BOX

Prints a filled box.

Example

EXT:my_extension/Configuration/Sets/Main/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

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/Sets/Main/setup.typoscript

align = c, b

color

color

Type: Colors in TypoScript GIFBUILDER / stdWrap
Default: black

Fill color of the box.

dimensions

dimensions

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

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.