|
Score
This is the top level notation context. No other context can
contain a Score context. This context handles the
administration of time signatures. It also makes sure that items
such as clefs, time signatures, and key-signatures are aligned
across staves. It can contain Lyrics , Staff ,
RhythmicStaff , GrandStaff , StaffGroup , and
ChoirStaff contexts.
You cannot explicitly instantiate a Score context (since it is
not contained in any other context). It is instantiated
automatically when an output definition (a score or
paper block) is processed.
This context creates the following grobs:
Arpeggio, BarNumber, BreakAlignGroup, BreakAlignment, LeftEdge, NonMusicalPaperColumn, PaperColumn, RehearsalMark, SpacingSpanner, SystemStartBar, SystemStartBrace, SystemStartBracket, System and VerticalAlignment.
This context sets the following properties:
- Set translator property tablatureFormat to
fret-number-tablature-format
- Set translator property stringTunings to
'(4 -1 -5 -10 -15 -20)
- Set translator property highStringOne to
#t
- Set translator property stringOneTopmost to
#t
- Set translator property chordNameExceptions to
'(((#<Pitch e' > #<Pitch gis' >) #<procedure line-markup (grob props . rest)> ((#<procedure simple-markup (grob props . rest)> +))) ((#<Pitch ees' > #<Pitch ges' >) #<procedure line-markup (grob props . rest)> ((#<procedure super-markup (grob props . rest)> (#<procedure simple-markup (grob props . rest)> o)))) ((#<Pitch ees' > #<Pitch ges' > #<Pitch bes' >) #<procedure line-markup (grob props . rest)> ((#<procedure super-markup (grob props . rest)> (#<procedure combine-markup (grob props . rest)> (#<procedure simple-markup (grob props . rest)> o) (#<procedure simple-markup (grob props . rest)> /))))) ((#<Pitch ees' > #<Pitch ges' > #<Pitch beses' >) #<procedure line-markup (grob props . rest)> ((#<procedure super-markup (grob props . rest)> (#<procedure simple-markup (grob props . rest)> o7)))))
- Set translator property chordNameSeparator to
'(#<procedure simple-markup (grob props . rest)> /)
- Set translator property majorSevenSymbol to
'(#<procedure override-markup (grob props . rest)> (font-family . math) (#<procedure simple-markup (grob props . rest)> M))
- Set translator property chordNameFunction to
ignatzek-chord-names
- Set translator property barCheckSynchronize to
#t
- Set translator property breakAlignOrder to
'(instrument-name left-edge ambitus span-bar breathing-sign clef key-signature staff-bar time-signature custos)
- Set translator property keyAccidentalOrder to
'((6 . -1) (2 . -1) (5 . -1) (1 . -1) (4 . -1) (0 . -1) (3 . -1) (3 . 1) (0 . 1) (4 . 1) (1 . 1) (5 . 1) (2 . 1) (6 . 1) (6 . -2) (2 . -2) (5 . -2) (1 . -2) (4 . -2) (0 . -2) (3 . -2) (3 . 2) (0 . 2) (4 . 2) (2 . 2) (5 . 2) (2 . 2) (6 . 2))
- Set translator property autoCautionaries to
'()
- Set translator property autoAccidentals to
'(Staff (same-octave . 0))
- Set translator property extraNatural to
#t
- Set translator property subdivideBeams to
#f
- Set translator property tupletNumberFormatFunction to
denominator-tuplet-formatter
- Set translator property pedalSostenutoStrings to
'(Sost. Ped. *Sost. Ped. *)
- Set translator property pedalUnaCordaStrings to
'(una corda tre corde)
- Set translator property pedalSustainStrings to
'(Ped. *Ped. *)
- Set translator property verticalAlignmentChildCallback to
Align_interface::alignment_callback
- Set translator property scriptDefinitions to
'((thumb (script-molecule feta thumb . thumb) (direction . 1)) (accent (script-molecule feta sforzato . sforzato) (side-relative-direction . -1)) (marcato (script-molecule feta dmarcato . umarcato) (side-relative-direction . -1)) (staccatissimo (script-molecule feta dstaccatissimo . ustaccatissimo) (side-relative-direction . -1)) (portato (script-molecule feta dportato . uportato) (side-relative-direction . -1)) (fermata (script-molecule feta dfermata . ufermata) (direction . 1)) (stopped (script-molecule feta stopped . stopped) (direction . 1)) (staccato (script-molecule feta staccato . staccato) (side-relative-direction . -1) (follow-into-staff . #t) (priority . -100)) (tenuto (script-molecule feta tenuto . tenuto) (follow-into-staff . #t) (side-relative-direction . -1)) (comma (script-molecule feta lcomma . rcomma) (follow-into-staff . #t) (direction . 1)) (upbow (script-molecule feta upbow . upbow) (direction . 1)) (downbow (script-molecule feta downbow . downbow) (direction . 1)) (lheel (script-molecule feta upedalheel . upedalheel) (direction . -1)) (rheel (script-molecule feta dpedalheel . dpedalheel) (direction . 1)) (ltoe (script-molecule feta upedaltoe . upedaltoe) (direction . -1)) (rtoe (script-molecule feta dpedaltoe . dpedaltoe) (direction . 1)) (turn (script-molecule feta turn . turn) (direction . 1)) (open (script-molecule feta open . open) (direction . 1)) (flageolet (script-molecule feta flageolet . flageolet) (direction . 1)) (reverseturn (script-molecule feta reverseturn . reverseturn) (direction . 1)) (trill (script-molecule feta trill . trill) (direction . 1) (priority . 2000)) (prall (script-molecule feta prall . prall) (direction . 1)) (mordent (script-molecule feta mordent . mordent) (direction . 1)) (prallprall (script-molecule feta prallprall . prallprall) (direction . 1)) (prallmordent (script-molecule feta prallmordent . prallmordent) (direction . 1)) (upprall (script-molecule feta upprall . upprall) (direction . 1)) (downprall (script-molecule feta downprall . downprall) (direction . 1)) (upmordent (script-molecule feta upmordent . upmordent) (direction . 1)) (downmordent (script-molecule feta downmordent . downmordent) (direction . 1)) (lineprall (script-molecule feta lineprall . lineprall) (direction . 1)) (pralldown (script-molecule feta pralldown . pralldown) (direction . 1)) (prallup (script-molecule feta prallup . prallup) (direction . 1)) (segno (script-molecule feta segno . segno) (direction . 1)) (coda (script-molecule feta coda . coda) (direction . 1)))
- Set translator property autoBeaming to
#t
- Set translator property autoBeamSettings to
'(((end * * 3 2) . #<Mom 1/2 >) ((end 1 16 3 2) . #<Mom 1/4 >) ((end 1 32 3 2) . #<Mom 1/8 >) ((begin 1 8 3 4) . #<Mom 1/4 >) ((end * * 3 4) . #<Mom 3/4 >) ((begin 1 16 3 4) . #<Mom 1/16 >) ((end 1 16 3 4) . #<Mom 1/4 >) ((end 1 32 3 4) . #<Mom 1/8 >) ((begin 1 16 3 8) . #<Mom 1/8 >) ((end * * 3 8) . #<Mom 3/8 >) ((end * * 4 4) . #<Mom 1/2 >) ((end 1 12 4 4) . #<Mom 1/4 >) ((end 1 16 4 4) . #<Mom 1/4 >) ((end 1 32 4 4) . #<Mom 1/8 >) ((end * * 2 4) . #<Mom 1/4 >) ((end 1 12 2 4) . #<Mom 1/4 >) ((end 1 16 2 4) . #<Mom 1/4 >) ((end 1 32 2 4) . #<Mom 1/8 >) ((end * * 4 8) . #<Mom 1/4 >) ((end 1 16 4 8) . #<Mom 1/4 >) ((end 1 32 4 8) . #<Mom 1/8 >) ((end * * 4 16) . #<Mom 1/8 >) ((end * * 6 8) . #<Mom 3/8 >) ((end 1 16 6 8) . #<Mom 3/8 >) ((end 1 32 6 8) . #<Mom 1/8 >) ((end * * 9 8) . #<Mom 3/8 >) ((end 1 16 9 8) . #<Mom 3/8 >) ((end 1 32 9 8) . #<Mom 1/8 >) ((end * * 12 8) . #<Mom 3/8 >) ((end 1 16 12 8) . #<Mom 3/8 >) ((end 1 32 12 8) . #<Mom 1/8 >))
- Set translator property explicitKeySignatureVisibility to
all-visible
- Set translator property explicitClefVisibility to
all-visible
- Set translator property barNumberVisibility to
default-bar-number-visibility
- Set translator property defaultBarType to
|
- Set translator property automaticMelismata to
#t
- Set translator property automaticPhrasing to
#t
- Set translator property centralCPosition to
-6
- Set translator property clefPosition to
-2
- Set translator property clefGlyph to
clefs-G
- Set translator property systemStartDelimiter to
'SystemStartBar
- Set translator property changeMoment to
'(#<Mom 0 > . #<Mom 1/512 >)
- Set translator property splitInterval to
'(0 . 1)
- Set translator property soloADue to
#t
- Set translator property aDueText to
a2
- Set translator property soloIIText to
Solo II
- Set translator property soloText to
Solo
- Set translator property localKeySignature to
'()
Context Score can contain
FiguredBass, NoteNames, PianoStaff, ChoirStaff, GrandStaff, ChordNames, Lyrics, RhythmicStaff, StaffGroup, StaffContainer, TabStaff and Staff
This context is built from the following engravers:
- Score_engraver
- Top level engraver. Takes care of generating columns and the complete system (ie. System)
This engraver decides whether a column is breakable. The default is that a column is always breakable. However, when every Bar_engraver that does not have a barline at a certain point will call Score_engraver::forbid_breaks to stop linebreaks. In practice, this means that you can make a breakpoint by creating a barline (assuming that there are no beams or notes that prevent a breakpoint.)
Music types accepted:
break-event
Properties (read)
currentCommandColumn (grob (GRaphical OBject))
- Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
currentMusicalColumn (grob (GRaphical OBject))
- Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).
This engraver creates the following grobs:
NonMusicalPaperColumn, PaperColumn and System.
- Span_arpeggio_engraver
-
Properties (read)
connectArpeggios (boolean)
- If
set, connect all arpeggios that are found. In this way, you can make
arpeggios that cross staves.
This engraver creates the following grobs:
Arpeggio.
- Bar_number_engraver
- A bar number is created whenever measurePosition is zero. It is
put on top of all staves, and appears only at left side of the staff.
Properties (read)
barNumberVisibility (procedure)
- Procedure that takes an int and returns whether the corresponding bar number should be printed
stavesFound (list)
- list of all staff-symbols found.
currentBarNumber (integer)
- Contains the current barnumber. This property is incremented at
every barline.
This engraver creates the following grobs:
BarNumber.
- Lyric_phrasing_engraver
- This engraver combines note heads and lyrics for alignment.
This engraver is switched on by default. Turn it off for faster processing of orchestral scores.
Properties (read)
phrasingPunctuation (string)
-
associatedVoice (string)
- Name of the Voice that has the melody for this LyricsVoice.
melismaEngraverBusy (boolean)
- See melismaBusy. This is set automatically.
automaticPhrasing (boolean)
- If set,
the Lyric_phrasing_engraver will match note heads of context
called Voice X to syllables from LyricsVoice called
X-<something>. This feature is turned on by default. See the example
file
lyrics-multi-stanza.ly .
- Vertical_align_engraver
- Catch Vertical axis groups and stack them.
This engraver creates the following grobs:
VerticalAlignment.
- Spacing_engraver
- make a SpacingSpanner and do bookkeeping of shortest starting and playing notes
This engraver creates the following grobs:
SpacingSpanner.
- Break_align_engraver
- Align grobs with corresponding break-align-symbols into groups, and order the groups according to breakAlignOrder
Properties (read)
breakAlignOrder (list)
- Defines the order in which
prefatory matter (clefs, key signatures) appears, eg. this puts the
key signatures after the bar lines:
\property Score.breakAlignOrder = #'(
span-bar
breathing-sign
clef
staff-bar
key
time-signature
)
This engraver creates the following grobs:
BreakAlignGroup, BreakAlignment and LeftEdge.
- Mark_engraver
-
Music types accepted:
mark-event
Properties (read)
stavesFound (list)
- list of all staff-symbols found.
rehearsalMark (number or string)
-
This engraver creates the following grobs:
RehearsalMark.
- System_start_delimiter_engraver
- Creates a system start delimiter (ie. SystemStart{Bar,Brace,Bracket} spanner
Properties (read)
systemStartDelimiter (symbol)
- Which grob to make for the start of the system/staff?
This engraver creates the following grobs:
SystemStartBar, SystemStartBrace and SystemStartBracket.
- Output_property_engraver
- Interpret Music of Output_property type, and apply a function to any Graphic objects that satisfies the predicate.
Music types accepted:
layout-instruction
- Timing_engraver
- Responsible for synchronizing timing information from staves. Normally in
Score . In order to create polyrhythmic music, this engraver should be removed from Score and placed in Staff .
Properties (read)
currentBarNumber (integer)
- Contains the current barnumber. This property is incremented at
every barline.
measurePosition (moment)
- How much
of the current measure (measured in whole notes) have we had. This
can be set manually to create incomplete measures (anacrusis, upbeat),
the start of the music.
measureLength (moment)
- Length of one
measure in the current time signature last?
oneBeat (moment)
- How long does one beat in the current time signature last?
timing (boolean)
- Keep administration of measure length, position, bar number, etc?
Switch off for cadenzas.
skipBars (boolean)
- Set to true to
skip the empty bars that are produced by multimeasure notes and rests.
These bars will not appear on the printed output. If not set (the
default) multimeasure notes and rests expand into their full length,
printing the appropriate number of empty bars so that synchronization
with other voices is preserved.
@lilypond[fragment,verbatim,center]
r1 r1*3 R1*3 \\property Score.skipBars= ##t r1*3 R1*3
@end lilypond
defaultBarType (string)
- Sets the default type of bar line. Available bar types: [FIXME];
This variable is typically read at Score level, so overriding
Staff.defaultBarType will have no effect.
barAlways (boolean)
- If set to true a bar line is drawn after each note.
whichBar (string)
- This property is read to determine what type of barline to create.
Example:
\property Staff.whichBar = "|:"
This will create a start-repeat bar in this staff only.
If not set explicitly (by property or bar ), this is set
according to values of defaultBarType , barAlways ,
barNonAuto and measurePosition .
Valid values are described in (lilypond-internals)bar-line-interface.
.
barNonAuto (boolean)
- If set to true then bar lines will not be printed
automatically; they must be explicitly created with
bar
keywords. Unlike with the cadenza keyword, measures are
still counted. Bar generation will resume according to that
count if this property is set to zero.
timeSignatureFraction (pair of numbers)
-
pair of numbers, signifying the time signature. For example #'(4 . 4) is a 4/4time signature.
- Staff_collecting_engraver
- Maintain the stavesFound variable
Properties (read)
stavesFound (list)
- list of all staff-symbols found.
Properties (write)
stavesFound (list)
- list of all staff-symbols found.
- Repeat_acknowledge_engraver
- Acknowledge repeated music, and convert the contents of repeatCommands ainto an appropriate setting for whichBar.
Properties (read)
whichBar (string)
- This property is read to determine what type of barline to create.
Example:
\property Staff.whichBar = "|:"
This will create a start-repeat bar in this staff only.
If not set explicitly (by property or bar ), this is set
according to values of defaultBarType , barAlways ,
barNonAuto and measurePosition .
Valid values are described in (lilypond-internals)bar-line-interface.
.
repeatCommands (list)
- This property is read to find any command of the form (volta . X), where X is a string or #f
|