%% Generated by lilypond-book
%% Options: [exampleindent=10.16\mm,indent=0\mm,line-width=160\mm]
\include "lilypond-book-preamble.ly"


% ****************************************************************
% Start cut-&-pastable-section
% ****************************************************************

#(ly:set-option 'eps-box-padding 3.000000)



\paper {
  indent = 0\mm
  line-width = 160\mm
  % offset the left padding, also add 1mm as lilypond creates cropped
  % images with a little space on the right
  line-width = #(- line-width (* mm  3.000000) (* mm 1))
}

\layout {
  
}




% ****************************************************************
% ly snippet:
% ****************************************************************
\sourcefilename "snippets/using-the-whiteout-property.ly"
\sourcefileline 0
%% DO NOT EDIT this file manually; it was automatically
%% generated from the LilyPond Snippet Repository
%% (http://lsr.di.unimi.it).
%%
%% Make any changes in the LSR itself, or in
%% `Documentation/snippets/new/`, then run
%% `scripts/auxiliar/makelsr.pl`.
%%
%% This file is in the public domain.

\version "2.23.13"

\header {
%% Translation of GIT committish: f11513f36c131dab18338d6a3a729e24a927150d
  texidocja = "
下にあるオブジェクトの一部分をマスクするために、任意のグラフィカル
オブジェクトを白い背景の上に表示することができます。これは、衝突を解決@c
するためにオブジェクトを移動するのが困難であるような複雑な状況において、@c
見た目を改善するのに有効です。@code{layer} プロパティを明示的に設定して、@c
どのオブジェクトが白でマスクされるかを指定しなければなりません。

この例では、タイと拍子記号が重なる部分について、タイの方をマスクしています。@c
そのためには @code{TimeSignature} の @code{whiteout} プロパティを設定し、@c
@code{TimeSignature} を @code{Tie} の上のレイヤに移動する必要があります。@c
@code{Tie} のデフォルトのレイヤは 1 であるため、@code{TimeSignature}
のレイヤ値をそれより大きくします。また、@code{StaffSymbol} が@c
マスクされないように、更に上位のレイヤに配置する必要があります。
"
  doctitleja = "whiteout プロパティを使用する"

%% Translation of GIT committish: 2f3474d9af596d677ed5b7ce720ae4d0954a6b51
  texidocit = "
Qualsiasi oggetto grafico può essere posizionato sopra uno sfondo
bianco per mascherare parti degli oggetti che si trovano sotto.
Ciò può essere utile per migliorare l'aspetto delle collisioni in
situazioni complesse in cui il riposizionamento degli oggetti è
troppo difficile. Bisogna impostare esplicitamente la proprietà
@code{layer} (livello) per controllare quali oggetti debbano essere
mascherati dallo sfondo bianco.

In questo esempio la collisione della legatura di valore con l'indicazione
di tempo viene migliorata mascherando la parte della legatura che incrocia
l'indicazione di tempo impostando la proprietà @code{whiteout} di
@code{TimeSignature}. Per farlo si sposta @code{TimeSignature} su un
livello superiore a @code{Tie}, che viene lasciato al livello predefinito 1;
e @code{StaffSymbol} viene spostato su un livello superiore a @code{TimeSignature}
in modo che non venga mascherato.

"
  doctitleit = "Uso della proprietà whiteout"

%% Translation of GIT committish: a3fd5364fc4f247579da0ed2bfea887ab37285c6
  texidocfr = "
Tout objet graphique peut s'imprimer sur un fond blanc afin de masquer
une partie des objets qu'il recouvre. Ceci trouve toute son utilité pour
améliorer certaines collisions, notamment dans des situations où un
repositionnement d'objets est irréaliste. Il faut alors explicitement
définir la propriété @code{layer} afin de contrôler quels objets seront
masqués par le fond blanc. Dans l'exemple ci-dessous, la liaison est en
collision avec la métrique ; la situation est améliorée dès lors que la
portion de liaison qui traverse la métrique est masquée par
l'affectation de la propriété @code{whiteout} à l'objet
@code{TimeSignature}. Pour ce faire, @code{TimeSignature} est déplacé
sur un calque au-dessus de celui de @code{Tie} -- il reste sur le calque
par défaut (1) --, puis le @code{StaffSymbol} est placé sur un calque
supérieur à celui de @code{TimeSignature} pour ne pas être masqué.
"

  doctitlefr = "Utilisation de la propriété @code{whiteout}"

%% Translation of GIT committish: 0c00cd98e81b27325bed5891b950fe7f0f0ebe5d
  texidoces = "
Se puede imprimir cualquier objeto gráfico sobre un fondo blanco para
enmascarar parte de los objetos que están por debajo.  Esto puede ser
útil para mejorar el aspecto de las colisiones en situaciones
complejas cuando no es práctico reposicionar los objetos.  Es
necesario establecer explícitamente la propiedad de capa
(@code{layer}) para controlar qué objetos resultan enmascarados por el
fondo blanco.

En este ejemplo, la colisión de la ligadura de unión con la indicación
de compás resulta mejorada enmascarando la parte de la ligadura que
cruza a la indicación de compás mediante el establecimiento de la
propiedad @code{whiteout} de @code{TimeSignature}.  Para hacer esto,
se mueve @code{TimeSignature} a una capa por encima de @code{Tie}, que
se deja en la capa predeterminada de 1, y @code{StaffSymbol} se mueve
a una capa por encima de @code{TimeSignature} de manera que no resulte
enmascarada.

"
  doctitlees = "Uso de la propiedad whiteout"

%% Translation of GIT committish: f0c956e3cda548bde3c7b8ca01bcd081ee07feae
  texidocca = "
Es pot imprimir qualsevol objecte gràfic sobre un fons blanc per
ocultar part dels objectes que estan a sota.  Això pot ser útil
per millorar l'aspecte de les col·lisions en situaciones complexes
quan no es pràctic tornar a col·locar els objectes.  Cal establir
explícitament la propietat de capa (@code{layer}) per controlar
quins objectes resulten ocultats pel fons blanc.

En aquest exemple, la col·lisió de la lligadura d'unió amb la
indicació de compàs resulta millorada ocultant la part de la
lligadura que creua la indicació de compàs mitjançant
l'establiment de la propietat @code{whiteout} de
@code{TimeSignature}.  per fer això, es mou @code{TimeSignature} a
una capa per sobre de @code{Tie}, que es deixa a la capa
predeterminada d'1, i @code{StaffSymbol} es mou a una capa per
sobre de @code{TimeSignature} de manera que no resulti ocultada.

"
  doctitleca = "Ús de la propietat whiteout"

  lsrtags = "editorial-annotations, expressive-marks"

  texidoc = "
Any graphical object can be printed over a white background to mask
parts of objects that lie beneath.  This can be useful to improve the
appearance of collisions in complex situations when repositioning
objects is impractical.  It is necessary to explicitly set the
@code{layer} property to control which objects are masked by the white
background. In this example the collision of the tie with the time
signature is improved by masking out the part of the tie that crosses
the time signature by setting the @code{whiteout} property of
@code{TimeSignature}. To do this @code{TimeSignature} is moved to a
layer above @code{Tie}, which is left in the default layer of 1, and
@code{StaffSymbol} is moved to a layer above @code{TimeSignature} so it
is not masked.
"

  doctitle = "Using the whiteout property"
} % begin verbatim


{
  \override Score.StaffSymbol.layer = #4
  \override Staff.TimeSignature.layer = #3
  b'2 b'~
  \once \override Staff.TimeSignature.whiteout = ##t
  \time 3/4
  b' r4
}



% ****************************************************************
% end ly snippet
% ****************************************************************