AugmentedFaceNode

Öffentliche Klasse AugmentedFaceNode

Knoten zum Rendern visueller Effekte auf einem Gesicht mit der ARCore-Funktion AugmentedFace.

Die visuellen Effekte können aus bis zu zwei Komponenten bestehen – dem Mesh-Netzwerk aus Gesichtern und den gerenderten Gesichterbereichen.

Mit dem Face Mesh können Sie 2D-Bilder visualisieren, die der Oberfläche einer Person zugeordnet sind. Die gerenderten Gesichterbereiche werden zur Visualisierung von 3D-Objekten (z.B. Fuchsnase und Ohren) verwendet, die sich mit den von ARCore erfassten Gesichtsbereichen bewegen.

Beim Erstellen von Renderable-Gesichtsregionen werden die Regionen den Knochen im Modell zugeordnet. Verwende die bereitgestellte XLSX-Beispieldatei, um Gesichterbereiche im richtigen Format zu rendern.

Dieser Knoten ist so positioniert, dass er der Pose aus getCenterPose() entspricht.

Die visuellen Effekte werden deaktiviert, wenn das AugmentedFace-Tracking nicht ist oder wenn AugmentedFace auf null festgelegt ist.

Public Constructors

	AugmentedFaceNode() Erstellen Sie einen AugmentedFaceNode ohne AugmentedFace.
	AugmentedFaceNode(AugmentedFace ugmentedFace) Erstellt einen AugmentedFaceNode mit dem angegebenen AugmentedFace.

Public Methods

AugmentedFace	getAugmentedFace aufrufen Gibt den AugmentedFace zurück, auf den dieser Knoten visuelle Effekte anwendet.
Material	getFaceMeshMaterialOverride() Gibt das Material zurück, das derzeit das Rendering des Mesh-Netzwerks überlagert.
Textur	getFaceMeshTexture Gibt die auf dem Gesichtsnetz gerenderte Textur zurück.
ModellRenderable	getFaceRegionsRenderable Gibt das Renderable zurück, das den Regionen auf dem Gesicht zugeordnet ist.
Ungültig	onActivate() Wird verarbeitet, wenn dieser Knoten aktiv wird.
Ungültig	onUpdate(FrameTime FrameTime) Wird verarbeitet, wenn dieser Knoten aktualisiert wird.
Ungültig	setAugmentedFace(AugmentedFace-Gesicht) Legt die AugmentedFace fest, auf die dieser Knoten visuelle Effekte anwendet.
Ungültig	setFaceMeshMaterialOverride(Material-Material) Legt das Material fest, das zum Rendern des Gitternetzes verwendet wird.
Ungültig	setFaceMeshTexture(Textur-Textur) Legt die Textur fest, die im Mesh-Netzwerk gerendert wird.
Ungültig	setFaceRegionsRenderable(ModelRenderable-renderable) Legt das Renderable fest, das den Regionen des Gesichts zugeordnet ist.

Ü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 Constructors

öffentlich AugmentedFaceNode ()

Erstellen Sie einen AugmentedFaceNode ohne AugmentedFace.

public AugmentedFaceNode (AugmentedFace augmentedFace)

Erstellt einen AugmentedFaceNode mit dem angegebenen AugmentedFace.

Parameter

Augmented Face

Public Methods

public AugmentedFace getAugmentedFace ()

Gibt den AugmentedFace zurück, auf den dieser Knoten visuelle Effekte anwendet.

public Material getFaceMeshMaterialOverride ()

Gibt das Material zurück, das derzeit das Rendering des Mesh-Netzwerks überlagert. Der Standardwert ist null.

public Texture getFaceMeshTexture ()

Gibt die auf dem Gesichtsnetz gerenderte Textur zurück. Der Standardwert ist null.

Hinweis: Diese Option wird nur verwendet, wenn das Mesh-Material des Gesichts nicht überschrieben wurde.

öffentlich ModelRenderable getFaceRegionsRenderable ()

Gibt das Renderable zurück, das den Regionen auf dem Gesicht zugeordnet ist. Sie muss mit Knochen ausgestattet sein, die mit den Gesichtsbereichen übereinstimmen. Verwenden Sie die bereitgestellte XLSX-Beispieldatei, um Gesichterbereiche zu exportieren, die im richtigen Format gerendert werden können.

public void onActivate ()

Wird verarbeitet, wenn dieser Knoten aktiv wird. Ein Knoten ist aktiv, wenn er Teil einer Szene ist und sein übergeordnetes Element aktiv ist.

Überschreiben, um alle Einrichtungsschritte auszuführen, die ausgeführt werden müssen, wenn der Knoten aktiviert wird.

öffentlich void onUpdate (FrameTime FrameTime)

Wird verarbeitet, wenn dieser Knoten aktualisiert wird. Ein Knoten wird aktualisiert, bevor die einzelnen Frames gerendert werden. Dies wird nur aufgerufen, wenn der Knoten aktiv ist.

Überschreiben, um Aktualisierungen durchzuführen, die in jedem Frame erfolgen müssen

Parameter

FrameTime	stellt Zeitinformationen für den aktuellen Frame bereit

Öffentlich void setAugmentedFace (AugmentedFace Gesicht)

Legt die AugmentedFace fest, auf die dieser Knoten visuelle Effekte anwendet.

Parameter

Gesicht

public void setFaceMeshMaterialOverride (Material material)

Legt das Material fest, das zum Rendern des Gitternetzes verwendet wird. Für das überschreibende Material wird getFaceMeshTexture() nicht verwendet. Setzen Sie den Wert auf null zurück, um das Standardmaterial wiederherzustellen.

Parameter

material

public void setFaceMeshTexture (Textur-Textur)

Legt die Textur fest, die im Mesh-Netzwerk gerendert wird.

Hinweis: Diese Option wird nur verwendet, wenn das Mesh-Material des Gesichts nicht überschrieben wurde.

Parameter

Textur

public void setFaceRegionsRenderable (ModelRenderable renderable)

Legt das Renderable fest, das den Regionen des Gesichts zugeordnet ist. Sie muss mit Knochen ausgestattet sein, die mit den Gesichtsbereichen übereinstimmen. Verwenden Sie die bereitgestellte XLSX-Beispieldatei, um Gesichterbereiche zu exportieren, die im richtigen Format gerendert werden können.

Parameter

renderbar