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

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