4D v15SVG_Define_filter |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v15
SVG_Define_filter
|
SVG_Define_filter ( objetoSVGPai ; id {; marcoX ; marcoY {; largoMarco ; altoMarco {; unidadeMarco ; unidadeFiltro}}}} ) -> Resultado | ||||||||
Parâmetro | Tipo | Descrição | ||||||
objetoSVGPai | Ref_SVG |
![]() |
Referencia do elemento pai | |||||
id | String |
![]() |
Nome do símbolo | |||||
marcoX | Inteiro longo |
![]() |
Coordenada no eixo X | |||||
marcoY | Inteiro longo |
![]() |
Coordenada no eixo Y | |||||
largoMarco | Inteiro longo |
![]() |
Largura do retângulo objetivo | |||||
altoMarco | Inteiro longo |
![]() |
Altura do retângulo objetivo | |||||
unidadeMarco | String |
![]() |
Sistema de coordenadas do marco | |||||
unidadeFiltro | String |
![]() |
Sistema de valores do filtro | |||||
Resultado | Ref_SVG |
![]() |
Referencia do filtro | |||||
The SVG_Define_filter command sets a new filter in the SVG container designated by parentSVGObject and returns its reference. If parentSVGObject is not an SVG document, an error is generated.
A filter is a succession of graphic operations that will be applied to the target element. The filter element is never rendered directly; it will be applied to an object using the SVG_SET_FILTER command.
The id parameter specifies the name of the marker. The name will be used to associate a filter with an object. If an element with the same name exists, it will be replaced.
The optional frameX, frameY, frameWidth and frameHeight parameters set a rectangular region in the document to which this filter will be applied.
The optional frameUnit parameter sets the coordinate system for the 4 previous parameters. Expected values: "userSpaceOnUse" or "objectBoundingBox" (default value).
The optional filterUnit parameter sets the coordinate system for the lenths and the filter definition properties. Expected values: "userSpaceOnUse" (default value) or "objectBoundingBox".
In this example, we want to perform the following operations:
$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")
//creation of 4% blur filter
$Dom_filter:=SVG_Define_filter($Dom_SVG;"blur")
SVG_Filter_Blur($Dom_filter;4)
SVG_Filter_Offset($Dom_filter;4)
//application of this filter to the rectangle
SVG_SET_FILTER($Dom_rect;"blur")
//saving result in an SVG file
SVG_SAVE_AS_TEXT($Dom_SVG;System folder(Desktop)+"test.svg")
SVG_CLEAR($Dom_SVG)
Result:
SVG_Filter_Blend
SVG_Filter_Blur
SVG_Filter_Offset
SVG_SET_FILTER