Node3D is the base class of all 3D nodes. More...

Inheritance diagram for Node3D:

Classes
enum	RenderMode
	Rendering mode for the node. More...

Public Member Functions
void	addChild (Node3D node)
	Adds a child node. More...

void	arrange ()
	Arranges this node.

void	centeredArrange (Vector3 actualSize)
	Default implementation of arrange for a layout that accommodates all children at its center.

Vector3	centeredMeasure (Vector3 availableSize)
	Default implementation of measure for a layout that accommodates all children at its center.

void	close ()
	Close the object, and release native resources.

Vector3	getActualSize ()
	Gets actual size. More...

Vector3	getAllocatedOffset ()
	Get allocated offset of an object.

Vector3	getAllocatedSize ()
	Gets allocated size. More...

Matrix4x4	getArrangeTransform ()
	Get arrange transform. More...

Node3D	getChild (int index)
	Returns a child from given index from node. More...

int	getChildCount ()
	Gets the number of children of the node. More...

int	getChildIndex (Node child)
	Returns the index of a child in a node. More...

Vector3	getCoreDesiredSize ()
	Get core desired size of an object. More...

Vector3	getDesiredSize ()
	Gets desired size. More...

Node3D	getFaceToCameraTarget ()
	Returns the camera to which this node faces to if the node is set to face a camera. More...

Matrix4x4	getFinalTransformation ()
	Gets the value of FinalTransformationProperty. More...

Vector3	getLayoutBoundingBoxMax ()
	Get bounding box size max corner for an object.

Vector3	getLayoutBoundingBoxMin ()
	Get bounding box size min corner for an object.

SRTValue3D	getLayoutTransformation ()
	Gets the value of LayoutTransformationProperty. More...

Node3D	getLookAtTarget ()
	Returns the node that is set to always face this node. More...

Node3D	getOrientationConstraintTarget ()
	Returns the node whose orientation is obtained to define the orientation of this node. More...

Vector3	getPivotOffset ()
	Get pivot offset of an object.

Node3D	getPositionConstraintTarget ()
	Returns the node whose position is obtained to define the position of this node. More...

SRTValue3D	getRenderTransformation ()
	Gets the value of RenderTransformationProperty. More...

Vector3	getSize ()
	Returns the size of object node. More...

Vector3	getStretchScale ()
	Get stretch scale of an object.

boolean	hasChild (Node child)
	Returns whether or not the child exists. More...

void	insertChild (int index, Node3D child)
	Adds a child node for object node to given index. More...

boolean	isPrimitiveLayout ()
	Indicates whether the node has primitive layout behavior. More...

Iterable< Node3D >	iterateChildren ()
	Gets an Iterable object used to iterate the Node3D children. More...

Iterable< Node3D >	iterateChildrenReverse ()
	Gets an Reverse Iterable object used to iterate the Node3D children. More...

void	layout ()
	Does layout pass starting from this node and iterating recursively all of its children. More...

void	lookAt (Vector3 position, Vector3 lookAtPoint, Vector3 upVector)
	Sets node transformation so that the node is in a given position looking at the given point. More...

void	measure (Vector3 availableSize)
	Measures this node. More...

void	moveToBack ()
	Repositions the node to the beginning of its parent's children, so that it is drawn first.

void	moveToFront ()
	Repositions the node to the end of its parent's children, so that it is drawn last.

Vector3	nGetMaximumBoundingBoxCoordinates ()
	Returns the minimum coordinates for object nodes bounding volume. More...

Vector3	nGetMinimumBoundingBoxCoordinates ()
	Returns the maximum coordinates for object nodes bounding volume. More...

void	removeAllChildren ()
	Removes all child nodes.

void	removeChild (Node3D node)
	Removes child node. More...

void	removeChild (int index)
	Removes child node at specified index. More...

void	setActualSize (Vector3 actualSize)
	Sets actual size. More...

void	setAllocatedOffset (Vector3 allocatedOffset)
	Set allocated offset for an object.

void	setAllocatedSize (Vector3 allocatedSize)
	Sets allocated size. More...

