#include <bitmap.hxx>

Inheritance diagram for Bitmap:

Collaboration diagram for Bitmap:

Public Types
typedef vcl::ScopedBitmapAccess< BitmapReadAccess, Bitmap,&Bitmap::AcquireReadAccess >	ScopedReadAccess

typedef vcl::ScopedBitmapAccess< BitmapInfoAccess, Bitmap,&Bitmap::AcquireInfoAccess >	ScopedInfoAccess

Public Member Functions
	Bitmap ()

	Bitmap (const Bitmap &rBitmap)

	Bitmap (const Size &rSizePixel, sal_uInt16 nBitCount, const BitmapPalette *pPal=nullptr)

	Bitmap (std::shared_ptr< SalBitmap > const &xSalBitmap)

virtual	~Bitmap ()

Bitmap &	operator= (const Bitmap &rBitmap)

Bitmap &	operator= (Bitmap &&rBitmap) noexcept

bool	operator! () const

bool	operator== (const Bitmap &rBitmap) const

bool	operator!= (const Bitmap &rBitmap) const

bool	IsEmpty () const

void	SetEmpty ()

const MapMode &	GetPrefMapMode () const

void	SetPrefMapMode (const MapMode &rMapMode)

const Size &	GetPrefSize () const

void	SetPrefSize (const Size &rSize)

Size	GetSizePixel () const

sal_uInt16	GetBitCount () const

sal_Int64	GetColorCount () const

sal_uLong	GetSizeBytes () const

bool	HasGreyPalette8Bit () const

bool	HasGreyPaletteAny () const

bool	GetSystemData (BitmapSystemData &rData) const
	get system dependent bitmap data More...

BitmapChecksum	GetChecksum () const

Bitmap	CreateDisplayBitmap (OutputDevice *pDisplay) const

bool	Convert (BmpConversion eConversion)
	Convert bitmap format. More...

bool	Dither ()
	Apply a Floyd dither algorithm to the bitmap. More...

bool	Crop (const tools::Rectangle &rRectPixel)
	Crop the bitmap. More...

bool	Expand (sal_uLong nDX, sal_uLong nDY, const Color *pInitColor=nullptr)
	Expand the bitmap by pixel padding. More...

bool	CopyPixel (const tools::Rectangle &rRectDst, const tools::Rectangle &rRectSrc, const Bitmap *pBmpSrc=nullptr)
	Copy a rectangular area from another bitmap. More...

bool	CopyPixel_AlphaOptimized (const tools::Rectangle &rRectDst, const tools::Rectangle &rRectSrc, const Bitmap *pBmpSrc)

bool	CombineSimple (const Bitmap &rMask, BmpCombine eCombine)
	Perform boolean operations with another bitmap. More...

bool	Blend (const AlphaMask &rAlpha, const Color &rBackgroundColor)
	Alpha-blend the given bitmap against a specified uniform background color. More...

bool	Erase (const Color &rFillColor)
	Fill the entire bitmap with the given color. More...

bool	Invert ()
	Perform the Invert operation on every pixel. More...

bool	Mirror (BmpMirrorFlags nMirrorFlags)
	Mirror the bitmap. More...

bool	Scale (const Size &rNewSize, BmpScaleFlag nScaleFlag=BmpScaleFlag::Default)
	Scale the bitmap. More...

bool	Scale (const double &rScaleX, const double &rScaleY, BmpScaleFlag nScaleFlag=BmpScaleFlag::Default)
	Scale the bitmap. More...

void	AdaptBitCount (Bitmap &rNew) const

bool	Rotate (Degree10 nAngle10, const Color &rFillColor)
	Rotate bitmap by the specified angle. More...

Bitmap	CreateMask (const Color &rTransColor, sal_uInt8 nTol=0) const
	Create on-off mask from bitmap. More...

vcl::Region	CreateRegion (const Color &rColor, const tools::Rectangle &rRect) const
	Create region of similar colors in a given rectangle. More...

bool	Replace (const Bitmap &rMask, const Color &rReplaceColor)
	Replace all pixel where the given mask is on with the specified color. More...

bool	Replace (const AlphaMask &rAlpha, const Color &rMergeColor)
	Merge bitmap with given background color according to specified alpha mask. More...

bool	Replace (const Color &rSearchColor, const Color &rReplaceColor, sal_uInt8 nTol=0)
	Replace all pixel having the search color with the specified color. More...

bool	Replace (const Color pSearchColors, const Color rReplaceColors, size_t nColorCount, sal_uInt8 const *pTols)
	Replace all pixel having one the search colors with the corresponding replace color. More...

void	Vectorize (GDIMetaFile &rMtf, sal_uInt8 cReduce, const Link< tools::Long, void > *pProgress)
	Convert the bitmap to a meta file. More...

bool	Adjust (short nLuminancePercent, short nContrastPercent=0, short nChannelRPercent=0, short nChannelGPercent=0, short nChannelBPercent=0, double fGamma=1.0, bool bInvert=false, bool msoBrightness=false)
	Change various global color characteristics. More...

SAL_DLLPRIVATE void	ReassignWithSize (const Bitmap &rBitmap)
	ReassignWithSize and recalculate bitmap. More...

SAL_DLLPRIVATE void	ImplMakeUnique ()

const std::shared_ptr< SalBitmap > &	ImplGetSalBitmap () const

SAL_DLLPRIVATE void	ImplSetSalBitmap (const std::shared_ptr< SalBitmap > &xImpBmp)

SAL_DLLPRIVATE bool	ImplMakeGreyscales (sal_uInt16 nGreyscales)

BitmapInfoAccess *	AcquireInfoAccess ()

BitmapReadAccess *	AcquireReadAccess ()

BitmapWriteAccess *	AcquireWriteAccess ()

