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 ​
| Name | Description |
|---|---|
Create | Inherited constructor that instantiates a new TBitmap32 bitmap instance. |
Methods ​
| Name | Description |
|---|---|
DeleteCanvas | Frees and releases the internal VCL/LCL TCanvas instance allocated for this bitmap. |
Draw | Draws a source bitmap, sub-rectangle, or GDI DC onto this bitmap. |
DrawTo | Draws this bitmap onto a destination bitmap or GDI device context (HDC). |
GetPlatformBackendClass | Returns the platform-default backend class used for surface management. |
RenderText | Renders anti-aliased text directly into the bitmap buffer using specified color. |
TextExtent | Calculates the pixel width and height dimensions of a text string when rendered using current Font. |
TextHeight | Returns the height in pixels of a text string when rendered using current Font. |
Textout | Renders text string onto the bitmap surface at specified coordinates or bounding rectangle using the current Font. |
TextWidth | Returns the width in pixels of a text string when rendered using current Font. |
TileTo | Tiles a source bitmap sub-rectangle repeatedly onto a target GDI device context (HDC). |
UpdateFont | Notifies the backend that font property changes have occurred and updates font settings. |
Properties ​
| Name | Type | Scope | Description |
|---|---|---|---|
BitmapInfo | TBitmapInfo | Public | Read-only GDI bitmap header information structure. |
Canvas | TCanvas | Public | VCL/LCL drawing canvas bound to the bitmap's device context (HDC). |
CanvasAllocated | boolean | Public | Indicates whether a VCL/LCL TCanvas instance is currently allocated for this bitmap. |
Font | TFont | Public | Font instance used for canvas text rendering operations. |
Handle | HBITMAP | Public | OS GDI bitmap surface handle. |
HDC | HDC | Public | OS GDI device context handle bound to pixel buffer surface. |
Events ​
| Name | Type | Description |
|---|---|---|
OnHandleChanged | TNotifyEvent | Fired when the OS GDI bitmap surface handle (Handle) changes or is re-allocated. |