| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < VerticalAlignment ] | [ Up : All layout objects ] | [ VoiceFollower > ] |
3.1.141 VerticalAxisGroup
VerticalAxisGroup objects are created by: Axis_group_engraver.
Standard settings:
axes(list): '(1)List of axis numbers. In the case of alignment grobs, this should contain only one number.
default-staff-staff-spacing(list): '((basic-distance . 9) (minimum-distance . 8) (padding . 1))The settings to use for
staff-staff-spacingwhen it is unset, for ungrouped staves and for grouped staves that do not have the relevantStaffGrouperproperty set (staff-staff-spacingorstaffgroup-staff-spacing).nonstaff-unrelatedstaff-spacing(list): '((padding . 0.5))The spacing alist controlling the distance between the current non-staff line and the nearest staff in the opposite direction from
staff-affinity, if there are no other non-staff lines between the two, andstaff-affinityis eitherUPorDOWN. Seestaff-staff-spacingfor a description of the alist structure.outside-staff-placement-directive(symbol):
'left-to-right-politeOne of four directives telling how outside staff objects should be placed.
left-to-right-greedy– Place each successive grob from left to right.left-to-right-polite– Place a grob from left to right only if it does not potentially overlap with another grob that has been placed on a pass through a grob array. If there is overlap, do another pass to determine placement.right-to-left-greedy– Same asleft-to-right-greedy, but from right to left.right-to-left-polite– Same asleft-to-right-polite, but from right to left.skyline-horizontal-padding(number):
0.1For determining the vertical distance between two staves, it is possible to have a configuration which would result in a tight interleaving of grobs from the top staff and the bottom staff. The larger this parameter is, the farther apart the staves are placed in such a configuration.
staff-staff-spacing(list):
#<unpure-pure-container #<primitive-procedure ly:axis-group-interface::calc-staff-staff-spacing> #<primitive-procedure ly:axis-group-interface::calc-pure-staff-staff-spacing> >When applied to a staff-group’s
StaffGroupergrob, this spacing alist controls the distance between consecutive staves within the staff-group. When applied to a staff’sVerticalAxisGroupgrob, it controls the distance between the staff and the nearest staff below it in the same system, replacing any settings inherited from theStaffGroupergrob of the containing staff-group, if there is one. This property remains in effect even when non-staff lines appear between staves. The alist can contain the following keys:
basic-distance– the vertical distance, measured in staff-spaces, between the reference points of the two items when no collisions would result, and no stretching or compressing is in effect.minimum-distance– the smallest allowable vertical distance, measured in staff-spaces, between the reference points of the two items, when compressing is in effect.padding– the minimum required amount of unobstructed vertical whitespace between the bounding boxes (or skylines) of the two items, measured in staff-spaces.stretchability– a unitless measure of the dimension’s relative propensity to stretch. If zero, the distance will not stretch (unless collisions would result).stencil(stencil):
ly:axis-group-interface::printThe symbol to print.
vertical-skylines(pair of skylines):
ly:hara-kiri-group-spanner::calc-skylinesTwo skylines, one above and one below this grob.
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:hara-kiri-group-spanner::y-extent> #<primitive-procedure ly:hara-kiri-group-spanner::pure-height> >Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.
Y-offset(number):
ly:hara-kiri-group-spanner::force-hara-kiri-callbackThe vertical amount that this object is moved relative to its Y-parent.
This object supports the following interface(s): axis-group-interface, grob-interface, hara-kiri-group-spanner-interface, outside-staff-axis-group-interface and spanner-interface.
| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < VerticalAlignment ] | [ Up : All layout objects ] | [ VoiceFollower > ] |