THotPDF.DecodeLoadedImageRegion Method
将一个已加载图像 XObject 流中的精确源坐标矩形,解码到由调用方持有的 TBitmap 中
声明
function DecodeLoadedImageRegion(AImageStream: THPDFStreamObject;
RegionLeft, RegionTop, RegionRight, RegionBottom: Integer): TBitmap;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
AImageStream | 要解码的已加载图像 XObject 流 |
RegionLeft | 包含左侧源坐标 |
RegionTop | 包含顶部源坐标 |
RegionRight | 不包含右侧源坐标 |
RegionBottom | 不包含底部源坐标 |
返回值
返回一个新分配的位图,内容为钳制后的非空区域;图像或所请求的几何无法解码时返回 nil
使用说明
- 调用方拥有返回的非 nil 位图,必须释放它
- 坐标使用解码后图像左上角为原点的光栅空间,右边界和下边界为开区间
- 超出图像的边界会在解码前被钳制
- JPEG 2000 requests the native decoder region before pixel expansion
- This method preserves the region's full decoded resolution
- 其他受支持的图像格式照常解码,并返回精确裁剪后的区域
- 对于被裁剪或缩小的、与坐标轴对齐的图像 XObject,已加载页面渲染器会自动使用感知分辨率的重载