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

CaptureIDCaptured Form XObject ID, or 0 when MaskType is PDF_SOFT_MASK_NONE
MaskTypePDF_SOFT_MASK_ALPHA, PDF_SOFT_MASK_LUMINOSITY ou PDF_SOFT_MASK_NONE
BackdropString 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
TransferFunctionString 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