Câmera

classe pública Câmera

Representa uma câmera virtual, que determina a perspectiva com que a cena é visualizada.

Se a câmera fizer parte de um ArSceneView, ela vai rastrear automaticamente a posição da câmera no ARCore. Além disso, os métodos a seguir vão gerar UnsupportedOperationException quando forem chamados:

• setParent(NodeParent): o pai da câmera não pode ser alterado, porque ele é sempre o cenário.
• setLocalPosition(Vector3): a posição da câmera não pode ser alterada, ela é controlada pela posição da câmera do ARCore.
• setLocalRotation(Quaternion): a rotação da câmera não pode ser alterada, ela é controlada pela posição da câmera do ARCore.
• setWorldPosition(Vector3): a posição da câmera não pode ser alterada, ela é controlada pela posição da câmera do ARCore.
• setWorldRotation(Quaternion): a rotação da câmera não pode ser alterada, ela é controlada pela posição da câmera do ARCore.

Todas as outras funcionalidades no Node são compatíveis. Você pode acessar a posição e a rotação da câmera, atribuir um formato de colisão à câmera ou adicionar filhos a ela. A desativação da câmera desativa a renderização.

Métodos públicos

float	getFarClipPlane()
float	getNearClipPlane()
float	getVerticalFovDegrees() Recebe o campo de visão vertical da câmera.
Raio	screenPointToRay(float x, float y) Calcula um raio no espaço mundial passando do plano próximo da câmera e passando por um ponto no espaço da tela.
void	setLocalPosition(posição Vector3) Defina a posição da câmera.
void	setLocalRotation(rotação Quaternion) Defina a rotação da câmera.
void	setParent(pai pai NodeParent) Operação incompatível.
void	setVerticalFovDegrees(float verticalFov) Define o campo de visão vertical da câmera externa em graus.
void	setWorldPosition(posição Vector3) Defina a posição da câmera.
void	setWorldRotation(rotação Quaternion) Defina a rotação da câmera.
Vector3 (link em inglês)	worldToScreenPoint(ponto Vector3) Converta um ponto do espaço mundial em um espaço na tela.

Métodos herdados

