Kamera

public class Camera

Eine virtuelle Kamera, die die Perspektive bestimmt, aus der die Szene angesehen wird

Wenn die Kamera zu einem ArSceneView gehört, zeichnet die Kamera die Kameraposition von ARCore automatisch auf. Außerdem wird bei folgenden Methoden UnsupportedOperationException ausgelöst:

• setParent(NodeParent): Das übergeordnete Element der Kamera kann nicht geändert werden, sondern immer das Ambiente.
• setLocalPosition(Vector3) – Die Position der Kamera kann nicht geändert werden. Sie wird durch die ARCore-Kamerastellung gesteuert.
• setLocalRotation(Quaternion): Die Drehung der Kamera kann nicht geändert werden. Sie wird über die ARCore-Kamerastellung gesteuert.
• setWorldPosition(Vector3) – Die Position der Kamera kann nicht geändert werden. Sie wird durch die ARCore-Kamerastellung gesteuert.
• setWorldRotation(Quaternion): Die Drehung der Kamera kann nicht geändert werden. Sie wird über die ARCore-Kamerastellung gesteuert.

Alle anderen Funktionen in Node.js werden unterstützt. Sie können auf die Position und Drehung der Kamera zugreifen, ihr eine Kollisionsform zuweisen oder der Kamera untergeordnete Elemente hinzufügen. Wenn du die Kamera deaktivierst, wird das Rendering deaktiviert.

Public Methods

float	getFarClipPlane
float	getNearClipPlane
float	getVerticalFovDedegrees Ruft das vertikale Sichtfeld für die Kamera ab.
Ray	screenPointToRay(Gleitkommazahl x, Gleitkommazahl y) Berechnet einen Strahl im Weltall, der von der Kamera in der Nähe des Flugzeugs zu einem Punkt im Bildschirm führt.
Ungültig	setLocalPosition(Vector3-Position) Position der Kamera festlegen.
Ungültig	setLocalRotation(Quaternion) Legen Sie die Kameradrehung fest.
Ungültig	setParent(NodeParent übergeordneter Element) Nicht unterstützter Vorgang.
Ungültig	setVerticalFovDedegrees(float verticalFov) Legt das vertikale Sichtfeld für die Nicht-Arche-Kamera in Grad fest.
Ungültig	setWorldPosition(Vector3-Position) Position der Kamera festlegen.
Ungültig	setWorldRotation(Quaternion-Rotation) Legen Sie die Kameradrehung fest.
Vektor3	worldToScreenPoint(Vector3-Punkt) Damit lässt sich ein Punkt aus dem Weltall in einen Bildschirmbereich umwandeln.

Übernommene Methoden

Von Klasse com.google.ar.sceneform.Node

