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
| CaptureID | ID d'objet XObject Form capturé, ou 0 lorsque MaskType vaut PDF_SOFT_MASK_NONE |
|---|---|
| MaskType | PDF_SOFT_MASK_ALPHA, PDF_SOFT_MASK_LUMINOSITY ou PDF_SOFT_MASK_NONE |
| Backdrop | Chaî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é |
| TransferFunction | Chaî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