Da classe com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListener ciclo de vida) Adiciona um listener que será chamado quando ocorrerem eventos de ciclo de vida do nó.
void	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) Adiciona um listener que será chamado quando a transformação do nó mudar.
void	callOnHierarchy(consumidor<nó> consumidor) Transfere a hierarquia e chama um método em cada nó (incluindo esse nó).
booleano final	canAddChild(filho do Node, falha de StringBuilder)
Nó	findInHierarchy(estado Predicate<Node>) Atravessa a hierarquia para encontrar o primeiro nó (incluindo esse nó) que atende a uma condição.
Vector3 final	getBack() Recebe o vetor de retorno do espaço mundial (+z) desse nó.
CollisionShape (link em inglês)	getCollisionShape() Recebe a forma a ser usada para colisões com esse nó.
Vector3 final	getDown() Recebe o vetor de espaço mundial (-y) desse nó.
Vector3 final	getForward() Recebe o vetor de encaminhamento mundial de espaço (-z) desse nó.
Vector3 final	getLeft() Recebe o vetor esquerdo do espaço mundial (-x) desse nó.
Claro	getLight(link em inglês) Recebe a luz atual, que é mutável.
Vector3 final	getLocalPosition(). Recebe uma cópia da posição dos nós em relação ao pai (local-space).
final de Quaternion	getLocalRotation () Recebe uma cópia da rotação de nós em relação ao pai (local-space)
Vector3 final	getLocalScale() Recebe uma cópia da escala dos nós em relação ao pai (local-space).
String final	getName() Retorna o nome do nó.
Nó final	getParent() Retorna o pai desse nó.
Renderizável	getRenderable(). Recebe o elemento de renderização a ser exibido para esse nó.
Vector3 final	getRight(). Recebe o vetor direito de espaço mundial (+x) desse nó.
Cenário final	getScene() Retorna a cena de que esse nó faz parte, nulo se não fizer parte de nenhuma cena.
Vector3 final	getUp() Recebe o vetor espaço mundial (+y) desse nó.
Vector3 final	getWorldPosition () Receba uma cópia da posição do espaço mundial dos nós.
final de Quaternion	getWorldRotation () Recebe uma cópia da rotação do espaço mundial dos nós.
Vector3 final	getWorldScale() Recebe uma cópia da escala global dos nós do espaço.
booleano final	isActive () Retorna verdadeiro se o nó está ativo.
booleano final	isDescendantOf(ancestral NodeParent) Verifica se o pai do nó fornecido é um ancestral desse nó recursivamente.
booleano final	isEnabled(). Recebe o estado ativado desse nó.
boolean	isTopLevel() Retorna verdadeiro se esse nó for de nível superior.
Vector3 final	localToWorldDirection(direção Vector3) Converte uma direção do espaço local desse nó em espaço mundial.
Vector3 final	localToWorldPoint(vetor 3) Converte um ponto no espaço local desse nó em espaço mundial.
void	onActivate() Processa quando este nó fica ativo.
anulação final	onAddChild(filho do Node)
void	onDisable(). Processa quando este nó fica inativo.
anulação final	onRemoveChild(filho do Node)
boolean	onTouchEvent (HitTestResult hitTestResult, MotionEvent movimentoEvent) Processa quando o nó é tocado.
void	onTransformChange(Node originNode) Processa quando a transformação deste nó é alterada.
void	onUpdate(FrameTime frameTime) Processa quando o nó é atualizado.
void	removeLifecycleListener(Node.LifecycleListener ciclo de vida) Remove um listener que será chamado quando ocorrerem eventos do ciclo de vida do nó.
void	removeTransformChangedListener (Node.TransformChangedListener transformChangedListener) Remove um listener que será chamado quando a transformação do nó mudar.
void	setCollisionShape(CollisionShape collisionShape) Define a forma como usada para detectar colisões para esse Node.
anulação final	setEnabled (booleano ativado) Define o estado ativado deste nó.
void	setLight(luz Light) Define o Light a ser exibido.
void	setLocalPosition(posição Vector3) Define a posição desse nó em relação ao pai (local-space).
void	setLocalRotation(rotação Quaternion) Define a rotação desse nó em relação ao pai (local-space).
void	setLocalScale(escala Vector3) Define a escala deste nó em relação ao pai (local-space).
anulação final	setLookDirection(Vector3 LookDirection) Define a direção que o nó está olhando no espaço mundial.
anulação final	setLookDirection(Vector3 LookDirection, Vector3 upDirection) Define a direção que o nó está olhando no espaço mundial.
anulação final	setName(nome da string) Define o nome deste nó.
void	setOnTapListener(Node.OnTapListener onTapListener) Registra um callback a ser invocado quando o usuário toca nesse nó.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) Registra um callback a ser invocado quando um evento de toque é enviado a esse nó.
void	setParent(pai pai NodeParent) Altera o nó pai desse nó.
void	setRenderable(renderizável) Renderable Define o Renderable a ser exibido para esse nó.
void	setWorldPosition(posição Vector3) Define a posição do espaço mundial desse nó.
void	setWorldRotation(rotação Quaternion) Define a rotação do espaço mundial desse nó.
void	setWorldScale(escala Vector3) Define a escala do espaço mundial deste nó.
String	toString().
Vector3 final	worldToLocalDirection(direção Vector3) Converte uma direção do espaço mundial para o espaço local desse nó.
Vector3 final	worldToLocalPoint(ponto Vector3) Converte um ponto no espaço mundial no espaço local deste nó.

Da classe com.google.ar.sceneform.NodeParent

anulação final	addChild(filha do Node) Adiciona um nó como filho deste NodeParent.
void	callOnHierarchy(consumidor<nó> consumidor) Percorra a hierarquia e chame um método em cada nó.
boolean	canAddChild(filho do Node, falha de StringBuilder)
Nó	findByName(nome da String) Percorra a hierarquia para encontrar o primeiro nó com um nome específico
Nó	findInHierarchy(estado Predicate<Node>) Percorra a hierarquia para encontrar o primeiro nó que atende a uma condição.
List<Node> final	getChildren() Retorna uma lista imutável dos filhos deste pai.
void	onAddChild(filho do Node)
void	onRemoveChild(filho do Node)
anulação final	removeChild(filha do Node) Remove um nó dos filhos deste NodeParent.

Da classe java.lang.Object

Object	clone ()
boolean	igual a(objeto arg0)
void	finalize()
Classe<?> final	getClass()
int	hashCode().
anulação final	notify()
anulação final	notifyAll()
String	toString().
anulação final	wait(long arg0, int arg1)
anulação final	wait (long arg0)
anulação final	wait()

