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

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