SVG_Define_filter

4D v20 R10

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

Descrição

O comando SVG_Define_filter define um novo filtro no recipiente SVG designado por objetoSVGPai e devolve sua referencia. Se objetoSVGPai não é um documento SVG, é gerado um erro.

Um filtro é uma sucessão de operações gráficas que se aplicarão ao elemento de destino. O elemento filtro nunca se renderiza diretamente, se aplica a um objeto mediante o comando SVG_SET_FILTER.

O parâmetro id específica o nome do marcador. O nome se utiliza para associar um filtro com um objeto. Se existe um elemento com o mesmo nome, se substitui.

Os parâmetros opcionais marcoX, marcoY, largoMarco e altoMarco definem uma região retangular do documento ao que se aplica o filtro.

O parâmetro opcional unidadeMarco define o sistema de coordenadas dos 4 parâmetros anteriores. Os valores esperados: "userSpaceOnUse" ou "objectBoundingBox" (valor por padrão).

O parâmetro opcional unidadeFiltro define o sistema de coordenadas para as longitudes e as propriedades de definição do filtro. Os valores esperados são: "userSpaceOnUse" (valor por padrão) ou "objectBoundingBox".

Exemplo

Neste exemplo, queremos realizar as seguintes operações:

criar um retângulo com fundo azul 50%
criar um filtro blur 4% e aplicar a este retângulo
guardar o resultado em um arquivo SVG em 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")

 

  //criação de um retângulo fundo blur 4%

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

 SVG_Filter_Blur($Dom_filter;4)

 SVG_Filter_Offset($Dom_filter;4)

 

  //aplicação deste filtro ao retângulo

 SVG_SET_FILTER($Dom_rect;"blur")

 

  //guardar o resultado em um arquivo 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