kanzi::ScrollView3D Class Reference

Use the Scroll View 3D node to create an input plane to enable user input from gestures. More...

#include <kanzi/ui/node/scroll_view3d.hpp>

Inheritance diagram for kanzi::ScrollView3D:
kanzi::ScrollViewConceptImpl< Node3D, ScrollView3D > kanzi::Node3D kanzi::ScrollViewConcept kanzi::Node kanzi::Object kanzi::MetaObject kanzi::PropertyObject

Public Member Functions

optional< Vector2calculatePanPosition (const KzcRay &ray) const
 Calculates pan position for given ray. More...
 
optional< Vector2calculatePanPosition (const InputManipulator::InputMessageArguments &arguments) const
 Calculates pan position for message arguments. More...
 
- Public Member Functions inherited from kanzi::ScrollViewConceptImpl< Node3D, ScrollView3D >
 ~ScrollViewConceptImpl ()
 Destructor. More...
 
PanManipulatorSharedPtr getPanManipulator () const
 Returns the pan manipulator. More...
 
Vector2 getScrollAxis () const
 Gets the value of ScrollAxisProperty. More...
 
void setScrollAxis (Vector2 value)
 Sets the value of ScrollAxisProperty. More...
 
float getRecognitionThreshold () const
 Gets the value of RecognitionThresholdProperty. More...
 
void setRecognitionThreshold (float value)
 Sets the value of RecognitionThresholdProperty. More...
 
int getMinimumNumberOfTouches () const
 Gets the value of MinimumNumberOfTouchesProperty. More...
 
void setMinimumNumberOfTouches (int value)
 Sets the value of MinimumNumberOfTouchesProperty. More...
 
int getMaximumNumberOfTouches () const
 Gets the value of MinimumNumberOfTouchesProperty. More...
 
void setMaximumNumberOfTouches (int value)
 Sets the value of MinimumNumberOfTouchesProperty. More...
 
float getSensitivity () const
 Gets the value of SensitivityProperty. More...
 
void setSensitivity (float value)
 Sets the value of SensitivityProperty. More...
 
float getSlidingAccelerationCoefficient () const
 Gets the value of SlidingAccelerationCoefficientProperty. More...
 
void setSlidingAccelerationCoefficient (float value)
 Sets the value of SlidingAccelerationCoefficientProperty. More...
 
float getSlidingDragCoefficient () const
 Gets the value of SlidingDragCoefficientProperty. More...
 
void setSlidingDragCoefficient (float value)
 Sets the value of SlidingDragCoefficientProperty. More...
 
float getDraggingAccelerationCoefficient () const
 Gets the value of DraggingAccelerationCoefficientProperty. More...
 
void setDraggingAccelerationCoefficient (float value)
 Sets the value of DraggingAccelerationCoefficientProperty. More...
 
float getDraggingDragCoefficient () const
 Gets the value of DraggingDragCoefficientProperty. More...
 
void setDraggingDragCoefficient (float value)
 Sets the value of DraggingDragCoefficientProperty. More...
 
float getDraggingImpulseFactor () const
 Gets the value of DraggingImpulseFactorProperty. More...
 
void setDraggingImpulseFactor (float value)
 Sets the value of DraggingImpulseFactorProperty. More...
 
float getSwipeDistance () const
 Gets the value of SwipeDistanceProperty. More...
 
void setSwipeDistance (float value)
 Sets the value of SwipeDistanceProperty. More...
 
Vector2 getScrollPosition () const
 Gets the value of ScrollPositionProperty. More...
 
void setScrollPosition (Vector2 value)
 Sets the value of ScrollPositionProperty. More...
 
Vector2 getScrollTargetPosition () const
 Gets the value of ScrollTargetPositionProperty. More...
 
void setScrollTargetPosition (Vector2 value)
 Sets the value of ScrollTargetPositionProperty. More...
 
Vector2 getScrollSpeed () const
 Gets the value of ScrollSpeedProperty. More...
 
void setScrollSpeed (Vector2 value)
 Sets the value of ScrollSpeedProperty. More...
 
bool isScrolling () const
 Gets the value of ScrollingProperty. More...
 
void setScrolling (bool value)
 Sets the value of ScrollingProperty. More...
 
bool isDragging () const
 Checks whether the finger is on the surface. More...
 
bool isZoomAffectsScrolling () const
 Gets the value of ZoomAffectsScrollingProperty. More...
 
void setZoomAffectsScrolling (bool value)
 Sets the value of ZoomAffectsScrollingProperty. More...
 
Vector2 getScrollBoundsMinimum () const
 Gets the value of ScrollBoundsMinimumProperty. More...
 
void setScrollBoundsMinimum (Vector2 value)
 Sets the value of ScrollBoundsMinimumProperty. More...
 
Vector2 getScrollBoundsMaximum () const
 Gets the value of ScrollBoundsMaximumProperty. More...
 
void setScrollBoundsMaximum (Vector2 value)
 Sets the value of ScrollBoundsMaximumProperty. More...
 
void setEnabledX (bool state)
 Sets whether the scroll view scrolls along the x axis. More...
 
void setEnabledY (bool state)
 Sets whether the scroll view scrolls along the y axis. More...
 
bool isEnabledX () const
 Returns whether the scroll view scrolls along the x axis. More...
 
bool isEnabledY () const
 Returns whether the scroll view scrolls along the y axis. More...
 
void setLoopingXEnabled (bool value)
 Sets the value of LoopingXEnabledProperty. More...
 
void setLoopingYEnabled (bool value)
 Sets the value of LoopingYEnabledProperty. More...
 
bool isLoopingXEnabled () const
 Gets the value of LoopingXEnabledProperty. More...
 
bool isLoopingYEnabled () const
 Gets the value of LoopingYEnabledProperty. More...
 
void setScrollBoundsX (float minimum, float maximum)
 Sets the bounds on the x axis. More...
 
void setScrollBoundsY (float minimum, float maximum)
 Sets the bounds on the y axis. More...
 
void scrollToPosition (Vector2 scrollPosition)
 Sets a value for the new position of the scroll view and starts scrolling to that value. More...
 
void scrollToPositionLooping (Vector2 scrollPosition)
 If a scroll view's axis looping is enabled, the shortest path to the target value is chosen. More...
 
void jumpToPosition (Vector2 scrollPosition)
 Sets a value for the position of the scroll view and immediately goes to that value. More...
 
