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.20"
   6
   7 \header {
   8 %% Translation of GIT committish: d2119a9e5e951c6ae850322f41444ac98d1ed492
   9
  10   texidoces = "
  11
  12 Se puede imprimir cualquier objeto gráfico sobre un fondo blanco para
  13 enmascarar parte de los objetos que están por debajo.  Esto puede ser
  14 útil para mejorar el aspecto de las colisiones en situaciones
  15 complejas cuando no es práctico reposicionar los objetos.  Es
  16 necesario establecer explícitamente la propiedad de capa
  17 (@code{layer}) para controlar qué objetos resultan enmascarados por el
  18 fondo blanco.
  19
  20 En este ejemplo, la colisión de la ligadura de unión con la indicación
  21 de compás resulta mejorada enmascarando la parte de la ligadura que
  22 cruza a la indicación de compás mediante el establecimiento de la
  23 propiedad @code{whiteout} de @code{TimeSignature}.  Para hacer esto,
  24 se mueve @code{TimeSignature} a una capa por encima de @code{Tie}, que
  25 se deja en la capa predeterminada de 1, y @code{StaffSymbol} se mueve
  26 a una capa por encima de @code{TimeSignature} de manera que no resulte
  27 enmascarada.
  28
  29 "
  30
  31   doctitlees = "Uso de la propiedad whiteout"
  32
  33   lsrtags = "expressive-marks, editorial-annotations"
  34   texidoc = "
  35 Any graphical object can be printed over a white backgound to
  36 mask parts of objects that lie beneath.  This can be useful to
  37 improve the appearance of collisions in complex situations when
  38 repositioning objects is impractical.  It is necessary to explicitly
  39 set the @code{layer} property to control which objects are masked
  40 by the white background.
  41
  42 In this example the collision of the tie with the time signature is
  43 improved by masking out the part of the tie that crosses the time
  44 signature by setting the @code{whiteout} property of @code{TimeSignature}.
  45 To do this @code{TimeSignature} is moved to a layer above @code{Tie}, which
  46 is left in the default layer of 1, and @code{StaffSymbol} is moved to a
  47 layer above @code{TimeSignature} so it is not masked.
  48 "
  49   doctitle = "Using the whiteout property"
  50 } % begin verbatim
  51
  52
  53 {
  54   \override Score.StaffSymbol #'layer = #4
  55   \override Staff.TimeSignature #'layer = #3
  56   b'2 b'~
  57   \once \override Staff.TimeSignature #'whiteout = ##t
  58   \time 3/4
  59   b' r4
  60 }