Cámara

clase pública Camera

Representa una cámara virtual, que determina la perspectiva a través de la cual se ve la escena.

Si la cámara es parte de un ArSceneView, la cámara realizará automáticamente un seguimiento de la pose de la cámara desde ARCore. Además, los siguientes métodos mostrarán UnsupportedOperationException cuando se los llame:

• setParent(NodeParent): el padre o la madre no se puede cambiar; siempre es la escena.
• setLocalPosition(Vector3): la posición de la cámara no se puede cambiar; se controla con la posición de la cámara de ARCore.
• setLocalRotation(Quaternion): la rotación de la cámara no se puede cambiar y la controla la posición de la cámara de ARCore.
• setWorldPosition(Vector3): la posición de la cámara no se puede cambiar; se controla con la posición de la cámara de ARCore.
• setWorldRotation(Quaternion): la rotación de la cámara no se puede cambiar y la controla la posición de la cámara de ARCore.

Todas las demás funciones de Node son compatibles. Puedes acceder a la posición y la rotación de la cámara, asignarle una forma de colisión o agregar niños a ella. Si inhabilitas la cámara, se desactivará la renderización.

Métodos públicos

float	getFarClipPlane()
float	getNearClipPlane()
float	getVerticalFovDegrees() Obtiene el campo visual vertical de la cámara.
Ray	screenPointToRay(float x, float y) Calcula un rayo en el espacio mundial que pasa desde el plano cercano de la cámara y atraviesa un punto en el espacio de la pantalla.
void	setLocalPosition(posición Vector3) Establece la posición de la cámara.
void	setLocalRotation(rotación Quaternion) Establece la rotación de la cámara.
void	setParent(NodeParent) Operación no admitida.
void	setVerticalFovDegrees(float verticalFov) Establece el campo visual vertical de la cámara que no es de RA en grados.
void	setWorldPosition(posición Vector3) Establece la posición de la cámara.
void	setWorldRotation(rotación Quaternion) Establece la rotación de la cámara.
Vector 3	worldToScreenPoint(punto Vector3) Convierte un punto del espacio del mundo en un espacio de pantalla.

Métodos heredados

