Camera

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não replicado

O objeto Camera define uma visão do mundo 3D.Em uma experiência em andamento, cada cliente tem seu próprio objeto Camera que reside no local do cliente Workspace, acessível através da propriedade Workspace.CurrentCamera.

As propriedades de câmera mais importantes são:

  • CFrame que representa a posição e orientação da câmera.

  • CameraType que é lido pelos scripts da câmera da experiência e determina como a câmera deve atualizar cada quadro.

  • CameraSubject que é lido pelos scripts da câmera da experiência e determina qual objeto a câmera deve seguir.

  • FieldOfView que representa a extensão visível do mundo observável.

  • Focus que representa o ponto em que a câmera está olhando.É importante que essa propriedade seja configurar, pois certos visuais serão mais detalhados e serão atualizados com mais frequência dependendo de quão perto eles estão do ponto de foco.

Veja Personalizando a Câmera para mais informações sobre como ajustar e personalizar o comportamento da câmera.

Armazenando Múltiplas Câmeras

Observe que ao alterar Workspace.CurrentCamera para um novo Camera todas as outras Cameras que descerem diretamente de Workspace serão destruídas.Se você precisar armazenar várias câmeras e trocar entre elas quando solicitado, é recomendado que você as armazene em um Folder ou Model dentro de Workspace, no qual elas permanecerão mesmo quando CurrentCamera for alterado.

Resumo

Propriedades

Propriedades herdados de PVInstance

Propriedades

Métodos

  • GetPartsObscuringTarget(castPoints : Array,ignoreList : Instances):Instances

    Retorna um array de que estão obscurecendo as linhas de visão entre os pontos de lançamento da Câmerae os pontos de lançamento.

  • Retorna o real CFrame onde o Camera está sendo renderizado, contabilizando qualquer rolagem aplicada e o impacto de dispositivos VR.

  • Retorna em radianos o rolo atual, ou rotação em torno do eixo Z da Câmera, aplicado ao Camera usando SetRoll() .

  • Escrever Parallel

    Cria uma unidade a partir de uma posição na tela (em pixels), em uma profundidade definida a partir da direção da Câmera.Contas para a inserção da GUI.

  • SetRoll(rollAngle : number):()

    Define a rotação atual aplicada ao redor do eixo Z da Câmera.

  • Escrever Parallel

    Cria uma unidade Ray a partir de uma posição na janela de visualização (em pixels), a uma profundidade dada do Camera, orientada na direção da Câmera.Não leva em conta o inseto CoreUISafeInsets inseto.

  • Escrever Parallel

    Retorna a localização e profundidade da tela de um Datatype.Vector3``worldPoint e se este ponto está dentro dos limites da tela.Contas para a inserção da GUI.

  • Escrever Parallel

    Retorna a localização e profundidade da tela de um Datatype.Vector3``worldPoint e se este ponto está dentro dos limites da tela.Não leva em conta a inserção da GUI.

  • ZoomToExtents(boundingBoxCFrame : CFrame,boundingBoxSize : Vector3):()
Métodos herdados de PVInstance

Métodos

Propriedades

CFrame

Ler Parallel

CameraSubject

Ler Parallel

CameraType

Ler Parallel

DiagonalFieldOfView

Não replicado
Ler Parallel

FieldOfView

Ler Parallel

FieldOfViewMode

Ler Parallel

Focus

Ler Parallel

HeadLocked

Ler Parallel

HeadScale

Ler Parallel

MaxAxisFieldOfView

Não replicado
Ler Parallel

NearPlaneZ

Somente leitura
Não replicado
Ler Parallel

VRTiltAndRollEnabled

Ler Parallel

ViewportSize

Somente leitura
Não replicado
Ler Parallel

Métodos

GetPartsObscuringTarget

Instances

Parâmetros

castPoints: Array
Valor Padrão: ""
ignoreList: Instances
Valor Padrão: ""

Devolução

Instances

GetRenderCFrame


Devolução

GetRoll


Devolução

Amostras de código

Câmera:GetRoll

local currentRoll = math.deg(workspace.CurrentCamera:GetRoll()) -- Obtém o rolo atual da câmera em graus.
if currentRoll ~= 20 then
workspace.CurrentCamera:SetRoll(math.rad(20)) -- Se a câmera não estiver em 20 graus de rotação, a rotação é definida para 20 graus.
end

ScreenPointToRay

Escrever Parallel

Parâmetros

Valor Padrão: ""
Valor Padrão: ""
depth: number
Valor Padrão: 0

Devolução

SetRoll

()

Parâmetros

rollAngle: number
Valor Padrão: ""

Devolução

()

ViewportPointToRay

Escrever Parallel

Parâmetros

Valor Padrão: ""
Valor Padrão: ""
depth: number
Valor Padrão: 0

Devolução

WorldToScreenPoint

Escrever Parallel

Parâmetros

worldPoint: Vector3
Valor Padrão: ""

Devolução

WorldToViewportPoint

Escrever Parallel

Parâmetros

worldPoint: Vector3
Valor Padrão: ""

Devolução

ZoomToExtents

()

Parâmetros

boundingBoxCFrame: CFrame
Valor Padrão: ""
boundingBoxSize: Vector3
Valor Padrão: ""

Devolução

()

Eventos

InterpolationFinished