# Directives: start_of_textblock

This directive indicates that the lines that follow define a piece of text that is combined into a single object that can be placed as an image.

For example

{start_of_textblock align=right flush=right}
She died of the fever,
and nothing could save her
And that was the end of sweet Molly Malone
{end_of_textblock}

The result could look like:

(The text at the left are ordinary chords and lyrics.)

# Attributes

The textblock directive may contain the same formatting attributes as the image directive, for example:

{start_of_textblock label="Verse 2" align="left"}

See Directives: Image for all possible attributes.

Additionally, the following attributes may be used:

• width="n"
  The width of the resultant object.
  Defaults to the actual width (tight fit) of the texts.
  Note that the object can only be made wider, not smaller.

• height="n"
  The height of the resultant object.
  Defaults to the actual height of the text, including the advance of the last line (non-tight fit).
  Note that the object can only be made higher, not smaller.
  When height or padding is set, a tight fit is used.

• padding="n"
  Provides padding between the object and the inner text.
  When height or padding is set, a tight fit is used.

• flush="flush"
  Horizontal text flush (left, center, right).

• vflush="vflush"
  Vertical text flush (top, middle, bottom).

• textstyle="style"
  Style (font) to be used. Must be one of the printable items as defined in the config.
  Default style is text.

• textsize="n"
  Initial value for the text size.

• textcolor="colour"
  Initial value for the text colour.

• background="colour"
  The background color of the object.