Desde la clase com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListenerlifecycleListener) Agrega un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos.
void	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) Agrega un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
void	callOnHierarchy(consumidorNode> consumer) Desvía la jerarquía y llama a un método en cada nodo (incluido este nodo).
Booleano final	canAddChild(elemento secundario Node, StringBuilder)
Node	findInHierarchy(condición <Nodo) Desvía la jerarquía para encontrar el primer nodo (incluido este nodo) que cumpla con una condición.
Vector3 final	getBack() Obtiene el vector de retroceso de espacio mundial (+z) de este nodo.
CollisionShape.	getCollisionShape() Obtiene la forma que se usará para las colisiones con este nodo.
Vector3 final	getDown() Obtiene el vector descendente del espacio global (-y) de este nodo.
Vector3 final	getForward() Obtiene el vector de avance de espacio global (z-) de este nodo.
Vector3 final	getLeft() Obtiene el vector a la izquierda del espacio de mundo (-x) de este nodo.
Ligera	getLight() Obtiene la luz actual, que es mutable.
Vector3 final	getLocalPosition() Obtiene una copia de la posición de los nodos en relación con su elemento superior (espacio local).
Quaternion final	getLocalRotation() Obtiene una copia de la rotación de nodos en relación con su elemento superior (espacio local).
Vector3 final	getLocalScale() Obtiene una copia de la escala de nodos en relación con su elemento superior (espacio local).
String final	getName() Muestra el nombre del nodo.
Node final	getParent(). Muestra el superior de este nodo.
Se puede renderizar	getRenderable() Obtiene el renderizado que se mostrará para este nodo.
Vector3 final	getRight() Obtiene el vector de espacio mundo (+x) de este nodo.
Scene final	getScene() Muestra la escena de la que forma parte este nodo, en caso de que no sea parte de ninguna escena.
Vector3 final	getUp() Obtiene el vector de espacio exterior (+y) de este nodo.
Vector3 final	getWorldPosition(). Obtenga una copia de la posición en el espacio del nodo.
Quaternion final	getWorldRotation() Obtiene una copia de la rotación del espacio-mundo de los nodos.
Vector3 final	getWorldScale() Obtiene una copia de la escala de espacio global del nodo.
Booleano final	La función está activa() Muestra true si el nodo está activo.
Booleano final	isDescendantOf(NodeParent) Comprueba si el nodo principal determinado es un principal de este nodo de forma recursiva.
Booleano final	está habilitada() Obtiene el estado habilitado de este nodo.
boolean	isTopLevel() Muestra true si este nodo es de nivel superior.
Vector3 final	localToWorldDirection(dirección Vector3) Convierte una dirección del espacio local de este nodo a un espacio del mundo.
Vector3 final	localToWorldPoint(punto Vector3) Convierte un punto en el espacio local de este nodo en un espacio del mundo.
void	onActivate() Controla cuándo se activa este nodo.
vacío final	onAddChild(elemento secundario de Node)
void	onDesactivar() Controla cuándo se desactiva este nodo.
vacío final	onRemoveChild(elemento secundario Node)
boolean	onTouchEvent(HitTestResult hitTestResult, MotionEvent movimientoEvent) Controla cuándo se toca este nodo.
void	onTransformChange(nodo de origen) Controla cuándo se cambia la transformación de este nodo.
void	onUpdate(FrameTime) Controla cuándo se actualiza este nodo.
void	removeLifecycleListener(Node.LifecycleListenerlifecycleListener) Quita un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos.
void	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) Quita un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
void	setCollisionShape(collisionShape colisiónShape) Configura la forma que se usará para detectar colisiones para este Node.
vacío final	setEnabled(booleano habilitado) Establece el estado habilitado de este nodo.
void	setLight(luz light) Configura el Light para mostrar.
void	setLocalPosition(posición Vector3) Establece la posición de este nodo en relación con su elemento principal (espacio local).
void	setLocalRotation(rotación Quaternion) Establece la rotación de este nodo en relación con su elemento superior (espacio local).
void	setLocalScale(escala Vector3) Establece la escala de este nodo en relación con su elemento superior (espacio local).
vacío final	setLookDirection(Vector3 lookDirection) Establece la dirección que el nodo observa en el espacio.
vacío final	setLookDirection(Vector3 lookDirection y Vector3 upDirection) Establece la dirección que el nodo observa en el espacio.
vacío final	setName(nombre de string) Establece el nombre de este nodo.
void	setOnTapListener(Node.OnTapListener onTapListener) Registra una devolución de llamada que se invocará cuando se presione este nodo.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) Registra una devolución de llamada que se invocará cuando se envíe un evento táctil a este nodo.
void	setParent(NodeParent) Cambia el nodo superior de este nodo.
void	setRenderable(Renderable renderable) Configura el Renderable para mostrar este nodo.
void	setWorldPosition(posición Vector3) Establece la posición de espacio mundial de este nodo.
void	setWorldRotation(rotación Quaternion) Establece la rotación de espacio mundial de este nodo.
void	setWorldScale(escala Vector3) Establece la escala de espacio mundial de este nodo.
String	toString()
Vector3 final	worldToLocalDirection(dirección Vector3) Convierte una dirección de un espacio-mundo al espacio local de este nodo.
Vector3 final	worldToLocalPoint(punto Vector3) Convierte un punto en el espacio mundial en el espacio local de este nodo.

Desde la clase com.google.ar.sceneform.NodeParent

vacío final	addChild(Node) Agrega un nodo como secundario de este NodeParent.
void	callOnHierarchy(consumidorNode> consumer) Desvía la jerarquía y llama a un método en cada nodo.
boolean	canAddChild(elemento secundario Node, StringBuilder)
Node	findByName(Nombre de String) Recorre la jerarquía para encontrar el primer nodo con un nombre determinado.
Node	findInHierarchy(condición <Nodo) Desvía la jerarquía para encontrar el primer nodo que cumple con una condición.
Lista finalNode	getChildren() Muestra una lista inmutable de los elementos secundarios de este elemento superior.
void	onAddChild(elemento secundario de Node)
void	onRemoveChild(elemento secundario Node)
vacío final	removeChild(secundario Node) Quita un nodo de los elementos secundarios de este NodeParent.

Desde la clase java.lang.Object

Objeto	clonar()
boolean	equals(Objeto arg0)
void	finalize()
Class final	getClass().
int	hashCode().
vacío final	notificar()
vacío final	notifyAll()
String	toString()
vacío final	wait(argumento largo, int arg1)
vacío final	wait(argumento largo)
vacío final	wait()

