NewSoftMaskGraphicsState

Graphiques vectoriels, transparence, Form XObjects

Description

Crée ou réutilise un ExtGState appliquant un Form XObject capturé comme masque doux alpha ou luminosité, ou crée un état de réinitialisation écrivant /SMask /None

Syntaxe

Delphi

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

Paramètres

CaptureIDID d'objet XObject Form capturé, ou 0 lorsque MaskType vaut PDF_SOFT_MASK_NONE
MaskTypePDF_SOFT_MASK_ALPHA, PDF_SOFT_MASK_LUMINOSITY ou PDF_SOFT_MASK_NONE
BackdropChaîne vide ou tableau numérique PDF contenant exactement trois composantes d'arrière-plan de 0 à 1 pour le groupe de transparence DeviceRGB isolé
TransferFunctionChaîne vide, /Identity, ou dictionnaire de fonction PDF, flux ou référence indirecte avec un FunctionType numérique

Valeurs de retour

Renvoie un ID d’état graphique réutilisable, sinon 0

Remarques

Le formulaire capturé est configuré comme un groupe de transparence DeviceRGB isolé, et les configurations identiques réutilisent un seul ExtGState

Appliquez l'ID renvoyé avec SetGraphicsState avant de dessiner le contenu masqué, puis un état PDF_SOFT_MASK_NONE pour terminer la portée du masque

Un état de réinitialisation exige un CaptureID égal à 0 et des chaînes d'arrière-plan et de fonction de transfert vides

La version du document est relevée à PDF 1.4, tandis que les modes PDF/A-1 et PDF/X-1 rejettent cette opération

Voir aussi

SetGraphicsState, BeginFormXObject, SetCapturedPageTransparencyGroup, SetImageSoftMaskEx