All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros
kanzi::BrushRenderer Class Referenceabstract

TODO: follow the NVI pattern, use xxxOverride protected funcs Brush renderer class. More...

#include <kanzi/graphics_2d/brush_renderer.hpp>

Inheritance diagram for kanzi::BrushRenderer:
kanzi::GlBrushRenderer kanzi::ColorBrushRenderer kanzi::MaterialBrushRenderer kanzi::TextureBrushRenderer kanzi::ContentBrushRenderer

Public Member Functions

virtual ~BrushRenderer ()
 Destructor. More...
 
void updateRender (bool forceOpaque, bool translucencyHint)
 Called from Node2D::updateRender(), prepare brush for rendering. More...
 
void updateRender (bool forceOpaque)
 Default parameter override for updateRender(). More...
 
void updateRender ()
 Default parameter override for updateRender(). More...
 
void bind (Renderer3D &renderer)
 Bind brush renderer for rendering. More...
 
void draw (Renderer3D &renderer, ClipQuad &quad, const Matrix4x4 &transform) const
 Draw a brush using given quad. More...
 
void draw (Renderer3D &renderer, ClipQuad &quad, const Matrix3x3 &transform) const
 Overload for draw a brush using given quad. More...
 
void restoreResources ()
 Restore resources after suspend. More...
 
BrushgetBrush () const
 Access brush. More...
 
unsigned int getPropertyChangeCounter () const
 Access property change counter. More...
 
float getRenderOpacity () const
 Access opacity. More...
 
void setRenderOpacity (float opacity)
 Set opacity to use for next attach. More...
 
TextureSharedPtr getContentTexture () const
 Access content texture. More...
 
void setContentTexture (TextureSharedPtr texture)
 Set a content texture. More...
 
NodegetNode () const
 Access node. More...
 

Protected Types

enum  RenderMode {
  RenderModeNone, RenderModeInvalid, RenderModeOpaqueNoContent, RenderModeTranslucentNoContent,
  RenderModeOpaque, RenderModeTranslucent
}
 Enum signifying currently selected render mode. More...
 

Protected Member Functions

 BrushRenderer (Brush *brush, Node *node)
 Constructor. More...
 
virtual void drawQuadOverride (Renderer3D &renderer, ClipQuad &quad, const Matrix4x4 &transform) const =0
 Draw a clip quad. More...
 
virtual void bindOverride (Renderer3D &renderer)=0
 BrushRenderer-specific bind implementation. More...
 
virtual void updateRenderOverride (bool forceOpaque, bool translucencyHint)=0
 BrushRenderer-specific opacity override implementation. More...
 
virtual void restoreResourcesOverride ()=0
 BrushRenderer-specific restore resources implementation. More...
 
bool isChangeCounterSame () const
 Check if property change counter matches that of the brush. More...
 
void updateChangeCounter ()
 Update property change counter to match brush. More...
 
RenderMode getRenderMode () const
 Get currently selected render mode. More...
 
bool hasRenderMode () const
 Tell if any (valid) render mode selection has been made. More...
 
void setRenderMode (RenderMode selection)
 Set render mode. More...
 

Protected Attributes

size_t m_contentTextureHandle
 Render value handle. More...
 
size_t m_renderOpacityHandle
 Render value handle. More...
 

Detailed Description

TODO: follow the NVI pattern, use xxxOverride protected funcs Brush renderer class.

Just an interface, actual rendering will be implemented by specialized brush renderers.

Member Enumeration Documentation

Enum signifying currently selected render mode.

Enumerator
RenderModeNone 

No selection.

RenderModeInvalid 

Invalid render mode - selection has been done but suitable render mode could not be selected.

RenderModeOpaqueNoContent 

Opaque without content.

RenderModeTranslucentNoContent 

Translucent without content.

RenderModeOpaque 

Opaque with content.

RenderModeTranslucent 

Translucent with content.

Constructor & Destructor Documentation

virtual kanzi::BrushRenderer::~BrushRenderer ( )
inlinevirtual

Destructor.

kanzi::BrushRenderer::BrushRenderer ( Brush brush,
Node node 
)
explicitprotected

Constructor.

Parameters
nodeNode to attach to.
brushBrush to attach to.

Member Function Documentation

void kanzi::BrushRenderer::updateRender ( bool  forceOpaque,
bool  translucencyHint 
)

Called from Node2D::updateRender(), prepare brush for rendering.

Parameters
forceOpaqueShould opaque render mode be selected no matter what?
translucencyHintAdditional hint to use translucent rendering.
void kanzi::BrushRenderer::updateRender ( bool  forceOpaque)
inline

