Knoten

Öffentliche Klasse Node
Bekannte direkte Unterklassen
Bekannte indirekte Unterklassen

Ein Knoten stellt eine Transformation innerhalb der Hierarchie der Szenengrafik dar. Sie kann ein Rendering enthalten, das vom Rendering-Modul gerendert werden muss.

Jeder Knoten kann eine beliebige Anzahl von untergeordneten Knoten und einen übergeordneten Knoten haben. Das übergeordnete Element kann ein anderer Knoten oder die Szene sein.

Verschachtelte Klassen

Schnittstelle Node.LebenszyklusListener Schnittstellendefinition für Callbacks, die bei Lebenszyklusereignissen des Knotens aufgerufen werden sollen. 
Schnittstelle Node.OnTapListener Schnittstellendefinition für einen Callback, der ausgelöst wird, wenn auf einen Knoten getippt wird. 
Schnittstelle Node.OnTouchListener Schnittstellendefinition für einen Callback, der ausgelöst wird, wenn ein Touch-Ereignis an diesen Knoten gesendet wird. 
Schnittstelle Node.TransformChangedListener Schnittstellendefinition für Callbacks, die aufgerufen werden sollen, wenn sich die Transformation des Knotens ändert. 

Public Constructors

Knoten()
Erstellt einen Knoten ohne übergeordnetes Element.

Public Methods

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).
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.
Ungültig
onDisable()
Wird verarbeitet, wenn dieser Knoten inaktiv wird.
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.

Geschützte Methoden

Boolescher Wert
canAddChild(Node-Child, StringBuilder errorReason)
Finale void
onAddChild(Node-Untergeordnetes Element)
Finale void
onRemoveChild(Node-Untergeordnetes)

Übernommene Methoden

Public Constructors

öffentlich Knoten ()

Erstellt einen Knoten ohne übergeordnetes Element.

Public Methods

public void addLifecycleListener (Node.LifecycleListenerlebenszyklusListener)

Fügt einen Listener hinzu, der aufgerufen wird, wenn Ereignisse im Knotenlebenszyklus auftreten. Die Listener werden in der Reihenfolge aufgerufen, in der sie hinzugefügt wurden.

Parameter
Lebenszyklus-Listener

public void addTransformChangedListener (Node.TransformChangedListener transformChangedListener)

Fügt einen Listener hinzu, der aufgerufen wird, wenn sich die Transformation des Knotens ändert.

Parameter
TransformationChangedListener

public void callOnHierarchy (Verbraucher ; Verbraucher)

Durchquert die Hierarchie und ruft eine Methode auf jedem Knoten auf (einschließlich dieses Knotens). Die Durchsuchung ist zuerst Tiefe.

Parameter
Nutzer Methode, die auf jedem Knoten aufgerufen wird

public Node findInHierarchy (Predicate<Node> Bedingung)

Durchläuft die Hierarchie, um den ersten Knoten (einschließlich dieses Knotens) zu finden, der eine Bedingung erfüllt. Sobald das Prädikat erfüllt ist, wird der Durchlauf beendet. Die Durchsuchung ist zuerst Tiefe.

Parameter
Bedingung Prädikat definiert die Bedingungen des zu suchenden Knotens.
Rückgabe:
  • dem ersten Knoten, der die Bedingungen des Prädikats erfüllt. Andernfalls wird null zurückgegeben.

public final Vector3 getBack ()

Ruft den Back-End-Weltvektor (+z) dieses Knotens ab.

Rückgabe:
  • Ein neuer Vektor für die Rückwärtsrichtung des Knotens im Weltall

public CollisionShape getCollisionShape ()

Ruft die Form ab, die für Kollisionen mit diesem Knoten verwendet werden soll. Wenn die Form null ist und setRenderable(Renderable) festgelegt ist, wird getCollisionShape() verwendet, um Kollisionen für diese Node zu erkennen.

Rückgabe:
  • stellt eine geometrische Form dar, d.h. eine Kugel, einen Kasten oder eine konvexe Hülle.
Weitere Informationen

public final Vector3 getDown ()

Ruft den nach unten gehenden Vektor (-y) für den Weltraum ab.

Rückgabe:
  • ein neuer Vektor für die Knotenrichtung im Weltall

public final Vector3 getForward ()

Ruft den World-Space-Forward-Vektor (-z) dieses Knotens ab.

Rückgabe:
  • Ein neuer Vektor für die Vorwärtsrichtung des Knotens im Weltall

public final Vector3 getLeft ()

Ruft den World-Space-Linksvektor (-x) dieses Knotens ab.

Rückgabe:
  • Ein neuer Vektor steht für die Richtung des Knotens im Weltall

