Camera

public class Camera

Represents a virtual camera, which determines the perspective through which the scene is viewed.

If the camera is part of an ArSceneView, then the camera automatically tracks the camera pose from ARCore. Additionally, the following methods will throw UnsupportedOperationException when called:

• setParent(NodeParent) - Camera's parent cannot be changed, it is always the scene.
• setLocalPosition(Vector3) - Camera's position cannot be changed, it is controlled by the ARCore camera pose.
• setLocalRotation(Quaternion) - Camera's rotation cannot be changed, it is controlled by the ARCore camera pose.
• setWorldPosition(Vector3) - Camera's position cannot be changed, it is controlled by the ARCore camera pose.
• setWorldRotation(Quaternion) - Camera's rotation cannot be changed, it is controlled by the ARCore camera pose.

All other functionality in Node is supported. You can access the position and rotation of the camera, assign a collision shape to the camera, or add children to the camera. Disabling the camera turns off rendering.

Public Methods

float	getFarClipPlane()
float	getNearClipPlane()
float	getVerticalFovDegrees() Gets the vertical field of view for the camera.
Ray	screenPointToRay(float x, float y) Calculates a ray in world space going from the near-plane of the camera and going through a point in screen space.
void	setLocalPosition(Vector3 position) Set the position of the camera.
void	setLocalRotation(Quaternion rotation) Set the rotation of the camera.
void	setParent(NodeParent parent) Unsupported operation.
void	setVerticalFovDegrees(float verticalFov) Sets the vertical field of view for the non-ar camera in degrees.
void	setWorldPosition(Vector3 position) Set the position of the camera.
void	setWorldRotation(Quaternion rotation) Set the rotation of the camera.
Vector3	worldToScreenPoint(Vector3 point) Convert a point from world space into screen space.

Inherited Methods

From class com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListener lifecycleListener) Adds a listener that will be called when node lifecycle events occur.
void	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) Adds a listener that will be called when the node's transformation changes.
void	callOnHierarchy(Consumer<Node> consumer) Traverses the hierarchy and call a method on each node (including this node).
final boolean	canAddChild(Node child, StringBuilder failureReason)
Node	findInHierarchy(Predicate<Node> condition) Traverses the hierarchy to find the first node (including this node) that meets a condition.
final Vector3	getBack() Gets the world-space back vector (+z) of this node.
CollisionShape	getCollisionShape() Gets the shape to use for collisions with this node.
final Vector3	getDown() Gets the world-space down vector (-y) of this node.
final Vector3	getForward() Gets the world-space forward vector (-z) of this node.
final Vector3	getLeft() Gets the world-space left vector (-x) of this node.
Light	getLight() Gets the current light, which is mutable.
final Vector3	getLocalPosition() Gets a copy of the nodes position relative to its parent (local-space).
final Quaternion	getLocalRotation() Gets a copy of the nodes rotation relative to its parent (local-space).
final Vector3	getLocalScale() Gets a copy of the nodes scale relative to its parent (local-space).
final String	getName() Returns the name of the node.
final Node	getParent() Returns the parent of this node.
Renderable	getRenderable() Gets the renderable to display for this node.
final Vector3	getRight() Gets the world-space right vector (+x) of this node.
final Scene	getScene() Returns the scene that this node is part of, null if it isn't part of any scene.
final Vector3	getUp() Gets the world-space up vector (+y) of this node.
final Vector3	getWorldPosition() Get a copy of the nodes world-space position.
final Quaternion	getWorldRotation() Gets a copy of the nodes world-space rotation.
final Vector3	getWorldScale() Gets a copy of the nodes world-space scale.
final boolean	isActive() Returns true if the node is active.
final boolean	isDescendantOf(NodeParent ancestor) Checks whether the given node parent is an ancestor of this node recursively.
final boolean	isEnabled() Gets the enabled state of this node.
boolean	isTopLevel() Returns true if this node is top level.
final Vector3	localToWorldDirection(Vector3 direction) Converts a direction from the local-space of this node to world-space.
final Vector3	localToWorldPoint(Vector3 point) Converts a point in the local-space of this node to world-space.
void	onActivate() Handles when this node becomes active.
final void	onAddChild(Node child)
void	onDeactivate() Handles when this node becomes inactivate.
final void	onRemoveChild(Node child)
boolean	onTouchEvent(HitTestResult hitTestResult, MotionEvent motionEvent) Handles when this node is touched.
void	onTransformChange(Node originatingNode) Handles when this node's transformation is changed.
void	onUpdate(FrameTime frameTime) Handles when this node is updated.
void	removeLifecycleListener(Node.LifecycleListener lifecycleListener) Removes a listener that will be called when node lifecycle events occur.
void	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) Removes a listener that will be called when the node's transformation changes.
void	setCollisionShape(CollisionShape collisionShape) Sets the shape to used to detect collisions for this Node.
final void	setEnabled(boolean enabled) Sets the enabled state of this node.
void	setLight(Light light) Sets the Light to display.
void	setLocalPosition(Vector3 position) Sets the position of this node relative to its parent (local-space).
void	setLocalRotation(Quaternion rotation) Sets the rotation of this node relative to its parent (local-space).
void	setLocalScale(Vector3 scale) Sets the scale of this node relative to its parent (local-space).
final void	setLookDirection(Vector3 lookDirection) Sets the direction that the node is looking at in world-space.
final void	setLookDirection(Vector3 lookDirection, Vector3 upDirection) Sets the direction that the node is looking at in world-space.
final void	setName(String name) Sets the name of this node.
void	setOnTapListener(Node.OnTapListener onTapListener) Registers a callback to be invoked when this node is tapped.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) Registers a callback to be invoked when a touch event is dispatched to this node.
void	setParent(NodeParent parent) Changes the parent node of this node.
void	setRenderable(Renderable renderable) Sets the Renderable to display for this node.
void	setWorldPosition(Vector3 position) Sets the world-space position of this node.
void	setWorldRotation(Quaternion rotation) Sets the world-space rotation of this node.
void	setWorldScale(Vector3 scale) Sets the world-space scale of this node.
String	toString()
final Vector3	worldToLocalDirection(Vector3 direction) Converts a direction from world-space to the local-space of this node.
final Vector3	worldToLocalPoint(Vector3 point) Converts a point in world-space to the local-space of this node.

