SVG_Define_filter

4D v16

SVG_Define_filter


SVG_Define_filter ( objetSVGParent ; id {; canevasX ; canevasY {; largeurCanevas ; hauteurCanevas {; unitéCanevas ; unitéFiltre}}}} ) -> Résultat

Paramètre	Type	Description
objetSVGParent	Ref_SVG	Référence de l’élément parent
id	Chaîne	Nom du symbole
canevasX	Entier long	Coordonnée sur l'axe x
canevasY	Entier long	Coordonnée sur l'axe y
largeurCanevas	Entier long	Largeur du rectangle cible
hauteurCanevas	Entier long	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".

Exemple

Dans cet exemple, nous souhaitons effectuer les opérations suivantes :

création d'un rectangle fond bleu 50%
création d'un filtre blur 4% et application au rectangle
stockage du résultat dans un fichier svg sur disque.

 $Dom_SVG:=SVG_New

 

  //création d'un rectangle fond bleu 50%

 $Dom_rect:=SVG_New_rect($Dom_SVG;50;50;50;50;0;0;"blue:50";"blue:50")

 

  //création filtre blur (flou) 4%

 $Dom_filter:=SVG_Define_filter($Dom_SVG;"blur")

 SVG_Filter_Blur($Dom_filter;4)

 SVG_Filter_Offset($Dom_filter;4)

 

  //application de ce filtre au rectangle

 SVG_SET_FILTER($Dom_rect;"blur")

 

  //stockage du résultat dans un fichier svg

 SVG_SAVE_AS_TEXT($Dom_SVG;Dossier systeme(Bureau)+"test.svg")

 

 SVG_CLEAR($Dom_SVG)

Résultat :

Voir aussi

SVG_Filter_Blend
SVG_Filter_Blur
SVG_Filter_Offset
SVG_SET_FILTER