public Light getLight ()

Ruft das aktuelle Licht ab, das änderbar ist.

public final Vector3 getLocalPosition ()

Ruft eine Kopie der Knotenposition in Bezug auf das übergeordnete Element (lokaler Bereich) ab. Wenn isTopLevel() „true“ ist, entspricht dies getWorldPosition().

Rückgabe:
  • Ein neuer Vektor für die Local-Space-Position des Knotens
Weitere Informationen

public final Quaternion getLocalRotation ()

Ruft eine Kopie der Knotenrotation in Bezug auf das übergeordnete Element (lokaler Bereich) ab. Wenn isTopLevel() „true“ ist, entspricht dies getWorldRotation().

Rückgabe:
  • eine neue Quartion, die die Rotation des lokalen Gruppenbereichs darstellt
Weitere Informationen

public final Vector3 getLocalScale ()

Ruft eine Kopie der Knotenskalierung in Bezug auf das übergeordnete Element (lokaler Bereich) ab. Wenn isTopLevel() „true“ ist, entspricht dies getWorldScale().

Rückgabe:
  • Ein neuer Vektor für die Skalierung des lokalen Bereichs des Knotens
Weitere Informationen

public final String getName ()

Gibt den Namen des Knotens zurück. Der Standardwert ist "Node".

public final Node getParent ()

Gibt das übergeordnete Element dieses Knotens zurück. Wenn dieses Node ein übergeordnetes Element hat und dieses übergeordnete Element eine Node- oder Node-Unterklasse ist, gibt diese Funktion das übergeordnete Element als Node zurück. Gibt null zurück, wenn das übergeordnete Element Scene ist. Verwende stattdessen getScene(), um das übergeordnete Element abzurufen.

Rückgabe:
  • Das übergeordnete Element als Node, wenn das übergeordnete Element ein Node ist.

öffentlich Renderable getRenderable ()

Ruft das Rendering ab, das für diesen Knoten angezeigt werden soll.

Rückgabe:
  • Kann für diesen Knoten angezeigt werden

public final Vector3 getRight ()

Ruft den World-Space-Right-Vektor (+x) dieses Knotens ab.

Rückgabe:
  • Ein neuer Vektor für die korrekte Richtung des Knotens im Weltall

public final Scene getScene ()

Gibt das Ambiente zurück, zu dem dieser Knoten gehört. Der Wert ist null, wenn er zu keiner Szene gehört. Ein Knoten ist Teil einer Szene, wenn der übergeordnete Vorgänger der Ebene ein Scene ist

public final Vector3 getUp ()

Ruft den „Weltraum-up“-Vektor (+y) dieses Knotens ab.

Rückgabe:
  • Ein neuer Vektor für die Knotenrichtung im Weltall

public final Vector3 getWorldPosition ()

Kopieren Sie die Position des Weltbereichs des Knotens.

Rückgabe:
  • Ein neuer Vektor für die Welt-Weltposition des Knotens
Weitere Informationen

public final Quaternion getWorldRotation ()

Ruft eine Kopie der Rotation der Welt-Welt des Knotens ab.

Rückgabe:
  • eine neue Quartera, die die Rotation des Weltraums des Knotens darstellt
Weitere Informationen

public final Vector3 getWorldScale ()

Ruft eine Kopie der World-Space-Skalierung des Knotens ab. Eine gewisse Genauigkeit geht verloren, wenn der Knoten verzerrt ist.

Rückgabe:
  • Ein neuer Vektor für die Größe des Weltalls des Knotens
Weitere Informationen

public final Boolesch isActive ()

Gibt „true“ zurück, wenn der Knoten aktiv ist. Ein Knoten gilt als aktiv, wenn er ALLE folgenden Bedingungen erfüllt:

  • Der Knoten ist Teil einer Szene.
  • Das übergeordnete Element des Knotens ist aktiv.
  • Der Knoten ist aktiviert.
Ein aktiver Knoten hat das folgende Verhalten:

Rückgabe:
  • Status des aktiven Knotens
Weitere Informationen

public final Boolesch isDescendantOf (NodeParent Parent)

Prüft, ob der übergeordnete Knoten rekursiv ein Vorgänger dieses Knotens ist.

Parameter
Ancestor das zu prüfende übergeordnete Element des Knotens
Rückgabe:
  • "true", wenn der Knoten ein Vorgänger dieses Knotens ist

public final Boolesch isEnabled ()

Ruft den aktivierten Status dieses Knotens ab. Ein Knoten kann aktiviert, aber inaktiv sein, wenn er nicht Teil der Szene ist oder sein übergeordnetes Element inaktiv ist.