void	setArrangeTransform (Matrix4x4 transform)
	Set arrange transform. More...

void	setAutoDepth ()
	Sets node to automatically determine depth.

void	setAutoSize ()
	Sets node to automatically determine width, height and depth.

void	setCoreDesiredSize (Vector3 value)
	Set core desired size for an object. More...

void	setDesiredSize (Vector3 size)
	Sets desired size. More...

void	setFinalTransformation (Matrix4x4 value)
	Sets the value of FinalTransformationProperty. More...

void	setLayoutBoundingBoxSize (Vector3 bboxMin, Vector3 bboxMax)
	Set bounding box size for an object.

void	setLayoutTransformation (SRTValue3D value)
	Sets the value of LayoutTransformationProperty. More...

void	setPivotOffset (Vector3 pivotOffset)
	Set pivot offset for an object.

void	setRenderTransformation (SRTValue3D value)
	Sets the value of RenderTransformationProperty. More...

void	setSize (float width, float height, float depth)
	Sets size properties of the node. More...

void	setStretchScale (Vector3 stretchScale)
	Set stretch scale for an object.

Public Member Functions inherited from Node
ResourceManager.AcquireTask	acquireResourcesAsync (String resourceId, ResourceManager.AcquireTask.Callback callback)
	Posts an asynchronous task to acquire a resource. More...

boolean	addAbstractChild (Node child)
	Adds a node as child of this node. More...

void	addAnonymousResource (Resource resource)
	Adds anonymous resource (such as style) for object node resources. More...

MessageSubscriptionToken	addMessageFilter (MessageType messageType, MessageSubscriptionFunction messageHandlerFunction)
	Adds a message filter where the filter is a function. More...

MessageSubscriptionToken	addMessageHandler (MessageType messageType, MessageSubscriptionFunction messageHandlerFunction)
	Adds a message handler where the handler is a function. More...

MessageSubscriptionToken	addMessageHandler (MessageType messageType, MessageSubscriptionFunction messageHandlerFunction, Node messageSourceFilter)
	Adds a message handler where the handler is a function. More...

void	addNodeComponent (NodeComponent component)
	Transfers the ownership of a node component to an object node. More...

void	addNodeComponentWithOwner (NodeComponent component, KanziObject owner)
	Transfers the ownership of a node component to an object node and sets the owner of the node component. More...

void	addResource (String resourceId, String resourceUrl)
	Adds a resource manager resource to an object node. More...

MessageSubscriptionToken	addTunnelingMessageFilter (MessageType messageType, MessageSubscriptionFunction messageHandlerFunction)
	Adds a message filter where the filter is a function. More...

MessageSubscriptionToken	addTunnelingMessageHandler (MessageType messageType, MessageSubscriptionFunction messageHandlerFunction, Node messageSourceFilter)
	Adds a message handler where the handler is a function and you explicitly define the accepted source. More...

void	attachRecursive ()
	Attaches a node and its children recursively.

boolean	containsResource (String resourceId)
	Returns if object node resource dictionary contains the resource with given ID. More...

void	detachRecursive ()
	Detaches a node and its children recursively.

void	dispatchMessage (MessageType messageType, MessageArguments arguments)
	Dispatches a message from this node with specified arguments. More...

String	findResourceUrl (String resourceId)
	Tries to find Resource URL for Resource ID from this node. More...

Node	getAbstractChild (int index)
	Returns node at given child index. More...

int	getAbstractChildCount ()
	Returns number of child nodes. More...

int	getAbstractChildIndex (Node node)
	Returns index of given node in list of child nodes. More...

float	getActualDepth ()
	Gets the value of ActualDepthProperty. More...

float	getActualHeight ()
	Gets the value of ActualHeightProperty. More...

float	getActualWidth ()
	Gets the value of ActualWidthProperty. More...

float	getDepth ()
	Gets the value of DepthProperty. More...

Vector2	getDepthMargin ()
	Gets the value of DepthMarginProperty. More...

float	getHeight ()
	Gets the value of HeightProperty. More...

