THPDFPage.ShowImageMatrix Method
在目前的 PDF 使用者空間中,以精確的六參數矩陣放置已註冊的 image 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 | 對 image 單位方形做縮放、旋轉、反射或傾斜的線性分量 |
E, F | 在目前 PDF 使用者空間中的平移分量 |
行為
- 把選到的 image 註冊進目前頁面的 XObject 資源一次,重複放置時重用既有別名
- 寫入隔離的
q、cm、Do、Q序列,矩陣不會外溢到後續的頁面內容 - 把 image XObject 單位方形直接透過
[A B C D E F]對映 - 不做文件量測換算、Y 座標投影、長寬比貼合或自動旋轉
- 拒絕無效的 image 索引以及任何非有限值的矩陣分量
範例
ImageIndex := Document.AddImage(Bitmap, icFlate);
Document.CurrentPage.ShowImageMatrix(
ImageIndex,
120, 0,
0, 80,
36, 540);