SVG_New_image

4D v20

SVG_New_image


SVG_New_image ( objetoSVGPadre ; url {; x ; y {; ancho ; alto}} ) -> Resultado

Parámetro	Tipo	Descripción
objetoSVGPadre	Ref_SVG	Referencia del elemento padre
url	Cadena	Dirección de la imagen
x	Entero largo	Coordenada de la esquina superior izquierda en el eje X
y	Entero largo	Coordenada de la esquina superior izquierda en el eje Y
ancho	Entero largo	Ancho de la imagen
alto	Entero largo	Alto de la imagen
Resultado	Ref_SVG	Referencia de la imagen

Descripción

El comando SVG_New_image permite referenciar una imagen en la dirección url en el contenedor SVG designado por objetoSVGPadre y devuelve su referencia. Si objetoSVGPadre no es un documento SVG, se genera un error.

El parámetro url especifica la ubicación de la imagen y puede tomar varias formas:

Un URL local (ruta de acceso de la forma: file://…): en este caso, la imagen sólo se mostrará si el archivo es realmente accesible en el momento de la renderización del objeto. Esta URL local puede ser relativa (de la forma: "#Imagenes/miImagen.png"), en este caso el comando prefija la ruta de acceso con la de la carpeta Resources de la base local. Si los parámetros ancho y alto se omiten, serán calculados por el comando (lo cual debe evitarse ya que esto hace que la ejecución del comando sea más lenta). En el caso de una ruta relativa, si no es válida, se genera un error.
Una URL no local (http://miSitio.com/imagenes/miImagen.jpeg ). En este caso, no se lleva a cabo la verificación de la validez del enlace y un error se generará si se omiten los parámetros ancho y alto.
Una URL relativa ("../picture.png"). Es particularmente importante en modo cliente/servidor cuando los archivos están en la carpeta resources. URLs relativos pueden comenzar por:
- "/", para indicar la ruta "~/Resources/SVG/"
- "./", para indicar la ruta "~/Resources/"
- "../", para indicar la carpeta de la base.

Los parámetros opcionales x e y permiten precisar la posición de la esquina superior derecha de la imagen en el contenedor SVG (valor por defecto: 0).

Los parámetros ancho y alto especifican el tamaño del rectángulo en el que se mostrará la imagen y así determinar el tamaño y el radio de aspecto de la imagen. Estos parámetros sólo son opcionales en el caso de una imagen referenciada por una ruta relativa en la carpeta Resources de la base local. Si ancho y/o alto es igual a 0, la imagen no se renderiza.

Ejemplo 1

Ubicar la imagen ‘logo4D.png’ ubicado en la carpeta 'Pictures’ de la carpeta ‘Resources’:

 svgRef:=SVG_New

 objectRef:=SVG_New_image(svgRef;"#Pictures/logo4D.png")

Ejemplo 2

Ubicar la imagen ‘4dlogo.gif’ accesible en el directorio ’pictures’ del sitio ‘4d.com’:

 svgRef:=SVG_New

 objectRef:=SVG_New_image(svgRef;"http://www.4d.com/pictures/4dlogo.gif";20;20;39;53)

Ejemplo 3

Estos son algunos ejemplos para acceder a imágenes utilizando las URLs relativas:

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

  // base es la carpeta "Resources"

  // el código XML será xlink:href="../images/picture.png"

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

  // base es la carpeta de la base

  // XML code will be xlink:href="../../picture.png"

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

  // base es la carpeta "SVG" en la carpeta "Resources"

  // el código XML será xlink:href="sample%20pictures/picture.gif"

Ver también

SVG_New_embedded_image
SVG_Open_picture