Kanzi framework  3.9.1
Java API
Node2D Class Reference

Node2D is the base class of all 2D nodes. More...

Inheritance diagram for Node2D:
[legend]

Classes

enum  ForegroundHint
 Hint for foreground handling of nodes. More...
 
enum  PerspectiveTransformationMode
 Node2D perspective transformation mode. More...
 
enum  PixelFormat
 Pixel formats. More...
 
enum  RenderType
 Node2D render type - affects elementary decisions about node rendering. More...
 

Public Member Functions

void addChild (Node2D node)
 Adds a child node. More...
 
void arrange ()
 Arranges this node.
 
void close ()
 Close the object, and release native resources.
 
Vector2 getActualSize ()
 Gets actual size. More...
 
Vector2 getAllocatedSize ()
 Gets allocated size. More...
 
Matrix3x3 getArrangeTransform ()
 Get arrange transform. More...
 
float getAspectRatio ()
 Gets the value of AspectRatioProperty. More...
 
Resource getBackgroundBrush ()
 Gets value of BackgroundBrushProperty. More...
 
CachingMode getCachingMode ()
 Gets the value of CachingModeProperty. More...
 
Node2D 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...
 
Resource getCompositionBrush ()
 Gets value of CompositionBrushProperty. More...
 
Vector2 getDesiredSize ()
 Gets desired size. More...
 
Resource getForegroundBrush ()
 Gets value of ForegroundBrushProperty. More...
 
SRTValue2D getLayoutTransformation ()
 Gets the value of LayoutTransformationProperty. More...
 
SRTValue3D getPerspectiveTransformation ()
 Gets the value of PerspectiveTransformationProperty. More...
 
float getPerspectiveTransformationFov ()
 Gets the value of PerspectiveTransformationFovProperty. More...
 
Vector3 getPerspectiveTransformationOrigin ()
 Gets the value of PerspectiveTransformationOriginProperty. More...
 
Vector3 getPerspectiveTransformationPivot ()
 Gets the value of PerspectiveTransformationPivotProperty. More...
 
Resource getRenderTarget ()
 Gets value of RenderTargetProperty. More...
 
float getRenderTargetMinimumHeight ()
 Gets the value of RenderTargetMinimumHeightProperty. More...
 
float getRenderTargetMinimumWidth ()
 Gets the value of RenderTargetMinimumWidthProperty. More...
 
float getRenderTargetReallocationLimit ()
 Gets the value of RenderTargetReallocationLimitProperty. More...
 
SRTValue2D getRenderTransformation ()
 Gets the value of RenderTransformationProperty. More...
 
Vector2 getRenderTransformationOrigin ()
 Gets the value of RenderTransformationOriginProperty. More...
 
boolean hasChild (Node child)
 Returns whether or not the child exists. More...
 
void insertChild (int index, Node2D child)
 Adds a child node for object node to given index. More...
 
boolean isDisableRenderTargetClear ()
 Gets the value of DisableRenderTargetClearProperty. More...
 
boolean isOffscreenRendering ()
 Gets the value of OffscreenRenderingProperty. More...
 
boolean isRenderSelf ()
 Gets the value of RenderSelfProperty. More...
 
boolean isSnapToPixel ()
 Gets the value of SnapToPixelProperty. More...
 
Iterable< Node2DiterateChildren ()
 Gets an Iterable object used to iterate the Node2D children. More...
 
Iterable< Node2DiterateChildrenReverse ()
 Gets an Reverse Iterable object used to iterate the Node2D children. More...
 
void layout ()
 Does layout pass starting from this node and iterating recursively all of its children. More...
 
boolean measure (Vector2 availableSize, boolean handleStretch)
 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.
 
void removeAllChildren ()
 Removes all child nodes.
 
void removeChild (Node2D node)
 Removes child node. More...
 
void removeChild (int index)
 Removes child node at specified index. More...
 
void setActualSize (Vector2 actualSize)
 Sets actual size. More...
 
void setAllocatedSize (Vector2 allocatedSize)
 Sets allocated size. More...
 
void setArrangeTransform (Matrix3x3 transform)
 Set arrange transform. More...
 
void setAspectRatio (float value)
 Sets the value of AspectRatioProperty. More...
 
void setAutoSize ()
 Sets node to automatically determine width, height and depth.
 
void setBackgroundBrush (Resource value)
 Sets value of BackgroundBrushProperty. More...
 