Rückgabe:
  • des Aktivierungsstatus des Knotens.
Weitere Informationen

Öffentlich boolesch isTopLevel ()

Gibt „true“ zurück, wenn dieser Knoten die oberste Ebene ist. Ein Knoten gilt als oberste Ebene, wenn er kein übergeordnetes Element hat oder wenn das übergeordnete Element die Szene ist.

Rückgabe:
  • „true“, wenn der Knoten die oberste Ebene ist

public final Vector3 localToWorldDirection (Vector3 Direction)

Wandelt eine Richtung vom lokalen Gruppenbereich dieses Knotens in einen globalen Gruppenbereich um. Nicht von der Position oder Skalierung des Knotens betroffen.

Parameter
direction die Richtung im lokalen Bereich, die konvertiert werden soll.
Rückgabe:
  • ein neuer Vektor, der die Richtung im Weltall darstellt

public final Vector3 localToWorldPoint (Vector3 Punkt)

Konvertiert einen Punkt im lokalen Gruppenbereich dieses Knotens in den Weltbereich.

Parameter
point der Punkt im lokalen Bereich, der konvertiert werden soll
Rückgabe:
  • ein neuer Vektor, der den Punkt im Weltall darstellt

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.

Weitere Informationen

public void onDisable ()

Wird verarbeitet, wenn dieser Knoten inaktiv wird. Ein Knoten ist inaktiv, wenn er deaktiviert ist, kein Teil einer Szene ist oder sein übergeordnetes Element inaktiv ist.

Überschreiben, um alle Einrichtungsschritte auszuführen, die erforderlich sind, wenn der Knoten deaktiviert wird.

Weitere Informationen

Public Boolesch onTouchEvent (HitTestResult hitTestResult, MotionEventmotionEvent)

Wird verarbeitet, wenn dieser Knoten berührt wird.

Überschreiben, um alle Logiken auszuführen, die auftreten sollen, wenn dieser Knoten berührt wird. Die Art und Weise, wie Touch-Ereignisse weitergegeben werden, entspricht der Art und Weise, wie Touch-Ereignisse an Android-Ansichten weitergegeben werden. Dies wird nur aufgerufen, wenn der Knoten aktiv ist.

Wenn ein ACTION_DOWN-Ereignis auftritt, stellt dies den Anfang einer Geste dar. ACTION_UP oder ACTION_CANCEL, wenn eine Geste endet. Wenn eine Geste gestartet wird, geschieht Folgendes:

  • Sendet Touch-Ereignisse an den berührten Knoten, der von hitTest(MotionEvent) erkannt wurde.
  • Wenn der Knoten das Ereignis nicht verarbeitet, wiederholen Sie die übergeordneten Elemente des Knotens nach oben und leiten das Touch-Ereignis weiter, bis einer der Knoten das Ereignis aufnimmt.
  • Wenn keine Knoten das Ereignis aufnehmen, wird die Geste ignoriert und nachfolgende Ereignisse, die Teil der Bewegung sind, werden nicht an Knoten weitergegeben.
  • Wenn eines der Knoten die Veranstaltung nutzt, nutzt dieses Knoten alle zukünftigen Touch-Ereignisse für die Geste.
Wenn ein Touch-Ereignis an einen Knoten gesendet wird, wird es zuerst an den Node.OnTouchListener des Knotens übergeben. Wenn Node.OnTouchListener das Ereignis nicht verarbeitet, wird es an onTouchEvent(HitTestResult, MotionEvent) übergeben.

Parameter
Treffer-Testergebnis Der berührte Knoten und Informationen dazu, wo er berührt wurde. Bei ACTION_DOWN-Ereignissen ist getNode() immer dieser Knoten oder einer seiner untergeordneten Elemente. Bei anderen Ereignissen hat sich die Berührung möglicherweise bewegt und der getNode() hat sich geändert (oder ist möglicherweise null).
Bewegungsereignis Das Bewegungsereignis.
Rückgabe:
  • Dieser Wert ist „True“, wenn das Ereignis verarbeitet wurde, andernfalls „False“.

public void onTransformChange (Knoten originNode)

Wird verarbeitet, wenn die Transformation dieses Knotens geändert wird.

Der Ursprungsknoten ist der oberste Knoten in der Hierarchie, der die Änderung dieses Knotens ausgelöst hat. Dies ist immer entweder derselbe Knoten oder ein übergeordneter Knoten. Wenn sich die Position des Knotens ändert, wird onTransformChange(Node) also für alle untergeordneten Knoten aufgerufen, wobei der Ursprungsknoten Knoten A ist.

