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

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