<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>The tweak command - GNU LilyPond Notation Reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Notation Reference">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.de.html#Top">
<link rel="up" href="Modifying-properties.de.html#Modifying-properties" title="Modifying properties">
<link rel="prev" href="The-override-command.de.html#The-override-command" title="The override command">
<link rel="next" href="set-versus-override.de.html#set-versus-override" title="set versus override">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<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="The-tweak-command"></a>
Next: <a rel="next" accesskey="n" href="set-versus-override.de.html#set-versus-override">set versus override</a>,
Previous: <a rel="previous" accesskey="p" href="The-override-command.de.html#The-override-command">The override command</a>,
Up: <a rel="up" accesskey="u" href="Modifying-properties.de.html#Modifying-properties">Modifying properties</a>
<hr>
</div>
<h4 class="subsection">5.3.4 The <code>\tweak</code> command</h4>
<p><a name="index-g_t_005ctweak-2699"></a><a name="index-g_t_005ctweak-2700"></a>
<a name="index-tweaking-2701"></a>
In some cases, it is possible to take a short-cut for tuning
graphical objects. For objects that are created directly from
an item in the input file, you can use the <code>\tweak</code> command.
For example:
<pre class="verbatim">
< c
\tweak #'color #red
d
g
\tweak #'duration-log #1
a
> 4
-\tweak #'padding #8
-^
</pre>
<p>
<a href="../b3/lily-cc668f05.ly">
<img align="middle"
border="0" src="../b3/lily-cc668f05.png" alt="[image of music]">
</a>
</p>
<p><a name="index-chord_002c-modifying-one-note-in-2702"></a>
But the main use of the <code>\tweak</code> command is to modify just
one of a number of notation elements which start at the same musical
moment, like the notes of a chord, or tuplet brackets which start
at the same time.
<p>For an introduction to the syntax and uses of the tweak command
see <a name="index-Tweaking-methods-2703"></a><a href="../lilypond-learning/Tweaking-methods.de.html#Tweaking-methods">Tweaking methods</a>.
<p>The <code>\tweak</code> command sets a property in the following object
directly, without requiring the grob name or context to be
specified. For this to work, it is necessary for the <code>\tweak</code>
command to remain immediately adjacent to the object to which it is
to apply after the input file has been converted to a music stream.
This is often not the case, as many additional elements are inserted
into the music stream implicitly. For example, when a note which is
not part of a chord is processed, Lilypond implicitly inserts a
<code>ChordEvent</code> event before the note, so separating the tweak
from the note. However, if chord symbols are placed round the
tweak and the note, the <code>\tweak</code> command comes after the
<code>ChordEvent</code> in the music stream, so remaining adjacent to the
note, and able to modify it.
<p>So, this works:
<blockquote>
<pre class="verbatim">
<\tweak #'color #red c>4
</pre>
<p>
<a href="../5b/lily-e04a24f0.ly">
<img align="middle"
border="0" src="../5b/lily-e04a24f0.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">but this does not:
<blockquote>
<pre class="verbatim">
\tweak #'color #red c4
</pre>
<p>
<a href="../35/lily-5ea3524b.ly">
<img align="middle"
border="0" src="../35/lily-5ea3524b.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>When several similar items are placed at the same musical moment,
the <code>\override</code> command cannot be used to modify just one of
them – this is where the <code>\tweak</code> command must be used.
Items which may appear more than once at the same musical moment
include the following:
<!-- TODO expand to include any further uses of \tweak -->
<ul>
<li>note heads of notes inside a chord
<li>articulation signs on a single note
<li>ties between notes in a chord
<li>tuplet brackets starting at the same time
</ul>
<!-- TODO add examples of these -->
<p class="noindent">and <code>\tweak</code> may be used to modify any single occurrence of
these items.
<p>Notably the <code>\tweak</code> command cannot be used to modify stems,
beams or accidentals, since these are generated later by note heads,
rather than by music elements in the input stream. Nor can a
<code>\tweak</code> command be used to modify clefs or time signatures,
since these become separated from any preceding <code>\tweak</code>
command in the input stream by the automatic insertion of extra
elements required to specify the context.
<p>But the <code>\tweak</code> command can be used as an alternative to
the <code>\override</code> command to modify those notational elements
that do not cause any additional implicit elements to be added
before them in the music stream. For example, slurs may be
modified in this way:
<blockquote>
<pre class="verbatim">
c-\tweak #'thickness #5 ( d e f)
</pre>
<p>
<a href="../1d/lily-dc761309.ly">
<img align="middle"
border="0" src="../1d/lily-dc761309.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Also several <code>\tweak</code> commands may be placed before a
notational element – all affect it:
<blockquote>
<pre class="verbatim">
c
-\tweak #'style #'dashed-line
-\tweak #'dash-fraction #0.2
-\tweak #'thickness #3
-\tweak #'color #red
\glissando
f'
</pre>
<p>
<a href="../ac/lily-27bdf109.ly">
<img align="middle"
border="0" src="../ac/lily-27bdf109.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>The music stream which is generated from a section of an input file,
including any automatically inserted elements, may be examined,
see <a href="Displaying-music-expressions.de.html#Displaying-music-expressions">Displaying music expressions</a>. This may be helpful in
determining what may be modified by a <code>\tweak</code> command.
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Learning Manual:
<a name="index-Tweaking-methods-2704"></a><a href="../lilypond-learning/Tweaking-methods.de.html#Tweaking-methods">Tweaking methods</a>.
<p>Notation Reference:
<a href="Displaying-music-expressions.de.html#Displaying-music-expressions">Displaying music expressions</a>.
<p class="noindent">
<h5 class="subsubheading">Known issues and warnings</h5>
<p><a name="index-tweaks-in-a-variable-2705"></a>The <code>\tweak</code> command cannot be used inside a variable.
<p><a name="index-tweaks-in-lyrics-2706"></a>The <code>\tweak</code> commands cannot be used in <code>\lyricmode</code>.
<p><a name="index-tweaking-control-points-2707"></a><a name="index-control-points_002c-tweaking-2708"></a>
The <code>\tweak</code> command cannot be used to modify the control
points of just one of several ties in a chord, other than the first
one encountered in the input file.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="set-versus-override.de.html#set-versus-override">set versus override</a>,
Previous: <a rel="previous" accesskey="p" href="The-override-command.de.html#The-override-command">The override command</a>,
Up: <a rel="up" accesskey="u" href="Modifying-properties.de.html#Modifying-properties">Modifying properties</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>
<P>
Andere Sprachen: <a href="The-tweak-command.fr.html">français</a>, <a href="The-tweak-command.es.html">español</a>.
<BR>
</P>
</BODY></html>
