NewSoftMaskGraphicsState

向量圖形、透明效果、Form XObject

描述

建立或重用一個 ExtGState，把擷取的 Form XObject 套用為 alpha 或亮度軟性遮罩；或建立一個寫出 /SMask /None 的重置狀態

Function TPDFlib.NewSoftMaskGraphicsState(CaptureID, MaskType: Integer; Const Backdrop, TransferFunction: WideString): Integer;

CaptureID	擷取的 Form XObject ID；MaskType 為 PDF_SOFT_MASK_NONE 時為 0
MaskType	PDF_SOFT_MASK_ALPHA、PDF_SOFT_MASK_LUMINOSITY 或 PDF_SOFT_MASK_NONE
Backdrop	空字串，或 PDF 數值陣列——為隔離的 DeviceRGB 透明群組提供正好三個 0 到 1 的背景（backdrop）成分
TransferFunction	空字串、/Identity，或帶數值 FunctionType 的 PDF 函式字典、串流或間接參照

傳回可重複使用的圖形狀態 ID，否則 0

擷取的 Form 設定為隔離的 DeviceRGB 透明度群組，相同設定重用同一個 ExtGState

繪製帶遮罩內容前先用 SetGraphicsState 套用傳回的 ID，之後套用 PDF_SOFT_MASK_NONE 狀態結束遮罩範圍

重設狀態要求 CaptureID 為 0，且背景與轉換函數字串為空

文件版本提升到 PDF 1.4；PDF/A-1 與 PDF/X-1 模式會拒絕此操作