Skip to content
Member Filters
Show Inherited
Show Protected
Show abstract
GR32🞂TCustomResampler🞂PixelAccessModePropertyPublished

TCustomResampler.PixelAccessMode

Controls out-of-bounds coordinate handling and boundary checking during pixel sampling.

Declaration ​

pascal
property PixelAccessMode: TPixelAccessMode read FPixelAccessMode write SetPixelAccessMode default pamSafe;

Description ​

PixelAccessMode determines how coordinates outside the source bitmap boundaries are handled during sampling operations.

Pixel Access Modes (TPixelAccessMode) ​

ValueDescription
pamUnsafePerforms direct buffer memory access without boundary checks. Fastest, but sampling outside bitmap dimensions results in access violations or memory corruption.
pamSafeClamps out-of-bounds coordinates to valid bitmap boundary pixels. Safe default mode.
pamWrapWraps coordinates outside bitmap boundaries tiled/repeating infinitely in both X and Y directions.
pamTransparentEdgeSamples outside bitmap boundaries as fully transparent pixels (clNone32).

Example ​

pascal
// Enable tiled wrapping mode for pattern sampling
Resampler.PixelAccessMode := pamWrap;