clipPath

Dernière mise à jour : 2023-09-01

Rubriques :
Dynamic Media Classic
Afficher plus sur ce sujet
SDK/API
Afficher plus sur ce sujet

Créé pour :
Developer

User

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*]

pathDefinition	Path data.
pathName	Nom du chemin d’accès incorporé dans l’image source du calque (ASCII uniquement).

Toute partie du calque située 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* est spécifié, le serveur cliente l’image à l’intersection de ces chemins. Quelconque *pathName* L’image source introuvable est ignorée.

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.

If 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é en fonction de origin= ou sa valeur par défaut. Toutes les zones du chemin en dehors du rectangle du calque restent transparentes.

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

REMARQUE

scale=, rotate=, et anchor= Les commandes ne sont pas autorisées pour les calques de couleur unitaires auto-dimensionnés.

*pathDefinition* accepte une chaîne similaire à la valeur de la variable d= de l’attribut du SVG <path> , sauf que des 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*:

Commande	Nom	Description
M x,y	moveto absolute	Démarrez un nouveau sous-chemin à x,y.
m x,y	moveto relatif
L *{ x,y}	lineto absolute	Tracez une ligne de la position actuelle à x,y.
l *{ x,y}	lineto relative
C *{ x1,y1,x2,y2,x,y}	curveto absolute	Tracez 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,y}	curveto relatif
z \| z	closepath	Fermez 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.