# Image Rendering Reference

## Navigation:

Index General Information Elements Utils Examples

# The <image> Element

## Description:

The root element of the image template. It specifies the basic attributes (e.g. size, background) of the image to be generated as well as default values for font and color.

### Multiple Occurrences allowed: false

## Attributes

Name | Description | Inheritated | Possible Values | Default Value | Examples
--- | --- | --- | --- | --- | ---
colors | The color of the element or the contained text | false | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | false | nestedFields1
invert | Inverts the colors of the image | false | true|false | false | -
rotation | Defines the rotation of the image to output. The rotation is only available for 0, 90, 180 and 270 degrees | false | 0|90|180|270 | 0 | -
background-image | Defines a background image for the element. The path to the image should be given relative to the used template. If the image is too small the image gets clipped to the upper left corner | false | A path relative to the template file or a URL. (e.g. "../test/image.png or http://url.to/image.png") | No default value | -
width | The width of the element specified in pixels | false | A size value in pixel | No default value | -
height | The height of the element specified in pixels | false | A size value in pixel | No default value | -
background-color | The background color of the element | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | transparent | -
font-family | The name of the font to be used | true | A font name (e.g. Arial, Tahoma, Times New Roman, etc.) | arial | -
font-size | Specifies a set of font sizes separated by colon. The text will be rendered with the biggest possible (and specified) font size | true | A positive integer describing the font size in pt or multiple integers separated by a colon as alternative font seizes | 12 | -
font-style | Specifies whether the text should be printed normal or italic | true | normal | italic | normal | -
font-weight | Specifies whether the text should be printed normal or bold | true | normal | bold | normal | -
color | The color of the element or the contained text | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | black | -
condense | Automatically condenses text if it is too long using the best matching condense factor specified | true | One or more float numbers separated by a colon. | 1.0 | span1
line-spacing | Sets the spacing between text lines in pixel (negative values decrease the line spacing) | true | A positive or negative integer value | 0 | list1
clip-height | The height of the clipping area | false | A size value in pixel | No default value | -
clip-width | The width of the clipping area | false | A size value in pixel | No default value | -
clip-x | The x-coordinate of the clipping area | false | An integer value >= 0 and smaller than the specified image dimension | No default value | -
clip-y | The y-coordinate of the clipping area | false | An integer value >= 0 and smaller than the specified image dimension | No default value | -
wrap | Changes the line wrap of a text field. Normal: line wraps at spaces and dashes. None: no wrapped lines. | true | normal | none | normal | -
dithering | Enables or disables dithering for the resulting image | false | true|false | false | -

## Child Elements

field | | rect | | line | | triangle | | ellipse | | polygon