DocumentationAPI de diffusion et de rendu d’images Dynamic Media

clipPath

Dernière mise à jour : 5 mai 2025
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

Chemin d’accès au clip de calque. Spécifie un chemin d’accès à l’élément pour le calque actif.

clipPath= *pathDefinition*

clipPathE= *pathName**[, *pathName*]

pathDefinitionDonnées de chemin d’accès.
pathNameNom du chemin d’accès incorporé dans l’image source du calque (ASCII uniquement).

Toutes les parties du calque situées en dehors de la zone définie par clipPath= sont rendues transparentes.

*pathName* est le nom d’un chemin incorporé dans l’image source du calque. Le chemin est automatiquement transformé afin de conserver un alignement relatif avec le contenu de l’image. Si plusieurs *pathName* sont spécifiés, le serveur cliente l’image à l’intersection de ces chemins. Tout *pathName* introuvable dans l’image source est ignoré.

REMARQUE
Seules les chaînes ASCII sont prises en charge pour *pathName*.

*pathDefinition* permet de spécifier des données de chemin d’accès explicites dans les coordonnées des pixels de couche.

Si size= est spécifié et non 0,0, le calque est prédimensionné. Dans ce cas, les coordonnées du chemin sont relatives au coin supérieur gauche du rectangle du calque et le calque est positionné sur la base de origin= ou de sa valeur par défaut. Toutes les zones du chemin en dehors du rectangle du calque restent transparentes.

Si size= n’est pas spécifié pour une couleur ou un calque de texte uni, le calque est considéré comme auto-dimensionnant, l’étendue du chemin déterminant sa taille. Si origin= n’est pas spécifié, l’espace de coordonnées du chemin est défini par défaut sur (0,0). Ce processus de workflow permet de spécifier les coordonnées du chemin par rapport à l’origine de la couche 0.

REMARQUE
Les commandes scale=, rotate= et anchor= ne sont pas autorisées pour l’auto-dimensionnement des calques de couleur unis.

*pathDefinition* accepte une chaîne similaire à la valeur de l’attribut d= de l’élément <path> du SVG, sauf que les virgules sont utilisées à la place d’espaces pour séparer les valeurs. *pathDefinition* peut inclure un ou plusieurs sous-chemins de boucle fermée.

Les commandes de chemin d’accès suivantes sont prises en charge dans *pathDefinition* :

CommandeNameDescription
M x,ymoveto absoluteDémarrez un nouveau sous-chemin à x,y.
m x,ymoveto relatif
L *{ x,y}lineto absoluteTracez une ligne de la position actuelle à x,y.
l *{ x,y}lineto relative
C *{ x1,y1,x2,y2,x,ycurveto absoluteTracez une courbe Bézier de la position actuelle à x,y. x1,y1 est le point de contrôle au début de la courbe et x2,y2 est le point de contrôle à la fin de la courbe.
c *{ x1,y1,x2,y2,x,ycurveto relatif
Z | zclosepathFermez le sous-chemin actuel avec une ligne droite.

Les commandes en majuscules indiquent que les valeurs des coordonnées se situent à des positions en pixels absolues (par rapport au coin supérieur gauche du rectangle du calque). Les décalages de pixels suivent des commandes en minuscules par rapport à la position actuelle.

'm' ou 'M' commence toujours un nouveau sous-chemin. Les sous-chemins sont fermés automatiquement (avec une ligne droite) si "Z" ou "z" n’est pas spécifié à la fin.

Si un sous-chemin commence par un mouvement relatif ('m'), il est relatif à l’un des éléments suivants :

  • Le point de départ du sous-chemin précédent, s’il a été fermé avec "z" ou "Z".
  • Point de fin du sous-chemin précédent, s’il n’a pas été fermé explicitement.
  • 0,0, s’il s’agit du premier sous-chemin.

Propriétés

Attribut de calque. S’applique au calque actif ou à l’image composite si layer=comp. Les calques d’effet l’ignorent.

Le modificateur clipPathE= est ignoré si aucun chemin d’accès portant le nom spécifié n’est trouvé dans l’image source du calque ou si la source du calque n’est pas une image.

Par défaut

Aucun, pour aucun autre écrêtage du calque.

Voir aussi

clipXpath= , textFlowPath= , extension=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49