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 = "expressive-marks, editorial-annotations"
  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 %% Translation of GIT committish: d5307870fe0ad47904daba73792c7e17b813737f
  38   texidocfr = "
  39 Tout objet graphique peut s'imprimer sur un fond blanc afin de masquer
  40 une partie des objets qu'il recouvre.  Ceci trouve toute son utilité
  41 pour améliorer certaines collisions, notamment dans des situations où un
  42 repositionnement d'objets est irréaliste.  Il faut alors explicitement
  43 définir la propriété @code{layer} afin de contrôler quels objets seront
  44 masqués par le fond blanc.
  45
  46 Dans l'exemple ci-dessous, la liaison est en collision avec la
  47 métrique ; la situation est améliorée dès lors que la portion de liaison
  48 qui traverse la métrique est masquée par l'affectation de la propriété
  49 @code{whiteout} à l'objet @code{TimeSignature}.  Pour ce faire,
  50 @code{TimeSignature} est déplacé sur un calque au-dessus de celui de
  51 @code{Tie} -- il reste sur le calque par défaut (1) --, puis le
  52 @code{StaffSymbol} est placé sur un calque supérieur à celui de
  53 @code{TimeSignature} pour ne pas être masqué.
  54
  55 "
  56   doctitlefr = "Utilisation de la propriété whiteout"
  57
  58   texidoc = "
  59 Any graphical object can be printed over a white background to mask
  60 parts of objects that lie beneath.  This can be useful to improve the
  61 appearance of collisions in complex situations when repositioning
  62 objects is impractical.  It is necessary to explicitly set the
  63 @code{layer} property to control which objects are masked by the white
  64 background.
  65
  66 In this example the collision of the tie with the time signature is
  67 improved by masking out the part of the tie that crosses the time
  68 signature by setting the @code{whiteout} property of
  69 @code{TimeSignature}. To do this @code{TimeSignature} is moved to a
  70 layer above @code{Tie}, which is left in the default layer of 1, and
  71 @code{StaffSymbol} is moved to a layer above @code{TimeSignature} so it
  72 is not masked.
  73
  74 "
  75   doctitle = "Using the whiteout property"
  76 } % begin verbatim
  77
  78 {
  79   \override Score.StaffSymbol #'layer = #4
  80   \override Staff.TimeSignature #'layer = #3
  81   b'2 b'~
  82   \once \override Staff.TimeSignature #'whiteout = ##t
  83   \time 3/4
  84   b' r4
  85 }