Node2D is the base class of all 2D nodes. More...
#include <kanzi/core.ui/node/node2d.hpp>
Classes | |
| struct | ClippingArea |
| Clipping information carried from parents. More... | |
Public Types | |
| typedef ChildContainer::const_iterator | ChildConstIterator |
| Iterator type for children. More... | |
| typedef ChildContainer::const_reverse_iterator | ChildConstReverseIterator |
| Reverse iterator type for children. More... | |
| typedef vector< Node2DSharedPtr > | ChildContainer |
| Container type for children. More... | |
| enum | ForegroundHint { ForegroundHintNone, ForegroundHintTranslucent, ForegroundHintOpaque } |
| Hint for foreground handling of nodes. More... | |
| typedef NodeSharedPtr(* | HitTestVisitor) (Node2D &node, Vector2 nodePoint, void *userData) |
| Hit test visitor function. More... | |
| typedef Matrix3x3 | LayoutMatrixType |
| typedef Vector2 | LayoutVectorType |
| enum | PerspectiveTransformationMode { Screen, XFov, YFov } |
| Node2D perspective transformation mode. More... | |
| enum | PixelFormat { PixelFormatRgb, PixelFormatRgba } |
| Pixel formats. More... | |
| enum | RenderType { RenderTypeNone, RenderTypeTexture, RenderTypeManual, RenderTypeManualClipped } |
| Node2D render type - affects elementary decisions about node rendering. More... | |
 Public Types inherited from kanzi::Node | |
