|
|
|
|
|
|
|
|
|
version 11.3
SVG_New_image (objetSVGParent; url{; x; y{; largeur; hauteur}}) 
Ref_SVG
| Paramètre | Type | Description | |
| objetSVGParent | Ref_SVG | | Référence de l'élément parent |
| url | Chaîne | | Adresse de l'image |
| x | Numérique | | Coordonnée du coin supérieur gauche sur l'axe x |
| y | Numérique | | Coordonnée du coin supérieur gauche sur l'axe y |
| largeur | Numérique | | Largeur de l'image |
| hauteur | Numérique | | Hauteur de l'image |
| Résultat | Ref_SVG |  | Référence de l'image |
Description
La commande SVG_New_image permet de référencer une image située à l'adresse url 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.
Le paramètre url spécifie l'emplacement de l'image et peut prendre plusieurs formes :
• Un URL local (chemin d'accès de la forme "file://..."). Dans ce cas, l'image ne sera affichée que si le fichier est effectivement accessible au moment du rendu de l'objet. Cet URL local peut être relatif (de la forme "#Images/monImage.png"), dans ce cas la commande préfixera le chemin d'accès de celui du dossier Resources de la base hôte. Si les paramètres largeur et hauteur sont omis, ils seront calculés par la commande (dans ce cas l'exécution de la commande sera plus lente). Si le chemin relatif n'est pas valide, une erreur est générée.
• Un URL non local ("http://monSite.com/images/monImage.jpeg"). Dans ce cas, aucune vérification n'est effectuée sur la validité du lien et une erreur sera générée si les paramètres largeur et hauteur sont omis.
Les paramètres optionnels x et y permettent de préciser la position du coin supérieur gauche de l'image dans le conteneur SVG (valeur par défaut : 0).
Les paramètres largeur et hauteur spécifient la taille du rectangle dans lequel sera affichée l'image et déterminent donc la taille et le ratio d'aspect de l'image. Ces paramètres ne sont optionnels que dans le cas d'une image référencée par un chemin relatif dans le dossier Resources de la base hôte. Si largeur et/ou hauteur vaut 0, l'image n'est pas rendue.
Exemples
1. Placer l'image 'logo4D.png' située dans le dossier 'Images' du dossier 'Resources' :
svgRef:= SVG_New objectRef:=SVG_New_image(svgRef;"#Images/logo4D.png")
2. Placer l'image '4dlogo.gif' accessible dans le répertoire 'images' du site '4d.fr' :
svgRef:= SVG_New objectRef:=SVG_New_image (svgRef;"http://www.4d.fr/images/4dlogo.gif";20;20;39;53)
Référence
SVG_New_embedded_image, SVG_Open_picture.
|
|
|
|
|
|
|
|
|