Vector2 getScroll () const
 Gets the values of the current position of the scroll view. More...
 
Vector2 getScrollTarget () const
 Gets the values of the position of the scroll view to which the scroll view is scrolling. More...
 
Vector2 getScrollTargetLooping () const
 When looping is enabled it gets the position value normalized to the allowed range of the scroll view. More...
 
Vector2 getSpeed () const
 Queries the current speed from the interpolator. More...
 
void scroll (ScrollDirection direction)
 Sets scroll delta to one step and starts scrolling to that direction. More...
 
void scroll (ScrollPage direction)
 Sets scroll delta to one page and starts scrolling to that direction. More...
 
void scroll (ScrollEdge direction)
 Sets scroll target to edge defined by scroll bounds and starts scrolling to that direction. More...
 
bool isZoomEnabled () const
 Gets the value of ZoomEnabledProperty. More...
 
void setZoomEnabled (bool value)
 Sets the value of ZoomEnabledProperty. More...
 
float getZoom () const
 Gets the value of ZoomProperty. More...
 
float getZoomMinimum () const
 Gets the value of ZoomMinimumProperty. More...
 
void setZoomMinimum (float value)
 Sets the value of ZoomMinimumProperty. More...
 
float getZoomMaximum () const
 Gets the value of ZoomMaximumProperty. More...
 
void setZoomMaximum (float value)
 Sets the value of ZoomMaximumProperty. More...
 
float getStepMultiplier () const
 Gets the value of StepMultiplierProperty. More...
 
void setStepMultiplier (float value)
 Sets the value of StepMultiplierProperty. More...
 
void refreshThreshold ()
 Updates the recognition threshold of the pan manipulator to the value of the RecognitionThresholdProperty value. More...
 
bool useDirectionalRecognitionThreshold () const
 Tells whether pan threshold should be locked to scroll direction or not. More...
 
- Public Member Functions inherited from kanzi::Node3D
Matrix4x4 getFinalTransformation () const
 Gets the value of FinalTransformationProperty. More...
 
void setFinalTransformation (Matrix4x4 value)
 Sets the value of FinalTransformationProperty. More...
 
float getFrustumCullMargin () const
 Gets the value of FrustumCullMarginProperty. More...
 
void setFrustumCullMargin (float value)
 Sets the value of FrustumCullMarginProperty. More...
 
SRTValue3D getRenderTransformation () const
 Gets the value of RenderTransformationProperty. More...
 
void setRenderTransformation (SRTValue3D value)
 Sets the value of RenderTransformationProperty. More...
 
SRTValue3D getLayoutTransformation () const
 Gets the value of LayoutTransformationProperty. More...
 
void setLayoutTransformation (SRTValue3D value)
 Sets the value of LayoutTransformationProperty. More...
 
virtual ~Node3D ()
 
size_t getChildCount () const
 Gets child count from object. More...
 
Node3DSharedPtr getChild (size_t index) const
 Returns a child from given index from object node. More...
 
size_t getChildIndex (const Node &child) const
 Returns the index of a child in an object node. More...
 
bool hasChild (const Node &child) const
 Returns whether or not the child exists. More...
 
void addChild (const Node3DSharedPtr &child)
 Adds a child node for object node. More...
 
void insertChild (size_t index, const Node3DSharedPtr &child)
 Adds a child node for object node to given index. More...
 
void removeChild (const Node &child)
 Removes child node from parent object. More...
 
void removeChild (size_t index)
 Removes child node from parent object node at specified index. More...
 
void removeAllChildren ()
 Removes all child nodes from parent object. More...
 
ChildConstIterator beginChildren () const
 
ChildConstIterator endChildren () const
 
ChildConstReverseIterator rbeginChildren () const
 
ChildConstReverseIterator rendChildren () const
 
virtual bool addAbstractChildOverride (NodeSharedPtr child) KZ_OVERRIDE
 
virtual size_t getAbstractChildCountOverride () KZ_OVERRIDE
 
virtual NodeSharedPtr getAbstractChildOverride (size_t index) KZ_OVERRIDE
 
virtual bool removeAbstractChildOverride (Node &child) KZ_OVERRIDE
 
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...
 
void setAutoWidth ()
 Sets node to automatically determine width. More...
 
void setAutoHeight ()
 Sets node to automatically determine height. More...
 
void setAutoDepth ()
 Sets node to automatically determine depth. More...
 
void setAutoSize ()
 Sets node to automatically determine width, height and depth. More...
 
void setSize (float width, float height, float depth)
 Sets size properties of the node. More...
 
void setCoreDesiredSize (const Vector3 &coreDesiredSize)
 Set core desired size for an object. More...
 
Vector3 getCoreDesiredSize () const
 Get core desired size of an object. More...
 
void setDesiredSize (const Vector3 &desiredSize)
 Set desired size for an object. More...
 
Vector3 getDesiredSize () const
 Get desired size for of object. More...
 
void setAllocatedSize (const Vector3 &layoutSize)
 Set allocated size for an object. More...
 
Vector3 getAllocatedSize () const
 Get allocated size of an object. More...
 
void setActualSize (const Vector3 &actualSize)
 Set actual size for an object. More...
 
Vector3 getActualSize () const
 Get actual size of an object. More...
 
void setLayoutBoundingBoxSize (const Vector3 &bboxMin, const Vector3 &bboxMax)
 Set bounding box size for an object. More...
 
void getLayoutBoundingBoxSize (Vector3 &bboxMin, Vector3 &bboxMax) const
 Get bounding box size for an object. More...
 
void setAllocatedOffset (const Vector3 &allocatedOffset)
 Set allocated offset for an object. More...
 
Vector3 getAllocatedOffset () const
 Get allocated offset of an object. More...
 
void setStretchScale (const Vector3 &stretchScale)
 Set stretch scale for an object. More...
 
Vector3 getStretchScale () const
 Get stretch scale of an object. More...
 
void setPivotOffset (const Vector3 &pivotOffset)
 Set pivot offset for an object. More...
 
Vector3 getPivotOffset () const
 Get pivot offset of an object. More...
 
kzsError getSize (Vector3 &out_size) const
 Returns the size of object node. More...
 
kzsError getMaximumBoundingBoxCoordinates (Vector3 &out_size) const
 Returns the minimum coordinates for object nodes bounding volume. More...
 
kzsError getMinimumBoundingBoxCoordinates (Vector3 &out_size) const
 Returns the maximum coordinates for object nodes bounding volume. More...
 
