Composition functionality for 2D nodes. More...

#include <kanzi/core.ui/node/node_compositor2d.hpp>

Public Types
enum	CompositingBits { CompositingBitUserTarget, CompositingBitCache, CompositingBitForce, CompositingBitOffscreen, CompositingBitOpacityAndChildren, CompositingBitPerspective, CompositingBitRequest, CompositingBitCount }
	Enum for compositing bit flags. More...

enum	PotentialCompositingBits { PotentialCompositingBitCache, PotentialCompositingBitViewport, PotentialCompositingBitCount }
	Enum for compositing potential bit flags. More...

Public Member Functions
tuple< TextureSharedPtr, bool >	beginComposition (CompositionStack &compositionStack, CompositionManager *compositionManager, Vector2 requiredSize, bool alphaRequired, bool depthRequired, bool stencilRequired, bool drawFlagSet)
	Begin final composition. More...

void	blitFinalComposition (Renderer3D &renderer, CompositionStack &compositionStack, CompositionManager compositionManager, TextureSharedPtr renderTargetTexture, QuadDescription &backgroundQuad, const Matrix3x3 &transform, Vector2 quadSize, const Matrix4x4 perspectiveMatrix, const Matrix4x4 *projectionMatrix)
	Blit final composition. More...

void	disableCaching ()
	Disable caching. More...

void	enableCaching (CachingMode mode)
	Enable caching. More...

void	endFinalComposition (CompositionStack &compositionStack)
	End final composition. More...

CachingMode	getCachingMode () const
	Gets the caching mode stored in the compositor. More...

BrushRenderer *	getCompositionBrushRenderer () const
	Access composition brush renderer. More...

TextureSharedPtr	getCompositionTarget () const
	Access managed composition target. More...

TextureSharedPtr	getManagedCompositionTarget () const
	Gets the managed composition target. More...

Vector2	getUserCompositionTargetSize () const
	Gets the size of user composition target. More...

bool	hasCompositionBrushRenderer () const
	Tell if composition brush renderer has been created. More...

bool	hasManagedCompositionTarget () const
	Indicates whether a managed composition target has been allocated. More...

bool	hasUserCompositionTarget () const
	Indicates whether user composition target is set. More...

void	invalidateCompositionBrush ()
	Invalidate composition brush. More...

bool	isCacheValid () const
	Indicates whether or not the cache is valid. More...

bool	isCompositionPotentiallyRequired () const
	Indicates whether composition can potentially be required during rendering. More...

bool	isCompositionRequested () const
	Indicates whether composition is requested from code. More...

bool	isCompositionRequired () const
	Indicates whether compositing the node is required. More...

bool	isCompositionRequiredDuringRendering (const optional< Matrix3x3 > &transform, bool drawFlagSet) const
	Indicates whether compositing the node is required during rendering. More...

bool	isForceComposition () const
	Indicates whether force composition flag is set. More...

bool	isOffscreenRendering () const
	Indicates whether offscreen rendering is enabled. More...

bool	isOpacityCompositionRequest () const
	Indicates whether composition due to opacity is requested. More...

bool	isPerspectiveCompositionRequested () const
	Indicates whether composition due to perspective transform is requested. More...

bool	isPotentialCompositionBitViewport () const
	Indicates whether potential composition request flag is set. More...

	NodeCompositor2D ()
	Constructor. More...

void	onDetached ()
	Run when node owning the compositor becomes detached. More...

void	renderCompositionQuad (Renderer3D &renderer, BrushRenderer &brushRenderer, const Texture &texture, QuadDescription &backgroundQuad, const Matrix4x4 &transform, Vector2 quadSize)
	Render composition quad. More...

void	resizeUserCompositionTarget (Vector2 compositionSize)
	Resize automatic sizes in user composition target if necessary. More...

void	restoreResources (Vector2 compositionSize)
	Restore resources. More...

void	setCacheValid (bool valid)
	Set cache validity flag. More...

void	setCompositionRequested (bool enabled)
	Sets the compositing request. More...

void	setForceComposition (bool enabled)
	Sets force composition. More...

void	setOffscreenRendering (bool enabled)
	Sets the offscreen rendering flag. More...

void	setOpacityCompositionRequested (bool enabled)
	Sets the opacity composition request flag. More...

void	setPerspectiveCompositionRequested (bool enabled)
	Sets the perspective composition request flag. More...

