Editing Using the whiteout property

Any graphical object can be printed over a white background to mask parts of objects that lie beneath. This can be useful to improve the appearance of collisions in complex situations when repositioning objects is impractical. It is necessary to explicitly set the <code>layer</code> property to control which objects are masked by the white background.

In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default layer 1, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.

<lilypond version="2.24.0">
{
  \override Score.StaffSymbol.layer = 4
  \override Staff.TimeSignature.layer = 3
  b'2 b'~
  \once \override Staff.TimeSignature.whiteout = ##t
  \time 3/4
  b' r4
}
</lilypond>

[[Category:Expressive marks]]
[[Category:Editorial annotations]]
[[Category:Included in the official documentation]]