void setArrangeTransformation (const Matrix4x4 &value)
 Sets the layout transformation of the object. More...
 
Matrix4x4 getArrangeTransformation () const
 Gets the layout transformation of the object. More...
 
void layout ()
 Recursively calculate the layouts in the scene. More...
 
void measureIterate ()
 Initial scene measure. More...
 
virtual bool measureRecursive ()
 Perform layout measurement on a node. More...
 
void arrangeIterate ()
 Initial scene arrange. More...
 
void arrangeIterateLayout (bool propagateArrange)
 
void arrangeIterateLayoutChild (bool propagateArrange)
 
void measure (const Vector3 &availableSize)
 Perform the default measure step. More...
 
void arrange ()
 Perform layout arrangement on a node. More...
 
Vector3 centeredMeasure (Vector3 availableSize) const
 Default implementation of measure for a layout that accommodates all children at its center. More...
 
void centeredArrange (Vector3 actualSize) const
 Default implementation of arrange for a layout that accommodates all children at its center. More...
 
bool isPrimitiveLayout () const
 
virtual void render (Renderer3D &renderer, const KzuTransformedObjectNode &transformedObjectNode, const Matrix4x4 &worldTransformation)
 Node-specific render function. More...
 
Node3DSharedPtr getLookAtTarget () const
 
Node3DSharedPtr getPositionConstraintTarget () const
 
Node3DSharedPtr getOrientationConstraintTarget () const
 
Node3DSharedPtr getFaceToCameraTarget () const
 
- Public Member Functions inherited from kanzi::Node
virtual ~Node ()
 Destructor. More...
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getProperty (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property. More...
 
AbstractPropertyTypeDescriptor::ValueSourcegetNodeFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) 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 >
DataType getAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename DataType >
optional< typename PropertyType< DataType >::DataType > getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename TMessageType , typename TClass , typename TClassMethod >
MessageSubscriptionToken addMessageHandler (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method)
 Adds a message handler where handler is a method to invoke on an object. More...
 
template<typename TMessageType , typename TClass , typename TClassMethod >
MessageSubscriptionToken addMessageFilter (TMessageType &messageType, TClass *messageHandlerObject, TClassMethod method)
 Adds a message filter where filter is a method to invoke on an object. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function)
 Adds a message handler where handler is function. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageFilter (const TMessageType &messageType, typename TMessageType::FunctionType function)
 Adds a message filter where filter is function. More...
 
template<typename TMessageType >
MessageSubscriptionToken addMessageHandler (const TMessageType &messageType, typename TMessageType::FunctionType function, Node *messageSourceFilter)
 Adds a message handler where handler is function and accepted source is explicitly defined. More...
 
void removeMessageHandler (MessageSubscriptionToken token)
 Removes a message subscription. More...
 
template<typename TArgumentsType >
void dispatchMessage (const MessageType< TArgumentsType > &messageType, typename MessageType< TArgumentsType >::ArgumentsType &messageArguments)
 Dispatches a message with specified arguments. More...
 
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 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...
 
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...
 
optional< string > findResourceURL (const ResourceID &resourceId) const
 Tries to find Resource URL for Resource ID from this node. More...
 
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...
 
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...
 
ResourceManager::AcquireTaskSharedPtr acquireResourceAsync (const ResourceID &key, ResourceManager::AsyncAcquireFinishedCallback func) const
 Posts an asynchronous task to acquire a resource. 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...
 
ResourceDictionarySharedPtr getResourceDictionary () const
 Gets the resource dictionary of the node, if the node has one. More...
 
ResourceDictionarySharedPtr acquireResourceDictionary ()
 Gets the resource dictionary of the node. More...
 
void setResourceDictionary (ResourceDictionarySharedPtr resourceDictionary)
 Replaces the resource dictionary of the node. More...
 
void addResourceDictionary (ResourceDictionarySharedPtr resourceDictionary)
 Add a nested resource dictionary to the resource dictionary of the node. More...
 
void addAnonymousResource (ResourceSharedPtr resource)
 Adds alias resource to an object node. More...
 
void removeAnonymousResource (const Resource &resource)
 Removes anonymous resource from object node resources. More...
 
bool isNamed (string_view name) const
 
NodegetParent () const
 Returns the parent of the node. More...
 
void setParent (Node *parent)
 
VisitorResult visit (const Visitor &visitor, VisitorOrder order)
 
VisitorResult visitDescendants (const Visitor &visitor, VisitorOrder order)
 
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...
 
