SVG_New_image

4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant

version 11.3


SVG_New_image (objetSVGParent; url{; x; y{; largeur; hauteur}}) Ref_SVG

ParamètreTypeDescription
objetSVGParentRef_SVGRéférence de l'élément parent
urlChaîneAdresse de l'image
xNumériqueCoordonnée du coin supérieur gauche sur l'axe x
yNumériqueCoordonnée du coin supérieur gauche sur l'axe y
largeurNumériqueLargeur de l'image
hauteurNumériqueHauteur de l'image
RésultatRef_SVGRé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.


4D - Documentation   Français   English   German   Composant 4D SVG, Commandes par thèmes   4D SVG, Index   Retour   Précédent   Suivant