SetImageSoftMaskEx

影像處理、透明效果

描述

把 MaskImageID 轉成灰階軟性遮罩、套用選配的底色（matte）顏色，並附加到 ImageID

Function TPDFlib.SetImageSoftMaskEx(ImageID, MaskImageID: Integer; Const Matte: WideString): Integer;

ImageID	Target image ID
MaskImageID	以其灰階取樣提供不透明度值的影像 ID
Matte	空字串表示省略 /Matte；或為 PDF 數值陣列，含 1 到 4 個 0 到 1 的顏色成分，須符合目標影像色彩空間

成功傳回 ImageID，否則為 0

目標影像與遮罩影像的像素尺寸必須一致，且必須是不同的影像物件

附加遮罩時文件版本提升到 PDF 1.4

PDF/A-1 與 PDF/X-1 模式拒絕此操作，因為它們不允許透明度