Documentation/snippets/new/using-the-whiteout-property.ly

   1 \version "2.13.10"
   2
   3 \header {
   4   lsrtags = "expressive-marks, editorial-annotations"
   5   texidoc = "
   6 Any graphical object can be printed over a white background to
   7 mask parts of objects that lie beneath.  This can be useful to
   8 improve the appearance of collisions in complex situations when
   9 repositioning objects is impractical.  It is necessary to explicitly
  10 set the @code{layer} property to control which objects are masked
  11 by the white background.
  12
  13 In this example the collision of the tie with the time signature is
  14 improved by masking out the part of the tie that crosses the time
  15 signature by setting the @code{whiteout} property of @code{TimeSignature}.
  16 To do this @code{TimeSignature} is moved to a layer above @code{Tie}, which
  17 is left in the default layer of 1, and @code{StaffSymbol} is moved to a
  18 layer above @code{TimeSignature} so it is not masked.
  19 "
  20   doctitle = "Using the whiteout property"
  21 }
  22
  23 {
  24   \override Score.StaffSymbol #'layer = #4
  25   \override Staff.TimeSignature #'layer = #3
  26   b'2 b'~
  27   \once \override Staff.TimeSignature #'whiteout = ##t
  28   \time 3/4
  29   b' r4
  30 }