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 %% Translation of GIT committish: d5307870fe0ad47904daba73792c7e17b813737f
  11   texidocfr = "
  12 Tout objet graphique peut s'imprimer sur un fond blanc afin de masquer
  13 une partie des objets qu'il recouvre.  Ceci trouve toute son utilité
  14 pour améliorer certaines collisions, notamment dans des situations où un
  15 repositionnement d'objets est irréaliste.  Il faut alors explicitement
  16 définir la propriété @code{layer} afin de contrôler quels objets seront
  17 masqués par le fond blanc.
  18
  19 Dans l'exemple ci-dessous, la liaison est en collision avec la
  20 métrique ; la situation est améliorée dès lors que la portion de liaison
  21 qui traverse la métrique est masquée par l'affectation de la propriété
  22 @code{whiteout} à l'objet @code{TimeSignature}.  Pour ce faire,
  23 @code{TimeSignature} est déplacé sur un calque au-dessus de celui de
  24 @code{Tie} -- il reste sur le calque par défaut (1) --, puis le
  25 @code{StaffSymbol} est placé sur un calque supérieur à celui de
  26 @code{TimeSignature} pour ne pas être masqué.
  27
  28 "
  29   doctitlefr = "Utilisation de la propriété whiteout"
  30
  31   lsrtags = "expressive-marks, editorial-annotations"
  32
  33
  34 %% Translation of GIT committish: b482c3e5b56c3841a88d957e0ca12964bd3e64fa
  35
  36   texidoces = "
  37
  38 Se puede imprimir cualquier objeto gráfico sobre un fondo blanco para
  39 enmascarar parte de los objetos que están por debajo.  Esto puede ser
  40 útil para mejorar el aspecto de las colisiones en situaciones
  41 complejas cuando no es práctico reposicionar los objetos.  Es
  42 necesario establecer explícitamente la propiedad de capa
  43 (@code{layer}) para controlar qué objetos resultan enmascarados por el
  44 fondo blanco.
  45
  46 En este ejemplo, la colisión de la ligadura de unión con la indicación
  47 de compás resulta mejorada enmascarando la parte de la ligadura que
  48 cruza a la indicación de compás mediante el establecimiento de la
  49 propiedad @code{whiteout} de @code{TimeSignature}.  Para hacer esto,
  50 se mueve @code{TimeSignature} a una capa por encima de @code{Tie}, que
  51 se deja en la capa predeterminada de 1, y @code{StaffSymbol} se mueve
  52 a una capa por encima de @code{TimeSignature} de manera que no resulte
  53 enmascarada.
  54
  55 "
  56
  57   doctitlees = "Uso de la propiedad whiteout"
  58
  59   texidoc = "
  60 Any graphical object can be printed over a white background to mask
  61 parts of objects that lie beneath.  This can be useful to improve the
  62 appearance of collisions in complex situations when repositioning
  63 objects is impractical.  It is necessary to explicitly set the
  64 @code{layer} property to control which objects are masked by the white
  65 background.
  66
  67 In this example the collision of the tie with the time signature is
  68 improved by masking out the part of the tie that crosses the time
  69 signature by setting the @code{whiteout} property of
  70 @code{TimeSignature}. To do this @code{TimeSignature} is moved to a
  71 layer above @code{Tie}, which is left in the default layer of 1, and
  72 @code{StaffSymbol} is moved to a layer above @code{TimeSignature} so it
  73 is not masked.
  74
  75 "
  76   doctitle = "Using the whiteout property"
  77 } % begin verbatim
  78
  79 {
  80   \override Score.StaffSymbol #'layer = #4
  81   \override Staff.TimeSignature #'layer = #3
  82   b'2 b'~
  83   \once \override Staff.TimeSignature #'whiteout = ##t
  84   \time 3/4
  85   b' r4
  86 }