result
The result
attribute defines the assigned name for this filter primitive. If supplied, then graphics that result from processing this filter primitive can be referenced by an in
attribute on a subsequent filter primitive within the same <filter>
element. If no value is provided, the output will only be available for re-use as the implicit input into the next filter primitive if that filter primitive provides no value for its in
attribute.
You can use this attribute with the following SVG elements:
<feBlend>
<feColorMatrix>
<feComponentTransfer>
<feComposite>
<feConvolveMatrix>
<feDiffuseLighting>
<feDisplacementMap>
<feDropShadow>
<feFlood>
<feGaussianBlur>
<feImage>
<feMerge>
<feMorphology>
<feOffset>
<feSpecularLighting>
<feTile>
<feTurbulence>
Example
<svg viewBox="0 0 220 220" xmlns="http://www.w3.org/2000/svg"> <filter id="displacementFilter"> <feTurbulence type="turbulence" baseFrequency="0.05" numOctaves="2" result="turbulence"/> <feDisplacementMap in2="turbulence" in="SourceGraphic" scale="50" xChannelSelector="R" yChannelSelector="G"/> </filter> <circle cx="100" cy="100" r="100" style="filter: url(#displacementFilter)"/> </svg>
Usage notes
Value | <filter-primitive-reference> |
---|---|
Default value | None |
Animatable | Yes |
<filter-primitive-reference>
-
This value is a
<custom-ident>
and defines the name for the filter primitive. It is only meaningful within a given<filter>
element and thus has only local scope. It is legal for the same<filter-primitive-reference>
to appear multiple times within the same<filter>
element. When referenced, this value will use the closest preceding filter primitive with the given result.
Specifications
Specification | Status | Comment |
---|---|---|
Filter Effects Module Level 1 The definition of 'result' in that specification. | Working Draft | Clarifies that the value is a <custom-ident> . |
Scalable Vector Graphics (SVG) 1.1 (Second Edition) The definition of 'result' in that specification. | Recommendation | Initial definition |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/result