Vector2	getHorizontalMargin ()
	Gets the value of HorizontalMarginProperty. More...

String	getLocale ()
	Gets the value of LocaleProperty. More...

String	getName ()
	Gets the value of NameProperty. More...

float	getOpacity ()
	Gets the value of OpacityProperty. More...

Node	getParent ()
	Gets parent of this node. More...

String	getPath ()
	Gets the value of PathProperty. More...

Resource	getStateManager ()
	Gets the value of StateManagerProperty. More...

Resource	getStyle ()
	Gets the value of StyleProperty. More...

Vector2	getVerticalMargin ()
	Gets the value of VerticalMarginProperty. More...

float	getWidth ()
	Gets the value of WidthProperty. More...

boolean	isAttached ()
	Checks if node is attached to ui tree. More...

boolean	isAttaching ()
	Checks if node is in the process of attaching to ui tree. More...

boolean	isClipChildren ()
	Gets the value of ClipChildrenProperty. More...

boolean	isDetaching ()
	Checks if node is in the process of getting detached from ui tree. More...

boolean	isEffectivelyEnabled ()
	Returns whether a node and its ancestor nodes are enabled. More...

boolean	isEffectivelyFocusable ()
	Returns whether a node and its ancestor focus scope nodes are focusable. More...

boolean	isEffectivelyVisible ()
	Returns whether a node and its ancestor nodes are visible. More...

boolean	isEnabled ()
	Gets the value of EnabledProperty. More...

boolean	isFocusable ()
	Gets the value of the FocusableProperty. More...

boolean	isFocused ()
	Sets whether a node is an active focus node and can receive keyboard messages. More...

boolean	isHitTestable ()
	Gets the value of HitTestableProperty. More...

boolean	isHitTestableContainer ()
	Gets the value of HitTestableContainerProperty. More...

boolean	isHover ()
	Gets the value of HoverProperty. More...

boolean	isInitialized ()
	Checks if initialize() has been called. More...

boolean	isNamed (String name)
	Checks if node has a given name. More...

boolean	isVisible ()
	Gets the value of VisibleProperty. More...

Iterable< NodeComponent >	iterateNodeComponents ()
	Gets an Iterable object used to iterate the Node Components. More...

NodeComponent	lookupNodeComponentByName (String name)
	Look up a Node Component bu Name. More...

KanziObject	lookupObject (String path)
	Returns a KanziObject by looking it up with specified path or alias. More...

boolean	removeAbstractChild (Node child)
	Removes child node from this node. More...

void	removeAnonymousResource (Resource resource)
	Removes anonymous resource from object node resources. More...

void	removeMessageHandler (MessageSubscriptionToken token)
	Removes a message subscription. More...

void	removeNodeComponent (NodeComponent component)
	Removes the ownership of a node component from an object node. More...

void	removeNodeComponentWithOwner (KanziObject owner)
	Removes all node component bindings with the specified owner. More...

void	removeResource (String resourceId)
	Removes a resource with given ID from object node resource dictionary. More...

void	setActualDepth (float value)
	Sets the value of ActualDepthProperty. More...

void	setActualHeight (float value)
	Sets the value of ActualHeightProperty. More...

void	setActualWidth (float value)
	Sets the value of ActualWidthProperty. More...

void	setAutoHeight ()
	Sets node to automatically determine height.

void	setAutoWidth ()
	Sets node to automatically determine width.

void	setClipChildren (boolean value)
	Sets the value of ClipChildrenProperty. More...

void	setDepth (float value)
	Sets the value of DepthProperty. More...

void	setDepthMargin (Vector2 value)
	Sets the value of DepthMarginProperty. More...

void	setEnabled (boolean value)
	Sets the value of the EnabledProperty. More...

void	setFocusable (boolean value)
	Sets the value of the FocusableProperty. More...

void	setFocused (boolean value)
	Sets the value of the FocusedProperty. More...

void	setHeight (float value)
	Sets the value of HeightProperty. More...

void	setHitTestable (boolean value)
	Sets the value of HitTestableProperty. More...

