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 | |
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 | |
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 | |
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 | |
Ungültig |
setRenderable(Renderable - renderbar)
Legt fest, dass
Renderable für diesen Knoten angezeigt werden soll. |
Ungültig | |
Ungültig | |
Ungültig | |
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 | |
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 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 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.
ö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.
- Die
onUpdate(FrameTime)
-Funktion des Knotens wird in jedem Frame aufgerufen. - Das
getRenderable()
-Objekt des Knotens wird gerendert. - Der Knoten
getCollisionShape()
wird in Aufrufen von Scene.hitTest geprüft. - Die
onTouchEvent(HitTestResult, MotionEvent)
-Funktion des Knotens wird aufgerufen, wenn der Knoten berührt wird.
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.
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.
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
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
Geschützte Methoden
geschützt final Boolesch canAddChild (Node untergeordnetes Element, StringBuilder errorReason)
Parameter
Kind | |
---|---|
Fehlergrund |