LibreOffice Module canvas (master)  1
Public Member Functions | Private Member Functions | Private Attributes | List of all members
vclcanvas::SpriteHelper Class Reference

Helper class for canvas sprites. More...

#include <spritehelper.hxx>

Inheritance diagram for vclcanvas::SpriteHelper:
[legend]
Collaboration diagram for vclcanvas::SpriteHelper:
[legend]

Public Member Functions

 SpriteHelper ()
 
void init (const css::geometry::RealSize2D &rSpriteSize, const ::canvas::SpriteSurface::Reference &rOwningSpriteCanvas, const BackBufferSharedPtr &rBackBuffer, const BackBufferSharedPtr &rBackBufferMask, bool bShowSpriteBounds)
 Late-init the sprite helper. More...
 
void disposing ()
 
void redraw (OutputDevice &rOutDev, const ::basegfx::B2DPoint &rPos, bool &bSurfacesDirty, bool bBufferedUpdate) const
 Repaint sprite content to associated sprite canvas. More...
 
- Public Member Functions inherited from canvas::CanvasCustomSpriteHelper
 CanvasCustomSpriteHelper ()
 
virtual ~CanvasCustomSpriteHelper ()
 
void init (const css::geometry::RealSize2D &rSpriteSize, const SpriteSurface::Reference &rOwningSpriteCanvas)
 Init helper. More...
 
void disposing ()
 Object is being disposed, release all internal references. More...
 
void clearingContent (const Sprite::Reference &rSprite)
 need to call this method for XCanvas::clear(), for opacity tracking More...
 
void checkDrawBitmap (const Sprite::Reference &rSprite, const css::uno::Reference< css::rendering::XBitmap > &xBitmap, const css::rendering::ViewState &viewState, const css::rendering::RenderState &renderState)
 need to call this method for XCanvas::drawBitmap(), for opacity tracking More...
 
void setAlpha (const Sprite::Reference &rSprite, double alpha)
 
void move (const Sprite::Reference &rSprite, const css::geometry::RealPoint2D &aNewPos, const css::rendering::ViewState &viewState, const css::rendering::RenderState &renderState)
 
void transform (const Sprite::Reference &rSprite, const css::geometry::AffineMatrix2D &aTransformation)
 
void clip (const Sprite::Reference &rSprite, const css::uno::Reference< css::rendering::XPolyPolygon2D > &aClip)
 
void setPriority (const Sprite::Reference &rSprite, double nPriority)
 
void show (const Sprite::Reference &rSprite)
 
void hide (const Sprite::Reference &rSprite)
 
bool isAreaUpdateOpaque (const ::basegfx::B2DRange &rUpdateArea) const
 
const ::basegfx::B2DPointgetPosPixel () const
 
const ::basegfx::B2DVectorgetSizePixel () const
 
::basegfx::B2DRange getUpdateArea () const
 
double getPriority () const
 
::basegfx::B2DRange getUpdateArea (const ::basegfx::B2DRange &rUntransformedSpriteBounds) const
 Calc sprite update area from given raw sprite bounds. More...
 
bool isContentFullyOpaque () const
 Returns true, if sprite content bitmap is fully opaque. More...
 
bool hasTransformChanged () const
 Returns true, if transformation has changed since last transformUpdated() call. More...
 
double getAlpha () const
 Retrieve current alpha value. More...
 
const css::uno::Reference< css::rendering::XPolyPolygon2D > & getClip () const
 Retrieve current clip. More...
 
const ::basegfx::B2DHomMatrixgetTransformation () const
 
bool isActive () const
 Retrieve current activation state. More...
 

Private Member Functions

virtual ::basegfx::B2DPolyPolygon polyPolygonFromXPolyPolygon2D (css::uno::Reference< css::rendering::XPolyPolygon2D > &xPoly) const override
 Called to convert an API polygon to a basegfx polygon. More...
 

Private Attributes

BackBufferSharedPtr mpBackBuffer
 
BackBufferSharedPtr mpBackBufferMask
 
mutable::canvas::vcltools::VCLObject< BitmapExmaContent
 Cached bitmap for the current sprite content. More...
 
bool mbShowSpriteBounds
 When true, line sprite corners in red. More...
 

Additional Inherited Members

- Protected Member Functions inherited from canvas::CanvasCustomSpriteHelper
void transformUpdated () const
 Notifies that caller is again in sync with current transformation. More...
 

Detailed Description

Helper class for canvas sprites.

This class implements all sprite-related functionality, like that available on the XSprite interface.

Definition at line 45 of file spritehelper.hxx.

Constructor & Destructor Documentation

vclcanvas::SpriteHelper::SpriteHelper ( )

Definition at line 52 of file spritehelper.cxx.

Member Function Documentation

void vclcanvas::SpriteHelper::disposing ( )

Definition at line 76 of file spritehelper.cxx.

References mpBackBuffer, and mpBackBufferMask.

