[ << Translation ] | [Top][Contents][Index][ ? ] | [ Backend >> ] | ||
[ < TabStaff ] | [ Up : Contexts ] | [ VaticanaStaff > ] |
2.1.23 TabVoice
Context for drawing notes in a Tab staff.
This context also accepts commands for the following context(s):
Voice.
This context creates the following layout object(s):
Arpeggio, Beam, BendAfter, BreathingSign, ClusterSpannerBeacon, ClusterSpanner, CombineTextScript, Dots, DoublePercentRepeatCounter, DoublePercentRepeat, DynamicLineSpanner, DynamicTextSpanner, DynamicText, Glissando, Hairpin, HarmonicParenthesesItem, InstrumentSwitch, LaissezVibrerTieColumn, LaissezVibrerTie, LigatureBracket, MultiMeasureRestNumber, MultiMeasureRestText, MultiMeasureRest, NoteColumn, NoteSpacing, PercentRepeatCounter, PercentRepeat, PhrasingSlur, RepeatSlash, RepeatTieColumn, RepeatTie, Rest, ScriptColumn, Script, Slur, StemTremolo, Stem, TabNoteHead, TextScript, TextSpanner, TieColumn, Tie, TrillPitchAccidental, TrillPitchGroup, TrillPitchHead, TrillSpanner, TupletBracket, TupletNumber and VoiceFollower.
This context sets the following properties:
- Set grob-property
gap
in Glissando to0.2
. - Set grob-property
extra-dy
in Glissando to0.75
. - Set grob-property
bound-details left
in Glissando to'((attach-dir . 1) (padding . 0.3))
. - Set grob-property
bound-details right
in Glissando to'((attach-dir . -1) (padding . 0.3))
. - Set grob-property
extra-dy
in Glissando to0.75
. - Set grob-property
length-fraction
in Beam to0.62
. - Set grob-property
thickness
in Beam to0.32
. - Set translator property
localKeySignature
to'()
.
This context is a ‘bottom’ context; it cannot contain other contexts.
This context is built from the following engraver(s):
Tab_harmonic_engraver
In a tablature, parenthesize objects whose music cause has the
parenthesize
property.This engraver creates the following layout object(s):
Tab_note_heads_engraver
Generate one or more tablature noteheads from event of type
NoteEvent
.Music types accepted:
string-number-event and note-event
Properties (read)
middleCPosition
(number)The place of the middle C, measured in half staff-spaces. Usually determined by looking at
middleCClefPosition
andmiddleCOffset
.stringTunings
(list)The tablature strings tuning. It is a list of the pitch (in semitones) of each string (starting with the lower one).
minimumFret
(number)The tablature auto string-selecting mechanism selects the highest string with a fret at least
minimumFret
.tablatureFormat
(procedure)A function formatting a tablature note head. Called with three arguments: string number, context and event. It returns the text as a string.
highStringOne
(boolean)Whether the first string is the string with highest pitch on the instrument. This used by the automatic string selector for tablature notation.
stringOneTopmost
(boolean)Whether the first string is printed on the top line of the tablature.
This engraver creates the following layout object(s):
Skip_event_swallow_translator
Swallow
\skip
.Instrument_switch_engraver
Create a cue text for taking instrument.
Properties (read)
instrumentCueName
(markup)The name to print if another instrument is to be taken.
This engraver creates the following layout object(s):
Grace_engraver
Set font size and other properties for grace notes.
Properties (read)
graceSettings
(list)Overrides for grace notes. This property should be manipulated through the
add-grace-property
function.Tuplet_engraver
Catch tuplet events and generate appropriate bracket.
Music types accepted:
Properties (read)
tupletFullLength
(boolean)If set, the tuplet is printed up to the start of the next note.
tupletFullLengthNote
(boolean)If set, end at the next note, otherwise end on the matter (time signatures, etc.) before the note.
This engraver creates the following layout object(s):
Tie_engraver
Generate ties between note heads of equal pitch.
Music types accepted:
Properties (read)
tieWaitForNote
(boolean)If true, tied notes do not have to follow each other directly. This can be used for writing out arpeggios.
Properties (write)
tieMelismaBusy
(boolean)Signal whether a tie is present.
This engraver creates the following layout object(s):
Slur_engraver
Build slur grobs from slur events.
Music types accepted:
Properties (read)
slurMelismaBusy
(boolean)Signal if a slur is present.
doubleSlurs
(boolean)If set, two slurs are created for every slurred note, one above and one below the chord.
This engraver creates the following layout object(s):
Slur.
Cluster_spanner_engraver
Engrave a cluster using
Spanner
notation.Music types accepted:
This engraver creates the following layout object(s):
Phrasing_slur_engraver
Print phrasing slurs. Similar to Slur_engraver.
Music types accepted:
This engraver creates the following layout object(s):
Spanner_break_forbid_engraver
Forbid breaks in certain spanners.
Note_spacing_engraver
Generate
NoteSpacing
, an object linking horizontal lines for use in spacing.This engraver creates the following layout object(s):
Rhythmic_column_engraver
Generate
NoteColumn
, an object that groups stems, note heads, and rests.This engraver creates the following layout object(s):
Script_column_engraver
Find potentially colliding scripts and put them into a
ScriptColumn
object; that will fix the collisions.This engraver creates the following layout object(s):
Script_engraver
Handle note scripted articulations.
Music types accepted:
Properties (read)
scriptDefinitions
(list)The description of scripts. This is used by the
Script_engraver
for typesetting note-superscripts and subscripts. See ‘scm/script.scm’ for more information.This engraver creates the following layout object(s):
Bend_engraver
Create fall spanners.
Music types accepted:
This engraver creates the following layout object(s):
Dynamic_align_engraver
Align hairpins and dynamic texts on a horizontal line
Properties (read)
currentMusicalColumn
(layout object)Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).
This engraver creates the following layout object(s):
New_dynamic_engraver
Create hairpins, dynamic texts, and their vertical alignments. The symbols are collected onto a
DynamicLineSpanner
grob which takes care of vertical positioning.Music types accepted:
span-dynamic-event and absolute-dynamic-event
Properties (read)
crescendoSpanner
(symbol)The type of spanner to be used for crescendi. Available values are ‘hairpin’ and ‘text’. If unset, a hairpin crescendo is used.
crescendoText
(markup)The text to print at start of non-hairpin crescendo, i.e., ‘cresc.’.
currentMusicalColumn
(layout object)Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).
decrescendoSpanner
(symbol)The type of spanner to be used for decrescendi. Available values are ‘hairpin’ and ‘text’. If unset, a hairpin decrescendo is used.
decrescendoText
(markup)The text to print at start of non-hairpin decrescendo, i.e., ‘dim.’.
This engraver creates the following layout object(s):
Text_engraver
Create text scripts.
Music types accepted:
This engraver creates the following layout object(s):
Part_combine_engraver
Part combine engraver for orchestral scores: Print markings ‘a2’, ‘Solo’, ‘Solo II’, and ‘unisono’.
Music types accepted:
Properties (read)
printPartCombineTexts
(boolean)Set ‘Solo’ and ‘A due’ texts in the part combiner?
soloText
(markup)The text for the start of a solo when part-combining.
soloIIText
(markup)The text for the start of a solo for voice ‘two’ when part-combining.
aDueText
(markup)Text to print at a unisono passage.
This engraver creates the following layout object(s):
Slash_repeat_engraver
Make beat repeats.
Music types accepted:
Properties (read)
measureLength
(moment)Length of one measure in the current time signature.
This engraver creates the following layout object(s):
Percent_repeat_engraver
Make whole bar and double bar repeats.
Music types accepted:
Properties (read)
countPercentRepeats
(boolean)If set, produce counters for percent repeats.
currentCommandColumn
(layout object)Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
measureLength
(moment)Length of one measure in the current time signature.
repeatCountVisibility
(procedure)A procedure taking as arguments an integer and context, returning whether the corresponding percent repeat number should be printed when
countPercentRepeats
is set.Properties (write)
forbidBreak
(boolean)If set to
##t
, prevent a line break at this point.This engraver creates the following layout object(s):
DoublePercentRepeat, DoublePercentRepeatCounter, PercentRepeat and PercentRepeatCounter.
Chord_tremolo_engraver
Generate beams for tremolo repeats.
Music types accepted:
This engraver creates the following layout object(s):
Beam.
Auto_beam_engraver
Generate beams based on measure characteristics and observed Stems. Uses
beatLength
,measureLength
, andmeasurePosition
to decide when to start and stop a beam. Overriding beaming is done through Stem_engraver propertiesstemLeftBeamCount
andstemRightBeamCount
.Music types accepted:
Properties (read)
autoBeaming
(boolean)If set to true then beams are generated automatically.
autoBeamSettings
(list)Specifies when automatically generated beams should begin and end. See behavior Setting automatic beam behavior for more information.
beatLength
(moment)The length of one beat in this time signature.
subdivideBeams
(boolean)If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
This engraver creates the following layout object(s):
Beam.
Grace_beam_engraver
Handle
Beam
events by engraving beams. If omitted, then notes are printed with flags instead of beams. Only engraves beams when we are at grace points in time.Music types accepted:
Properties (read)
beamMelismaBusy
(boolean)Signal if a beam is present.
beatLength
(moment)The length of one beat in this time signature.
subdivideBeams
(boolean)If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
This engraver creates the following layout object(s):
Beam.
Beam_engraver
Handle
Beam
events by engraving beams. If omitted, then notes are printed with flags instead of beams.Music types accepted:
Properties (read)
beamMelismaBusy
(boolean)Signal if a beam is present.
beatLength
(moment)The length of one beat in this time signature.
subdivideBeams
(boolean)If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
Properties (write)
forbidBreak
(boolean)If set to
##t
, prevent a line break at this point.This engraver creates the following layout object(s):
Beam.
Stem_engraver
Create stems and single-stem tremolos. It also works together with the beam engraver for overriding beaming.
Music types accepted:
Properties (read)
tremoloFlags
(integer)The number of tremolo flags to add if no number is specified.
stemLeftBeamCount
(integer)Specify the number of beams to draw on the left side of the next note. Overrides automatic beaming. The value is only used once, and then it is erased.
stemRightBeamCount
(integer)See
stemLeftBeamCount
.This engraver creates the following layout object(s):
Stem and StemTremolo.
Tweak_engraver
Read the
tweaks
property from the originating event, and set properties.Rest_engraver
Engrave rests.
Music types accepted:
Properties (read)
middleCPosition
(number)The place of the middle C, measured in half staff-spaces. Usually determined by looking at
middleCClefPosition
andmiddleCOffset
.This engraver creates the following layout object(s):
Rest.
Dots_engraver
Create Dots objects for rhythmic-head-interfaces.
This engraver creates the following layout object(s):
Dots.
Breathing_sign_engraver
Create a breathing sign.
Music types accepted:
This engraver creates the following layout object(s):
Ligature_bracket_engraver
Handle
Ligature_events
by engravingLigature
brackets.Music types accepted:
This engraver creates the following layout object(s):
Glissando_engraver
Engrave glissandi.
Music types accepted:
This engraver creates the following layout object(s):
Note_head_line_engraver
Engrave a line between two note heads, for example a glissando. If
followVoice
is set, staff switches also generate a line.Properties (read)
followVoice
(boolean)If set, note heads are tracked across staff switches by a thin line.
This engraver creates the following layout object(s):
Glissando and VoiceFollower.
Repeat_tie_engraver
Create repeat ties.
Music types accepted:
This engraver creates the following layout object(s):
RepeatTie and RepeatTieColumn.
Laissez_vibrer_engraver
Create laissez vibrer items.
Music types accepted:
This engraver creates the following layout object(s):
Forbid_line_break_engraver
Forbid line breaks when note heads are still playing at some point.
Properties (read)
busyGrobs
(list)A queue of
(end-moment . GROB)
cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).Properties (write)
forbidBreak
(boolean)If set to
##t
, prevent a line break at this point.Grob_pq_engraver
Administrate when certain grobs (e.g., note heads) stop playing.
Properties (read)
busyGrobs
(list)A queue of
(end-moment . GROB)
cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).Properties (write)
busyGrobs
(list)A queue of
(end-moment . GROB)
cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).Trill_spanner_engraver
Create trill spanner from an event.
Music types accepted:
This engraver creates the following layout object(s):
Text_spanner_engraver
Create text spanner from an event.
Music types accepted:
This engraver creates the following layout object(s):
Multi_measure_rest_engraver
Engrave multi-measure rests that are produced with ‘R’. It reads
measurePosition
andinternalBarNumber
to determine what number to print over the MultiMeasureRest. ReadsmeasureLength
to determine whether it should use a whole rest or a breve rest to represent one measure.Music types accepted:
multi-measure-text-event and multi-measure-rest-event
Properties (read)
internalBarNumber
(integer)Contains the current barnumber. This property is used for internal timekeeping, among others by the
Accidental_engraver
.restNumberThreshold
(number)If a multimeasure rest has more measures than this, a number is printed.
breakableSeparationItem
(layout object)The breakable items in this time step, for this staff.
currentCommandColumn
(layout object)Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
measurePosition
(moment)How much of the current measure have we had. This can be set manually to create incomplete measures.
measureLength
(moment)Length of one measure in the current time signature.
This engraver creates the following layout object(s):
MultiMeasureRest, MultiMeasureRestNumber and MultiMeasureRestText.
Arpeggio_engraver
Generate an Arpeggio symbol.
Music types accepted:
This engraver creates the following layout object(s):
Output_property_engraver
Apply a procedure to any grob acknowledged.
Music types accepted:
Pitched_trill_engraver
Print the bracketed note head after a note head with trill.
This engraver creates the following layout object(s):
Font_size_engraver
Put
fontSize
intofont-size
grob property.Properties (read)
fontSize
(number)The relative size of all grobs in a context.
[ << Translation ] | [Top][Contents][Index][ ? ] | [ Backend >> ] | ||
[ < TabStaff ] | [ Up : Contexts ] | [ VaticanaStaff > ] |