%% Generated by lilypond-book
%% Options: [exampleindent=10.16\mm,indent=0\mm,line-width=160\mm,paper-height=845.047\pt,paper-width=597.508\pt,papersize='(cons (* 597.508 pt) (* 845.047 pt))]
\include "lilypond-book-preamble.ly"


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

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



\paper {
  #(set-paper-size '(cons (* 597.508 pt) (* 845.047 pt)))
  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 Wiki
%% (https://wiki.lilypond.community).
%%
%% Make any changes in the Wiki itself, or in
%% `Documentation/snippets/new/`, then run
%% `scripts/auxiliar/makelsr.pl`.
%%
%% This file is in the public domain.

\version "2.24.0"

\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: de1e42ce512f3690387cdd065109bddff1b7bd6d
  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: 4f16fa98fd258f08e64203c793028ea3e363b1c0
  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 estableciendo 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@tie{}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 @code{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"

  categories = "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, 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@tie{}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
% ****************************************************************