Use ShadowEffect2D to apply drop- and inner-shadow post-processing effects to 2D nodes. More...
#include <kanzi/core.ui/effect/shadow_effect2d.hpp>
Public Types | |
| enum | Quality { Quality::Low, Quality::Normal, Quality::High, Quality::Count } |
| Defines the visual quality levels of the shadow effect. More... | |
| enum | Type { Type::DropShadow, Type::InnerShadow, Type::Count } |
| Defines the types of the shadow effect. 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 Member Functions | |
| float | getAngle () const |
| Gets the value of AngleProperty. More... | |
| float | getBlurRadius () const |
| Gets the value of BlurRadiusProperty. More... | |
| ColorRGBA | getColor () const |
| Gets the value of ColorProperty. More... | |
| float | getDistance () const |
| Gets the value of DistanceProperty. More... | |
| Quality | getQuality () const |
| Gets the value of QualityProperty. More... | |
| bool | getShadowOnly () const |
| Gets the value of ShadowOnlyProperty. More... | |
| Type | getType () const |
| Gets the value of TypeProperty. More... | |
| void | setAngle (float value) |
| Sets the value of AngleProperty. More... | |
| void | setBlurRadius (float value) |
| Sets the value of BlurRadiusProperty. More... | |
| void | setColor (ColorRGBA value) |
| Sets the value of ColorProperty. More... | |
| void | setDistance (float value) |
| Sets the value of DistanceProperty. More... | |
| void | setQuality (Quality value) |
| Sets the value of QualityProperty. More... | |
| void | setShadowOnly (bool value) |
| Sets the value of ShadowOnlyProperty. More... | |
| void | setType (Type value) |
| Sets the value of TypeProperty. More... | |
Public Member Functions inherited from kanzi::NodeEffect2D | |
| NodeEffectRenderer2DUniquePtr | createRenderer () |
| Creates a renderer instance. More... | |
| unsigned int | getEffectPaddingChangeCounter () const |
| Gets the effect quad change counter. More... | |
| Vector4 | getEffectQuadPadding () const |
| Gets the effect quad padding. More... | |
| Vector2 | getEffectQuadPaddingOffset () const |
| Gets the effect quad offset relative relative to the top-left corner of the node. More... | |
| Vector2 | getEffectQuadPaddingSize () const |
| Gets the effect quad padding size. More... | |
| bool | isAlphaRequired () const |
| Indicates whether the effect requires alpha channel for the result. More... | |
| void | unregisterEffectRenderer (NodeEffectRenderer2D *effectRenderer) |
| Unregister effect renderer. More... | |
| ~NodeEffect2D () | |
Public Member Functions inherited from kanzi::Resource | |
| virtual unsigned int | getCPUMemoryUsage () const |
| Function for getting the memory usage of a resource. More... | |
| const string & | getName () const |
| Gets the resource name. More... | |
| const string & | getUrl () const |
| Gets the resource URL. More... | |
| bool | isKeepAlive () const |
| Tells if the resource has keep alive flag set. More... | |
| void | reload () |
| void | reloadFromFile (string_view filePath) |
| void | reloadFromKzb (KzbFile &kzbFile, ReadOnlyMemoryFile &file, KzbMemoryParser &parser) |
| void | setKeepAlive (bool keepAlive) |
| Sets the keep alive flag. More... | |
| void | setUrl (string_view url) |
| Sets the resource URL. More... | |
| ~Resource () override | |
| Destructor. 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 () |
Static Public Member Functions | |
| static ShadowEffect2DSharedPtr | create (Domain *domain, string_view name) |
| Creates a shadow effect. More... | |
| static PropertyTypeEditorInfoSharedPtr | makeEditorInfo () |
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... | |
Static Public Attributes | |
| static PropertyType< float > | AngleProperty |
| Sets the direction of the shadow as an angle relative to the positive x-axis. More... | |
| static PropertyType< float > | BlurRadiusProperty |
| Sets the softness of the shadow by defining the distance in pixels the shadow blur extends outward from an edge. More... | |
| static PropertyType< ColorRGBA > | ColorProperty |
| Sets the color of the shadow. More... | |
| static PropertyType< float > | DistanceProperty |
| Sets how far to move the shadow from the object in the direction set by the AngleProperty. More... | |
| static PropertyType< Quality > | QualityProperty |
| Sets the visual quality of the shadow. More... | |
| static PropertyType< bool > | ShadowOnlyProperty |
| Sets whether to render only the shadow without the node contents. More... | |
| static PropertyType< Type > | TypeProperty |
| Sets the type of the shadow: More... | |
Additional Inherited Members | |
Protected Types inherited from kanzi::Object | |
| typedef vector< AppliedStyleEntrySharedPtr > | AppliedStyleContainer |
| Applied style container. More... | |
Protected Attributes inherited from kanzi::Object | |
| AppliedStyleContainer | m_appliedStyles |
| Listing of applied styles applied to this object. More... | |
Use ShadowEffect2D to apply drop- and inner-shadow post-processing effects to 2D nodes.
To create a shadow effect:
To set the shadow effect properties:
|
strong |
|
strong |
|
explicitprotected |
|
inline |
Gets the value of BlurRadiusProperty.
|
inline |
Sets the value of BlurRadiusProperty.
|
inline |
Gets the value of QualityProperty.
|
inline |
Sets the value of QualityProperty.
|
inline |
Gets the value of TypeProperty.
|
inline |
Sets the value of TypeProperty.
|
inline |
Gets the value of DistanceProperty.
|
inline |
Sets the value of DistanceProperty.
|
inline |
Gets the value of AngleProperty.
|
inline |
Sets the value of AngleProperty.
|
inline |
Gets the value of ColorProperty.
|
inline |
Sets the value of ColorProperty.
|
inline |
Gets the value of ShadowOnlyProperty.
|
inline |
Sets the value of ShadowOnlyProperty.
|
static |
|
static |
Creates a shadow effect.
|
overrideprotectedvirtual |
NodeEffect2D::createRendererOverride implementation.
Implements kanzi::NodeEffect2D.
|
overrideprotectedvirtual |
NodeEffect2D::initializeRendererOverride implementation.
Implements kanzi::NodeEffect2D.
|
overrideprotectedvirtual |
PropertyObject::onPropertyChanged implementation.
Reimplemented from kanzi::PropertyObject.
|
static |
Sets the softness of the shadow by defining the distance in pixels the shadow blur extends outward from an edge.
For a shadow with sharp edges, set to 0. The default value is 8.
|
static |
Sets the visual quality of the shadow.
Lower quality uses less computing and memory resources. The default value is Normal.
|
static |
|
static |
Sets how far to move the shadow from the object in the direction set by the AngleProperty.
The default value is 10.
|
static |
Sets the direction of the shadow as an angle relative to the positive x-axis.
The default value is 45.
|
static |
Sets the color of the shadow.
The default value is ColorRGBA(0.f, 0.f, 0.f, 0.75f).
|
static |
Sets whether to render only the shadow without the node contents.
The default value is false.