NewSoftMaskGraphicsState
Gráficos vetoriais, Transparência, Form XObjects
Descrição
Creates or reuses an ExtGState that applies a captured Form XObject as an alpha or luminosity soft mask, or creates a reset state that writes /SMask /None
Sintaxe
Delphi
Function TPDFlib.NewSoftMaskGraphicsState(CaptureID, MaskType: Integer; Const Backdrop, TransferFunction: WideString): Integer;
Parâmetros
| CaptureID | Captured Form XObject ID, or 0 when MaskType is PDF_SOFT_MASK_NONE |
|---|---|
| MaskType | PDF_SOFT_MASK_ALPHA, PDF_SOFT_MASK_LUMINOSITY ou PDF_SOFT_MASK_NONE |
| Backdrop | String vazia, ou um array numérico PDF contendo exatamente três componentes de backdrop de 0 a 1 para o grupo de transparência DeviceRGB isolado |
| TransferFunction | String vazia, /Identity, ou um dicionário de função, stream ou referência indireta do PDF com um FunctionType numérico |
Valores retornados
Retorna um ID reutilizável de graphics state, caso contrário 0
Observações
O formulário capturado é configurado como um grupo de transparência DeviceRGB isolado, e configurações idênticas reutilizam um único ExtGState
Aplique o ID retornado com SetGraphicsState antes de desenhar conteúdo mascarado e, então, aplique um estado PDF_SOFT_MASK_NONE para encerrar o escopo da máscara
Um estado de reinício exige CaptureID 0 e strings vazias de backdrop e função de transferência
A versão do documento é elevada ao PDF 1.4, enquanto os modos PDF/A-1 e PDF/X-1 rejeitam esta operação
Veja também
SetGraphicsState, BeginFormXObject, SetCapturedPageTransparencyGroup, SetImageSoftMaskEx