<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!-- header_tag --> <html lang="en"> <head> <title>InstrumentSwitch - LilyPond program-reference</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="description" content="LilyPond program-reference"> <meta name="generator" content="makeinfo 4.11"> <link title="Top" rel="start" href="index.html#Top"> <link rel="up" href="All-layout-objects.html#All-layout-objects" title="All layout objects"> <link rel="prev" href="InstrumentName.html#InstrumentName" title="InstrumentName"> <link rel="next" href="KeyCancellation.html#KeyCancellation" title="KeyCancellation"> <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> <meta http-equiv="Content-Style-Type" content="text/css"> <style type="text/css"><!-- pre.display { font-family:inherit } pre.format { font-family:inherit } pre.smalldisplay { font-family:inherit; font-size:smaller } pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } span.sc { font-variant:small-caps } span.roman { font-family:serif; font-weight:normal; } span.sansserif { font-family:sans-serif; font-weight:normal; } hr { border:0; height:1; color: #000000; background-color: #000000; } /* hr { border: none; height: 1px; color: #666666; background-color: #666666; } body { border-left: 1px solid #666666; border-right: 1px solid #666666; color: #332d28; margin-right: auto; margin-left: auto; width: 60em; list-style-type: square; font-family: Arial,Helvetica,sans-serif; padding-right: 1em; padding-left: 1em; } a { border-bottom: 1px dashed #344242; text-decoration: none; color: #344242; } a:link { text-decoration: none; } a:visited { border-bottom: 1px dashed #666666; color: #666666; } a:active { border-bottom: 1px solid #00cccc; color: #00cccc; } a:hover { border-bottom: 1px solid #1d7b85; color: #1d7b85; } blockquote { border: 1px solid #cccccc; padding: 3px; width: 40em; } .node { border-left: 1px solid #666666; margin: -0.5em 0px 1em; padding: 2px 1px 0px; font-style: italic; } .node a { border: none; text-decoration: underline; font-style: normal; font-weight: bold; } .verbatim { font-family: "Courier New",Courier,monospace; } .unnumberedsubsubsec { font-size: large; color: #1d7b85; } .subsubheading { font-size: large; color: #3b220d; } .contents { border: 1px dashed #339999; margin: 3px 2em; list-style-type: square; padding-right: 1em; width: 40em; background-color: #fcfff9; } .contents a { border-bottom: 1px dashed #423d34; text-decoration: none; color: #423d34; } .contents a:visited { border-bottom: 1px dashed #666666; color: #666666; } .contents a:active { border-bottom: 1px solid #f0d86d; color: #f0d86d; } .contents a:hover { border-bottom: 1px solid #3b220d; color: #3b220d; } .menu { border-left: 1px dashed #339999; margin: 3px 2em 1em; list-style-type: square; padding-left: 1.4em; width: 40em; } .unnumbered { } h2 { font-size: x-large; color: #1d7b85; } */ --></style> </head> <BODY BGCOLOR=WHITE TEXT=BLACK> <div class="node"> <p> <a name="InstrumentSwitch"></a> Next: <a rel="next" accesskey="n" href="KeyCancellation.html#KeyCancellation">KeyCancellation</a>, Previous: <a rel="previous" accesskey="p" href="InstrumentName.html#InstrumentName">InstrumentName</a>, Up: <a rel="up" accesskey="u" href="All-layout-objects.html#All-layout-objects">All layout objects</a> <hr> </div> <h4 class="unnumberedsubsec">InstrumentSwitch</h4> <p>InstrumentSwitch objects are created by: <a href="Instrument_005fswitch_005fengraver.html#Instrument_005fswitch_005fengraver">Instrument_switch_engraver</a>. <p>Standard settings: <blockquote> <dl> <dt><code>padding</code> (dimension, in staff space):<dd> <code>0.5</code> <p>Add this much extra space between objects that are next to each other. <br><dt><code>stencil</code> (unknown):<dd> <code>ly:text-interface::print</code> <p>The symbol to print. <br><dt><code>Y-offset</code> (number):<dd> <code>ly:side-position-interface::y-aligned-side</code> <p>The vertical amount that this object is moved relative to its Y-parent. <br><dt><code>X-offset</code> (number):<dd> <code>ly:self-alignment-interface::x-aligned-on-self</code> <p>The horizontal amount that this object is moved relative to its X-parent. <br><dt><code>staff-padding</code> (dimension, in staff space):<dd> <code>0.5</code> <p>Maintain this much space between reference points and the staff. Its effect is to align objects of differing sizes (like the dynamics <b>p</b> and <b>f</b>) on their baselines. <br><dt><code>direction</code> (direction):<dd> <code>1</code> <p>If <code>side-axis</code> is <code>0</code> (or <code>#X</code>), then this property determines whether the object is placed <code>#LEFT</code>, <code>#CENTER</code> or <code>#RIGHT</code> with respect to the other object. Otherwise, it determines whether the object is placed <code>#UP</code>, <code>#CENTER</code> or <code>#DOWN</code>. Numerical values may also be used: <code>#UP</code>=<code>1</code>, <code>#DOWN</code>=<code>-1</code>, <code>#LEFT</code>=<code>-1</code>, <code>#RIGHT</code>=<code>1</code>, <code>#CENTER</code>=<code>0</code>. <br><dt><code>side-axis</code> (number):<dd> <code>1</code> <p>If the value is <code>#X</code> (or equivalently <code>0</code>), the object is placed horizontally next to the other object. If the value is <code>#Y</code> or <code>1</code>, it is placed vertically. <br><dt><code>self-alignment-X</code> (number):<dd> <code>-1</code> <p>Specify alignment of an object. The value <code>-1</code> means left aligned, <code>0</code> centered, and <code>1</code> right-aligned in X direction. Other numerical values may also be specified. <br><dt><code>outside-staff-priority</code> (number):<dd> <code>500</code> <p>If 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 <code>outside-staff-priority</code> is closer to the staff. <br><dt><code>extra-spacing-width</code> (pair of numbers):<dd> <code>'(quote (+inf.0 . -inf.0))</code> <p>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 <code>(+inf.0 . -inf.0)</code>. </dl> </blockquote> <p>This object supports the following interface(s): <a href="side_002dposition_002dinterface.html#side_002dposition_002dinterface">side-position-interface</a>, <a href="item_002dinterface.html#item_002dinterface">item-interface</a>, <a href="font_002dinterface.html#font_002dinterface">font-interface</a> and <a href="grob_002dinterface.html#grob_002dinterface">grob-interface</a>. <!-- footer_tag --><br><hr> <div class="node"> <p> Next: <a rel="next" accesskey="n" href="KeyCancellation.html#KeyCancellation">KeyCancellation</a>, Previous: <a rel="previous" accesskey="p" href="InstrumentName.html#InstrumentName">InstrumentName</a>, Up: <a rel="up" accesskey="u" href="All-layout-objects.html#All-layout-objects">All layout objects</a> </div> <div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;"> <p> <font size="-1"> This page is for LilyPond-2.11.57 (development-branch). <br> <address> Report errors to <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address> <br> Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome. </font> </p> </div> </BODY></html>