Subclasses diretas conhecidas |
Subclasses indiretas conhecidas |
Um nó representa uma transformação na hierarquia do gráfico de cena. Ele pode conter um elemento de renderização para o mecanismo de renderização renderizar.
Cada nó pode ter um número arbitrário de nós filhos e um pai. O pai pode ser outro nó, ou a cena.
Classes aninhadas
Interface | Node.LifecycleListener | Definição de interface para invocar chamadas de retorno quando ocorrerem eventos de ciclo de vida do nó. | |
Interface | Node.OnTapListener | Definição de interface para um callback ser invocado quando um nó é tocado. | |
Interface | Node.OnTouchListener | Definição de interface para um callback ser invocado quando um evento de toque é enviado para esse nó. | |
Interface | Node.TransformChangedListener | Definição da interface para callbacks serem invocados quando a transformação do nó for alterada. |
Construtores públicos
Nó()
Cria um nó sem pai.
|
Métodos públicos
void |
addLifecycleListener(Node.LifecycleListener ciclo de vida)
Adiciona um listener que será chamado quando ocorrerem eventos de ciclo de vida do nó.
|
void |
addTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Adiciona um listener que será chamado quando a transformação do nó mudar.
|
void |
callOnHierarchy(consumidor<nó> consumidor)
Transfere a hierarquia e chama um método em cada nó (incluindo esse nó).
|
Nó |
findInHierarchy(estado Predicate<Node>)
Atravessa a hierarquia para encontrar o primeiro nó (incluindo esse nó) que atende a uma condição.
|
Vector3 final |
getBack()
Recebe o vetor de retorno do espaço mundial (+z) desse nó.
|
CollisionShape (link em inglês) |
getCollisionShape()
Recebe a forma a ser usada para colisões com esse nó.
|
Vector3 final |
getDown()
Recebe o vetor de espaço mundial (-y) desse nó.
|
Vector3 final |
getForward()
Recebe o vetor de encaminhamento mundial de espaço (-z) desse nó.
|
Vector3 final |
getLeft()
Recebe o vetor esquerdo do espaço mundial (-x) desse nó.
|
Claro |
getLight(link em inglês)
Recebe a luz atual, que é mutável.
|
Vector3 final |
getLocalPosition().
Recebe uma cópia da posição dos nós em relação ao pai (local-space).
|
final de Quaternion |
getLocalRotation ()
Recebe uma cópia da rotação de nós em relação ao pai (local-space)
|
Vector3 final |
getLocalScale()
Recebe uma cópia da escala dos nós em relação ao pai (local-space).
|
String final |
getName()
Retorna o nome do nó.
|
Nó final |
getParent()
Retorna o pai desse nó.
|
Renderizável |
getRenderable().
Recebe o elemento de renderização a ser exibido para esse nó.
|
Vector3 final |
getRight().
Recebe o vetor direito de espaço mundial (+x) desse nó.
|
Cenário final |
getScene()
Retorna a cena de que esse nó faz parte, nulo se não fizer parte de nenhuma cena.
|
Vector3 final |
getUp()
Recebe o vetor espaço mundial (+y) desse nó.
|
Vector3 final |
getWorldPosition ()
Receba uma cópia da posição do espaço mundial dos nós.
|
final de Quaternion |
getWorldRotation()
Recebe uma cópia da rotação do espaço mundial dos nós.
|
Vector3 final |
getWorldScale()
Recebe uma cópia da escala global dos nós do espaço.
|
booleano final |
isActive ()
Retorna verdadeiro se o nó está ativo.
|
booleano final |
isDescendantOf(ancestral NodeParent)
Verifica se o pai do nó fornecido é um ancestral desse nó recursivamente.
|
booleano final |
isEnabled().
Recebe o estado ativado desse nó.
|
boolean |
isTopLevel()
Retorna verdadeiro se esse nó for de nível superior.
|
Vector3 final |
localToWorldDirection (direção Vector3)
Converte uma direção do espaço local desse nó em espaço mundial.
|
Vector3 final | |
void |
onActivate()
Processa quando este nó fica ativo.
|
void |
onDisable().
Processa quando este nó fica inativo.
|
boolean |
onTouchEvent(HitTestResult hitTestResult, MotionEvent movimentoEvent)
Processa quando o nó é tocado.
|
void | |
void | |
void |
removeLifecycleListener (Node.LifecycleListener ciclo de vida)
Remove um listener que será chamado quando ocorrerem eventos do ciclo de vida do nó.
|
void |
removeTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Remove um listener que será chamado quando a transformação do nó mudar.
|
void |
setCollisionShape(CollisionShape collisionShape)
Define a forma como usada para detectar colisões para esse
Node . |
anulação final |
setEnabled(booleano ativado)
Define o estado ativado deste nó.
|
void | |
void | |
void | |
void | |
anulação final | |
anulação final |
setLookDirection(Vector3 LookDirection, Vector3 upDirection)
Define a direção que o nó está olhando no espaço mundial.
|
anulação final | |
void |
setOnTapListener(Node.OnTapListener onTapListener)
Registra um callback a ser invocado quando o usuário toca nesse nó.
|
void |
setOnTouchListener (Node.OnTouchListener onTouchListener)
Registra um callback a ser invocado quando um evento de toque é enviado a esse nó.
|
void | |
void | |
void | |
void | |
void | |
String |
toString().
|
Vector3 final |
worldToLocalDirection (direção Vector3)
Converte uma direção do espaço mundial para o espaço local desse nó.
|
Vector3 final |
Métodos protegidos
booleano final | |
anulação final |
onAddChild(filho do Node)
|
anulação final |
onRemoveChild(filho do Node)
|
Métodos herdados
Construtores públicos
público Nó ()
Cria um nó sem pai.
Métodos públicos
void public addLifecycleListener (Node.LifecycleListenerlifecycleListener)
Adiciona um listener que será chamado quando ocorrerem eventos de ciclo de vida do nó. Os listeners serão chamados na ordem em que foram adicionados.
Parâmetros
listener de ciclo de vida |
---|
void void addTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Adiciona um listener que será chamado quando a transformação do nó mudar.
Parâmetros
TransformChangedListener |
---|
public void callOnHierarchy (Consumer<Node> consumer)
Transfere a hierarquia e chama um método em cada nó (incluindo esse nó). A primeira é a profundidade.
Parâmetros
consumidor | O método a ser chamado em cada nó |
---|
Node findInHierarchy (Predicate<Nó> condição)
Atravessa a hierarquia para encontrar o primeiro nó (incluindo esse nó) que atende a uma condição. Quando o predicado é atendido, a travessia é interrompida. A profundidade é essencial.
Parâmetros
condição | o predicado define as condições do nó a ser pesquisado. |
---|
Retorna
- o primeiro nó que corresponder às condições do predicado. Caso contrário, será retornado nulo.
público final Vector3 getBack ()
Recebe o vetor de retorno do espaço mundial (+z) desse nó.
Retorna
- um novo vetor que representa a direção de retorno do nó no espaço mundial
público CollisionShape getCollisionShape ()
Recebe a forma a ser usada para colisões com esse nó. Se a forma for nula e setRenderable(Renderable)
for definido, getCollisionShape()
será usado para detectar colisões para esse Node
.
Retorna
- representa uma forma geométrica, ou seja, esfera, caixa, casco convexo.
público final Vector3 getDown ()
Recebe o vetor de espaço mundial (-y) desse nó.
Retorna
- um novo vetor que representa a direção para baixo do nó no espaço mundial
público final Vector3 getForward ()
Recebe o vetor de encaminhamento mundial de espaço (-z) desse nó.
Retorna
- um novo vetor que representa a direção direta do nó no espaço mundial
público final Vector3 getLeft ()
Recebe o vetor esquerdo do espaço mundial (-x) desse nó.
Retorna
- um novo vetor que representa a direção esquerda do nó no espaço mundial
público final Vector3 getLocalPosition ()
Recebe uma cópia da posição dos nós em relação ao pai (local-space). Se isTopLevel()
for verdadeiro, será o mesmo que getWorldPosition()
.
Retorna
- um novo vetor que representa a posição de espaço local do nó
Ver também
público final Quaternion getLocalRotation ()
Recebe uma cópia da rotação de nós em relação ao pai (local-space) Se isTopLevel()
for verdadeiro, será o mesmo que getWorldRotation()
.
Retorna
- um novo quatérnio que representa a rotação do espaço local do nó
Ver também
público final Vector3 getLocalScale ()
Recebe uma cópia da escala dos nós em relação ao pai (local-space). Se isTopLevel()
for verdadeiro, será o mesmo que getWorldScale()
.
Retorna
- um novo vetor que representa a escala do espaço local do nó
Ver também
público final Nó getParent ()
público Renderizável getRenderable ()
Recebe o elemento de renderização a ser exibido para esse nó.
Retorna
- renderable para exibição neste nó
público final Vector3 getRight ()
Recebe o vetor direito de espaço mundial (+x) desse nó.
Retorna
- um novo vetor que representa a direção correta do nó no espaço mundial
público final Cena getScene ()
Retorna a cena de que esse nó faz parte, nulo se não fizer parte de nenhuma cena. Um nó faz parte
de uma cena se o ancestral de nível mais alto for uma Scene
público final Vector3 getUp ()
Recebe o vetor espaço mundial (+y) desse nó.
Retorna
- um novo vetor que representa a direção do nó para cima no espaço mundial
público final Vector3 getWorldPosition ()
Receba uma cópia da posição do espaço mundial dos nós.
Retorna
- um novo vetor que representa a posição espacial do nó
Ver também
público final Quaternion getWorldRotation ()
Recebe uma cópia da rotação do espaço mundial dos nós.
Retorna
- um novo quatérnio que representa a rotação do espaço mundial do nó
Ver também
público final Vector3 getWorldScale ()
Recebe uma cópia da escala global dos nós do espaço. Perda de precisão se o nó estiver distorcido.
Retorna
- um novo vetor que representa a escala do espaço mundial do nó
Ver também
booleano público final isActive ()
Retorna verdadeiro se o nó está ativo. Um nó será considerado ativo se atender a TODAS as condições a seguir:
- O nó faz parte de uma cena.
- o pai do nó está ativo.
- O nó está ativado.
- A função
onUpdate(FrameTime)
do nó será chamada a cada frame. - O
getRenderable()
do nó será renderizado. - O
getCollisionShape()
do nó será verificado nas chamadas para Scene.hitTest. - A função
onTouchEvent(HitTestResult, MotionEvent)
do nó será chamada quando o nó for tocado.
Retorna
- status ativo do nó
Ver também
booleano final booleano isDescendantOf ( ancestralParent)
Verifica se o pai do nó fornecido é um ancestral desse nó recursivamente.
Parâmetros
ancestor | o pai pai para verificar |
---|
Retorna
- verdadeiro se o nó for um ancestral desse nó
booleano público final isEnabled ()
Recebe o estado ativado desse nó. Um nó poderá ser ativado, mas ainda inativo se não for parte da cena ou se o pai dele estiver inativo.
Retorna
- status ativado dos nós.
Ver também
booleano público isTopLevel ()
Retorna verdadeiro se esse nó for de nível superior. Um nó será considerado de nível superior se não tiver pai ou se o pai for a cena.
Retorna
- verdadeiro se o nó for de nível superior
público final Vector3 localToWorldDirection (Vector3 direção)
Converte uma direção do espaço local desse nó em espaço mundial. Não é afetado pela posição ou escala do nó.
Parâmetros
sentido | a direção no espaço local para conversão |
---|
Retorna
- um novo vetor que representa a direção no espaço mundial
público final Vector3 localToWorldPoint (Vector3 ponto)
Converte um ponto no espaço local desse nó em espaço mundial.
Parâmetros
point | o ponto no espaço local para conversão |
---|
Retorna
- um novo vetor que representa o ponto no espaço mundial
public void onActivate ()
Processa quando este nó fica ativo. Um nó estará ativo se estiver ativado, fizer parte de uma cena e o pai dele estiver ativo.
Modifique para executar qualquer configuração que precise ocorrer quando o nó for ativado.
Ver também
public void onDisable ()
Processa quando este nó fica inativo. Um nó está inativo se estiver desativado, não fizer parte de uma cena ou se o pai estiver inativo.
Modifique para executar qualquer configuração que precise ocorrer quando o nó for desativado.
Ver também
booleano booleano onTouchEvent (HitTestResult hitTestResult, MotionEvent movimentoEvent)
Processa quando o nó é tocado.
Modifique para executar qualquer lógica que ocorra quando o nó for tocado. A maneira como os eventos de toque são propagados se espelha na forma como os toques são propagados para as visualizações do Android. Isso só é chamado quando o nó está ativo.
Quando ocorre um evento ACTION_DOWN, ele representa o início de um gesto. ACTION_UP ou ACTION_CANCEL representam quando um gesto termina. Quando um gesto é iniciado, acontece o seguinte:
- Eventos de toque de envio para o nó que foi tocado conforme detectado por
hitTest(MotionEvent)
. - Se o nó não consumir o evento, retorne para cima pelos pais do nó e envie o evento de toque até que um dos nós consuma o evento.
- Se nenhum nó consumir o evento, o gesto será ignorado e os eventos subsequentes que fazem parte dele não serão transmitidos para nenhum nó.
- Se um dos nós consumir o evento, esse nó consumirá todos os eventos de toque futuros para o gesto.
Node.OnTouchListener
. Se a Node.OnTouchListener
não processar o evento, ela será transmitida para onTouchEvent(HitTestResult, MotionEvent)
.Parâmetros
Resultado do teste de hit | Representa o nó que foi tocado e as informações sobre onde ele foi tocado. Em eventos ACTION_DOWN, getNode() sempre será este nó ou um dos filhos dele. Em outros eventos, o toque pode ter sido movido fazendo com que o getNode() mudasse (ou pode ser nulo). |
---|---|
eventEvent | O evento de movimento. |
Retorna
- Verdadeiro se o evento foi processado. Caso contrário, é falso.
void public onTransformChange (Node originNode)
Processa quando a transformação deste nó é alterada.
O nó de origem é o nó de nível mais alto na hierarquia que acionou a mudança
dele. Ele sempre será o mesmo nó ou um dos pais dele. Ou seja, se a posição do nó A's for alterada, isso acionará o onTransformChange(Node)
para ser chamado para todos os filhos dele, com o originNode sendo o nó A.
Parâmetros
Nó de origem | o nó que acionou a transformação desse nó para mudar |
---|
public void onUpdate (FrameTime frameTime)
Processa quando o nó é atualizado. Um nó é atualizado antes de renderizar cada frame. Isso só é chamado quando o nó está ativo.
Modifique para executar as atualizações que precisam ocorrer em cada frame.
Parâmetros
Tempo para a renderização do frame | fornece informações de tempo para o frame atual; |
---|
void public removeLifecycleListener (Node.LifecycleListenerlifecycleListener)
Remove um listener que será chamado quando ocorrerem eventos do ciclo de vida do nó.
Parâmetros
listener de ciclo de vida |
---|
public void removeTransformChangedListener (Node.TransformChangedListener transformChangedListener)
Remove um listener que será chamado quando a transformação do nó mudar.
Parâmetros
TransformChangedListener |
---|
void void setCollisionShape (CollisionShape collisionShape)
Define a forma como usada para detectar colisões para esse Node
. Se a forma não for definida e
setRenderable(Renderable)
for definido, getCollisionShape()
será
usado para detectar colisões para esse Node
.
Parâmetros
Forma de colisão | representa uma forma geométrica, ou seja, esfera, caixa, casco convexo. Se nulo, o formato de colisão atual do nó será removido. |
---|
público final nulo setEnabled (booleano ativado)
Define o estado ativado deste nó. Um nó poderá ser ativado, mas ainda inativo se não for parte da cena ou se o pai dele estiver inativo.
Parâmetros
ativado | o novo status ativado do nó |
---|
Ver também
public void setLight (light)
Define o Light
a ser exibido. Para usar, primeiro crie um Light
usando Light.Builder
. Defina os parâmetros mais importantes e anexe-os ao nó usando essa função. Um nó pode ter um renderable e um light ou apenas atuar como um Light
.
Parâmetros
luz | Propriedades de Light a serem renderizadas, transmita um valor nulo para remover a luz.
|
---|
void public setLocalPosition (Vector3 posição)
Define a posição desse nó em relação ao pai (local-space). Se isTopLevel()
for verdadeiro, será o mesmo que setWorldPosition(Vector3)
.
Parâmetros
position | A posição a ser aplicada. |
---|
Ver também
void public setLocalRotation (Alternância de rotação)
Define a rotação desse nó em relação ao pai (local-space). Se isTopLevel()
for verdadeiro, será o mesmo que setWorldRotation(Quaternion)
.
Parâmetros
rotação | A rotação a ser aplicada. |
---|
Ver também
public void setLocalScale (Vector3 escala)
Define a escala deste nó em relação ao pai (local-space). Se isTopLevel()
for
verdadeiro, será o mesmo que setWorldScale(Vector3)
.
Parâmetros
escalonar | A escala a ser aplicada. |
---|
Ver também
público final nulo setLookDirection (Vector3 LookDirection)
Define a direção que o nó está olhando no espaço mundial. Depois de chamar isso, getForward()
corresponderá à direção de visualização transmitida. O espaço mundial para cima (0, 1, 0) será usado para determinar a orientação do nó em torno da direção.
Parâmetros
LookDirection | um vetor que representa a direção de aparência desejada no espaço mundial |
---|
público final void setLookDirection (Vector3 LookDirection, Vector3 upDirection)
Define a direção que o nó está olhando no espaço mundial. Depois de chamar isso, getForward()
corresponderá à direção de visualização transmitida. A direção para cima determinará a orientação do nó em torno da direção. A direção da aparência e a da direção para cima não podem ser coincidentes (paralelas) ou a orientação é inválida.
Parâmetros
LookDirection | um vetor que representa a direção de aparência desejada no espaço mundial |
---|---|
Direção para cima | um vetor que representa um vetor acima válido a ser usado, como Vector3.up() |
público final nulo setName (String nome)
Define o nome deste nó. Os nós podem ser encontrados usando os nomes deles. Vários nós podem ter o
mesmo nome. Nesse caso, chamar findByName(String)
retornará o primeiro
nó com o nome fornecido.
Parâmetros
nome | O nome do nó. |
---|
public void setOnTapListener (Node.OnTapListener onTapListener)
Registra um callback a ser invocado quando o usuário toca nesse nó. Se houver um callback registrado, os eventos de toque não aparecerão em balões para o pai desse nó. Se o Node.onTouchEvent for substituído e o super.onTouchEvent não for chamado, o toque não ocorrerá.
Parâmetros
onTapListener |
---|
Ver também
void null setOnTouchListener (Node.OnTouchListener onTouchListener)
Registra um callback a ser invocado quando um evento de toque é enviado a esse nó. A maneira como os eventos de toque são propagados se espelha na forma como os toques são propagados para as visualizações do Android. Isso só é chamado quando o nó está ativo.
Quando ocorre um evento ACTION_DOWN, ele representa o início de um gesto. ACTION_UP ou ACTION_CANCEL representam quando um gesto termina. Quando um gesto é iniciado, acontece o seguinte:
- Eventos de toque de envio para o nó que foi tocado conforme detectado por
hitTest(MotionEvent)
. - Se o nó não consumir o evento, retorne para cima pelos pais do nó e envie o evento de toque até que um dos nós consuma o evento.
- Se nenhum nó consumir o evento, o gesto será ignorado e os eventos subsequentes que fazem parte dele não serão transmitidos para nenhum nó.
- Se um dos nós consumir o evento, esse nó consumirá todos os eventos de toque futuros para o gesto.
Node.OnTouchListener
. Se a Node.OnTouchListener
não processar o evento, ela será transmitida para onTouchEvent(HitTestResult, MotionEvent)
.Parâmetros
onTouchListener |
---|
Ver também
void public setParent (NodeParent pai)
Altera o nó pai desse nó. Se definido como nulo, esse nó será removido do pai. A posição, a rotação e a escala locais desse nó permanecerão as mesmas. Portanto, a posição mundial, a rotação e a escala desse nó podem ser diferentes depois que o pai alterar.
O pai pode ser outro Node
ou um Scene
. Se for uma cena, esse
Node
será considerado de nível superior. getParent()
retornará nulo, e getScene()
retornará a cena.
Parâmetros
primária | O novo pai do qual este nó será filho. Se for nulo, esse nó será removido do pai. |
---|
Ver também
void public setRenderable (Renderable renderable)
Define o Renderable
a ser exibido para esse nó. Se setCollisionShape(CollisionShape)
não for definido, o getCollisionShape()
será usado para detectar colisões para esse Node
.
Parâmetros
renderizável | Normalmente, um modelo 3D. Se nulo, o atual atual do nó será removido. |
---|
Ver também
public void setWorldPosition (Vector3 posição)
Define a posição do espaço mundial desse nó.
Parâmetros
position | A posição a ser aplicada. |
---|
Ver também
public void setWorldRotation (Alternância de rotação)
Define a rotação do espaço mundial desse nó.
Parâmetros
rotação | A rotação a ser aplicada. |
---|
Ver também
public void setWorldScale (escala Vector3)
Define a escala do espaço mundial deste nó.
Parâmetros
escalonar | A escala a ser aplicada. |
---|
Ver também
público final Vector3 worldToLocalDirection (direção Vector3)
Converte uma direção do espaço mundial para o espaço local desse nó. Não é afetado pela posição ou escala do nó.
Parâmetros
sentido | a direção no espaço mundial para converter |
---|
Retorna
- um novo vetor que representa a direção no espaço local
Métodos protegidos
booleano protegido canAddChild (Node filho, StringBuilder failedReason)
Parâmetros
criança | |
---|---|
failureReason |