void	setHitTestableContainer (boolean value)
	Sets the value of HitTestableContainerProperty. More...

void	setHorizontalMargin (Vector2 value)
	Sets the value of HorizontalMarginProperty. More...

void	setHover (boolean value)
	Sets the value of HoverProperty. More...

void	setLocale (String value)
	Sets the value of LocaleProperty. More...

void	setName (String name)
	Sets the value of NameProperty. More...

void	setOpacity (float value)
	Sets the value of OpacityProperty. More...

void	setStateManager (Resource value)
	Sets the value of StateManagerProperty. More...

void	setStyle (Resource value)
	Sets the value of StyleProperty. More...

void	setVerticalMargin (Vector2 value)
	Sets the value of VerticalMarginProperty. More...

void	setVisible (boolean value)
	Sets the value of VisibleProperty. More...

void	setWidth (float value)
	Sets the value of WidthProperty. More...

Node	trySetFocus ()
	Tries to move the focus on this node. More...

Public Member Functions inherited from KanziObject
boolean	equals (Object object)

Domain	getDomain ()
	Returns the domain the object belongs to. More...

Metaclass	getDynamicMetaclass ()
	Returns the metaclass of the dynamic type of the object. More...

boolean	isStale ()
	Test if the object is stale i.e. More...

void	removeLocalValue (PropertyType propertyType)
	Removes the local value associated with the property. More...

Static Public Member Functions
static boolean	isUnboundedLayoutSize (Vector3 layoutSize)
	Indicates whether a layout size is an unbound layout size. More...

static boolean	isValidLayoutSize (Vector3 size)
	Indicates whether a size is valid layout size. More...

static float	layoutUp ()
	Returns the direction to which the Y-axis grows for this node type. More...

static Vector3	replaceUnboundedLayoutSize (Vector3 layoutSize, Vector3 resetSize)
	Replaces any element of a layout size with appropriate element of the reset size if it is unbounded and returns the size. More...

static Vector3	replaceUnboundedLayoutSizeWithZero (Vector3 layoutSize)
	Replaces any element of a layout size with zero if it is unbounded and returns the size. More...

static Vector3	unboundedLayoutSize ()
	Returns an unbounded layout size. More...

Static Public Attributes
static final Metaclass	metaclass = com.rightware.kanzi.metadata.Node3DMetadata.metaclass
	The Metaclass for the class.

Static Public Attributes inherited from Node
static final Metaclass	metaclass = com.rightware.kanzi.metadata.NodeMetadata.metaclass
	The Metaclass for the class.

Static Public Attributes inherited from KanziObject
static final Metaclass	metaclass = new AbstractMetaclass("Kanzi.Object")
	The Metaclass for the class.

Protected Member Functions
	Node3D (Domain domain, long nativeNode, Metaclass metaclass)
	Wraps a given native node. More...

void	arrangeOverride (Vector3 actualSize)
	Performs setting of actual node size and transformation calculations. More...

void	initialize ()
	Initializes the Node3D.

Vector3	measureOverride (Vector3 availableSize)
	Performs node size calculation. More...

void	onAttached ()
	Called when this node becomes attached.

void	onDetached ()
	Called when this node becomes detached.

void	onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason)
	Method executed on node property change. More...

Static Protected Member Functions
static< Derived extends Node3D > ObjectRef< Derived >	createDerived (Domain domain, String name, Metaclass metaclass)
	Creates a derived class instance. More...

Additional Inherited Members
Public Attributes inherited from NodeMetadata
DynamicPropertyType< Float >	ActualDepthProperty
	The calculated size of the node in depth direction when used in a layout. More...

DynamicPropertyType< Float >	ActualHeightProperty
	The calculated height of the node when used in a layout. More...

DynamicPropertyType< Float >	ActualWidthProperty
	The calculated width of the node when used in a layout. More...

DynamicPropertyType< Boolean >	ClipChildrenProperty
	Sets whether to clip the child nodes of thos node. More...

DynamicPropertyType< Integer >	ContentStretchProperty
	Sets how the content that belongs to this node is stretched (as opposed to manipulating the actual node size). More...

