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