| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < InstrumentName ] | [ Up : All layout objects ] | [ KeyCancellation > ] |
3.1.58 InstrumentSwitch
InstrumentSwitch objects are created by: Instrument_switch_engraver.
Standard settings:
direction(direction):
1If
side-axisis0(orX), then this property determines whether the object is placedLEFT,CENTERorRIGHTwith respect to the other object. Otherwise, it determines whether the object is placedUP,CENTERorDOWN. Numerical values may also be used:UP=1,DOWN=-1,LEFT=-1,RIGHT=1,CENTER=0.extra-spacing-width(pair of numbers): '(+inf.0 . -inf.0)In the horizontal spacing problem, we pad each item by this amount (by adding the ‘car’ on the left side of the item and adding the ‘cdr’ on the right side of the item). In order to make a grob take up no horizontal space at all, set this to
(+inf.0 . -inf.0).outside-staff-priority(number):
500If set, the grob is positioned outside the staff in such a way as to avoid all collisions. In case of a potential collision, the grob with the smaller
outside-staff-priorityis closer to the staff.padding(dimension, in staff space):
0.5Add this much extra space between objects that are next to each other.
parent-alignment-X(number)Specify on which point of the parent the object is aligned. The value
-1means aligned on parent’s left edge,0on center, and1right edge, in X direction. Other numerical values may also be specified - the unit is half the parent’s width. If unset, the value fromself-alignment-Xproperty will be used.self-alignment-X(number):
-1Specify alignment of an object. The value
-1means left aligned,0centered, and1right-aligned in X direction. Other numerical values may also be specified - the unit is half the object width.side-axis(number):
1If the value is
X(or equivalently0), the object is placed horizontally next to the other object. If the value isYor1, it is placed vertically.staff-padding(dimension, in staff space):
0.5Maintain this much space between reference points and the staff. Its effect is to align objects of differing sizes (like the dynamics p and f) on their baselines.
stencil(stencil):
ly:text-interface::printThe symbol to print.
X-offset(number):
ly:self-alignment-interface::aligned-on-x-parentThe horizontal amount that this object is moved relative to its X-parent.
Y-extent(pair of numbers):
#<unpure-pure-container #<primitive-procedure ly:grob::stencil-height> >Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.
Y-offset(number):
#<unpure-pure-container #<primitive-procedure ly:side-position-interface::y-aligned-side> #<primitive-procedure ly:side-position-interface::pure-y-aligned-side> >The vertical amount that this object is moved relative to its Y-parent.
This object supports the following interface(s): font-interface, grob-interface, item-interface, outside-staff-interface, self-alignment-interface, side-position-interface and text-interface.
| [ << Backend ] | [Top][Contents][Index] | [ Scheme functions >> ] |
| [ < InstrumentName ] | [ Up : All layout objects ] | [ KeyCancellation > ] |