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.
Seventeen elements are using this attribute: <feBlend>, <feColorMatrix>, <feComponentTransfer>, <feComposite>, <feConvolveMatrix>, <feDiffuseLighting>, <feDisplacementMap>, <feDropShadow>, <feFlood>, <feGaussianBlur>, <feImage>, <feMerge>, <feMorphology>, <feOffset>, <feSpecularLighting>, <feTile>, and <feTurbulence>
html, body, svg {
height: 100%;
}
<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 |