Default parameter override for updateRender().

Allows forcing opacity, in this situation translucency hint does not matter.

Parameters
forceOpaqueShould opaque render mode be selected no matter what?
void kanzi::BrushRenderer::updateRender ( )
inline

Default parameter override for updateRender().

Opaqueness force and translucency hint are off.

void kanzi::BrushRenderer::bind ( Renderer3D renderer)

Bind brush renderer for rendering.

Parameters
rendererRenderer to use.
void kanzi::BrushRenderer::draw ( Renderer3D renderer,
ClipQuad quad,
const Matrix4x4 transform 
) const

Draw a brush using given quad.

Parameters
rendererRenderer to use.
quadQuad to draw.
transformTransform (4X4) to use.
void kanzi::BrushRenderer::draw ( Renderer3D renderer,
ClipQuad quad,
const Matrix3x3 transform 
) const
inline

Overload for draw a brush using given quad.

Parameters
rendererRenderer to use.
quadQuad to draw.
transformTransform (3X3) to use.
void kanzi::BrushRenderer::restoreResources ( )

Restore resources after suspend.

Brush* kanzi::BrushRenderer::getBrush ( ) const
inline

Access brush.

Returns
Brush pointer.
unsigned int kanzi::BrushRenderer::getPropertyChangeCounter ( ) const
inline

Access property change counter.

float kanzi::BrushRenderer::getRenderOpacity ( ) const
inline

Access opacity.

Returns
Current render opacity.
void kanzi::BrushRenderer::setRenderOpacity ( float  opacity)
inline

Set opacity to use for next attach.

Parameters
opacityNew render opacity.
TextureSharedPtr kanzi::BrushRenderer::getContentTexture ( ) const
inline

Access content texture.

Returns
Current content texture.
void kanzi::BrushRenderer::setContentTexture ( TextureSharedPtr  texture)
inline

Set a content texture.

Parameters
textureNew render texture.
Node* kanzi::BrushRenderer::getNode ( ) const
inline

Access node.

Returns
Node pointer.
virtual void kanzi::BrushRenderer::drawQuadOverride ( Renderer3D renderer,
ClipQuad quad,
const Matrix4x4 transform 
) const
protectedpure virtual

Draw a clip quad.

To be implemented by specific brush implementations.

Parameters
rendererRenderer to use.
quadQuad to draw.
transformTransform to use.

Implemented in kanzi::ColorBrushRenderer, kanzi::MaterialBrushRenderer, and kanzi::TextureBrushRenderer.

virtual void kanzi::BrushRenderer::bindOverride ( Renderer3D renderer)
protectedpure virtual

BrushRenderer-specific bind implementation.

Implemented in kanzi::ColorBrushRenderer, kanzi::MaterialBrushRenderer, kanzi::TextureBrushRenderer, and kanzi::ContentBrushRenderer.

virtual void kanzi::BrushRenderer::updateRenderOverride ( bool  forceOpaque,
bool  translucencyHint 
)
protectedpure virtual

BrushRenderer-specific opacity override implementation.

Parameters
forceOpaqueShould opaque render mode be selected no matter what?
translucencyHintAdditional hint to use translucent rendering.

Implemented in kanzi::ColorBrushRenderer, kanzi::MaterialBrushRenderer, kanzi::TextureBrushRenderer, and kanzi::ContentBrushRenderer.

virtual void kanzi::BrushRenderer::restoreResourcesOverride ( )
protectedpure virtual

BrushRenderer-specific restore resources implementation.

Implemented in kanzi::GlBrushRenderer.

bool kanzi::BrushRenderer::isChangeCounterSame ( ) const
protected

Check if property change counter matches that of the brush.

Returns
True if matches and no update is necessary, false otherwise.
void kanzi::BrushRenderer::updateChangeCounter ( )
protected

Update property change counter to match brush.

RenderMode kanzi::BrushRenderer::getRenderMode ( ) const
inlineprotected

Get currently selected render mode.

Returns
Current render mode.
bool kanzi::BrushRenderer::hasRenderMode ( ) const
inlineprotected

Tell if any (valid) render mode selection has been made.

Returns
True if yes, false if no.
void kanzi::BrushRenderer::setRenderMode ( RenderMode  selection)
inlineprotected

Set render mode.

Parameters
selectionNew render mode selection.

Member Data Documentation

size_t kanzi::BrushRenderer::m_contentTextureHandle
protected

Render value handle.

size_t kanzi::BrushRenderer::m_renderOpacityHandle
protected

Render value handle.


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