void	setPotentialCompositionBitVierport (bool enabled)
	Sets the potential composition request flag. More...

void	setUserCompositionBrush (BrushSharedPtr brush)
	Set user composition brush. More...

void	setUserCompositionTarget (TextureSharedPtr texture)
	Set user composition target. More...

void	updateRender (Node2D &node, Vector2 actualSize, bool alphaRequired, bool depthRequired, bool stencilRequired, float opacity, bool opaquenessHint, bool translucencyHint)
	Update for rendering, recreating composition targets and brush renderers as needed. More...

Protected Member Functions
bool	updatePersistentCompositionTarget (Node2D &node, TextureSharedPtr &managedCompositionTarget, Vector2 requiredSize, bool alphaRequired, bool depthRequired, bool stencilRequired)
	Update the managed composition target to match current requirements. More...

Protected Attributes
bool	m_brushRenderersDirty
	Brush renderer dirty flag. More...

bool	m_cacheValid
	Cache status flag. More...

CachingMode	m_cachingMode
	Caching mode setting. More...

bitset< CompositingBitCount >	m_compositingMask
	Bit mask for states affecting whether or not the node should compose itself and its children. More...

BrushRendererPtr	m_compositionBrushRenderer
	Composition brush renderer. More...

CompositionBrushSharedPtr	m_managedCompositionBrush
	Composition brush managed by node. More...

TextureSharedPtr	m_managedCompositionTarget
	Current framebuffer. More...

bool	m_opaquenessHint
	Saved opaqueness hint. More...

bitset< PotentialCompositingBitCount >	m_potentialCompositingMask
	Bit mask for states affecting whether or not the node should potentially compose itself and its children. More...

bool	m_translucencyHint
	Saved tTranslucency hint. More...

BrushSharedPtr	m_userCompositionBrush
	User-set composition brush. More...

TextureSharedPtr	m_userCompositionTarget
	User-set composition target. More...

Detailed Description

Composition functionality for 2D nodes.

Member Enumeration Documentation

enum kanzi::NodeCompositor2D::CompositingBits

Enum for compositing bit flags.

Enumerator
CompositingBitUserTarget	User composition target explicitly set.
CompositingBitCache	Caching mode is set to enabled.
CompositingBitForce	Force composition from property.
CompositingBitOffscreen	Offscreen rendering.
CompositingBitOpacityAndChildren	Composition due to opacity and children.
CompositingBitPerspective	Composition due to perspective transform and children.
CompositingBitRequest	Custom request from code.
CompositingBitCount	Number of options.

enum kanzi::NodeCompositor2D::PotentialCompositingBits

Enum for compositing potential bit flags.

Enumerator
PotentialCompositingBitCache	Caching mode is set to automatic.
PotentialCompositingBitViewport	Potential non-aligned viewport.
PotentialCompositingBitCount	Number of options.

Constructor & Destructor Documentation

kanzi::NodeCompositor2D::NodeCompositor2D ( )

inline

Constructor.

Member Function Documentation

bool kanzi::NodeCompositor2D::updatePersistentCompositionTarget	(	Node2D &	node,
		TextureSharedPtr &	managedCompositionTarget,
		Vector2	requiredSize,
		bool	alphaRequired,
		bool	depthRequired,
		bool	stencilRequired
	)

protected

Update the managed composition target to match current requirements.

If the composition target does not exist or the settings required from it have been changed, it is (re)created.

Parameters

node	Node to attach to.
managedCompositionTarget	Existing composition target.
requiredSize	Size required of the composition target.
alphaRequired	Alpha requirement.
depthRequired	Depth requirement.
stencilRequired	Stencil requirement.

Returns: True if composition target was updated, false if not.

tuple<TextureSharedPtr, bool> kanzi::NodeCompositor2D::beginComposition	(	CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		Vector2	requiredSize,
		bool	alphaRequired,
		bool	depthRequired,
		bool	stencilRequired,
		bool	drawFlagSet
	)

Begin final composition.

Parameters

compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
requiredSize	Size required of the composition target.
alphaRequired	Alpha requirement.
depthRequired	Depth requirement.
stencilRequired	Stencil requirement.
drawFlagSet	Whether the draw flag is set for the node or any of its descendants.

Returns: Tuple of render target to use and whether or not to perform actual render.

