Subclases directas conocidas |
Subcategorías indirectas conocidas |
Un nodo representa una transformación dentro de la jerarquía del gráfico de escena. Puede contener un elemento que se pueda renderizar para el motor de procesamiento.
Cada nodo puede tener una cantidad arbitraria de nodos secundarios y uno superior. El superior puede ser otro nodo o la escena.
Categorías anidadas
Interfaz | Node.LifecycleListener. | Definición de interfaz para las invocaciones que se invocan cuando ocurren eventos del ciclo de vida de los nodos. | |
Interfaz | Node.OnTapListener. | Definición de interfaz para que se invoque una devolución de llamada cuando se presiona un nodo | |
Interfaz | Node.OnTouchListener | Definición de interfaz para que se invoque una devolución de llamada cuando se envía un evento táctil a este nodo. | |
Interfaz | Node.TransformChangedListener | Definición de interfaz para las devoluciones de llamada que se invocan cuando cambia la transformación del nodo. |
Constructores públicos
Nodo()
Crea un nodo sin superior.
|
Métodos públicos
void |
addLifecycleListener(Node.LifecycleListenerlifecycleListener)
Agrega un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos.
|
void |
addTransformChangedListener(Node.TransformChangedListener transformChangedListener)
Agrega un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
|
void |
callOnHierarchy(consumidorNode> consumer)
Desvía la jerarquía y llama a un método en cada nodo (incluido este nodo).
|
Node |
findInHierarchy(condición <Nodo)
Desvía la jerarquía para encontrar el primer nodo (incluido este nodo) que cumpla con una condición.
|
Vector3 final |
getBack()
Obtiene el vector de retroceso de espacio mundial (+z) de este nodo.
|
CollisionShape. |
getCollisionShape()
Obtiene la forma que se usará para las colisiones con este nodo.
|
Vector3 final |
getDown()
Obtiene el vector descendente del espacio global (-y) de este nodo.
|
Vector3 final |
getForward()
Obtiene el vector de avance de espacio global (z-) de este nodo.
|
Vector3 final |
getLeft()
Obtiene el vector a la izquierda del espacio de mundo (-x) de este nodo.
|
Ligera |
getLight()
Obtiene la luz actual, que es mutable.
|
Vector3 final |
getLocalPosition()
Obtiene una copia de la posición de los nodos en relación con su elemento superior (espacio local).
|
Quaternion final |
getLocalRotation()
Obtiene una copia de la rotación de nodos en relación con su elemento superior (espacio local).
|
Vector3 final |
getLocalScale()
Obtiene una copia de la escala de nodos en relación con su elemento superior (espacio local).
|
String final |
getName()
Muestra el nombre del nodo.
|
Node final |
getParent().
Muestra el superior de este nodo.
|
Se puede renderizar |
getRenderable()
Obtiene el renderizado que se mostrará para este nodo.
|
Vector3 final |
getRight()
Obtiene el vector de espacio mundo (+x) de este nodo.
|
Scene final |
getScene()
Muestra la escena de la que forma parte este nodo, en caso de que no sea parte de ninguna escena.
|
Vector3 final |
getUp()
Obtiene el vector de espacio exterior (+y) de este nodo.
|
Vector3 final |
getWorldPosition().
Obtenga una copia de la posición en el espacio del nodo.
|
Quaternion final |
getWorldRotation()
Obtiene una copia de la rotación del espacio-mundo de los nodos.
|
Vector3 final |
getWorldScale()
Obtiene una copia de la escala de espacio global del nodo.
|
Booleano final |
La función está activa()
Muestra true si el nodo está activo.
|
Booleano final |
isDescendantOf(NodeParent)
Comprueba si el nodo principal determinado es un principal de este nodo de forma recursiva.
|
Booleano final |
está habilitada()
Obtiene el estado habilitado de este nodo.
|
boolean |
isTopLevel()
Muestra true si este nodo es de nivel superior.
|
Vector3 final |
localToWorldDirection(dirección Vector3)
Convierte una dirección del espacio local de este nodo a un espacio del mundo.
|
Vector3 final |
localToWorldPoint(punto Vector3)
Convierte un punto en el espacio local de este nodo en un espacio del mundo.
|
void |
onActivate()
Controla cuándo se activa este nodo.
|
void |
onDesactivar()
Controla cuándo se desactiva este nodo.
|
boolean |
onTouchEvent(HitTestResult hitTestResult, MotionEvent movimientoEvent)
Controla cuándo se toca este nodo.
|
void | |
void | |
void |
removeLifecycleListener(Node.LifecycleListenerlifecycleListener)
Quita un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos.
|
void |
removeTransformChangedListener(Node.TransformChangedListener transformChangedListener)
Quita un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
|
void |
setCollisionShape(collisionShape colisiónShape)
Configura la forma que se usará para detectar colisiones para este
Node . |
vacío final |
setEnabled(booleano habilitado)
Establece el estado habilitado de este nodo.
|
void | |
void |
setLocalPosition(posición Vector3)
Establece la posición de este nodo en relación con su elemento principal (espacio local).
|
void |
setLocalRotation(rotación Quaternion)
Establece la rotación de este nodo en relación con su elemento superior (espacio local).
|
void |
setLocalScale(escala Vector3)
Establece la escala de este nodo en relación con su elemento superior (espacio local).
|
vacío final | |
vacío final |
setLookDirection(Vector3 lookDirection y Vector3 upDirection)
Establece la dirección que el nodo observa en el espacio.
|
vacío final | |
void |
setOnTapListener(Node.OnTapListener onTapListener)
Registra una devolución de llamada que se invocará cuando se presione este nodo.
|
void |
setOnTouchListener(Node.OnTouchListener onTouchListener)
Registra una devolución de llamada que se invocará cuando se envíe un evento táctil a este nodo.
|
void | |
void | |
void | |
void | |
void | |
String |
toString()
|
Vector3 final |
worldToLocalDirection(dirección Vector3)
Convierte una dirección de un espacio-mundo al espacio local de este nodo.
|
Vector3 final |
worldToLocalPoint(punto Vector3)
Convierte un punto en el espacio mundial en el espacio local de este nodo.
|
Métodos protegidos
Booleano final | |
vacío final |
onAddChild(elemento secundario de Node)
|
vacío final |
onRemoveChild(elemento secundario Node)
|
Métodos heredados
Constructores públicos
public Nodo ()
Crea un nodo sin superior.
Métodos públicos
vacío público addLifecycleListener (Node.LifecycleListenerlifecycleListener)
Agrega un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos. Los objetos de escucha se llamarán en el orden en que se agregaron.
Parámetros
ciclode vida |
---|
vacío público addTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Agrega un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
Parámetros
TransformaciónChangedListener |
---|
vacío público callOnHierarchy (Consumidor<Nodo> consumidor)
Desvía la jerarquía y llama a un método en cada nodo (incluido este nodo). El recorrido es la profundidad en primer lugar.
Parámetros
consumidor | el método para llamar en cada nodo |
---|
público Node findInHierarchy (condición<Nodo> condition)
Desvía la jerarquía para encontrar el primer nodo (incluido este nodo) que cumpla con una condición. Una vez que se cumple el predicado, el recorrido se detiene. El recorrido es la profundidad en primer lugar.
Parámetros
condición | predicado define las condiciones del nodo que se va a buscar. |
---|
Resultado que se muestra
- el primer nodo que coincide con las condiciones del predicado; de lo contrario, se muestra un valor nulo
public final Vector3 getBack ()
Obtiene el vector de retroceso de espacio mundial (+z) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección inversa del nodo en el espacio mundial
public CollisionShape getCollisionShape ()
Obtiene la forma que se usará para las colisiones con este nodo. Si la forma es nula y se configura setRenderable(Renderable)
, se usa getCollisionShape()
a fin de detectar colisiones para este Node
.
Resultado que se muestra
- representa una forma geométrica, es decir, una esfera, una caja y una envolvente convexa.
Consulta también
public final Vector3 getDown ()
Obtiene el vector descendente del espacio global (-y) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección del nodo hacia abajo en el espacio mundial
public final Vector3 getForward ()
Obtiene el vector de avance de espacio global (z-) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección hacia delante del nodo en el espacio mundial
public final Vector3 getLeft ()
Obtiene el vector a la izquierda del espacio de mundo (-x) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección de la izquierda del nodo en el espacio
public final Vector3 getLocalPosition ()
Obtiene una copia de la posición de los nodos en relación con su elemento superior (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que getWorldPosition()
.
Resultado que se muestra
- un vector nuevo que representa la posición del espacio local del nodo
Consulta también
público Quaternion getLocalRotation ()
Obtiene una copia de la rotación de nodos en relación con su elemento superior (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que getWorldRotation()
.
Resultado que se muestra
- un nuevo cuaternión que representa la rotación del espacio local del nodo
Consulta también
public final Vector3 getLocalScale ()
Obtiene una copia de la escala de nodos en relación con su elemento superior (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que getWorldScale()
.
Resultado que se muestra
- un vector nuevo que representa la escala de espacio local del nodo
Consulta también
public final Node getParent ()
public Renderable getRenderable ()
Obtiene el renderizado que se mostrará para este nodo.
Resultado que se muestra
- puede mostrarse en este nodo
public final Vector3 getRight ()
Obtiene el vector de espacio mundo (+x) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección correcta del nodo en el espacio mundial
public final Scene getScene ()
Muestra la escena de la que forma parte este nodo, en caso de que no sea parte de ninguna escena. Un nodo es parte de una escena si su principal de nivel superior es un Scene
public final Vector3 getUp ()
Obtiene el vector de espacio exterior (+y) de este nodo.
Resultado que se muestra
- un nuevo vector que representa la dirección ascendente del nodo en el espacio mundial
public final Vector3 getWorldPosition ()
Obtenga una copia de la posición en el espacio del nodo.
Resultado que se muestra
- un nuevo vector que representa la posición en el espacio del nodo
Consulta también
público Quaternion getWorldRotation ()
Obtiene una copia de la rotación del espacio-mundo de los nodos.
Resultado que se muestra
- un nuevo cuaternión que representa la rotación del espacio-mundo del nodo
Consulta también
public final Vector3 getWorldScale ()
Obtiene una copia de la escala de espacio global del nodo. Se perderá algo de precisión si el nodo está sesgado.
Resultado que se muestra
- un nuevo vector que representa la escala espacial mundial del nodo
Consulta también
Booleano final público isActive ()
Muestra true si el nodo está activo. Un nodo se considera activo si cumple con TODAS las condiciones siguientes:
- El nodo es parte de una escena.
- el superior del nodo está activo.
- El nodo está habilitado.
- Se llamará a la función
onUpdate(FrameTime)
del nodo en cada marco. - Se renderizará el
getRenderable()
del nodo. - El
getCollisionShape()
del nodo se registrará en las llamadas a Scene.hitTest. - Se llamará a la función
onTouchEvent(HitTestResult, MotionEvent)
del nodo cuando se toque el nodo.
Resultado que se muestra
- el estado activo del nodo
Consulta también
Booleano final público isDescendantOf (NodeParent principal)
Comprueba si el nodo principal determinado es un principal de este nodo de forma recursiva.
Parámetros
principal | el superior del nodo que se debe verificar |
---|
Resultado que se muestra
- true si el nodo es un principal
Booleano final público isEnabled ()
Obtiene el estado habilitado de este nodo. Ten en cuenta que un nodo puede estar habilitado, pero aún inactivo, si no forma parte de la escena o si su elemento superior está inactivo.
Resultado que se muestra
- el estado habilitado del nodo.
Consulta también
Booleano público isTopLevel ()
Muestra true si este nodo es de nivel superior. Un nodo se considera de nivel superior si no tiene un principal o si es el principal de la escena.
Resultado que se muestra
- true si el nodo es de nivel superior
public final Vector3 localToWorldDirection (Dirección Vector3)
Convierte una dirección del espacio local de este nodo a un espacio del mundo. No se ven afectados por la posición o escala del nodo.
Parámetros
direction | la dirección en el espacio local para convertir |
---|
Resultado que se muestra
- un vector nuevo que representa la dirección en el espacio
public final Vector3 localToWorldPoint (Punto3)
Convierte un punto en el espacio local de este nodo en un espacio del mundo.
Parámetros
point | el punto en el espacio local para convertir |
---|
Resultado que se muestra
- un nuevo vector que representa el punto en el espacio
vacío público onActivate ()
Controla cuándo se activa este nodo. Un nodo está activo si está habilitado, es parte de una escena y su elemento superior está activo.
Anula para realizar cualquier configuración que deba ocurrir cuando se activa el nodo.
Consulta también
vacío público onOff ()
Controla cuándo se desactiva este nodo. Un nodo está inactivo si está inhabilitado, no es parte de una escena o su superior está inactivo.
Anula para realizar cualquier configuración que deba ocurrir cuando se desactiva el nodo.
Consulta también
Booleano público onTouchEvent (HitTestResult hitTestResult, MotionEvent movimientoEvent)
Controla cuándo se toca este nodo.
Anula para realizar cualquier lógica que deba ocurrir cuando se toca este nodo. La manera en que se propagan los eventos táctiles es la misma que se propagan los toques en las vistas de Android. Solo se lo llama cuando el nodo está activo.
Cuando ocurre un evento ACTION_DOWN, eso representa el inicio de un gesto. ACTION_UP o ACTION_CANCEL representa cuándo finaliza un gesto. Cuando se inicia un gesto, se hace lo siguiente:
- Envía eventos táctiles al nodo que se detectó como detectado por
hitTest(MotionEvent)
. - Si el nodo no consume el evento, recurre hacia arriba a través de los elementos superiores del nodo y envía el evento táctil hasta que uno de los nodos consuma el evento.
- Si ningún nodo consume el evento, el gesto se ignora y los eventos posteriores que forman parte del gesto no se pasarán a ningún nodo.
- Si uno de los nodos consume el evento, ese nodo consumirá todos los eventos táctiles futuros del gesto.
Node.OnTouchListener
del nodo. Si Node.OnTouchListener
no controla el evento, se pasa a onTouchEvent(HitTestResult, MotionEvent)
.Parámetros
hitTestResult | Representa el nodo que se tocó y la información sobre dónde se tocó. En los eventos ACTION_DOWN, getNode() siempre será este nodo o uno de sus elementos secundarios. En otros eventos, es posible que el toque se haya movido y haya cambiado getNode() (o posiblemente sea nulo). |
---|---|
MotionEvent | El evento de movimiento. |
Resultado que se muestra
- Verdadero si el evento se manejó, de lo contrario, es falso.
vacío público onTransformChange (NodeoriginNode)
Controla cuándo se cambia la transformación de este nodo.
El nodo de origen es el nodo de nivel superior en la jerarquía que activó este cambio. Siempre será el mismo nodo o uno de sus nodos superiores; es decir, si se cambia la posición del nodo A, se activará onTransformChange(Node)
para todos sus elementos secundarios, y el nodo de origen será el nodo A.
Parámetros
origenNodo | el nodo que activó la transformación de este nodo para cambiar |
---|
vacío público onUpdate (FrameTime frameTime)
Controla cuándo se actualiza este nodo. Se actualiza un nodo antes de procesar cada fotograma. Solo se lo llama cuando el nodo está activo.
Anula para realizar las actualizaciones necesarias en cada fotograma.
Parámetros
Latencia de fotogramas | proporciona información de tiempo para el fotograma actual |
---|
vacío público removeLifecycleListener (Node.LifecycleListenerlifecycleListener)
Quita un objeto de escucha al que se llamará cuando se produzcan eventos de ciclo de vida de los nodos.
Parámetros
ciclode vida |
---|
vacío público removeTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Quita un objeto de escucha al que se llamará cuando cambie la transformación del nodo.
Parámetros
TransformaciónChangedListener |
---|
vacío público setCollisionShape (CollisionShape collisionShape)
Configura la forma que se usará para detectar colisiones para este Node
. Si no se establece la forma y se configura setRenderable(Renderable)
, se usa getCollisionShape()
a fin de detectar colisiones para esta Node
.
Parámetros
colisiónForma | representa una forma geométrica, es decir, una esfera, una caja y una envolvente convexa. Si es nulo, se quitará la forma de colisión actual de este nodo. |
---|
Consulta también
public final void setEnabled (booleano habilitado)
Establece el estado habilitado de este nodo. Ten en cuenta que un nodo puede estar habilitado, pero aún inactivo, si no forma parte de la escena o si su elemento superior está inactivo.
Parámetros
habilitado | el nuevo estado habilitado del nodo |
---|
Consulta también
vacío público setLight (Luz luminosa)
Configura el Light
para mostrar. Para usar, primero crea un Light
con Light.Builder
. Configura los parámetros que te interesan y, luego, adjúntalos al nodo mediante esta función. Un nodo puede tener un elemento renderable y una luz, o bien solo actuar como Light
.
Parámetros
Leve | Propiedades de Light para renderizar y pasar null para quitar la luz
|
---|
vacío público setLocalPosition (posición de Vector3)
Establece la posición de este nodo en relación con su elemento principal (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que setWorldPosition(Vector3)
.
Parámetros
position | Posición que se aplicará. |
---|
Consulta también
vacío público setLocalRotation (rotación Quaternion)
Establece la rotación de este nodo en relación con su elemento superior (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que setWorldRotation(Quaternion)
.
Parámetros
rotación | La rotación que se aplicará. |
---|
Consulta también
vacío público setLocalScale (escalaVector)
Establece la escala de este nodo en relación con su elemento superior (espacio local). Si isTopLevel()
es verdadero, entonces es lo mismo que setWorldScale(Vector3)
.
Parámetros
de Google. | La escala que se aplicará. |
---|
Consulta también
vacío público final setLookDirection (Vector3 lookDirection)
Establece la dirección que el nodo observa en el espacio. Después de llamar a esto, getForward()
coincidirá con la dirección de apariencia que se pasó. El espacio mundial arriba (0, 1, 0) se usará para determinar la orientación del nodo alrededor de la dirección.
Parámetros
LookDirection | un vector que representa la dirección de mirada deseada en el espacio |
---|
vacío público final setLookDirection (Vector3 lookDirection, Vector3 upDirection)
Establece la dirección que el nodo observa en el espacio. Después de llamar a esto, getForward()
coincidirá con la dirección de apariencia que se pasó. La dirección hacia arriba determinará la orientación del nodo alrededor de ella. La dirección de búsqueda y la de arriba no pueden coincidir (paralelamente) o la orientación no será válida.
Parámetros
LookDirection | un vector que representa la dirección de mirada deseada en el espacio |
---|---|
Dirección ascendente | un vector que representa un vector hacia arriba válido para usar, como Vector3.up() |
public final void setName (String name)
Establece el nombre de este nodo. Los nodos se pueden encontrar con sus nombres. Es posible que varios nodos tengan el mismo nombre, en cuyo caso la llamada a findByName(String)
mostrará el primer nodo con ese nombre.
Parámetros
name | El nombre del nodo. |
---|
vacío público setOnTapListener (Node.OnTapListener onTapListener)
Registra una devolución de llamada que se invocará cuando se presione este nodo. Si hay una devolución de llamada registrada, los eventos táctiles no aparecerán en la burbuja del elemento principal de este nodo. Si se anula Node.onTouchEvent y no se llama a super.onTouchEvent, no se realizará el toque.
Parámetros
onTapListener |
---|
Consulta también
vacío público setOnTouchListener (Node.OnTouchListener onTouchListener)
Registra una devolución de llamada que se invocará cuando se envíe un evento táctil a este nodo. La manera en que se propagan los eventos táctiles es la misma que se propagan los toques en las vistas de Android. Solo se lo llama cuando el nodo está activo.
Cuando ocurre un evento ACTION_DOWN, eso representa el inicio de un gesto. ACTION_UP o ACTION_CANCEL representa cuándo finaliza un gesto. Cuando se inicia un gesto, se hace lo siguiente:
- Envía eventos táctiles al nodo que se detectó como detectado por
hitTest(MotionEvent)
. - Si el nodo no consume el evento, recurre hacia arriba a través de los elementos superiores del nodo y envía el evento táctil hasta que uno de los nodos consuma el evento.
- Si ningún nodo consume el evento, el gesto se ignora y los eventos posteriores que forman parte del gesto no se pasarán a ningún nodo.
- Si uno de los nodos consume el evento, ese nodo consumirá todos los eventos táctiles futuros del gesto.
Node.OnTouchListener
del nodo. Si Node.OnTouchListener
no controla el evento, se pasa a onTouchEvent(HitTestResult, MotionEvent)
.Parámetros
onTouchListener |
---|
Consulta también
vacío público setParent (NodeParent)
Cambia el nodo superior de este nodo. Si se configura como nulo, este nodo se desvinculará de su superior. La posición, la rotación y la escala locales de este nodo permanecerán iguales. Por lo tanto, la posición, la rotación y la escala mundiales de este nodo pueden ser diferentes después de que cambia el superior.
El superior puede ser otro Node
o Scene
. Si es una escena, este Node
se considera de nivel superior. getParent()
mostrará un valor nulo y getScene()
mostrará la escena.
Parámetros
elemento superior | El nuevo superior del que será nodo este nodo. Si es nulo, este nodo se desvinculará de su superior. |
---|
Consulta también
public void setRenderable (Renderable renderable)
Configura el Renderable
para mostrar este nodo. Si no se configura setCollisionShape(CollisionShape)
, se usa getCollisionShape()
a fin de detectar colisiones para esta Node
.
Parámetros
procesable | Por lo general, es un modelo 3D. Si es nulo, se quitará el renderable actual de este nodo. |
---|
Consulta también
vacío público setWorldPosition (posición de Vector3)
Establece la posición de espacio mundial de este nodo.
Parámetros
position | Posición que se aplicará. |
---|
Consulta también
vacío público setWorldRotation (rotación Quaternion)
Establece la rotación de espacio mundial de este nodo.
Parámetros
rotación | La rotación que se aplicará. |
---|
Consulta también
vacío público setWorldScale (Escala Vector3)
Establece la escala de espacio mundial de este nodo.
Parámetros
de Google. | La escala que se aplicará. |
---|
Consulta también
público final Vector3 worldToLocalDirection (Dirección Vector3)
Convierte una dirección de un espacio-mundo al espacio local de este nodo. No se ven afectados por la posición o escala del nodo.
Parámetros
direction | la dirección en el espacio para convertir |
---|
Resultado que se muestra
- un nuevo vector que representa la dirección en el espacio local
público final Vector3 worldToLocalPoint (punto3Vector)
Convierte un punto en el espacio mundial en el espacio local de este nodo.
Parámetros
point | el punto en el espacio para convertir |
---|
Resultado que se muestra
- un nuevo vector que representa el punto en el espacio local
Métodos protegidos
booleano final protegido canAddChild (Nodo del nodo secundario, StringBuilder con el motivo de la falla)
Parámetros
niño | |
---|---|
Motivo de error |