From class com.google.ar.sceneform.NodeParent

final void	addChild(Node child) Adds a node as a child of this NodeParent.
void	callOnHierarchy(Consumer<Node> consumer) Traverse the hierarchy and call a method on each node.
boolean	canAddChild(Node child, StringBuilder failureReason)
Node	findByName(String name) Traverse the hierarchy to find the first node with a given name.
Node	findInHierarchy(Predicate<Node> condition) Traverse the hierarchy to find the first node that meets a condition.
final List<Node>	getChildren() Returns an immutable list of this parent's children.
void	onAddChild(Node child)
void	onRemoveChild(Node child)
final void	removeChild(Node child) Removes a node from the children of this NodeParent.

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public float getFarClipPlane ()

public float getNearClipPlane ()

public float getVerticalFovDegrees ()

Gets the vertical field of view for the camera.

If this is an AR camera, then it is calculated based on the camera information from ARCore and can vary between device. It can't be calculated until the first frame after the ARCore session is resumed, in which case an IllegalStateException is thrown.

Otherwise, this will return the value set by setVerticalFovDegrees(float), with a default of 90 degrees.

Throws

IllegalStateException	if called before the first frame after ARCore is resumed

public Ray screenPointToRay (float x, float y)

Calculates a ray in world space going from the near-plane of the camera and going through a point in screen space. Screen space is in Android device screen coordinates: TopLeft = (0, 0) BottomRight = (Screen Width, Screen Height) The device coordinate space is unaffected by the orientation of the device.

Parameters

x	X position in device screen coordinates.
y	Y position in device screen coordinates.

public void setLocalPosition (Vector3 position)

Set the position of the camera. The camera always isTopLevel(), therefore this behaves the same as setWorldPosition(Vector3).

If the camera is part of an ArSceneView, then this is an unsupported operation. Camera's position cannot be changed, it is controlled by the ARCore camera pose.

Parameters

position	The position to apply.

public void setLocalRotation (Quaternion rotation)

Set the rotation of the camera. The camera always isTopLevel(), therefore this behaves the same as setWorldRotation(Quaternion).

If the camera is part of an ArSceneView, then this is an unsupported operation. Camera's rotation cannot be changed, it is controlled by the ARCore camera pose.

Parameters

rotation	The rotation to apply.

public void setParent (NodeParent parent)

Unsupported operation. Camera's parent cannot be changed, it is always the scene.

Parameters

parent	The new parent that this node will be a child of. If null, this node will be detached from its parent.

public void setVerticalFovDegrees (float verticalFov)

Sets the vertical field of view for the non-ar camera in degrees. If this is an AR camera, then the fov comes from ARCore and cannot be set so an exception is thrown. The default is 90 degrees.

Parameters

verticalFov

Throws

UnsupportedOperationException	if this is an AR camera

public void setWorldPosition (Vector3 position)

Set the position of the camera. The camera always isTopLevel(), therefore this behaves the same as setLocalPosition(Vector3).

If the camera is part of an ArSceneView, then this is an unsupported operation. Camera's position cannot be changed, it is controlled by the ARCore camera pose.

Parameters

position	The position to apply.

public void setWorldRotation (Quaternion rotation)

Set the rotation of the camera. The camera always isTopLevel(), therefore this behaves the same as setLocalRotation(Quaternion).

If the camera is part of an ArSceneView, then this is an unsupported operation. Camera's rotation cannot be changed, it is controlled by the ARCore camera pose.

Parameters

rotation	The rotation to apply.

public Vector3 worldToScreenPoint (Vector3 point)

Convert a point from world space into screen space.

The X value is negative when the point is left of the viewport, between 0 and the width of the SceneView when the point is within the viewport, and greater than the width when the point is to the right of the viewport.

The Y value is negative when the point is below the viewport, between 0 and the height of the SceneView when the point is within the viewport, and greater than the height when the point is above the viewport.

The Z value is always 0 since the return value is a 2D coordinate.

Parameters

point	the point in world space to convert

Returns

• a new vector that represents the point in screen-space.