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.
Whenheight
orpadding
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 istext
. -
textsize="
n"
Initial value for the text size. This may be relative to the size specified in the config using%
,em
, andex
. -
textcolor="
colour"
Initial value for the text colour. -
background="
colour"
The background color of the object.