LilyPond Beginnershandleiding

Hoofdstuk 4: Tweaking output 119
side-position-interface and the nearest other object (generally the note or the
staff lines); staff-padding applies only to those objects which are always set outside
the staff – it controls the minimum amount of space that should be inserted between
that object and the staff. Note that staff-padding has no effect on objects which are
positioned relative to the note rather than the staff, even though it may be overridden
without error for such objects – it is simply ignored.
To discover which padding property is required for the object you wish to reposition,
you need to return to the IR and look up the object’s properties. Be aware that the
padding properties might not be located in the obvious object, so look in objects that
appear to be related.
All padding values are measured in staff spaces. For most objects, this value is set by
default to be around 1.0 or less (it varies with each object). It may be overridden if a
larger (or smaller) gap is required.
• self-alignment-X
This property can be used to align the object to the left, to the right, or to center it with
respect to the parent object’s reference point. It may be used with all objects which
support the self-alignment-interface. In general these are objects that contain
text. The values are LEFT, RIGHT or CENTER. Alternatively, a numerical value between
-1 and +1 may be specified, where -1 is left-aligned, +1 is right-aligned, and numbers
in between move the text progressively from left-aligned to right-aligned. Numerical
values greater than 1 may be specified to move the text even further to the left, or
less than -1 to move the text even further to the right. A change of 1 in the value
corresponds to a movement of half the text’s length.
• extra-spacing-width
This property is available for all objects which support the item-interface. It takes
two numbers, the first is added to the leftmost extent and the second is added to the
rightmost extent. Negative numbers move the edge to the left, positive to the right, so
to widen an object the first number must be negative, the second positive. Note that
not all objects honor both numbers. For example, the Accidental object only takes
notice of the first (left edge) number.
• staff-position
staff-position is a property of the staff-symbol-referencer-interface, which is
supported by objects which are positioned relative to the staff. It specifies the vertical
position of the object relative to the center line of the staff in half staff-spaces. It is
useful in resolving collisions between layout objects like multi-measure rests, ties and
notes in different voices.
• force-hshift
Closely spaced notes in a chord, or notes occurring at the same time in different voices,
are arranged in two, occasionally more, columns to prevent the note heads overlapping.
These are called note columns, and an object called NoteColumn is created to lay out
the notes in that column.
The force-hshift property is a property of a NoteColumn (actually of the
note-column-interface). Changing it permits a note column to be moved in units
appropriate to a note column, viz. the note head width of the first voice note. It
should be used in complex situations where the normal \shiftOn commands (see
Sectie 3.2.2 [Explicitly instantiating voices], pagina 53) do not resolve the note
conflict. It is preferable to the extra-offset property for this purpose as there is no
need to work out the distance in staff-spaces, and moving the notes into or out of a
NoteColumn affects other actions such as merging note heads.