Métodos públicos

flotante público getFarClipPlane ()

public float getNearClipPlane ()

public float getVerticalFovDegrees ()

Obtiene el campo visual vertical de la cámara.

Si se trata de una cámara de RA, se calcula en función de la información de ARCore sobre la cámara y puede variar según el dispositivo. No se puede calcular hasta que se reanude el primer fotograma después de que se reanude la sesión de ARCore. En ese caso, se genera una IllegalStateException.

De lo contrario, se mostrará el valor establecido por setVerticalFovDegrees(float), con un valor predeterminado de 90 grados.

Arroja

IllegalStateException	si se llama antes del primer fotograma después de que se reanuda ARCore

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

Calcula un rayo en el espacio mundial que pasa desde el plano cercano de la cámara y atraviesa un punto en el espacio de la pantalla. El espacio de la pantalla está en las coordenadas de la pantalla del dispositivo Android: TopLeft = (0, 0) BottomRight = (Screen Width, Screen Height) El espacio de coordenadas del dispositivo no se ve afectado por la orientación del dispositivo.

Parámetros

x	Posición X en las coordenadas de la pantalla del dispositivo.
y	Posición Y en las coordenadas de la pantalla del dispositivo.

vacío público setLocalPosition (posición de Vector3)

Establece la posición de la cámara. La cámara siempre isTopLevel(), por lo que esto se comporta de la misma manera que setWorldPosition(Vector3).

Si la cámara es parte de un ArSceneView, no se admite esta operación. No se puede cambiar la posición de la cámara porque está controlada por la pose de la cámara de ARCore.

Parámetros

position	Posición que se aplicará.

vacío público setLocalRotation (rotación Quaternion)

Establece la rotación de la cámara. La cámara siempre isTopLevel(), por lo que esto se comporta de la misma manera que setWorldRotation(Quaternion).

Si la cámara es parte de un ArSceneView, no se admite esta operación. La rotación de la cámara no se puede cambiar y la posición de la cámara de ARCore la controla.

Parámetros

rotación	La rotación que se aplicará.

vacío público setParent (NodeParent)

Operación no admitida. El padre o la madre no se puede cambiar; siempre es la escena.

Parámetros

elemento superior	El nuevo superior del que será nodo este nodo. Si es nulo, este nodo se desvinculará de su superior.

vacío público setVerticalFovDegrees (float verticalFov)

Establece el campo visual vertical de la cámara que no es de RA en grados. Si se trata de una cámara de RA, el fov proviene de ARCore y no se puede establecer, por lo que se arroja una excepción. El valor predeterminado es 90 grados.

Parámetros

VerticalFov

Arroja

UnsupportedOperationException	si esta es una cámara de RA

vacío público setWorldPosition (posición de Vector3)

Establece la posición de la cámara. La cámara siempre isTopLevel(), por lo que esto se comporta de la misma manera que setLocalPosition(Vector3).

Si la cámara es parte de un ArSceneView, no se admite esta operación. No se puede cambiar la posición de la cámara porque está controlada por la pose de la cámara de ARCore.

Parámetros

position	Posición que se aplicará.

vacío público setWorldRotation (rotación Quaternion)

Establece la rotación de la cámara. La cámara siempre isTopLevel(), por lo que esto se comporta de la misma manera que setLocalRotation(Quaternion).

Si la cámara es parte de un ArSceneView, no se admite esta operación. La rotación de la cámara no se puede cambiar y la posición de la cámara de ARCore la controla.

Parámetros

rotación	La rotación que se aplicará.

público Vector3 worldToScreenPoint (punto Vector3)

Convierte un punto del espacio del mundo en un espacio de pantalla.

El valor X es negativo cuando el punto se encuentra a la izquierda del viewport, entre 0 y el ancho de SceneView cuando el punto está dentro del viewport, y mayor que el ancho cuando el punto está a la derecha del viewport.

El valor Y es negativo cuando el punto está por debajo del viewport, entre 0 y la altura del SceneView cuando el punto está dentro del viewport, y mayor que el alto cuando el punto está por encima del viewport.

El valor Z siempre es 0, ya que el valor que se muestra es una coordenada 2D.

Parámetros

point	el punto en el espacio mundial para convertir

Resultado que se muestra

• un vector nuevo que representa el punto en el espacio de pantalla.