4D v16

SVG_New_image

Accueil

 
4D v16
SVG_New_image

SVG_New_image 


 

SVG_New_image ( objetSVGParent ; url {; x ; y {; largeur ; hauteur}} ) -> Résultat 
Paramètre Type   Description
objetSVGParent  Ref_SVG in Référence de l’élément parent
url  Chaîne in Adresse de l’image
Entier long in Coordonnée du coin supérieur gauche sur l'axe x
Entier long in Coordonnée du coin supérieur gauche sur l'axe y
largeur  Entier long in Largeur de l’image
hauteur  Entier long in Hauteur de l’image
Résultat  Ref_SVG in Référence de l'image

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.

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

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)

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"



Voir aussi  

SVG_New_embedded_image
SVG_Open_picture

 
PROPRIÉTÉS 

Produit : 4D
Thème : Dessin
Numéro : 65969
Nom intl. : SVG_New_image

 
HISTORIQUE 

Créé : Composant 4D SVG v11.3
Modifié : 4D v14

 
UTILISATION DE L'ARTICLE

4D SVG ( 4D v16)