de.javagl.jgltf.model.impl

Class DefaultNodeModel

java.lang.Object

de.javagl.jgltf.model.impl.AbstractModelElement

de.javagl.jgltf.model.impl.AbstractNamedModelElement

de.javagl.jgltf.model.impl.DefaultNodeModel

All Implemented Interfaces:

ModelElement, NamedModelElement, NodeModel

public class DefaultNodeModel
extends AbstractNamedModelElement
implements NodeModel

Implementation of a NodeModel

Constructor Summary

Constructors

Constructor and Description
DefaultNodeModel() Creates a new instance
DefaultNodeModel(NodeModel other) Copy constructor that creates a shallow copy with references to the elements of the given model, except for the children and MeshModel instances (which will be empty in the copy).

Method Summary

Modifier and Type	Method and Description
void	addChild(DefaultNodeModel child) Add the given child node
void	addMeshModel(MeshModel meshModel) Add the given MeshModel
float[]	computeGlobalTransform(float[] result) Computes the global transform of this node.
float[]	computeLocalTransform(float[] result) Computes the local transform of this node.
static float[]	computeLocalTransform(NodeModel nodeModel, float[] result) Compute the local transform of the given node.
java.util.function.Supplier<float[]>	createGlobalTransformSupplier() Creates a supplier for the global transform matrix of this node model.
java.util.function.Supplier<float[]>	createLocalTransformSupplier() Creates a supplier for the local transform matrix of this node model.
CameraModel	getCameraModel() Returns the CameraModel for this node, or null if this node is not associated with a camera
java.util.List<NodeModel>	getChildren() Returns an unmodifiable view on the list of children of this node
float[]	getMatrix() Returns a reference to the array storing the matrix of this node.
java.util.List<MeshModel>	getMeshModels() Returns an unmodifiable view on the list of MeshModel instances that are attached to this node.
NodeModel	getParent() Returns the parent of this node, or null if this is a root node
float[]	getRotation() Returns a reference to the array storing the rotation of this node, or null if no rotation was set
float[]	getScale() Returns a reference to the array storing the scale of this node, or null if no scale was set
SkinModel	getSkinModel() Returns the SkinModel for this node, or null if this node is not associated with a skin
float[]	getTranslation() Returns a reference to the array storing the translation of this node, or null if no translation was set.
float[]	getWeights() Returns a reference to the morph target weights, or null if no morph target weights have been defined
void	setCameraModel(CameraModel cameraModel) Set the CameraModel
void	setMatrix(float[] matrix) Set the matrix of this node to be a reference to the given array.
void	setParent(DefaultNodeModel parent) Set the parent of this node
void	setRotation(float[] rotation) Set the rotation of this node to be a reference to the given array.
void	setScale(float[] scale) Set the scale of this node to be a reference to the given array.
void	setSkinModel(SkinModel skinModel) Set the SkinModel
void	setTranslation(float[] translation) Set the translation of this node to be a reference to the given array.
void	setWeights(float[] weights) Set the morph target weights to be a reference to the given array.

Methods inherited from class de.javagl.jgltf.model.impl.AbstractNamedModelElement

getName, setName

Methods inherited from class de.javagl.jgltf.model.impl.AbstractModelElement

addExtension, getExtensions, getExtras, removeExtension, setExtensions, setExtras

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.javagl.jgltf.model.NamedModelElement

getName

Methods inherited from interface de.javagl.jgltf.model.ModelElement

getExtensions, getExtras

Constructor Detail

DefaultNodeModel

public DefaultNodeModel()

Creates a new instance

DefaultNodeModel

public DefaultNodeModel(NodeModel other)

Copy constructor that creates a shallow copy with references to the elements of the given model, except for the children and MeshModel instances (which will be empty in the copy).

Parameters:

other - The other NodeModel

Method Detail

setParent

public void setParent(DefaultNodeModel parent)

Set the parent of this node

Parameters:

parent - The parent node

addChild

public void addChild(DefaultNodeModel child)

Add the given child node

Parameters:

child - The child node

addMeshModel

public void addMeshModel(MeshModel meshModel)

Add the given MeshModel

Parameters:

meshModel - The MeshModel

setSkinModel

public void setSkinModel(SkinModel skinModel)

Set the SkinModel

Parameters:

skinModel - The SkinModel

setCameraModel

public void setCameraModel(CameraModel cameraModel)

Set the CameraModel

Parameters:

cameraModel - The CameraModel

getParent

public NodeModel getParent()

Description copied from interface: NodeModel

Returns the parent of this node, or null if this is a root node

Specified by:

getParent in interface NodeModel

Returns:

The parent

getChildren

public java.util.List<NodeModel> getChildren()

Description copied from interface: NodeModel

Returns an unmodifiable view on the list of children of this node

Specified by:

getChildren in interface NodeModel

Returns:

The children

getMeshModels

public java.util.List<MeshModel> getMeshModels()

Description copied from interface: NodeModel

Returns an unmodifiable view on the list of MeshModel instances that are attached to this node.

Specified by:

getMeshModels in interface NodeModel

Returns:

The MeshModel list

getSkinModel

