| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < AccidentalSuggestion ] | [ Up : All layout objects ] | [ AmbitusAccidental > ] |
3.1.5 Ambitus
Ambitus objects are created by: Ambitus_engraver.
Standard settings:
axes(list): '(0 1)List of axis numbers. In the case of alignment grobs, this should contain only one number.
break-align-symbol(symbol):
'ambitusThis key is used for aligning, ordering, and spacing breakable items. See break-alignment-interface.
break-visibility(vector): #(#f #f #t)A vector of 3 booleans,
#(end-of-line unbroken begin-of-line).#tmeans visible,#fmeans killed.non-musical(boolean):
#tTrue if the grob belongs to a
NonMusicalPaperColumn.space-alist(list): '((cue-end-clef extra-space . 0.5) (clef extra-space . 1.15) (cue-clef extra-space . 0.5) (key-signature extra-space . 1.15) (staff-bar extra-space . 1.15) (time-signature extra-space . 1.15) (right-edge extra-space . 0.5) (first-note extra-space . 1.15))An alist that specifies distances from this grob to other breakable items, using the format:
'((break-align-symbol . (spacing-style . space)) (break-align-symbol . (spacing-style . space)) ...)Standard choices for
break-align-symbolare listed in break-alignment-interface. Additionally, three special break-align symbols available tospace-alistare:
first-noteused when the grob is just left of the first note on a line
next-noteused when the grob is just left of any other note; if not set, the value of
first-notegets usedright-edgeused when the grob is the last item on the line (only compatible with the
extra-spacespacing style)Choices for
spacing-styleare:
extra-spacePut this much space between the two grobs. The space is stretchable when paired with
first-noteornext-note; otherwise it is fixed.minimum-spacePut at least this much space between the left sides of both grobs, without allowing them to collide. The space is stretchable when paired with
first-noteornext-note; otherwise it is fixed. Not compatible withright-edge.fixed-spaceOnly compatible with
first-noteandnext-note. Put this much fixed space between the grob and the note.minimum-fixed-spaceOnly compatible with
first-noteandnext-note. Put at least this much fixed space between the left side of the grob and the left side of the note, without allowing them to collide.semi-fixed-spaceOnly compatible with
first-noteandnext-note. Put this much space between the grob and the note, such that half of the space is fixed and half is stretchable.Rules for this spacing are much more complicated than this. See [Wanske] page 126–134, [Ross] page 143–147.
X-extent(pair of numbers):
ly:axis-group-interface::widthExtent (size) in the X direction, measured in staff-space units, relative to object’s reference point.
Y-extent(pair of numbers):
#<unpure-pure-container #<primitive-procedure ly:axis-group-interface::height> #<primitive-procedure ly:axis-group-interface::pure-height> >Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.
This object supports the following interface(s): ambitus-interface, axis-group-interface, break-aligned-interface, grob-interface and item-interface.
| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < AccidentalSuggestion ] | [ Up : All layout objects ] | [ AmbitusAccidental > ] |