NodelookupNodeRaw (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...
 
tuple< NodeSharedPtr, AbstractPropertyTypelookupObjectForStateManager (string_view relativePath)
 Lookup for an node and possible object from within the node for state manager. More...
 
template<typename Type >
shared_ptr< Type > lookupObject (string_view path)
 Lookup for an object from a node. More...
 
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...
 
void addInputManipulator (InputManipulatorSharedPtr inputManipulator)
 Transfers the ownership and attaches an input manipulator to an object node. More...
 
void removeInputManipulator (InputManipulator &inputManipulator)
 Removes the ownership and detaches an input manipulator from an object node. More...
 
InputManipulatorConstIterator beginInputManipulators () const
 
InputManipulatorConstIterator endInputManipulators () const
 
void addBinding (BindingSharedPtr binding)
 Transfers the ownership of a binding rule to an object node. More...
 
void addBindingWithOwner (BindingSharedPtr binding, const void *owner)
 Transfers the ownership of a binding rule to an object node and sets the owner of binding rule. More...
 
void removeBinding (Binding &binding)
 Removes the ownership and detaches a binding rule from an object node. More...
 
void removeBindingsWithOwner (const void *owner)
 Removes all bindings with the specified owner. More...
 
BindingConstIterator beginBindings () const
 
BindingConstIterator endBindings () const
 
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 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...
 
NodeComponentConstIterator beginNodeComponents () const
 
NodeComponentConstIterator endNodeComponents () const
 
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...
 
void setRenderable (bool state)
 Sets whether the object node is renderable. More...
 
bool isRenderable () const
 Returns whether node is renderable. More...
 
bool isEffectivelyVisible () const
 Checks if the node and all of its ancestors are visible. More...
 
bool isEffectivelyEnabled () const
 Checks if the node and all of its ancestors are enabled. More...
 
uint32_t getChangeFlags () const
 Get current change flags. More...
 
uint32_t getChildChangeFlags () const
 Get current child change flags. More...
 
void setChangeFlag (uint32_t flag)
 Sets a change flag. More...
 
void clearChangeFlag (uint32_t flag)
 Clears a change flag. More...
 
bool isChangeFlagSet (uint32_t flag) const
 Checks if a change flag is set. More...
 
bool isAnyChangeFlagSet (uint32_t flag) const
 Checks if any of given flags is set. More...
 
void setChildChangeFlag (uint32_t flag)
 Sets a child change flag. More...
 
void clearChildChangeFlag (uint32_t flag)
 Clears a child change flag. More...
 
bool isChildChangeFlagSet (uint32_t flag) const
 Checks if child change flags match. More...
 
bool isAnyChildChangeFlagSet (uint32_t flag) const
 Checks if any child change flags (corresponding to given mask) are set. More...
 
bool isInvalidMeasure () const
 Check if the node needs measure. More...
 
void invalidateMeasure ()
 Invalidates measure for the node. More...
 
void validateMeasure ()
 Validates measure for the node. More...
 
bool isInvalidArrange () const
 Checks if the node needs arrange. More...
 
void invalidateArrange ()
 Invalidates arrange. More...
 
void validateArrange ()
 Validates arrange. More...
 
bool isInvalidRender () const
 Returns if node render flag is invalid. More...
 
void validateRender ()
 Validates render for object node. More...
 
void invalidateRender ()
 Invalidates render for object node. More...
 
bool isInvalidDraw ()
 Tells if node draw flag is invalid. More...
 
void invalidateDraw ()
 Invalidates draw flag for the node. More...
 
void validateDraw ()
 Validates draw flags for the node. More...
 
void validateDrawForChildrenRecursive ()
 Recursively validates draw for the children from this 2D node onwards. More...
 
bool isInitialized () const
 Returns true if initialize() has been called, false otherwise. 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 isDetaching () const
 Returns true if the node currently detaching. More...
 
void attachRecursive ()
 Attaches an object node and its children recursively. More...
 
void detachRecursive ()
 Detaches an object node and its children recursively. More...
 
virtual const KzuBoundingVolumegetBoundingVolume () const
 Gets bounding volume from object node. More...
 
AppliedStyleEntryapplyStyle (StyleSharedPtr style)
 Applies a style to an object node. More...
 
AppliedStyleEntryapplyManualStyle (StyleSharedPtr style)
 Applies a style to an object node. More...
 
void unapplyStyle (AppliedStyleEntry *appliedStyleEntry)
 Unapplies a style from an object node. More...
 
void applyStyles ()
 Apply all styles for an object node. More...
 
void unapplyStyles ()
 Unapplies and removes all applied styles. More...
 
void applyStylesRecursive ()
 Applies styles recursively. More...
 
void unapplyStylesRecursive ()
 Unapplies styles recursively. More...
 
void removeKZBData ()
 Destroys all object node data loaded from KZB, including properties, bindings, node comopnents, resources etc. More...
 
void addResourceReference (AbstractPropertyType propertyType, AbstractResourceReference *reference)
 This is a helper for automatic resource tracking in ResourceReference. More...
 
void removeResourceReference (const AbstractResourceReference &reference)
 This is a helper for automatic resource tracking in ResourceReference. More...
 
void addNodeReference (AbstractPropertyType propertyType, AbstractNodeReference *reference)
 
void removeNodeReference (const AbstractNodeReference &reference)
 
virtual void restoreResources ()
 Reattaches an object node after potential resource change. More...
 
ScriptingContextSharedPtr getScriptingContext () const
 
void setScriptingContext (ScriptingContextSharedPtr context)
 
void setTemplateRoot (NodeSharedPtr templateRoot)
 Sets the template root of this node. More...
 
NodeSharedPtr getTemplateRoot () const
 Gets the template root of this node. 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...
 
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...
 
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
 Gets the value of EnabledProperty. More...
 
void setEnabled (bool value)
 Sets the value of EnabledProperty. More...
 
bool isFocusable () const
 Gets the value of FocusableProperty. More...
 
void setFocusable (bool value)
 Sets the value of FocusableProperty. More...
 
bool isFocused () const
 Gets the value of FocusedProperty. More...
 
void setFocused (bool value)
 Sets the value of FocusedProperty. More...
 
ResourceSharedPtr getFont () const
 Gets the value of FontProperty. More...
 
void setFont (ResourceSharedPtr value)
 Sets the value of FontProperty. More...
 
float getVisibleAmountInParent () const
 Gets the value of VisibleAmountInParentProperty. More...
 
void setVisibleAmountInParent (float value)
 Sets the value of VisibleAmountInParentProperty. More...
 
bool isClipChildren () const
 Gets the value of ClipChildrenProperty. More...
 
void setClipChildren (bool value)
 Sets the value of ClipChildrenProperty. More...
 
float getProjection2DTo3DScale () const
 Gets the value of Projection2DTo3DScaleProperty. More...
 
void setProjection2DTo3DScale (float value)
 Sets the value of Projection2DTo3DScaleProperty. More...
 
bool isEnableClick () const
 Gets the value of EnableClickProperty. More...
 
void setEnableClick (bool value)
 Sets the value of EnableClickProperty. More...
 
bool isEnableMultiClick () const
 Gets the value of EnableMultiClickProperty. More...
 
void setEnableMultiClick (bool value)
 Sets the value of EnableMultiClickProperty. 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...
 
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...
 
- Public Member Functions inherited from kanzi::Object
 Object (Domain *domain)
 
virtual ~Object ()
 
DomaingetDomain () const
 Returns the domain the object belongs to. More...
 
KzuTaskSchedulergetTaskScheduler () const
 Returns the task scheduler of the object. More...
 
KzuMessageDispatchergetMessageDispatcher () const
 Returns the message dispatcher of the object. More...
 
ResourceManagergetResourceManager () const
 Returns the resource manager of the object. More...
 
virtual const MetaclassgetDynamicMetaclass () const KZ_OVERRIDE
 Returns the metaclass of the dynamic type of the object. More...
 
AppliedStyleEntryapplyObjectStyle (kanzi::StyleSharedPtr style)
 Applies a style to an object. More...
 
void unapplyObjectStyle (AppliedStyleEntry *appliedStyleEntry)
 
void applyObjectStyles ()
 Apply all styles for an object node. More...
 
void unapplyObjectStyles ()
 Unapplies and removes all applied styles. More...
 
- Public Member Functions inherited from kanzi::MetaObject
virtual ~MetaObject ()
 
bool isTypeOf (const Metaclass *objectType) const
 Determines if the type of this object is the given type or derived from it. More...
 
- Public Member Functions inherited from kanzi::PropertyObject
 PropertyObject ()
 
virtual ~PropertyObject ()
 
template<typename DataType >
void setProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Traits::ParameterType value)
 Sets the local value of a property. More...
 
