User Tools

Site Tools


api:dk11:delphi:fmx.gisframework.tgis_bitmapfmx.lockpixels_tgis_pixels_boolean_tgis_bitmapformat_tgis_bitmaplinesorder

Table of Contents



TGIS_BitmapFMX.LockPixels method

DK for Delphi | FMX.GisFramework.TGIS_BitmapFMX.LockPixels | Constructors | Fields | Methods | Properties

Prepare the bitmap for direct pixel access.

Syntax

Overrides TGIS_BitmapAbstract.LockPixels.

// Delphi
public
  procedure LockPixels(
    var _pixels : TGIS_Pixels;
    const _writable : Boolean;
    const _format : TGIS_BitmapFormat;
    const _order : TGIS_BitmapLinesOrder
  ); override;
// C++ Builder
public:
  virtual void LockPixels(
    TGIS_Pixels* &_pixels,
    const bool _writable,
    TGIS_BitmapFormat* const _format,
    TGIS_BitmapLinesOrder* const _order
  );

Parameters

Name Type Description
_pixels TGIS_Pixels pixel buffer allocated and maintained between LockPixels and UnlockPixels
_writable Boolean True if the caller will modify pixel values
_format TGIS_BitmapFormat desired bitmap format of locked pixels; some platform operations require a format different from the native default
_order TGIS_BitmapLinesOrder desired bitmap lines order of locked pixels; some platform operations require an order different from the native default

Remarks

Must be paired with UnlockPixels.

USAGE: Lock bitmap pixels before reading or modifying the buffer directly.

bitmap.LockPixels(pixels, True, format, order)
pixels[index] = value
bitmap.UnlockPixels()

2026/09/20 23:46

Page Tools