THotPDF.AcquireLoadedImageRegionAtResolution Method

Decodes or reuses a loaded-image region at the requested output resolution and returns an immutable shared handle

Declaration

function AcquireLoadedImageRegionAtResolution(
  AImageStream: THPDFStreamObject;
  RegionLeft, RegionTop, RegionRight, RegionBottom,
  TargetPixelWidth, TargetPixelHeight: Integer): IHPDFDecodedBitmapHandle;

Parameters

The region coordinates select source pixels and the target dimensions select the decoded output size

Return value

Returns a reference-counted decoded bitmap handle or nil for invalid bounds or an unsupported image

Performance

The region geometry and target resolution form part of the cache key, while warm hits avoid all decoded bitmap copies

Related APIs

IHPDFDecodedBitmapHandle · DecodeLoadedImageRegionAtResolutionCached