void removeKzbProperties ()
 
template<typename DataType >
PropertyType< DataType >::Traits::ReturnType getProperty (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property. More...
 
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 >
PropertyType< DataType >::Traits::ReturnType getPropertyBase (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property disregarding modifiers. More...
 
template<typename DataType >
void setAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::Traits::ParameterType value)
 
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
 
void setPropertyFlag (AbstractPropertyType propertyType, uint32_t flag)
 
bool isPropertyFlagSet (AbstractPropertyType propertyType, uint32_t flag) const
 
void clearPropertyFlag (AbstractPropertyType propertyType, uint32_t flag)
 
bool hasValue (AbstractPropertyType propertyType) const
 Evaluates whether there are any inputs into the property value. 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...
 
void removeLocalValue (AbstractPropertyType propertyType)
 Removes the local value associated with the property. More...
 
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...
 
template<typename DataType >
void addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, void *owner)
 
template<typename DataType >
void removePropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *owner)
 
template<typename DataType >
void addPropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner)
 
template<typename DataType >
void removePropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner)
 
void validatePropertyModifiers (AbstractPropertyType propertyType)
 
template<typename DataType >
void addPropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner)
 
template<typename DataType >
void removePropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner)
 
template<typename DataType >
size_t getPropertyNotificationHandlerCount (const PropertyType< DataType > &propertyType)
 Gets number of current notification handlers for given property type. More...
 

Static Public Member Functions

static ScrollView3DSharedPtr create (Domain *domain, string_view name)
 Creates a scroll view with the default settings. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::ScrollViewConceptImpl< Node3D, ScrollView3D >
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::Node3D
static float layoutUp ()
 
static bool isValidLayoutSize (Vector3 size)
 Indicates whether a size is valid layout size. More...
 
static Vector3 unboundedLayoutSize ()
 Returns an unbounded layout size. More...
 
static bool isUnboundedLayoutSize (Vector3 layoutSize)
 Indicates whether a layout size is an unbound layout size. More...
 
static Vector3 replaceUnboundedLayoutSize (Vector3 layoutSize, Vector3 resetSize)
 Replaces any element of a layout size with appropriate element of the reset size if it is unbounded and returns the size. More...
 
static Vector3 replaceUnboundedLayoutSizeWithZero (Vector3 layoutSize)
 Replaces any element of a layout size with zero if it is unbounded and returns the size. More...
 
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 
- Static Public Member Functions inherited from kanzi::Node
static bool isValidLayoutValue (float value)
 Indicates whether a value is valid layout value. More...
 
static float unboundedLayoutValue ()
 Returns an unbounded layout value. More...
 
static bool isUnboundedLayoutValue (float layoutValue)
 Indicates whether a value is an unbound 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 Public Member Functions inherited from kanzi::Object
static const MetaclassgetStaticMetaclass ()
 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 MetaclassgetStaticMetaclass ()
 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::ScrollViewConcept
static PropertyTypeEditorInfoSharedPtr makeEditorInfo ()
 

Protected Member Functions

 ScrollView3D (Domain *domain, string_view name)
 Constructor. More...
 
- Protected Member Functions inherited from kanzi::ScrollViewConceptImpl< Node3D, ScrollView3D >
 ScrollViewConceptImpl (Domain *domain, string_view name)
 
ScrollView3DgetThisObject ()
 Internal accessor for the Curiously Recurring Template Pattern. More...
 
const ScrollView3DgetThisObject () const
 Internal accessor for the Curiously Recurring Template Pattern. More...
 
void initialize ()
 Assigns the message handlers for the pan manipulator and scroll messages. More...
 
virtual void onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) KZ_OVERRIDE
 Node::onNodePropertyChanged() implementation. More...
 
void refreshScrollConfiguration ()
 Updates smooth interpolation coefficients, depending whether the finger is still on the scroll view or not. More...
 
void refreshMinimumNumberOfTouches ()
 Updates the minimum number of touch points of the pan manipulator to the value of the #MinimumNumberOfTouchPointsProperty value. More...
 
void refreshMaximumNumberOfTouches ()
 Updates the maximum number of touch points of the pan manipulator to the value of the #MaximumNumberOfTouchPointsProperty value. More...
 
- Protected Member Functions inherited from kanzi::Node3D
 Node3D (Domain *domain, string_view name)
 
void initialize ()
 
virtual NodeSharedPtr findAbstractChildOverride (string_view name) KZ_OVERRIDE
 
virtual VisitorResult visitAbstractChildOverride (const Visitor &visitor, VisitorOrder order) KZ_OVERRIDE
 
virtual Vector3 measureOverride (Vector3 availableSize)
 
virtual void arrangeOverride (Vector3 actualSize)
 
void setPrimitiveLayout (bool primitive)
 
- Protected Member Functions inherited from kanzi::Node
 Node (Domain *domain, string_view name)
 Constructor. More...
 
void initialize ()
 
virtual void onAttached ()
 Called when an object node becomes attached. More...
 
virtual void onDetached ()
 Called when an object node becomes detached. More...
 
void updatePropertiesForConnectedNode ()
 Invokes property notifications for inherited properties during scene graph tree connections. More...
 
void updatePropertiesForDisconnectedNode (Node *oldParent)
 Invokes property notifications for inherited properties during scene graph tree disconnections. More...
 
void updateResourceReferences ()
 
void updateResourceReferences (AbstractPropertyType propertyType)
 
void updateResourceReferencesRecursive ()
 
void updateResourceReferencesRecursive (const ResourceID &resourceID)
 
void attach ()
 Attaches the object node. More...
 
void detach ()
 Detaches the object node. More...
 
virtual void notifyPropertyHandlers (PropertyStoragePtr &propertyStorage, PropertyNotificationReason reason) KZ_OVERRIDE
 
- Protected Member Functions inherited from kanzi::Object
void initialize ()
 