| enum | ContentStretch { ContentStretchNone, ContentStretchFill, ContentStretchUniform, ContentStretchUniformToFill, ContentStretchRepeat } |
| Content stretch option. More... | |
| enum | DepthAlignment { DepthAlignmentBack, DepthAlignmentFront, DepthAlignmentCenter, DepthAlignmentStretch } |
| Depth alignment options. More... | |
| enum | HorizontalAlignment { HorizontalAlignmentLeft, HorizontalAlignmentRight, HorizontalAlignmentCenter, HorizontalAlignmentStretch } |
| Horizontal alignment options. More... | |
| typedef InputManipulatorContainer::const_iterator | InputManipulatorConstIterator |
| typedef vector< InputManipulatorBaseSharedPtr > | InputManipulatorContainer |
| Gets the input manipulator iterator. More... | |
| typedef InputManipulatorContainer::iterator | InputManipulatorIterator |
| typedef kanzi::vector< Node::MessageSubscriptionToken > | MessageSubscriptionTokenVector |
| typedef NodeComponentContainer::const_iterator | NodeComponentConstIterator |
| typedef vector< NodeComponentEntry > | NodeComponentContainer |
| Gets the node component iterator. More... | |
| typedef NodeComponentContainer::iterator | NodeComponentIterator |
| enum | VerticalAlignment { VerticalAlignmentBottom, VerticalAlignmentTop, VerticalAlignmentCenter, VerticalAlignmentStretch } |
| Vertical alignment options. More... | |
| typedef function< VisitorResult(Node &)> | Visitor |
| Defines the type of the function that Kanzi executes for each node when visiting a node tree. More... | |
| enum | VisitorOrder { VisitorPreOrder, VisitorPostOrder } |
| Defines the order in which Kanzi visits the nodes in a node tree. More... | |
| enum | VisitorResult { VisitorAbort, VisitorContinue, VisitorContinueSibling } |
| Defines the return type of the Node::Visitor function. More... | |
| Public Types inherited from kanzi::PropertyObject | |
| typedef PropertyStorageContainer::const_iterator | PropertyStorageConstIterator |
| typedef vector< PropertyStoragePtr > | PropertyStorageContainer |
| typedef PropertyStorageContainer::iterator | PropertyStorageIterator |
| typedef intrusive_ptr< AbstractPropertyTypeDescriptor::PropertyStorage > | PropertyStoragePtr |
| typedef PropertyStorageContainer::reverse_iterator | PropertyStorageReverseIterator |
| Public Types inherited from kanzi::BindingHostConcept | |
| using | BindingHostConceptSharedPtr = shared_ptr< BindingHostConcept > |
| Binding host concept shared pointer type. More... | |
| using | BindingRuntimeConstIterator = BindingRuntimeContainer::const_iterator |
| Const iterator for binding runtimes. More... | |
| using | BindingRuntimeContainer = vector< AbstractBindingRuntimeSharedPtr > |
| Container for binding runtimes. More... | |
| using | BindingRuntimeIterator = BindingRuntimeContainer::iterator |
| Iterator for binding runtimes. More... | |
Public Member Functions | |
| bool | addAbstractChildOverride (NodeSharedPtr child) override |
| Node::addAbstractChildOverride() implementation. More... | |
| void | addChild (Node2DSharedPtr child) |
| Adds a child node. More... | |
| void | arrange () |
| Arrange one Node2D. More... | |
| ChildConstIterator | beginChildren () const |
| bool | compositionRequiresAlpha () const |
| Tell if composition requires alpha. More... | |
| bool | compositionRequiresDepth () const |
| Tell if composition requires depth. More... | |
| bool | compositionRequiresStencil () const |
| Tell if composition requires stencil. More... | |
| optional< Vector2 > | containsGlobal (Vector2 point) const |
| Tell if a node area contains a point (defined in screen space). More... | |
| bool | containsLocal (Vector2 point) const |
| Tell if a node area contains a point (defined in node's own space). More... | |
| ChildConstIterator | endChildren () const |
| NodeSharedPtr | findAbstractChildOverride (string_view name) override |
| Node::findAbstractChildOverride() implementation. More... | |
| size_t | getAbstractChildCountOverride () override |
| Node::getAbstractChildCountOverride() implementation. More... | |
| size_t | getAbstractChildIndexOverride (const Node &node) override |
| NodeSharedPtr | getAbstractChildOverride (size_t index) override |
| Node::getAbstractChildOverride() implementation. More... | |
| Vector2 | getActualSize () const |
| Get actual size. More... | |
| Vector2 | getAllocatedSize () const |
| Get allocated size. More... | |
| Matrix3x3 | getArrangeTransform () const |
| Get arrange transform. More... | |
| BrushSharedPtr | getBackgroundBrush () const |
| Gets value of BackgroundBrushProperty. More... | |
| BrushRenderer * | getBackgroundBrushRenderer () const |
| Get background brush renderer. More... | |
| QuadDescription | getBackgroundQuad () const |
| Gets the background quad description. More... | |
| Node2DSharedPtr | getChild (size_t index) const |
| Returns a child from given index from object node. More... | |
| Matrix3x3 | getChildCompositionSpaceTransform () const |
| Gets the transform used for composition children of the 2D node. More... | |
| size_t | getChildCount () const |
| Gets the number of children of the node. More... | |
| size_t | getChildIndex (const Node &child) const |
| Returns the index of a child in an object node. More... | |
| ClippingArea | getClippingArea () const |
| Get clipping area. More... | |
| BrushSharedPtr | getCompositionBrush () const |
| Gets value of CompositionBrushProperty. More... | |
| BrushRenderer * | getCompositionBrushRenderer () const |
| Access cache result brush renderer. More... | |
| CompositionManager * | getCompositionManager () const |
| Access composition manager. More... | |
| TextureSharedPtr | getCompositionTarget () const |
| Gets the composition target used for compositing the node. More... | |
| NodeCompositor2D * | getCompositor () const |
| Access compositor component. More... | |
| Vector2 | getContentDesiredSize () const |
| Get size desired by content. More... | |
| Vector2 | getDesiredSize () const |
| Gets desired size. More... | |
| NodeEffect2DSharedPtr | getEffect () const |
| Gets the value of EffectProperty. More... | |
| NodeEffectPrefab2DSharedPtr | getEffectPrefab () const |
| Gets the value of EffectPrefabProperty. More... | |
| NodeEffectRenderer2D * | getEffectRenderer () const |
| Gets the effect renderer. More... | |
| BrushSharedPtr | getForegroundBrush () const |
| Gets value of ForegroundBrushProperty. More... | |
| BrushRenderer * | getForegroundBrushRenderer () const |
| Get foreground brush renderer. More... | |
| float | getLayoutOpacity () const |
| Get opacity after propagation from layouting hierarchy. More... | |
| SRTValue2D | getLayoutTransformation () const |
| Gets the value of LayoutTransformationProperty. More... | |
| TextureSharedPtr | getManagedCompositionTarget () const |
| Gets the managed composition target of a node. More... | |
| Matrix3x3 | getParentSpaceTransform () const |
| Gets the parent space transform of the 2D node. More... | |
| Matrix3x3 | getPartialArrangeTransform () const |
| Get partial arrange transform. More... | |
| NodeEffect2D * | getRenderableEffect () const |
| Gets a pointer to the current effect if effect rendering is required. More... | |
| Matrix3x3 | getRenderQuadTransform () const |
| Gets transformation used to render the 2D node. More... | |
| TextureSharedPtr | getRenderTarget () const |
| Gets value of RenderTargetProperty. More... | |
| SRTValue2D | getRenderTransformation () const |
| Gets the value of RenderTransformationProperty. More... | |
| RenderType | getRenderType () const |
| Get render type. More... | |
| Vector2 | getSecondPassDesiredSize () const |
| Get second pass desired size. More... | |
| Vector2 | getUserDesiredSize () const |
| Get size desired by user. More... | |
| NodeVisual2D * | getVisual () const |
| Access visual component. More... | |
| Matrix3x3 | getWorldTransform () const |
| Get world transform. More... | |
| optional< Vector2 > | globalToLocal (Vector2 point) const |
| bool | hasCenterClipArea () const |
| Tell if Node2D has the center clip area (the area of itself). More... | |
| bool | hasChild (const Node &child) const |
| Returns whether or not the child exists. More... | |
| bool | hasCompositionTarget () const |
| Indicates whether the node has a composition target. More... | |
| bool | hasEffect () const |
| Whether an active effect is applied to this node. More... | |
| bool | hasManagedCompositionTarget () const |
| Indicates whether the node has a managed composition target. More... | |
| bool | hasOutsideClipArea () const |
| Tell if Node2D has outside clipping area. More... | |
| bool | hasTranslucentForeground () const |
| Tell if Node2D foreground has translucency. More... | |
| NodeSharedPtr | hitTest (Vector2 point) |
| Performs a hit test to a 2D node and all its child nodes. More... | |
| NodeSharedPtr | hitTest (Vector2 point, const Metaclass *type) |
| Performs a hit test to a 2D node and all its child nodes. More... | |
| template<typename T > | |
| shared_ptr< T > | hitTest (Vector2 point) |
| Wrapper for hitTest(Vector2), casts the return value. More... | |
| template<typename T > | |
| shared_ptr< T > | hitTest (Vector2 point, const Metaclass *type) |
| Wrapper for hitTest(Vector2, const Metaclass), casts the return value. More... | |
| virtual tuple< NodeSharedPtr, Ray, float > | hitTestContent (Vector2 point) |
| Default implementation of Node2D content hit test. More... | |
| NodeSharedPtr | hitTestIterate (Vector2 point, HitTestVisitor visitor, void *userData) |
| Recursively hit test nodes from this node downwards and call visitor function on nodes hit. More... | |
| void | insertChild (size_t index, Node2DSharedPtr child) |
| Adds a child node for object node to given index. More... | |
| bool | isCacheValid () const |
| Tell if children cache is valid. More... | |
| bool | isClearColorAllowed () const |
| Indicates whether this Node2D is allowed and should clear the color buffer of its own composition target. More... | |
| bool | isCompletelyClipped () const |
| Tell if node is completely clipped (and needs not be rendered). More... | |
| bool | isCompletelyTransparent () const |
| Tell if node is completely transparent. More... | |
| bool | isCompositionClearColorRequired () const |
| Indicates whether composition target requires color clear before rendering. More... | |
| bool | isCompositionPotentiallyRequired () const |
| Tell if node itself is going to get rendered into a composition target. More... | |
| bool | isPerspectiveTransformActive () const |
| Tell if node is being perspective transformed. More... | |
| bool | isRenderChildrenAllowed () const |
| Tell if rendering children is allowed. More... | |
| bool | isRenderSelfAllowed () const |
| Tell if render self is allowed. More... | |
| bool | isSelfInCompositionTarget () const |
| Tell if node itself is going to get rendered into a composition target. More... | |
| bool | isVisibleForHitTesting () const |
| Tell if Node2D is visible for hit testing. More... | |
| void | layout (optional< Matrix3x3 > rootTransform) |
| Does layout pass starting from this node and iterating recursively all of its children. More... | |
| void | layout () |
| Does layout pass with no root transformation (identity). More... | |
| bool | measure (const Vector2 *availableSize, bool handleStretch) |
| Measure one node. More... | |
| virtual bool | measureRecursive () |
| Perform measure recursively. More... | |
| bool | moveAbstractChildToPositionOverride (NodeSharedPtr child, size_t index) override |
| Node::moveAbstractChildToPosition() implementation. More... | |
| void | moveChildToPosition (Node2DSharedPtr child, size_t index) |
| Moves a child node to a given position in the list of child nodes. More... | |
| void | moveToBack () |
| Repositions the node to the beginning of its parent's children, so that it is drawn first. More... | |
| void | moveToFront () |
| Repositions the node to the end of its parent's children, so that it is drawn last. More... | |
| ChildConstReverseIterator | rbeginChildren () const |
| bool | removeAbstractChildOverride (Node &child) override |
| Node::removeAbstractChildOverride() implementation. More... | |
| void | removeAllChildren () |
| Removes all child nodes. More... | |
| void | removeChild (const Node &child) |
| Removes child node. More... | |
| void | removeChild (size_t index) |
| Removes child node at specified index. More... | |
| ChildConstReverseIterator | rendChildren () const |
| void | render (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Renders a node and its descendant nodes. More... | |
| void | render (Renderer3D &renderer, CompositionStack &compositionStack) |
| Render a node and its descendant nodes. More... | |
| bool | requiresBackgroundBrushRendering () const |
| Tell if background brush rendering is required. More... | |
| bool | requiresForegroundBrushRendering () const |
| Tell if foreground brush rendering is required. More... | |
| bool | requiresLocalTransformationScope () const |
| Indicates whether local transformation scope is required. More... | |
| bool | requiresTilingUpdate () const |
| Indicates whether node geometry requires an update for the tiling. More... | |
| void | resetCache () |
| Reset cached content for complete node content including itself and its children. More... | |
| void | setActualSize (Vector2 actualSize) |
| Set actual size. More... | |
| void | setActualSize (float sizeX, float sizeY) |
| Set actual size. More... | |
| void | setAllocatedSize (Vector2 allocatedSize) |
| Set allocated size. More... | |
| void | setArrangeTransform (Matrix3x3 transform) |
| Set arrange transform. More... | |
| void | setAutoHeight () |
| Sets node to automatically determine height. More... | |
| void | setAutoSize () |
| Sets node to automatically determine both width and height. More... | |
| void | setAutoWidth () |
| Sets node to automatically determine width. More... | |
| void | setBackgroundBrush (BrushSharedPtr value) |
| Sets value of BackgroundBrushProperty. More... | |
| void | setClearColorAllowed (bool enabled) |
| Set clear color allowed. More... | |
| void | setCompositionBrush (BrushSharedPtr value) |
| Sets value of CompositionBrushProperty. More... | |
| void | setCompositionRequested (bool enabled) |
| Turn composition request on or off. More... | |
| void | setCompositionRequiresAlpha (bool enabled) |
| Turn composition alpha requirement on or off. More... | |
| void | setCompositionRequiresDepth (bool enabled) |
| Turn composition depth requirement on or off. More... | |
| void | setCompositionRequiresStencil (bool enabled) |
| Turn composition stencil requirement on or off. More... | |
| void | setDesiredSize (Vector2 desiredSize) |
| Sets desired size. More... | |
| void | setEffectPrefab (NodeEffectPrefab2DSharedPtr value) |
| Sets the value of EffectPrefabProperty. More... | |
| void | setForegroundBrush (BrushSharedPtr value) |
| Sets value of ForegroundBrushProperty. More... | |
| void | setForegroundIsTranslucent (bool enabled) |
| Set foreground translucency status. More... | |
| KZ_DEPRECATED void | setLayoutSize (float width, float height) |
| Sets size properties of the node. More... | |
| void | setLayoutTransformation (SRTValue2D value) |
| Sets the value of LayoutTransformationProperty. More... | |
| void | setPotentialCompositionBitViewport (bool enabled) |
| Turns the potential composition flag for the viewport on or off. More... | |
| void | setRenderTarget (TextureSharedPtr texture) |
| Sets value of RenderTargetProperty. More... | |
| void | setRenderTransformation (SRTValue2D value) |
| Sets the value of RenderTransformationProperty. More... | |
| void | setRequiresLocalTransformationScope (bool enabled) |
| Sets the local transformation scope requirement. More... | |
| void | setRequiresTilingUpdate (bool enabled) |
| Sets the tiling update requirement. More... | |
| void | setSize (float width, float height) |
| Sets size properties of the node. More... | |
| void | setSize (Vector2 size) |
| Sets size properties of the node. More... | |
| void | transform () |
| Transform one Node2D. More... | |
| VisitorResult | visitAbstractChildOverride (const Visitor &visitor, VisitorOrder order) override |
| Node::visitAabstractChild implementation. More... | |
| ~Node2D () override | |
| Public Member Functions inherited from kanzi::Node | |
| ResourceSharedPtr | acquireResource (const ResourceID &id) const |
| Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary. More... | |
| template<typename T > | |
| shared_ptr< T > | acquireResource (const ResourceID &id) const |
| Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary, and casts the resource to given type. More... | |
| ResourceManager::AcquireTaskSharedPtr | acquireResourceAsync (const ResourceID &key, ResourceManager::AsyncAcquireFinishedCallback func) const |
| Posts an asynchronous task to acquire a resource. More... | |
| ResourceDictionarySharedPtr | acquireResourceDictionary () |
| Gets the resource dictionary of the node. More... | |
| void | addAnonymousResource (ResourceSharedPtr resource) |
| Adds alias resource to an object node. More... | |
| void | addInputManipulator (InputManipulatorBaseSharedPtr inputManipulator) |
| Transfers the ownership and attaches an input manipulator to an object node. More... | |
| template<typename TMessageType , typename TClass , typename TClassMethod > | |
| MessageSubscriptionToken | addMessageFilter (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method) |
| Adds a message filter where the filter is a method that is invoked on an object. More... | |
| template<typename TMessageType > | |
| MessageSubscriptionToken | addMessageFilter (const TMessageType &messageType, typename TMessageType::FunctionType function) |
| Adds a message filter where the filter is a function. More... | |
| template<typename TMessageType , typename TClass , typename TClassMethod > | |
| MessageSubscriptionToken | addMessageHandler (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method) |
| Adds a message handler where the handler is a method that is invoked on an object. More... | |
| template<typename TMessageType > | |
| MessageSubscriptionToken | addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function) |
| Adds a message handler where the handler is a function. More... | |
| template<typename TMessageType > | |
| MessageSubscriptionToken | addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function, Node *messageSourceFilter) |
| Adds a message handler where the handler is a function and you explicitly define the accepted source. More... | |
| void | addNodeComponent (NodeComponentSharedPtr nodeComponent) |
| Transfers the ownership of a node component to an object node. More... | |
| void | addNodeComponentWithOwner (NodeComponentSharedPtr nodeComponent, const void *owner) |
| Transfers the ownership of a node component to an object node and sets the owner of the node component. More... | |
| void | addNodeReference (AbstractPropertyType propertyType, AbstractNodeReference *reference) |
| void | addResource (const ResourceID &resourceId, string_view resourceUrl) |
| Adds a resource manager resource to an object node. If resourceID already exists in object, removes the existing entry. If resourceURL is NULL, error is thrown. */. More... | |
| void | addResourceDictionary (ResourceDictionarySharedPtr resourceDictionary) |
| Add a nested resource dictionary to the resource dictionary of the node. More... | |
| void | addResourceReference (AbstractPropertyType propertyType, AbstractResourceReference *reference) |
| This is a helper for automatic resource tracking in ResourceReference. More... | |
| template<typename TMessageType > | |
| MessageSubscriptionToken | addTunnelingFilter (const TMessageType &messageType, typename TMessageType::FunctionType function) |
| Adds a message filter where the filter is a function. More... | |
| template<typename TMessageType , typename TClass , typename TClassMethod > | |
| MessageSubscriptionToken | addTunnelingFilter (const TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method) |
| Adds a message filter where the filter is a method that is invoked on an object. More... | |
| template<typename TMessageType > | |
| MessageSubscriptionToken | addTunnelingHandler (const TMessageType &messageType, typename TMessageType::FunctionType function, Node *messageSourceFilter) |
| Adds a message handler where the handler is a function and you explicitly define the accepted source. More... | |
| AppliedStyleEntrySharedPtr | applyManualStyle (StyleSharedPtr style) |
| Applies a style to an object node. More... | |
| AppliedStyleEntrySharedPtr | applyStyle (StyleSharedPtr style) |
| Applies a style to an object node. More... | |
| void | applyStyles () |
| Apply all styles for an object node. More... | |
| void | applyStylesRecursive () |
| Applies styles recursively. More... | |
| void | attachRecursive () |
| Attaches an object node and its children recursively. More... | |
| InputManipulatorConstIterator | beginInputManipulators () const |
| NodeComponentConstIterator | beginNodeComponents () const |
| void | clearChangeFlag (uint32_t flag) |
| Clears a change flag. More... | |
| void | clearChildChangeFlag (uint32_t flag) |
| Clears a child change flag. More... | |
| bool | containsResource (const ResourceID &resourceID) const |
| Returns if object node resource dictionary contains the resource with given ID. Resource can be any type: style, alias or resource manager resource. */. More... | |
| BindingLookupContextPtr | createLookupContext (NodeSharedPtr templateRoot) |
| Creates a lookup context for the node. More... | |
| void | detachRecursive () |
| Detaches an object node and its children recursively. More... | |
| void | dispatchAbstractMessage (const AbstractMessageType &messageType, MessageArguments &messageArguments) |
| Dispatches a message from this node with specified arguments. More... | |
| template<typename TArgumentsType > | |
| void | dispatchMessage (const MessageType< TArgumentsType > &messageType, typename MessageType< TArgumentsType >::ArgumentsType &messageArguments) |
| Dispatches a message from this node with specified arguments. More... | |
| InputManipulatorConstIterator | endInputManipulators () const |
| NodeComponentConstIterator | endNodeComponents () const |
| template<typename TNodeType > | |
| shared_ptr< TNodeType > | findAbstractChild (string_view name) |
| Find a child by name. Finds direct children as well as children connected indirectly for example Viewport->Scene. More... | |
| optional< string > | findResourceURL (const ResourceID &resourceId) const |
| Tries to find Resource URL for Resource ID from this node. More... | |
| template<typename DataType > | |
| DataType | getAbstractProperty (AbstractPropertyType abstractPropertyType) const |
| uint32_t | getChangeFlags () const |
| Get current change flags. More... | |
| uint32_t | getChildChangeFlags () const |
| Get current child change flags. More... | |
| FocusScope * | getFocusScopeInfo () const |
| Returns the information about the focus scope for a node. More... | |
| AbstractPropertyTypeDescriptor::ValueSource * | getNodeFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| template<typename DataType > | |
| optional< typename PropertyType< DataType >::DataType > | getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const |
| template<typename DataType > | |
| optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalProperty (const PropertyType< DataType > &propertyType) const |
| Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value. More... | |
| Node * | getParent () const |
| Returns the parent of the node. More... | |
| template<typename DataType > | |
| PropertyType< DataType >::Traits::ReturnType | getProperty (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property. More... | |
| ResourceDictionarySharedPtr | getResourceDictionary () const |
| Gets the resource dictionary of the node, if the node has one. More... | |
| NodeSharedPtr | getTemplateRoot () const |
| Gets the template root of this node. More... | |
| void | invalidateArrange () |
| Invalidates arrange. More... | |
| void | invalidateDraw () |
| Invalidates draw flag for the node. More... | |
| void | invalidateFinalTransform () |
| Invalidates final transform for node. More... | |
| void | invalidateMeasure () |
| Invalidates measure for the node. More... | |
| void | invalidateRender () |
| Invalidates render for node. More... | |
| bool | isAnyChangeFlagSet (uint32_t flag) const |
| Checks if any of given flags is set. More... | |
| bool | isAnyChildChangeFlagSet (uint32_t flag) const |
| Checks if any child change flags (corresponding to given mask) are set. More... | |
| bool | isAttached () const |
| Returns true if the node is attached to a screen or one of its descendants. More... | |
| bool | isAttaching () const |
| Returns true if node is in the process of attaching, false otherwise. More... | |
| bool | isChangeFlagSet (uint32_t flag) const |
| Checks if a change flag is set. More... | |
| bool | isChildChangeFlagSet (uint32_t flag) const |
| Checks if child change flags match. More... | |
| bool | isDetaching () const |
| Returns true if the node currently detaching. More... | |
| bool | isEffectivelyFocusable () const |
| Returns whether a node and its ancestor focus scope nodes are focusable. More... | |
| bool | isEffectivelyVisible () const |
| Returns whether a node and its ancestor nodes are visible. More... | |
| bool | isInitialized () const |
| Returns true if initialize() has been called, false otherwise. More... | |
| bool | isInvalidArrange () const |
| Checks if the node needs arrange. More... | |
| bool | isInvalidDraw () |
| Tells if node draw flag is invalid. More... | |
| bool | isInvalidFinalTransform () const |
| Tells if final transform flag is invalid for node. More... | |
| bool | isInvalidMeasure () const |
| Check if the node needs measure. More... | |
| bool | isInvalidRender () const |
| Returns if node render flag is invalid. More... | |
| bool | isNamed (string_view name) const |
| KZ_METACLASS_PROPERTY_TYPE (FontFamilyProperty) | |
| template<typename Type > | |
| shared_ptr< Type > | lookupNode (string_view pathOrKey) |
| Returns a node of specified type by looking it up with specified path or alias. More... | |
| template<typename Type > | |
| shared_ptr< Type > | lookupNodeComponent (string_view name) |
| Returns a node component of specified type by looking it up with specified name. More... | |
| Node * | lookupNodeRaw (string_view relativePath) |
| Get an object node by another node and a relative path. More... | |
| ObjectSharedPtr | lookupObject (string_view relativePath) |
| Lookup for an object from a node. More... | |
| template<typename Type > | |
| shared_ptr< Type > | lookupObject (string_view relativePath) |
| Lookup for an object from a node. More... | |
| tuple< NodeSharedPtr, AbstractPropertyType > | lookupObjectForStateManager (string_view relativePath) |
| Lookup for an node and possible object from within the node for state manager. More... | |
| void | notifyResourceDictionaryModified () |
| Forces the re-evaluation of resource IDs in a node tree. More... | |
| void | removeAnonymousResource (const Resource &resource) |
| Removes anonymous resource from object node resources. More... | |
| void | removeInputManipulator (InputManipulator &inputManipulator) |
| Removes the ownership and detaches an input manipulator from an object node. More... | |
| void | removeKZBData (flat_set< AbstractPropertyType > *keepProperties) |
| Destroys all object node data loaded from KZB, including properties, bindings, node components, resources etc. More... | |
| void | removeKZBData () |
| Destroys all object node data loaded from KZB. More... | |
| void | removeMessageHandler (MessageSubscriptionToken token) |
| Removes a message subscription. More... | |
| void | removeNodeComponent (NodeComponent &nodeComponent) |
| Removes the ownership of a node component from an object node. More... | |
| void | removeNodeComponentWithOwner (const void *owner) |
| Removes all bindings with the specified owner. More... | |
| void | removeNodeReference (const AbstractNodeReference &reference) |
| void | removeResource (const ResourceID &resourceId) |
| Removes a resource with given ID from object node resource dictionary. Does not do anything if resourceID was not found. */. More... | |
| void | removeResourceReference (const AbstractResourceReference &reference) |
| This is a helper for automatic resource tracking in ResourceReference. More... | |
| void | setChangeFlag (uint32_t flag) |
| Sets a change flag. More... | |
| void | setChildChangeFlag (uint32_t flag) |
| Sets a child change flag. More... | |
| void | setParent (Node *parent) |
| Kanzi uses this method internally to set the parent of a node. More... | |
| void | setResourceDictionary (ResourceDictionarySharedPtr resourceDictionary) |
| Replaces the resource dictionary of the node. More... | |
| void | setTemplateRoot (NodeSharedPtr templateRoot) |
| Sets the template root of this node. More... | |
| ResourceSharedPtr | tryAcquireResource (const ResourceID &id) const |
| Acquires a resource from the node or the node's closest ancestor having the resource id in the resource dictionary. More... | |
| template<typename T > | |
| shared_ptr< T > | tryAcquireResource (const ResourceID &id) const |
| Acquires a resource from the node or the node's closest ancestor having the resource and casts the resource to given type. More... | |
| KZ_DEPRECATED NodeSharedPtr | trySetActiveFocus () |
| Tries to move the focus on this node. More... | |
| NodeSharedPtr | trySetFocus () |
| Tries to move the focus to this node. More... | |
| NodeSharedPtr | trySetFocus (FocusFallback fallbackOption) |
| Tries to set the focus to the newFocusNode using FocusManager::trySetFocus() but with a fallback behavior in case the node does not gain focus. More... | |
| void | unapplyStyle (AppliedStyleEntrySharedPtr appliedStyleEntry) |
| Unapplies a style from an object node. More... | |
| void | unapplyStyles () |
| Unapplies and removes all applied styles. More... | |
| void | unapplyStylesRecursive () |
| Unapplies styles recursively. More... | |
| void | validateArrange () |
| Validates arrange. More... | |
| void | validateDraw () |
| Validates draw flags for the node. More... | |
| void | validateDrawForChildrenRecursive () |
| Recursively validates draw for the children from this 2D node onwards. More... | |
| void | validateMeasure () |
| Validates measure for the node. More... | |
| void | validateRender () |
| Validates render for node. More... | |
| VisitorResult | visit (const Visitor &visitor, VisitorOrder order) |
| Visits a node and its descendants. More... | |
| VisitorResult | visitDescendants (const Visitor &visitor, VisitorOrder order) |
| Visits the descendants of a node. More... | |
| ~Node () override | |
| Destructor. More... | |
| string | getName () const |
| Gets the value of NameProperty. More... | |
| void | setName (string_view value) |
| Sets the value of NameProperty. More... | |
| string | getPath () const |
| Gets the value of PathProperty. More... | |
| void | setPath (string value) |
| Sets the value of PathProperty. More... | |
| string | getLocale () const |
| Gets the value of LocaleProperty. More... | |
| void | setLocale (string value) |
| Sets the value of LocaleProperty. More... | |
| bool | isHitTestable () const |
| Gets the value of HitTestableProperty. More... | |
| void | setHitTestable (bool value) |
| Sets the value of HitTestableProperty. More... | |
| bool | isHitTestableContainer () const |
| Gets the value of HitTestableContainerProperty. More... | |
| void | setHitTestableContainer (bool value) |
| Sets the value of HitTestableContainerProperty. More... | |
| bool | isVisible () const |
| Gets the value of VisibleProperty. More... | |
| void | setVisible (bool value) |
| Sets the value of VisibleProperty. More... | |
| bool | isEnabled () const |
| Returns the value of the EnabledProperty. More... | |
| void | setEnabled (bool value) |
| Sets the value of the EnabledProperty. More... | |
| bool | isEffectivelyEnabled () const |
| Returns the value of EffectivelyEnabledProperty. More... | |
| bool | isFocusable () const |
| Gets the value of the FocusableProperty. More... | |
| void | setFocusable (bool value) |
| Sets the value of the FocusableProperty. More... | |
| bool | isFocused () const |
| Gets the value of the FocusedProperty. More... | |
| void | setFocused (bool value) |
| Sets the value of the FocusedProperty. More... | |
| FocusState | getFocusState () const |
| Gets the value of the FocusStateProperty. More... | |
| void | setFocusState (FocusState state) |
| Sets the value of the FocusStateProperty. More... | |
| FontFamilySharedPtr | getFontFamily () const |
| Gets the font family the node uses. More... | |
| void | setFontFamily (FontFamilySharedPtr value) |
| Sets the font family the node uses. More... | |
| float | getVisibleAmountInParent () const |
| Gets the value of VisibleAmountInParentProperty. More... | |
| void | setVisibleAmountInParent (float value) |
| Sets the value of VisibleAmountInParentProperty. More... | |
| float | getProjection2DTo3DScale () const |
| Gets the value of Projection2DTo3DScaleProperty. More... | |
| void | setProjection2DTo3DScale (float value) |
| Sets the value of Projection2DTo3DScaleProperty. More... | |
| ResourceSharedPtr | getStyle () const |
| Gets the value of StyleProperty. More... | |
| void | setStyle (ResourceSharedPtr value) |
| Sets the value of StyleProperty. More... | |
| ResourceSharedPtr | getStateManager () const |
| Gets the value of StateManagerProperty. More... | |
| void | setStateManager (ResourceSharedPtr value) |
| Sets the value of StateManagerProperty. More... | |
| float | getWidth () const |
| Gets the value of WidthProperty. More... | |
| void | setWidth (float value) |
| Sets the value of WidthProperty. More... | |
| float | getHeight () const |
| Gets the value of HeightProperty. More... | |
| void | setHeight (float value) |
| Sets the value of HeightProperty. More... | |
| float | getDepth () const |
| Gets the value of DepthProperty. More... | |
| void | setDepth (float value) |
| Sets the value of DepthProperty. More... | |
| float | getActualWidth () const |
| Gets the value of ActualWidthProperty. More... | |
| void | setActualWidth (float value) |
| Sets the value of ActualWidthProperty. More... | |
| float | getActualHeight () const |
| Gets the value of ActualHeightProperty. More... | |
| void | setActualHeight (float value) |
| Sets the value of ActualHeightProperty. More... | |
| float | getActualDepth () const |
| Gets the value of ActualDepthProperty. More... | |
| void | setActualDepth (float value) |
| Sets the value of ActualDepthProperty. More... | |
| Node::HorizontalAlignment | getHorizontalAlignment () const |
| Gets the value of HorizontalAlignmentProperty. More... | |
| void | setHorizontalAlignment (Node::HorizontalAlignment value) |
| Sets the value of HorizontalAlignmentProperty. More... | |
| Node::VerticalAlignment | getVerticalAlignment () const |
| Gets the value of VerticalAlignmentProperty. More... | |
| void | setVerticalAlignment (Node::VerticalAlignment value) |
| Sets the value of VerticalAlignmentProperty. More... | |
| Node::DepthAlignment | getDepthAlignment () const |
| Gets the value of DepthAlignmentProperty. More... | |
| void | setDepthAlignment (Node::DepthAlignment value) |
| Sets the value of DepthAlignmentProperty. More... | |
| Vector2 | getHorizontalMargin () const |
| Gets the value of HorizontalMarginProperty. More... | |
| void | setHorizontalMargin (Vector2 value) |
| Sets the value of HorizontalMarginProperty. More... | |
| Vector2 | getVerticalMargin () const |
| Gets the value of VerticalMarginProperty. More... | |
| void | setVerticalMargin (Vector2 value) |
| Sets the value of VerticalMarginProperty. More... | |
| Vector2 | getDepthMargin () const |
| Gets the value of DepthMarginProperty. More... | |
| void | setDepthMargin (Vector2 value) |
| Sets the value of DepthMarginProperty. More... | |
| Node::ContentStretch | getContentStretch () const |
| Gets the value of ContentStretchProperty. More... | |
| void | setContentStretch (Node::ContentStretch value) |
| Sets the value of ContentStretchProperty. More... | |
| float | getOpacity () const |
| Gets the value of OpacityProperty. More... | |
| void | setOpacity (float value) |
| Sets the value of OpacityProperty. More... | |
| bool | isHover () const |
| Returns whether the node has HoverProperty set to true. More... | |
| bool | isClipChildren () const |
| Gets the value of ClipChildrenProperty. More... | |
| void | setClipChildren (bool value) |
| Sets the value of ClipChildrenProperty. More... | |
| Public Member Functions inherited from kanzi::Object | |
| AppliedStyleEntrySharedPtr | applyObjectStyle (kanzi::StyleSharedPtr style) |
| Applies a style to an object. More... | |
| void | applyObjectStyles () |
| Apply all styles for an object node. More... | |
| Domain * | getDomain () const |
| Returns the domain the object belongs to. More... | |
| const Metaclass * | getDynamicMetaclass () const override |
| Returns the metaclass of the dynamic type of the object. More... | |
| MainLoopScheduler * | getMainLoopScheduler () const |
| Returns the MainLoopScheduler instance of the associated Domain. More... | |
| detail::MessageDispatcher * | getMessageDispatcher () const |
| Returns the message dispatcher of the object. More... | |
| ResourceManager * | getResourceManager () const |
| Returns the resource manager of the object. More... | |
| ScriptingContextSharedPtr | getScriptingContext () const |
| Gets the scripting context of the object. More... | |
| Object (Domain *domain) | |
| void | setScriptingContext (ScriptingContextSharedPtr context) |
| Sets the scripting context of the object. More... | |
| void | unapplyObjectStyle (AppliedStyleEntrySharedPtr appliedStyleEntry) |
| void | unapplyObjectStyles () |
| Unapplies and removes all applied styles. More... | |
| ~Object () override | |
| Public Member Functions inherited from kanzi::MetaObject | |
| bool | isTypeOf (const Metaclass *objectType) const |
| Determines if the type of this object is the given type or derived from it. More... | |
| virtual | ~MetaObject () |
| Public Member Functions inherited from kanzi::PropertyObject | |
| template<typename DataType > | |
| void | addPropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner) |
| template<typename DataType > | |
| void | addPropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner) |
| template<typename DataType > | |
| void | addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, void *ownerPointer) |
| template<typename DataType > | |
| void | addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, AbstractPropertyTypeDescriptor::ValueSourceOwner *owner) |
| PropertyStorageContainer::iterator | beginPropertyStorage () |
| Returns the begin iterator to the internal property storage container. More... | |
| PropertyStorageContainer::const_iterator | beginPropertyStorage () const |
| Returns the begin iterator to the internal property storage container. More... | |
| void | clearPropertyFlag (AbstractPropertyType propertyType, uint32_t flag) |
| void | copyLocalValue (const PropertyObject &other, AbstractPropertyType propertyType) |
| Copies local value of single property from another object. More... | |
| void | copyLocalValues (const PropertyObject &other) |
| Copies all local values from another object. More... | |
| PropertyStorageContainer::iterator | endPropertyStorage () |
| Returns the end iterator to the internal property storage container. More... | |
| PropertyStorageContainer::const_iterator | endPropertyStorage () const |
| Returns the end iterator to the internal property storage container. More... | |
| template<typename DataType > | |
| PropertyType< DataType >::Traits::ReturnType | getAbstractProperty (AbstractPropertyType abstractPropertyType) const |
| template<typename DataType > | |
| PropertyType< DataType >::Traits::ReturnType | getAbstractPropertyBase (AbstractPropertyType abstractPropertyType) const |
| template<typename DataType > | |
| optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const |
| template<typename DataType > | |
| optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalProperty (const PropertyType< DataType > &propertyType) const |
| Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value. More... | |
| template<typename DataType > | |
| optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalPropertyBase (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property disregarding modifiers, but does not default to the value in property metadata if there are no inputs to the property value. More... | |
| template<typename DataType > | |
| PropertyType< DataType >::Traits::ReturnType | getProperty (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property type. More... | |
| template<typename DataType > | |
| PropertyType< DataType >::Traits::ReturnType | getPropertyBase (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property disregarding modifiers. More... | |
| template<typename DataType > | |
| size_t | getPropertyNotificationHandlerCount (const PropertyType< DataType > &propertyType) const |
| Gets number of current notification handlers for given property type. More... | |
| bool | hasBaseValue (AbstractPropertyType propertyType) const |
| Evaluates whether there are any inputs into the property value, disregarding modifiers. More... | |
| bool | hasLocalValue (AbstractPropertyType propertyType) const |
| Evaluates whether there is a local value set for the property. More... | |
| bool | hasNonClassValue (AbstractPropertyType propertyType) const |
| Evaluates whether there is a value of any precedence higher than class default value set for the property. More... | |
| bool | hasValue (AbstractPropertyType propertyType) const |
| Evaluates whether there are any inputs into the property value. More... | |
| bool | isPropertyFlagSet (AbstractPropertyType propertyType, uint32_t flag) const |
| PropertyObject () | |
| void | removeKzbProperties (flat_set< AbstractPropertyType > *keepProperties) |
| Remove all KZB properties that are not included in a given set. More... | |
| void | removeKzbProperties () |
| Remove all KZB properties. More... | |
| template<typename DataType > | |
| void | removeLocalPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *ownerPointer) |
| void | removeLocalValue (AbstractPropertyType propertyType) |
| Removes the local value associated with the property. More... | |
| template<typename DataType > | |
| void | removePropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner) |
| template<typename DataType > | |
| void | removePropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner) |
| template<typename DataType > | |
| void | removePropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *ownerPointer) |
| template<typename DataType > | |
| void | setAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::Traits::ParameterType value) |
| template<typename DataType > | |
| void | setProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Traits::ParameterType value) |
| Sets the local value of a property type. More... | |
| void | setPropertyFlag (AbstractPropertyType propertyType, uint32_t flag) |
| void | validatePropertyModifiers (AbstractPropertyType propertyType) |
| virtual | ~PropertyObject () |
| Public Member Functions inherited from kanzi::BindingHostConceptImpl< Node > | |
| void | addBindingRuntime (AbstractBindingRuntimeSharedPtr entry, shared_ptr< void > owner) |
| Adds an already-created binding runtime to this binding host. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field, PropertyValuePrecedence precedence) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyValuePrecedence precedence) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType, PropertyField field, PropertyValuePrecedence precedence) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType, PropertyField field) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType, PropertyValuePrecedence precedence) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType) |
| Wrapper for setting a binding. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding, shared_ptr< Node > templateRoot) |
| Sets a binding with no target. More... | |
| AbstractBindingRuntimeSharedPtr | setBinding (AbstractBindingSharedPtr binding) |
| Wrapper for setting a binding with no target. More... | |
| AbstractBindingRuntimeSharedPtr | setBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field, PropertyValuePrecedence precedence) |
| Sets a binding to a certain property. More... | |
| AbstractBindingRuntimeSharedPtr | setBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, AbstractPropertyType propertyType, PropertyField field, PropertyValuePrecedence precedence) |
| Wrapper for setting a binding with owner. More... | |
| AbstractBindingRuntimeSharedPtr | setBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, AbstractPropertyType propertyType) |
| Wrapper for setting a binding with owner. More... | |
| AbstractBindingRuntimeSharedPtr | setBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, shared_ptr< Node > templateRoot) |
| Sets a binding with no target. More... | |
| AbstractBindingRuntimeSharedPtr | setBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner) |
| Wrapper for setting a binding with no target. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBinding (AbstractBindingSharedPtr binding, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field) |
| Wrapper for setting a modifier binding. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType, PropertyField field) |
| Wrapper for setting a modifier binding. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBinding (AbstractBindingSharedPtr binding, AbstractPropertyType propertyType) |
| Wrapper for setting a modifier binding. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field) |
| Sets a modifier binding. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, AbstractPropertyType propertyType, PropertyField field) |
| Wrapper for setting a modifier binding. More... | |
| AbstractBindingRuntimeSharedPtr | setModifierBindingWithOwner (AbstractBindingSharedPtr binding, shared_ptr< void > owner, AbstractPropertyType propertyType) |
| Wrapper for setting a modifier binding. More... | |
| Public Member Functions inherited from kanzi::BindingHostConcept | |
| BindingRuntimeConstIterator | beginBindingRuntimes () const |
| Returns an iterator to the beginning of binding runtimes. More... | |
| BindingRuntimeConstIterator | endBindingRuntimes () const |
| Returns an iterator to the end of binding runtimes. More... | |
| AbstractBindingRuntimeSharedPtr | getBindingRuntime (size_t idx) |
| Gets binding by index. More... | |
| size_t | getBindingRuntimeCount () const |
| Gets the number of binding runtimes added to this node. More... | |
| void | removeAllBindings () |
| Removes all binding runtimes. More... | |
| void | removeBinding (AbstractBindingRuntime &bindingRuntime) |
| Removes a binding runtime added earlier. More... | |
| void | removeBindingsWithOwner (shared_ptr< void > owner) |
| Removes all binding runtimes with the specified owner. More... | |
Static Public Member Functions | |
| static bool | isUnboundedLayoutSize (Vector2 layoutSize) |
| Indicates whether a layout size is an unbound layout size. More... | |
| static bool | isValidLayoutSize (Vector2 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 PropertyTypeEditorInfoSharedPtr | makeEditorInfo () |
| static Vector2 | replaceUnboundedLayoutSize (Vector2 layoutSize, Vector2 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 Vector2 | replaceUnboundedLayoutSizeWithZero (Vector2 layoutSize) |
| Replaces any element of a layout size with zero if it is unbounded and returns the size. More... | |
| static Vector2 | unboundedLayoutSize () |
| Returns an unbounded layout size. More... | |
| Static Public Member Functions inherited from kanzi::Node | |
| static bool | isUnboundedLayoutValue (float layoutValue) |
| Indicates whether a value is an unbound layout value. More... | |
| static bool | isValidLayoutValue (float value) |
| Indicates whether a value is valid layout value. More... | |
| static float | replaceUnboundedLayoutValue (float layoutValue, float resetValue) |
| Replaces layout value with the specified value if it is unbounded and returns it. More... | |
| static float | replaceUnboundedLayoutValueWithZero (float layoutValue) |
| Replaces layout value with zero if it is unbounded layout value and returns it. More... | |
| static float | unboundedLayoutValue () |
| Returns an unbounded layout value. More... | |
| Static Public Member Functions inherited from kanzi::Object | |
| static const Metaclass * | getStaticMetaclass () |
| Returns the metaclass of Object class. More... | |
| static PropertyTypeEditorInfoSharedPtr | makeEditorInfo () |
| Default implementation that returns empty editor info. More... | |
| Static Public Member Functions inherited from kanzi::MetaObject | |
| static const Metaclass * | getStaticMetaclass () |
| Returns the metaclass of Object class. More... | |
| static PropertyTypeEditorInfoSharedPtr | makeEditorInfo () |
| Default implementation that returns empty editor info. More... | |
Protected Types | |
| enum | Node2DFlags { AllowClear, AllowRenderChildren, AllowRenderSelf, ForegroundIsTranslucent, ForegroundTranslucencyRequested, RequiresBackgroundQuad, RequiresLocalTransformationScope, RequiresTilingUpdate, Node2DFlagsBitCount } |
| Different Node2D flags for bit set. More... | |
| Protected Types inherited from kanzi::Object | |
| typedef vector< AppliedStyleEntrySharedPtr > | AppliedStyleContainer |
| Applied style container. More... | |
Protected Member Functions | |
| NodeCompositor2D & | acquireCompositor () |
| Initializes and returns composition structure. More... | |
| NodeVisual2D & | acquireVisual () |
| Initializes and returns visual structure. More... | |
| Matrix3x3 | applyCompositionForRenderSelf (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Apply composition for rendering the node itself. More... | |
| virtual void | arrangeOverride (Vector2 actualSize) |
| Default implementation of Node2D arrange. More... | |
| virtual void | arrangeRecursive (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform, bool arrangeNeeded, bool transformChanged) |
| Perform arrange recursively. More... | |
| ClippingArea | calculateClippingArea (const Matrix3x3 &parentSpaceTransform) const |
| Calculate clipping parameters. More... | |
| optional< QuadDescription > | calculateContentStretch (Vector2 renderSize, Vector2 contentSize) |
| Calculate content stretch. More... | |
| bool | calculatePerspectiveTransformMatrices (int viewportWidth, int viewportHeight, Matrix4x4 &cameraMatrix, Matrix4x4 &projectionMatrix) const |
| Calculate perspective transform matrices. More... | |
| void | calculateTransformedBoundingArea (const Matrix3x3 &transform, Vector2 sizeIn) |
| Calculate new transformed bounding area. More... | |
| void | clearCompositionTarget (Renderer3D &renderer, CompositionStack &compositionStack, bool clearColor) |
| Clear node composition target. More... | |
| Vector2 | getDesiredSizeAxisAlignedBoundingBoxMaximum () const |
| Get desired size axis aligned bounding box maximum. More... | |
| Vector2 | getDesiredSizeAxisAlignedBoundingBoxMinimum () const |
| Get desired size axis aligned bounding box minimum. More... | |
| optional< float > | getUserAspectRatio () const |
| Get aspect ratio property assigned to the node. More... | |
| optional< float > | getUserHeight () const |
| Get layout height property assigned to the node. More... | |
| optional< float > | getUserWidth () const |
| Get layout width property assigned to the node. More... | |
| void | initialize () |
| Node2D -specific initialization. More... | |
| bool | isEmptyActualSize () const |
| Tell if the size of the node is empty or invalid. More... | |
| bool | isForegroundHintOpaque () const |
| Indicates whether foreground hint is opaque. More... | |
| bool | isForegroundHintTranslucent () const |
| Indicates whether foreground hint is translucent. More... | |
| bool | isForegroundTranslucencyRequested () const |
| Tell if foreground translucency has been requested. More... | |
| virtual Vector2 | measureOverride (Vector2 availableSize) |
| Default implementation of Node2D size calculation. More... | |
| Node2D (Domain *domain, string_view name) | |
| Constructor. More... | |
| void | onDetached () override |
| Node::onDetached() implementation. More... | |
| void | onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) override |
| Node::onNodePropertyChanged implementation. More... | |
| virtual void | onTransform () |
| Node2D transform function. More... | |
| unsigned int | performClipping (QuadDescription &backgroundQuad, optional< QuadDescription > &foregroundQuad, optional< QuadDescription > &effectQuad, unsigned int clippingResult) |
| Perform rectangle clipping. More... | |
| bool | pushLocalViewportArea (CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Push local viewport and scissor area into composition stack if it's required. More... | |
| void | renderBackground (Renderer3D &renderer, const CompositionStack &compositionStack, const Matrix3x3 &transform) |
| Render background quad of a Node2D. More... | |
| void | renderChildren (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Render all children of a Node2D. More... | |
| void | renderForeground (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &transform) |
| Render foreground of a Node2D. More... | |
| virtual void | renderForegroundOverride (Renderer3D &renderer, CompositionStack &compositionStack, const Matrix3x3 &transform) |
| Node-specific foreground render. More... | |
| virtual void | renderOverride (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Node-specific top-level render call. More... | |
| void | renderRecursive (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Render a Node2D and then recursively all its children. More... | |
| virtual void | renderSelfOverride (Renderer3D &renderer, CompositionStack &compositionStack, const optional< Matrix3x3 > &baseTransform) |
| Node-specific rendering. More... | |
| void | restoreResources () override |
| Node::restoreResources() implementation. More... | |
| void | setDesiredSizeAxisAlignedBoundingBoxMaximum (Vector2 size) |
| Set desired size axis aligned bounding box maximum. More... | |
| void | setDesiredSizeAxisAlignedBoundingBoxMaximum (float sizeX, float sizeY) |
| Set desired size maximum. More... | |
| void | setDesiredSizeAxisAlignedBoundingBoxMinimum (Vector2 size) |
| Set desired size axis aligned bounding box minimum. More... | |
| void | setDesiredSizeAxisAlignedBoundingBoxMinimum (float sizeX, float sizeY) |
| Set desired size axis aligned bounding box minimum. More... | |
| void | setEffect (NodeEffect2DSharedPtr value) |
| Sets the value of EffectProperty. More... | |
| void | setForegroundTranslucencyRequested (bool enabled) |
| Turn foreground translucency request on or off. More... | |
| void | setPartialArrangeTransform (Matrix3x3 transform) |
| Sets partial arrange transform. More... | |
| void | setRenderChildrenAllowed (bool enabled) |
| Turn render children on or off. More... | |
| void | setRenderSelfAllowed (bool enabled) |
| Turn render self on or off. More... | |
| void | setRenderType (RenderType renderType) |
| Set render type. More... | |
| void | setSecondPassDesiredSize (Vector2 size) |
| Set second pass desired size. More... | |
| void | updateContentTexture (TextureSharedPtr texture) |
| Update content texture for the foreground brush. More... | |
| void | updateFinalTransform (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform) |
| Update final transformation. More... | |
| bool | updateRender (const Matrix3x3 &worldTransform, const Matrix3x3 &parentTransform, bool transformChanged) |
| Validate node for rendering. More... | |
| virtual void | updateRenderOverride () |
| Node-specific updates done before render. More... | |
| Protected Member Functions inherited from kanzi::Node | |
| void | attach () |
| Attaches the object node. More... | |
| void | detach () |
| Detaches the object node. More... | |
| void | initialize () |
| Node-specific initialization. More... | |
| Node (Domain *domain, string_view name) | |
| Constructor. More... | |
| void | notifyPropertyHandlers (PropertyStoragePtr &propertyStorage, PropertyNotificationReason reason) override |
| virtual void | onAttached () |
| Called when an object node becomes attached. More... | |
| virtual void | updateFocusScopeInfo (FocusScopePtr &nodeScopeInfo) |
| Updates the overlay scope information that is attached to the root node of an overlay scope. More... | |
| void | updatePropertiesForConnectedNode () |
| Invokes property notifications for inherited properties during node tree connections. More... | |
| void | updatePropertiesForDisconnectedNode (Node *oldParent) |
| Invokes property notifications for inherited properties during node tree disconnections. More... | |
| void | updateResourceReferences () |
| void | updateResourceReferences (AbstractPropertyType propertyType) |
| void | updateResourceReferencesRecursive () |
| void | updateResourceReferencesRecursive (const ResourceID &resourceID) |
| Protected Member Functions inherited from kanzi::Object | |
| void | initialize () |
| void | onCopy (const Object &other) |
| Protected Member Functions inherited from kanzi::MetaObject | |
| void | initialize () |
| MetaObject () | |
| Protected Member Functions inherited from kanzi::PropertyObject | |
| AbstractPropertyTypeDescriptor::ValueSourceEntry * | acquireLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, PropertyStoragePtr &propertyStorage) |
| Acquires a local value source entry that is free for the assignment of a value. More... | |
| AbstractPropertyTypeDescriptor::ModifierStorage * | acquireModifierStorage (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) |
| AbstractPropertyTypeDescriptor::NotificationStorage * | acquireNotificationStorage (AbstractPropertyTypeDescriptor &descriptor) |
| PropertyStoragePtr | acquirePropertyStorage (AbstractPropertyTypeDescriptor &descriptor) |
| void | addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, void *ownerPointer) |
| Internally adds a property value source. More... | |
| void | addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, AbstractPropertyTypeDescriptor::ValueSourceOwner *owner) |
| Internally adds a property value source. More... | |
| AbstractPropertyTypeDescriptor::ValueSourceEntry * | constructLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) |
| PropertyStoragePtr | constructPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) |
| void | copyLocalValue (const AbstractPropertyTypeDescriptor::PropertyStorage &otherPropertyStorage) |
| Copy local value from property storage. More... | |
| AbstractPropertyTypeDescriptor::ModifierStorage * | findModifierStorage (AbstractPropertyTypeDescriptor &descriptor) |
| AbstractPropertyTypeDescriptor::NotificationStorage * | findNotificationStorage (AbstractPropertyTypeDescriptor &descriptor) const |
| AbstractPropertyTypeDescriptor::PropertyStorage * | findPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets the property storage for given property type descriptor. More... | |
| PropertyStoragePtr | findPropertyStoragePtr (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets property storage intrusive pointer which you can use to hold a reference until the end of the operation. More... | |
| AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByNameAndDataType (string_view name, PropertyDataType dataType) const |
| Finds a property type descriptor by name and data type. More... | |
| AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByQualifiedNameAndDataType (string_view qualifiedName, PropertyDataType dataType) const |
| Like findPropertyTypeDescriptorByNameAndDataType, but only searches by matching with qualified names. More... | |
| AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByUnqualifiedNameAndDataType (string_view unqualifiedName, PropertyDataType dataType) const |
| Like findPropertyTypeDescriptorByNameAndDataType, but only searches by matching with unqualified names. More... | |
| AbstractPropertyTypeDescriptor::ValueSource * | getClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| AbstractPropertyTypeDescriptor::ValueSource * | getFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| AbstractPropertyTypeDescriptor::ValueSource * | getNonClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| AbstractPropertyTypeDescriptor::ValueSource * | getTopValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets the top-level value source for a given property descriptor. More... | |
| void | onCopy (const PropertyObject &other) |
| void | removeLocalValue (AbstractPropertyTypeDescriptor &descriptor, PropertyStoragePtr &propertyStorage) |
| Removes a local value from the given property storage. More... | |
| void | removePropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, void *owner) |
| Removes a property value source. More... | |
| void | validatePropertyModifiersAndNotifyHandlers (PropertyStoragePtr &propertyStorage) |
| Protected Member Functions inherited from kanzi::BindingHostConceptImpl< Node > | |
| BindingTargetRuntimePtr | createModifierBindingTarget (shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field) |
| Creates a property modifier binding target for given combination of property type and field. More... | |
| BindingTargetRuntimePtr | createValueSourceBindingTarget (shared_ptr< Node > templateRoot, AbstractPropertyType propertyType, PropertyField field, PropertyValuePrecedence precedence, bool reuseAllowed) |
| Creates a value source binding target for given combination of property type and field. More... | |
| Node * | getThisObject () |
| Internal accessor for the Curiously Recurring Template Pattern. More... | |
| const Node * | getThisObject () const |
| Internal accessor for the Curiously Recurring Template Pattern. More... | |
| Protected Member Functions inherited from kanzi::BindingHostConcept | |
| void | attachBindings () |
| Attach all bindings stored in this object. More... | |
| void | detachBindings () |
| Detach bindings. More... | |
Protected Attributes | |
| QuadDescription | m_backgroundQuadDescription |
| Background clipping quad / composition quad description. More... | |
| NodeEffect2DSharedPtr | m_cachedEffect |
| Cached effect instance. More... | |
| ClippingArea | m_clipping |
| Clipping parameters. More... | |
| CompositionRequirements | m_compositionRequirements |
| Composition requirements for this 2D node. More... | |
| unique_ptr< NodeCompositor2D > | m_compositor |
| Composition and caching information. More... | |
| NodeEffectPrefab2DSharedPtr | m_currentEffectPrefab |
| Currently instantiated effect prefab. More... | |
| optional< QuadDescription > | m_effectQuadDescription |
| Effect quad description. More... | |
| unsigned int | m_validatedEffectPaddingChangeCounter |
| Effect padding change counter value at which effect quad was last validated. More... | |
| unique_ptr< NodeVisual2D > | m_visual |
| Visual information. More... | |
| Protected Attributes inherited from kanzi::Object | |
| AppliedStyleContainer | m_appliedStyles |
| Listing of applied styles applied to this object. More... | |
| Protected Attributes inherited from kanzi::BindingHostConcept | |
| BindingRuntimeContainer | m_bindingRuntimes |
| Bindings in this object. More... | |
Friends | |
| void | doListBoxArrange (Node2D &node) |
| class | Screen |
| class | Viewport3D |
Additional Inherited Members | |
| Static Public Attributes inherited from kanzi::Node | |
| static PropertyType< string > | NameProperty |
| Name property. More... | |
| static PropertyType< string > | PathProperty |
| Path property. More... | |
| static PropertyType< string > | LocaleProperty |
| Locale property. More... | |
| static PropertyType< bool > | CreatedFromKZBProperty |
| CreatedFromKZB property. More... | |
| static PropertyType< bool > | HitTestableProperty |
| HitTestable property. More... | |
| static PropertyType< bool > | HitTestableContainerProperty |
| HitTestableContainer property. More... | |
| static PropertyType< bool > | VisibleProperty |
| Visible property. More... | |
| static PropertyType< bool > | EnabledProperty |
| Sets whether the node is enabled. More... | |
| static PropertyType< bool > | EffectivelyEnabledProperty |
| Indicates whether the node and its ancestor nodes are enabled. More... | |
| static PropertyType< bool > | FocusableProperty |
| Sets whether a node can get focus and can participate in the focus chain navigation. More... | |
| static PropertyType< bool > | FocusedProperty |
| Sets whether a node is an focus node and can receive keyboard messages. More... | |
| static PropertyType< FocusState > | FocusStateProperty |
| Reports the focus state of a focusable node or focus scope node. More... | |
| static PropertyType< ResourceSharedPtr > | FontFamilyProperty |
| Sets the font family the node uses. More... | |
| static PropertyType< float > | VisibleAmountInParentProperty |
| VisibleAmountInParent property. More... | |
| static PropertyType< float > | Projection2DTo3DScaleProperty |
| Projection2DTo3DScale property. More... | |
| static PropertyType< ResourceSharedPtr > | StyleProperty |
| Style property. More... | |
| static PropertyType< ResourceSharedPtr > | StateManagerProperty |
| StateManager property. More... | |
| static PropertyType< void * > | PrefabTemplateSourceProperty |
| PrefabTemplateSource property. More... | |
| static PropertyType< float > | WidthProperty |
| Width property. More... | |
| static PropertyType< float > | HeightProperty |
| Height property. More... | |
| static PropertyType< float > | DepthProperty |
| Depth property. More... | |
| static PropertyType< float > | ActualWidthProperty |
| ActualWidth property. More... | |
| static PropertyType< float > | ActualHeightProperty |
| ActualHeight property. More... | |
| static PropertyType< float > | ActualDepthProperty |
| ActualDepth property. More... | |
| static PropertyType< Node::HorizontalAlignment > | HorizontalAlignmentProperty |
| HorizontalAlignment property. More... | |
| static PropertyType< Node::VerticalAlignment > | VerticalAlignmentProperty |
| VerticalAlignment property. More... | |
| static PropertyType< Node::DepthAlignment > | DepthAlignmentProperty |
| DepthAlignment property. More... | |
| static PropertyType< Vector2 > | HorizontalMarginProperty |
| Sets the horizontal space between this node and other nodes that are adjacent to this node in a layout. More... | |
| static PropertyType< Vector2 > | VerticalMarginProperty |
| Sets the vertical space between this node and other nodes that are adjacent to this node in a layout. More... | |
| static PropertyType< Vector2 > | DepthMarginProperty |
| Sets the space in the depth direction between this node and other nodes that are adjacent to this node in a layout. More... | |
| static PropertyType< Node::ContentStretch > | ContentStretchProperty |
| ContentStretch property. More... | |
| static PropertyType< float > | OpacityProperty |
| Opacity property. More... | |
| static PropertyType< bool > | HoverProperty |
| Kanzi updates the HoverProperty for a hit testable node to indicate whether the node is the foremost node under the cursor. More... | |
| static PropertyType< bool > | ClipChildrenProperty |
| ClipChildren property. More... | |
| static PropertyType< int > | SceneGraphAddNodeChangeChildFlagsProperty |
| SceneGraphAddNodeChangeChildFlags property. More... | |
| static PropertyType< int > | SceneGraphAddNodeChangeParentFlagsProperty |
| SceneGraphAddNodeChangeParentFlags property. More... | |
| static PropertyType< int > | SceneGraphRemoveNodeChangeChildFlagsProperty |
| SceneGraphRemoveNodeChangeChildFlags property. More... | |
| static PropertyType< int > | SceneGraphRemoveNodeChangeParentFlagsProperty |
| SceneGraphRemoveNodeChangeParentFlags property. More... | |
| Static Protected Member Functions inherited from kanzi::Node | |
| static VisitorResult | applyStylesVisitor (Node &node, bool apply) |
| static VisitorResult | attachVisitor (Node &node) |
| static VisitorResult | detachVisitor (Node &node) |
| static bool | processPropertyChanged (Node &node, AbstractPropertyType propertyType, const PropertyStoragePtr &nodePropertyStorage, AbstractPropertyTypeDescriptor::PropertyStorage *changedPropertyStorage, PropertyNotificationReason reason) |
| Processes notification handlers for node and property storage. More... | |
| static VisitorResult | propertyChangedVisitor (Node &node, AbstractPropertyType propertyType, AbstractPropertyTypeDescriptor::PropertyStorage *propertyStorage, PropertyNotificationReason reason) |
| static VisitorResult | updateAllResourcesVisitor (Node &node) |
| static VisitorResult | updateResourceVisitor (Node &node, const ResourceID &id) |
| static VisitorResult | validateDrawVisitor (Node &node) |
| Visitor for validating draw. More... | |
Node2D is the base class of all 2D nodes.
Node2D implements functionality common to all 2D nodes, such as rendering, layout and hit testing. To create UI graphs, use classes derived from Node2D, such as Image2D, EmptyNode2D, and StackLayout2D. You can derive from Node2D to implement your own custom rendering and layout.
You can configure common parameters for rendering and layout with methods of Node2D. Use methods of derived classes to control behavior specific to them.
To construct 2D nodes, call a create functions that return a shared pointer to the node. You can create an empty node:
You can create an image node:
Each node has its own type of create function.
Constructors of nodes are protected, and cannot be accessed except for inheriting classes. Node initialization happens within the create function, after constructing the node.
Nodes are arranged to a node tree. You can think of node trees as directed acyclic graphs with no loops. Each node can have multiple children but only one parent.
The root node of the node tree is always a 2D node. The root node does not have a parent, and it is usually of type Screen.
Viewport2D nodes serve as windows to 3D scene graphs that are displayed in the viewport area. Viewport nodes have Scene nodes as children. Scenes have Node3D children.
You can manipulate the node tree by adding children to nodes:
You can remove children from a parent node:
Parents take ownership, and hold a reference to the children.
You can explore the node tree from a node by iterating its children:
You can also go upwards to the parent:
The parent returned is valid except for the root node that has no parent (it will return 0).
Finding nodes in the node tree is inherited from Node base class. You can look for nodes with a path:
The paths work relative from the node doing the lookup. You can also traverse upwards:
If lookup fails, no node is returned. See node tree lookup in Node documentation.
Rendering nodes happens from root node downwards, iterating the tree in depth-first algorithm.
Each node has a foreground and a background. Foreground and background are rendered separately. Node classes can override foreground or background rendering separately.
Foreground is the node content, for example an image. Background is the full node area. It may be the same size as the node content or larger. Fitting the content to the node area is controlled by ContentStretchProperty, for details, see section about content stretch.
Nodes are rendered in the order they were added to the parent node. Node added first will be rendered first You can modify the rendering order by reordering the children within the parent. You can move nodes to the front to render them last:
You can move nodes to the back, to render them first:
Parent content is always rendered before rendering the children.
Rendering of node foreground, background and optional composition happens using brushes. Brushes determine how the rendering is done. They can simply display a color or an image, tint content provided by node, or render using an arbitrary shader.
Nodes have foreground, background and composition brushes. These are accessed via ForegroundBrushProperty, BackgroundBrushProperty and CompositionBrushProperty
You can set the foreground brush:
Foreground brush is used to render the content the node provides, for example an Image2D node provides an image. If node does not provide any foreground content, setting foreground brush has no effect.
You can set the background brush:
Background brush is used to render the content outside the node foreground area. If the node has no foreground or the foreground is translucent, background will fill the entire node area. If the node foreground fills the entire node area, no background will be rendered.
You can disable rendering by setting null brush:
Note that some nodes have default brushes, so removing the property would not be enough to disable rendering - the nodes would revert to default behavior.
Node translucency is controlled by OpacityProperty. You can set the opacity of a node:
Opacity affects node background, foreground, and all node children.
Node foreground and background may be translucent even if opacity property is not set if the brushes or content are translucent.
If node has children, setting Node2D as translucent affects all children. To render the children correctly in regard to overlapping translucency, parent node may need to be composited. See section about composition for details.
You can modify RenderTransformationProperty to change where nodes are rendered in regard to their parent:
Render transformation is specified as SRT - Scale, Rotation and Translation.
Render transform is relative to top left of 2D nodes by default. You can change the origin point within the node by setting RenderTransformationOriginProperty:
Render transformation origin can also be set outside the node.
The values set to render transform origin are relative to the size of the node. Value of 0.5 ; 0.5 will be the center of the node regardless of actual node size.
Render transformation happens after layout transformation has been already applied. Render transformation is not affected by layout constraints such as alignment and margins, and does not modify the size layout nodes take into account. For details about layout transformation, see the appropriate section.
You can apply perspective transformation in 3D space to bring limited 3D effects to 2D node tree. Perspective transformation is an optional transformation applied as the last Node2D transformation. Perspective transformation applies after layout and render transformations have already been applied.
You can set the perspective transformation:
The projection for perspective transformation is applied in the space of current composition space. Perspective transformation is specified as 3D SRT - 3-component Scale, Rotation and Translation vectors.
Currently the perspective transform has the following rules:
All information related to foreground and background rendering in Node2D is stored in a separate object of type NodeVisual2D. This object holds brush and geometry information required to render the node. To save memory, if node has nothing to render, no visual component is allocated.
Node2D will never release the visual component once it has been allocated once.
By default, nodes will be rendered into the rendering context of their parent. Usually, the top-level rendering context is the back buffer, provided by Screen node.
You can manually override this and render a node into a render target:
If a render target is specified, the node will take its size from the render target size. You can define fixed width and fixed height for a node that also has a render target set. The fixed size can be smaller then render target size. In this case, rendering will only happen on a part of the render target area. Specifying fixed size greater than render target size is undefined behavior. Nodes rendered into a render target will still draw the resulting composition to the rendering context of their parent.
Even if render target has not been set, nodes may be rendered using render targets to achieve correct result.
If the opacity of Viewport2D is not 1.0 or if its transformation has non-translation components, a Viewport2D renders to a render target:
Viewport2D is a 'window' to a 3D scene. It must be aligned to the units in the parent render context. If this is not the case, it needs to be composited.
All nodes will render to render targets if they have children and their opacity is not one:
The parent has opacity set, so it will first need to do composition of all its children, and then render this composition using that opacity.
When you manually assign a render target you can set it to take its size from the size of the node. In this case, Kanzi resizes the composition target to the size that the node gets during layout:
Nodes do not necessariyly have to draw their composition onto the render context of their parent. You can enable or disable offscreen rendering:
If offscreen rendering is enabled, the node will not be drawn anywhere after rendering to its render target.
You can render the render target of the node using some other node:
The render target behaves like a normal texture when used. Setting the render target to an Image2D will determine its size unless fixed size has been used.
When a Node2D is rendered into a render target, it will clear the color and depth buffers of that render target. If the render target has a depth buffer, and the node is not a Viewport2D that clears it in a RenderPass, Kanzi clears the depth buffer. If the node foreground does not fill complete composition area, or the combination of background and foreground is translucent, the color buffer will be cleared.
You can disable render target clearing:
Disabling clearing of render target will force the node to not clear even if it would otherwise decide to.
Cache render targets will be cleared if necessary even if clearing would be disabled.
To avoid rendering 2D nodes and their descendants every frame, you can cache Node2D rendering results. Caching carries a cost in GPU memory. Cache only complex nodes that are expensive to render and change rarely. You can either:
To control the caching of a 2D node, use the CachingModeProperty. You can enable or disable the cache:
When the CachingModeProperty is set to CachingModeEnabled, the node content does not change until you either:
To invalidate the cache:
After you invalidate the cache, Kanzi renders the node content once. After this, Kanzi considers the node cached again. You can disable the cache:
After you disable the cache, Kanzi renders the node normally and all changes to the node and its descendants are visible immediately.
Setting the CachingModeProperty to CachingModeAutomatic causes Kanzi to automatically update the cache of the node whenever the content of the node or its descendants change. To set Kanzi to automatically update the cache:
When the caching mode is set to automatic, any change to the node or its descendants causes Kanzi to update the cache. You can manually set the draw flag on a child node to invalidate the cache:
Setting any property that controls rendering will eventually invalidate draw.
All information related to compositing is stored in a separate class of type NodeCompositor2D. This object holds composition targets, caching information and a composition brush. Since compositing implies rendering, it is not possible to allocate a compositor without also allocating a NodeVisual2D. To save memory, if composition is not needed, no compositor component is allocated.
Node2D will never release the compositor component once it has been allocated once. Composition targets within compositor may be released if not needed.
2D nodes will try to determine their size automatically. 2D nodes with content will take the size of their content by default, e.g. Image2D will take the size of the image it displays. EmptyNode2D and Viewport2D have unbounded layout by default. This means that they take the entire available size. Available size for is calculated from the size of node's parent, or available screen area. You can use layouts such as StackLayout2D and GridLayout2D to arrange their children in a more complex manner.
You can set a fixed size to a 2D node, this will override the size it would otherwise assume:
You configure the node to determine its size automatically by removing fixed sizes:
or:
You can configure a node to take its width or height based on a specified fixed size and an aspect ratio:
If fixed width and aspect ratio are defined, height is width divided by aspect ratio. If fixed height and aspect ratio are defined, width is height multiplied by aspect ratio. If both fixed width and fixed height are defined, aspect ratio has no effect.
If neither width or height are defined, but aspect ratio is defined, the result depends on the node. Nodes that have unbounded layout, take the largest size they can with the given aspect ratio while still fitting within their allocated size. Aspect ratio has no effect with nodes with content that defines its size. This is analogous to having both fixed width and fixed height.
Nodes have an allocated area specified by the parent's area or a layout node. You can configure 2D node to align in its allocated area by setting horizontal and vertical alignment:
Horizontal alignment can be HorizontalAlignmentLeft, HorizontalAlignmentRight, HorizontalAlignmentCenter or HorizontalAlignmentStretch. Vertical alignment can be VerticalAlignmentTop, VerticalAlignmentBottom, VerticalAlignmentCenter or VerticalAlignmentStretch.
You can configure 2D node to fill its allocated area by setting alignment to stretch:
You can offset 2D nodes from the edges of its parent:
For horizontal margins, the order of values is left, then right. For vertical margins, the order of values is top, then bottom. If margins are not specified, the node will be aligned exactly at the edge of allocated area. If margins are specified, the node will be offset from the edge of allocated area by an amount equal to the margin.
You can modify LayoutTransformationProperty to change the transformation of a node in regard to its parent:
Layout transform is specified as SRT - Scale, Rotation and Translation.
A node transformed with layout transformation gets its alignment and margin applied after the transformation. Render transformation is applied after layout transformation, alignment and margins.
For information about render transformation or perspective transformation, see the corresponding sections.
Node foreground content (e.g. image) has rules on how to stretch in relation to node area. The different content stretch modes are ContentStretchNone, ContentStretchFill, ContentStretchUniform and ContentStretchUniformToFill. You can set content stretch mode:
Having no value for content stretch is the same as having ContentStretchUniform. This means foreground content is stretched to fill node area while keeping its aspect ratio. If node aspect ratio is different from content aspect ratio, the remaining area is left for background rendering.
ContentStretchNone means the foreground area will be centered in node area and keep the exact size it would have, for example image size. If node is smaller than the foreground area, it will only display a part of the content. If node is larger than foreground area, the remaining area is left for background rendering.
ContentStretchFill means the foreground area will take the exact node area. This may alter the aspect ratio of content.
ContentStretchUniformToFill means the foreground area will be centered to node area and then uniformly scaled to fill it. If node aspect ratio is different from content aspect ratio, node will only display part of the content.
During the program main loop, layout is called for the root node. Before calling layout, the screen node allocated size will be set to current graphics output size. Layout pass only evaluates nodes marked as requiring layout. Render is called immediately after layout.
As render is called immediately after layout, user can modify the node tree and see the changes before next call to user's update function. It may be useful to determine node calculated sizes or locations before waiting for the next frame. You may call layout manually:
After calling layout(), you can call getActualSize() to get the size determined by the node. Default allocated size is unbounded layout or infinity. When calling layout() manually, you must set allocated size for the node receiving the layout() call.
For details, see layout section under "Implementing custom node derived from Node2D".
You can hit test nodes in regard to their location on screen:
Hit testing uses the 'world' or 'render' coordinates of the node. These coordinates are relative to the screen, not to the parent node or to the node that does the hit testing. Node visibility and all transformations are taken into account.
Hit testing transforms global coordinates into Node2D local coordinates to determine if the node is hit. You can determine world (screen) space coordinates in Node2D local coordinate space:
The return enclosed in optional value, but is always valid if the node has a real is non-degenerate transformation.
You can test whether or not given coordinates would hit a node:
Checking whether a global coordinate is within a node is equal to calling globalToLocal() and then testing the result with containsLocal().
To do custom rendering and layout, a custom Node2D implementation must be implemented.
Custom Node2D implementations are defined by inheriting from Node2D base class.
To define a simple Node2D implementation see the following example:
This example describes a very simple class inherited from Node2D.
The following sections go through parts of the node declaration one at a time and explain the segments.
Each class derived from Node2D must have a metaclass definition To declare the metaclass, inherit from Node2D base class and list the properties specific to the inherited node:
For details about metaclass, see the description in Node documentation.
Local property types are declared in metaclass to belong to the node. Additionally, property types must be declared within the node:
It is also often useful to declare setters and getters to wrap getProperty() and setProperty() for the custom property.
After being declared in the class, the property must have a specific definition. The definition lists property metadata. The example property is defined as follows:
Note that the property has PropertyTypeChangeFlagFinalTransformation -flag set. This means that updateRender must be called for the node if it has been changed.
There are various property change flags that determine what has to be recalculated when the property is changed. PropertyTypeChangeFlagMeasure means the node has to be measured. This will cause measure and arrange to propagate from the node. measure() will be ran to the node and potentially all of its parents if measured size changed. Then, arrange() and updateRender() will be ran to node, all of the changed nodes and their descendants PropertyTypeChangeFlagArrange means the node has to be arranged. This will cause arrange to propagate from the node. arrange() and updateRender() will be ran to the node and all of its children. PropertyTypeChangeFlagFinalTransformation means that node transformation and transformations of its children have to be updated. updateRender() will be ran to the node and all its children.
Nodes may have class values for properties:
Class values override the default value the node would have for a property otherwise, but the value applies only to objects of a certain class.
For more information about properties in nodes, refer to Node documentation.
To communicate with each other, nodes in Kanzi can send messages. Message types must be declared in nodes:
Like the node itself, the message class must define a metaclass and properties.
Message type, metadata and related property metadata must be defined in addition to being declared in the node:
The argument definition is similar to property type definition. Also the message type and studio metadata need to be defined.
Node can subscribe to listen any messages. Typically on initialization.
For more information about messages, refer to Node documentation.
Constructing a node initializes node-specific values and passes to base class constructor.
Class values are initialized in the constructor.
Further initialization is done in Node::initialize(), that is called from the create function:
In this example, the node subscribes to listen a message defined earlier upon initialize:
For details of initialization, refer to Node documentation.
When a node becomes a part of the node tree, it is attached. When node no longer is a part of a node tree, it is detached. Nodes may also be attached or detached if their parent is attached or detached - typically if their parent is added or removed from the node tree.
Attaching connects and activates node features related to its location in the node tree. This includes resource references, bindings, triggers, input manipulators, etc.
For details on attach and detach, refer to Node documentation.
Custom node rendering is controlled by overriding rendering functions and setting the render type. During render process, nodes will first call their rendering functions, and then rendering will descend to the children.
To override foreground rendering, implement renderForegroundOverride(). Default implementation of renderForegroundOverride() is empty, since all nodes decide on their own rendering.
You can override all rendering of node itself, meaning both foreground and background, by implementing renderSelfOverride(). Default implementation of renderSelfOverride() applies the composition stack, and then defers to background and foreground rendering. When implementing this function, remember to ensure that the viewport settings are correct before issuing draw calls. Applying the composition stack
To use normal background rendering within overridden rendering, call renderBackground(). renderBackground() checks if background brush exists, and then renders the background quad. In the case of opaque foreground, background rendering will render a 'frame' around the node content area if possible.
For most nodes, implementing renderSelfOverride() is enough.
Node2D rendering is controlled by RenderType. It should be set upon constructor or node initialization to reflect on node rendering behavior. RenderType acts as a hint to the rendering system, regarding how to set viewport settings and how to handle background rendering.
RenderTypeNone is used for nodes that do not have a foreground and will not render it.
RenderTypeTexture is used for nodes that render their foreground as a rectangular quad - for example Image2D.
RenderTypeManual is used for nodes that handle their own foreground rendering. It implies the system having to set up viewport coordinates for the area of the node, this will push a local viewport area onto the composition stack. Nodes using RenderTypeManual should implement renderSelfOverride.
RenderTypeManualClipped is using nodes that handle their own foreground rendering, but do not need a local viewport area. This implies nodes using RenderTypeManualClipped either clip their own content, or that the user does not care about clipping. Nodes using RenderTypeManualClipped should implement at least renderForegroundOverride, possibly renderSelfOverride.
Custom nodes also follow the layout directives described in the earlier section. Layout can be partially overridden by implementing layout functions.
Node desired size is determined in measure(). Measurement pass descends recursively downwards until nodes that are flagged as needing measure are found. For every node the size of which was changed, measure ascends upwards to the root and flags node as requiring arrange. To override the size that would otherwise be determined for the node, implement measureOverride():
Content desired size for node is determined by the size returned from measureOverride(). Desired size for node is affected by the content desired size returned and node properties.
Node actual size and transformation is determined in arrange(). Arrange pass descends recursively downwards to nodes that are flagged as needing arrange, and then arranges them and all their children. Arrange process reads available size for node, then determines transformation and actual size based on node properties.
Nodes performing layout on their children, for example StackLayout2D, must implement arrangeOverride(). During parent arrange pass, children have already been measured. Arranging children works by iterating over child nodes and setting their allocated sizes and arrange transformations. For non-layout nodes, (default) arrangeOverride() sets child node allocated size as the node actual size, and resets child arrange transformation.
Node final transformation, brushes and composition settings are determined in updateRender(). updateRender() is called after arrange for all nodes that were marked as requiring transformation updated. Nodes may implement updateRenderOverride() to do custom clipping or modify brush or composition settings:
| typedef vector<Node2DSharedPtr> kanzi::Node2D::ChildContainer |
Container type for children.
| typedef ChildContainer::const_iterator kanzi::Node2D::ChildConstIterator |
Iterator type for children.
| typedef ChildContainer::const_reverse_iterator kanzi::Node2D::ChildConstReverseIterator |
Reverse iterator type for children.
| typedef NodeSharedPtr(* kanzi::Node2D::HitTestVisitor) (Node2D &node, Vector2 nodePoint, void *userData) |
Hit test visitor function.
Hint for foreground handling of nodes.
| Enumerator | |
|---|---|
| ForegroundHintNone | No hint given, assumed the background of a node can be rendered after content. |
| ForegroundHintTranslucent | Some elements rendered within the node are translucent over the background. |
| ForegroundHintOpaque | Node content is assumed to be fully opaque thus, that background does not need to be rendered. |
Node2D render type - affects elementary decisions about node rendering.
| Enumerator | |
|---|---|
| RenderTypeNone | Will not render itself except for its children. |
| RenderTypeTexture | Node will render itself as textured quad. |
| RenderTypeManual | Node handles its own rendering. |
| RenderTypeManualClipped | Node handles its own rendering, but also clips its own content. This means the node using this will not need additional composition area definitions, and can rendered directly. |
|
protected |
Different Node2D flags for bit set.
| Enumerator | |
|---|---|
| AllowClear | Is clearing allowed? This flag is turned on by default, but can be disabled by node properties. 2D nodes only clear color buffers, even if other buffers are created. |
| AllowRenderChildren | Are children rendered for this node or are they handled in a special manner? |
| AllowRenderSelf | Is the node allowed to render itself? |
| ForegroundIsTranslucent | Does layout detected foreground translucency? |
| ForegroundTranslucencyRequested | Has an extra request been filed (by implementations) for foreground translucency?. |
| RequiresBackgroundQuad | Is background quad required. |
| RequiresLocalTransformationScope | Node requires local transformation scope. Set by specialized node classes that perform their own custom composition. |
| RequiresTilingUpdate | Node requires tiling update. Kanzi sets this when the value of a tiling property changes, and clears it after updating the node geometry.
|
| Node2DFlagsBitCount | Number of options. |
|
override |
|
explicitprotected |
|
inlinestatic |
Returns the direction to which the Y-axis grows for this node type.
|
inlinestatic |
Indicates whether a size is valid layout size.
Size is valid if all its elements are valid layout values (see Node::isValidLayoutValue()).
| size | Size to test if it is unbound layout size. |
|
inlinestatic |
Returns an unbounded layout size.
|
inlinestatic |
Indicates whether a layout size is an unbound layout size.
Size is layout unbound size if any of its elements is unbounded layout value.
| layoutSize | Layout size to test if it is unbound layout size. |
|
inlinestatic |
Replaces any element of a layout size with appropriate element of the reset size if it is unbounded and returns the size.
| 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. |
Replaces any element of a layout size with zero if it is unbounded and returns the size.
| layoutSize | Layout size to test if any of its elements is unbounded layout value. |
|
inline |
Gets the value of AspectRatioProperty.
|
inline |
Sets the value of AspectRatioProperty.
|
inline |
Gets the value of ForceCompositionProperty.
|
inline |
Sets the value of ForceCompositionProperty.
|
inline |
Gets the value of ForegroundHintProperty.
|
inline |
Sets the value of ForegroundHintProperty.
|
inline |
Gets the value of OffscreenRenderingProperty.
|
inline |
Sets the value of OffscreenRenderingProperty.
|
inline |
Gets the value of DisableRenderTargetClearProperty.
|
inline |
Sets the value of DisableRenderTargetClearProperty.
|
inline |
Gets the value of PixelFormatProperty.
|
inline |
Sets the value of PixelFormatProperty.
|
inline |
Gets the value of RenderSelfProperty.
|
inline |
Sets the value of RenderSelfProperty.
|
inline |
Gets the value of RenderTargetMinimumHeightProperty.
|
inline |
Sets the value of RenderTargetMinimumHeightProperty.
|
inline |
Gets the value of RenderTargetMinimumWidthProperty.
|
inline |
Sets the value of RenderTargetMinimumWidthProperty.
|
inline |
Gets the value of RenderTargetReallocationLimitProperty.
|
inline |
Sets the value of RenderTargetReallocationLimitProperty.
|
inline |
Gets the value of CachingModeProperty.
|
inline |
Sets the value of CachingModeProperty.
| value | New caching mode value. |
|
inline |
Gets the value of PerspectiveTransformationProperty.
|
inline |
Sets the value of PerspectiveTransformationProperty.
|
inline |
Gets the value of PerspectiveTransformationModeProperty.
|
inline |
Sets the value of PerspectiveTransformationModeProperty.
|
inline |
Gets the value of PerspectiveTransformationFovProperty.
|
inline |
Sets the value of PerspectiveTransformationProperty.
|
inline |
Gets the value of PerspectiveTransformationPivotProperty.
|
inline |
Sets the value of PerspectiveTransformationPivotProperty.
|
inline |
Gets the value of PerspectiveTransformationOriginProperty.
|
inline |
Sets the value of PerspectiveTransformationOriginProperty.
|
inline |
Gets the value of RenderTransformationOriginProperty.
|
inline |
Sets the value of RenderTransformationOriginProperty.
|
inline |
Gets the value of SnapToPixelProperty.
|
inline |
Sets the value of SnapToPixelProperty.
|
static |
| ChildConstIterator kanzi::Node2D::beginChildren | ( | ) | const |
| ChildConstIterator kanzi::Node2D::endChildren | ( | ) | const |
| ChildConstReverseIterator kanzi::Node2D::rbeginChildren | ( | ) | const |
| ChildConstReverseIterator kanzi::Node2D::rendChildren | ( | ) | const |
| void kanzi::Node2D::addChild | ( | Node2DSharedPtr | child | ) |
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. Screens can have only one child which is a 2D node.
| void kanzi::Node2D::insertChild | ( | size_t | index, |
| Node2DSharedPtr | child | ||
| ) |
Adds a child node for object node to given index.
Adding a 3D node node as a child of a 2D node is only allowed when adding a scene to a viewport. Screens can have only one child which is a 2D node.
| void kanzi::Node2D::removeChild | ( | const Node & | child | ) |
Removes child node.
| void kanzi::Node2D::removeChild | ( | size_t | index | ) |
Removes child node at specified index.
| void kanzi::Node2D::removeAllChildren | ( | ) |
Removes all child nodes.
| Node2DSharedPtr kanzi::Node2D::getChild | ( | size_t | index | ) | const |
Returns a child from given index from object node.
| size_t kanzi::Node2D::getChildIndex | ( | const Node & | child | ) | const |
Returns the index of a child in an object node.
| bool kanzi::Node2D::hasChild | ( | const Node & | child | ) | const |
Returns whether or not the child exists.
| size_t kanzi::Node2D::getChildCount | ( | ) | const |
Gets the number of children of the node.
| void kanzi::Node2D::moveToBack | ( | ) |
Repositions the node to the beginning of its parent's children, so that it is drawn first.
| void kanzi::Node2D::moveToFront | ( | ) |
Repositions the node to the end of its parent's children, so that it is drawn last.
| void kanzi::Node2D::moveChildToPosition | ( | Node2DSharedPtr | child, |
| size_t | index | ||
| ) |
Moves a child node to a given position in the list of child nodes.
| child | Child node to reposition. |
| index | Position at which to place the child node in the list of child nodes. |
|
inline |
Get render type.
|
inline |
Gets the value of EffectProperty.
|
inline |
Gets a pointer to the current effect if effect rendering is required.
|
inline |
Gets the effect renderer.
The effect renderer is set only if the effect is both set and is renderable.
|
inline |
Whether an active effect is applied to this node.
|
inline |
Gets the value of EffectPrefabProperty.
|
inline |
Sets the value of EffectPrefabProperty.
|
inline |
Gets value of BackgroundBrushProperty.
|
inline |
Sets value of BackgroundBrushProperty.
|
inline |
Gets value of CompositionBrushProperty.
|
inline |
Sets value of CompositionBrushProperty.
|
inline |
Gets value of ForegroundBrushProperty.
|
inline |
Sets value of ForegroundBrushProperty.
|
inline |
Get background brush renderer.
|
inline |
Get foreground brush renderer.
|
inline |
Access cache result brush renderer.
|
inline |
Gets the value of RenderTransformationProperty.
|
inline |
Sets the value of RenderTransformationProperty.
| void kanzi::Node2D::render | ( | Renderer3D & | renderer, |
| CompositionStack & | compositionStack, | ||
| const optional< Matrix3x3 > & | baseTransform | ||
| ) |
Renders a node and its descendant nodes.
| renderer | Renderer to use. |
| compositionStack | Render context stack to use. |
| baseTransform | Optional transform in composition space. |
|
inline |
Render a node and its descendant nodes.
Omits the base transformation.
| renderer | Renderer to use. |
| compositionStack | Render context stack to use. |
|
inline |
Access visual component.
|
inline |
Gets value of RenderTargetProperty.
|
inline |
Sets value of RenderTargetProperty.
|
inline |
Gets the composition target used for compositing the node.
The composition target can be set manually by you or created automatically by Kanzi.
|
inline |
Indicates whether the node has a composition target.
|
inline |
Gets the managed composition target of a node.
|
inline |
Indicates whether the node has a managed composition target.
|
inline |
Tell if children cache is valid.
|
inline |
Reset cached content for complete node content including itself and its children.
Does not change the caching property - if caching is enabled, Kanzi recreates the cache on next render.
|
inline |
Access composition manager.
|
inline |
Access compositor component.
| void kanzi::Node2D::setAutoWidth | ( | ) |
Sets node to automatically determine width.
| void kanzi::Node2D::setAutoHeight | ( | ) |
Sets node to automatically determine height.
| void kanzi::Node2D::setAutoSize | ( | ) |
Sets node to automatically determine both width and height.
| void kanzi::Node2D::setSize | ( | float | width, |
| float | height | ||
| ) |
Sets size properties of the node.
| width | The value of the WidthProperty. |
| height | The value of the HeightProperty. |
|
inline |
Sets size properties of the node.
| size | A vector containing width and height. |
|
inline |
Sets size properties of the node.
|
inline |
Gets the value of LayoutTransformationProperty.
|
inline |
Sets the value of LayoutTransformationProperty.
|
inline |
Gets desired size.
|
inline |
Sets desired size.
| desiredSize | New size vector. |
|
inline |
Get allocated size.
|
inline |
Set allocated size.
If allocated size differs from existing, will invalidate arrange as a side effect.
| allocatedSize | New size vector. |
|
inline |
Get actual size.
|
inline |
Set actual size.
| actualSize | New size vector. |
|
inline |
Set actual size.
| sizeX | New size X component. |
| sizeY | New size Y component. |
|
inline |
Get arrange transform.
|
inline |
Set arrange transform.
If Layout transform differs existing, will invalidate arrange as a side effect.
| transform | New transformation matrix. |
| void kanzi::Node2D::layout | ( | optional< Matrix3x3 > | rootTransform | ) |
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.
| rootTransform | Transform applied to root node for arrange pass if set. Can be used to offset complete node tree, but should usually be empty. |
|
inline |
| bool kanzi::Node2D::measure | ( | const Vector2 * | availableSize, |
| bool | handleStretch | ||
| ) |
Measure one node.
| availableSize | Available size passed from parent, may be NULL. |
| handleStretch | Should the node handle stretching of node to fill available space? |
|
virtual |
Perform measure recursively.
Reimplemented in kanzi::Viewport2D.
| void kanzi::Node2D::arrange | ( | ) |
Arrange one Node2D.
|
inline |
Transform one Node2D.
|
inline |
Get world transform.
| bool kanzi::Node2D::containsLocal | ( | Vector2 | point | ) | const |
Tell if a node area contains a point (defined in node's own space).
Tell if a node area contains a point (defined in screen space).
If true, the node-space coordinates have been written into outgoing point.
| NodeSharedPtr kanzi::Node2D::hitTest | ( | Vector2 | point | ) |
Performs a hit test to a 2D node and all its child nodes.
Returns the topmost 2D node under given point.
| point | Point in world coordinates. |
| NodeSharedPtr kanzi::Node2D::hitTest | ( | Vector2 | point, |
| const Metaclass * | type | ||
| ) |
| NodeSharedPtr kanzi::Node2D::hitTestIterate | ( | Vector2 | point, |
| HitTestVisitor | visitor, | ||
| void * | userData | ||
| ) |
Recursively hit test nodes from this node downwards and call visitor function on nodes hit.
Used for specific implementations of hit testing.
| point | Point in world coordinates. |
| visitor | Visitor function to call on nodes. |
| userData | User data passed to visitor function. |
|
virtual |
Default implementation of Node2D content hit test.
Just returns the node itself.
| point | Point in node space. |
Reimplemented in kanzi::Viewport2D.
Wrapper for hitTest(Vector2), casts the return value.
| point | Point in world coordinates. |
|
inline |
Wrapper for hitTest(Vector2, const Metaclass), casts the return value.
| point | Point in world coordinates. |
| type | Metaclass type to limit hit testing to. |
|
overridevirtual |
Node::findAbstractChildOverride() implementation.
Implements kanzi::Node.
Reimplemented in kanzi::Viewport2D.
|
overridevirtual |
Node::visitAabstractChild implementation.
Implements kanzi::Node.
Reimplemented in kanzi::Viewport2D.
|
overridevirtual |
Node::addAbstractChildOverride() implementation.
Implements kanzi::Node.
|
overridevirtual |
Node::getAbstractChildCountOverride() implementation.
Implements kanzi::Node.
Reimplemented in kanzi::Viewport2D.
|
overridevirtual |
Implements kanzi::Node.
Reimplemented in kanzi::Viewport2D.
|
overridevirtual |
Node::getAbstractChildOverride() implementation.
Implements kanzi::Node.
Reimplemented in kanzi::Viewport2D.
|
overridevirtual |
Node::removeAbstractChildOverride() implementation.
Implements kanzi::Node.
|
overridevirtual |
Node::moveAbstractChildToPosition() implementation.
Implements kanzi::Node.
|
inline |
Tell if composition requires alpha.
|
inline |
Turn composition alpha requirement on or off.
| enabled | True to turn on, false to turn off. |
|
inline |
Tell if composition requires depth.
|
inline |
Turn composition depth requirement on or off.
| enabled | True to turn on, false to turn off. |
|
inline |
Tell if composition requires stencil.
|
inline |
Turn composition stencil requirement on or off.
| enabled | True to turn on, false to turn off. |
|
inline |
Gets the background quad description.
This function returns a copy of the background quad struct. Should be only used for tests.
|
inline |
Get clipping area.
This function returns a copy of the clipping struct. Should be only used for tests.
|
inline |
Get opacity after propagation from layouting hierarchy.
|
inline |
Gets the parent space transform of the 2D node.
|
inline |
Gets the transform used for composition children of the 2D node.
Kanzi uses the same transform for rendering the background and foreground of the node.
|
inline |
Gets transformation used to render the 2D node.
|
inline |
Tell if Node2D has the center clip area (the area of itself).
|
inline |
Tell if Node2D has outside clipping area.
This means any area outside clipping area.
|
inline |
Tell if Node2D foreground has translucency.
|
inline |
Set foreground translucency status.
This is calculated from layout time to combine factors deciding translucency.
| enabled | True to enable, false to disable. |
|
inline |
Turn composition request on or off.
This is a composition request from code, not by setting a property.
| enabled | True to turn on, false to turn off. |
|
inline |
Turns the potential composition flag for the viewport on or off.
| enabled | True to turn on, false to turn off. |
| bool kanzi::Node2D::isCompositionClearColorRequired | ( | ) | const |
Indicates whether composition target requires color clear before rendering.
Indicates whether to request composition clear if it is not possible to render the node content so that the content completely replaces the existing background of the node. For example, this can happen when using custom blend modes or when the node brushes do not cover the entire node.
|
inline |
Indicates whether this Node2D is allowed and should clear the color buffer of its own composition target.
By default, clearing is allowed but can be explicitly denied by user using properties.
This function does not access the property, but rather a flag determined during layout.
|
inline |
Set clear color allowed.
| enabled | True to turn on, false to turn off. |
|
inline |
Tell if rendering children is allowed.
|
inline |
Tell if render self is allowed.
|
inline |
Tell if Node2D is visible for hit testing.
This is different from node being merely visible, it must also be not rendered offscreen.
|
inline |
Tell if background brush rendering is required.
|
inline |
Tell if foreground brush rendering is required.
|
inline |
Indicates whether local transformation scope is required.
|
inline |
Sets the local transformation scope requirement.
| enabled | Set to true to enable, false to disable. |
|
inline |
Indicates whether node geometry requires an update for the tiling.
|
inline |
Sets the tiling update requirement.
| enabled | To enable the tiling update requirement, set to true. To disable the tiling update requirement, set to false. |
|
inline |
Tell if node itself is going to get rendered into a composition target.
|
inline |
Tell if node itself is going to get rendered into a composition target.
|
inline |
Get size desired by content.
|
inline |
Get second pass desired size.
|
inline |
Get size desired by user.
|
inline |
Get partial arrange transform.
|
inline |
Tell if node is completely clipped (and needs not be rendered).
|
inline |
Tell if node is completely transparent.
|
inline |
Tell if node is being perspective transformed.
|
protected |
Node2D -specific initialization.
|
protected |
Initializes and returns visual structure.
Allocates memory for rendering-related information. By default this information is unallocated.
|
protectedvirtual |
Node-specific top-level render call.
Allows for overriding the complete Node2D rendering process. Should normally not be overridden. Even if overridden, inherited implementations should usually call base implementation.
| renderer | Renderer. |
| compositionStack | Render context stack. |
| baseTransform | Optional additional transform in the composition space. |
|
protected |
|
protectedvirtual |
Node-specific rendering.
Default implementation renders background normally and passes to foreground render. Inherit to render more complex forms. The base transform is optional. If it is set, Kanzi multiplies it with the transform of the node.
| renderer | Renderer. |
| compositionStack | Render context stack. |
| baseTransform | Transform applied to node itself in parent space. |
Reimplemented in kanzi::Viewport2D, kanzi::ProgressiveRenderingViewport2D, and kanzi::Portal.
|
protected |
|
protected |
|
protected |
Render foreground of a Node2D.
Calls renderForegroundOverride().
| renderer | Renderer. |
| compositionStack | Render context stack. |
| transform | Transform used to render the foreground. |
|
protectedvirtual |
Node-specific foreground render.
Default implementation renders the center clip area from using the assigned foreground brush.
| renderer | Renderer. |
| compositionStack | Render context stack. |
| transform | Transform used to render the foreground. |
Reimplemented in kanzi::TextBox2D, and kanzi::TextBlock2D.
|
protected |
Push local viewport and scissor area into composition stack if it's required.
Nodes with render type RenderTypeManual rely on viewport and scissoring settings to clip their output. This needs an additional composition area pushed to the composition stack.
| compositionStack | Composition stack. |
| baseTransform | Optional transform in composition space. |
|
protected |
Initializes and returns composition structure.
Allocates memory for all composition-related information. By default this information is unallocated.
|
protected |
Apply composition for rendering the node itself.
Used in the standard render path. Either applies the perspective projection or uses the current composition stack as-is. Can be used in inheriting classes implementing renderSelfOverride() but not wanting to re-invent perspective transform.
| renderer | Renderer. |
| compositionStack | Render context stack. |
| baseTransform | Transform applied to node itself in parent space. |
|
protected |
Clear node composition target.
| renderer | Renderer to use. |
| compositionStack | Render context stack. |
| clearColor | Clear color buffer. |
Default implementation of Node2D size calculation.
Reimplemented in kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >, kanzi::Viewport2D, kanzi::TextBox2D, kanzi::GridLayout2D, kanzi::TrajectoryLayout2D, kanzi::Image2D, kanzi::FlowLayout2D, kanzi::ContentLayout2D, kanzi::TextBlock2D, kanzi::StackLayout2D, kanzi::PrefabView2D, kanzi::Portal, kanzi::DockLayout2D, kanzi::ToggleButton2D, and kanzi::Button2D.
|
protectedvirtual |
Perform arrange recursively.
Reimplemented in kanzi::Viewport2D.
|
protectedvirtual |
Default implementation of Node2D arrange.
Reimplemented in kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >, kanzi::Page, kanzi::GridListBox2D, kanzi::TextBox2D, kanzi::ProgressiveRenderingViewport2D, kanzi::GridLayout2D, kanzi::TrajectoryLayout2D, kanzi::FlowLayout2D, kanzi::ContentLayout2D, kanzi::TextBlock2D, kanzi::StackLayout2D, and kanzi::DockLayout2D.
|
protected |
Get aspect ratio property assigned to the node.
Aspect ratio of 0 or smaller equals no aspect ratio set.
|
protected |
Get layout height property assigned to the node.
Having an offscreen render target overrides the node's default size.
Sizes smaller than 0 are clamped to 0.
|
protected |
Get layout width property assigned to the node.
Having an offscreen render target overrides the node's default size.
Sizes smaller than 0 are clamped to 0.
|
inlineprotected |
Get desired size axis aligned bounding box minimum.
|
inlineprotected |
Set desired size axis aligned bounding box minimum.
| size | New size vector. |
|
inlineprotected |
Set desired size axis aligned bounding box minimum.
| sizeX | New desired minimum size X component. |
| sizeY | New desired minimum size Y component. |
|
inlineprotected |
Get desired size axis aligned bounding box maximum.
|
inlineprotected |
Set desired size axis aligned bounding box maximum.
| size | New size vector. |
|
inlineprotected |
Set desired size maximum.
| sizeX | New desired maximum size X component. |
| sizeY | New desired maximum size Y component. |
|
protected |
Calculate new transformed bounding area.
| transform | Matrix to use for calculation. |
| sizeIn | Input size. |
|
protected |
Update final transformation.
Updates the transformation status based on node properties and calculations in measure and arrange phases. Called from within updateRender() if necessary (if transform has changed). Kanzi stores all calculated transforms into node fields.
| worldTransform | Transformation in world space. |
| parentTransform | Parent's transformation in its composition space. |
|
protected |
Validate node for rendering.
This is the final part of layouting. (Re)Calculate transformation components, decide whether or not to render to an FBO, etc.
Transformations are only recalculated if parent transform or node transform has been changed.
| worldTransform | Transformation in world space. |
| parentTransform | Transformation in parent space. |
| transformChanged | Indicates whether transform (local or parent) has changed and needs updating. |
|
protectedvirtual |
Node-specific updates done before render.
Reimplemented in kanzi::Viewport2D, kanzi::TextBox2D, kanzi::ProgressiveRenderingViewport2D, kanzi::Image2D, and kanzi::TextBlock2D.
|
protected |
Calculate content stretch.
| renderSize | Rendering area size. |
| contentSize | Size of content rendered to rendering area. |
|
protected |
Calculate clipping parameters.
|
protected |
Perform rectangle clipping.
| backgroundQuad | Background quad, modified in-place. |
| foregroundQuad | Optional foreground quad, modified in-place. |
| effectQuad | Optional effect quad, modified in-place. |
| clippingResult | Current clipping result mask. |
|
protectedvirtual |
|
overrideprotectedvirtual |
Node::onDetached() implementation.
Reimplemented from kanzi::Node.
Reimplemented in kanzi::TextBoxConceptImpl< Node2D, TextBox2D, TextBox2DTraits >, kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >, kanzi::NinePatchImage2D, kanzi::ButtonConceptImpl< Node2D, Button2D >, kanzi::ButtonConceptImpl< Node2D, ToggleButton2D >, kanzi::Viewport2D, kanzi::Screen, kanzi::Page, kanzi::PageHost, kanzi::ProgressiveRenderingViewport2D, kanzi::ToggleButtonGroupConceptImpl< Node2D, ToggleButtonGroup2D >, kanzi::ActivityConceptImpl< ContentLayout2D, Activity2D >, kanzi::ClickConceptImpl< Node2D, Button2D >, kanzi::ClickConceptImpl< ContentLayout2D, ListBoxItemContainer2D >, kanzi::ClickConceptImpl< Node2D, ToggleButton2D >, kanzi::ParallelActivityHostImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::TextBlock2D, kanzi::DataDrivenExclusiveActivityHostImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ExclusiveActivityHostImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ExclusiveActivityHostBaseImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ExclusiveActivityHostBaseImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, ExclusiveActivityHost2D >, and kanzi::ActivityElementImpl< ContentLayout2D, Activity2D >.
|
overrideprotectedvirtual |
Node::onNodePropertyChanged implementation.
Reimplemented from kanzi::Node.
Reimplemented in kanzi::TextBoxConceptImpl< Node2D, TextBox2D, TextBox2DTraits >, kanzi::ScrollViewConceptImpl< Node2D, ScrollView2D >, kanzi::ListBoxConceptImpl< Node2D, GridListBox2D, GridListBox2DTraits >, kanzi::NinePatchImage2D, kanzi::ButtonConceptImpl< Node2D, Button2D >, kanzi::ButtonConceptImpl< Node2D, ToggleButton2D >, kanzi::TrajectoryLayoutConceptImpl< Node2D, TrajectoryLayout2D >, kanzi::Viewport2D, kanzi::GridLayoutConceptImpl< Node2D, GridLayout2D >, kanzi::Screen, kanzi::PageHost, kanzi::PrefabViewConceptImpl< Node2D, PrefabView2D >, kanzi::TextBox2D, kanzi::ToggleButtonGroupConceptImpl< Node2D, ToggleButtonGroup2D >, kanzi::TextBlockConceptImpl< Node2D, TextBlock2D >, kanzi::ClickConceptImpl< Node2D, Button2D >, kanzi::ClickConceptImpl< ContentLayout2D, ListBoxItemContainer2D >, kanzi::ClickConceptImpl< Node2D, ToggleButton2D >, kanzi::TextBlock2D, kanzi::ExclusiveActivityHostImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::ExclusiveActivityHostBaseImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ExclusiveActivityHostBaseImpl< ContentLayout2D, ExclusiveActivityHost2D >, kanzi::DataDrivenExclusiveActivityHostImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, DataDrivenExclusiveActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, ParallelActivityHost2D >, kanzi::ActivityElementImpl< ContentLayout2D, ExclusiveActivityHost2D >, and kanzi::ActivityElementImpl< ContentLayout2D, Activity2D >.
|
overrideprotectedvirtual |
Node::restoreResources() implementation.
Reimplemented from kanzi::Node.
Reimplemented in kanzi::Viewport2D, and kanzi::ProgressiveRenderingViewport2D.
|
inlineprotected |
Tell if the size of the node is empty or invalid.
Node must have positive size, greater than zero on both axes to be considered having a non-empty size.
Having empty size prevents rendering of node itself but not of its children.
|
inlineprotected |
Indicates whether foreground hint is opaque.
|
inlineprotected |
Indicates whether foreground hint is translucent.
|
inlineprotected |
Tell if foreground translucency has been requested.
|
inlineprotected |
Turn foreground translucency request on or off.
This is a way to request 'extra' translucency in updateRenderOverride() implementations inherited classes.
| enabled | True to turn on, false to turn off. |
|
inlineprotected |
Sets partial arrange transform.
If the transform has changed, invalidates final transformation.
| transform | New partial arrange transform. |
|
inlineprotected |
Turn render children on or off.
| enabled | True to turn on, false to turn off. |
|
inlineprotected |
Turn render self on or off.
| enabled | True to turn on, false to turn off. |
|
inlineprotected |
Set render type.
| renderType | Render type. |
|
inlineprotected |
Update content texture for the foreground brush.
|
inlineprotected |
Set second pass desired size.
| size | New size vector. |
|
inlineprotected |
Calculate perspective transform matrices.
This is a testing support function and should not be used by user code.
|
inlineprotected |
Sets the value of EffectProperty.
|
friend |
|
friend |
|
friend |
|
static |
|
static |
ForceComposition property.
The default value is false.
|
static |
ForegroundHint property.
The default value is Node2D::ForegroundHintNone.
|
static |
OffscreenRendering property.
The default value is false.
|
static |
DisableRenderTargetClear property.
The default value is false.
|
static |
PixelFormat property.
The default value is Node2D::PixelFormatRgb.
|
static |
|
static |
RenderTarget property.
The default value is ResourceSharedPtr().
|
static |
RenderTargetMinimumHeight property.
The default value is 1.0f.
|
static |
RenderTargetMinimumWidth property.
The default value is 1.0f.
|
static |
RenderTargetReallocationLimit property.
The default value is 0.25f.
|
static |
Sets the caching mode:
|
static |
Kanzi sets the value of this property to indicate whether the node is cached.
To disable the cache for one frame, set this property to false. The default value is false.
|
static |
|
static |
|
static |
PerspectiveTransformation property.
The default value is identity.
|
static |
PerspectiveTransformationMode property.
The default value is Screen.
|
static |
PerspectiveTransformationFov property.
The default value is 45.
|
static |
PerspectiveTransformationOrigin property.
The default value is 0.0,0.0,0.0.
|
static |
PerspectiveTransformationOrigin property.
The default value is 0.0,0.0,0.0.
|
static |
RenderTransformationOrigin property.
The default value is Vector2(0.0f, 0.0f).
|
static |
|
static |
BackgroundBrush property.
The default value is ResourceSharedPtr().
|
static |
CompositionBrush property.
The default value is ResourceSharedPtr().
|
static |
ForegroundBrush property.
The default value is ResourceSharedPtr().
|
static |
Reports the runtime effect instance used by the node, instantiated from the NodeEffectPrefab2D.
Kanzi sets this property internally whenever the value of the EffectPrefabProperty changes. The default value is ResourceSharedPtr()
|
static |
Sets the 2D Effect prefab to use for the node.
The default value is ResourceSharedPtr()
|
protected |
Visual information.
|
protected |
Composition and caching information.
|
protected |
Background clipping quad / composition quad description.
|
protected |
Effect quad description.
|
protected |
Cached effect instance.
|
protected |
Effect padding change counter value at which effect quad was last validated.
|
protected |
Clipping parameters.
|
protected |
Composition requirements for this 2D node.
|
protected |
Currently instantiated effect prefab.
