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

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