void setCachingMode (CachingMode value)
 Sets the value of CachingModeProperty. More...
 
void setCompositionBrush (Resource value)
 Sets value of CompositionBrushProperty. More...
 
void setDesiredSize (Vector2 size)
 Sets desired size. More...
 
void setDisableRenderTargetClear (boolean value)
 Sets the value of DisableRenderTargetClearProperty. More...
 
void setForegroundBrush (Resource value)
 Sets value of ForegroundBrushProperty. More...
 
void setLayoutTransformation (SRTValue2D value)
 Sets the value of LayoutTransformationProperty. More...
 
void setOffscreenRendering (boolean value)
 Sets the value of OffscreenRenderingProperty. More...
 
void setPerspectiveTransformation (SRTValue3D value)
 Sets the value of PerspectiveTransformationProperty. More...
 
void setPerspectiveTransformationFov (float value)
 Sets the value of PerspectiveTransformationProperty. More...
 
void setPerspectiveTransformationOrigin (Vector3 value)
 Sets the value of PerspectiveTransformationOriginProperty. More...
 
void setPerspectiveTransformationPivot (Vector3 value)
 Sets the value of PerspectiveTransformationPivotProperty. More...
 
void setRenderSelf (boolean value)
 Sets the value of RenderSelfProperty. More...
 
void setRenderTarget (Resource texture)
 Sets value of RenderTargetProperty. More...
 
void setRenderTargetMinimumHeight (float value)
 Sets the value of RenderTargetMinimumHeightProperty. More...
 
void setRenderTargetMinimumWidth (float value)
 Sets the value of RenderTargetMinimumWidthProperty. More...
 
void setRenderTargetReallocationLimit (float value)
 Sets the value of RenderTargetReallocationLimitProperty. More...
 
void setRenderTransformation (SRTValue2D value)
 Sets the value of RenderTransformationProperty. More...
 
void setRenderTransformationOrigin (Vector2 value)
 Sets the value of RenderTransformationOriginProperty. More...
 
void setSize (float width, float height)
 Sets size properties of the node. More...
 
void setSnapToPixel (boolean value)
 Sets the value of SnapToPixelProperty. More...
 
- 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< NodeComponentiterateNodeComponents ()
 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 Attributes

static final Metaclass metaclass = com.rightware.kanzi.metadata.Node2DMetadata.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

 Node2D (Domain domain, long nativeNode, Metaclass metaclass)
 Wraps a given native node. More...
 
void arrangeOverride (Vector2 actualSize)
 Performs setting of actual node size and transformation calculations. More...
 
void initialize ()
 Initializes the Node2D.
 
