SVG_Use

4D v20 R7

SVG_Use


SVG_Use ( objetoSVGPadre ; id {; x ; y ; ancho ; alto {; modo}} ) -> Resultado

Parámetro	Tipo	Descripción
objetoSVGPadre	Ref_SVG	Referencia del elemento padre
id	Cadena	Nombre del símbolo
x	Entero largo	Posición X del rectángulo de visualización
y	Entero largo	Posición Y del rectángulo de visualización
ancho	Entero largo	Ancho del rectángulo de visualización
alto	Entero largo	Alto del rectángulo de visualización
modo	Cadena	Adaptación al rectángulo de visualización
Resultado	Ref_SVG	Referencia del objeto SVG

Descripción

El comando SVG_Use pone una ocurrencia del símbolo en el contenedor SVG designado por objetoSVGPadre y devuelve su referencia. Si objetoSVGPadre no es un documento SVG o si id no es el nombre de un objeto del documento SVG, se genera un error.

Un símbolo se utiliza para definir los objetos gráficos, nunca renderiza directamente, pero puede crear ser instanciado mediante el comando SVG_Use.

El parámetro id específica el nombre del símbolo.

Los parámetros opcionales x, y, ancho y alto especifican el rectángulo del área de visualización (atributo 'Viewbox').

El parámetro opcional modo permite indicar si el gráfico debe adaptarse y cómo, al tamaño del rectángulo de visualización. (Ver el comando SVG_New).

Ejemplo

Definimos un gráfico compuesto de dos círculos rojos y dos cuadrados azules. Luego utilizamos este gráfico en un bucle para crear 36 ocurrencias con diferentes posiciones, opacidad y rotación.

 $SVG:=SVG_New

  `Dibujo del fondo

 SVG_New_rect($SVG;20;20;650;650;0;0;"gray";"lemonchiffon")

  `Definición de un símbolo compuesto por 2 cuadrados y 2 círculos

 $Symbol:=SVG_Define_symbol($SVG;"MySymbol";0;0;110;110;"true")

 SVG_New_circle($Symbol;30;30;25;"red";"palevioletred")

 SVG_New_rect($Symbol;10;60;40;40;0;0;"blue";"cornflowerblue")

 SVG_New_rect($Symbol;60;10;40;40;0;0;"blue";"cornflowerblue")

 SVG_New_circle($Symbol;80;80;25;"red";"palevioletred")

  `En un grupo…

 $g:=SVG_New_group($SVG)

  `…posicionado a 20 unidades de la esquina superior izquierda del documento…

 SVG_SET_TRANSFORM_TRANSLATE($g;20;20)

  `…poner 36 patrones variando la posición, opacidad y rotación

 For($x;0;540;90)&NBSP;&NBSP; `6 columnas

    For($y;0;540;90)&NBSP;&NBSP;&NBSP; `6 líneas

       $use:=SVG_Use($g;"MySymbol";$x;$y;110;110)

       SVG_SET_OPACITY($use;100-($y/12)+($x/12)

       SVG_SET_TRANSFORM_ROTATE($use;($x*(18/50))+($y*(18/50));($x+55);($y+55))

    End for

 End for

Ver también

SVG_Define_symbol