Static Public Member Functions
static const BitmapPalette &	GetGreyPalette (int nEntries)

static bool	HasFastScale ()
	Returns true if bitmap scaling is considered to be fast. More...

static void	ReleaseAccess (BitmapInfoAccess *pAccess)

Private Member Functions
SAL_DLLPRIVATE bool	ImplConvertUp (sal_uInt16 nBitCount, Color const *pExtColor=nullptr)

SAL_DLLPRIVATE bool	ImplConvertDown (sal_uInt16 nBitCount, Color const *pExtColor=nullptr)

Private Attributes
std::shared_ptr< SalBitmap >	mxSalBmp

MapMode	maPrefMapMode

Size	maPrefSize

Detailed Description

Definition at line 111 of file bitmap.hxx.

Member Typedef Documentation

typedef vcl::ScopedBitmapAccess<BitmapInfoAccess, Bitmap, &Bitmap::AcquireInfoAccess> Bitmap::ScopedInfoAccess

Definition at line 538 of file bitmap.hxx.

typedef vcl::ScopedBitmapAccess<BitmapReadAccess, Bitmap, &Bitmap::AcquireReadAccess> Bitmap::ScopedReadAccess

Definition at line 537 of file bitmap.hxx.

Constructor & Destructor Documentation

Bitmap::Bitmap ( )

Definition at line 59 of file bitmap/bitmap.cxx.

Referenced by CreateMask().

Bitmap::Bitmap ( const Bitmap & rBitmap )

Definition at line 63 of file bitmap/bitmap.cxx.

Bitmap::Bitmap	(	const Size &	rSizePixel,
		sal_uInt16	nBitCount,
		const BitmapPalette *	pPal = `nullptr`
	)

Definition at line 77 of file bitmap/bitmap.cxx.

References COL_BLACK, COL_BLUE(), COL_BROWN, COL_CYAN(), COL_GRAY, COL_GREEN(), COL_LIGHTBLUE, COL_LIGHTCYAN, COL_LIGHTGRAY(), COL_LIGHTGREEN, COL_LIGHTMAGENTA, COL_LIGHTRED, COL_MAGENTA(), COL_RED(), COL_WHITE, COL_YELLOW, SalInstance::CreateSalBitmap(), Size::Height(), ImplGetSVData(), ImplSVData::mpDefInst, mxSalBmp, BitmapPalette::SetEntryCount(), and Size::Width().

Bitmap::Bitmap ( std::shared_ptr< SalBitmap > const & xSalBitmap )

explicit

Definition at line 70 of file bitmap/bitmap.cxx.

References MapPixel.

Bitmap::~Bitmap ( )

virtual

Definition at line 152 of file bitmap/bitmap.cxx.

Member Function Documentation

BitmapInfoAccess * Bitmap::AcquireInfoAccess ( )

Definition at line 436 of file bitmap/bitmap.cxx.

BitmapReadAccess * Bitmap::AcquireReadAccess ( )

Definition at line 448 of file bitmap/bitmap.cxx.

Referenced by AlphaMask::AcquireAlphaReadAccess(), vcl::bitmap::CanvasCairoExtractBitmapData(), and BitmapEx::GetContour().

BitmapWriteAccess * Bitmap::AcquireWriteAccess ( )

Definition at line 460 of file bitmap/bitmap.cxx.

Referenced by AlphaMask::AcquireAlphaWriteAccess(), and ReadRawDIB().

void Bitmap::AdaptBitCount ( Bitmap & rNew ) const

Definition at line 1505 of file bitmap/bitmap.cxx.

References Convert(), GetBitCount(), HasGreyPaletteAny(), N1BitThreshold, N24Bit, N32Bit, N4BitColors, N4BitGreys, N8BitColors, N8BitGreys, and SAL_WARN.

Referenced by BitmapInterpolateScaleFilter::execute().

bool Bitmap::Adjust	(	short	nLuminancePercent,
		short	nContrastPercent = `0`,
		short	nChannelRPercent = `0`,
		short	nChannelGPercent = `0`,
		short	nChannelBPercent = `0`,
		double	fGamma = `1.0`,
		bool	bInvert = `false`,
		bool	msoBrightness = `false`
	)

Change various global color characteristics.

Parameters

nLuminancePercent	Percent of luminance change, valid range [-100,100]. Values outside this range are clipped to the valid range.
nContrastPercent	Percent of contrast change, valid range [-100,100]. Values outside this range are clipped to the valid range.
nChannelRPercent	Percent of red channel change, valid range [-100,100]. Values outside this range are clipped to the valid range.
nChannelGPercent	Percent of green channel change, valid range [-100,100]. Values outside this range are clipped to the valid range.
nChannelBPercent	Percent of blue channel change, valid range [-100,100]. Values outside this range are clipped to the valid range.
fGamma	Exponent of the gamma function applied to the bitmap. The value 1.0 results in no change, the valid range is (0.0,10.0]. Values outside this range are regarded as 1.0.
bInvert	If true, invert the channel values with the logical 'not' operator
msoBrightness	Use the same formula for brightness as used by MSOffice.

Returns: true, if the operation was completed successfully.

Definition at line 1665 of file bitmap/bitmap.cxx.

References FRound(), GAMMA, Color::GetBlue(), Color::GetGreen(), BitmapInfoAccess::GetPaletteColor(), BitmapInfoAccess::GetPaletteEntryCount(), BitmapReadAccess::GetPixelFromData(), Color::GetRed(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::GetScanlineFormat(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), i, MinMax(), N24BitTcBgr, N24BitTcRgb, nCount, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), Color::SetBlue(), Color::SetGreen(), BitmapWriteAccess::SetPaletteColor(), BitmapReadAccess::SetPixelOnData(), Color::SetRed(), and BitmapInfoAccess::Width().

