SVG_Define_filter

4D v16

SVG_Define_filter


SVG_Define_filter ( objetoSVGPadre ; id {; marcoX ; marcoX {; anchoMarco ; altoMarco {; unidadMarco ; unidadFiltro}}}} ) -> Resultado

Parámetro	Tipo	Descripción
objetoSVGPadre	Ref_SVG	Referencia del elemento padre
id	Cadena	Nombre del símbolo
marcoX	Entero largo	Coordenada en el eje X
marcoX	Entero largo	Coordenada en el eje Y
anchoMarco	Entero largo	Ancho del rectángulo objetivo
altoMarco	Entero largo	Alto del rectángulo objetivo
unidadMarco	Cadena	Sistema de coordenadas del marco
unidadFiltro	Cadena	Sistema de valores del filtro
Resultado	Ref_SVG	Referencia del filtro

Descripción

El comando SVG_Define_filter define un nuevo filtro en el contenedor SVG designado por objetoSVGPadre y devuelve su referencia. Si objetoSVGPadre no es un documento SVG, se genera un error.

Un filtro es una sucesión de operaciones gráficas que se aplicarán al elemento de destino. El elemento filtro nunca se renderiza directamente, se aplica a un objeto mediante el comando SVG_SET_FILTER.

El parámetro id específica el nombre del marcador. El nombre se utiliza para asociar un filtro con un objeto. Si existe un elemento con el mismo nombre, se reemplazará.

Los parámetros opcionales marcoX, marcoY, largoMarco y anchoMarco definen una región rectangular del documento al que se apllca el filtro.

El parámetro opcional unidadMarco define el sistema de coordenadas de los 4 parámetros anteriores. Los valores esperados: "userSpaceOnUse" u "objectBoundingBox" (valor por defecto).

El parámetro opcional unidadFiltro define el sistema de coordenadas para las longitudes y las propiedades de definición del filtro. Los valores esperados son: "userSpaceOnUse" (valor por defecto) u "objectBoundingBox".

Ejemplo

En este ejemplo, queremos efectuar las siguientes operaciones:

crear un rectángulo con fondo azul 50%
crear un filtro blur 4% y aplicarlo a este rectángulo
guardar el resultado en un archivo SVG en disco.

 $Dom_SVG:=SVG_New

 

  //creation of a rectangle with 50% blue background

 $Dom_rect:=SVG_New_rect($Dom_SVG;50;50;50;50;0;0;"blue:50";"blue:50")

 

  //creación de un rectángulo fondo blur 4%

 $Dom_filter:=SVG_Define_filter($Dom_SVG;"blur")

 SVG_Filter_Blur($Dom_filter;4)

 SVG_Filter_Offset($Dom_filter;4)

 

  //aplicación de este filtro al rectángulo

 SVG_SET_FILTER($Dom_rect;"blur")

 

  //guardar el resultado en un archivo SVG

 SVG_SAVE_AS_TEXT($Dom_SVG;System folder(Desktop)+"test.svg")

 

 SVG_CLEAR($Dom_SVG)

Resultado:

Ver también

SVG_Filter_Blend
SVG_Filter_Blur
SVG_Filter_Offset
SVG_SET_FILTER