Метод THotPDF.DecodeLoadedImageRegion
Декодирует точный прямоугольник в исходных координатах из загруженного image XObject stream в TBitmap, принадлежащий вызывающему коду
Объявление
function DecodeLoadedImageRegion(AImageStream: THPDFStreamObject;
RegionLeft, RegionTop, RegionRight, RegionBottom: Integer): TBitmap;
Модуль
HPDFDoc
Параметры
| Имя | Назначение |
|---|---|
AImageStream | Загруженный image XObject stream для декодирования |
RegionLeft | Левая исходная координата, включительно |
RegionTop | Верхняя исходная координата, включительно |
RegionRight | Правая исходная координата, не включается |
RegionBottom | Нижняя исходная координата, не включается |
Возвращаемое значение
Возвращает вновь выделенный bitmap с обрезанной непустой областью или nil, если изображение либо запрошенная геометрия не декодируются
Примечания по использованию
- Возвращённый bitmap (не nil) принадлежит вызывающему коду и должен быть освобождён
- Координаты отсчитываются в растровом пространстве декодированного изображения от левого верхнего угла, правая и нижняя границы не включаются
- Границы за пределами изображения обрезаются перед декодированием
- Для JPEG 2000 область передаётся нативному декодеру до разворачивания пикселей
- Метод сохраняет полное декодированное разрешение области
- Остальные поддерживаемые форматы декодируются как обычно и возвращают точно обрезанную область
- Renderer загруженных страниц автоматически выбирает вариант с учётом разрешения для обрезанных или уменьшенных image XObject, выровненных по осям