%% 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/subdividing-beams.ly"
\sourcefileline 0
%% DO NOT EDIT this file manually; it was automatically
%% generated from `Documentation/snippets/new/`.
%%
%% Make any changes in `Documentation/snippets/new/`,
%% then run `scripts/auxiliar/makelsr.pl --new`.
%%
%% This file is in the public domain.
%%
%% Note: this file needs at least LilyPond version 2.25.23.

\version "2.25.23"

\header {
%% Translation of GIT committish: f11513f36c131dab18338d6a3a729e24a927150d
  texidocja = "
16 分音符 (あるいはそれより短い音符) の連桁は、デフォルトでは細分されません。@c
つまり、3 つ以上の音符全体が分かれることなく平等に連桁で繋がれます。@c
この挙動は、@code{subdivideBeams} プロパティをセットすることで、@c
連桁を細分するように変更することができます。このプロパティがセットされると、@c
連桁が現在の @code{beatBase} の間隔で細分されて表示されるようになります。@c
分割された後の音符全体の長さが分割長より短い (不完全な連桁) 場合は、@c
連桁の本数は可能な最長分割グループが基になります。@c
しかし、分割された後の音符が 1 つしか存在しない場合、この制限は@c
適用されません。
@code{beatBase} は、明示的にセットされなければ、現在の拍子記号の@c
分母分の 1 に設定されます。@c
@code{beatBase} は、このスニペットのように
@code{ly:make-moment} 関数を用いて、連桁を分割する単位となる長さを分数で@c
指定する必要があります。@c
また、@code{beatBase} が変更された場合、@code{beatStructure} も新たな
@code{beatBase} に合わせて変更する必要があります:
"
  doctitleja = "連桁を細分する"

%% Translation of GIT committish: 2f3474d9af596d677ed5b7ce720ae4d0954a6b51
  texidocit = "
Le travature di note consecutive di un sedicesimo (o più brevi) non
vengono suddivise, ovvero i tre (o più) tratti della travatura si
estendono, senza spezzarsi, sugli interi gruppi di note.
Questo comportamento può essere modificato in modo da suddividere le
travature in sottogruppi attraverso la proprietà
@code{subdivideBeams}. Se impostata, le travature che comprendono più
sottogruppi verranno suddivise a intervalli definiti dal
valore attuale di @code{beatBase}, riducendo le travature multiple
al numero di travature che indica il valore metrico della suddivisione.
Se il gruppo successivo alla suddivisione è più breve del valore
metrico corrente (di solito perché la travatura è incompleta), il
numero di travature riflette il gruppo di suddivisione più lungo
possibile.  Tuttavia, se rimane una sola nota dopo la divisione, questa
restrizione non viene applicata.
Si noti che @code{beatBase}, se non impostata
esplicitamente, equivale a uno fratto il denominatore dell'attuale
indicazione di tempo.  Deve quindi essere impostata su una frazione
che stabilisca la durata del sottogruppo di travature; lo si può fare
usando la funzione @code{ly:make-moment}, come è mostrato in questo
frammento di codice.  Inoltre quando @code{beatBase} cambia, anche
@code{beatStructure} deve essere modificato per accordarsi con
@code{beatBase}:

"
  doctitleit = "Suddividere le travature"

%% Translation of GIT committish: de1e42ce512f3690387cdd065109bddff1b7bd6d
  texidocfr = "
Les ligatures d'une succession de notes de durée inférieure ou égale à
la double croche ne sont pas subdivisées par défaut. Autrement dit, tous
les traits de ligature (deux ou plus) seront continus. Ce comportement
peut être modifié afin de diviser la ligature en sous-groupes grâce à la
propriété @code{subdivideBeams}. Lorsqu'elle est activée, un certain
nombre de traits de ligature entre deux hampes est supprimé à des
intervalles correspondant à la durée de sous-groupe souhaitée.

Les propriétés @code{beamMinimumSubdivision} et
@code{beamMaximumSubdivision} permettent de configurer les
limites de la subdivision automatique des ligatures : l'intervalle
rythmique minimum auquel subdiviser et le nombre de tronçons supprimés
selon cet intervalle. Leur valeur par défaut est respectivement
de @code{0} et @code{+inf.0}, ce qui demandera à LilyPond de subdiviser
le plus possible.

Certains cas particulier doivent être pris en considération.

@itemize
@item
Lorsque le nombre fourni en numérateur à @code{beamMaximumSubdivision}
n'est pas une puissance de 2, la plus petite durée pour subdiviser sera
de @code{beamMaximumSubdivision} divisé par une puissance de 2 tout en
restant supérieur ou égal à @code{beamMinimumSubdivision}.

@item
Dès lors que @code{beamMaximumSubdivision} est inférieur à
@code{beamMinimumSubdivision}, la profondeur de subdivision se limite à
@code{beamMaximumSubdivision} mais pas la fréquence ou l'intervalle, ce
qui peut dévier de la valeur métrique à laquelle on est en droit de
s'attendre.
@end itemize

Lorsque la propriété @code{respectIncompletBeams} est activée, les
subdivisions incomplètes à plus de deux hampes sont considérées comme
« extension » du sous-groupe précédent, autrement dit, le groupe de
subdivision précédente sera étendu pour couvrir aussi la subdivision
incomplète. Lorsqu'elle est désactivée, ce qui est le cas par défaut,
une nouvelle subdivision est alors entamée.
"

  doctitlefr = "Subdivision des ligatures"

%% Translation of GIT committish: 4f16fa98fd258f08e64203c793028ea3e363b1c0
  texidoces = "
Las barras de semicorchea, o de figuras más breves, no se
subdividen de forma predeterminada.  Esto es, las barras de más de
dos plicas se amplían sobre el grupo completo de notas, sin
dividirse.  Este comportamiento se puede modificar para subdividir
las barras en subgrupos mediante el establecimiento de la
propiedad @code{subdivideBeams} al valor @code{#t}.  Cuando está
activada, las barras se subdividen a intervalos definidos por el
valor actual de la subivisión.

Usando las propiedades @code{beamMinimumSubdivision} y
@code{beamMaximumSubdivision} se pueden configurar los límites de
la subdivisión automática de las barras, concretamente las
duraciones mínima y máxima en que las barras secundarios se
eliminan.  Los valores por omisión son@tie{}@code{0} para la
primera y @code{+inf.0} para la segunda, haciendo que LilyPond
subdivida las barras tanto como sea posible.

Existen dos casos especiales que tener en cuenta.

@itemize
@item
Si el numerador de @code{beamMaximumSubdivision} no es una
potencia de@tie{}2, las duraciones candidatas a la subdivisión son
@code{beamMaximumSubdivision} dividido por las potencias de@tie{}2
que sean mayores o iguales que @code{beamMinimumSubdivision}.

@item
Si @code{beamMaximumSubdivision} es menor que
@code{beamMinimumSubdivision}, la profundidad de las subdivisiones
de las barras está limitada por @code{beamMaximumSubdivision},
pero no la frecuencia y los intervalos rítmicos, desviándose por
tanto, posiblemente, de las longitudes correctas o
esperadas.
@end itemize

Si @code{respectIncompleteBeams} se fija al valor @code{#t}, las
subdivisiones incompletas con más de dos plicas se tratan como una
@q{extensión} del grupo de subdivisión previo, es decir, la
duración del grupo de subdivisión anterior se extiende para que
comprenda también la subdivisión incompleta.  Si en vez de ello se
fija a @code{#f} (que es lo predeterminado), se inicia un grupo de
subdivisión nuevo.
"
  doctitlees = "Subdivisión de barras"

%% Translation of GIT committish: f91c9533a7217e9d19eccc3c192ea9222efdbfc4
  texidocca = "
Les barres de semicorxera, o de figures més breus, no es subdivideixen
de forma predeterminada.  És a dir, les tres (o més) barres s'amplien
sense trencar-se sobre grups complets de notes.  Aquest comportament
es pot modificar per subdividir les barres en subgrups mitjançant
l'establiment de la propietat @code{subdivideBeams}.  Quan està
activada, les barres es subdivideixen a intervals definits pel
valor actual de @code{beatBase} mitjançant la reducció de les
barres repetides a una sola entre els subgrups.  Observeu que el
valor predeterminat de @code{beatBase} és un més que el
denominador del tipus de compàs actual, si no es fixa explícitament.
S'ha d'ajustar a una fracció que dóna la duració del subgrup de
barres utilitzant la funció @code{ly:make-moment}, como es veu en
aquest fragment de codi.  Així mateix, quan es modifica
@code{beatBase}, s'hauria de canviar també @code{beatStructure}
perquè correspongui al @code{beatBase} nou:

"
  doctitleca = "Subdivisió de barres"

  categories = "Rhythms"

  texidoc = "
The beams of consecutive 16th (or shorter) notes are, by default,
not subdivided.  That is, the beams of more than two stems stretch
over the entire group of notes without a break.  This behavior can
be modified to subdivide the beams into sub-groups by setting the
property @code{subdivideBeams} to @code{#t}.  When set, beams are
subdivided at (rhythmic) intervals to match the metric value of
the subdivision.

Using the properties @code{beamMinimumSubdivision} and
@code{beamMaximumSubdivision} it is possible to configure the
limits of automatic beam subdivision, namely the minimum and
maximum rhythmic lengths at which beamlets are removed.  The
default values are@tie{}@code{0} for the former and @code{+inf.0}
for the latter, making LilyPond subdivide beams as much as
possible.

There are two special cases to consider.

@itemize
@item
If the numerator of @code{beamMaximumSubdivision} is not a power
of@tie{}2, the rhythmic lengths considered for subdivision are
@code{beamMaximumSubdivision} divided by powers of@tie{}2 that
stay greater than or equal to @code{beamMinimumSubdivision}.

@item
If @code{beamMaximumSubdivision} is smaller than
@code{beamMinimumSubdivision}, the depth of beam subdivisions is
limited by @code{beamMaximumSubdivision}, but not the frequency
and rhythmic intervals, therefore possibly deviating from the
correct, expected metric value.
@end itemize

If @code{respectIncompleteBeams} is set to @code{#t}, incomplete
subdivisions with more than two stems are treated as an
@q{extension} of the previous subdivision group, i.e., the length
of the previous subdivision group gets extended to also cover the
incomplete subdivision.  If set to @code{#f} (which is the
default), a new subdivision group gets started instead.
"

  doctitle = "Subdividing beams"
} % begin verbatim


\relative c'' {
  \time 1/4

  <>^"default"
  c32 c c c c c c c

  <>^"with subdivision"
  \set subdivideBeams = ##t
  c32 c c c c c c c

  <>^"min 1/8"
  \once \set beamMinimumSubdivision = #1/8
  c32 c c c c c c c

  <>^"max 1/16"
  \once \set beamMaximumSubdivision = #1/16
  c32 c c c c c c c

  <>^"max 3/8"
  \once \set beamMaximumSubdivision = #3/8
  \repeat unfold 16 c64

  <>^"min 1/32, max 1/64"
  % Set maximum beam subdivision interval to 1/64 to limit
  % subdivision depth, despite not being metrically correct.
  \once \set beamMinimumSubdivision = #1/32
  \once \set beamMaximumSubdivision = #1/64
  \repeat unfold 32 c128
  \break

  <>^"beams with incomplete subdivisions"
  c32 c c c c c c r32
  c32 c c c c r16.

  <>^\markup { "the same with"
               \typewriter { "respectIncomplete=#t" } }
  \set respectIncompleteBeams = ##t
  % The incomplete subgroup extends the completed subgroup.
  c32 c c c c c c r32
  % No visual change since we have only two stems in the
  % incomplete subgroup.
  c32 c c c c r16.
}



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