void onCopy (const Object &other)
 
- Protected Member Functions inherited from kanzi::MetaObject
 MetaObject ()
 
void initialize ()
 
- Protected Member Functions inherited from kanzi::PropertyObject
void addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, void *owner)
 
void removePropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, void *owner)
 
AbstractPropertyTypeDescriptor::ValueSourceEntrygetTopValueSourceEntry (AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) const
 
AbstractPropertyTypeDescriptor::ValueSourceEntrygetTopValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetTopValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetNonClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourcegetClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const
 
AbstractPropertyTypeDescriptor::ValueSourceEntryfindLocalValueSourceEntry (AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 
AbstractPropertyTypeDescriptor::ValueSourceEntryconstructLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 
AbstractPropertyTypeDescriptor::ValueSourceEntryacquireLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::PropertyStoragefindPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) const
 
PropertyStoragePtr findPropertyStoragePtr (AbstractPropertyTypeDescriptor &descriptor) const
 Gets property storage intrusive pointer that can be used to hold a reference until end of operation. More...
 
PropertyStoragePtr constructPropertyStorage (AbstractPropertyTypeDescriptor &descriptor)
 
PropertyStoragePtr acquirePropertyStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::ModifierStorageacquireModifierStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::ModifierStoragefindModifierStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::NotificationStorageacquireNotificationStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptor::NotificationStoragefindNotificationStorage (AbstractPropertyTypeDescriptor &descriptor)
 
AbstractPropertyTypeDescriptorfindPropertyTypeDescriptorByUnqualifiedNameAndDataType (string_view unqualifiedName, PropertyDataType dataType)
 
void validatePropertyModifiersAndNotifyHandlers (PropertyStoragePtr &propertyStorage)
 
void copyLocalValue (const AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage)
 Copy local value from property storage. More...
 
PropertyStorageContainer::iterator beginPropertyStorage ()
 
PropertyStorageContainer::iterator endPropertyStorage ()
 
void onCopy (const PropertyObject &other)
 

Additional Inherited Members

- Public Types inherited from kanzi::ScrollViewConceptImpl< Node3D, ScrollView3D >
typedef ScrollViewConceptImpl< Node3D, ScrollView3DTScrollView
 
- Public Types inherited from kanzi::Node3D
typedef Vector3 LayoutVectorType
 
typedef Matrix4x4 LayoutMatrixType
 
typedef vector< Node3DSharedPtrChildContainer
 Iterators for children. More...
 
typedef ChildContainer::const_iterator ChildConstIterator
 
typedef ChildContainer::const_reverse_iterator ChildConstReverseIterator
 
- Public Types inherited from kanzi::Node
enum  HorizontalAlignment { HorizontalAlignmentLeft, HorizontalAlignmentRight, HorizontalAlignmentCenter, HorizontalAlignmentStretch }
 Horizontal alignment options. More...
 
enum  VerticalAlignment { VerticalAlignmentBottom, VerticalAlignmentTop, VerticalAlignmentCenter, VerticalAlignmentStretch }
 Vertical alignment options. More...
 
enum  DepthAlignment { DepthAlignmentBack, DepthAlignmentFront, DepthAlignmentCenter, DepthAlignmentStretch }
 Depth alignment options. More...
 
enum  ContentStretch {
  ContentStretchNone, ContentStretchFill, ContentStretchUniform, ContentStretchUniformToFill,
  ContentStretchRepeat
}
 Content stretch option. More...
 
enum  VisitorOrder { VisitorPreOrder, VisitorPostOrder }
 
enum  VisitorResult { VisitorAbort, VisitorContinue, VisitorContinueSibling }
 
typedef kanzi::vector< Node::MessageSubscriptionTokenMessageSubscriptionTokenVector
 
typedef function< VisitorResult(Node &)> Visitor
 
typedef vector< InputManipulatorSharedPtrInputManipulatorContainer
 Gets the input manipulator iterator. More...
 
typedef InputManipulatorContainer::iterator InputManipulatorIterator
 
typedef InputManipulatorContainer::const_iterator InputManipulatorConstIterator
 
typedef vector< BindingEntryBindingContainer
 Gets the bindings iterator. More...
 
typedef BindingContainer::iterator BindingIterator
 
typedef BindingContainer::const_iterator BindingConstIterator
 
typedef vector< NodeComponentEntryNodeComponentContainer
 Gets the node component iterator. More...
 
typedef NodeComponentContainer::iterator NodeComponentIterator
 
typedef NodeComponentContainer::const_iterator NodeComponentConstIterator
 
- Public Types inherited from kanzi::PropertyObject
typedef intrusive_ptr< AbstractPropertyTypeDescriptor::PropertyStoragePropertyStoragePtr
 
typedef vector< PropertyStoragePtrPropertyStorageContainer
 
typedef PropertyStorageContainer::iterator PropertyStorageIterator
 
typedef PropertyStorageContainer::const_iterator PropertyStorageConstIterator
 
typedef PropertyStorageContainer::reverse_iterator PropertyStorageReverseIterator
 
- Public Types inherited from kanzi::ScrollViewConcept
enum  ScrollDirection { ScrollUp, ScrollDown, ScrollLeft, ScrollRight }
 Enumeration for possible directions when scrolling by step. More...
 
enum  ScrollPage { ScrollPageUp, ScrollPageDown }
 Enumeration for possible directions when scrolling by page. More...
 
enum  ScrollEdge { ScrollHome, ScrollEnd }
 Enumeration for possible directions when scrolling to edge. More...
 
enum  PanState { PanInitial, PanStarted, PanCancelling, PanCanceled }
 Enumeration for pan state. More...
 
- Static Public Attributes inherited from kanzi::Node3D
static PropertyType< Matrix4x4FinalTransformationProperty
 FinalTransformation property. More...
 
static PropertyType< float > FrustumCullMarginProperty
 FrustumCullMargin property. More...
 
static PropertyType< SRTValue3DRenderTransformationProperty
 RenderTransformation property. More...
 
static PropertyType< SRTValue3DLayoutTransformationProperty
 LayoutTransformation property. More...
 
- 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< 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::HorizontalAlignmentHorizontalAlignmentProperty
 HorizontalAlignment property. More...
 
static PropertyType< Node::VerticalAlignmentVerticalAlignmentProperty
 VerticalAlignment property. More...
 
