Image Rendering Reference

Navigation:

IndexGeneral InformationElementsUtilsExamples

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