4.15 <image>
This element displays an image loaded from a file. It can load the common pixel graphic formats and SVG.
 |
|
The <image> element can read SVG images, but will render them as pixel graphics. If you want to get good scaling results or even SVG scripting, then use the <canvas> element instead. |
4.15.1 Attributes
| Name | Type | Default Value | Description |
|---|---|---|---|
| image-width | unit | The width of the image. The image will be scaled accordingly. | |
| image-height | unit | The height of the image. The image will be scaled accordingly. | |
| opacity | float | 1.0 | [new in 0.34.3] A floating point value greater than or equal to 0.0 and less than or equal to 1.0. 0.0 corresponds to invisible and 1.0 corresponds to fully opaque. |
| scale | float | 1.0 | A decimal value greater than 0 for the scaling factor of the image. A factor of 1.0 yields the original size. |
| uri | URI | The path of an image file in a supported file format. |
|
|
Use image-width or image-height alone to preserve the aspect ratio while scaling the image. |
4.15.2 Examples
...
<image uri="http://gdesklets.gnomedesktop.org/" scale="2.5"/>
...