static PropertyType< Node::DepthAlignmentDepthAlignmentProperty
 DepthAlignment property. More...
 
static PropertyType< Vector2HorizontalMarginProperty
 HorizontalMargin property. More...
 
static PropertyType< Vector2VerticalMarginProperty
 VerticalMargin property. More...
 
static PropertyType< Vector2DepthMarginProperty
 DepthMargin 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
 Enabled property. More...
 
static PropertyType< bool > FocusableProperty
 Focusable property. More...
 
static PropertyType< bool > FocusedProperty
 Focused property. More...
 
static PropertyType< ResourceSharedPtrFontProperty
 Font property. More...
 
static PropertyType< float > VisibleAmountInParentProperty
 VisibleAmountInParent property. More...
 
static PropertyType< bool > ClipChildrenProperty
 ClipChildren property. More...
 
static PropertyType< float > Projection2DTo3DScaleProperty
 Projection2DTo3DScale property. More...
 
static PropertyType< bool > EnableClickProperty
 EnableClick property. More...
 
static PropertyType< bool > EnableMultiClickProperty
 EnableMultiClick property. More...
 
static PropertyType< Node::ContentStretchContentStretchProperty
 ContentStretch property. More...
 
static PropertyType< float > OpacityProperty
 Opacity property. More...
 
static PropertyType< ResourceSharedPtrStyleProperty
 Style property. More...
 
static PropertyType< ResourceSharedPtrStateManagerProperty
 StateManager 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 PropertyType< void * > PrefabTemplateSourceProperty
 PrefabTemplateSource property. More...
 
- Static Public Attributes inherited from kanzi::ScrollViewConcept
static MessageType< ScrollStartedMessageArgumentsScrollStartedMessage
 
static MessageType< ScrollFinishedMessageArgumentsScrollFinishedMessage
 
static MessageType< UserScrollStartedMessageArgumentsUserScrollStartedMessage
 
static MessageType< UserScrollFinishedMessageArgumentsUserScrollFinishedMessage
 
static MessageType< ZoomedMessageArgumentsZoomedMessage
 
static MessageType< ScrolledMessageArgumentsScrolledMessage
 
static MessageType< SnapRequestMessageArgumentsSnapRequestMessage
 
static MessageType< ScrollDirectionMessageArgumentsScrollDirectionMessage
 
static MessageType< ScrollPageMessageArgumentsScrollPageMessage
 
static MessageType< ScrollEdgeMessageArgumentsScrollEdgeMessage
 
static MessageType< SetScrollTargetMessageArgumentsSetScrollTargetMessage
 
static MessageType< SetScrollMessageArgumentsSetScrollMessage
 
static PropertyType< float > MessageArgumentScrollViewScrollPositionXProperty
 MessageArgumentScrollViewScrollPositionX property. More...
 
static PropertyType< float > MessageArgumentScrollViewScrollPositionYProperty
 MessageArgumentScrollViewScrollPositionY property. More...
 
static PropertyType< Vector2MessageArgumentScrollViewScrollPositionProperty
 MessageArgumentScrollViewScrollPosition property. More...
 
static PropertyType< Vector2MessageArgumentScrollViewScrollSpeedProperty
 MessageArgumentScrollViewScrollSpeed property. More...
 
static PropertyType< Vector2MessageArgumentScrollViewScrollTargetProperty
 MessageArgumentScrollViewScrollTarget property. More...
 
static PropertyType< int > MessageArgumentScrollViewScrollDirectionProperty
 MessageArgumentScrollViewScrollDirection property. More...
 
static PropertyType< int > MessageArgumentScrollViewScrollPageProperty
 MessageArgumentScrollViewScrollPage property. More...
 
static PropertyType< int > MessageArgumentScrollViewScrollEdgeProperty
 MessageArgumentScrollViewScrollEdge property. More...
 
static PropertyType< float > MessageArgumentScrollViewZoomProperty
 MessageArgumentScrollViewZoom property. More...
 
static PropertyType< Vector2MessageArgumentScrollViewSnapPositionProperty
 MessageArgumentScrollViewSnapPosition property. More...
 
static PropertyType< Vector2MessageArgumentScrollViewSnapDirectionProperty
 MessageArgumentScrollViewSnapDirection property. More...
 
static PropertyType< Vector2ScrollAxisProperty
 ScrollAxis property. More...
 
static PropertyType< float > RecognitionThresholdProperty
 RecognitionThreshold property. More...
 
static PropertyType< int > MinimumNumberOfTouchesProperty
 MinimumNumberOfTouches property. More...
 
static PropertyType< int > MaximumNumberOfTouchesProperty
 MaximumNumberOfTouches property. More...
 
static PropertyType< float > SensitivityProperty
 Sensitivity property. More...
 
static PropertyType< float > SlidingAccelerationCoefficientProperty
 SlidingAccelerationCoefficient property. More...
 
static PropertyType< float > SlidingDragCoefficientProperty
 SlidingDragCoefficient property. More...
 
static PropertyType< float > DraggingAccelerationCoefficientProperty
 DraggingAccelerationCoefficient property. More...
 
static PropertyType< float > DraggingDragCoefficientProperty
 DraggingDragCoefficient property. More...
 
static PropertyType< float > DraggingImpulseFactorProperty
 DraggingImpulseFactor property. More...
 
static PropertyType< float > SwipeDistanceProperty
 SwipeDistance property. More...
 
static PropertyType< Vector2ScrollPositionProperty
 ScrollPosition property. More...
 
static PropertyType< Vector2ScrollTargetPositionProperty
 ScrollTargetPosition property. More...
 
static PropertyType< Vector2ScrollSpeedProperty
 ScrollSpeed property. More...
 
static PropertyType< bool > ScrollingProperty
 Scrolling property. More...
 
static PropertyType< bool > ZoomAffectsScrollingProperty
 ZoomAffectsScrolling property. More...
 
static PropertyType< Vector2ScrollBoundsMinimumProperty
 ScrollBoundsMinimum property. More...
 
static PropertyType< Vector2ScrollBoundsMaximumProperty
 ScrollBoundsMaximum property. More...
 
static PropertyType< bool > LoopingXEnabledProperty
 LoopingXEnabled property. More...
 
static PropertyType< bool > LoopingYEnabledProperty
 LoopingYEnabled property. More...
 
static PropertyType< bool > ZoomEnabledProperty
 ZoomEnabled property. More...
 