Ungültig	addLifecycleListener(Node.LifecycleListener Lebenszyklus-Listener) Fügt einen Listener hinzu, der aufgerufen wird, wenn Ereignisse im Knotenlebenszyklus auftreten.
Ungültig	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) Fügt einen Listener hinzu, der aufgerufen wird, wenn sich die Transformation des Knotens ändert.
Ungültig	callOnHierarchy(Nutzer;Knoten> Nutzer) Durchquert die Hierarchie und ruft eine Methode auf jedem Knoten auf (einschließlich dieses Knotens).
Boolescher Wert	canAddChild(Node-Child, StringBuilder errorReason)
Knoten	findInHierarchy(Predicate<Node> Bedingung) Durchläuft die Hierarchie, um den ersten Knoten (einschließlich dieses Knotens) zu finden, der eine Bedingung erfüllt.
final Vector3	getBack Ruft den Back-End-Weltvektor (+z) dieses Knotens ab.
CollisionShape	getCollisionShape() Ruft die Form ab, die für Kollisionen mit diesem Knoten verwendet werden soll.
final Vector3	getDown() Ruft den nach unten gehenden Vektor (-y) für den Weltraum ab.
final Vector3	getForward Ruft den World-Space-Forward-Vektor (-z) dieses Knotens ab.
final Vector3	getLeft() Ruft den World-Space-Linksvektor (-x) dieses Knotens ab.
Leicht	getLight() Ruft das aktuelle Licht ab, das änderbar ist.
final Vector3	getLocalPosition() Ruft eine Kopie der Knotenposition in Bezug auf das übergeordnete Element (lokaler Bereich) ab.
Finale Quaternion	getLocalRotation Ruft eine Kopie der Knotenrotation in Bezug auf das übergeordnete Element (lokaler Bereich) ab.
final Vector3	getLocalScale Ruft eine Kopie der Knotenskalierung in Bezug auf das übergeordnete Element (lokaler Bereich) ab.
final String	getName() Gibt den Namen des Knotens zurück.
finaler Knoten	getParent Gibt das übergeordnete Element dieses Knotens zurück.
Renderbar	getRenderable Ruft das Rendering ab, das für diesen Knoten angezeigt werden soll.
final Vector3	getRight Ruft den World-Space-Right-Vektor (+x) dieses Knotens ab.
Finale Szene	getScene Gibt das Ambiente zurück, zu dem dieser Knoten gehört. Der Wert ist null, wenn er zu keiner Szene gehört.
final Vector3	getUp Ruft den „Weltraum-up“-Vektor (+y) dieses Knotens ab.
final Vector3	getWorldPosition() Kopieren Sie die Position des Weltbereichs des Knotens.
Finale Quaternion	getWorldRotation() Ruft eine Kopie der Rotation der Welt-Welt des Knotens ab.
final Vector3	getWorldScale Ruft eine Kopie der World-Space-Skalierung des Knotens ab.
Boolescher Wert	isActive() Gibt „true“ zurück, wenn der Knoten aktiv ist.
Boolescher Wert	isDescendantOf(NodeParent Vorgänger) Prüft, ob der übergeordnete Knoten rekursiv ein Vorgänger dieses Knotens ist.
Boolescher Wert	isEnabled() Ruft den aktivierten Status dieses Knotens ab.
boolean	isTopLevel() Gibt „true“ zurück, wenn dieser Knoten die oberste Ebene ist.
final Vector3	localToWorldDirection(Vector3-Richtung) Wandelt eine Richtung vom lokalen Gruppenbereich dieses Knotens in einen globalen Gruppenbereich um.
final Vector3	localToWorldPoint(Vector3 Punkt) Konvertiert einen Punkt im lokalen Gruppenbereich dieses Knotens in den Weltbereich.
Ungültig	onActivate() Wird verarbeitet, wenn dieser Knoten aktiv wird.
Finale void	onAddChild(Node-Untergeordnetes Element)
Ungültig	onDisable() Wird verarbeitet, wenn dieser Knoten inaktiv wird.
Finale void	onRemoveChild(Node-Untergeordnetes)
boolean	onTouchEvent(HitTestResult hitTestResult, MotionEventmotionEvent) Wird verarbeitet, wenn dieser Knoten berührt wird.
Ungültig	onTransformChange(Knoten originNode) Wird verarbeitet, wenn die Transformation dieses Knotens geändert wird.
Ungültig	onUpdate(FrameTime FrameTime) Wird verarbeitet, wenn dieser Knoten aktualisiert wird.
Ungültig	removeLifecycleListener(Node.LifecycleListener Lebenszyklus-Listener) Entfernt einen Listener, der bei Lebenszyklusereignissen des Knotens aufgerufen wird.
Ungültig	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) Entfernt einen Listener, der aufgerufen wird, wenn sich die Transformation des Knotens ändert.
Ungültig	setCollisionShape(CollisionShape kollisionShape) Legt die Form fest, mit der Kollisionen für diesen Node erkannt werden.
Finale void	setEnabled(boolesch aktiviert) Legt den aktivierten Status dieses Knotens fest.
Ungültig	setLight(Light-Licht) Legt fest, dass Light angezeigt werden soll.
Ungültig	setLocalPosition(Vector3-Position) Legt die Position dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest.
Ungültig	setLocalRotation(Quaternion) Legt die Rotation dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest.
Ungültig	setLocalScale(Vector3-Skalierung) Legt die Skalierung dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest.
Finale void	setLookDirection(Vector3-LookDirection) Legt die Richtung fest, die der Knoten im Weltall betrachtet.
Finale void	setLookDirection(Vector3 LookDirection, Vector3 upDirection) Legt die Richtung fest, die der Knoten im Weltall betrachtet.
Finale void	setName(String-Name) Legt den Namen dieses Knotens fest.
Ungültig	setOnTapListener(Node.OnTapListener onTapListener) Registriert einen Callback, der ausgelöst wird, wenn auf diesen Knoten getippt wird.
Ungültig	setOnTouchListener(Node.OnTouchListener onTouchListener) Registriert einen Callback, der ausgelöst wird, wenn ein Touch-Ereignis an diesen Knoten gesendet wird.
Ungültig	setParent(NodeParent übergeordneter Element) Ändert den übergeordneten Knoten dieses Knotens.
Ungültig	setRenderable(Renderable - renderbar) Legt fest, dass Renderable für diesen Knoten angezeigt werden soll.
Ungültig	setWorldPosition(Vector3-Position) Legt die Position des Weltbereichs dieses Knotens fest.
Ungültig	setWorldRotation(Quaternion-Rotation) Legt die Rotation des Weltraums dieses Knotens fest.
Ungültig	setWorldScale(Vector3-Skalierung) Legt die Skalierung des Weltbereichs dieses Knotens fest.
String	toString()
final Vector3	worldToLocalDirection(Vector3-Richtung) Wandelt eine Richtung vom Weltall in den lokalen Bereich dieses Knotens um.
final Vector3	worldToLocalPoint(Vector3-Punkt) Wandelt einen Punkt im Weltall in den lokalen Bereich dieses Knotens um.