Parameter
Ursprungsknoten der Knoten, der die Transformation dieses Knotens ausgelöst hat

ö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

public void removeLifecycleListener (Node.LifecycleListenerlebenszyklusListener)

Entfernt einen Listener, der bei Lebenszyklusereignissen des Knotens aufgerufen wird.

Parameter
Lebenszyklus-Listener

public void removeTransformChangedListener (Node.TransformChangedListener transformChangedListener)

Entfernt einen Listener, der aufgerufen wird, wenn sich die Transformation des Knotens ändert.

Parameter
TransformationChangedListener

public void setCollisionShape (CollisionShape kollisionShape)

Legt die Form fest, mit der Kollisionen für diesen Node erkannt werden. Wenn die Form nicht festgelegt und setRenderable(Renderable) festgelegt ist, wird getCollisionShape() verwendet, um Konflikte für dieses Node zu erkennen.

Parameter
kollisionsform stellt eine geometrische Form dar, d.h. eine Kugel, einen Kasten oder eine konvexe Hülle. Wenn dieser Wert null ist, wird die aktuelle Kollisionsform dieses Knotens entfernt.
Weitere Informationen

public final void setEnabled (boole aktiviert)

Legt den aktivierten Status dieses Knotens fest. Ein Knoten kann aktiviert, aber inaktiv sein, wenn er nicht Teil der Szene ist oder sein übergeordnetes Element inaktiv ist.

Parameter
aktiviert Der neue aktivierte Status des Knotens
Weitere Informationen

public void setLight (Light, Licht)

Legt fest, dass Light angezeigt werden soll. Erstelle zuerst ein Light mit Light.Builder. Legen Sie die gewünschten Parameter fest und hängen Sie sie mit dieser Funktion an den Knoten an. Ein Knoten kann ein Renderer und eine Lampe haben oder als Light fungieren.

Parameter
Licht Eigenschaften von Light, die gerendert werden sollen. Übergeben Sie null, um das Licht zu entfernen.

public void setLocalPosition (Vector3-Position)

Legt die Position dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest. Wenn isTopLevel() „true“ ist, entspricht dies setWorldPosition(Vector3).

Parameter
position Die anzuwendende Position.
Weitere Informationen

public void setLocalRotation (Quaternion-Rotation)

Legt die Rotation dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest. Wenn isTopLevel() „true“ ist, entspricht dies setWorldRotation(Quaternion).

Parameter
Rotation Die anzuwendende Rotation.
Weitere Informationen

public void setLocalScale (Vector3-Skalierung)

Legt die Skalierung dieses Knotens relativ zu seinem übergeordneten Element (lokaler Bereich) fest. Wenn isTopLevel() „true“ ist, entspricht dies setWorldScale(Vector3).

Parameter
profitieren Die anzuwendende Waage.
Weitere Informationen

public final void setLookDirection (Vector3 LookDirection)

Legt die Richtung fest, die der Knoten im Weltall betrachtet. Nach dem Aufruf entspricht getForward() der übergebenen Blickrichtung. Mit der Leertaste oben (0, 1, 0) wird die Ausrichtung des Knotens in Richtung der Richtung bestimmt.

Parameter
LookDirection Ein Vektor, der die gewünschte Blickrichtung im Weltall darstellt

public final void setLookDirection (Vector3lookDirection, Vector3 upDirection)

Legt die Richtung fest, die der Knoten im Weltall betrachtet. Nach dem Aufruf entspricht getForward() der übergebenen Blickrichtung. Die Richtung oben bestimmt die Ausrichtung des Knotens um die Richtung. Die Blickrichtung und die Richtung nach oben dürfen nicht parallel (parallel) sein oder die Ausrichtung ist ungültig.

Parameter
LookDirection Ein Vektor, der die gewünschte Blickrichtung im Weltall darstellt
UpDirection Ein Vektor, der einen gültigen zu verwendenden Vektor darstellt, z. B. Vector3.up()

public final void setName (String name)

Legt den Namen dieses Knotens fest. Knoten können anhand ihres Namens gefunden werden. Möglicherweise haben mehrere Knoten denselben Namen. In diesem Fall wird beim Aufrufen von findByName(String) der erste Knoten mit dem angegebenen Namen zurückgegeben.

Parameter
name Der Name des Knotens.

public void setOnTapListener (Node.OnTapListener onTapListener)

Registriert einen Callback, der ausgelöst wird, wenn auf diesen Knoten getippt wird. Wenn ein Callback registriert ist, werden Touch-Ereignisse nicht in das übergeordnete Element dieses Knotens übertragen. Wenn Node.onTouchEvent überschrieben und super.onTouchEvent nicht aufgerufen wird, findet kein Tippen statt.

