4D v14

SVG_Define_filter

Página Inicial

 
4D v14
SVG_Define_filter

SVG_Define_filter 


 

SVG_Define_filter ( objetoSVGPai ; id {; marcoX ; marcoY {; largoMarco ; altoMarco {; unidadeMarco ; unidadeFiltro}}}} ) -> Resultado 
Parâmetro Tipo   Descrição
objetoSVGPai  SVG_Ref in Referencia do elemento pai
id  cadeia in Nome do símbolo
marcoX  Inteiro longo in Coordenada no eixo X
marcoY  Inteiro longo in Coordenada no eixo Y
largoMarco  Inteiro longo in Largura do retângulo objetivo
altoMarco  Inteiro longo in Altura do retângulo objetivo
unidadeMarco  cadeia in Sistema de coordenadas do marco
unidadeFiltro  cadeia in Sistema de valores do filtro
Resultado  SVG_Ref in Referencia do filtro

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:

 
PROPRIEDADES 

Produto: 4D
Tema: Estrutura e definições
Número 65988

 
HISTÓRIA 

Criado por: Composant 4D SVG v11.3

 
VER TAMBÉM 

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)