7. Suffixes in use

SuffixFunction in Score Function in Staff group Function for Staff
...PieceName Title for the piece - -
...PieceNameTacet Piece title if no music is found - -
...Staff Used as staff/group - -
The following variables are only used if ...Staff is not defined (i.e. the staff is created by OrchestralLily):
...Music - - used as music for the staff
...Lyrics - - Lyrics assigned to music
...Settings - - music expression at beginning of staff
...Clef - - music expression at beginning of staff
...Key - - music expression at beginning of staff
...TimeSignature - - music expression at beginning of staff
...TransposeTo - - pitch, definition position of middle c’ for the piece
...InstrumentName - assigned as instr. name assigned as instr. name
...ShortInstrumentName - assigned as instr. name assigned as instr. name
...MidiInstrument - assigned as MIDI instr. assigned as MIDI instr.

The order in which these variables are looked up is also relevant. If you are printing the score for piece "PieceA" and the currently processed instrument/group is "Instr", OrchestralLily will test the following variable names (in this order):

  PieceAInstrSuffix
  InstrSuffix
  PieceASuffix

This particular order ensures that you can have a definition for each score-instrument combination, which overrides everything else (e.g. the definition of the music should probably use this variable). However, for piece titles, keys and so on, you can have one definition, which applies to all instruments in that piece (the third form). On the other hand, some instruments (e.g. transposing instruments) need some special settings, which should override the piece-wide settings (like the key). For this, the second form is provided.

In the following we will typically give the variable name in full form \PieceAInstrSuffix with the understanding that of course \InstrSuffix and \PieceASuffix will be used if the full form variable does not exist. If any part is written in square brackets [..], this indicates that this part is typically left out and instrument- or piece-wide variables are usually used in this place.

One word or care, though: Be careful with variables of the form \InstrStaff. If you define it, OrchestralLily will use that staff for the given instrument for each part of the whole work and never generate a staff for you!!! Similarly, if you define \PieceAStaff, all instruments in PieceA will get this staff, unless you manually define a staff for an instrument!

FIXME Add ...Transposition


Table of Contents

This document was generated by Reinhold Kainhofer on June, 4 2008 using texi2html 1.79.