Parameter
onTapListener
Weitere Informationen

public void setOnTouchListener (Node.OnTouchListener onTouchListener)

Registriert einen Callback, der ausgelöst wird, wenn ein Touch-Ereignis an diesen Knoten gesendet wird. Die Art und Weise, wie Touch-Ereignisse weitergegeben werden, entspricht der Art und Weise, wie Touch-Ereignisse an Android-Ansichten weitergegeben werden. Dies wird nur aufgerufen, wenn der Knoten aktiv ist.

Wenn ein ACTION_DOWN-Ereignis auftritt, stellt dies den Anfang einer Geste dar. ACTION_UP oder ACTION_CANCEL, wenn eine Geste endet. Wenn eine Geste gestartet wird, geschieht Folgendes:

  • Sendet Touch-Ereignisse an den berührten Knoten, der von hitTest(MotionEvent) erkannt wurde.
  • Wenn der Knoten das Ereignis nicht verarbeitet, wiederholen Sie die übergeordneten Elemente des Knotens nach oben und leiten das Touch-Ereignis weiter, bis einer der Knoten das Ereignis aufnimmt.
  • Wenn keine Knoten das Ereignis aufnehmen, wird die Geste ignoriert und nachfolgende Ereignisse, die Teil der Bewegung sind, werden nicht an Knoten weitergegeben.
  • Wenn eines der Knoten die Veranstaltung nutzt, nutzt dieses Knoten alle zukünftigen Touch-Ereignisse für die Geste.
Wenn ein Touch-Ereignis an einen Knoten gesendet wird, wird es zuerst an den Node.OnTouchListener des Knotens übergeben. Wenn Node.OnTouchListener das Ereignis nicht verarbeitet, wird es an onTouchEvent(HitTestResult, MotionEvent) übergeben.

Parameter
onTouchListener
Weitere Informationen

public void setParent (NodeParent übergeordnetes Element)

Ändert den übergeordneten Knoten dieses Knotens. Bei der Einstellung null wird dieser Knoten von seinem übergeordneten Element getrennt. Die lokale Position, Rotation und Skalierung dieses Knotens bleibt unverändert. Daher können sich die Weltposition, Rotation und Skalierung dieses Knotens nach der Änderung des übergeordneten Elements unterscheiden.

Das übergeordnete Element kann ein anderes Node oder Scene sein. Wenn es sich um eine Szene handelt, gilt diese Node als oberste Ebene. getParent() gibt null zurück und getScene() gibt die Szene zurück.

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

public void setRenderable (Renderable renderable)

Legt fest, dass Renderable für diesen Knoten angezeigt werden soll. Wenn setCollisionShape(CollisionShape) nicht festgelegt ist, wird getCollisionShape() verwendet, um Konflikte für diese Node zu erkennen.

Parameter
renderbar Normalerweise ein 3D-Modell. Bei null wird das aktuell renderbare Element dieses Knotens entfernt.
Weitere Informationen

public void setWorldPosition (Vector3-Position)

Legt die Position des Weltbereichs dieses Knotens fest.

Parameter
position Die anzuwendende Position.
Weitere Informationen

public void setWorldRotation (Quaternion-Rotation)

Legt die Rotation des Weltraums dieses Knotens fest.

Parameter
Rotation Die anzuwendende Rotation.
Weitere Informationen

public void setWorldScale (Vector3-Skala)

Legt die Skalierung des Weltbereichs dieses Knotens fest.

Parameter
profitieren Die anzuwendende Waage.
Weitere Informationen

öffentlich String toString ()

public final Vector3 worldToLocalDirection (Vector3 Direction)

Wandelt eine Richtung vom Weltall in den lokalen Bereich dieses Knotens um. Nicht von der Position oder Skalierung des Knotens betroffen.

Parameter
direction die Richtung im Weltall, um sie zu konvertieren
Rückgabe:
  • ein neuer Vektor, der die Richtung im lokalen Raum darstellt

public final Vector3 worldToLocalPoint (Vector3 Punkt)

Wandelt einen Punkt im Weltall in den lokalen Bereich dieses Knotens um.

Parameter
point der im Weltall konvertiert werden muss,
Rückgabe:
  • ein neuer Vektor, der den Punkt im lokalen Raum darstellt

Geschützte Methoden

geschützt final Boolesch canAddChild (Node untergeordnetes Element, StringBuilder errorReason)

Parameter
Kind
Fehlergrund

geschützte letzte void onAddChild (Node untergeordnete)

Parameter
Kind

geschützte letzte void onRemoveChild (Node untergeordnete)

Parameter
Kind