<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Painting objects white - 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.html#Top">
<link rel="up" href="Controlling-visibility-of-objects.html#Controlling-visibility-of-objects" title="Controlling visibility of objects">
<link rel="prev" href="Making-objects-transparent.html#Making-objects-transparent" title="Making objects transparent">
<link rel="next" href="Using-break_002dvisibility.html#Using-break_002dvisibility" title="Using break-visibility">
<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="Painting-objects-white"></a>
Next: <a rel="next" accesskey="n" href="Using-break_002dvisibility.html#Using-break_002dvisibility">Using break-visibility</a>,
Previous: <a rel="previous" accesskey="p" href="Making-objects-transparent.html#Making-objects-transparent">Making objects transparent</a>,
Up: <a rel="up" accesskey="u" href="Controlling-visibility-of-objects.html#Controlling-visibility-of-objects">Controlling visibility of objects</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Painting objects white</h5>
<p><a name="index-objects_002c-coloring-2716"></a><a name="index-coloring-objects-2717"></a><a name="index-layers-2718"></a><a name="index-printing-order-2719"></a><a name="index-overwriting-objects-2720"></a><a name="index-objects_002c-overwriting-2721"></a><a name="index-grobs_002c-overwriting-2722"></a>
Every layout object has a color property which by default is set
to <code>black</code>. If this is overridden to <code>white</code> the object
will be indistinguishable from the white background. However,
if the object crosses other objects the color of the crossing
points will be determined by the order in which they are drawn,
and this may leave a ghostly image of the white object, as shown
here:
<blockquote>
<pre class="verbatim">
\override Staff.Clef #'color = #white
a1
</pre>
<p>
<a href="../23/lily-7892cbfc.ly">
<img align="middle"
border="0" src="../23/lily-7892cbfc.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>This may be avoided by changing the order of printing the objects.
All layout objects have a <code>layer</code> property which should be set
to an integer. Objects with the lowest value of <code>layer</code> are
drawn first, then objects with progressively higher values are drawn,
so objects with higher values overwrite objects with lower values.
By default most objects are assigned a <code>layer</code> value of
<code>1</code>, although a few objects, including <code>StaffSymbol</code> and
<code>BarLine</code>, are assigned a value of <code>0</code>. The order of
printing objects with the same value of <code>layer</code> is indeterminate.
<p>In the example above the white clef, with a default <code>layer</code>
value of <code>1</code>, is drawn after the staff lines (default
<code>layer</code> value <code>0</code>), so overwriting them. To change this,
the <code>Clef</code> object must be given in a lower value of
<code>layer</code>, say <code>-1</code>, so that it is drawn earlier:
<blockquote>
<pre class="verbatim">
\override Staff.Clef #'color = #white
\override Staff.Clef #'layer = #-1
a1
</pre>
<p>
<a href="../47/lily-e804f239.ly">
<img align="middle"
border="0" src="../47/lily-e804f239.png" alt="[image of music]">
</a>
</p>
</blockquote>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Using-break_002dvisibility.html#Using-break_002dvisibility">Using break-visibility</a>,
Previous: <a rel="previous" accesskey="p" href="Making-objects-transparent.html#Making-objects-transparent">Making objects transparent</a>,
Up: <a rel="up" accesskey="u" href="Controlling-visibility-of-objects.html#Controlling-visibility-of-objects">Controlling visibility of 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>
