4D v14

SVG_New_image

Inicio

 
4D v14
SVG_New_image

SVG_New_image 


 

SVG_New_image ( objetoSVGPadre ; url {; x ; y {; ancho ; alto}} ) -> Resultado 
Parámetro Tipo   Descripción
objetoSVGPadre  SVG_Ref in Referencia del elemento padre
url  Cadena in Dirección de la imagen
Entero largo in Coordenada de la esquina superior izquierda en el eje X
Entero largo in Coordenada de la esquina superior izquierda en el eje Y
ancho  Entero largo in Ancho de la imagen
alto  Entero largo in Alto de la imagen
Resultado  SVG_Ref in Referencia de la imagen

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.

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

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)

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"

 
PROPIEDADES 

Producto: 4D
Tema: Dibujo
Número 65969

 
HISTORIA 

New
Creado por: Composant 4D SVG v11.3
Modificado: 4D v14

 
VER TAMBIÉN 

SVG_New_embedded_image
SVG_Open_picture

 
ARTICLE USAGE

4D SVG ( 4D v14)

Inherited from : SVG_New_image ( 4D v13)