void kanzi::NodeCompositor2D::endFinalComposition ( CompositionStack & compositionStack )

End final composition.

Parameters

compositionStack Composition stack to use.

void kanzi::NodeCompositor2D::blitFinalComposition	(	Renderer3D &	renderer,
		CompositionStack &	compositionStack,
		CompositionManager *	compositionManager,
		TextureSharedPtr	renderTargetTexture,
		QuadDescription &	backgroundQuad,
		const Matrix3x3 &	transform,
		Vector2	quadSize,
		const Matrix4x4 *	perspectiveMatrix,
		const Matrix4x4 *	projectionMatrix
	)

Blit final composition.

Parameters

renderer	Renderer to use.
compositionStack	Composition stack to use.
compositionManager	Composition manager to use.
renderTargetTexture	Render target texture used.
backgroundQuad	Clip quad for background area.
transform	Transform used for rendering.
quadSize	Rendered quad size.
optional	transform used for perspective projection.
optional	projection used for perspective projection.

void kanzi::NodeCompositor2D::renderCompositionQuad	(	Renderer3D &	renderer,
		BrushRenderer &	brushRenderer,
		const Texture &	texture,
		QuadDescription &	backgroundQuad,
		const Matrix4x4 &	transform,
		Vector2	quadSize
	)

Render composition quad.

Parameters

renderer	Renderer to use.
compositionStack	Composition stack to use.
texture	Texture used.
backgroundQuad	Clip quad for background area.
renderTransform	Transform used for rendering.
quadSize	Rendered quad size.

TextureSharedPtr kanzi::NodeCompositor2D::getCompositionTarget ( ) const

Access managed composition target.

Returns: User composition target if set, otherwise the managed composition target or nullptr.

void kanzi::NodeCompositor2D::resizeUserCompositionTarget ( Vector2 compositionSize )

Resize automatic sizes in user composition target if necessary.

Parameters

compositionSize Composition size to resize to.

void kanzi::NodeCompositor2D::onDetached ( )

Run when node owning the compositor becomes detached.

void kanzi::NodeCompositor2D::restoreResources ( Vector2 compositionSize )

Restore resources.

Will restore all GL resources and resize render targets with automatic size.

Parameters

compositionSize Composition size to resize to.

void kanzi::NodeCompositor2D::updateRender	(	Node2D &	node,
		Vector2	actualSize,
		bool	alphaRequired,
		bool	depthRequired,
		bool	stencilRequired,
		float	opacity,
		bool	opaquenessHint,
		bool	translucencyHint
	)

Update for rendering, recreating composition targets and brush renderers as needed.

Parameters

node	Node to attach to.
actualSize	Size required of the composition target.
alphaRequired	Alpha requirement.
depthRequired	Depth requirement.
stencilRequired	Stencil requirement.
opacity	Opacity value that should be used for rendering.
opaquenessHint	Should opaque rendering especially be used?
translucencyHint	Should translucent rendering especially be used?

BrushRenderer* kanzi::NodeCompositor2D::getCompositionBrushRenderer ( ) const

inline

Access composition brush renderer.

bool kanzi::NodeCompositor2D::hasCompositionBrushRenderer ( ) const

inline

Tell if composition brush renderer has been created.

void kanzi::NodeCompositor2D::setUserCompositionBrush ( BrushSharedPtr brush )

inline

Set user composition brush.

Vector2 kanzi::NodeCompositor2D::getUserCompositionTargetSize ( ) const

Gets the size of user composition target.

Returns: Size of composition target or zero vector.

bool kanzi::NodeCompositor2D::hasUserCompositionTarget ( ) const

inline

Indicates whether user composition target is set.

Returns: If user composition target has been set true, otherwise false.

void kanzi::NodeCompositor2D::setUserCompositionTarget ( TextureSharedPtr texture )

inline

Set user composition target.

void kanzi::NodeCompositor2D::invalidateCompositionBrush ( )

inline

Invalidate composition brush.

CachingMode kanzi::NodeCompositor2D::getCachingMode ( ) const

inline

Gets the caching mode stored in the compositor.

Returns: Caching mode.

void kanzi::NodeCompositor2D::enableCaching ( CachingMode mode )

inline

Enable caching.

Parameters

mode	New caching mode, must not be CachingModeDisabled.

void kanzi::NodeCompositor2D::disableCaching ( )

inline

Disable caching.