DynamicPropertyType< Boolean >	CreatedFromKZBProperty
	Kanzi internally uses this property to distinguish objects like bindings and triggers created in code from objects that are loaded from a kzb file. More...

DynamicPropertyType< Integer >	DepthAlignmentProperty
	The alignment in depth direction the node should use when it resides under a layout. More...

DynamicPropertyType< Vector2 >	DepthMarginProperty
	Sets the depth distance between this node and other nodes that are adjacent to this node in a layout. More...

DynamicPropertyType< Float >	DepthProperty = new DynamicPropertyType<>("Node.Depth", Float.class)
	The size of the node in depth direction when used in a layout. More...

DynamicPropertyType< Boolean >	EffectivelyEnabledProperty
	Indicates whether this node and its ancestor nodes are enabled. More...

DynamicPropertyType< Boolean >	EnabledProperty
	Whether this node is enabled. More...

DynamicPropertyType< Boolean >	FocusableProperty
	Indicates whether the node can receive focus. More...

DynamicPropertyType< Boolean >	FocusedProperty
	Indicates whether the node has focus. More...

DynamicPropertyType< Resource >	FontFamilyProperty
	The font family used to render the text. More...

DynamicPropertyType< Float >	HeightProperty
	The height of the node when used in a layout. More...

DynamicPropertyType< Boolean >	HitTestableContainerProperty
	When enabled, Kanzi uses the layout bounds as geometry for hit testing. More...

DynamicPropertyType< Boolean >	HitTestableProperty
	When enabled, users can pick the node from the default Camera node of the active Scene node. More...

DynamicPropertyType< Integer >	HorizontalAlignmentProperty
	The alignment in horizontal direction the node should use when it resides under a layout. More...

DynamicPropertyType< Vector2 >	HorizontalMarginProperty
	Sets the horizontal space between this node and other nodes that are adjacent to this node in a layout. More...

DynamicPropertyType< Boolean >	HoverProperty
	Indicates whether a node is the foremost hit testable node under the cursor. More...

DynamicPropertyType< String >	LocaleProperty
	The locale of the node. More...

AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.Node")
	Metaclass for Node.

DynamicPropertyType< String >	NameProperty = new DynamicPropertyType<>("Node.Name", String.class)
	Node name.

DynamicPropertyType< Float >	OpacityProperty
	Opacity of the node. More...

DynamicPropertyType< String >	PathProperty = new DynamicPropertyType<>("Node.Path", String.class)
	Full path to the node.

DynamicPropertyType< Float >	Projection2DTo3DScaleProperty
	Sets the scale factor to project pixels to 3D size. More...

DynamicPropertyType< Resource >	StateManagerProperty
	Sets the State Manager to the node. More...

DynamicPropertyType< Resource >	StyleProperty
	Sets a style to the node. More...

DynamicPropertyType< Integer >	VerticalAlignmentProperty
	The alignment in vertical direction the node should use when it resides under a layout. More...

DynamicPropertyType< Vector2 >	VerticalMarginProperty
	Sets the vertical space between this node and other nodes that are adjacent to this node in a layout. More...

DynamicPropertyType< Float >	VisibleAmountInParentProperty
	Sets the amount the node is inside its parent. More...

DynamicPropertyType< Boolean >	VisibleProperty
	When disabled, Kanzi does not render the node. More...

DynamicPropertyType< Float >	WidthProperty = new DynamicPropertyType<>("Node.Width", Float.class)
	The width of the node when used in a layout. More...

Public Attributes inherited from Node3DMetadata
DynamicPropertyType< Matrix4x4 >	FinalTransformationProperty
	The combined location, orientation and scale of the node and its ancestor nodes. More...

DynamicPropertyType< Float >	FrustumCullMarginProperty
	The margin of the frustum cull radius of the node. More...

DynamicPropertyType< SRTValue3D >	LayoutTransformationProperty
	The location, orientation and scale of the node relative to its parent node. More...

AbstractMetaclass	metaclass = new AbstractMetaclass("Kanzi.Node3D")
	Metaclass for Node3D.