public SkinModel getSkinModel()

Description copied from interface: NodeModel

Returns the SkinModel for this node, or null if this node is not associated with a skin

Specified by:

getSkinModel in interface NodeModel

Returns:

The SkinModel

getCameraModel

public CameraModel getCameraModel()

Description copied from interface: NodeModel

Returns the CameraModel for this node, or null if this node is not associated with a camera

Specified by:

getCameraModel in interface NodeModel

Returns:

The CameraModel

setMatrix

public void setMatrix(float[] matrix)

Description copied from interface: NodeModel

Set the matrix of this node to be a reference to the given array.

The matrix is assumed to be a 16-element array containing the matrix in column-major order. If the given matrix is null, then the translation, rotation, and scale properties will be used for determining the local transform.

Specified by:

setMatrix in interface NodeModel

Parameters:

matrix - The matrix

getMatrix

public float[] getMatrix()

Description copied from interface: NodeModel

Returns a reference to the array storing the matrix of this node. This is a 16-element array containing the matrix in column-major order, or null if no matrix was set.

Specified by:

getMatrix in interface NodeModel

Returns:

The matrix

setTranslation

public void setTranslation(float[] translation)

Description copied from interface: NodeModel

Set the translation of this node to be a reference to the given array.

Specified by:

setTranslation in interface NodeModel

Parameters:

translation - The translation

getTranslation

public float[] getTranslation()

Description copied from interface: NodeModel

Returns a reference to the array storing the translation of this node, or null if no translation was set.

Specified by:

getTranslation in interface NodeModel

Returns:

The translation

setRotation

public void setRotation(float[] rotation)

Description copied from interface: NodeModel

Set the rotation of this node to be a reference to the given array. The array is assumed to be a quaternion, consisting of 4 float elements.

Specified by:

setRotation in interface NodeModel

Parameters:

rotation - The rotation

getRotation

public float[] getRotation()

Description copied from interface: NodeModel

Returns a reference to the array storing the rotation of this node, or null if no rotation was set

Specified by:

getRotation in interface NodeModel

Returns:

The rotation

setScale

public void setScale(float[] scale)

Description copied from interface: NodeModel

Set the scale of this node to be a reference to the given array.

Specified by:

setScale in interface NodeModel

Parameters:

scale - The scale

getScale

public float[] getScale()

Description copied from interface: NodeModel

Returns a reference to the array storing the scale of this node, or null if no scale was set

Specified by:

getScale in interface NodeModel

Returns:

The scale

setWeights

public void setWeights(float[] weights)

Description copied from interface: NodeModel

Set the morph target weights to be a reference to the given array.

Specified by:

setWeights in interface NodeModel

Parameters:

weights - The weights

getWeights

public float[] getWeights()

Description copied from interface: NodeModel

Returns a reference to the morph target weights, or null if no morph target weights have been defined

Specified by:

getWeights in interface NodeModel

Returns:

The morph target weights

computeLocalTransform

public float[] computeLocalTransform(float[] result)

Description copied from interface: NodeModel

Computes the local transform of this node.

The result will be written to the given array, as a 4x4 matrix in column major order. If the given array is null or does not have a length of 16, then a new array with length 16 will be created and returned.

Specified by:

computeLocalTransform in interface NodeModel

Parameters:

result - The result array

Returns:

The result array

computeGlobalTransform

public float[] computeGlobalTransform(float[] result)

Description copied from interface: NodeModel

Computes the global transform of this node.

The result will be written to the given array, as a 4x4 matrix in column major order. If the given array is null or does not have a length of 16, then a new array with length 16 will be created and returned.

Specified by:

computeGlobalTransform in interface NodeModel

Parameters:

result - The result array

Returns:

The result array

createGlobalTransformSupplier

public java.util.function.Supplier<float[]> createGlobalTransformSupplier()

Description copied from interface: NodeModel

Creates a supplier for the global transform matrix of this node model.

The matrix will be provided as a float array with 16 elements, storing the matrix entries in column-major order.

Note: The supplier MAY always return the same array instance. Callers MUST NOT store or modify the returned array.

Specified by:

createGlobalTransformSupplier in interface NodeModel

Returns:

The supplier

createLocalTransformSupplier

public java.util.function.Supplier<float[]> createLocalTransformSupplier()

Description copied from interface: NodeModel

Creates a supplier for the local transform matrix of this node model.

The matrix will be provided as a float array with 16 elements, storing the matrix entries in column-major order.

Note: The supplier MAY always return the same array instance. Callers MUST NOT store or modify the returned array.

Specified by:

createLocalTransformSupplier in interface NodeModel

Returns:

The supplier

computeLocalTransform

public static float[] computeLocalTransform(NodeModel nodeModel,
                                            float[] result)

Compute the local transform of the given node. The transform is either taken from the getMatrix() (if it is not null), or computed from the getTranslation(), getRotation() and getScale(), if they are not null, respectively.

The result will be written to the given array, as a 4x4 matrix in column major order. If the given array is null or does not have a length of 16, then a new array with length 16 will be created and returned.

Parameters:

nodeModel - The node. May not be null.

result - The result array

Returns:

The result array