BOX

Prints a filled box.

Example

EXT:my_extension/Configuration/TypoScript/setup.typoscript
lib.example = IMAGE
lib.example {
  file = GIFBUILDER
  file {
    # Rectangle with 100 pixel width and 50 pixel height
    # in orange with opacity 50%
    10 = BOX
    10 {
      dimensions = 0, 0, 100, 50
      color = #ff8700
      opacity = 50
    }
  }
}

Properties

align

align
Data type

VHalign / stdWrap

Default

l, t

Pair of values, which defines the horizontal and vertical alignment of the box in the image.

Values:

Horizontal alignment:

l

left

c

center

r

right

Vertical alignment:

t

top

c

center

b

bottom

Example:

Horizontally centered, vertically at the bottom:

EXT:site_package/Configuration/TypoScript/setup.typoscript
align = c, b

color

color
Data type

GraphicColor / stdWrap

Default

black

Fill color of the box.

dimensions

dimensions
Data type

x,y,w,h +calc / stdWrap

Dimensions of a filled box.

x,y is the offset.

w,h are the dimensions. Dimensions of 1 will result in 1-pixel wide lines!

opacity

opacity
Data type

positive integer (1-100) / stdWrap

Default

100

The degree to which the box conceals the background.

Mathematically speaking: Opacity = Transparency^-1, i.e. 100% opacity = 0% transparency.