Referenced by BitmapEx::Adjust(), and Image::Draw().

bool Bitmap::Blend	(	const AlphaMask &	rAlpha,
		const Color &	rBackgroundColor
	)

Alpha-blend the given bitmap against a specified uniform background color.

Attention:: This method might convert paletted bitmaps to truecolor, to be able to represent every necessary color. Note that during alpha blending, lots of colors not originally included in the bitmap can be generated.

Parameters

rAlpha	Alpha mask to blend with
rBackgroundColor	Background color to use for every pixel during alpha blending

Returns: true, if blending was successful, false otherwise

Definition at line 1090 of file bitmappaint.cxx.

References Convert(), GetBitCount(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::Height(), Color::Merge(), N24Bit, BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by Printer::DrawDeviceBitmap().

bool Bitmap::CombineSimple	(	const Bitmap &	rMask,
		BmpCombine	eCombine
	)

Perform boolean operations with another bitmap.

Parameters

rMask	The mask bitmap in the selected combine operation
eCombine	The combine operation to perform on the bitmap

Returns: true, if the operation was completed successfully.

Definition at line 1020 of file bitmappaint.cxx.

References And, COL_BLACK, COL_WHITE, BitmapInfoAccess::GetBestMatchingColor(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::Height(), Or, BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by unographic::GraphicTransformer::colorChange(), BitmapEx::CombineMaskOr(), and vcl::bitmap::DrawAndClipBitmap().

bool Bitmap::Convert ( BmpConversion eConversion )

Convert bitmap format.

Parameters

eConversion The format this bitmap should be converted to.

Returns: true the conversion was completed successfully.

Definition at line 944 of file bitmap/bitmap.cxx.

References BMP_COL_TRANS, BitmapFilter::Filter(), GetBitCount(), BitmapEx::GetBitmap(), ImplConvertDown(), ImplConvertUp(), ImplGetSVData(), ImplMakeGreyscales(), ImplSetSalBitmap(), mxSalBmp, N1BitThreshold, N24Bit, N32Bit, N4BitColors, N4BitGreys, N8BitColors, N8BitGreys, N8BitNoConversion, N8BitTrans, nBitCount, and SAL_INFO.

Referenced by AdaptBitCount(), AlphaMask::AlphaMask(), Blend(), BitmapEx::Convert(), CopyPixel(), DetectEdges(), OutputDevice::DrawBitmap(), Printer::DrawDeviceMask(), BitmapPopArtFilter::execute(), OutputDevice::GetBitmapEx(), Printer::ImplPrintTransparent(), AlphaMask::operator=(), AlphaMask::ReleaseAccess(), Replace(), JPEGWriter::Write(), and vcl::PDFWriterImpl::writeBitmapObject().

bool Bitmap::CopyPixel	(	const tools::Rectangle &	rRectDst,
		const tools::Rectangle &	rRectSrc,
		const Bitmap *	pBmpSrc = `nullptr`
	)

Copy a rectangular area from another bitmap.

Parameters

rRectDst	Destination rectangle in this bitmap. This is clipped to the bitmap dimensions.
rRectSrc	Source rectangle in pBmpSrc. This is clipped to the source bitmap dimensions. Note further that no scaling takes place during this copy operation, i.e. only the minimum of source and destination rectangle's width and height are used.
pBmpSrc	The source bitmap to copy from. If this argument is NULL, or equal to the object this method is called on, copying takes place within the same bitmap.

Returns: true, if the operation completed successfully. false is not only returned when the operation failed, but also if nothing had to be done, e.g. because one of the rectangles are empty.

Definition at line 524 of file bitmap/bitmap.cxx.

References Convert(), BitmapInfoAccess::GetBestPaletteIndex(), GetBitCount(), tools::Rectangle::GetHeight(), BitmapReadAccess::GetIndexFromData(), BitmapInfoAccess::GetPaletteColor(), BitmapInfoAccess::GetPaletteEntryCount(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), GetSizePixel(), tools::Rectangle::GetWidth(), BitmapInfoAccess::HasPalette(), i, tools::Rectangle::Intersection(), tools::Rectangle::IsEmpty(), tools::Rectangle::Left(), mxSalBmp, N24Bit, N4BitColors, N8BitColors, nCount, Point, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapWriteAccess::SetPaletteColor(), BitmapReadAccess::SetPixelOnData(), and tools::Rectangle::Top().

Referenced by BitmapEx::CopyPixel().

bool Bitmap::CopyPixel_AlphaOptimized	(	const tools::Rectangle &	rRectDst,
		const tools::Rectangle &	rRectSrc,
		const Bitmap *	pBmpSrc
	)

Definition at line 729 of file bitmap/bitmap.cxx.

References tools::Rectangle::GetHeight(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), GetSizePixel(), tools::Rectangle::GetWidth(), tools::Rectangle::Intersection(), tools::Rectangle::IsEmpty(), tools::Rectangle::Left(), mxSalBmp, Point, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), and tools::Rectangle::Top().

Referenced by BitmapEx::CopyPixel().

Bitmap Bitmap::CreateDisplayBitmap ( OutputDevice * pDisplay ) const

Definition at line 922 of file bitmap/bitmap.cxx.

References OutputDevice::GetGraphics(), ImplGetSVData(), ImplSetSalBitmap(), and mxSalBmp.

Referenced by OutputDevice::DrawBitmapWallpaper().

Bitmap Bitmap::CreateMask	(	const Color &	rTransColor,
		sal_uInt8	nTol = `0`
	)		const

Create on-off mask from bitmap.

This method creates a bitmask from the bitmap, where every pixel that equals rTransColor is set transparent, the rest opaque.

Parameters

rTransColor	Color value where the bitmask should be transparent
nTol	Tolerance value. Specifies the maximal difference between rTransColor and the individual pixel values, such that the corresponding pixel is still regarded as transparent.

Returns: the resulting bitmask.

Definition at line 367 of file bitmappaint.cxx.

References assert(), Bitmap(), COL_BLACK, COL_WHITE, BitmapInfoAccess::GetBestMatchingColor(), BitmapInfoAccess::GetBitCount(), Color::GetBlue(), Color::GetGreen(), GetGreyPalette(), BitmapColor::GetIndex(), BitmapReadAccess::GetIndexFromData(), BitmapInfoAccess::GetPaletteColor(), BitmapReadAccess::GetPixelFromData(), Color::GetRed(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::GetScanlineFormat(), BitmapInfoAccess::GetScanlineSize(), GetSizePixel(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), maPrefMapMode, maPrefSize, N1BitLsbPal, N1BitMsbPal, N4BitLsnPal, N4BitMsnPal, N8BitPal, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by BitmapEx::BitmapEx(), BitmapEx::CombineMaskOr(), vcl::bitmap::DrawAlphaBitmapAndAlphaGradient(), OutputDevice::DrawDeviceMask(), BitmapEx::GetBitmap(), and OutputDevice::SetBackground().

vcl::Region Bitmap::CreateRegion	(	const Color &	rColor,
		const tools::Rectangle &	rRect
	)		const

Create region of similar colors in a given rectangle.

Parameters

rColor	All pixel which have this color are included in the calculated region
rRect	The rectangle within which matching pixel are looked for. This rectangle is always clipped to the bitmap dimensions.

Returns: the generated region.

Definition at line 618 of file bitmappaint.cxx.

References a, tools::Rectangle::Bottom(), BitmapInfoAccess::GetBestMatchingColor(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), GetSizePixel(), tools::Rectangle::Intersection(), tools::Rectangle::Justify(), tools::Rectangle::Left(), Point, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), tools::Rectangle::Right(), tools::Rectangle::SetBottom(), tools::Rectangle::SetLeft(), tools::Rectangle::SetRight(), tools::Rectangle::SetTop(), tools::Rectangle::Top(), and vcl::Region::Union().

Referenced by Printer::DrawDeviceMask(), Printer::ImplPrintTransparent(), and ImplWheelWindow::ImplSetRegion().

bool Bitmap::Crop ( const tools::Rectangle & rRectPixel )

Crop the bitmap.

Parameters

rRectPixel A rectangle specifying the crop amounts on all four sides of the bitmap. If the upper left corner of the bitmap is assigned (0,0), then this method cuts out the given rectangle from the bitmap. Note that the rectangle is clipped to the bitmap's dimension, i.e. negative left,top rectangle coordinates or exceeding width or height is ignored.

Returns: true cropping was performed successfully. If nothing had to be cropped, because e.g. the crop rectangle included the bitmap, false is returned, too!

Definition at line 477 of file bitmap/bitmap.cxx.

References GetBitCount(), BitmapInfoAccess::GetPalette(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), tools::Rectangle::GetSize(), GetSizePixel(), tools::Rectangle::Intersection(), tools::Rectangle::IsEmpty(), tools::Rectangle::Left(), Point, ReassignWithSize(), vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), and tools::Rectangle::Top().

Referenced by clipMetafileContentAgainstOwnRegions(), BitmapEx::Crop(), Printer::DrawDeviceMask(), OutputDevice::GetDownsampledBitmap(), and Printer::ImplPrintTransparent().

bool Bitmap::Dither ( )

Apply a Floyd dither algorithm to the bitmap.

This method dithers the bitmap inplace, i.e. a true color bitmap is converted to a paletted bitmap, reducing the color deviation by error diffusion.

Definition at line 1576 of file bitmap/bitmap.cxx.

References aMap, CALC_ERRORS, CALC_TABLES3, CALC_TABLES5, CALC_TABLES7, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::get(), getColor(), BitmapReadAccess::GetScanline(), GetSizePixel(), Size::Height(), BitmapInfoAccess::Height(), maPrefMapMode, maPrefSize, nVCLBLut, nVCLGLut, nVCLRLut, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), shiftColor(), Size::Width(), and BitmapInfoAccess::Width().

bool Bitmap::Erase ( const Color & rFillColor )

Fill the entire bitmap with the given color.

Parameters

rFillColor Color value to use for filling

Returns: true, if the operation was completed successfully.

Definition at line 34 of file bitmappaint.cxx.

References BitmapWriteAccess::Erase(), ImplGetSVData(), ImplSetSalBitmap(), IsEmpty(), maPrefMapMode, maPrefSize, and mxSalBmp.

Referenced by AlphaMask::AlphaMask(), BitmapEx::CopyPixel(), createBlendFrame(), OutputDevice::DrawBitmapEx(), OutputDevice::DrawTransformBitmapExDirect(), AlphaMask::Erase(), BitmapEx::Erase(), GDIMetaFile::ImplBmpMonoFnc(), Printer::ImplPrintTransparent(), GraphicObject::ImplTransformBitmap(), BitmapEx::ModifyBitmapEx(), and BitmapEx::Rotate().

bool Bitmap::Expand	(	sal_uLong	nDX,
		sal_uLong	nDY,
		const Color *	pInitColor = `nullptr`
	)

Expand the bitmap by pixel padding.

Parameters

nDX	Number of pixel to pad at the right border of the bitmap
nDY	Number of scanlines to pad at the bottom border of the bitmap
pInitColor	Color to use for padded pixel

Returns: true, if padding was performed successfully. false is not only returned when the operation failed, but also if nothing had to be done, e.g. because nDX and nDY were zero.

Definition at line 857 of file bitmap/bitmap.cxx.