DynamicPropertyType< SRTValue3D >	RenderTransformationProperty
	The location, orientation, and scale of the node relative to its parent node. More...

Detailed Description

Node3D is the base class of all 3D nodes.

Node3D implements functionality common to all 3D nodes, such as rendering, layout and hit testing. You should use classes derived from Node3D like Image3D, EmptyNode3D and StackLayout3D to construct UI graphs. You can configure common parameters for rendering and layout with methods of Node3D. Use methods of derived classes to control behavior specific to them.

Constructor & Destructor Documentation

◆ Node3D()

Node3D	(	Domain	domain,
		long	nativeNode,
		Metaclass	metaclass
	)

protected

Wraps a given native node.

Called by KanziObject.connectObject(long) when connecting to a native node.

Parameters

domain	UI Domain where this node belongs.
nativeNode	Native object that is backing this node.
metaclass	Metaclass data for this node.

Member Function Documentation

◆ addChild()

void addChild ( Node3D node )

Adds a child node.

Adding a 3D node node as a child of a 2D node is only allowed when adding a scene to a viewport.

Parameters

node	Node to add as a child of this node.

◆ arrangeOverride()

void arrangeOverride ( Vector3 actualSize )

protected

Performs setting of actual node size and transformation calculations.

Parameters

actualSize The actual size available for this node.

◆ createDerived()

static <Derived extends Node3D> ObjectRef<Derived> createDerived	(	Domain	domain,
		String	name,
		Metaclass	metaclass
	)

staticprotected

Creates a derived class instance.

Call this method as part of the create method for a derived class.

Parameters

domain	UI Domain where this node belongs.
name	Name of the node
metaclass	Metaclass data of the node.

Returns: An ObjectRef that holds the created instance.

◆ getActualSize()

Vector3 getActualSize ( )

Gets actual size.

Returns: Actual size of this node.

◆ getAllocatedSize()

Vector3 getAllocatedSize ( )

Gets allocated size.

Returns: Allocated size of this node.

◆ getArrangeTransform()

Matrix4x4 getArrangeTransform ( )

Get arrange transform.

Returns: Current arrange transformation of this node.

◆ getChild()

Node3D getChild ( int index )

Returns a child from given index from node.

Parameters

index Index of the child node.

Returns: Child node at specified index.

◆ getChildCount()

int getChildCount ( )

Gets the number of children of the node.

Returns: Number of child nodes.

◆ getChildIndex()

int getChildIndex ( Node child )

Returns the index of a child in a node.

Parameters

child Child node to get index for.

Returns: Index of the specified child node.

◆ getCoreDesiredSize()

Vector3 getCoreDesiredSize ( )

Get core desired size of an object.

Returns: Current value.

◆ getDesiredSize()

Vector3 getDesiredSize ( )

Gets desired size.

Returns: Desired size of this node.

◆ getFaceToCameraTarget()

Node3D getFaceToCameraTarget ( )

Returns the camera to which this node faces to if the node is set to face a camera.

Returns: The target camera to which this node faces if it is set to face a camera.

◆ getFinalTransformation()

Matrix4x4 getFinalTransformation ( )

Gets the value of FinalTransformationProperty.

Returns: Current value.

◆ getLayoutTransformation()

SRTValue3D getLayoutTransformation ( )

Gets the value of LayoutTransformationProperty.

Returns: Current value.

◆ getLookAtTarget()

Node3D getLookAtTarget ( )

Returns the node that is set to always face this node.

Returns: The look at target node.

◆ getOrientationConstraintTarget()

Node3D getOrientationConstraintTarget ( )

Returns the node whose orientation is obtained to define the orientation of this node.

Returns: The orientation constraint target node.

◆ getPositionConstraintTarget()

Node3D getPositionConstraintTarget ( )

Returns the node whose position is obtained to define the position of this node.

Returns: The position constraint target node.

◆ getRenderTransformation()

SRTValue3D getRenderTransformation ( )

Gets the value of RenderTransformationProperty.

Returns: Current value.

◆ getSize()

