4D v14

SVG_Define_filter

Inicio

 
4D v14
SVG_Define_filter

SVG_Define_filter 


 

SVG_Define_filter ( objetoSVGPadre ; id {; marcoX ; marcoX {; anchoMarco ; altoMarco {; unidadMarco ; unidadFiltro}}}} ) -> Resultado 
Parámetro Tipo   Descripción
objetoSVGPadre  SVG_Ref in Referencia del elemento padre
id  Cadena in Nombre del símbolo
marcoX  Entero largo in Coordenada en el eje X
marcoX  Entero largo in Coordenada en el eje Y
anchoMarco  Entero largo in Ancho del rectángulo objetivo
altoMarco  Entero largo in Alto del rectángulo objetivo
unidadMarco  Cadena in Sistema de coordenadas del marco
unidadFiltro  Cadena in Sistema de valores del filtro
Resultado  SVG_Ref in Referencia del filtro

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:

 
PROPIEDADES 

Producto: 4D
Tema: Estructura y definiciones
Número 65988

 
HISTORIA 

Creado por: Composant 4D SVG v11.3

 
VER TAMBIÉN 

SVG_Filter_Blend
SVG_Filter_Blur
SVG_Filter_Offset
SVG_SET_FILTER

 
ARTICLE USAGE

4D SVG ( 4D v13)
4D SVG ( 4D v12)
4D SVG ( Composant 4D SVG v11.4)
4D SVG ( 4D v14 R2)
4D SVG ( 4D v14)
4D SVG ( 4D v14 R3)
4D SVG ( 4D v14 R4)