Métodos públicos

flutuante público getFarClipPlane ()

flutuante público getNearClipPlane ()

ponto flutuante público getVerticalFovDegrees ()

Recebe o campo de visão vertical da câmera.

Se esta for uma câmera de RA, ela será calculada com base nas informações da câmera do ARCore e poderá variar de acordo com o dispositivo. Ele não pode ser calculado até que o primeiro frame após a retomada da sessão ARCore. Nesse caso, uma IllegalStateException é gerada.

Caso contrário, ele retornará o valor definido por setVerticalFovDegrees(float), com um padrão de 90 graus.

Gera

IllegalStateException	se chamado antes do primeiro frame após a retomada do ARCore

público Ray screenPointToRay (float x, float y)

Calcula um raio no espaço mundial passando do plano próximo da câmera e passando por um ponto no espaço da tela. O espaço na tela está nas coordenadas da tela do dispositivo Android: TopLeft = (0, 0) BottomRight = (largura da tela, altura da tela). O espaço de coordenadas do dispositivo não é afetado pela orientação do dispositivo.

Parâmetros

x	Posição X nas coordenadas da tela do dispositivo.
y	Posição Y nas coordenadas da tela do dispositivo.

void public setLocalPosition (Vector3 posição)

Defina a posição da câmera. A câmera sempre isTopLevel(), portanto, se comporta da mesma forma que setWorldPosition(Vector3).

Se a câmera fizer parte de um ArSceneView, esta não é uma operação compatível. A posição da câmera não pode ser alterada. Ela é controlada pela posição da câmera do ARCore.

Parâmetros

position	A posição a ser aplicada.

void public setLocalRotation (Alternância de rotação)

Defina a rotação da câmera. A câmera sempre isTopLevel(), portanto, se comporta da mesma forma que setWorldRotation(Quaternion).

Se a câmera fizer parte de um ArSceneView, esta não é uma operação compatível. A rotação da câmera não pode ser alterada. Ela é controlada pela posição da câmera do ARCore.

Parâmetros

rotação	A rotação a ser aplicada.

void public setParent (NodeParent pai)

Operação incompatível. O pai da câmera não pode ser alterado, é sempre o cenário.

Parâmetros

primária	O novo pai do qual este nó será filho. Se for nulo, esse nó será removido do pai.

public void setVerticalFovDegrees (float verticalFov)

Define o campo de visão vertical da câmera externa em graus. Se esta for uma câmera de RA, o fov vem do ARCore e não pode ser definido, então uma exceção é gerada. O padrão é 90 graus.

Parâmetros

VerticalFov

Gera

SupportedOperationException	Se esta é uma câmera de RA

public void setWorldPosition (Vector3 posição)

Defina a posição da câmera. A câmera sempre isTopLevel(), portanto, se comporta da mesma forma que setLocalPosition(Vector3).

Se a câmera fizer parte de um ArSceneView, esta não é uma operação compatível. A posição da câmera não pode ser alterada. Ela é controlada pela posição da câmera do ARCore.

Parâmetros

position	A posição a ser aplicada.

public void setWorldRotation (Alternância de rotação)

Defina a rotação da câmera. A câmera sempre isTopLevel(), portanto, se comporta da mesma forma que setLocalRotation(Quaternion).

Se a câmera fizer parte de um ArSceneView, esta não é uma operação compatível. A rotação da câmera não pode ser alterada. Ela é controlada pela posição da câmera do ARCore.

Parâmetros

rotação	A rotação a ser aplicada.

público Vector3 worldToScreenPoint (Vector3 ponto)

Converta um ponto do espaço mundial em um espaço na tela.

O valor X é negativo quando o ponto é deixado da janela de visualização, entre 0 e a largura da SceneView quando o ponto está na janela de visualização e maior que a largura quando o ponto está à direita da janela de visualização.

O valor Y é negativo quando o ponto está abaixo da janela de visualização, entre 0 e a altura do SceneView quando o ponto está dentro da janela de visualização e maior do que a altura quando o ponto está acima da janela de visualização.

O valor Z é sempre 0, já que o valor de retorno é uma coordenada 2D.

Parâmetros

point	o ponto no espaço mundial para converter

Retorna

• um novo vetor que representa o ponto no espaço da tela.