# Image Rendering Reference

## Navigation:

Index General Information Elements Utils Examples

# The <text> Element

## Description:

The text element specifies the properties for the containing text. The field element can contain multiple text elements. The text element's font properties are inheritated from the root image tag. In order to automatically fit multiple text elements into a field, leave out the y position attribute. The text then gets positioned one underneath the other (Note: be cautious with the auto-spacing attribute. In case of dynamic positioning the first text element uses the whole space of the field then.).

### Multiple Occurrences allowed: true

## Attributes

Name | Description | Inheritated | Possible Values | Default Value | Examples
--- | --- | --- | --- | --- | ---
class | A identifier of a CSS class. This identifier can be referenced via a CSS file. The same class identifier is meant to be used in multiple tags | false | String | No default value | css1
id | A identifier of the tag. This identifier can be referenced via a CSS file. This identifier has to be unique | false | String | No default value | css1
font-family | The name of the font to be used | true | A font name (e.g. Arial, Tahoma, Times New Roman, etc.) | arial | -
align | Specifies the horizontal alignment of the element/text | true | left | right | center | justify | left | -
padding-bottom | Specifies the padding in pixels from the bottom | true | A positive or negative integer value | 0 | -
padding-left | Specifies the padding in pixels from the left | true | A positive or negative integer value | 0 | -
padding-right | Specifies the padding in pixels from the right | true | A positive or negative integer value | 0 | -
padding-top | Specifies the padding in pixels from the top | true | A positive or negative integer value | 0 | -
background-color | The background color of the element | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | transparent | -
text-decoration | Specifies a decoration for the given text (underline, overline, linethrough or none) | true | underline | linethrough | none | none | span1
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
wrap | Changes the line wrap of a text field. Normal: line wraps at spaces and dashes. None: no wrapped lines. | true | normal | none | normal | -
letter-spacing | The letter-spacing attribute increases or decreases the space between characters in a text. | true | A possitive or negative float number | 0.0 | multiline1
superscript | Used to superscript or subscript a text | true | superscript | subscript | normal | normal | span1
outline | Specifies whether the text should be outlined or not | true | true|false | false | -
outline-color | Specifies the color of the text's outline | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | black | -
outline-thickness | Specifies the thickness of the text's outline | true | An non-negative integer value (>0) | 1 | -
outline-inside | This value determines, whether the outline should be drawn to the inside or outside of the corresponding text | true | true|false | false | -
shadow | Enables or disables the shadow | true | true|false | false | -
shadow-alpha | The alpha value (transparency) of the shadow | true | A positive float number >= 0 and <= 1 | 0.5 | -
shadow-color | Sets the color of the shadow | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | black | -
shadow-size | The size of the shadow in pixels | true | An non-negative integer value (>0) | 2 | -
shadow-blur | Whether the shadow should be rendered with or without blur effect | true | true|false | false | -

## Child Elements

#text | | br | | span | | ul | | ol

## Examples

- Single and Multi Line Example