# Image Rendering Reference

## Navigation:

Index General Information Elements Utils Examples

# The <field> Element

## Description:

The field element defines a rectangular container in which an image, text or a barcode can be placed. The position of the field can either be set by specifiying the x and y coordinates of the top left corner or by just setting the x coordinate. In the second case, the field is positioned exactly after the last field, which specified the y-coordinate (or 0, in case no field has a y-coordinate specified).

### Multiple Occurrences allowed: true

## Attributes

Name | Description | Inheritated | Possible Values | Default Value | Examples
--- | --- | --- | --- | --- | ---
rotation | A positive or negative rotation angle to rotate the corresponding field content | false | An integer value >= 0 and smaller than the specified image dimension | 0 | rotation1
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
x | The position of the element on the x-axis in pixels | false | An integer value >= 0 and smaller than the specified image dimension | No default value | -
y | The position of the element on the y-axis in pixels | false | An integer value >= 0 and smaller than the specified image dimension | No default value | -
width | The width of the element specified in pixels | true | A size value in pixel | No default value | -
height | The height of the element specified in pixels | true | A size value in pixel | No default value | -
max-height | Defines the maximum height of a field. This attribute is used in combination with a relative y-positioning. The height of the rendered field will be smaller or equal the specified maximum height value, depending on its content | false | An non-negative integer value (>0) | No default value | relative1, nestedFields1
background-color | The background color of the element | true | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | transparent | -
border | Specifies the thickness of the border around the element. A value of 0 means no border | false | An non-negative integer value (>0) | 0 | drawing1
border-color | Specifies the color of the used border | false | black | white | transparent | semi-colon separated RGBA string with values between 0 and 255 | black | -
border-style | Sets the line style of the border | false | dotted | dashed | solid | solid | -
align | Specifies the horizontal alignment of the element/text | true | left | right | center | justify | left | -
valign | Specifies the vertical alignment of the element/text | true | top | center | bottom | top | -
rounded-corners | Defines which of the corners should be rounded. Multiple corners can be specified using a colon (,) as separator. | false | top_left | top_right | bottom_left | bottom_right | No default value | drawing3
corner-radius | The radius of the rounded corners of the rectangle/field. Zero radius means no rounded corners. In case the corner radius is to large, it gets adjusted automatically. The maximum radius is (Min(width,height) - 1) / 2 | false | A size value in pixel | 0 | drawing3
wrap | Changes the line wrap of a text field. Normal: line wraps at spaces and dashes. None: no wrapped lines. | true | normal | none | normal | -

## Child Elements

field | | table | | barcode | | img | | label | | text | | rect | | line | | triangle | | ellipse | | polygon

## Examples

- 2,7" nested field example