Vector3 getSize ( )

Returns the size of object node.

Returns: Current size.

◆ hasChild()

boolean hasChild ( Node child )

Returns whether or not the child exists.

Returns: True if child exists, otherwise false.

◆ insertChild()

void insertChild	(	int	index,
		Node3D	child
	)

Adds a child node for object node to given index.

Parameters

index	Index where to add the child node.
child	Node to add as a child of this node.

◆ isPrimitiveLayout()

boolean isPrimitiveLayout ( )

Indicates whether the node has primitive layout behavior.

Returns: True if yes, false otherwise.

◆ isUnboundedLayoutSize()

static boolean isUnboundedLayoutSize ( Vector3 layoutSize )

static

Indicates whether a layout size is an unbound layout size.

Size is layout unbound size if any of its elements is unbounded layout value.

Parameters

layoutSize Layout size to test if it is unbound layout size.

Returns: true if the layoutSize is unbound layout size, false otherwise.

◆ isValidLayoutSize()

static boolean isValidLayoutSize ( Vector3 size )

static

Indicates whether a size is valid layout size.

Size is valid if all its elements are valid layout values (see Node::isValidLayoutValue()).

Parameters

size	Size to test if it is unbound layout size.

Returns: true if the size if valid layout size, false otherwise.

◆ iterateChildren()

Iterable<Node3D> iterateChildren ( )

Gets an Iterable object used to iterate the Node3D children.

Returns: An iterable of Node3D children.

◆ iterateChildrenReverse()

Iterable<Node3D> iterateChildrenReverse ( )

Gets an Reverse Iterable object used to iterate the Node3D children.

Returns: An reverse iterable of Node3D children.

◆ layout()

void layout ( )

Does layout pass starting from this node and iterating recursively all of its children.

Measure pass only descends up to nodes marked for requiring measure and then propagates upwards for all nodes that were changed. After measure, all nodes marked for requiring arrange and all their children are arranged. Node actual size is not known before layout. User may call layout manually to determine node actual sizes. Before calling layout, the node must have allocated size set to limit node area to anything less than infinity. Normal layout process sets allocated size to current composition size.

◆ layoutUp()

static float layoutUp ( )

static

Returns the direction to which the Y-axis grows for this node type.

Returns: The direction of Y-axis.

◆ lookAt()

void lookAt	(	Vector3	position,
		Vector3	lookAtPoint,
		Vector3	upVector
	)

Sets node transformation so that the node is in a given position looking at the given point.

Parameters

position	The new translation of the node.
lookAtPoint	A point where the node is looking at.
upVector	The new up vector of the node.

◆ measure()

void measure ( Vector3 availableSize )

Measures this node.

Parameters

availableSize Available size passed from parent.

◆ measureOverride()

Vector3 measureOverride ( Vector3 availableSize )

protected

Performs node size calculation.

Parameters

availableSize The size available for this node.

Returns: The measured size of this node.

◆ nGetMaximumBoundingBoxCoordinates()

Vector3 nGetMaximumBoundingBoxCoordinates ( )

Returns the minimum coordinates for object nodes bounding volume.

Returns: Current value.

◆ nGetMinimumBoundingBoxCoordinates()

Vector3 nGetMinimumBoundingBoxCoordinates ( )

Returns the maximum coordinates for object nodes bounding volume.

Returns: Current value.

◆ onNodePropertyChanged()

void onNodePropertyChanged	(	AbstractPropertyType	propertyType,
		PropertyNotificationReason	reason
	)

protected

Method executed on node property change.

Parameters

propertyType	Property that was changed in this node.
reason	Change reason.

◆ removeChild() [1/2]

void removeChild ( Node3D node )

Removes child node.

Parameters

node	Node to remove.

◆ removeChild() [2/2]

void removeChild ( int index )

Removes child node at specified index.

Parameters

index Index of the child to be removed.

◆ replaceUnboundedLayoutSize()

static Vector3 replaceUnboundedLayoutSize	(	Vector3	layoutSize,
		Vector3	resetSize
	)

static

