version 11.3
SVG_Define_filter (objetSVGParent; id{; canevasX; canevasY{; largeurCanevas; hauteurCanevas{; unitéCanevas{; unitéFiltre}}}}) Ref_SVG
| Paramètre | Type | Description | |
| objetSVGParent | Ref_SVG | Référence de l'élément parent | |
| id | Chaîne | Nom du symbole | |
| canevasX | Numérique | Coordonnée sur l'axe x | |
| canevasY | Numérique | Coordonnée sur l'axe y | |
| largeurCanevas | Numérique | Largeur du rectangle cible | |
| hauteurCanevas | Numérique | Hauteur du rectangle cible | |
| unitéCanevas | Chaîne | Système de coordonnées du canevas | |
| unitéFiltre | Chaîne | Système des valeurs du filtre | |
| Résultat | Ref_SVG | Référence du filtre |
Description
La commande SVG_Define_filter définit un nouveau filtre dans le conteneur SVG désigné par objetSVGParent et retourne sa référence. Si objetSVGParent n'est pas un document SVG, une erreur est générée.
Un filtre est une succession d'opérations graphiques qui seront appliquées sur l'élément cible. L'élément filtre n'est jamais rendu directement, il sera appliqué à un objet grâce à la commande SVG_SET_FILTER.
Le paramètre id spécifie le nom du filtre. Le nom sera utilisé pour associer un filtre à un objet. Si un élément de même nom existait, il est remplacé.
Les paramètres optionnels canevasX, canevasY, largeurCanevas et hauteurCanevas définissent une région rectangulaire du document sur laquelle ce filtre s'applique.
Le paramètre optionnel unitéCanevas définit le système de coordonnées pour les quatre paramètres précédents. Les valeurs attendues sont "userSpaceOnUse" ou "objectBoundingBox" (valeur par défaut).
Le paramètre optionnel unitéFiltre définit le système de coordonnées pour les longueurs et les propriétés de définition du filtre. Les valeurs attendues sont "userSpaceOnUse" (valeur par défaut) ou "objectBoundingBox".
Référence
SVG_Filter_Blend, SVG_Filter_Blur, SVG_Filter_Offset, SVG_SET_FILTER.