References BitmapWriteAccess::CopyScanline(), BitmapInfoAccess::GetBestMatchingColor(), GetBitCount(), BitmapInfoAccess::GetPalette(), BitmapReadAccess::GetScanline(), GetSizePixel(), Size::Height(), BitmapInfoAccess::Height(), ReassignWithSize(), vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), Size::Width(), and BitmapInfoAccess::Width().

Referenced by BitmapEx::Expand().

sal_uInt16 Bitmap::GetBitCount ( ) const

Definition at line 323 of file bitmap/bitmap.cxx.

References mxSalBmp, and nBitCount.

Referenced by AdaptBitCount(), BitmapEx::BitmapEx(), BitmapInfoAccess::BitmapInfoAccess(), Blend(), Convert(), CopyPixel(), vcl::PDFWriterImpl::createBitmapEmit(), Crop(), Printer::DrawDeviceMask(), OutputDevice::EmulateDrawTransparent(), BitmapScaleSuperFilter::execute(), Expand(), GetChecksum(), GetColorCount(), BitmapEx::GetPixelColor(), GetSizeBytes(), BitmapEx::GetTransparency(), HasGreyPaletteAny(), ImplConvertDown(), ImplConvertUp(), Printer::ImplPrintTransparent(), AlphaMask::ImplSetBitmap(), vcl::PDFWriterImpl::implWriteBitmapEx(), BitmapEx::ModifyBitmapEx(), vcl::PNGWriterImpl::PNGWriterImpl(), ReadDIBBitmapEx(), Replace(), Rotate(), Scale(), vcl::PDFWriterImpl::writeBitmapObject(), vcl::PDFWriterImpl::writeJPG(), and MetafileXmlDump::writeXml().

BitmapChecksum Bitmap::GetChecksum ( ) const

Definition at line 370 of file bitmap/bitmap.cxx.

References GetBitCount(), ImplGetSVData(), and mxSalBmp.

Referenced by vcl::PDFWriterImpl::createBitmapEmit(), vcl::PDFWriterImpl::drawJPGBitmap(), BitmapEx::GetChecksum(), and GDIMetaFile::GetChecksum().

sal_Int64 Bitmap::GetColorCount ( ) const

inline

Definition at line 581 of file bitmap.hxx.

References GetBitCount().

Referenced by BitmapColorQuantizationFilter::execute(), and BitmapSimpleColorQuantizationFilter::execute().

const BitmapPalette & Bitmap::GetGreyPalette ( int nEntries )

static

Definition at line 168 of file bitmap/bitmap.cxx.

References i.

Referenced by vcl::unotools::bitmapExFromXBitmap(), CreateMask(), BitmapDisabledImageFilter::execute(), ImplMakeGreyscales(), and BitmapPalette::IsGreyPaletteAny().

const MapMode & Bitmap::GetPrefMapMode ( ) const

inline

Definition at line 561 of file bitmap.hxx.

References maPrefMapMode.

Referenced by clipMetafileContentAgainstOwnRegions(), DetectEdges(), BitmapSimpleColorQuantizationFilter::execute(), BitmapColorQuantizationFilter::execute(), and BitmapMonochromeFilter::execute().

const Size & Bitmap::GetPrefSize ( ) const

inline

Definition at line 571 of file bitmap.hxx.

References maPrefSize.

Referenced by clipMetafileContentAgainstOwnRegions(), DetectEdges(), BitmapSimpleColorQuantizationFilter::execute(), BitmapColorQuantizationFilter::execute(), BitmapMonochromeFilter::execute(), and BitmapEx::GetContour().

sal_uLong Bitmap::GetSizeBytes ( ) const

inline

Definition at line 586 of file bitmap.hxx.

References GetBitCount(), GetSizePixel(), Size::Height(), and Size::Width().

Referenced by BitmapEx::GetSizeBytes().

Size Bitmap::GetSizePixel ( ) const

Definition at line 318 of file bitmap/bitmap.cxx.

References mxSalBmp.

Referenced by BitmapEx::BitmapEx(), OutputDevice::BlendBitmap(), OutputDevice::BlendBitmapWithAlpha(), BitmapGaussianSeparableBlurFilter::convolutionPass(), CopyPixel(), CopyPixel_AlphaOptimized(), CreateMask(), CreateRegion(), BitmapEx::Crop(), Crop(), DetectEdges(), Dither(), OutputDevice::DrawBitmap(), OutputDevice::DrawDeviceAlphaBitmap(), OutputDevice::DrawDeviceAlphaBitmapSlowPath(), Printer::DrawDeviceMask(), vcl::PDFWriterImpl::drawJPGBitmap(), OutputDevice::DrawMask(), BitmapWriteAccess::Erase(), BitmapDuoToneFilter::execute(), BitmapSeparableUnsharpenFilter::execute(), BitmapSimpleColorQuantizationFilter::execute(), BitmapColorQuantizationFilter::execute(), BitmapScaleSuperFilter::execute(), BitmapGaussianSeparableBlurFilter::execute(), BitmapMonochromeFilter::execute(), BitmapEx::Expand(), Expand(), BitmapWriteAccess::FillRect(), GDIMetaFile::GetBoundRect(), BitmapEx::GetContour(), OutputDevice::GetDownsampledBitmap(), vcl::unotools::VclCanvasBitmap::getSize(), GetSizeBytes(), ImplConvertDown(), ImplConvertUp(), ImplMakeGreyscales(), Printer::ImplPrintTransparent(), ImplWheelWindow::ImplSetRegion(), EMFWriter::ImplWrite(), EMFWriter::ImplWriteBmpRecord(), BitmapEx::ModifyBitmapEx(), ReassignWithSize(), Replace(), BitmapEx::ReplaceTransparency(), BitmapEx::Rotate(), Rotate(), BitmapEx::Scale(), Scale(), vcl::unotools::VclCanvasBitmap::VclCanvasBitmap(), WMFWriter::WMFRecord_StretchDIB(), vcl::PDFWriterImpl::writeBitmapObject(), vcl::PDFWriterImpl::writeGradientFunction(), and WMFWriter::WriteRecords().

bool Bitmap::GetSystemData ( BitmapSystemData & rData ) const

get system dependent bitmap data

Parameters

rData The system dependent BitmapSystemData structure to be filled

Returns: true if the bitmap has a valid system object (e.g. not empty)

Definition at line 938 of file bitmap/bitmap.cxx.

References mxSalBmp.

bool Bitmap::HasFastScale ( )

static

Returns true if bitmap scaling is considered to be fast.

Currently this returns true if OpenGL is used for scaling, otherwise false (CPU scaling is slower).

Available since:: 4.5

Definition at line 1496 of file bitmap/bitmap.cxx.

References SkiaHelper::isVCLSkiaEnabled().

bool Bitmap::HasGreyPalette8Bit ( ) const

Definition at line 357 of file bitmap/bitmap.cxx.

Referenced by BitmapEx::BitmapEx(), AlphaMask::ImplSetBitmap(), ReadDIBBitmapEx(), and JPEGWriter::Write().

bool Bitmap::HasGreyPaletteAny ( ) const

Definition at line 342 of file bitmap/bitmap.cxx.

References GetBitCount(), and nBitCount.

Referenced by AdaptBitCount(), and vcl::PDFWriterImpl::writeBitmapObject().

bool Bitmap::ImplConvertDown	(	sal_uInt16	nBitCount,
		Color const *	pExtColor = `nullptr`
	)

private

Definition at line 1261 of file bitmap/bitmap.cxx.