bool kanzi::NodeCompositor2D::isCacheValid ( ) const

inline

Indicates whether or not the cache is valid.

Returns: True if yes, false if no.

void kanzi::NodeCompositor2D::setCacheValid ( bool valid )

inline

Set cache validity flag.

Parameters

valid Cache status flag.

bool kanzi::NodeCompositor2D::isCompositionRequired ( ) const

inline

Indicates whether compositing the node is required.

This query does not take draw flags into account.

Returns: If composition is required true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionPotentiallyRequired ( ) const

inline

Indicates whether composition can potentially be required during rendering.

This status is in addition to the obligatory requirement.

Returns: If composition may be required during rendering, true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionRequiredDuringRendering	(	const optional< Matrix3x3 > &	transform,
		bool	drawFlagSet
	)		const

Indicates whether compositing the node is required during rendering.

This status is in addition to the obligatory requirement.

Parameters

transform	Local override transform for the node.
drawFlagSet	Whether the draw flag is set for the node or any of its descendants.

Returns: If composition is required during rendering true, otherwise false.

bool kanzi::NodeCompositor2D::isCompositionRequested ( ) const

inline

Indicates whether composition is requested from code.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setCompositionRequested ( bool enabled )

inline

Sets the compositing request.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isForceComposition ( ) const

inline

Indicates whether force composition flag is set.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setForceComposition ( bool enabled )

inline

Sets force composition.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isOffscreenRendering ( ) const

inline

Indicates whether offscreen rendering is enabled.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setOffscreenRendering ( bool enabled )

inline

Sets the offscreen rendering flag.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isOpacityCompositionRequest ( ) const

inline

Indicates whether composition due to opacity is requested.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setOpacityCompositionRequested ( bool enabled )

inline

Sets the opacity composition request flag.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isPerspectiveCompositionRequested ( ) const

inline

Indicates whether composition due to perspective transform is requested.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setPerspectiveCompositionRequested ( bool enabled )

inline

Sets the perspective composition request flag.

Parameters

enabled New flag state.

bool kanzi::NodeCompositor2D::isPotentialCompositionBitViewport ( ) const

inline

Indicates whether potential composition request flag is set.

Returns: If flag is set true, otherwise false.

void kanzi::NodeCompositor2D::setPotentialCompositionBitVierport ( bool enabled )

inline

Sets the potential composition request flag.

Parameters

enabled New flag state.

TextureSharedPtr kanzi::NodeCompositor2D::getManagedCompositionTarget ( ) const

inline

Gets the managed composition target.

Returns: Current composition target.

bool kanzi::NodeCompositor2D::hasManagedCompositionTarget ( ) const

inline

Indicates whether a managed composition target has been allocated.

Returns: If the managed composition target exists true, otherwise false.

Member Data Documentation

TextureSharedPtr kanzi::NodeCompositor2D::m_managedCompositionTarget

protected

Current framebuffer.

CachingMode kanzi::NodeCompositor2D::m_cachingMode

protected

Caching mode setting.

bool kanzi::NodeCompositor2D::m_cacheValid

protected

Cache status flag.

BrushSharedPtr kanzi::NodeCompositor2D::m_userCompositionBrush

protected

User-set composition brush.

TextureSharedPtr kanzi::NodeCompositor2D::m_userCompositionTarget

protected

User-set composition target.

CompositionBrushSharedPtr kanzi::NodeCompositor2D::m_managedCompositionBrush

protected

Composition brush managed by node.

BrushRendererPtr kanzi::NodeCompositor2D::m_compositionBrushRenderer

protected

Composition brush renderer.

bool kanzi::NodeCompositor2D::m_opaquenessHint

protected

Saved opaqueness hint.

bool kanzi::NodeCompositor2D::m_translucencyHint

protected

Saved tTranslucency hint.

bool kanzi::NodeCompositor2D::m_brushRenderersDirty

protected

Brush renderer dirty flag.

bitset<CompositingBitCount> kanzi::NodeCompositor2D::m_compositingMask

protected

Bit mask for states affecting whether or not the node should compose itself and its children.

bitset<PotentialCompositingBitCount> kanzi::NodeCompositor2D::m_potentialCompositingMask

protected

Bit mask for states affecting whether or not the node should potentially compose itself and its children.

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

kanzi/core.ui/node/node_compositor2d.hpp


Kanzi Engine API

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation