#include <GraphicObject.hxx>

Collaboration diagram for GraphicObject:

Public Member Functions
	GraphicObject ()

	GraphicObject (const Graphic &rGraphic)

	GraphicObject (const GraphicObject &rCacheObj)

	~GraphicObject ()

GraphicObject &	operator= (const GraphicObject &rCacheObj)

bool	operator== (const GraphicObject &rCacheObj) const

bool	operator!= (const GraphicObject &rCacheObj) const

const Graphic &	GetGraphic () const

void	SetGraphic (const Graphic &rGraphic)

Graphic	GetTransformedGraphic (const Size &rDestSize, const MapMode &rDestMap, const GraphicAttr &rAttr) const
	Get graphic transformed according to given attributes. More...

Graphic	GetTransformedGraphic (const GraphicAttr *pAttr) const

void	SetAttr (const GraphicAttr &rAttr)

const GraphicAttr &	GetAttr () const

bool	HasUserData () const

void	SetUserData ()

void	SetUserData (const OUString &rUserData)

const OUString &	GetUserData () const

OString	GetUniqueID () const

GraphicType	GetType () const

Size	GetPrefSize () const

MapMode	GetPrefMapMode () const

bool	IsTransparent () const

bool	IsAnimated () const

bool	IsEPS () const

bool	Draw (OutputDevice &rOut, const Point &rPt, const Size &rSz, const GraphicAttr *pAttr=nullptr) const

void	DrawTiled (OutputDevice &rOut, const tools::Rectangle &rArea, const Size &rSize, const Size &rOffset, int nTileCacheSize1D=128)
	Draw the graphic repeatedly into the given output rectangle. More...

bool	StartAnimation (OutputDevice &rOut, const Point &rPt, const Size &rSz, tools::Long nExtraData=0, OutputDevice *pFirstFrameOutDev=nullptr)

void	StopAnimation (const OutputDevice *pOut=nullptr, tools::Long nExtraData=0)

basegfx::B2DVector	calculateCropScaling (double fWidth, double fHeight, double fLeftCrop, double fTopCrop, double fRightCrop, double fBottomCrop) const

Static Public Member Functions
static bool	isGraphicObjectUniqueIdURL (std::u16string_view rURL)

Private Member Functions
bool VCL_DLLPRIVATE	ImplGetCropParams (const OutputDevice &rOut, Point &rPt, Size &rSz, const GraphicAttr *pAttr, tools::PolyPolygon &rClipPolyPoly, bool &bRectClipRegion) const

bool VCL_DLLPRIVATE	ImplRenderTempTile (VirtualDevice &rVDev, int nNumTilesX, int nNumTilesY, const Size &rTileSizePixel, const GraphicAttr *pAttr)
	Render a given number of tiles in an optimized way. More...

bool VCL_DLLPRIVATE	ImplRenderTileRecursive (VirtualDevice &rVDev, int nExponent, int nMSBFactor, int nNumOrigTilesX, int nNumOrigTilesY, int nRemainderTilesX, int nRemainderTilesY, const Size &rTileSizePixel, const GraphicAttr *pAttr, ImplTileInfo &rTileInfo)
	internally called by ImplRenderTempTile() More...

bool VCL_DLLPRIVATE	ImplDrawTiled (OutputDevice &rOut, const tools::Rectangle &rArea, const Size &rSizePixel, const Size &rOffset, const GraphicAttr *pAttr, int nTileCacheSize1D)

bool VCL_DLLPRIVATE	ImplDrawTiled (OutputDevice &rOut, const Point &rPos, int nNumTilesX, int nNumTilesY, const Size &rTileSize, const GraphicAttr *pAttr) const

void VCL_DLLPRIVATE	ImplTransformBitmap (BitmapEx &rBmpEx, const GraphicAttr &rAttr, const Size &rCropLeftTop, const Size &rCropRightBottom, const tools::Rectangle &rCropRect, const Size &rDstSize, bool bEnlarge) const

Private Attributes
Graphic	maGraphic

GraphicAttr	maAttr

OUString	maUserData

std::unique_ptr< GrfSimpleCacheObj >	mxSimpleCache

Friends
class	SdrGrafObj

Detailed Description

Definition at line 52 of file GraphicObject.hxx.

Constructor & Destructor Documentation

GraphicObject::GraphicObject ( )

Definition at line 299 of file GraphicObject.cxx.

Referenced by ImplRenderTileRecursive().

GraphicObject::GraphicObject ( const Graphic & rGraphic )

Definition at line 303 of file GraphicObject.cxx.

References maGraphic.

GraphicObject::GraphicObject ( const GraphicObject & rCacheObj )

Definition at line 308 of file GraphicObject.cxx.

References maGraphic, and maUserData.

GraphicObject::~GraphicObject ( )

Definition at line 315 of file GraphicObject.cxx.

Member Function Documentation

basegfx::B2DVector GraphicObject::calculateCropScaling	(	double	fWidth,
		double	fHeight,
		double	fLeftCrop,
		double	fTopCrop,
		double	fRightCrop,
		double	fBottomCrop
	)		const

Definition at line 895 of file GraphicObject.cxx.

References basegfx::fTools::equalZero(), Application::GetDefaultDevice(), GetMapUnit(), GetPrefMapMode(), GetPrefSize(), Size::Height(), OutputDevice::LogicToLogic(), OutputDevice::PixelToLogic(), and Size::Width().

bool GraphicObject::Draw	(	OutputDevice &	rOut,
		const Point &	rPt,
		const Size &	rSz,
		const GraphicAttr *	pAttr = `nullptr`
	)		const

void GraphicObject::DrawTiled	(	OutputDevice &	rOut,
		const tools::Rectangle &	rArea,
		const Size &	rSize,
		const Size &	rOffset,
		int	nTileCacheSize1D = `128`
	)

Draw the graphic repeatedly into the given output rectangle.

Parameters

pOut	OutputDevice where the rendering should take place
rArea	The output area that is filled with tiled instances of this graphic
rSize	The actual size of a single tile
rOffset	Offset from the left, top position of rArea, where to start the tiling. The upper left corner of the graphic tilings will virtually start at this position. Concretely, only that many tiles are drawn to completely fill the given output area.
nFlags	Optional rendering flags
nTileCacheSize1D	Optional dimension of the generated cache tiles. The pOut sees a number of tile draws, which have approximately nTileCacheSize1D times nTileCacheSize1D bitmap sizes if the tile bitmap is smaller. Otherwise, the tile is drawn as is. This is useful if e.g. you want only a few, very large bitmap drawings appear on the outdev.

Definition at line 522 of file GraphicObject.cxx.

References OutputDevice::GetMapMode(), Size::Height(), ImplDrawTiled(), Size::IsEmpty(), OutputDevice::LogicToPixel(), SAL_MAX_UINT16, and Size::Width().

const GraphicAttr& GraphicObject::GetAttr ( void ) const

inline

Definition at line 205 of file GraphicObject.hxx.

Referenced by Draw(), GetTransformedGraphic(), and StartAnimation().

const Graphic & GraphicObject::GetGraphic ( ) const

Definition at line 601 of file GraphicObject.cxx.

References maGraphic.

Referenced by GetTransformedGraphic(), GetUniqueID(), ImplDrawTiled(), operator=(), and StartAnimation().

MapMode GraphicObject::GetPrefMapMode ( ) const

Definition at line 329 of file GraphicObject.cxx.

References Graphic::GetPrefMapMode(), and maGraphic.

Referenced by calculateCropScaling().

Size GraphicObject::GetPrefSize ( ) const

Definition at line 324 of file GraphicObject.cxx.

References Graphic::GetPrefSize(), and maGraphic.

Referenced by calculateCropScaling().

Graphic GraphicObject::GetTransformedGraphic	(	const Size &	rDestSize,
		const MapMode &	rDestMap,
		const GraphicAttr &	rAttr
	)		const

Get graphic transformed according to given attributes.

This method returns a Graphic transformed, cropped and scaled to the given parameters, ready to be rendered to printer or display. The returned graphic has the same visual appearance as if it had been drawn via GraphicObject::Draw() to a specific output device.

Parameters

rDestSize	Desired output size in logical coordinates. The mapmode to interpret these logical coordinates in is given by the second parameter, rDestMap.
rDestMap	Mapmode the output should be interpreted in. This is used to interpret rDestSize, to set the appropriate PrefMapMode on the returned Graphic, and to deal correctly with metafile graphics.
rAttr	Graphic attributes used to transform the graphic. This includes cropping, rotation, mirroring, and various color adjustment parameters.

Returns: the readily transformed Graphic

Definition at line 611 of file GraphicObject.cxx.

References Size::AdjustWidth(), Bitmap, eType, basegfx::fround(), GdiMetafile, Graphic::GetAnimation(), Graphic::GetBitmapEx(), GraphicAttr::GetBottomCrop(), Application::GetDefaultDevice(), Graphic::GetGDIMetaFile(), GetGraphic(), GraphicAttr::GetLeftCrop(), Graphic::GetPrefMapMode(), Graphic::GetPrefSize(), GraphicAttr::GetRightCrop(), GraphicAttr::GetTopCrop(), GetTransformedGraphic(), GetType(), Size::Height(), ImplTransformBitmap(), Graphic::IsAnimated(), GraphicAttr::IsCropped(), OutputDevice::LogicToLogic(), OutputDevice::LogicToPixel(), AnimationBitmap::maPositionPixel, tools::Rectangle::Move(), Point, Size::setHeight(), Graphic::SetPrefMapMode(), Graphic::SetPrefSize(), Size::setWidth(), and Size::Width().

Referenced by GetTransformedGraphic(), and StartAnimation().

Graphic GraphicObject::GetTransformedGraphic ( const GraphicAttr * pAttr ) const

GraphicType GraphicObject::GetType ( ) const

Definition at line 319 of file GraphicObject.cxx.

References Graphic::GetType(), and maGraphic.

Referenced by GetTransformedGraphic(), ImplDrawTiled(), and ImplGetCropParams().

OString GraphicObject::GetUniqueID ( ) const

Definition at line 437 of file GraphicObject.cxx.

References GetGraphic(), and Graphic::getUniqueID().

const OUString& GraphicObject::GetUserData ( ) const

inline

Definition at line 210 of file GraphicObject.hxx.

bool GraphicObject::HasUserData ( ) const

inline

Definition at line 207 of file GraphicObject.hxx.

bool GraphicObject::ImplDrawTiled	(	OutputDevice &	rOut,
		const tools::Rectangle &	rArea,
		const Size &	rSizePixel,
		const Size &	rOffset,
		const GraphicAttr *	pAttr,
		int	nTileCacheSize1D
	)

private

bool GraphicObject::ImplDrawTiled	(	OutputDevice &	rOut,
		const Point &	rPos,
		int	nNumTilesX,
		int	nNumTilesY,
		const Size &	rTileSize,
		const GraphicAttr *	pAttr
	)		const

private

Definition at line 380 of file GraphicObject2.cxx.

References Bitmap, Draw(), OutputDevice::EnableMapMode(), OutputDevice::GetConnectMetaFile(), GetType(), Size::Height(), OutputDevice::IsMapModeEnabled(), OutputDevice::PixelToLogic(), Point, and Size::Width().

bool GraphicObject::ImplGetCropParams	(	const OutputDevice &	rOut,
		Point &	rPt,
		Size &	rSz,
		const GraphicAttr *	pAttr,
		tools::PolyPolygon &	rClipPolyPoly,
		bool &	bRectClipRegion
	)		const

private

bool GraphicObject::ImplRenderTempTile	(	VirtualDevice &	rVDev,
		int	nNumTilesX,
		int	nNumTilesY,
		const Size &	rTileSizePixel,
		const GraphicAttr *	pAttr
	)

private

Render a given number of tiles in an optimized way.

This method recursively subdivides the tile rendering problem in smaller parts, i.e. rendering output size x with few tiles of size y, which in turn are generated from the original bitmap in a recursive fashion. The subdivision size can be controlled by the exponent argument, which specifies the minimal number of smaller tiles used in one recursion step. The resulting tile size is given as the integer number of repetitions of the original bitmap along x and y. As the exponent need not necessarily divide these numbers without remainder, the repetition counts are effectively converted to base-exponent numbers, where each place denotes the number of times the corresponding tile size is rendered.

Parameters

rVDev	Virtual device to render everything into
nNumTilesX	Number of original tiles to generate in x direction
nNumTilesY	Number of original tiles to generate in y direction
rTileSizePixel	Size in pixel of the original tile bitmap to render it in
pAttr	Graphic attributes to be used for rendering
nFlags	Graphic flags to be used for rendering
rCurrPos	Current output point for this recursion level (should start with (0,0))

Returns: true, if everything was successfully rendered.

Definition at line 58 of file GraphicObject2.cxx.

References OutputDevice::EnableMapMode(), ImplRenderTileRecursive(), and OutputDevice::IsMapModeEnabled().

Referenced by ImplDrawTiled().

bool GraphicObject::ImplRenderTileRecursive	(	VirtualDevice &	rVDev,
		int	nExponent,
		int	nMSBFactor,
		int	nNumOrigTilesX,
		int	nNumOrigTilesY,
		int	nRemainderTilesX,
		int	nRemainderTilesY,
		const Size &	rTileSizePixel,
		const GraphicAttr *	pAttr,
		ImplTileInfo &	rTileInfo
	)

private

internally called by ImplRenderTempTile()

Definition at line 101 of file GraphicObject2.cxx.

References ImplTileInfo::aNextTileTopLeft, ImplTileInfo::aTileSizePixel, ImplTileInfo::aTileTopLeft, Draw(), OutputDevice::DrawEllipse(), OutputDevice::DrawRect(), OutputDevice::GetBitmap(), GraphicObject(), Size::Height(), ImplTileInfo::nTilesEmptyX, ImplTileInfo::nTilesEmptyY, Point, OutputDevice::SetFillColor(), OutputDevice::SetLineColor(), and Size::Width().

Referenced by ImplRenderTempTile().

void GraphicObject::ImplTransformBitmap	(	BitmapEx &	rBmpEx,
		const GraphicAttr &	rAttr,
		const Size &	rCropLeftTop,
		const Size &	rCropRightBottom,
		const tools::Rectangle &	rCropRect,
		const Size &	rDstSize,
		bool	bEnlarge
	)		const

private

Definition at line 428 of file GraphicObject2.cxx.

References ColorAlpha, BitmapEx::CopyPixel(), BitmapEx::Crop(), BitmapEx::Erase(), Bitmap::Erase(), BitmapEx::GetAlpha(), BitmapEx::GetBitmap(), Bitmap::GetGreyPalette(), GraphicAttr::GetRotation(), BitmapEx::GetSizePixel(), Size::Height(), BitmapEx::IsAlpha(), IsAnimated(), GraphicAttr::IsCropped(), vcl::N8_BPP, Point, BitmapEx::Scale(), and Size::Width().

Referenced by GetTransformedGraphic().

bool GraphicObject::IsAnimated ( ) const

Definition at line 339 of file GraphicObject.cxx.

References Graphic::IsAnimated(), and maGraphic.

Referenced by GetTransformedGraphic(), ImplTransformBitmap(), and StartAnimation().

bool GraphicObject::IsEPS ( ) const

Definition at line 344 of file GraphicObject.cxx.

References Graphic::IsEPS(), and maGraphic.

bool GraphicObject::isGraphicObjectUniqueIdURL ( std::u16string_view rURL )

static

Definition at line 888 of file GraphicObject.cxx.

References o3tl::starts_with(), and u.

Referenced by vcl::graphic::SearchForGraphics().

bool GraphicObject::IsTransparent ( ) const

Definition at line 334 of file GraphicObject.cxx.

References Graphic::IsTransparent(), and maGraphic.

Referenced by ImplDrawTiled().

bool GraphicObject::operator!= ( const GraphicObject & rCacheObj ) const

inline

Definition at line 167 of file GraphicObject.hxx.

GraphicObject & GraphicObject::operator= ( const GraphicObject & rCacheObj )

Definition at line 418 of file GraphicObject.cxx.

References GetGraphic(), maAttr, maGraphic, maUserData, and mxSimpleCache.

bool GraphicObject::operator== ( const GraphicObject & rCacheObj ) const

Definition at line 431 of file GraphicObject.cxx.

References maAttr, and maGraphic.

void GraphicObject::SetAttr ( const GraphicAttr & rAttr )

Definition at line 442 of file GraphicObject.cxx.

References maAttr, and mxSimpleCache.

void GraphicObject::SetGraphic ( const Graphic & rGraphic )

Definition at line 606 of file GraphicObject.cxx.

References maGraphic.

Referenced by ImplDrawTiled().

void GraphicObject::SetUserData ( )

Definition at line 450 of file GraphicObject.cxx.

References maUserData.

void GraphicObject::SetUserData ( const OUString & rUserData )

Definition at line 455 of file GraphicObject.cxx.

References maUserData.

bool GraphicObject::StartAnimation	(	OutputDevice &	rOut,
		const Point &	rPt,
		const Size &	rSz,
		tools::Long	nExtraData = `0`,
		OutputDevice *	pFirstFrameOutDev = `nullptr`
	)