4D Doc Center : SVG_New

4D v14

SVG_New_image


SVG_New_image ( objetSVGParent ; chemin {; x ; y {; largeur ; hauteur}} ) -> Résultat

Paramètre	Type	Description
objetSVGParent	Ref_SVG	Référence de l’élément parent
chemin	Chaîne	Adresse de l’image
x	Entier long	Coordonnée du coin supérieur gauche sur l'axe x
y	Entier long	Coordonnée du coin supérieur gauche sur l'axe y
largeur	Entier long	Largeur de l’image
hauteur	Entier long	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.
Un URL relatif ("../picture.png"). Cette possibilité est particulièrement utile en client/serveur, lorsque les fichiers sont stockés dans le dossier "Resources". Les URLs relatifs peuvent débuter par :
- "/", désignant le chemin "~/Resources/SVG/"
- "./", désignant le chemin "~/Resources/"
- "../", désignant le dossier de la base

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.

Exemple 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")

Exemple 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)

Exemple 3

Voici quelques exemples de référencement d'images à l'aide d'URLs relatifs :

 SVG_New_image($Dom_svg;"./images/picture.png";10;10)

  // chemin relatif au dossier "Resources"

  // le code XML sera xlink:href="../images/picture.png"

 SVG_New_image($Dom_svg;"../picture.png";70;180)

  // chemin relatif au dossier de la base

  // le code XML sera xlink:href="../../picture.png"

 SVG_New_image($Dom_svg;"/sample pictures/picture.png";110;90;100;100)

  // chemin relatif au dossier "SVG" dans le dossier "Resources"

  // le code XML sera xlink:href="sample%20pictures/picture.gif"