static PropertyType< float > ZoomProperty
 Zoom property. More...
 
static PropertyType< float > ZoomMinimumProperty
 ZoomMinimum property. More...
 
static PropertyType< float > ZoomMaximumProperty
 ZoomMaximum property. More...
 
static PropertyType< float > StepMultiplierProperty
 StepMultiplier property. More...
 
- Protected Types inherited from kanzi::Object
typedef vector< AppliedStyleEntry * > AppliedStyleContainer
 Applied style container. More...
 
- Static Protected Member Functions inherited from kanzi::Node
static VisitorResult updateResourceVisitor (Node &node, const ResourceID &id)
 
static VisitorResult updateAllResourcesVisitor (Node &node)
 
static VisitorResult applyStylesVisitor (Node &node, bool apply)
 
static VisitorResult attachVisitor (Node &node)
 
static VisitorResult detachVisitor (Node &node)
 
static VisitorResult validateDrawVisitor (Node &node)
 Visitor for validating draw. More...
 
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)
 
- Protected Attributes inherited from kanzi::Object
AppliedStyleContainer m_appliedStyles
 Listing of applied styles applied to this object. More...
 

Detailed Description

Use the Scroll View 3D node to create an input plane to enable user input from gestures.

For example, you can use the scroll message with its parameters generated by a Scroll View node to move a map plane or rotate a mesh.

When you create a Scroll View node it does not have a visual shape and does not necessarily need visible content, but can instead work as an interactive surface. When a user interacts with a Scroll View node, the action generates a message that travels to the Scroll View node where you can define the behavior for that message.

The Scroll View reports changes of its scroll position through the Scroll View: Scrolled message. You can add actions to react to these messages to, for example, set the position of an object according to the scrolling.

Note that Scroll View 3D node has location, position, and size in 3D space. It registers user input in 3D coordinates within the area defined by the size of the Scroll View 3D node. Take this into account when designing interaction with the Scroll View 3D. For example, if you rotate the Scroll View 3D node, the scroll input gets distorted.

See also
For a 2D scroll view component, see ScrollView2D.

Examples

To create a Scroll View 3D node that animates the transformation of a 3D node in response to scroll messages:

// Declare the variable for storing the Scroll View node used in this example.
// Declare the variable for storing the Box node created in this example.
// Define the handler function for the ScrollView3D.Scrolled message from the scroll view.
void onScrollViewScrolled(ScrollView3D::ScrollMessageArguments& messageArguments)
{
// Make a 3D vector out of the Scroll View node's scroll position X/Y values, setting Z as zero.
Vector3 translation = Vector3(messageArguments.getScrollPositionX(), messageArguments.getScrollPositionY(), 0.0f);
// Set the above 3D vector as box's render translation.
box->setRenderTransformation(SRTValue3D::createTranslation(translation));
}
// Create the Scroll View which uses the ScrollView3D.Scrolled message handler.
void exampleSetupScrollView3D()
{
// Create Scroll View node and attach to that node a Text Block 2D node.
scrollView = ScrollView3D::create(domain, "Scroll View");
scrollView->setSize(100.0f, 100.0f, 10.0f);
// Create a Box node and attach it to the Scroll View 3D node.
box = Model3D::createBox(domain, "Box", Vector3(2.0f, 2.0f, 2.0f), ThemeOrange);
scrollView->addChild(box);
// Add a message handler for the ScrollView3D.Scrolled message from the Scroll View node.
scrollView->addMessageHandler(ScrollView3D::ScrolledMessage, bind(&ScrollView3DScrollSnippet::onScrollViewScrolled, this, placeholders::_1));
}

To create a Scroll View 3D node that animates the transformation of a 3D node in response to zoom messages:

// Declare the variable for storing the Scroll View node used in this example.
// Declare the variables for storing the Box node and Render Transformation property value used in this example.
SRTValue3D baseTransform;
// Define the handler function for the ScrollView3D.Zoomed message from the scroll view.
void onScrollViewZoomed(ScrollView3D::ZoomedMessageArguments& arguments)
{
// Get the value for the amount of zoom from the ScrollView3D.Zoomed message arguments.
float zoom = arguments.getZoom();
// Make a copy of the saved base Render Transformation of the Box node.
SRTValue3D transformCopy(baseTransform);
// Scale the copied transform on every axis for the zoom amount.
transformCopy.scale(Vector3(zoom, zoom, zoom));
// Apply the scaled transform to the Render Transformation property of the Box node.
box->setRenderTransformation(transformCopy);
}
// Create the Scroll View which uses the ScrollView3D.Zoomed message handler.
void exampleSetupScrollView3D()
{
// Create Scroll View node and set a size for it.
scrollView = ScrollView3D::create(domain, "Scroll View");
scrollView->setSize(100.0f, 100.0f, 10.0f);
// Create a Box node and attach it to the Scroll View 3D node.
box = Model3D::createBox(domain, "Box", Vector3(2.0f, 2.0f, 2.0f), ThemeOrange);
scrollView->addChild(box);
// Get the value of the Render Transformation property of the Box node.
baseTransform = box->getRenderTransformation();
// Add a message handler for the ScrollView3D.Zoomed message from the Scroll View node.
scrollView->addMessageHandler(ScrollView3D::ZoomedMessage, bind(&ScrollView3DZoomSnippet::onScrollViewZoomed, this, placeholders::_1));
}

Constructor & Destructor Documentation

kanzi::ScrollView3D::ScrollView3D ( Domain domain,
string_view  name 
)
explicitprotected

Constructor.

Parameters
domainThe UI domain the new node belongs to.
nameThe name of the node.

Member Function Documentation

static ScrollView3DSharedPtr kanzi::ScrollView3D::create ( Domain domain,
string_view  name 
)
static

Creates a scroll view with the default settings.

Parameters
domainThe UI domain the new node belongs to.
nameName of the node.
static PropertyTypeEditorInfoSharedPtr kanzi::ScrollView3D::makeEditorInfo ( )
static
optional<Vector2> kanzi::ScrollView3D::calculatePanPosition ( const KzcRay ray) const

Calculates pan position for given ray.

Parameters
rayRay that intersects the scroll's view plane.
optional<Vector2> kanzi::ScrollView3D::calculatePanPosition ( const InputManipulator::InputMessageArguments arguments) const

Calculates pan position for message arguments.

Parameters
argumentsMessage arguments from input manipulator.

The documentation for this class was generated from the following file: