TCustomBitmap32

Hierarchy

TPersistent

   |

TNotifiablePersistent

   |

TThreadPersistent

   |

TCustomMap

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:

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 BeginUpdateEndUpdate block followed by the Changed call to reduce the amount of repaintings of the container.

Reference

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

See Also

TCustomMap, TNotifiablePersistent, TThreadPersistent, TImage32, TBitmapLayer