Vector2 measureOverride (Vector2 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...
 
void updateRenderOverride ()
 Performs node-specific updates before render.
 

Static Protected Member Functions

static< Derived extends Node2D > 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< Boolean > ContainsFocusProperty
 Indicates whether this node contains the keyboard focus. 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< Vector2DepthMarginProperty
 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< ResourceFontFamilyProperty
 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< Vector2HorizontalMarginProperty
 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< ResourceStateManagerProperty
 Sets the State Manager to the node. More...
 
DynamicPropertyType< ResourceStyleProperty
 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< Vector2VerticalMarginProperty
 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 Node2DMetadata
DynamicPropertyType< Float > AspectRatioProperty
 Determines the proportion of width and height. More...
 
DynamicPropertyType< ResourceBackgroundBrushProperty
 The background brush to paint the background of 2D nodes. More...
 
DynamicPropertyType< Boolean > CacheValidProperty
 Indicates whether the node is cached. More...
 
DynamicPropertyType< Integer > CachingModeProperty
 Sets the caching mode of this node: More...
 
DynamicPropertyType< ResourceCompositionBrushProperty
 The brush to use to compose 2D nodes to screen. More...
 
DynamicPropertyType< Boolean > DisableRenderTargetClearProperty
 Do not clear render target buffers before rendering into it even if necessary. More...
 
DynamicPropertyType< ResourceEffectPrefabProperty
 The 2D Effect to use for this node. More...
 
DynamicPropertyType< ResourceEffectProperty
 Reports the runtime effect instance that this node uses. More...
 
DynamicPropertyType< Boolean > ForceCompositionProperty
 Force rendering to composing target even if not otherwise necessary. More...
 
DynamicPropertyType< ResourceForegroundBrushProperty
 The foreground brush to paint the foreground of 2D nodes. More...
 
DynamicPropertyType< Integer > ForegroundHintProperty
 Give a hint of the type of the foreground of 2D nodes: More...
 
DynamicPropertyType< SRTValue2DLayoutTransformationProperty
 The 2D transformation to be applied before layouting. More...
 
AbstractMetaclass metaclass = new AbstractMetaclass("Kanzi.Node2D")
 Metaclass for Node2D.
 
DynamicPropertyType< Boolean > OffscreenRenderingProperty
 When set and the node has an explicitly set render target, do not render the resulting framebuffer to screen. More...
 
DynamicPropertyType< Float > PerspectiveTransformationFovProperty
 The 3D transformation field of view (degrees) to be applied after layouting. More...
 
DynamicPropertyType< Integer > PerspectiveTransformationModeProperty
 Defines the mode of operation for the coordinate system and field of view. More...
 
DynamicPropertyType< Vector3PerspectiveTransformationOriginProperty
 The 3D transformation origin to be used for perspective transformation on this or child nodes. More...
 
DynamicPropertyType< Vector3PerspectiveTransformationPivotProperty
 The 3D pivot point in relative coordinates. More...
 
DynamicPropertyType< SRTValue3DPerspectiveTransformationProperty
 The 3D transformation to be applied after layouting. More...
 
DynamicPropertyType< Integer > PixelFormatProperty
 The pixel format of the node if rendering to a texture. More...
 
DynamicPropertyType< Boolean > RenderSelfProperty
 Whether the node renders itself. More...
 
DynamicPropertyType< Float > RenderTargetMinimumHeightProperty
 Sets the minimum height of implicitly generated render targets. More...
 
DynamicPropertyType< Float > RenderTargetMinimumWidthProperty
 Sets the minimum width of implicitly generated render targets. More...
 
DynamicPropertyType< ResourceRenderTargetProperty
 Forces the node to be rendered into a given render target texture. More...
 
DynamicPropertyType< Float > RenderTargetReallocationLimitProperty
 The change in size that triggers reallocation of a render target. More...
 
DynamicPropertyType< Vector2RenderTransformationOriginProperty
 Sets the render transform origin in relative coordinates. More...
 
DynamicPropertyType< SRTValue2DRenderTransformationProperty
 The 2D transformation to be applied after layouting. More...
 
DynamicPropertyType< Boolean > SnapToPixelProperty
 Snap the translation of the node and its size into pixel boundary. More...
 

Detailed Description

Node2D is the base class of all 2D nodes.

Node2D implements functionality common to all 2D nodes, such as rendering, layout and hit testing. You should use classes derived from Node2D like Image2D, EmptyNode2D and StackLayout2D to construct UI graphs. You can configure common parameters for rendering and layout with methods of Node2D. Use methods of derived classes to control behavior specific to them.

Constructor & Destructor Documentation

◆ Node2D()

Node2D ( Domain  domain,
long  nativeNode,
Metaclass  metaclass 
)
protected

Wraps a given native node.

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

Parameters
domainUI Domain where this node belongs.
nativeNodeNative object that is backing this node.
metaclassMetaclass data for this node.

Member Function Documentation

◆ addChild()

void addChild ( Node2D  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
nodeNode to add as a child of this node.

◆ arrangeOverride()

void arrangeOverride ( Vector2  actualSize)
protected

Performs setting of actual node size and transformation calculations.

Parameters
actualSizeThe actual size available for this node.

◆ createDerived()

static <Derived extends Node2D> 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
domainUI Domain where this node belongs.
nameName of the node
metaclassMetaclass data of the node.
Returns
An ObjectRef that holds the created instance.

◆ getActualSize()

Vector2 getActualSize ( )

Gets actual size.

Returns
Actual size of this node.

◆ getAllocatedSize()

Vector2 getAllocatedSize ( )

Gets allocated size.

Returns
Allocated size of this node.

◆ getArrangeTransform()

Matrix3x3 getArrangeTransform ( )

Get arrange transform.

Returns
Current arrange transformation of this node.

◆ getAspectRatio()

float getAspectRatio ( )

Gets the value of AspectRatioProperty.

Returns
Current value.

◆ getBackgroundBrush()

Resource getBackgroundBrush ( )

Gets value of BackgroundBrushProperty.

Returns
Current value.

◆ getCachingMode()

CachingMode getCachingMode ( )

Gets the value of CachingModeProperty.

Returns
Caching mode value.

◆ getChild()

Node2D getChild ( int  index)

Returns a child from given index from node.

Parameters
indexIndex 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
childChild node to get index for.
Returns
Index of the specified child node.

◆ getCompositionBrush()

Resource getCompositionBrush ( )

Gets value of CompositionBrushProperty.

Returns
Current value.

◆ getDesiredSize()

Vector2 getDesiredSize ( )

Gets desired size.

Returns
Desired size of this node.

◆ getForegroundBrush()

Resource getForegroundBrush ( )

Gets value of ForegroundBrushProperty.

Returns
Current value.

◆ getLayoutTransformation()

SRTValue2D getLayoutTransformation ( )

Gets the value of LayoutTransformationProperty.

Returns
Current value.

◆ getPerspectiveTransformation()

SRTValue3D getPerspectiveTransformation ( )

Gets the value of PerspectiveTransformationProperty.

Returns
Current value.

◆ getPerspectiveTransformationFov()

float getPerspectiveTransformationFov ( )

Gets the value of PerspectiveTransformationFovProperty.

Returns
Current value.

◆ getPerspectiveTransformationOrigin()

Vector3 getPerspectiveTransformationOrigin ( )

Gets the value of PerspectiveTransformationOriginProperty.

Returns
Current value.

◆ getPerspectiveTransformationPivot()

Vector3 getPerspectiveTransformationPivot ( )

Gets the value of PerspectiveTransformationPivotProperty.

Returns
Current value.

◆ getRenderTarget()

Resource getRenderTarget ( )

Gets value of RenderTargetProperty.

Returns
Current value.

◆ getRenderTargetMinimumHeight()

float getRenderTargetMinimumHeight ( )

Gets the value of RenderTargetMinimumHeightProperty.

Returns
Current value.

◆ getRenderTargetMinimumWidth()

float getRenderTargetMinimumWidth ( )

Gets the value of RenderTargetMinimumWidthProperty.

Returns
Current value.

◆ getRenderTargetReallocationLimit()

float getRenderTargetReallocationLimit ( )

Gets the value of RenderTargetReallocationLimitProperty.

Returns
Current value.

◆ getRenderTransformation()

SRTValue2D getRenderTransformation ( )

Gets the value of RenderTransformationProperty.

Returns
Current value.

◆ getRenderTransformationOrigin()

Vector2 getRenderTransformationOrigin ( )

Gets the value of RenderTransformationOriginProperty.

Returns
Current value.

◆ hasChild()

boolean hasChild ( Node  child)

Returns whether or not the child exists.

Returns
True if child exists, otherwise false.

◆ insertChild()

void insertChild ( int  index,
Node2D  child 
)

Adds a child node for object node to given index.

Parameters
indexIndex where to add the child node.
childNode to add as a child of this node.

◆ isDisableRenderTargetClear()

boolean isDisableRenderTargetClear ( )

Gets the value of DisableRenderTargetClearProperty.

Returns
Current value.

◆ isOffscreenRendering()

boolean isOffscreenRendering ( )

Gets the value of OffscreenRenderingProperty.

Returns
Current value.

◆ isRenderSelf()

boolean isRenderSelf ( )

Gets the value of RenderSelfProperty.

Returns
Current value.

◆ isSnapToPixel()

boolean isSnapToPixel ( )

Gets the value of SnapToPixelProperty.

Returns
Current value.

◆ iterateChildren()

Iterable<Node2D> iterateChildren ( )

Gets an Iterable object used to iterate the Node2D children.

Returns
An iterable of Node2D children.

◆ iterateChildrenReverse()

Iterable<Node2D> iterateChildrenReverse ( )

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

Returns
An reverse iterable of Node2D 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.

◆ measure()

boolean measure ( Vector2  availableSize,
boolean  handleStretch 
)

Measures this node.

Parameters
availableSizeAvailable size passed from parent, may be null.
handleStretchShould the node handle stretching of node to fill available space?
Returns
True if measure should be propagated, false if not.

◆ measureOverride()

Vector2 measureOverride ( Vector2  availableSize)
protected

Performs node size calculation.

Parameters
availableSizeThe size available for this node.
Returns
The measured size of this node.

◆ onNodePropertyChanged()

void onNodePropertyChanged ( AbstractPropertyType  propertyType,
PropertyNotificationReason  reason 
)
protected

Method executed on node property change.

Parameters
propertyTypeProperty that was changed in this node.
reasonChange reason.

◆ removeChild() [1/2]

void removeChild ( Node2D  node)

Removes child node.

Parameters
nodeNode to remove.

◆ removeChild() [2/2]

void removeChild ( int  index)

Removes child node at specified index.

Parameters
indexIndex of the child to be removed.

◆ setActualSize()

void setActualSize ( Vector2  actualSize)

Sets actual size.

Parameters
actualSizeNew actual size.

◆ setAllocatedSize()

void setAllocatedSize ( Vector2  allocatedSize)

Sets allocated size.

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

Parameters
allocatedSizeNew allocated size.

◆ setArrangeTransform()

void setArrangeTransform ( Matrix3x3  transform)

Set arrange transform.

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

Parameters
transformNew arrange transformation matrix.

◆ setAspectRatio()

void setAspectRatio ( float  value)

Sets the value of AspectRatioProperty.

Parameters
valueNew value.

◆ setBackgroundBrush()

void setBackgroundBrush ( Resource  value)

Sets value of BackgroundBrushProperty.

Parameters
valueNew value.

◆ setCachingMode()

void setCachingMode ( CachingMode  value)

Sets the value of CachingModeProperty.

Parameters
valueNew caching mode value.

◆ setCompositionBrush()

void setCompositionBrush ( Resource  value)

Sets value of CompositionBrushProperty.

Parameters
valueNew value.

◆ setDesiredSize()

void setDesiredSize ( Vector2  size)

Sets desired size.

Parameters
sizeNew desired size.

◆ setDisableRenderTargetClear()

void setDisableRenderTargetClear ( boolean  value)

Sets the value of DisableRenderTargetClearProperty.

Parameters
valueNew value.

◆ setForegroundBrush()

void setForegroundBrush ( Resource  value)

Sets value of ForegroundBrushProperty.

Parameters
valueNew value.

◆ setLayoutTransformation()

void setLayoutTransformation ( SRTValue2D  value)

Sets the value of LayoutTransformationProperty.

Parameters
valueNew value.

◆ setOffscreenRendering()

void setOffscreenRendering ( boolean  value)

Sets the value of OffscreenRenderingProperty.

Parameters
valueNew value.

◆ setPerspectiveTransformation()

void setPerspectiveTransformation ( SRTValue3D  value)

Sets the value of PerspectiveTransformationProperty.

Parameters
valueNew value.

◆ setPerspectiveTransformationFov()

void setPerspectiveTransformationFov ( float  value)

Sets the value of PerspectiveTransformationProperty.

Parameters
valueNew value.

◆ setPerspectiveTransformationOrigin()

void setPerspectiveTransformationOrigin ( Vector3  value)

Sets the value of PerspectiveTransformationOriginProperty.

Parameters
valueNew value.

◆ setPerspectiveTransformationPivot()

void setPerspectiveTransformationPivot ( Vector3  value)

Sets the value of PerspectiveTransformationPivotProperty.

Parameters
valueNew value.

◆ setRenderSelf()

void setRenderSelf ( boolean  value)

Sets the value of RenderSelfProperty.

Parameters
valueNew value.

◆ setRenderTarget()

void setRenderTarget ( Resource  texture)

Sets value of RenderTargetProperty.

Parameters
textureNew value.

◆ setRenderTargetMinimumHeight()

void setRenderTargetMinimumHeight ( float  value)

Sets the value of RenderTargetMinimumHeightProperty.

Parameters
valueNew value.

◆ setRenderTargetMinimumWidth()

void setRenderTargetMinimumWidth ( float  value)

Sets the value of RenderTargetMinimumWidthProperty.

Parameters
valueNew value.

◆ setRenderTargetReallocationLimit()

void setRenderTargetReallocationLimit ( float  value)

Sets the value of RenderTargetReallocationLimitProperty.

Parameters
valueNew value.

◆ setRenderTransformation()

void setRenderTransformation ( SRTValue2D  value)

Sets the value of RenderTransformationProperty.

Parameters
valueNew value.

◆ setRenderTransformationOrigin()

void setRenderTransformationOrigin ( Vector2  value)

Sets the value of RenderTransformationOriginProperty.

Parameters
valueNew value.

◆ setSize()

void setSize ( float  width,
float  height 
)

Sets size properties of the node.

Parameters
widthThe value of the WidthProperty.
heightThe value of the HeightProperty.

◆ setSnapToPixel()

void setSnapToPixel ( boolean  value)

Sets the value of SnapToPixelProperty.

Parameters
valueNew value.