6 Text and Lyrics

In Advanced GUIDO, arbitrary voice- and pagetext and lyrics can be specified. The \text tag is used to place arbitrary text at the current position within a voice. The \lyrics tag is used to specify complete lyrics for a melody. To place text at arbitrary positions on the page, use the \pagetext tag. Specialized versions of the \pagetext tag are the \title and \composer tags.

6.1 \text

This (purley graphical) tag places a text in the score. The text tag can be used either with or without ranges. When used with a range, the text is placed relative to position of the first event within the range. The spacing of the musical symbols following the range is adjusted, so that the text is printed completly within the range. When used without a range, the text is placed relative to the current time position. In this case, spacing is not adjusted and the current drawing position is not changed.

Parameters: (in the order of their default positions)

name (string; obligatory) - specifies the text;
Default value: none.
dx,dy (float; optional) - specify the offset w.r.t. the current position. The refercence position of the text is the left-top corner of the bounding box. The current horizontal position is dependant on the range: if no range is specified, it is the middle between the reference positions of the two events (e.g., notes) between which the \text tag appears; if a range is specified, it is the horizontal position of the first event within the range. The current vertical position is the lower edge of the lowest staff line. Default units are relative time units for dx and halfspaces for dy.
Default values: dx = 0, dy=0.
NB:arbitrary spacing can be enforced using \space tags before and/or after the \text tag.
size (float;optional) - the fontsize for the text. It is recommended to specify this size in points (e.g. 10pt). Note that not all fontsizes may be available on all systems for a specific font. If the size is specified in halfspaces, the font will be scaled proportionally to the staff-size. If no units are specfied, the units specified by the \units tag are used.
Default value: size=10pt
font (string,optional) - the fontname for the text. This parameter is system and application dependant.
Default value: None. System and plattform-dependant.

Range: optional; if a range is specified, the current position is the reference position of the first event in the range.

Remarks:

Examples:

6.2 \pageText

The purley graphcial \pageText tag is used to place text at arbitrary positions on the page. It is not dependant on the current time position or drawing position.

Parameters: (in the order of their default positions)

text (string,obligatory) - The text to display on the page.
Default value: None.
adjust (string; optional) - specifies the reference point on the page relative to which the composer text is positioned. The string is of the following form "vh", where v is one of the characters 't' (top margin of page), 'c' (center), 'b' (bottom margin of page) and v is one of 'l' (left margin of page), 'c' (center), 'r' (right margin of page). The reference point of the composer text is located at the text's bounding box analogously to the page reference point selected by adjust
Default value: "tl"
NB: The reference point refers to the physical dimensions of the page, not the the printable area.
dx,dy (float; optional) - specify the offset of the composer text w.r.t. the reference point is specified by the adjust parameter; the reference position of the composer text is located relative to its bounding box analogously to the page reference position on the page, i.e., for adjust="tl", the top left corner of the text bounding box is adjusted w.r.t. the top left corner of the page. Default units are as specified by the \units tag.
Default values: dx=0, dy unspecified, adjusted by the application according to the page size and margins such that the composer appears above the first system and collisions are avoided.
size (float;optional) - the fontsize for the text. It is recommended to specify this size in points (e.g. 10pt). Note that not all fontsizes may be available on all systems for a specific font. If the size is specified in halfspaces, the font will be scaled proportionally to the staff-size. If no units are specfied, the units specified by the \units tag are used.
Default value: size=10pt
font (string,optional) - the fontname for the text. This parameter is system and application dependant.
Default value: None. System and plattform-dependant.
repeat (string; optional) - allows symbol to be placed on multiple pages. The string has one of the values "once" (symbol appears only on current page), "all" (symbol appears on every page), "odd" (symbol appears only on odd numbered pages), or "even" (symbol appears only on even numbered pages).
Default value: "once".

Range: none.

Remarks:

Examples:

6.3 \composer

This tag specifies the composer of the piece and the position of this information on the current page.

Parameters (in the order of their default positions):

text (string; obligatory) - composer of the piece
adjust (string; optional) - specifies the reference point on the page relative to which the composer text is positioned. The string is of the following form "vh", where v is one of the characters 't' (top margin of page), 'c' (center), 'b' (bottom margin of page) and v is one of 'l' (left margin of page), 'c' (center), 'r' (right margin of page). The reference point of the composer text is located at the text's bounding box analogously to the page reference point selected by adjust
Default value: "tr"
NB: The reference point refers to the physical dimensions of the page, not the the printable area.
dx,dy (float; optional) - specify the offset of the composer text w.r.t. the reference point is specified by the adjust parameter; the reference position of the composer text is located relative to its bounding box analogously to the page reference position on the page, i.e., for adjust="tl", the top left corner of the text bounding box is adjusted w.r.t. the top left corner of the page. Default units are as specified by the \units tag.
Default values: dx=0, dy unspecified, adjusted by the application according to the page size and margins such that the composer appears above the first system and collisions are avoided.
font (string; optional) - font used for displaying the composer text
Default value: (unspecified, depends on application)
size (float;optional) - the fontsize for the text. It is recommended to specify this size in points (e.g. 10pt). Note that not all fontsizes may be available on all systems for a specific font. If the size is specified in halfspaces, the font will be scaled proportionally to the staff-size. If no units are specfied, the units specified by the \units tag are used.
Default value: size=10pt

