TCustomBitmap32

Hierarchy

TPersistent

Description

TCustomBitmap32 is the central class in the Graphics32 library. It manages a single 32-bit device-independent bitmap (DIB) and provides methods for drawing on it and combining it with other DIBs.

Since TCustomBitmap32 is a descendant of TThreadPersistent, it inherits its locking mechanism and it may be used in multi-threaded applications.

Change Notification

Change notification events (OnChange, OnResize), inherited from TNotifiablePersistent and TCustomMap are generated by most drawing/resizing etc. functions with a few exceptions. Due to performance considerations the following functions are not accompanied with event generation:

Pixel-based operations (SetPixelT, SetPixelF...);
HorzLine* and VertLine* functions;

If necessary, the OnChange event may be generated explicitly by calling the Changed methods.

Normally, if the bitmap is a part of some container (TImage32, TBitmapLayer, etc.), its change notification events are linked to the container, causing repaint operations. When making several simultaneous changes, it may be beneficial to enclose them in BeginUpdate…EndUpdate block followed by the Changed call to reduce the amount of repaintings of the container.

Reference

Fields	Properties	Methods	Events
In TCustomBitmap32:
	Backend	BeginMeasuring	OnAreaChanged
	Bits	Clear	OnPixelCombine
	Clipping	Create
	ClipRect	Destroy
	CombineMode	Draw
	DrawMode	DrawTo
	MasterAlpha	Empty
	MeasuringMode	EndMeasuring
	OuterColor	FillRect
	PenColor	FlipHorz
	Pixel	FlipVert
	PixelPtr	FrameRect
	Resampler	GetStippleColor
	ResamplerClassName	HorzLine
	ScanLine	Line
	StippleCounter	LineTo
	StippleStep	LoadFromFile
	StretchFilter	LoadFromStream
	WrapMode	MoveTo
		RaiseRectTS
		ResetAlpha
		ResetClipRect
		Roll
		Rotate
		SaveToFile
		SaveToStream
		SetPixel
		SetSize
		SetStipple
		VertLine
In TCustomMap:
	Height	Delete	OnResize
	Width	Resized
In TThreadPersistent:
	LockCount	Lock
		Unlock
In TNotifiablePersistent:
	UpdateCount	BeginUpdate	OnChange
		Changed
		EndUpdate

TCustomBitmap32

Hierarchy

Description

Change Notification

Reference

See Also