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. This may be relative to the size specified in the config using %, em, and ex.

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

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