Von Klasse com.google.ar.sceneform.NodeParent

Finale void	addChild(Node-Child) Fügt einen Knoten als untergeordnetes Element dieses NodeParents hinzu.
Ungültig	callOnHierarchy(Nutzer;Knoten> Nutzer) die Hierarchie durchlaufen und auf jedem Knoten eine Methode aufrufen
boolean	canAddChild(Node-Child, StringBuilder errorReason)
Knoten	findByName(String-Name) Durchlaufen Sie die Hierarchie, um den ersten Knoten mit einem bestimmten Namen zu finden.
Knoten	findInHierarchy(Predicate<Node> Bedingung) Durchlaufen Sie die Hierarchie, um den ersten Knoten zu finden, der eine Bedingung erfüllt.
final List<Knoten>	getChildren() Gibt eine unveränderliche Liste dieser übergeordneten Elemente zurück.
Ungültig	onAddChild(Node-Untergeordnetes Element)
Ungültig	onRemoveChild(Node-Untergeordnetes)
Finale void	removeChild(Node-Kind) Entfernt einen Knoten aus den untergeordneten Elementen dieses NodeParent.

Aus Klasse java.lang.Object

Objekt	clone()
boolean	equals(Objekt arg0)
Ungültig	endgültig()
final Class<?>	getClass()
int	hashCode()
Finale void	benachrichtigen()
Finale void	notifyAll()
String	toString()
Finale void	wait(langes arg0, int-arg1)
Finale void	wait(langes Argument0)
Finale void	wait()

Public Methods

öffentlichen Gleitkomma getFarClipPlane ()

öffentlichen Gleitkomma getNearClipPlane ()

public float getVerticalFovDedegrees ()

Ruft das vertikale Sichtfeld für die Kamera ab.

Wenn dies eine AR-Kamera ist, wird sie basierend auf den Kamerainformationen von ARCore berechnet und kann je nach Gerät variieren. Sie kann erst berechnet werden, wenn der erste Frame nach dem Fortsetzen der ARCore-Sitzung fortgesetzt wurde. In diesem Fall wird eine IllegalStateException ausgelöst.

Andernfalls wird der von setVerticalFovDegrees(float) festgelegte Wert mit einem Standardwert von 90 Grad zurückgegeben.

Throws

IllegalStateException	Bei Aufruf vor dem ersten Frame nach Fortsetzen von ARCore

öffentlich Ray screenPointToRay (Gleitkommazahl x, Gleitkommazahl y)

Berechnet einen Strahl im Weltall, der von der Kamera in der Nähe des Flugzeugs zu einem Punkt im Bildschirm führt. Der Bildschirmbereich wird in Bildschirmkoordinaten des Android-Geräts angegeben: Oben links = (0, 0) BottomRight = (Bildschirmbreite, Bildschirmhöhe) Der Gerätekoordinatenraum ist von der Geräteausrichtung nicht betroffen.

