THPDFPage.ShowImageMatrix 方法
在当前 PDF 用户空间中,通过精确的六参数矩阵放置已注册的图像 XObject
声明
procedure ShowImageMatrix(ImageIndex: Integer; A, B, C, D, E, F: Single);
void __fastcall ShowImageMatrix(int ImageIndex, float A, float B, float C, float D, float E, float F);
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
ImageIndex | 由 AddImage、AddImageWithMask 或 AddImageWithSMask API 返回的索引 |
A, B, C, D | 线性分量,用于对图像单位正方形做缩放、旋转、镜像或错切 |
E, F | 当前 PDF 用户空间中的平移分量 |
行为
- 选中的图像只在当前页面 XObject 资源中注册一次,重复放置时复用已有别名
- 写入独立的
q、cm、Do、Q序列,矩阵不会泄漏到后续页面内容中 - 图像 XObject 的单位正方形直接经
[A B C D E F]映射 - 不做文档度量换算、Y 坐标投影、纵横比适配或自动旋转
- 拒绝无效的图像索引和一切非有限矩阵分量
示例
ImageIndex := Document.AddImage(Bitmap, icFlate);
Document.CurrentPage.ShowImageMatrix(
ImageIndex,
120, 0,
0, 80,
36, 540);