[icon]

GNU LilyPond

-- --

What is LilyPond
Home
Examples
Templates
Download
GNU/Linux binaries
Windows binaries
Source code
Documentation
Tutorial
Manual
Glossary
Index

Support
Mailing lists
Search
WikiWiki

External sites
lilypond.org/stable
lilypond.org/development
savannah.gnu.org
ftp.lilypond.org
Mutopia
Other music online

Node:TabStaff, Next:, Previous:StaffGroup, Up:Contexts



TabStaff

Context for generating tablature. [DOCME]

This context creates the following grobs: BarLine, Clef, DotColumn, InstrumentName, NoteCollision, OctavateEight, RestCollision, SeparatingGroupSpanner, SeparationItem, SostenutoPedalLineSpanner, SostenutoPedal, StaffSymbol, SustainPedalLineSpanner, SustainPedal, TimeSignature, UnaCordaPedalLineSpanner, UnaCordaPedal, VerticalAxisGroup and VoltaBracket.

This context sets the following properties:

  • Set translator property clefPosition to 0
  • Set translator property clefGlyph to clefs-tab
  • Set grob-property avoid-note-head in Stem to #t
  • Set grob-property staff-space in StaffSymbol to 1.5
  • Set grob-property line-count in StaffSymbol to 6
  • Set translator property instr to '()
  • Set translator property instrument to '()
  • Set translator property localKeySignature to '()
  • Set translator property verticalExtent to #f
  • Set translator property extraVerticalExtent to #f
  • Set translator property minimumVerticalExtent to '(-6 . 6)
  • Set grob-property spacing-procedure in SeparatingGroupSpanner to Separating_group_spanner::set_spacing_rods_and_seqs

Context TabStaff can contain TabVoice

This context is built from the following engravers:


Engraver_group_engraver
A group of engravers taken together
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) conses. This is for internal (C++) use only. Use at your own risk. This property contains the grobs for which END-MOMENT >= NOW.

Grob_pq_engraver
Administrate when certain grobs (eg. note heads) stop playing; this engraver is a sort-of a failure, since it doesn't handle all sorts of borderline cases very well.

Properties (read)


busyGrobs (list)
a queue of (END-MOMENT . GROB) conses. This is for internal (C++) use only. Use at your own risk. This property contains the grobs for which END-MOMENT >= NOW.
Properties (write)

busyGrobs (list)
a queue of (END-MOMENT . GROB) conses. This is for internal (C++) use only. Use at your own risk. This property contains the grobs for which END-MOMENT >= NOW.

Instrument_name_engraver
Prints the name of the instrument (specified by Staff.instrument and Staff.instr) at the left of the staff.

Properties (read)


instr (markup)
see instrument
instrument (markup)
If Instrument_name_engraver is added to the Staff translator, then the instrument property is used to label the first line of the staff and the instr property is used to label subsequent lines. If the midiInstrument property is not set, then instrument is used to determine the instrument for MIDI output.
This engraver creates the following grobs: InstrumentName.
Piano_pedal_engraver
Engrave piano pedal symbols and brackets.

Music types accepted: abort-event and pedal-event

Properties (read)


pedalUnaCordaStrings (list)
see pedalSustainStrings.
pedalSustainStrings (list)
List of string to print for sustain-pedal. Format is (UP UPDOWN DOWN), where each of the three is the string to print when this is done with the pedal.
pedalSostenutoStrings (list)
see pedalSustainStrings.
This engraver creates the following grobs: SostenutoPedal, SostenutoPedalLineSpanner, SustainPedal, SustainPedalLineSpanner, UnaCordaPedal and UnaCordaPedalLineSpanner.
Rest_collision_engraver
Handles collisions of rests.

This engraver creates the following grobs: RestCollision.

Collision_engraver

This engraver creates the following grobs: NoteCollision.

Staff_symbol_engraver
create the constellation of five (default) staff lines.

This engraver creates the following grobs: StaffSymbol.

Time_signature_engraver
Create a TimeSignature whenever timeSignatureFraction changes

This engraver creates the following grobs: TimeSignature.

Clef_engraver
Determine and set reference point for pitches

Properties (read)


explicitClefVisibility (procedure)
visibility-lambda function for clef changes.
clefOctavation (integer)
Add this much extra octavation. Values of 7 and -7 are common.
centralCPosition (number)
Place of the central C, measured in half staffspaces. Usually determined by looking at clefPosition and clefGlyph.
clefGlyph (string)
Name of the symbol within the music font
clefPosition (number)
Where should the center of the clef symbol go? On systems with an odd number of stafflines, the value 0 puts the clef on the middle staffline; a positive value shifts it up, a negative value shifts it down. The unit of this distance is the half staff space.
This engraver creates the following grobs: Clef and OctavateEight.
Dot_column_engraver
Engraves dots on dotted notes shifted to the right of the note. If omitted, then dots appear on top of the notes.

This engraver creates the following grobs: DotColumn.

Separating_line_group_engraver
Generates objects for computing spacing parameters.

This engraver creates the following grobs: SeparatingGroupSpanner and SeparationItem.

Volta_engraver
Make volta brackets

Properties (read)


stavesFound (list)
list of all staff-symbols found.
voltaSpannerDuration (moment)
maximum duration of the volta bracket.

Set to a duration to control the size of the brackets printed by \alternative. It specifies the number of whole notes duration to use for the brackets. This can be used to shrink the length of brackets in the situation where one alternative is very large. It may have odd effects if the specified duration is longer than the music given in an \alternative. .

repeatCommands (list)
This property is read to find any command of the form (volta . X), where X is a string or #f
This engraver creates the following grobs: VoltaBracket.
Font_size_engraver
Puts fontSize into font-relative-size grob property.

Properties (read)


fontSize (integer)
Used to set the relative size of all grobs in a context. This is done using the Font_size_engraver.

Bar_engraver
Create barlines. This engraver is controlled through the whichBar property. If it has no bar line to create, it will forbid a linebreak at this point

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.

.

This engraver creates the following grobs: BarLine.
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

Axis_group_engraver
Group all objects created in this context in a VerticalAxisGroup spanner.

Properties (read)


extraVerticalExtent (pair of numbers)
extra vertical extent, same format as MinimumVerticalExtent
minimumVerticalExtent (pair of numbers)
minimum vertical extent, same format as VerticalExtent
verticalExtent (pair of numbers)
hard coded vertical extent. The format is a pair of dimensions, for example, this sets the sizes of a staff to 10 (5+5) staffspaces high.
               property Staff.verticalExtent = #(-5.0 . 5.0)
               

VerticalExtent, MinimumVerticalExtent and ExtraVerticalExtent are predefined in all relevant contexts to #f, so they will not inherit values.

Note that these VerticalExtents can only operate on vertical groups, and therefore only work in contexts which contain an Axis_group_engraver.

This engraver creates the following grobs: VerticalAxisGroup.

Go back to index of LilyPond.

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to (address unknown)

Copyright (c) 1997--2002 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.


This page was built from LilyPond-1.7.14 (development-branch) by

Buchan Milne <(address unknown)>, Thu Mar 6 21:11:35 2003 CET.