Parameter

x	X-Position in Bildschirmkoordinaten des Geräts.
y	Y-Position in Bildschirmkoordinaten des Geräts

public void setLocalPosition (Vector3-Position)

Position der Kamera festlegen. Die Kamera isTopLevel() ist immer gleich und verhält sich daher genauso wie setWorldPosition(Vector3).

Wenn die Kamera Teil eines ArSceneView ist, wird dieser Vorgang nicht unterstützt. Die Position der Kamera kann nicht geändert werden. Sie wird durch die ARCore-Kamerastellung gesteuert.

Parameter

position	Die anzuwendende Position.

public void setLocalRotation (Quaternion-Rotation)

Legen Sie die Kameradrehung fest. Die Kamera isTopLevel() ist immer gleich und verhält sich daher genauso wie setWorldRotation(Quaternion).

Wenn die Kamera Teil eines ArSceneView ist, wird dieser Vorgang nicht unterstützt. Die Kameradrehung kann nicht geändert werden. Sie wird über die ARCore-Kamerastellung gesteuert.

Parameter

Rotation	Die anzuwendende Rotation.

public void setParent (NodeParent übergeordnetes Element)

Nicht unterstützter Vorgang. Das übergeordnete Element der Kamera kann nicht geändert werden, es ist immer die Szene.

Parameter

Übergeordnetes Element	Das neue übergeordnete Element, dem dieser Knoten untergeordnet sein wird. Bei null wird dieser Knoten von seinem übergeordneten Element getrennt.

public void setVerticalFovDedegrees (float verticalFov)

Legt das vertikale Sichtfeld für die Nicht-Arche-Kamera in Grad fest. Wenn dies eine AR-Kamera ist, stammt der Fov von ARCore und kann nicht festgelegt werden, sodass eine Ausnahme ausgelöst wird. Der Standardwert ist 90 Grad.

Parameter

Vertikal

Throws

Nicht unterstützteOperationAusnahme	wenn es sich um eine AR-Kamera handelt

public void setWorldPosition (Vector3-Position)

Position der Kamera festlegen. Die Kamera isTopLevel() ist immer gleich und verhält sich daher genauso wie setLocalPosition(Vector3).

Wenn die Kamera Teil eines ArSceneView ist, wird dieser Vorgang nicht unterstützt. Die Position der Kamera kann nicht geändert werden. Sie wird durch die ARCore-Kamerastellung gesteuert.

Parameter

position	Die anzuwendende Position.

public void setWorldRotation (Quaternion-Rotation)

Legen Sie die Kameradrehung fest. Die Kamera isTopLevel() ist immer gleich und verhält sich daher genauso wie setLocalRotation(Quaternion).

Wenn die Kamera Teil eines ArSceneView ist, wird dieser Vorgang nicht unterstützt. Die Kameradrehung kann nicht geändert werden. Sie wird über die ARCore-Kamerastellung gesteuert.

Parameter

Rotation	Die anzuwendende Rotation.

public Vector3 worldToScreenPoint (Vector3 Punkt)

Damit lässt sich ein Punkt aus dem Weltall in einen Bildschirmbereich umwandeln.

Der X-Wert ist negativ, wenn der Punkt links vom Darstellungsbereich liegt, zwischen 0 und der Breite von SceneView, wenn sich der Punkt innerhalb des Darstellungsbereichs befindet, und größer als die Breite, wenn sich der Punkt rechts vom Darstellungsbereich befindet.

Der Y-Wert ist negativ, wenn der Punkt unterhalb des Darstellungsbereichs liegt, zwischen 0 und der Höhe von SceneView, wenn sich der Punkt innerhalb des Darstellungsbereichs befindet, und größer als die Höhe, wenn der Punkt über dem Darstellungsbereich liegt.

Der Z-Wert ist immer 0, da der Rückgabewert eine 2D-Koordinate ist.

Parameter

point	der Welt, aus der

Rückgabe:

• ein neuer Vektor, der den Punkt im Bildschirmbereich darstellt