void vclcanvas::SpriteHelper::init ( const css::geometry::RealSize2D &  rSpriteSize,
const ::canvas::SpriteSurface::Reference rOwningSpriteCanvas,
const BackBufferSharedPtr rBackBuffer,
const BackBufferSharedPtr rBackBufferMask,
bool  bShowSpriteBounds 
)

Late-init the sprite helper.

Parameters
rSpriteSizeSize of the sprite
rSpriteCanvasSprite canvas this sprite is part of. Object stores ref-counted reference to it, thus, don't forget to pass on disposing()!
rBackBufferBuffer of the sprite content (non-alpha part)
rBackBufferMaskBuffer of the sprite content (alpha part)
virtual ::basegfx::B2DPolyPolygon vclcanvas::SpriteHelper::polyPolygonFromXPolyPolygon2D ( css::uno::Reference< css::rendering::XPolyPolygon2D > &  xPoly) const
overrideprivatevirtual

Called to convert an API polygon to a basegfx polygon.

Derive:
Needs to be provided by backend-specific code

Implements canvas::CanvasCustomSpriteHelper.

void vclcanvas::SpriteHelper::redraw ( OutputDevice rOutDev,
const ::basegfx::B2DPoint rPos,
bool &  bSurfacesDirty,
bool  bBufferedUpdate 
) const

Repaint sprite content to associated sprite canvas.

Parameters
rPosOutput position (sprite's own position is disregarded)
io_bSurfacesDirtyWhen true, the referenced sprite surfaces (backBuffer and backBufferMask) have been modified since last call.
bBufferedUpdateWhen true, the redraw does not happen directly on the front buffer, but within a VDev. Used to speed up drawing.

Definition at line 85 of file spritehelper.cxx.

References ALIGN_TOP, basegfx::unotools::b2DPolyPolygonFromXPolyPolygon2D(), canvas::tools::calcTransformedRectBounds(), COL_RED(), basegfx::B2DPolyPolygon::count(), OutputDevice::DrawBitmap(), OutputDevice::DrawBitmapEx(), OutputDevice::DrawPolyLine(), OutputDevice::DrawPolyPolygon(), OutputDevice::DrawText(), basegfx::fTools::equalZero(), BitmapFilter::Filter(), basegfx::fround(), basegfx::B2DHomMatrix::get(), canvas::CanvasCustomSpriteHelper::getAlpha(), BitmapEx::GetBitmap(), canvas::tools::getBoundMarksPolyPolygon(), canvas::CanvasCustomSpriteHelper::getClip(), basegfx::B2DRange::getMinX(), basegfx::B2DRange::getMinY(), canvas::CanvasCustomSpriteHelper::getPriority(), canvas::CanvasCustomSpriteHelper::getSizePixel(), canvas::CanvasCustomSpriteHelper::getTransformation(), canvas::CanvasCustomSpriteHelper::hasTransformChanged(), Size::Height(), i, canvas::CanvasCustomSpriteHelper::isActive(), canvas::CanvasCustomSpriteHelper::isContentFullyOpaque(), basegfx::B2DHomMatrix::isIdentity(), OpenGLHelper::isVCLOpenGLEnabled(), maContent, mbShowSpriteBounds, min, mpBackBuffer, mpBackBufferMask, vcl::unotools::pointFromB2DPoint(), OutputDevice::Pop(), OutputDevice::Push(), AlphaMask::Replace(), SAL_INFO, OutputDevice::SetClipRegion(), vcl::Font::SetColor(), OutputDevice::SetFillColor(), OutputDevice::SetFont(), vcl::Font::SetFontHeight(), Size::setHeight(), OutputDevice::SetLineColor(), OutputDevice::SetTextAlign(), OutputDevice::SetTextColor(), Size::setWidth(), Point::setX(), Point::setY(), vcl::unotools::sizeFromB2DSize(), text(), basegfx::B2DPolyPolygon::transform(), vclcanvas::tools::transformBitmap(), canvas::CanvasCustomSpriteHelper::transformUpdated(), basegfx::B2DHomMatrix::translate(), void(), Size::Width(), Point::X(), and Point::Y().

Member Data Documentation

mutable ::canvas::vcltools::VCLObject<BitmapEx> vclcanvas::SpriteHelper::maContent
private

Cached bitmap for the current sprite content.

Definition at line 105 of file spritehelper.hxx.

Referenced by redraw().

bool vclcanvas::SpriteHelper::mbShowSpriteBounds
private

When true, line sprite corners in red.

Definition at line 108 of file spritehelper.hxx.

Referenced by redraw().

BackBufferSharedPtr vclcanvas::SpriteHelper::mpBackBuffer
private

Definition at line 101 of file spritehelper.hxx.

Referenced by disposing(), and redraw().

BackBufferSharedPtr vclcanvas::SpriteHelper::mpBackBufferMask
private

Definition at line 102 of file spritehelper.hxx.

Referenced by disposing(), and redraw().


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