Nó

classe pública Nó
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
localToWorldPoint(vetor 3)
Converte um ponto no espaço local desse nó em espaço mundial.
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
onTransformChange(Node originNode)
Processa quando a transformação deste nó é alterada.
void
onUpdate(FrameTime frameTime)
Processa quando o nó é atualizado.
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
setLight(luz Light)
Define o Light a ser exibido.
void
setLocalPosition (posição Vector3)
Define a posição desse nó em relação ao pai (local-space).
void
setLocalRotation(rotação Quaternion)
Define a rotação desse nó em relação ao pai (local-space).
void
setLocalScale(escala Vector3)
Define a escala deste nó em relação ao pai (local-space).
anulação final
setLookDirection (Vector3 LookDirection)
Define a direção que o nó está olhando no espaço mundial.
anulação final
setLookDirection(Vector3 LookDirection, Vector3 upDirection)
Define a direção que o nó está olhando no espaço mundial.
anulação final
setName(nome da string)
Define o nome deste nó.
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
setParent(pai pai NodeParent)
Altera o nó pai desse nó.
void
setRenderable(renderizável) Renderable
Define o Renderable a ser exibido para esse nó.
void
setWorldPosition (posição Vector3)
Define a posição do espaço mundial desse nó.
void
setWorldRotation(rotação Quaternion)
Define a rotação do espaço mundial desse nó.
void
setWorldScale(escala Vector3)
Define a escala do espaço mundial deste nó.
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
worldToLocalPoint(ponto Vector3)
Converte um ponto no espaço mundial no espaço local deste nó.

Métodos protegidos

booleano final
canAddChild(filho do Node, falha de StringBuilder)
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.
Ver também

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 Light getLight ()

Recebe a luz atual, que é mutável.

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 String getName ()

Retorna o nome do nó. O valor padrão é "Node".

público final Nó getParent ()

Retorna o pai desse nó. Se a Node tiver um pai e essa mãe for uma subclasse Node ou Node, a função vai retornar o pai como uma Node. Retornará "null" se o pai for um Scene. Use getScene() para recuperar o pai.

Retorna
  • o pai como um Node, se o pai for um Node.

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.
Um nó ativo tem o seguinte comportamento:

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.
Quando um evento de toque é enviado a um nó, o evento é primeiro transmitido para o nó do 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.
Ver também

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.
Quando um evento de toque é enviado a um nó, o evento é primeiro transmitido para o nó do 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

String toString ()

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

público final Vector3 worldToLocalPoint (Vector3 ponto)

Converte um ponto no espaço mundial no espaço local deste nó.

Parâmetros
point o ponto no espaço mundial para converter
Retorna
  • um novo vetor que representa o ponto no espaço local

Métodos protegidos

booleano protegido canAddChild (Node filho, StringBuilder failedReason)

Parâmetros
criança
failureReason

nulo protegido nulo onAddChild (Node filho)

Parâmetros
criança

nulo protegido nulo onRemoveChild (Nó filho)

Parâmetros
criança