<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Accidental_engraver - 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.de.html#Top">
<link rel="up" href="Engravers-and-Performers.de.html#Engravers-and-Performers" title="Engravers and Performers">
<link rel="next" href="Ambitus_005fengraver.de.html#Ambitus_005fengraver" title="Ambitus_engraver">
<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="Accidental_engraver"></a>
<a name="Accidental_005fengraver"></a>
Next: <a rel="next" accesskey="n" href="Ambitus_005fengraver.de.html#Ambitus_005fengraver">Ambitus_engraver</a>,
Up: <a rel="up" accesskey="u" href="Engravers-and-Performers.de.html#Engravers-and-Performers">Engravers and Performers</a>
<hr>
</div>
<h4 class="unnumberedsubsec">Accidental_engraver</h4>
<p>Make accidentals. Catch note heads, ties and notices key-change events. This engraver usually lives at Staff level, but reads the settings for Accidental at <code>Voice</code> level, so you can <code>\override</code> them at <code>Voice</code>.
<p>Properties (read)
<blockquote>
<dl>
<dt><code>autoAccidentals</code> (list)<dd>List of different ways to typeset an
accidental.
<p>For determining when to print an accidental, several different rules
are tried. The rule that gives the highest number of accidentals is
used. Each rule consists of
<dl>
<dt><var>context</var><dd>In which context is the rule applied. For example, if <var>context</var>
is <a href="Score.de.html#Score">Score</a> then all staves share accidentals, and if
<var>context</var> is <a href="Staff.de.html#Staff">Staff</a> then all voices in the same staff
share accidentals, but staves do not.
<br><dt><var>octavation</var><dd>Whether the accidental changes all octaves or only the current octave.
Valid choices are
<dl>
<dt><code>same-octave</code><dd>This is the default algorithm. Accidentals are typeset if the note
changes the accidental of that note in that octave. Accidentals lasts
to the end of the measure and then as many measures as specified in the
value. This is, <code>1</code> means to the end of next measure,
<code>-1</code> means to the end of previous measure (that is: no
duration at all), etc. <code>#t</code> means forever.
<br><dt><code>any-octave</code><dd>Accidentals are typeset if the note is different from the previous note
on the same pitch in any octave. The value has same meaning as in
<code>same-octave</code>.
</dl>
<br><dt><var>laziness</var><dd>Over how many bar lines the accidental lasts. If <var>laziness</var> is
<code>-1</code> then the accidental is forgotten immediately, and if
<var>laziness</var> is <code>#t</code> then the accidental lasts forever.
</dl>
<br><dt><code>autoCautionaries</code> (list)<dd>List similar to <code>autoAccidentals</code>,
but it controls cautionary accidentals rather than normal ones. Both
lists are tried, and the one giving the most accidentals wins. In
case of draw, a normal accidental is typeset.
<br><dt><code>internalBarNumber</code> (integer)<dd>Contains the current barnumber.
This property is used for internal timekeeping, among others by the
<code>Accidental_engraver</code>.
<br><dt><code>extraNatural</code> (boolean)<dd>Whether to typeset an extra natural sign
before accidentals changing from a non-natural to another
non-natural.
<br><dt><code>harmonicAccidentals</code> (boolean)<dd>If set, harmonic notes in chords
get accidentals.
<br><dt><code>localKeySignature</code> (list)<dd>The key signature at this point in the
measure. The format is the same as for <code>keySignature</code>, but can
also contain <code>((</code><var>octave</var><code> . </code><var>name</var><code>) . (</code><var>alter</var><code> .
</code><var>barnumber</var><code>))</code> pairs.
</dl>
</blockquote>
Properties (write)
<blockquote>
<dl>
<dt><code>localKeySignature</code> (list)<dd>The key signature at this point in the
measure. The format is the same as for <code>keySignature</code>, but can
also contain <code>((</code><var>octave</var><code> . </code><var>name</var><code>) . (</code><var>alter</var><code> .
</code><var>barnumber</var><code>))</code> pairs.
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
<p><a href="Accidental.de.html#Accidental">Accidental</a>, <a href="AccidentalCautionary.de.html#AccidentalCautionary">AccidentalCautionary</a> and <a href="AccidentalSuggestion.de.html#AccidentalSuggestion">AccidentalSuggestion</a>.
<p><code>Accidental_engraver</code> is part of the following context(s): <a href="GregorianTranscriptionStaff.de.html#GregorianTranscriptionStaff">GregorianTranscriptionStaff</a>, <a href="MensuralStaff.de.html#MensuralStaff">MensuralStaff</a>, <a href="Staff.de.html#Staff">Staff</a> and <a href="VaticanaStaff.de.html#VaticanaStaff">VaticanaStaff</a>.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
<a name="Accidental_005fengraver"></a>
Next: <a rel="next" accesskey="n" href="Ambitus_005fengraver.de.html#Ambitus_005fengraver">Ambitus_engraver</a>,
Up: <a rel="up" accesskey="u" href="Engravers-and-Performers.de.html#Engravers-and-Performers">Engravers and Performers</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Diese Seite ist für LilyPond-2.11.57 (Entwicklungszweig).
<br>
<address>
Fehler bitte an <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> melden. </address>
<br>
Ihre <a href="http://lilypond.org/web/devel/participating/documentation-adding">Vorschläge für die Dokumentation</a> sind willkommen.
</font>
</p>
</div>
</BODY></html>