Replaces any element of a layout size with appropriate element of the reset size if it is unbounded and returns the size.

Parameters

layoutSize	Layout size to test if any of its elements is unbounded layout value.
resetSize	The size whose values are used as a replacement for specified layout size's unbounded value elements.

Returns: layoutSize with its unbounded value elements replaced with the elements of resetSize.

◆ replaceUnboundedLayoutSizeWithZero()

static Vector3 replaceUnboundedLayoutSizeWithZero ( Vector3 layoutSize )

static

Replaces any element of a layout size with zero if it is unbounded and returns the size.

Parameters

layoutSize Layout size to test if any of its elements is unbounded layout value.

Returns: layoutSize with its unbounded value elements replaced with zero.

◆ setActualSize()

void setActualSize ( Vector3 actualSize )

Sets actual size.

Parameters

actualSize New actual size.

◆ setAllocatedSize()

void setAllocatedSize ( Vector3 allocatedSize )

Sets allocated size.

If allocated size differs from existing, will invalidate arrange as a side effect.

Parameters

allocatedSize New allocated size.

◆ setArrangeTransform()

void setArrangeTransform ( Matrix4x4 transform )

Set arrange transform.

If Layout transform differs existing, will invalidate arrange as a side effect.

Parameters

transform New arrange transformation matrix.

◆ setCoreDesiredSize()

void setCoreDesiredSize ( Vector3 value )

Set core desired size for an object.

Parameters

value New value.

◆ setDesiredSize()

void setDesiredSize ( Vector3 size )

Sets desired size.

Parameters

size	New desired size.

◆ setFinalTransformation()

void setFinalTransformation ( Matrix4x4 value )

Sets the value of FinalTransformationProperty.

Parameters

value New value.

◆ setLayoutTransformation()

void setLayoutTransformation ( SRTValue3D value )

Sets the value of LayoutTransformationProperty.

Parameters

value New value.

◆ setRenderTransformation()

void setRenderTransformation ( SRTValue3D value )

Sets the value of RenderTransformationProperty.

Parameters

value New value.

◆ setSize()

void setSize	(	float	width,
		float	height,
		float	depth
	)

Sets size properties of the node.

Parameters

width	The value of the WidthProperty.
height	The value of the HeightProperty.
depth	The value of the DepthProperty.

◆ unboundedLayoutSize()

static Vector3 unboundedLayoutSize ( )

static

Returns an unbounded layout size.

Returns: Unbounded layout size.

Classes

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Node3D()

Member Function Documentation

◆ addChild()

◆ arrangeOverride()

◆ createDerived()

◆ getActualSize()

◆ getAllocatedSize()

◆ getArrangeTransform()

◆ getChild()

◆ getChildCount()

◆ getChildIndex()

◆ getCoreDesiredSize()

◆ getDesiredSize()

◆ getFaceToCameraTarget()

◆ getFinalTransformation()

◆ getLayoutTransformation()

◆ getLookAtTarget()

◆ getOrientationConstraintTarget()

◆ getPositionConstraintTarget()

◆ getRenderTransformation()

◆ getSize()

◆ hasChild()

◆ insertChild()

◆ isPrimitiveLayout()

◆ isUnboundedLayoutSize()

◆ isValidLayoutSize()

◆ iterateChildren()

◆ iterateChildrenReverse()

◆ layout()

◆ layoutUp()

◆ lookAt()

◆ measure()

◆ measureOverride()

◆ nGetMaximumBoundingBoxCoordinates()

◆ nGetMinimumBoundingBoxCoordinates()

◆ onNodePropertyChanged()

◆ removeChild() [1/2]

◆ removeChild() [2/2]

◆ replaceUnboundedLayoutSize()

◆ replaceUnboundedLayoutSizeWithZero()

◆ setActualSize()

◆ setAllocatedSize()

◆ setArrangeTransform()

◆ setCoreDesiredSize()

◆ setDesiredSize()

◆ setFinalTransformation()

◆ setLayoutTransformation()

◆ setRenderTransformation()

◆ setSize()

◆ unboundedLayoutSize()