References aMap, assert(), COL_BLACK, COL_WHITE, InverseColorMap::GetBestPaletteIndex(), GetBitCount(), BitmapPalette::GetEntryCount(), BitmapReadAccess::GetIndexFromData(), Octree::GetPalette(), BitmapInfoAccess::GetPaletteColor(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), GetSizePixel(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), ImpErrorQuad::ImplAddColorError1(), ImpErrorQuad::ImplAddColorError3(), ImpErrorQuad::ImplAddColorError5(), ImpErrorQuad::ImplAddColorError7(), ImpErrorQuad::ImplGetColor(), maPrefMapMode, maPrefSize, nCount, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), SAL_WARN_IF, BitmapPalette::SetEntryCount(), BitmapWriteAccess::SetPalette(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by Convert().

bool Bitmap::ImplConvertUp	(	sal_uInt16	nBitCount,
		Color const *	pExtColor = `nullptr`
	)

private

Definition at line 1172 of file bitmap/bitmap.cxx.

References aMap, assert(), GetBitCount(), BitmapPalette::GetEntryCount(), BitmapReadAccess::GetIndexFromData(), BitmapInfoAccess::GetPalette(), BitmapInfoAccess::GetPaletteColor(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), GetSizePixel(), BitmapInfoAccess::HasPalette(), i, maPrefMapMode, maPrefSize, SAL_WARN_IF, and BitmapPalette::SetEntryCount().

Referenced by Convert().

const std::shared_ptr<SalBitmap>& Bitmap::ImplGetSalBitmap ( ) const

inline

Definition at line 525 of file bitmap.hxx.

Referenced by BitmapInfoAccess::BitmapInfoAccess(), BitmapReadAccess::BitmapReadAccess(), OutputDevice::BlendBitmap(), AlphaMask::BlendWith(), OutputDevice::DrawBitmap(), OutputDevice::DrawDeviceAlphaBitmap(), OutputDevice::DrawDeviceAlphaBitmapSlowPath(), OutputDevice::DrawDeviceMask(), OutputDevice::DrawTransformBitmapExDirect(), and BitmapInfoAccess::~BitmapInfoAccess().

bool Bitmap::ImplMakeGreyscales ( sal_uInt16 nGreyscales )

void Bitmap::ImplMakeUnique ( )

Definition at line 397 of file bitmap/bitmap.cxx.

References SalInstance::CreateSalBitmap(), ImplGetSVData(), ImplSVData::mpDefInst, mxSalBmp, and void().

Referenced by BitmapInfoAccess::BitmapInfoAccess().

void Bitmap::ImplSetSalBitmap ( const std::shared_ptr< SalBitmap > & xImpBmp )

Definition at line 431 of file bitmap/bitmap.cxx.

References mxSalBmp.

Referenced by BitmapInfoAccess::BitmapInfoAccess(), AlphaMask::BlendWith(), Convert(), CreateDisplayBitmap(), Erase(), OutputDevice::GetBitmap(), Replace(), and Scale().

bool Bitmap::Invert ( )

Perform the Invert operation on every pixel.

Returns: true, if the operation was completed successfully.

Definition at line 64 of file bitmappaint.cxx.

References BitmapInfoAccess::GetPalette(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), i, Color::Invert(), mxSalBmp, nCount, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapWriteAccess::SetPalette(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by BitmapEx::Invert().

bool Bitmap::IsEmpty ( ) const

inline

Definition at line 556 of file bitmap.hxx.

References mxSalBmp.

Referenced by clipMetafileContentAgainstOwnRegions(), BitmapEx::CopyPixel(), vcl::PDFWriterImpl::createBitmapEmit(), OutputDevice::DrawBitmap(), Printer::DrawDeviceMask(), vcl::PDFWriterImpl::drawJPGBitmap(), Erase(), BitmapEx::GetChecksum(), OutputDevice::GetDownsampledBitmap(), BitmapEx::GetTransparency(), Printer::ImplPrintTransparent(), BitmapEx::IsEmpty(), and BitmapEx::ModifyBitmapEx().

bool Bitmap::Mirror ( BmpMirrorFlags nMirrorFlags )

Mirror the bitmap.

Parameters

nMirrorFlags About which axis (horizontal, vertical, or both) to mirror

Returns: true, if the operation was completed successfully.

Definition at line 108 of file bitmappaint.cxx.

References BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::GetScanlineSize(), BitmapInfoAccess::Height(), Horizontal, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), Vertical, and BitmapInfoAccess::Width().

Referenced by OutputDevice::DrawBitmap(), OutputDevice::DrawDeviceAlphaBitmap(), Printer::DrawDeviceMask(), OutputDevice::DrawDeviceMask(), Printer::ImplPrintTransparent(), BitmapEx::Mirror(), and Rotate().

bool Bitmap::operator! ( ) const

inline

Definition at line 551 of file bitmap.hxx.

References mxSalBmp.

Referenced by AlphaMask::operator!().

bool Bitmap::operator!= ( const Bitmap & rBitmap ) const

inline

Definition at line 125 of file bitmap.hxx.

References operator==().

Referenced by AlphaMask::operator!=().

Bitmap & Bitmap::operator= ( const Bitmap & rBitmap )

Definition at line 272 of file bitmap/bitmap.cxx.

References maPrefMapMode, maPrefSize, and mxSalBmp.

Referenced by AlphaMask::operator=().

Bitmap & Bitmap::operator= ( Bitmap && rBitmap )

noexcept

Definition at line 284 of file bitmap/bitmap.cxx.

References maPrefMapMode, maPrefSize, and mxSalBmp.

bool Bitmap::operator== ( const Bitmap & rBitmap ) const

Definition at line 293 of file bitmap/bitmap.cxx.

References mxSalBmp.

Referenced by AlphaMask::operator==().

void Bitmap::ReassignWithSize ( const Bitmap & rBitmap )

ReassignWithSize and recalculate bitmap.

ReassignWithSizes the bitmap, and recalculates the bitmap size based on the new bitmap.

Parameters

rBitmap Bitmap to reassign and use for size calculation

Definition at line 407 of file bitmap/bitmap.cxx.

References FRound(), GetSizePixel(), Size::Height(), maPrefMapMode, maPrefSize, Size::setHeight(), Size::setWidth(), and Size::Width().

Referenced by Crop(), Expand(), and Rotate().

void Bitmap::ReleaseAccess ( BitmapInfoAccess * pAccess )

static

Definition at line 472 of file bitmap/bitmap.cxx.

Referenced by vcl::bitmap::CanvasCairoExtractBitmapData(), BitmapMosaicFilter::execute(), BitmapEx::GetContour(), vcl::bitmap::isHistorical8x8(), vcl::PNGWriterImpl::PNGWriterImpl(), AlphaMask::ReleaseAccess(), vcl::ScopedBitmapAccess< BitmapWriteAccess, Bitmap,&Bitmap::AcquireWriteAccess >::reset(), and vcl::ScopedBitmapAccess< BitmapWriteAccess, Bitmap,&Bitmap::AcquireWriteAccess >::~ScopedBitmapAccess().

bool Bitmap::Replace	(	const Bitmap &	rMask,
		const Color &	rReplaceColor
	)

Replace all pixel where the given mask is on with the specified color.

Parameters

rMask	Mask specifying which pixel should be replaced
rReplaceColor	Color to be placed in all changed pixel

Returns: true, if the operation was completed successfully.

Definition at line 716 of file bitmappaint.cxx.

References COL_WHITE, BitmapInfoAccess::GetBestMatchingColor(), BitmapInfoAccess::GetBitCount(), BitmapReadAccess::GetIndexFromData(), BitmapInfoAccess::GetPaletteColor(), BitmapInfoAccess::GetPaletteEntryCount(), BitmapReadAccess::GetPixelFromData(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), i, BitmapWriteAccess::SetPaletteColor(), BitmapWriteAccess::SetPaletteEntryCount(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

Referenced by unographic::GraphicTransformer::colorChange(), Printer::DrawDeviceBitmap(), BitmapEx::GetBitmap(), EMFWriter::ImplWrite(), BitmapEx::Replace(), BitmapEx::ReplaceTransparency(), and WMFWriter::WriteRecords().

bool Bitmap::Replace	(	const AlphaMask &	rAlpha,
		const Color &	rMergeColor
	)

Merge bitmap with given background color according to specified alpha mask.

Parameters

rAlpha	Alpha mask specifying the amount of background color to merge in
rMergeColor	Background color to be used for merging

Returns: true, if the operation was completed successfully.

Definition at line 794 of file bitmappaint.cxx.

References aMap, BitmapReadAccess::GetColor(), BitmapReadAccess::GetScanline(), GetSizePixel(), BitmapInfoAccess::Height(), maPrefMapMode, maPrefSize, Color::Merge(), vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

bool Bitmap::Replace	(	const Color &	rSearchColor,
		const Color &	rReplaceColor,
		sal_uInt8	nTol = `0`
	)

Replace all pixel having the search color with the specified color.

Parameters

rSearchColor	Color specifying which pixel should be replaced
rReplaceColor	Color to be placed in all changed pixel
nTol	Tolerance value. Specifies the maximal difference between rSearchColor and the individual pixel values, such that the corresponding pixel is still regarded a match.

Returns: true, if the operation was completed successfully.

Definition at line 841 of file bitmappaint.cxx.

References Convert(), BitmapInfoAccess::GetBestMatchingColor(), GetBitCount(), Color::GetBlue(), Color::GetGreen(), BitmapInfoAccess::GetPaletteColor(), BitmapInfoAccess::GetPaletteEntryCount(), BitmapReadAccess::GetPixelFromData(), Color::GetRed(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), i, ImplGetSVData(), ImplSetSalBitmap(), maPrefMapMode, maPrefSize, mxSalBmp, N4BitColors, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapWriteAccess::SetPaletteColor(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

bool Bitmap::Replace	(	const Color *	pSearchColors,
		const Color *	rReplaceColors,
		size_t	nColorCount,
		sal_uInt8 const *	pTols
	)

Replace all pixel having one the search colors with the corresponding replace color.

Parameters

pSearchColors	Array of colors specifying which pixel should be replaced
rReplaceColors	Array of colors to be placed in all changed pixel
nColorCount	Size of the aforementioned color arrays
pTols	Tolerance value. Specifies the maximal difference between pSearchColor colors and the individual pixel values, such that the corresponding pixel is still regarded a match.

Returns: true, if the operation was completed successfully.

Definition at line 916 of file bitmappaint.cxx.

References Convert(), BitmapInfoAccess::GetBestMatchingColor(), GetBitCount(), Color::GetBlue(), Color::GetGreen(), BitmapInfoAccess::GetPaletteColor(), BitmapInfoAccess::GetPaletteEntryCount(), BitmapReadAccess::GetPixelFromData(), Color::GetRed(), BitmapReadAccess::GetScanline(), BitmapInfoAccess::HasPalette(), BitmapInfoAccess::Height(), i, N4BitColors, vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), BitmapWriteAccess::SetPaletteColor(), BitmapReadAccess::SetPixelOnData(), and BitmapInfoAccess::Width().

bool Bitmap::Rotate	(	Degree10	nAngle10,
		const Color &	rFillColor
	)

Rotate bitmap by the specified angle.

Parameters

nAngle10	The rotation angle in tenth of a degree. The bitmap is always rotated around its center.
rFillColor	The color to use for filling blank areas. During rotation, the bitmap is enlarged such that the whole rotation result fits in. The empty spaces around that rotated original bitmap are then filled with this color.

Returns: true, if the operation was completed successfully.

Definition at line 212 of file bitmappaint.cxx.

References F_PI1800, FRound(), o3tl::strong_int< UNDERLYING_TYPE, PHANTOM_TYPE >::get(), GetBitCount(), tools::Polygon::GetBoundRect(), BitmapInfoAccess::GetPalette(), BitmapReadAccess::GetPixel(), GetSizePixel(), Size::Height(), Horizontal, Mirror(), Point, ReassignWithSize(), vcl::ScopedBitmapAccess< Access, Bitmap, Acquire >::reset(), tools::Polygon::Rotate(), Vertical, and Size::Width().

Referenced by OutputDevice::ImplDrawRotateText(), and BitmapEx::Rotate().

bool Bitmap::Scale	(	const Size &	rNewSize,
		BmpScaleFlag	nScaleFlag = `BmpScaleFlag::Default`
	)

Scale the bitmap.

Parameters

rNewSize	The resulting size of the scaled bitmap
nScaleFlag	The algorithm to be used for scaling

Returns: true, if the operation was completed successfully.

Definition at line 1479 of file bitmap/bitmap.cxx.

References GetSizePixel(), Size::Height(), and Size::Width().

Referenced by BitmapEx::BitmapEx(), OutputDevice::DrawBitmap(), BitmapFastScaleFilter::execute(), OutputDevice::GetDownsampledBitmap(), ImpGraphic::ImplGetBitmap(), and BitmapEx::Scale().

bool Bitmap::Scale	(	const double &	rScaleX,
		const double &	rScaleY,
		BmpScaleFlag	nScaleFlag = `BmpScaleFlag::Default`
	)

Scale the bitmap.

Parameters

rScaleX	The scale factor in x direction.
rScaleY	The scale factor in y direction.
nScaleFlag	Method of scaling - it is recommended that either BmpScaleFlag::Default or BmpScaleFlag::BestQuality be used.

Returns: true, if the operation was completed successfully.

Definition at line 1388 of file bitmap/bitmap.cxx.

References BestQuality, BiCubic, BiLinear, Default, basegfx::fTools::equal(), basegfx::fTools::equalZero(), Fast, BitmapFilter::Filter(), GetBitCount(), BitmapEx::GetBitmap(), GetSizePixel(), Height, ImplGetSVData(), ImplSetSalBitmap(), Interpolate, Lanczos, maPrefMapMode, maPrefSize, mxSalBmp, NearestNeighbor, SAL_INFO, Super, and Width.

void Bitmap::SetEmpty ( )

Definition at line 311 of file bitmap/bitmap.cxx.

References maPrefMapMode, maPrefSize, and mxSalBmp.

Referenced by OutputDevice::GetDownsampledBitmap(), BitmapEx::ModifyBitmapEx(), and BitmapEx::SetEmpty().

void Bitmap::SetPrefMapMode ( const MapMode & rMapMode )

inline

Definition at line 566 of file bitmap.hxx.

References maPrefMapMode.

Referenced by DetectEdges(), BitmapColorQuantizationFilter::execute(), BitmapSimpleColorQuantizationFilter::execute(), BitmapMonochromeFilter::execute(), and ImpGraphic::ImplGetBitmap().

void Bitmap::SetPrefSize ( const Size & rSize )

inline

Definition at line 576 of file bitmap.hxx.

References maPrefSize.

Referenced by ImpGraphic::ImplGetBitmap().

void Bitmap::Vectorize	(	GDIMetaFile &	rMtf,
		sal_uInt8	cReduce,
		const Link< tools::Long, void > *	pProgress
	)

Convert the bitmap to a meta file.

This works by putting continuous areas of the same color into polygons painted in this color, by tracing the area's bounding line.

Parameters

rMtf	The resulting meta file
cReduce	If non-null, minimal size of bound rects for individual polygons. Smaller ones are ignored.
pProgress	A callback for showing the progress of the vectorization

Definition at line 1660 of file bitmap/bitmap.cxx.

References ImplVectorizer::ImplVectorize().