Range: none

Remarks:

Usually appears once at the beginning of the first voice.

Examples:

...

6.4 \title

This tag specifies the title of the piece and its position on the current page.

\title<text,adjust,dx,dy,font,size>

Parameters (in the order of their default positions):

text (string; obligatory) - title of the piece
adjust (string; optional) - specifies the reference point on the page relative to which the title text is positioned. The string is of the following form "vh", where v is one of the characters 't' (top margin of page), 'c' (center), 'b' (bottom margin of page) and v is one of 'l' (left margin of page), 'c' (center), 'r' (right margin of page). The reference point of the title text is located at the text's bounding box analogously to the page reference point selected by adjust
Default value: "tc"
NB: The reference point refers to the physical dimensions of the page, not the the printable area.
dx,dy (float; optional) - specify the offset of the title text w.r.t. the reference point is specified by the adjust parameter; the reference position of the title text is located relative to its bounding box analogously to the page reference position on the page, i.e., for adjust="tl", the top left corner of the text bounding box is adjusted w.r.t. the top left corner of the page. Default units are as specified by the \units tag.
Default values: dx=0, dy unspecified, adjusted by the application according to the page size and margins such that the title appears above the first system and collisions are avoided.
font (string; optional) - font used for displaying the title text
Default value: (unspecified, depends on application)
size (float;optional) - the fontsize for the text. It is recommended to specify this size in points (e.g. 10pt). Note that not all fontsizes may be available on all systems for a specific font. If the size is specified in halfspaces, the font will be scaled proportionally to the staff-size. If no units are specfied, the units specified by the \units tag are used.
Default value: size=24pt

Range: none

Remarks:

Usually appears once at the beginning of the first voice.

Examples:

...

6.5 \lyrics

The \lyrics tag specifies lyrics belonging to voices. The \lyrics tag can be used to define complete verses for a voice at one place in the GUIDO description and not breaking the text into subsequent \text tags associated with events.

Parameters: (in the order of their default positions)

text (string; obligatory) - The lyrics for the following events. The string is mapped onto the following notes and rests according to the following rules:
- A " " (space) after a word (or syllable) progresses to the following event.
- A "~" (tilde) between characters specifies a blank within the lyrics. There is no progression to the following event. The tilde is used to place more than one word on a single note.
- A "-" (hyphen) progresses to the following event. The hyphen is also printed in the score.
- A "_" (underscore) progresses to the following event. The underscore is also printed in the score.
- A "<n>" progresses to the event that is marked with the \mark<n>-tag. If the <n> is proceeded by a hyphen ("-"), a series of hyphens is printed from the current event to the target event.

Default value:

verse (integer; optional) - This parameter defines which verse the given lyrics belong to. The verse parameter is an integer and defines the positioning of more than one verse (from lowest to highest). It does not add any numerals to the actual lyrics-string.
Default value: verse=1.
dx,dy (float; optional) - Specify the horizontal and vertical offset w.r.t. the current position. The reference position of the lyrics is the left-top corner of the bounding box. The current horizontal position is the horizontal position of the first event (e.g. note or rest) following the lyrics tag. The current vertical position is the lowest edge of the lowest staffline.
Default values: dx=0, dy=0.
font (string; optional) - The font that is used to print the lyrics. The font-names are plattform-specific; a special subset of font-names should be supported by all GUIDO implementations.
Default value: None. System and application dependant.
size (float; optional) - The size of the font that is used to print the lyrics. It is recommended to specify the fontsize in points (e.g. 10pt). It is also possible to specify fontsize in terms of halfspaces, so that changing the staffsize also changes the size of the lyrics. Note that not all fontsizes are supported with every font on all systems.
Default value: size=10pt.

Range: none.

Remarks:

Examples:

{ [ \lyrics<text="The green-<1> fox jumps o-ver_ the bridge", stanza=1,dx=0,dy=0,font="Helvetica",fontsize=10pt> c d/8 e f g e \mark<1> f/4 d c/8 d e f/4 c/2 ] }