Skip to content
Member Filters
Show Inherited
Show Protected
Show abstract
GR32🞂TBitmap32Class

TBitmap32

Primary 32-bit ARGB bitmap class in Graphics32, providing VCL/LCL Canvas, GDI device context (HDC), and OS surface handle bindings.

Inheritance:TObject 🞂 TPersistent 🞂 TPlainInterfacedPersistent 🞂 TNotifiablePersistent 🞂 TThreadPersistent 🞂 TCustomMap 🞂 TCustomBitmap32 🞂 TBitmap32

Declaration ​

pascal
TBitmap32 = class(TCustomBitmap32)

Description ​

TBitmap32 is the standard concrete 32-bit ARGB bitmap implementation in Graphics32. It inherits all core pixel buffer management, sub-pixel sampling, drawing primitives, blending modes, and resamplers from TCustomBitmap32.

In addition, TBitmap32 integrates with host OS graphics frameworks (VCL on Windows, LCL on cross-platform GUI toolkits) by exposing a standard VCL/LCL Canvas, device context (HDC), GDI bitmap surface handle (Handle), Font property for text rendering, and GDI drawing routines (TileTo, HDC Draw / DrawTo overloads).

Constructors & Destructors ​

NameDescription
CreateInherited constructor that instantiates a new TBitmap32 bitmap instance.

Methods ​

NameDescription
DeleteCanvasFrees and releases the internal VCL/LCL TCanvas instance allocated for this bitmap.
DrawDraws a source bitmap, sub-rectangle, or GDI DC onto this bitmap.
DrawToDraws this bitmap onto a destination bitmap or GDI device context (HDC).
GetPlatformBackendClassReturns the platform-default backend class used for surface management.
RenderTextRenders anti-aliased text directly into the bitmap buffer using specified color.
TextExtentCalculates the pixel width and height dimensions of a text string when rendered using current Font.
TextHeightReturns the height in pixels of a text string when rendered using current Font.
TextoutRenders text string onto the bitmap surface at specified coordinates or bounding rectangle using the current Font.
TextWidthReturns the width in pixels of a text string when rendered using current Font.
TileToTiles a source bitmap sub-rectangle repeatedly onto a target GDI device context (HDC).
UpdateFontNotifies the backend that font property changes have occurred and updates font settings.

Properties ​

NameTypeScopeDescription
BitmapInfoTBitmapInfoPublicRead-only GDI bitmap header information structure.
CanvasTCanvasPublicVCL/LCL drawing canvas bound to the bitmap's device context (HDC).
CanvasAllocatedbooleanPublicIndicates whether a VCL/LCL TCanvas instance is currently allocated for this bitmap.
FontTFontPublicFont instance used for canvas text rendering operations.
HandleHBITMAPPublicOS GDI bitmap surface handle.
HDCHDCPublicOS GDI device context handle bound to pixel buffer surface.

Events ​

NameTypeDescription
OnHandleChangedTNotifyEventFired when the OS GDI bitmap surface handle (Handle) changes or is re-allocated.