<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Instrument Specific Markup - GNU LilyPond - manuel de notation</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond - manuel de notation">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.fr.html#Top">
<link rel="up" href="Text-markup-commands.fr.html#Text-markup-commands" title="Text markup commands">
<link rel="prev" href="Music.fr.html#Music" title="Music">
<link rel="next" href="Other.fr.html#Other" title="Other">
<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="Instrument-Specific-Markup"></a>
Suivant : <a rel="next" accesskey="n" href="Other.fr.html#Other">Other</a>,
Précédent : <a rel="previous" accesskey="p" href="Music.fr.html#Music">Music</a>,
Haut : <a rel="up" accesskey="u" href="Text-markup-commands.fr.html#Text-markup-commands">Text markup commands</a>
<hr>
</div>
<h4 class="appendixsubsec">B.6.5 Instrument Specific Markup</h4>
<dl>
<dt><code>\fret-diagram</code> <var>definition-string</var> (string)<dd><a name="index-g_t_005cfret_002ddiagram-1475"></a><a name="index-g_t_005cfret_002ddiagram-1476"></a>
<p><a name="index-g_t_005cfret_002ddiagram-1477"></a>Make a (guitar) fret diagram. For example, say
<pre class="example"> \markup \fret-diagram #"s:0.75;6-x;5-x;4-o;3-2;2-3;1-2;"
</pre>
<p class="noindent">for fret spacing 3/4 of staff space, D chord diagram
<p>Syntax rules for <var>definition-string</var>:
<ul>
<li>Diagram items are separated by semicolons.
<li>Possible items:
<ul>
<li><code>s:</code><var>number</var> – Set the fret spacing of the diagram (in staff
spaces).
Default: 1.
<li><code>t:</code><var>number</var> – Set the line thickness (in staff spaces).
Default: 0.05.
<li><code>h:</code><var>number</var> – Set the height of the diagram in frets.
Default: 4.
<li><code>w:</code><var>number</var> – Set the width of the diagram in strings.
Default: 6.
<li><code>f:</code><var>number</var> – Set fingering label type
(0 = none, 1 = in circle on string, 2 = below string).
Default: 0.
<li><code>d:</code><var>number</var> – Set radius of dot, in terms of fret spacing.
Default: 0.25.
<li><code>p:</code><var>number</var> – Set the position of the dot in the fret space.
0.5 is centered; 1 is on lower fret bar, 0 is on upper fret bar.
Default: 0.6.
<li><code>c:</code><var>string1</var><code>-</code><var>string2</var><code>-</code><var>fret</var> – Include a
barre mark from <var>string1</var> to <var>string2</var> on <var>fret</var>.
<li><var>string</var><code>-</code><var>fret</var> – Place a dot on <var>string</var> at <var>fret</var>.
If <var>fret</var> is ‘<samp><span class="samp">o</span></samp>’, <var>string</var> is identified as open.
If <var>fret</var> is ‘<samp><span class="samp">x</span></samp>’, <var>string</var> is identified as muted.
<li><var>string</var><code>-</code><var>fret</var><code>-</code><var>fingering</var> – Place a dot on
<var>string</var> at <var>fret</var>, and label with <var>fingering</var> as defined
by the <code>f:</code> code.
</ul>
<li>Note: There is no limit to the number of fret indications per string.
</ul>
<p>Used properties:
<ul>
<li><code>thickness</code> (0.5)
<li><code>fret-diagram-details</code>
<li><code>size</code> (1.0)
<li><code>align-dir</code> (-0.4)
</ul>
<br><dt><code>\fret-diagram-terse</code> <var>definition-string</var> (string)<dd><a name="index-g_t_005cfret_002ddiagram_002dterse-1478"></a><a name="index-g_t_005cfret_002ddiagram_002dterse-1479"></a>
<p><a name="index-g_t_005cfret_002ddiagram_002dterse-1480"></a>Make a fret diagram markup using terse string-based syntax.
<p>Here is an example
<pre class="example"> \markup \fret-diagram-terse #"x;x;o;2;3;2;"
</pre>
<p class="noindent">for a D chord diagram.
<p>Syntax rules for <var>definition-string</var>:
<ul>
<li>Strings are terminated by semicolons; the number of semicolons
is the number of strings in the diagram.
<li>Mute strings are indicated by ‘<samp><span class="samp">x</span></samp>’.
<li>Open strings are indicated by ‘<samp><span class="samp">o</span></samp>’.
<li>A number indicates a fret indication at that fret.
<li>If there are multiple fret indicators desired on a string, they
should be separated by spaces.
<li>Fingerings are given by following the fret number with a <code>-</code>,
followed by the finger indicator, e.g. ‘<samp><span class="samp">3-2</span></samp>’ for playing the third
fret with the second finger.
<li>Where a barre indicator is desired, follow the fret (or fingering) symbol
with <code>-(</code> to start a barre and <code>-)</code> to end the barre.
</ul>
<p>Used properties:
<ul>
<li><code>thickness</code> (0.5)
<li><code>fret-diagram-details</code>
<li><code>size</code> (1.0)
<li><code>align-dir</code> (-0.4)
</ul>
<br><dt><code>\fret-diagram-verbose</code> <var>marking-list</var> (list)<dd><a name="index-g_t_005cfret_002ddiagram_002dverbose-1481"></a><a name="index-g_t_005cfret_002ddiagram_002dverbose-1482"></a>
<p><a name="index-g_t_005cfret_002ddiagram_002dverbose-1483"></a>Make a fret diagram containing the symbols indicated in <var>marking-list</var>.
<p>For example,
<pre class="example"> \markup \fret-diagram-verbose
#'((mute 6) (mute 5) (open 4)
(place-fret 3 2) (place-fret 2 3) (place-fret 1 2))
</pre>
<p class="noindent">produces a standard D chord diagram without fingering indications.
<p>Possible elements in <var>marking-list</var>:
<dl>
<dt><code>(mute </code><var>string-number</var><code>)</code><dd>Place a small ‘x’ at the top of string <var>string-number</var>.
<br><dt><code>(open </code><var>string-number</var><code>)</code><dd>Place a small ‘o’ at the top of string <var>string-number</var>.
<br><dt><code>(barre </code><var>start-string</var> <var>end-string</var> <var>fret-number</var><code>)</code><dd>Place a barre indicator (much like a tie) from string <var>start-string</var>
to string <var>end-string</var> at fret <var>fret-number</var>.
<br><dt><code>(place-fret </code><var>string-number</var> <var>fret-number</var> <var>finger-value</var><code>)</code><dd>Place a fret playing indication on string <var>string-number</var> at fret
<var>fret-number</var> with an optional fingering label <var>finger-value</var>.
By default, the fret playing indicator is a solid dot. This can be
changed by setting the value of the variable <var>dot-color</var>. If the
<var>finger</var> part of the <code>place-fret</code> element is present,
<var>finger-value</var> will be displayed according to the setting of the
variable <var>finger-code</var>. There is no limit to the number of fret
indications per string.
</dl>
<p>Used properties:
<ul>
<li><code>thickness</code> (0.5)
<li><code>fret-diagram-details</code>
<li><code>size</code> (1.0)
<li><code>align-dir</code> (-0.4)
</ul>
<br><dt><code>\harp-pedal</code> <var>definition-string</var> (string)<dd><a name="index-g_t_005charp_002dpedal-1484"></a><a name="index-g_t_005charp_002dpedal-1485"></a>
<p><a name="index-g_t_005charp_002dpedal-1486"></a>Make a harp pedal diagram.
<p>Possible elements in <var>definition-string</var>:
<dl>
<dt><code>^</code><dd>pedal is up
<br><dt><code>-</code><dd>pedal is neutral
<br><dt><code>v</code><dd>pedal is down
<br><dt><code>|</code><dd>vertical divider line
<br><dt><code>o</code><dd>the following pedal should be circled (indicating a change)
</dl>
<p>The function also checks if the string has the typical form of three
pedals, then the divider and then the remaining four pedals. If not it
prints out a warning. However, in any case, it will also print each symbol
in the order as given. This means you can place the divider (even multiple
dividers) anywhere you want, but you'll have to live with the warnings.
<p>The appearance of the diagram can be tweaked inter alia using the size property
of the TextScript grob (<code>\override Voice.TextScript #'size = #0.3</code>) for
the overall, the thickness property
(<code>\override Voice.TextScript #'thickness = #3</code>) for the line thickness of
the horizontal line and the divider. The remaining configuration (box sizes,
offsets and spaces) is done by the harp-pedal-details list of properties
(<code>\override Voice.TextScript #'harp-pedal-details #'box-width = #1</code>).
It contains the following settings: <code>box-offset</code> (vertical shift of the
box center for up/down pedals), <code>box-width</code>, <code>box-height</code>,
<code>space-before-divider</code> (the spacing between two boxes before the
divider) and <code>space-after-divider</code> (box spacing after the divider).
<blockquote>
<pre class="verbatim">
\markup \harp-pedal #"^-v|--ov^"
</pre>
<p>
<a href="../16/lily-d94dc991.ly"> <img align="middle" border="0" src="../16/lily-d94dc991.png" alt="[image of music]"> </a>
</p>
</blockquote>
<p>Used properties:
<ul>
<li><code>thickness</code> (0.5)
<li><code>harp-pedal-details</code>
<li><code>size</code> (1.0)
</ul>
</dl>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Suivant : <a rel="next" accesskey="n" href="Other.fr.html#Other">Other</a>,
Précédent : <a rel="previous" accesskey="p" href="Music.fr.html#Music">Music</a>,
Haut : <a rel="up" accesskey="u" href="Text-markup-commands.fr.html#Text-markup-commands">Text markup commands</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Cette page documente LilyPond-2.11.57 (branche de développement).
<br>
<address>
Rapportez toute anomalie en français à <a href="mailto:lilypond-user-fr@gnu.org">lilypond-user-fr@gnu.org</a> ou en anglais à <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>
Vos <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions à propos de la documentation</a> sont les bienvenues.
</font>
</p>
</div>
<P>
Autres langues : <a href="Instrument-Specific-Markup.html">English</a>, <a href="Instrument-Specific-Markup.es.html">español</a>, <a href="Instrument-Specific-Markup.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
