The <feImage> SVG filter primitive fetches image data from an external source and provides the pixel data as output (meaning if the external source is an SVG image, it is rasterized.)
Usage context
| Categories | Filter primitive element |
|---|---|
| Permitted content | Any number of the following elements, in any order:<animate>, <animateTransform>, <set> |
Attributes
Global attributes
- Core attributes
- Presentation attributes
- Filter primitive attributes
- XLink attributes
classstyleexternalResourcesRequired
Specific attributes
DOM Interface
This element implements the SVGFEImageElement interface.
Example
SVG
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink">
<defs>
<filter id="image">
<feImage xlink:href="/files/6457/mdn_logo_only_color.png"/>
</filter>
</defs>
<rect x="10%" y="10%" width="80%" height="80%"
style="filter:url(#image);"/>
</svg>
Result
Specifications
| Specification | Status | Comment |
|---|---|---|
| Filter Effects Module Level 1 The definition of '<feImage>' in that specification. |
Working Draft | Added href attribute and deprecated xlink:href. Added crossorigin attribute. |
| Scalable Vector Graphics (SVG) 1.1 (Second Edition) The definition of '<feImage>' in that specification. |
Recommendation | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | 4.0 (2.0)[1] | (Yes) | 9.0 | ? |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | ? | ? | ? | ? |
[1] Partially supported, see bug 455986.
The chart is based on these sources.
See also
<filter><animate><animateTransform><set><feBlend><feColorMatrix><feComponentTransfer><feComposite><feConvolveMatrix><feDiffuseLighting><feDisplacementMap><feFlood><feGaussianBlur><feMerge><feMorphology><feOffset><feSpecularLighting><feTile><feTurbulence>- SVG tutorial: Filter effects
Document Tags and Contributors
Tags:
Contributors to this page:
abbycar,
Sebastianz,
iwarui,
chrisdavidmills,
Spaxe,
Jeremie,
kscarfone,
Manuel_Strehl
Last updated by:
abbycar,