1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: ja -*-
3 Translation of GIT committish: d5647c5fd1c38d4124d2374725b923f4901f3661
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
13 @c Translators: Yoshiki Sawada
14 @c Translation status: post-GDP
19 @translationof General input and output
21 このセクションでは、特定の記譜法ではなく、@c
22 LilyPond の一般的な入出力の問題について扱います。
36 @translationof Input structure
38 LilyPond の入力の主となるフォーマットはテキスト ファイルです。@c
39 習慣として、それらのファイルの最後には @file{.ly} を付けます。
43 * book の中にある複数の score::
44 * 1 つの入力ファイルから複数の出力ファイルを生成する::
52 @translationof Structure of a score
56 @code{\score} ブロックは、波括弧で囲まれた単一の音楽表記を@c
65 @warning{@code{\score} ブロックの中には、@c
66 最上位の音楽表記が @strong{1 つだけ} 存在していなければならず、@c
67 その音楽表記は波括弧で囲まれていなければ@strong{なりません}。}
69 この単一の音楽表記は任意のサイズになり得ます。@c
70 そして、それは他の音楽表記を保持して任意の複雑さを持ち得ます。@c
77 @lilypond[verbatim,quote]
84 @lilypond[verbatim,quote]
86 \new Staff { c'4 c' c' c' }
87 \new Staff { d'4 d' d' d' }
95 \new Staff @{ \flute @}
96 \new Staff @{ \oboe @}
99 \new Staff @{ \violinI @}
100 \new Staff @{ \violinII @}
106 この一般規則の例外の 1 つにコメントがあります。@c
107 (他の例外は、@ref{File structure} を参照してください。)@c
108 単一行コメントと複数行コメント (@code{%@{ .. %@}} で囲まれます) は@c
109 どちらも入力ファイルの任意の場所に配置することができます。@c
110 コメントは @code{\score} ブロックの内側あるいは外側に@c
111 配置することができ、@code{\score} ブロックの中にある単一の音楽表記の@c
112 内側あるいは外側に配置することができます。
114 たとえ @code{\score} ブロックだけを保持しているファイルであっても、@c
115 暗黙的に @code{\book} ブロックで囲まれるということを覚えておいてください。@c
116 ソース ファイルの中にある @code{\book} は少なくとも 1 つの@c
118 デフォルトでは出力ファイル名は入力ファイル名から派生します。@c
119 @file{fandangoforelephants.ly} は @file{fandangoforelephants.pdf} を@c
122 (@code{\book} ブロックについての詳細は、@c
123 @ref{Multiple scores in a book}、@c
124 @ref{Multiple output files from one input file}、@c
125 @ref{File structure} を参照してください。)
129 @rlearning{Working on input files},
130 @rlearning{Music expressions explained},
131 @rlearning{Score is a (single) compound musical expression}
134 @node book の中にある複数の score
135 @subsection book の中にある複数の score
136 @translationof Multiple scores in a book
139 @cindex movements, multiple (複数の楽章)
141 ドキュメントは複数の楽曲とテキストを含むことができます。@c
142 そのようなドキュメントの例には練習曲集や、@c
143 複数の楽章を持つオーケストラのパート譜があります。@c
144 楽章はそれぞれ @code{\score} ブロックで入力され、
152 テキストは @code{\markup} ブロックで入力されます。
162 同じ @file{.ly} ファイルの中にあるすべての楽章とテキストは、@c
163 通常、単一の出力ファイルとして譜刻されます。
177 重要な例外として lilypond-book ドキュメントがあります。@c
178 lilypond-book ドキュメントでは、明示的に @code{\book} ブロックを追加する@c
180 さもなければ、最初の @code{\score} あるいは @code{\markup} だけが出力に@c
183 音楽の各節のヘッダはその節の @code{\score} ブロックの中に置くことができます。@c
184 そのヘッダからの @code{piece} 名がそれぞれの楽章の前に譜刻されます。@c
185 book 全体のタイトルは @code{\book} の中に置くことができます。@c
186 しかしながら、@code{\book} が存在しない場合は、@code{\header} を@c
191 title = "Eight miniatures"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romanze" @}
199 ..text of second verse..
202 ..text of third verse..
206 \header @{ piece = "Menuetto" @}
212 @code{\bookpart} ブロックを用いて、
213 複数の楽曲を book のパートとしてグループ化することができます。
215 book パートは改ページで区切られ、book 自体と同様に
216 @code{\header} ブロックによりタイトルを持つことができます。
222 subtitle = "First part"
229 subtitle = "Second part"
237 @node 1 つの入力ファイルから複数の出力ファイルを生成する
238 @subsection 1 つの入力ファイルから複数の出力ファイルを生成する
239 @translationof Multiple output files from one input file
241 1 つの @file{.ly} ファイルから複数の出力ファイルを得たいのであれば、@c
242 @file{.ly} ファイルに複数の @code{\book} ブロックを記述します。@c
243 各 @code{\book} ブロックが個々に出力ファイルになります。@c
244 入力ファイルで @code{\book} ブロックを記述しなければ、@c
245 LilyPond は暗黙的にファイル全体を単一の @code{\book} として扱います。@c
246 @ref{File structure} を参照してください。
248 単一のソース ファイルから複数のファイルを作り出す時、@c
249 LilyPond は、@code{\book} ブロックが作り出す出力ファイルが@c
250 同じ入力ファイル内にある他の @code{\book} ブロックが作り出した出力ファイルを@c
253 入力ファイルから派生するデフォルトの出力ファイル名に
254 @code{\book} 毎の接尾辞を付け加えることによって上書きされないことを保証します。
257 デフォルトでは出力ファイル名にバージョン番号の接尾辞を付け加えます。@c
258 ソース ファイル @file{eightminiatures.ly} 内の以下の記述
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
271 \layout @{ @dots{} @}
279 @file{eightminiatures.pdf},
281 @file{eightminiatures-1.pdf} and
283 @file{eightminiatures-2.pdf}.
289 @translationof Output file names
291 @funindex \bookOutputSuffix
292 @funindex \bookOutputName
295 出力ファイルを作り出す時に出力ファイル名を制御するための様々な機能を提供します。
298 LilyPond がどのように単一のソース ファイルから作り出される複数の出力ファイルが@c
299 上書きされることを防ぐかを見てきました。@c
300 @code{\book} ブロック毎の出力ファイル名に付け加えられる接尾辞を@c
302 各 @code{\book} ブロックの内部に @code{\bookOutputSuffix} 宣言を@c
304 @file{eightminiatures-Romanze.pdf}, @file{eightminiatures-Menuetto.pdf}
305 それに @file{eightminiatures-Nocturne.pdf} といった名前の出力ファイルを@c
310 \bookOutputSuffix "Romanze"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Menuetto"
317 \layout @{ @dots{} @}
320 \bookOutputSuffix "Nocturne"
322 \layout @{ @dots{} @}
326 @code{\bookOutputName} 宣言を用いることにより、@c
327 @code{\book} ブロックに入力ファイル名とは異なる出力ファイル名を@c
332 \bookOutputName "Romanze"
334 \layout @{ @dots{} @}
337 \bookOutputName "Menuetto"
339 \layout @{ @dots{} @}
342 \bookOutputName "Nocturne"
344 \layout @{ @dots{} @}
348 上記のファイルは下記の出力ファイルを作り出します:
362 @translationof File structure
372 @file{.ly} ファイルは最上位の表記を任意の数だけ保持することができます
373 -- ここで、最上位の表記とは以下の中の 1 つです:
377 @code{\paper}, @code{\midi}, @code{\layout} などの出力定義。@c
378 最上位にある出力定義はブック全体のデフォルト設定を変更します。@c
379 最上位に同じタイプの出力定義が複数ある場合は組み合わされますが、@c
380 衝突した場合は後ろの方にある出力定義が優先されます。@c
381 出力定義が @code{\layout} ブロックにどのような影響を与えるかの詳細は
382 @ref{The \layout block} を参照してください。
386 @code{#(set-default-paper-size "a7" 'landscape)} や
387 @code{#(ly:set-option 'point-and-click #f)} などの Scheme 表記。
390 @code{\header} ブロック。これはグローバル ヘッダ ブロックになります。@c
391 このブロックは、作曲者、曲名などのブック全体の設定定義を保持します。
394 @code{\score} ブロック。@c
395 この score は他の最上位の score とともに単一の @code{\book} にまとめられます。@c
397 変数 @code{toplevel-score-handler} を最上位の階層で設定することによって、@c
400 初期化ファイル @file{../scm/lily.scm} で定義されています。
403 @code{\book} ブロックは複数の楽章 (すなわち、複数の @code{\score} ブロック) を@c
404 論理的に 1 つのドキュメントにまとめます。@c
405 複数の @code{\score} が存在する場合、@c
406 それぞれの @code{\book} ブロックに対して 1 つずつ出力ファイルが作成され、@c
407 それぞれの出力ファイルの中では該当するすべての楽章が連結されます。@c
408 @file{.ly} ファイルの中で明示的に @code{\book} ブロックを@c
409 指定する必要があるケースはただ 1 つ、@c
410 単一の入力ファイルから複数の出力ファイルを作成することを望む場合です。@c
411 例外の 1 つに lilypond-book ドキュメントがあります
412 -- そこでは、同じ例の中に複数の @code{\socre} あるいは @code{\markup} を@c
413 配置したければ、明示的に @code{\book} ブロックを追加する必要があります。@c
415 変数 @code{toplevel-score-handler} を最上位の階層で設定することによって、@c
418 初期化ファイル @file{../scm/lily.scm} で定義されています。
421 @code{\bookpart} ブロック。@c
423 あるいは異なるパートで別々の @code{\paper} 設定を使用するために、@c
425 -- @code{\bookpart} を用いて --
426 いくつかのパートに分割される可能性があります。
434 これは楽節を @code{\score} に付け加え、@c
435 その楽節を他のすべての最上位 @code{\score} や音楽表記とともに@c
437 言い換えると、上記の音楽表記だけを保持しているファイルは@c
456 変数 @code{toplevel-score-handler} を最上位の階層で設定することによって、@c
459 初期化ファイル @file{../scm/lily.scm} で定義されています。
466 2. The first line verse two.
470 マークアップ テキストは、それが出現した場所で、@c
471 score あるいは音楽表記の上、間、あるいは下に描かれます。
473 @cindex variables (変数)
482 使用するには、入力ファイルの中で @code{\foo} と入力します。@c
483 変数の名前はアルファベットだけで構成すべきです。@c
484 数字、アンダスコアあるいはダッシュを使うことができません。
488 以下の例は最上位の階層で入力される可能性がある 3 つのものを示しています:
492 % Don't justify the output
504 ファイルの任意の場所で、以下の編集指示のいずれかが入力される可能性があります:
507 @item @code{\version}
508 @item @code{\include}
509 @item @code{\sourcefilename}
510 @item @code{\sourcefileline}
512 @code{%} 記号で始まる単一行コメント。
515 @code{%@{ .. %@}} で囲まれる複数行コメント。
521 通常、入力の要素間にある空白は無視され、@c
522 可読性を良くするために自由に削除あるいは追加することができます。@c
523 しかしながら、以下の状況ではエラーを避けるために空白を挿入する必要があります:
527 @item コマンドあるいは変数 -- すなわち、@code{\} 記号で始まる要素 -- の後。
528 @item Scheme 表記として解釈される要素
529 -- すなわち、@code{#} 記号で始まる要素 -- の後。
530 @item Scheme 表記要素を区切る空白。
531 @item @code{lyricmode} モードの @code{\override} と @code{\set} コマンドの@c
533 特に、@code{\override Score.LyricText.font-size = #5} のように、@c
534 コマンドの中のドットとイコール記号の前後、コマンド全体の前後に@c
541 @rlearning{How LilyPond input files work}
544 @ref{The \layout block}
549 @translationof Titles and headers
551 ほとんどすべての楽譜にはタイトルと作曲者名が含まれます。@c
552 楽譜の中にはさらに多くの情報を含むものもあります。
555 * タイトル、ヘッダ、フッタを作成する::
556 * カスタム ヘッダ、フッタ、タイトル::
563 @node タイトル、ヘッダ、フッタを作成する
564 @subsection タイトル、ヘッダ、フッタを作成する
565 @translationof Creating titles headers and footers
569 * book と score のタイトル ブロックのデフォルト レイアウト::
570 * ヘッダとフッタのデフォルト レウアウト::
574 @unnumberedsubsubsec タイトル ブロックの説明
575 @translationof Title blocks explained
577 @c TODO: figure out how \bookpart titles work
579 タイトル ブロックには 2 つのタイプがあります:
580 book の最初の @code{\score} の上に表示されるメインのタイトル ブロックと、@c
581 各 @code{\score} ブロック内に表示される個々のタイトル ブロックです。@c
582 両タイプのテキスト フィールドは @code{\header} ブロックを用いて挿入します。
584 book が単一の score しか持たない場合、@c
585 @code{\header} ブロックを配置する場所は @code{\score} ブロックの内側でも@c
588 @warning{@bs{}@code{score} ブロックの内側に @bs{}@code{header} ブロックを@c
590 @bs{}@code{header} ブロックの前に音楽表記を配置する必要があります。}
592 @lilypond[papersize=a5,quote,verbatim,noragged-right]
595 composer = "J. S. Bach."
599 \new Staff \relative g, {
602 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
603 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
611 \new Staff \relative b {
615 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
616 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
624 book のメイン タイトル ブロックのテキスト フィールドはすべての @code{\score}
625 ブロックに表示させることができ、手動で表示を抑制することもできます:
628 @lilypond[papersize=a5,quote,verbatim,noragged-right]
631 print-all-headers = ##t
634 title = "DAS WOHLTEMPERIRTE CLAVIER"
636 % この book では tagline を表示しません
639 \markup { \vspace #1 }
643 \new Staff { \clef "bass" s1 }
646 title = "PRAELUDIUM I"
648 % この score では subtitle を表示しません
655 \new Staff { \clef "bass" s1 }
659 subsubtitle = "A 4 VOCI"
661 % この score では subtitle を表示しません
670 @ref{File structure},
671 @ref{Custom layout for title blocks}
674 @node book と score のタイトル ブロックのデフォルト レイアウト
675 @unnumberedsubsubsec book と score のタイトル ブロックのデフォルト レイアウト
676 @translationof Default layout of book and score title blocks
678 タイトル ブロックのレイアウトとフォーマットは 2 つの @code{\paper}
680 メインの @code{\header} タイトル ブロックのための @code{bookTitleMarkup} と、@c
681 @code{\score} 内部の個々の @code{\header} ブロックのための
682 @code{scoreTitleMarkup} です。
684 以下の例は @code{\header} のすべての変数の使用例です:
687 @lilypond[papersize=a7,quote,verbatim,noragged-right]
691 dedication = "Dedication"
693 subtitle = "Subtitle"
694 subsubtitle = "Subsubtitle"
695 % 以下のフィールドは 1 行に配置されます
696 % フィールド "instrument" は 2 ページ以降にも表示されます
697 instrument = \markup \with-color #green "Instrument"
699 composer = "Composer"
700 % 以下のフィールドは同一行の両端に配置されます
702 arranger = "Arranger"
703 % 以下のフィールドは最下段の中央に配置されます
704 tagline = "tagline goes at the bottom of the last page"
705 copyright = "copyright goes at the bottom of the first page"
710 % 以下のフィールドは同一行の両端に配置されます
718 % 以下のフィールドは同一行の両端に配置されます
719 piece = "Piece 2 on the same page"
727 % 以下のフィールドは同一行の両端に配置されます
728 piece = "Piece 3 on a new page"
742 紙面変数 @code{print-all-headers} に @code{##f} がセットされている場合
743 (デフォルトの設定です)、@code{\score} には @code{piece} と @code{opus}
747 @c Is the bit about \null markups true? -mp
748 @code{\header} ブロックでセットされなかったテキスト フィールドには@c
749 @code{\null} マークアップがセットされ、スペースを無駄にしません。
752 デフォルト設定では、@code{scoreTitleMarkup} は
753 @code{piece} テキスト フィールドと @code{opus} テキスト フィールドを@c
758 デフォルトのレイアウトを変更するには @ref{Custom layout for title blocks}
763 最上位の @code{\header} ブロックのタイトルを最初のページに配置して、@c
764 @code{\score} ブロックで定義される楽譜を次のページから始めるするには、@c
765 @code{\score} ブロックの中にある @code{\header} ブロック内で@c
766 @code{breakbefore} 変数を使用します。
768 @lilypond[papersize=a8landscape,verbatim,noragged-right]
771 title = "This is my Title"
772 subtitle = "This is my Subtitle"
773 copyright = "This is the bottom of the first page"
776 \repeat unfold 4 { e'' e'' e'' e'' }
778 piece = "This is the Music"
787 @rlearning{How LilyPond input files work}
790 @ref{Custom layout for title blocks},
794 @file{ly/titling-init.ly}
797 @node ヘッダとフッタのデフォルト レウアウト
798 @unnumberedsubsubsec ヘッダとフッタのデフォルト レウアウト
799 @translationof Default layout of headers and footers
801 @emph{ヘッダ} と @emph{フッタ} は、book のテキストとは別の、@c
802 ページの最初と最後に表示されるテキスト行です。@c
803 ヘッダとフッタは以下の @code{\paper} 変数によって制御されます:
806 @item @code{oddHeaderMarkup}
807 @item @code{evenHeaderMarkup}
808 @item @code{oddFooterMarkup}
809 @item @code{evenFooterMarkup}
812 これらのマークアップ変数は、最上位の @code{\header} ブロック
813 (これは book のすべての score に適用されます) から、@c
814 テキスト フィールドのみにアクセスすることができ、@c
815 @file{ly/titling-init.ly} で定義されています。@c
821 ページ番号は、2 ページ目から、ページ最上段の左端 (偶数ページの場合)
822 または右端 (奇数ページの場合) に自動的に配置されます。
825 @code{instrument} テキスト フィールドは、2 ページ目から、@c
829 @code{copyright} テキストは最初のページの最下段中央に配置されます。
832 @code{tagline} は最後のページの最下段中央に配置されます。@c
833 1 ページしかない場合は @code{copyright} の下に配置されます。
837 @lilypond[papersize=a8landscape]
847 最上位の @code{\header} ブロックの中に @code{tagline} を追加することで、@c
848 デフォルトのタグラインを変更することができます。
850 @lilypond[papersize=a8landscape,verbatim]
853 tagline = "... music notation for Everyone"
863 タグラインを削除するには、@code{tagline} に @code{##f} をセットします。
866 @node カスタム ヘッダ、フッタ、タイトル
867 @subsection カスタム ヘッダ、フッタ、タイトル
868 @translationof Custom headers footers and titles
870 @c TODO: somewhere put a link to header spacing info
871 @c (you'll have to explain it more in NR 4).
874 * タイトル ブロックのカスタム テキスト フォーマット::
875 * タイトル ブロックのカスタム レイアウト::
876 * ヘッダとフッタのカスタム レイアウト::
879 @node タイトル ブロックのカスタム テキスト フォーマット
880 @unnumberedsubsubsec タイトル ブロックのカスタム テキスト フォーマット
881 @translationof Custom text formatting for title blocks
883 標準の @code{\markup} コマンドを使って @code{\header} ブロックの中にある@c
884 ヘッダ、フッタ、それにタイトル テキストをカスタマイズすることができます。
886 @lilypond[quote,verbatim,noragged-right]
890 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
891 subtitle = \markup { \italic "(Excerpt)" }
898 @ref{Formatting text}
901 @node タイトル ブロックのカスタム レイアウト
902 @unnumberedsubsubsec タイトル ブロックのカスタム レイアウト
903 @translationof Custom layout for title blocks
905 @cindex bookTitleMarkup
906 @cindex scoreTitleMarkup
907 @funindex bookTitleMarkup
908 @funindex scoreTitleMarkup
910 @code{\header} ブロックの中に @code{\markup} コマンドを配置することにより、@c
911 シンプルなテキストをフォーマットすることができます。@c
912 しかしながら、タイトルの配置を精密に制御することはできません。@c
913 テキスト フィールドの配置をカスタマイズするには、以下の @code{\paper}
914 変数のどちらか、あるいは両方を変更します:
917 @item @code{bookTitleMarkup}
918 @item @code{scoreTitleMarkup}
921 これらの @code{\markup} のデフォルト値を用いた場合のタイトルの配置は
922 @ref{Default layout of book and score title blocks} の中にある例で@c
925 @file{ly/titling-init.ly} で定義されている @code{scoreTitleMarkup}
929 scoreTitleMarkup = \markup @{ \column @{
930 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
932 \fromproperty #'header:piece
933 \fromproperty #'header:opus
939 これは、@code{piece} テキスト フィールドと @code{opus} テキスト フィールドを@c
942 @lilypond[quote,verbatim,noragged-right]
946 piece = "PRAELUDIUM I"
952 以下の例では、@code{scoreTitleMarkup} を再定義することにより、@c
953 @code{piece} テキスト フィールドを中央に配置して、フォントを大きく、@c
956 @lilypond[papersize=a5,quote,verbatim,noragged-right]
960 scoreTitleMarkup = \markup {
963 \fontsize #4 \bold \fromproperty #'header:piece
964 \fromproperty #'header:opus
968 \header { tagline = ##f }
972 piece = "PRAELUDIUM I"
979 @code{print-all-headers} を @code{\paper} ブロックの中に配置することにより、@c
980 メイン タイトル ブロックのテキスト フィールドを個々の score タイトル ブロック@c
982 この方法の欠点は、個々の @code{\score} ブロックで、@c
983 最上位の @code{\header} ブロックだけに表示させるテキスト フィールドを@c
985 @ref{Title blocks explained} を参照してください。
987 この欠点を回避するには、個々の @code{\score} ブロックに表示させたい@c
988 テキスト フィールドを @code{scoreTitleMarkup} 定義に追加します。@c
989 以下の例では、@code{composer} テキスト フィールド
990 (通常、これは @code{bookTitleMarkup} に関連付けされています)
991 を @code{scoreTitleMarkup} に追加することにより、@c
992 各 score は異なる作曲者を表示しています:
994 @lilypond[papersize=a5,quote,verbatim,noragged-right]
998 scoreTitleMarkup = \markup {
1001 \fontsize #4 \bold \fromproperty #'header:piece
1002 \fromproperty #'header:composer
1006 \header { tagline = ##f }
1011 composer = "Christian Petzold"
1018 composer = "François Couperin"
1024 あなた自身のカスタム テキスト フィールドを作成して、@c
1025 それをマークアップ定義で参照することもできます。
1027 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1031 scoreTitleMarkup = \markup {
1034 \override #`(direction . ,UP) {
1036 \center-align \fontsize #-1 \bold
1037 \fromproperty #'header:mycustomtext %% User-defined field
1038 \center-align \fontsize #4 \bold
1039 \fromproperty #'header:piece
1042 \fromproperty #'header:opus
1046 \header { tagline = ##f }
1051 mycustomtext = "A 4 VOCI" %% User-defined field
1060 @ref{Title blocks explained}
1063 @node ヘッダとフッタのカスタム レイアウト
1064 @unnumberedsubsubsec ヘッダとフッタのカスタム レイアウト
1065 @translationof Custom layout for headers and footers
1067 @c can make-header and make-footer be removed from
1068 @c paper-defaults-init.ly? -mp
1070 @code{\header} ブロックの中に @code{\markup} コマンドを配置することにより、@c
1071 シンプルなテキストをフォーマットすることができます。@c
1072 しかしながら、ヘッダとフッタの配置を精密に制御することはできません。@c
1073 テキスト フィールドの配置をカスタマイズするために、@c
1074 以下の @code{\paper} 変数のいずれか、あるいはいくつかを使用します:
1077 @item @code{oddHeaderMarkup}
1078 @item @code{evenHeaderMarkup}
1079 @item @code{oddFooterMarkup}
1080 @item @code{evenFooterMarkup}
1083 @cindex markup, conditional (条件付マークアップ)
1084 @cindex on-the-fly (オンザフライ)
1085 @funindex \on-the-fly
1087 @code{\markup} コマンド @code{\on-the-fly} を用いて、@code{\paper}
1088 ブロック内部で定義されたヘッダ テキストとフッタ テキストに条件付でマーク@c
1093 @code{variable} = @code{\markup} @{
1095 @code{\on-the-fly} #@var{procedure} @var{markup}
1100 @var{procedure} は、それを保持している @code{\markdup} コマンドが評価@c
1102 @var{procedure} はある特定の条件をテストして、条件が真である場合にのみ@c
1103 @var{markup} 引数を解釈します (つまり、表示します)。
1105 様々な条件をテストするためのプロシージャがあらかじめ用意されています:
1108 @multitable {print-page-number-check-first-----} {should this page be printed-----}
1110 @headitem Procedure name @tab Condition tested
1112 @item print-page-number-check-first @tab このページ番号は表示されるか?
1113 @item create-page-number-stencil @tab 'print-page-numbers は真か?
1114 @item print-all-headers @tab 'print-all-headers は真か?
1115 @item first-page @tab ブックの最初のページか?
1116 @item (on-page nmbr) @tab ページ番号 = nmbr か?
1117 @item last-page @tab ブックの最後のページか?
1118 @item not-first-page @tab ブックの最初ではないページか?
1119 @item part-first-page @tab ブック パートの最初のページか?
1120 @item part-last-page @tab ブック パートの最後のページか?
1121 @item not-single-page @tab ブック パートのページ数 > 1 か?
1126 以下の例では、ページ番号を各ページの最下段中央に配置しています。@c
1127 まず、@code{oddHeaderMarkup} と @code{evenHeaderMarkup} に
1128 @emph{null} を定義することにより、デフォルト設定を削除します。@c
1129 次に、@code{oddFooterMarkup} に中央に配置されたページ番号を再定義します。@c
1130 最後に、@code{evenFooterMarkup} に @code{oddFooterMarkup} を@c
1131 定義することにより、同じレイアウトにします:
1133 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1136 print-page-number = ##t
1137 print-first-page-number = ##t
1138 oddHeaderMarkup = \markup \null
1139 evenHeaderMarkup = \markup \null
1140 oddFooterMarkup = \markup {
1142 \on-the-fly #print-page-number-check-first
1143 \fromproperty #'page:page-number-string
1146 evenFooterMarkup = \oddFooterMarkup
1149 \new Staff { s1 \break s1 \break s1 }
1154 複数の @code{\on-the-fly} 条件を @q{and} 演算子で組み合わせることが@c
1158 @code{\on-the-fly #first-page}
1159 @code{\on-the-fly #last-page}
1160 @code{@{ \markup ... \fromproperty #'header: ... @}}
1163 これは、出力が単一のページかどうかを判断します。
1167 @ref{Title blocks explained},
1168 @ref{Default layout of book and score title blocks}
1171 @file{../ly/titling-init.ly}
1176 @translationof Creating footnotes
1178 作成できる脚注には 2 つのタイプがあります。@c
1188 @unnumberedsubsubsec 脚注の概要
1189 @translationof Footnotes overview
1191 自動脚注は繰り上がっていくページ番号を作り出し、@c
1192 手動脚注はページ番号をカスタマイズすることができます。@c
1193 通常、脚注は @code{\tweak} のように適用されるので、多くの音楽要素や@c
1194 ポスト-イベントによって作成されるグラフィカル オブジェクト上に直接配置@c
1196 これがうまくいかない場合 (小節線や拍の変更のように、プロパティの変更の結果@c
1197 として作り出されるグラフィカル オブジェクトの場合)、脚注を独立した音楽@c
1198 イベントとして入力することである特定のタイミングにある指定したタイプの@c
1199 すべてのグラフィカルに影響を与えることもできます。
1201 脚注コマンドの完全な形式は以下のようなものです:
1204 \footnote @var{mark} @var{offset} @var{grob-name} @var{footnote}
1212 これは脚注を指定するマークアップや文字列で、参照ポイントとページ下の@c
1214 これは省略することができ (@code{\default} で置き換えられます)、省略した@c
1217 脚注マークを配置する参照ポイントからの X と Y オフセットを指定する
1218 @samp{#(2 . 1)} のような数字のペアです。
1220 脚注マークを付けるグラフィカル オブジェクトのタイプを指定します (例えば
1221 @samp{#'Flag} です)。@c
1222 これが指定された場合、対応するグラフィカル オブジェクトが参照される
1223 @var{music} 自体にあるものでなくても、そこから作成されたものであれば@c
1225 これは省略するができ (@code{\default} で置き換えられます)、その場合は@c
1226 直接作成されたグラフィカル オブジェクトだけに脚注が付けられます。
1228 このマークアップあるいは文字列はページ下の脚注テキストになります。
1230 これは脚注を付ける要素 -- 音楽イベント、和音構成要素、あるいは@c
1232 これを省略することはできませんが、@code{\default} で置き換えることで@c
1233 脚注をある特定の音楽表記ではなく音楽タイミングに付けることができます。@c
1234 @code{\default} を用いた場合、影響を与えるグラフィカル オブジェクトの@c
1235 タイプを指定する @var{grob-name} 引数を指定する必要があります。
1238 @code{\tweak} と同様に、@code{\footnote} をポスト-イベントや@c
1239 アーティキュレーションに適用する場合、それ自体の前に @code{-} を配置@c
1240 して、構文解析の結果を前にある音符や休符にくっつけさせる必要があります。
1244 @unnumberedsubsubsec 自動脚注
1245 @translationof Automatic footnotes
1247 自動脚注は 4 つの引数を取ります: 脚注マークの位置 @samp{(x . y)}、@c
1248 脚注を付ける @var{レイアウト オブジェクト} を指定するオプションの
1249 @var{grob-name}、ページ下の脚注に表示される @var{footnote} マークアップ、@c
1250 それに脚注を付ける @var{music} です。
1253 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1255 \header { tagline = ##f }
1257 \footnote #'(0.5 . -2)
1258 \markup { The first note }
1260 \single\footnote #'(0.5 . 1)
1261 \markup { The third note } Flag
1270 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1272 \header { tagline = ##f }
1275 \footnote #'(1 . -1.25) "これは C です" c
1276 \footnote #'(2 . -0.25) \markup { \italic "E-flat です" } es
1277 \footnote #'(2 . 3) \markup { \bold "これは G です" } g
1284 脚注の垂直方向の位置が同じになる場合、下方向に並べられます。@c
1285 高い位置にある脚注は、リストでも上に来ます。
1288 ここで、グラフィカル オブジェクト動脚注を付ける例をいくつか挙げ、@c
1289 さらに脚注とタグラインやコピーライトとの位置関係を示します。
1292 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1294 \header { copyright = \markup { "Copyright 1970" } }
1296 a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
1297 -\footnote #'(0 . 1.5) \markup { スラー } (
1298 b8)-\footnote #'(0 . -2) \markup { 連桁 } [ e]
1299 \single\footnote #'(1 . -1)
1300 \markup { \teeny { これは符幹です } } Stem
1302 \single\footnote #'(0 . 0.5)
1303 \markup \italic { 忠告の臨時記号 } AccidentalCautionary
1304 \footnote #'(1 . 1) "音符自体"
1305 dis?4-\footnote #'(0.5 . -0.5) \markup \italic { スロー ダウン }
1311 最上位の @code{\markup} に脚注を付ける場合、@c
1312 @code{\auto-footnote} コマンドを使う必要があります:
1314 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1316 \header { tagline = ##f }
1317 \markup { \auto-footnote "A simple tune" \italic "By me" }
1326 @unnumberedsubsubsec 手動脚注
1327 @translationof Manual footnotes
1329 @cindex footnotes, manual (手動の脚注
1331 手動で付ける脚注は追加で最初の引数として参照マークとなる @var{mark} を@c
1333 自動的に生成される脚注マークとは対照的に、ページ下の @var{footnote}
1334 マークアップの前には表示されません: 見た目のつながりはユーザ自身で作成@c
1336 LilyPond は対応するマークアップを同じページの下に表示するだけです。
1338 上記のことを除けば、手動脚注は自動的に付番される脚注と同じです。
1341 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1343 \header { tagline = ##f }
1347 \markup { \italic "1. 最初の音符" }
1351 \markup { \bold "2" } #'(0.5 . 1)
1355 d-\footnote "3" #'(0.5 . -1) "3. ピアノ" \p
1360 和音に手動脚注を付ける場合、以下のようにします:
1363 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1365 \header { tagline = ##f }
1368 \footnote "1" #'(1 . -1.25) "1. C" c
1370 \markup { \bold "b" } #'(2 . -0.25) "b. E-フラット" es
1371 \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
1378 脚注の垂直方向の位置が同じになる場合、下方向に並べられます。@c
1379 高い位置にある脚注は、リストでも上に来ます。
1382 ここで、グラフィカル オブジェクトに手動脚注を付ける例をいくつか挙げ、@c
1383 脚注とタグラインやコピーライトとの位置関係を示します。
1386 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1388 \header { tagline = ##f }
1391 \markup { \teeny 1 } #'(-3 . 0)
1392 \markup { 1. \bold フォルテ } \f
1394 \markup { \teeny b } #'(0 . 1.5)
1395 \markup { b. スラー } (
1397 \markup { \teeny 3 } #'(0 . -2)
1401 \markup { 4 } #'(1 . -1)
1402 \markup { \bold 4. { これは符幹です } } Stem
1405 \markup \concat \teeny { "sharp (v)" }
1407 \markup \italic { v. 忠告の臨時記号 } AccidentalCautionary
1409 \markup \concat \teeny { "a" } #'(0.5 . -0.5)
1410 \markup \italic { a. スローダウン } _"rit."
1412 \markup { \teeny \musicglyph #"rests.4" }
1414 \markup { \null } \breathe
1419 最上位の @code{\markup} に脚注を付ける場合、下記のようにします:
1421 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1423 \header { tagline = ##f }
1424 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1433 @rlearning{Objects and interfaces}
1440 @ref{Titles and headers}
1443 @rinternals{FootnoteEvent},
1444 @rinternals{FootnoteItem},
1445 @rinternals{FootnoteSpanner},
1446 @rinternals{Footnote_engraver}
1449 同じページにある複数の脚注は上下にしか配置できません。@c
1450 ある脚注が他の脚注の上に配置され、同じ行に配置することはできません。@c
1451 @code{MultiMeasureRests} に脚注を付けることはできず、@c
1452 @code{Staff}、@code{\markup} オブジェクト、それに他の @code{footnote} と@c
1454 手動の @code{footnote} コマンドを使う場合、@c
1455 containing @code{footnote-auto-number = ##f} を保持している
1456 @code{\paper} ブロックが必要です。
1461 @subsection カスタム タイトル
1462 @translationof Custom titles
1465 @code{\paper} ブロックの中にある以下の変数の定義を変更することができます。@c
1466 初期化ファイル @file{../ly/titling-init.ly} が@c
1467 デフォルトのレイアウトの設定リストです。
1470 @funindex bookTitleMarkup
1471 @item bookTitleMarkup
1472 これは出力ドキュメントの先頭に付け加えられるタイトルです。@c
1473 通常、ここには作品の作曲者名とタイトルが含まれます。
1475 @funindex scoreTitleMarkup
1476 @item scoreTitleMarkup
1477 これは @code{\score} ブロックの上に配置されるタイトルです。@c
1478 通常、ここには楽章の名前 (@code{piece} フィールド) が含まれます。
1480 @funindex oddHeaderMarkup
1481 @item oddHeaderMarkup
1484 @funindex evenHeaderMarkup
1485 @item evenHeaderMarkup
1487 これが指定されていない場合は、奇数番号ページのヘッダが代わりに使用されます。
1489 デフォルトのヘッダ定義は、ページ番号は端に配置し、@c
1490 楽器名は中央に配置するようになっています。
1492 @funindex oddFooterMarkup
1493 @item oddFooterMarkup
1496 @funindex evenFooterMarkup
1497 @item evenFooterMarkup
1499 これが指定されていない場合は、偶数番号ページのフッタが代わりに使用されます。
1501 デフォルトでは、最初のページのフッタには著作権についての注意書きが含まれ、@c
1502 最後のページのフッタにはタグ行が含まれます。
1507 @cindex header (ヘッダ)
1508 @cindex footer (フッタ)
1509 @cindex page layout (ページ レイアウト)
1510 @cindex titles (タイトル)
1512 以下の定義では、タイトルはページの左側に配置され、@c
1517 bookTitleMarkup = \markup {
1519 \fromproperty #'header:title
1520 \fromproperty #'header:composer
1528 @subsection ページ番号の参照
1529 @translationof Reference to page numbers
1531 @code{\label} コマンドを用いて、楽譜のある特定の場所
1534 このラベルをマークアップの中で参照することできます。@c
1535 ラベルを付けられた場所のページ番号を取得するには、@c
1536 @code{\page-ref} マークアップ コマンドを使います。
1538 @lilypond[verbatim,papersize=a8landscape]
1539 \header { tagline = ##f }
1545 \pageBreak \mark A \label #'markA
1549 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1550 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1554 @code{\page-ref} マークアップ コマンドは 3 つの引数をとります:
1557 これは Scheme シンボルです -- 例: @code{#'firstScore}。
1559 これはマークアップの大きさを推定するためのゲージです。
1561 これは、ラベルが不明な場合にページ番号として用いられます。
1565 マークアップが解釈されているときに改ページはまだ行われておらず、@c
1566 ページ番号はまだわからないからです。@c
1568 実際のマークアップ解釈はもっと後に延期されます。@c
1569 しかしながら、マークアップの大きさは事前に判明している必要があるため、@c
1570 ゲージを使ってマークアップの大きさを決定します。@c
1571 book のページ数が 10 から 99 までの範囲であるのなら、ゲージを "00"
1572 -- つまり、2 桁の数 -- にします。
1585 @translationof Table of contents
1587 目次は @code{\markuplist \table-of-contents} コマンドを用いて挿入します。@c
1588 目次に表示すべき要素は @code{\tocItem} コマンドで挿入されます
1589 -- このコマンドは最上位あるいは音楽表記の内部で使用します。
1592 \markuplist \table-of-contents
1595 \tocItem \markup "First score"
1599 \tocItem \markup "Some particular point in the first score"
1604 \tocItem \markup "Second score"
1612 目次を構成するために使用するマークアップは
1613 @code{\paper} ブロックの中で定義します。@c
1615 目次のタイトルを構成する @code{tocTitleMarkup} と、@c
1616 目次の要素 -- 要素のタイトルとページ番号 -- を構成する
1617 @code{tocItemMarkup} です。@c
1618 これらの変数はユーザによって変更することができます:
1623 %% 目次タイトルをフランス語に翻訳します:
1624 tocTitleMarkup = \markup \huge \column {
1625 \fill-line { \null "Table des matières" \null }
1628 %% より大きなフォント サイズを使用します
1629 tocItemMarkup = \markup \large \fill-line {
1630 \fromproperty #'toc:text \fromproperty #'toc:page
1635 @code{tocItemMarkup} 定義の中で目次要素のテキストとページ番号を@c
1638 より手の込んだ目次を構築するために新しいコマンドとマークアップを@c
1641 @item まず、@code{\paper} ブロックの中で新しいマークアップ変数を定義します
1642 @item それから、このマークアップ変数を用いて、@c
1643 目次要素を付け加えるための音楽関数を定義します。
1647 オペラの目次の中で幕の名前を挿入するために新しい様式を定義しています:
1651 tocActMarkup = \markup \large \column {
1653 \fill-line { \null \italic \fromproperty #'toc:text \null }
1659 #(define-music-function (parser location text) (markup?)
1660 (add-toc-item! 'tocActMarkup text))
1663 @lilypond[line-width=10.0\cm]
1664 \header { tagline = ##f }
1666 tocActMarkup = \markup \large \column {
1668 \fill-line { \null \italic \fromproperty #'toc:text \null }
1674 #(define-music-function (parser location text) (markup?)
1675 (add-toc-item! 'tocActMarkup text))
1678 \markuplist \table-of-contents
1679 \tocAct \markup { Atto Primo }
1680 \tocItem \markup { Coro. Viva il nostro Alcide }
1681 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1682 \tocAct \markup { Atto Secondo }
1683 \tocItem \markup { Sinfonia }
1684 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1689 要素とページ番号の間をドットで埋めることができます:
1691 @lilypond[verbatim,line-width=10.0\cm]
1692 \header { tagline = ##f }
1694 tocItemMarkup = \tocItemWithDotsMarkup
1698 \markuplist \table-of-contents
1699 \tocItem \markup { Allegro }
1700 \tocItem \markup { Largo }
1707 @file{ly/toc-init.ly}
1710 @funindex \table-of-contents
1711 @code{\table-of-contents},
1718 @section 入力ファイルに取り組む
1719 @translationof Working with input files
1722 * LilyPond ファイルをインクルードする::
1723 * 1 つのソースから異なる版を生成する::
1728 @node LilyPond ファイルをインクルードする
1729 @subsection LilyPond ファイルをインクルードする
1730 @translationof Including LilyPond files
1733 @cindex including files (ファイルをインクルードする)
1735 大きなプロジェクトは別々のファイルに分割することができます。@c
1736 他のファイルを参照するには、以下のようにします:
1739 \include "otherfile.ly"
1742 @code{\include "otherfile.ly"} という行は、@c
1743 @file{otherfile.ly} の内容をカレント ファイルの @code{\include}
1744 がある場所に貼り付けるのと等価です。@c
1745 例えば、大きなプロジェクトでは、個々の楽器パートを別々のファイルで記述し、@c
1746 個々の楽器ファイルをまとめる @qq{総譜} ファイルを作成することができます。@c
1747 通常、インクルードされるファイルはいくつかの変数を定義し、@c
1748 それらの変数は総譜ファイルの中で使用されます。@c
1749 インクルードされるファイルの中でタグ付きセクションにマークを付けて、@c
1750 それを楽譜の他の場所で使うことができます
1751 -- @ref{Different editions from one source} を参照してください。
1753 カレントのワーキング ディレクトリの中にあるファイルは
1754 @code{\include} コマンドに後にファイル名を指定するだけで@c
1756 他の場所にあるファイルはフル パス参照か相対パス参照
1757 (ディレクトリ区切りとして、UNIX ではスラッシュ / を使用しますが、@c
1758 DOS/Windows ではバックスラッシュ \ を使用します) によって@c
1760 例えば、@file{stuff.ly} がカレントのワーキング ディレクトリよりも
1761 1 つ上のディレクトリの中にある場合、以下のようにインクルードします:
1764 \include "../stuff.ly"
1768 あるいは、インクルードされるオーケストラのすべてのパート ファイルが、@c
1769 カレント ディレクトリ内部の @file{parts} というサブディレクトリの中に@c
1770 配置されている場合、以下のようにインクルードします:
1773 \include "parts/VI.ly"
1774 \include "parts/VII.ly"
1778 インクルードされるファイルも @code{\include} 文を持つことができます。@c
1779 それら第 2 レベルの @code{\include} 文はそのファイルがメイン ファイルに@c
1781 そのため、第 2 レベルの @code{\include} 文で指定するファイル名は@c
1782 すべてメイン ファイルを保持しているディレクトリからの相対参照で@c
1784 -- インクルード ファイルを保持しているディレクトリからではありません。@c
1785 しかしながら、この振る舞いは、オプション @option{-drelative-includes} を@c
1788 @code{#(ly:set-option 'relative-includes #t)} を付け加えることによって)
1790 @code{relative-includes} をセットすることで、@c
1791 各 @code{\include} コマンドのパスは@c
1792 そのコマンドを保持しているファイルからの相対参照になります。@c
1793 この振る舞いを使用することが推奨されていて、@c
1794 lilypond の将来のバージョンではこの振る舞いがデフォルトになります。
1796 コマンド ラインから LilyPond を呼び出すときにオプションとして指定した@c
1797 サーチ パスに含まれるディレクトリから@c
1798 ファイルをインクルードすることもできます。@c
1800 インクルードされるファイルはファイル名だけで指定されます。@c
1801 例えば、サーチ パスで指定する @file{parts} というサブディレクトリの中にある@c
1802 ファイルをインクルードする @file{main.ly} をコンパイルするには、@c
1803 @file{main.ly} を保持しているディレクトリに cd して、以下を入力します:
1806 lilypond --include=parts main.ly
1809 @file{main.ly} の中には以下を記述しておきます:
1817 いくつもの楽譜でインクルードされるファイルは
1818 LilyPond ディレクトリ @file{../ly} の中に置くことになるかもしれません
1819 (このディレクトリが存在する場所はインストールの仕方に依存します
1820 -- @rlearning{Other sources of information} を参照してください)。@c
1821 このディレクトリの中にあるファイルは、@code{\include} 文で@c
1822 ファイル名を指定するだけでインクルードすることができます。@c
1823 この方法で @file{english.ly} のような言語依存のファイルを@c
1826 LilyPond は、実行開始時に、デフォルトで@c
1827 いくつかのファイルをインクルードします。@c
1828 このインクルードはユーザには明らかにされませんが、@c
1829 コマンド ラインから @code{lilypond --verbose} を実行することによって@c
1830 インクルードされるファイルを明らかにすることができます。@c
1831 @code{--verbose} オプションは、他の多くの情報とともに、@c
1832 LilyPond が使用するパスとファイルのリストを表示します。@c
1833 また、デフォルトでインクルードされるファイルのうち、@c
1834 より重要なファイルについて @rlearning{Other sources of information}
1836 これらのファイルを編集することができますが、@c
1838 新しいバージョンの LilyPond をインストールすると失われます。
1840 @code{\include} を使用している簡単な例がいくつか
1841 @rlearning{Scores and parts} で示されています。
1846 @rlearning{Other sources of information},
1847 @rlearning{Scores and parts}
1852 インクルードされるファイルに LilyPond のインストール ファイルと同じ名前が@c
1853 与えられている場合、LilyPond のインストール ファイルが優先されます。
1857 @node 1 つのソースから異なる版を生成する
1858 @subsection 1 つのソースから異なる版を生成する
1859 @translationof Different editions from one source
1861 同じ音楽ソースから異なるバージョンの楽譜を容易に生成できるようにするために、@c
1863 長い音楽や注記のセクションをさまざまなやり方で組み合わせる場合には、@c
1864 おそらく変数が最も役に立つでしょう。@c
1865 差し替え用の短い音楽セクションの中から 1 つを選択する場合にはタグが役に立ち、@c
1866 楽曲の一部をいろいろな箇所で組み合わせることもできます。
1868 どのような方法をとるにしても、楽譜構造から音楽表記を分離しておくと、@c
1869 音楽表記に手を触れずに楽譜構造を変更することが簡単に行えます。
1878 @unnumberedsubsubsec 変数を使用する
1879 @translationof Using variables
1881 @cindex variables, use of (変数を使用する)
1883 音楽のセクションが変数の中で定義されている場合、@c
1884 そのセクションを楽譜の異なる部分で再利用することができます
1885 -- @rlearning{Organizing pieces with variables} を参照してください。@c
1886 例えば、@notation{アカペラ} のボーカル譜はリハーサル目的で@c
1887 すべてのパートをまとめたピアノ譜を持つことがよくあります。@c
1889 その場合、音楽を入力する必要があるのは 1 回だけです。@c
1890 2 つの変数からの音楽を 1 つの譜に組み込むことができます
1891 -- @ref{Automatic part combining} を参照してください。@c
1894 @lilypond[verbatim,quote]
1895 sopranoMusic = \relative c'' { a4 b c b8( a) }
1896 altoMusic = \relative g' { e4 e e f }
1897 tenorMusic = \relative c' { c4 b e d8( c) }
1898 bassMusic = \relative c' { a4 gis a d, }
1899 allLyrics = \lyricmode {King of glo -- ry }
1901 \new Staff = "Soprano" \sopranoMusic
1902 \new Lyrics \allLyrics
1903 \new Staff = "Alto" \altoMusic
1904 \new Lyrics \allLyrics
1905 \new Staff = "Tenor" {
1909 \new Lyrics \allLyrics
1910 \new Staff = "Bass" {
1914 \new Lyrics \allLyrics
1917 \set Staff.printPartCombineTexts = ##f
1923 \set Staff.printPartCombineTexts = ##f
1933 音楽表記には変更を加えずに、楽譜構造の文を変えるだけで、@c
1934 ボーカル パートだけあるいはピアノ パートだけの楽譜を作り出すことができます。
1936 長い楽譜では、変数定義をそれぞれ別々のファイルの中に置いて、@c
1937 それらのファイルをインクルードすることになるかもしれません
1938 -- @ref{Including LilyPond files} を参照してください。
1941 @unnumberedsubsubsec タグを使用する
1942 @translationof Using tags
1945 @funindex \keepWithTag
1946 @funindex \removeWithTag
1947 @funindex \pushToTag
1948 @funindex \appendToTag
1950 @cindex keep tagged music (タグの付いた音楽を保持する)
1951 @cindex remove tagged music (タグの付いた音楽を排除する)
1952 @cindex splice into tagged music (タグの付いた音楽を組み合わせる)
1954 @code{\tag #'@var{partA}} コマンドは音楽表記に
1955 @var{partA} という名前を付けます。@c
1956 この方法でタグを付けられた表記は、後で @code{\keepWithTag #'@var{name}} と
1957 @code{\removeWithTag #'@var{name}} のどちらかを用いて、@c
1958 名前によって選択あるいは排除することができます。@c
1959 タグの付いた音楽にそのようなフィルタを適用した結果は以下のようになります:
1961 @multitable @columnfractions .5 .5
1965 @code{\keepWithTag #'@var{name}} が前に付くタグ付きの音楽
1966 @tab タグの付いていない音楽と @var{name} というタグの付いた音楽が@c
1968 他のタグ名を持つタグ付き音楽は排除されます。
1970 @code{\removeWithTag #'@var{name}} が前に付くタグ付きの音楽
1971 @tab タグの付いていない音楽と @var{name} 以外のタグを持つ音楽が@c
1973 @var{name} というタグの付いた音楽は排除されます。
1975 @code{\keepWithTag} と @code{\removeWithTag} のどちらも@c
1977 @tab タグの付いた音楽とタグの付いていない音楽すべてがインクルードされます。
1980 @code{\tag}、@code{\keepWithTag} それに @code{\removeWithTag} コマンドの引数は@c
1981 シンボル (@code{#'score} や @code{#'part} など) とその後に続けて@c
1984 以下の例では、楽曲を 2 つのバージョンで示しています。@c
1985 1 つはトリルを通常の記譜法で示していて、@c
1986 もう 1 つはトリルを明示的に展開しています:
1988 @lilypond[verbatim,quote]
1989 music = \relative g' {
1991 \tag #'trills {d8.\trill }
1992 \tag #'expand {\repeat unfold 3 {e32 d} }
1997 \keepWithTag #'trills \music
2000 \keepWithTag #'expand \music
2005 @code{\keepWithTag} を使う代わりに、@c
2006 音楽セクションを排除する方が楽な場合もあります:
2008 @lilypond[verbatim,quote]
2009 music = \relative g' {
2011 \tag #'trills {d8.\trill }
2012 \tag #'expand {\repeat unfold 3 {e32 d} }
2017 \removeWithTag #'expand
2021 \removeWithTag #'trills
2026 タグ フィルタリングはアーティキュレーション、テキストなどにも@c
2028 フィルタリングを行うにはアーティキュレーションの前に
2031 -\tag #'@var{your-tag}
2035 例えば、以下は条件付の運指指示を持つ音符と条件付注記を持つ音符を定義しています:
2039 c1-\tag #'warn ^"Watch!"
2042 複数の @code{\tag} エントリで、表記に複数のタグを付ける場合もあります:
2044 @lilypond[quote,verbatim]
2045 music = \relative c'' {
2046 \tag #'a \tag #'both { a4 a a a }
2047 \tag #'b \tag #'both { b4 b b b }
2050 \keepWithTag #'a \music
2051 \keepWithTag #'b \music
2052 \keepWithTag #'both \music
2056 単一の音楽表記に複数の @code{\removeWithTag} フィルタを適用することによって、@c
2057 いくつかの異なる名前のタグが付いたセクションを排除することができます:
2059 @lilypond[verbatim,quote]
2060 music = \relative c'' {
2061 \tag #'A { a4 a a a }
2062 \tag #'B { b4 b b b }
2063 \tag #'C { c4 c c c }
2064 \tag #'D { d4 d d d }
2073 単一の音楽表記に複数の @code{\keepWithTag} フィルタを適用すると、@c
2074 タグ付きセクションは @emph{すべて} 排除されます。@c
2075 なぜなら、最初のフィルタはあるタグ名以外を持つセクションを排除し、@c
2076 2 番目のフィルタがそのタグ名を持つセクションを排除するからです。
2078 既存の音楽表記のある特定の場所にいくつか音を組み込みたいことがあります。@c
2079 @code{\pushToTag} と @code{\appendToTag} を使って、@c
2080 既存の音楽構造の @code{要素} の前または後に素材を追加することができます。@c
2081 すべての音楽構造が @code{要素} を持つわけではありませんが、@c
2082 連続するか同時進行する音楽構造はまず間違いなく @code{要素} を持ちます:
2084 @lilypond[verbatim,quote]
2085 test = { \tag #'here { \tag #'here <<c''>> } }
2088 \pushToTag #'here c'
2089 \pushToTag #'here e'
2090 \pushToTag #'here g' \test
2091 \appendToTag #'here c'
2092 \appendToTag #'here e'
2093 \appendToTag #'here g' \test
2097 どちらのコマンドもタグ、組み込む素材、それにタグ付けされた音楽表記を
2098 取り、タグが出現するたびに素材を組み込みます。@c
2099 これらのコマンドは変更するものを全てコピーするので、@c
2100 オリジナルの @code{\test} が元の意味を保持し続けることを保証します。
2104 @rlearning{Organizing pieces with variables}
2107 @ref{Automatic part combining},
2108 @ref{Including LilyPond files}
2111 @c This warning is more general than this placement implies.
2112 @c Rests are not merged whether or not they come from tagged sections.
2113 @c Should be deleted? -td
2116 Multiple rests are not merged if you create a score with more
2117 than one tagged section at the same place.
2119 複数のタグ付きセクションからを生成した場合、@c
2120 同じ場所にある複数の休符はマージされません。
2126 @unnumberedsubsubsec グローバル設定を使用する
2127 @translationof Using global settings
2129 @cindex include-settings
2131 別のファイルからグローバル設定をインクルードすることができます:
2134 lilypond -dinclude-settings=MY_SETTINGS.ly MY_SCORE.ly
2137 ページ サイズ、フォント、書体などのような設定のグループを別々のファイルに@c
2139 こうすることにより、適当な設定ファイルを指定するだけで、@c
2140 同じ楽譜から異なる版を作り出すことができます。
2142 このテクニックはスタイル シートでも使えます。@c
2143 @rlearning{Style sheets} を参照してください。
2147 @rlearning{Organizing pieces with variables},
2148 @rlearning{Style sheets}
2151 @ref{Including LilyPond files}
2156 @translationof Special characters
2158 @cindex special characters (特殊文字)
2159 @cindex non-ASCII characters (非 ASCII 文字)
2169 @unnumberedsubsubsec テキスト エンコーディング
2170 @translationof Text encoding
2174 LilyPond は Unicode 協会と ISO/IEC 10646 によって定義された@c
2176 この文字レパートリは、ほとんどすべての現代言語と他の多くの言語で@c
2177 使用される文字セットに対して、固有の名前とコード位置を定義しています。@c
2178 Unicode はいくつかの異なるエンコーディングを用いて実装することができます。@c
2179 LilyPond は UTF-8 エンコーディング
2180 (UTF は Unicode Transformation Format を意味します) を使用します
2181 -- UTF-8 はすべての共通ラテン文字を 1 バイトで表し、@c
2182 他の文字を可変バイト長形式 (最大 4 ビット) で表します。
2184 文字の実際の見た目は利用可能なある特定のフォントの中にあるグリフ (図柄)
2186 -- フォントはグリフを指す Unicode コードのサブセット (部分集合) の写像を@c
2188 LilyPond は多言語テキストを、Pango ライブラリを用いて、@c
2191 Lilypond は入力のエンコーディング変換をまったく行いません。@c
2192 これは非 ASCII 文字を含むすべてのテキスト
2193 -- タイトル、歌詞テキストあるいは演奏指示 --
2194 を UTF-8 でエンコードして入力する必要があるということを意味します。@c
2195 そのようなテキストを入力する最も容易な方法は Unicode を認識するエディタを@c
2196 用いて、ファイルを UTF-8 で保存することです。@c
2197 人気のある現代的なエディタのほとんどが UTF-8 をサポートします
2198 -- 例えば、vim, Emacs, jEdit, GEdit です。@c
2199 NT より後の MS Windows システムはすべて@c
2200 ネイティブ キャラクタ エンコーディングとして Unicode を使用します。@c
2201 そのため、Notepad でさえ UTF-8 フォーマットのファイルを@c
2203 Windows 用のもっと機能的なエディタに BabelPad があります。
2205 非 ASCII 文字を保持している LilyPond 入力ファイルが UTF-8 フォーマットで@c
2206 保存されていない場合、エラー メッセージ
2209 FT_Get_Glyph_Name () error: invalid argument
2214 ここでキリル文字、ヘブライ文字、ポルトガル語のテキストを表示する例を挙げます:
2218 %c No verbatim here as the code does not display correctly in PDF
2220 bulgarian = \lyricmode {
2221 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2225 hebrew = \lyricmode {
2226 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2230 portuguese = \lyricmode {
2231 à vo -- cê uma can -- ção legal
2237 \addlyrics { \bulgarian }
2238 \addlyrics { \hebrew }
2239 \addlyrics { \portuguese }
2244 @unnumberedsubsubsec Unicode
2245 @translationof Unicode
2247 @cindex Unicode (ユニコード)
2249 単一の文字 -- その文字に対する Unicode コード ポイントを知っているが、@c
2250 使用しているエディタではその文字を使用できない -- を入力するには、@c
2251 @code{\markup} ブロック内部で @code{\char ##xhhhh} あるいは
2252 @code{\char ##dddd} を使用します
2253 -- ここで @code{hhhh} はその文字に対する 16 進コードであり、@c
2254 @code{dddd} はそれに対応する 10 進数値です。@c
2255 先頭の 0 は省略可能ですが、16 進表記では 4 文字で指定する方法が一般的です。@c
2256 (@code{\char} の後に UTF-8 エンコーディングのコード ポイントを使うべきでは@c
2258 なぜなら、UTF-8 エンコーディングはバイト数を表すための余分なビットを@c
2260 任意の文字に対する 16 進のコード ポイントを調べるための、@c
2261 Unicode コード表と文字名インデックスは Unicode コンソーシアム Web サイト
2262 @uref{http://www.unicode.org/} にあります。
2265 例えば、@code{\char ##x03BE} と @code{\char #958} はどちらも
2266 Unicode U+03BE の文字を入力します
2267 -- この文字は Unicode 名 @qq{Greek Small Letter Xi}
2270 この方法で任意の Unicode コード ポイントを入力することができます。@c
2271 すべての特殊文字がこの方法で入力されている場合、@c
2272 入力ファイルを UTF-8 フォーマットで保存する必要はありません。@c
2273 もちろん、入力された文字を保持しているフォントがすべて@c
2274 インストールされていて、LilyPond で利用可能になっている必要があります。
2276 以下の例は UTF-8 コード化された文字を 4 箇所
2277 -- リハーサル記号の中、アーティキュレーション テキストとして、歌詞の中、@c
2278 楽譜の下にある独立したテキストの中 --
2281 @lilypond[quote,verbatim]
2284 c1 \mark \markup { \char ##x03EE }
2285 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2287 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2289 \markup { "Copyright 2008--2012" \char ##x00A9 }
2292 @cindex copyright sign (著作権記号)
2294 著作権についての注意書きの中で著作権記号を入力するには、以下のようにします:
2298 copyright = \markup @{ \char ##x00A9 "2008" @}
2304 @unnumberedsubsubsec ASCII エイリアス
2305 @translationof ASCII aliases
2307 特殊文字の ASCII エイリアスのリストを含めることができます:
2310 @lilypond[quote,verbatim]
2312 #(include-special-characters)
2315 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2318 \new Staff { \repeat unfold 9 a'4 }
2320 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2325 "特殊文字への置換を無効にすることができます:"
2326 "– &OE; …"
2327 \override #'(replacement-alist . ()) "– &OE; …"
2331 また、エイリアスを作ることもできます。@c
2334 @lilypond[quote,verbatim]
2336 #(add-text-replacements!
2337 '(("100" . "hundred")
2338 ("dpi" . "dots per inch")))
2340 \markup "A 100 dpi."
2345 @lilypond[quote,verbatim]
2346 \markup \replace #'(("100" . "hundred")
2347 ("dpi" . "dots per inch")) "A 100 dpi."
2352 @ref{List of special characters}
2355 @file{ly/text-replacements.ly}
2360 @translationof Controlling output
2370 @subsection 音楽の断片を抽出する
2371 @translationof Extracting fragments of music
2373 大きな楽譜の中の小さな範囲を、出力から直接引用することができます。@c
2374 これは紙の楽譜の一部をはさみで切り抜くことに相当します。
2376 これは切り抜く小節を定義することによって実行されます。@c
2385 (make-rhythmic-location 5 1 2)
2386 (make-rhythmic-location 7 3 4)))
2391 第 5 小節の中間から第 7 小節までを抽出します。@c
2392 @code{5 1 2} は第 5 小節の先頭から 1/2 音符の位置を意味し、@c
2393 @code{7 3 4} は第 7 小節の先頭から 4 分音符 3 つ分の位置を意味します。
2395 リズムによる位置のペアをリストに追加することによって、@c
2396 更に多くの切り抜き範囲を定義することができます。
2399 LilyPond を @option{-dclip-systems} を付けて呼び出す必要があります。@c
2400 切り抜きは EPS ファイルとして出力され、@c
2401 更にフォーマットが指定されている場合には PDF や PNG に変換されます。
2403 出力フォーマットについての更なる情報は、@c
2404 @rprogram{lilypond を呼び出す} を参照してください。
2406 @node 校正済みの音楽をスキップする
2407 @subsection 校正済みの音楽をスキップする
2408 @translationof Skipping corrected music
2410 @funindex skipTypesetting
2411 @funindex showFirstLength
2412 @funindex showLastLength
2414 音楽を入力あるいはコピーしているとき、@c
2415 閲覧、校正する必要があるのは、たいてい終わり近くの音楽
2416 (そこに音符を追加している場所) だけです。@c
2418 最後の数小節以外の譜刻をスキップすることができます。@c
2419 これはソース ファイルの中に以下を置くことによって実現できます:
2422 showLastLength = R1*5
2427 これは入力ファイルの中にあるそれぞれの @code{\score} の最後の 5 小節だけを@c
2428 描画します (4/4 拍子と仮定して)。@c
2429 長い楽曲の場合、小さな部分だけを描画するのにかかる時間は@c
2430 楽曲をすべて描画するのにかかる時間よりも非常に短くなります。@c
2431 すでに譜刻済みの楽譜の開始部分に取り掛かる (例えば、新しいパートを追加する)
2432 ときには、@code{showFirstLength} プロパティも役に立つかもしれません。
2434 楽譜の中のいくつかのパートをスキップは、プロパティ @code{Score.skipTypesetting}
2435 を用いたより細かなやり方で制御することができます。@c
2436 このプロパティがセットされていると、譜刻はまったく行われません。
2438 このプロパティは MIDI ファイルへの出力を制御するためにも用いられます。@c
2439 このプロパティはすべてのイベント -- テンポの変更や楽器の変更を含む -- を@c
2440 スキップするということに注意してください。@c
2443 @lilypond[quote,relative=2,ragged-right,verbatim]
2445 \set Score.skipTypesetting = ##t
2447 \set Score.skipTypesetting = ##f
2451 多声の音楽では、@code{Score.skipTypesetting} はすべてのボイスと譜に@c
2452 影響を与えて、より多くの時間を節約します。
2456 @subsection 他の出力フォーマット
2457 @translationof Alternative output formats
2459 @cindex scalable vector graphics output (SVG 出力)
2460 @cindex SVG output (SVG 出力)
2461 @cindex encapsulated postscript output (EPS 出力)
2462 @cindex EPS output (EPS 出力)
2464 譜刻される楽譜のデフォルト出力フォーマットは、@c
2465 Portable Document Format (PDF) と PostScript (PS) です。@c
2466 コマンド ライン オプションを指定することにより、@c
2467 Scalable Vector Graphics (SVG), Encapsulated PostScript (EPS) それに
2468 Portable Network Graphics (PNG) 出力フォーマットが利用可能です。@c
2469 @rprogram{Basic command line options for LilyPond} を参照してください。
2473 @subsection 記譜フォントを置換する
2474 @translationof Replacing the notation font
2476 LilyPond で使用される Feta フォントの代わりに Gonville に使うことができます。@c
2477 Gonville は以下からダウンロードできます:
2479 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2484 @c NOTE: these images are a bit big, but that's important
2485 @c for the font comparison. -gp
2486 @sourceimage{Gonville_after,,,}
2488 LilyPond の Feta フォントのサンプル小節です:
2490 @sourceimage{Gonville_before,,,}
2492 @subsubheading MacOS でのインストール手順
2494 ZIP ファイルをダウンロードして、伸張します。@c
2495 @code{lilyfonts} ディレクトリを @file{@var{SHARE_DIR}/lilypond/current} に@c
2497 -- 更なる情報は、@rlearning{Other sources of information} を参照してください。@c
2498 既存の @code{fonts} ディレクトリを @code{fonts_orig} にリネームして、@c
2499 @code{lilyfonts} ディレクトリを @code{fonts} にリネームします。@c
2500 Feta フォントに戻すには、@code{fonts_orig} を @code{fonts} に戻します。
2504 @rlearning{Other sources of information}
2507 Gonville では @q{古代の音楽} を記譜することはできません。@c
2508 Gonville フォント ファミリーでは、@c
2509 これからリリースされる LilyPond の新しい図柄は提供されないかもしれません。@c
2510 ライセンス条件等を含む Gonville の更なる情報は、@c
2511 製作者の Web サイトを参照してください。
2516 @translationof MIDI output
2518 @cindex Sound (サウンド)
2521 MIDI (Musical Instrument Digital Interface) はデジタル楽器接続 / 制御の@c
2523 MIDI ファイルはいくつかのトラックの中にある音符の連なりです。@c
2524 MIDI ファイルは実際はサウンド ファイルではありません。@c
2525 音符の連なりと実際のサウンドの翻訳を行うには専用のソフトウェアが必要になります。
2527 LilyPond で記述した音楽は MIDI ファイルに変換することができ、@c
2528 入力されたものを聴くことができます。@c
2529 これは音楽をチェックするのに便利です。オクターブの外れや臨時記号の付け間違いは
2530 MIDI 出力を聴いたときに際立ちます。
2532 標準 MIDI 出力には粗雑さがあります。@c
2533 オプションで @ref{The Articulate script} を用いることにより、@c
2534 強化されたリアルな MIDI 出力を得ることができます。
2536 MIDI 出力は譜毎に 1 つのチャンネルを割り当て、@c
2537 ドラムのためにチャンネル 10 を予約します。@c
2538 デバイス 1 つにつき MIDI チャンネルは 16 しかないため、@c
2539 楽譜が 16 以上の譜を保持している場合、MIDI チャンネルは再利用されます。
2544 * 何が MIDI に出力されるのか?::
2546 * MIDI での音の強弱を制御する::
2551 @node MIDI ファイルを作り出す
2552 @subsection MIDI ファイルを作り出す
2553 @translationof Creating MIDI files
2555 LilyPond 入力ファイルから MIDI ファイルを作り出すには、@c
2556 score に @code{\midi} ブロックを付け加えます。@c
2566 @code{\layout} ブロックを持たない @code{\score} の中に
2567 @code{\midi} ブロックがある場合、MIDI 出力だけが生成されます。@c
2568 楽譜も必要な場合は、@code{\layout} ブロックも存在している必要があります。
2578 ピッチ、リズム、タイ、強弱記号、テンポの変更は解釈されて@c
2579 正確に MIDI 出力に翻訳されます。@c
2580 強弱記号、クレッシェンド、デクレッシェンドは MIDI ボリューム レベルに@c
2582 強弱記号は利用可能な MIDI ボリューム レンジ内のある固定値に翻訳されます。@c
2583 クレッシェンドとデクレッシェンドはそれらの開始点と終了点の間でボリュームを@c
2585 MIDI 出力における強弱記号の効果を完全に削除することができます
2586 -- @ref{MIDI block} を参照してください。
2588 初期のテンポと後のテンポ変化は、音楽記譜内部の @code{\tempo} コマンドで@c
2590 通常このコマンドはメトロノーム記号を表示させますが、@c
2592 -- @ref{Metronome marks} を参照してください。@c
2593 初期 MIDI テンポあるいは MIDI 全体のテンポを指定するための代替手段が@c
2594 この後で記述されています -- @ref{MIDI block} を参照してください。
2596 Windows の制限により、Windows での MIDI ファイルのデフォルトの拡張子は
2598 他の OS では、拡張子は @code{.midi} となります。@c
2599 他の拡張子を使いたいのであれば、入力ファイルの最上位で、@c
2600 @code{\book} ブロック, @code{\bookpart} ブロック、それに @code{\score}
2604 #(ly:set-option 'midi-extension "midi")
2607 上記の行は、MIDI ファイルのデフォルトの拡張子を @code{.midi} にします。
2610 コマンド ラインで以下のオプションを与える方法があります:
2613 lilypond … -dmidi-extension=midi lilyFile.ly
2617 @unnumberedsubsubsec 楽器名
2618 @c @unnumberedsubsubsec Instrument names
2620 @cindex instrument names (楽器名)
2621 @funindex Staff.midiInstrument
2623 @code{Staff.midiInstrument} プロパティに楽器名を設定することで、@c
2624 使用する MIDI 楽器が指定されます。@c
2625 楽器名は @ref{MIDI instruments} にあるリストから選択しなければなりません。
2629 \set Staff.midiInstrument = #"glockenspiel"
2635 \new Staff \with @{midiInstrument = #"cello"@} @{
2640 選択された楽器が MIDI 楽器のリストにある楽器に一致しない場合、@c
2641 グランド ピアノ (@code{"acoustic grand"}) 楽器が使用されます。
2646 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2647 {changing-midi-output-to-one-channel-per-voice.ly}
2651 @c In 2.11 the following no longer seems to be a problem -td
2653 Unterminated (de)crescendos will not render properly in the midi file,
2654 resulting in silent passages of music. The workaround is to explicitly
2655 terminate the (de)crescendo. For example,
2657 終端の無い(デ)クレッシェンドは適切に MIDI ファイルを作り出しません。@c
2658 結果として無音の音楽パッセージとなります。@c
2659 回避方法として、明示的に(デ)クレッシェンドを終了させます。@c
2667 will not work properly but
2679 MIDI ボリュームの変化は音符の開始点でのみ起こります。@c
2680 そのため、クレッシェンドとデクレッシェンドは@c
2681 単一の音符のボリューム変化には効果を持ちません。
2683 すべての MIDI プレイヤが MIDI 出力の中にあるテンポ変化を@c
2685 正しく機能するプレイヤとして知られているものには MS Windows の Media Player や
2686 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} があります。
2689 @subsection MIDI ブロック
2690 @translationof MIDI block
2692 @cindex MIDI block (MIDI ブロック)
2695 score 内部に @code{\midi} ブロックを置く必要があります。@c
2696 MIDI ブロックはレイアウト ブロックに似ていますが、それよりも単純です。@c
2697 しばしば、@code{\midi} ブロックは空のままですが、コンテキストの再編成
2698 -- 新しいコンテキスト定義やプロパティの値を設定するためのコード --
2700 例えば以下の例は、テンポ指示を譜刻することなしに、@c
2701 MIDI ファイルの初期テンポを設定します:
2712 この例では、テンポは 1 分間あたり 72 個の 4 分音符にセットされています。@c
2713 @code{\tempo} は実際、コンパイルの最中にプロパティを設定する音楽コマンドです:
2714 @code{\midi} ブロックのような出力定義コンテキストの中にある @code{\tempo} は@c
2715 当然のこととして、コンテキストを変更するものとして解釈されます。
2717 @cindex MIDI context definitions (MIDI コンテキスト定義)
2719 @code{\midi} ブロック内部でのコンテキスト定義は、@c
2720 @code{\layout} ブロック内部でのコンテキスト定義の構文とまったく同じです。@c
2721 サウンドのモジュールへの翻訳は performer と呼ばれます。@c
2723 @file{../ly/performer-init.ly} で定義されています
2724 -- @rlearning{Other sources of information} を参照してください。@c
2725 例えば、MIDI 出力から強弱記号の効果を削除するには、@c
2726 @code{\midi@{ @}} ブロックの中に以下のコードを挿入します。
2733 \remove "Dynamic_performer"
2738 MIDI 出力は、@code{\score} コマンドで定義された score ブロック内部に
2739 @code{\midi} ブロックが存在する場合にのみ生成されます。
2742 @code{\midi} ブロックが明示的にインスタンス化された score コンテキストの中
2743 (例えば、@code{\new Score} ブロックの中) に配置された場合、@c
2744 その LilyPond ファイルはエラーになります。@c
2745 これを解決するには、@code{\new Score} と @code{\midi} コマンドを
2746 @code{\score} ブロックの中に置きます。
2751 @{ @dots{}notes@dots{} @}
2757 @node 何が MIDI に出力されるのか?
2758 @subsection 何が MIDI に出力されるのか?
2759 @translationof What goes into the MIDI output?
2761 @c TODO Check grace notes - timing is suspect?
2763 @unnumberedsubsubsec MIDI でサポートされるもの
2764 @c @unnumberedsubsubsec Supported in MIDI
2766 @cindex Pitches in MIDI (MIDI でのピッチ)
2767 @cindex MIDI, Pitches (MIDI でのピッチ)
2768 @cindex Quarter tones in MIDI (MIDI での4 分音)
2769 @cindex MIDI, quarter tones (MIDI での4 分音)
2770 @cindex Microtones in MIDI (MIDI での微分音)
2771 @cindex MIDI, microtones (MIDI での微分音)
2772 @cindex Chord names in MIDI (MIDI でのコード ネーム)
2773 @cindex MIDI, chord names (MIDI でのコード ネーム)
2774 @cindex Rhythms in MIDI (MIDI でのリズム)
2775 @cindex MIDI, Rhythms (MIDI でのリズム)
2776 @cindex Articlulate scripts (奏法スクリプト)
2777 @cindex MIDI, articulations (MIDI での奏法)
2778 @cindex articulations in MIDI (MIDI での奏法)
2779 @cindex trills in MIDI (MIDI でのトリル)
2780 @cindex turns in MIDI (MIDI でのターン)
2781 @cindex rallentando in MIDI (MIDI でのラレンタンド)
2782 @cindex accelerando in MIDI (MIDI でのアッチェレランド)
2785 以下の記譜要素が MIDI 出力に反映されます:
2789 @item 微分音 (@ref{Accidentals} を参照してください。@c
2790 演奏にはピッチ ベンドをサポートするプレイヤが必要になります。)
2792 @item 音符の演奏時間として入力されたリズム -- 連符を含みます
2793 @item @q{@code{:}[@var{number}]} を使わずに入力されたトレモロ
2796 @item 複数の音符にかかるクレッシェンド、デクレッシェンド
2797 @item テンポ記号で入力されたテンポ変化
2801 @ref{The Articulate script} を用いることで、@c
2802 上記のリストにいくつかの要素が追加されます:
2805 @item アーティキュレーション (スラー、スタッカート等)
2807 @item ラレンタンドとアッチェレランド
2810 @unnumberedsubsubsec MIDI でサポートされないもの
2811 @c @unnumberedsubsubsec Unsupported in MIDI
2813 @c TODO index as above
2815 以下の記譜要素は MIDI 出力に影響を与えません:
2818 @item 注記 -- 例えば swing -- として入力されたリズム
2819 @item テンポ記号を使わずに注記として入力されたテンポ変化
2820 @item スタッカートと他のアーティキュレーションや装飾
2821 @item スラーとフレージング スラー
2822 @item 単一の音符に付けられたクレッシェンド、デクレッシェンド
2823 @item @q{@code{:}[@var{number}]} を使って入力されたトレモロ
2830 @subsection MIDI での繰り返し
2831 @translationof Repeats in MIDI
2833 @cindex repeats in MIDI (MIDI での繰り返し)
2834 @funindex \unfoldRepeats
2837 すべてのタイプの繰り返しを MIDI 出力に反映させることができます。@c
2838 これは @code{\unfoldRepeats} 音楽関数を適用することによって@c
2840 この関数はすべての繰り返しを展開します。
2842 @lilypond[quote,verbatim]
2844 \repeat tremolo 8 { c'32 e' }
2845 \repeat percent 2 { c''8 d'' }
2846 \repeat volta 2 { c'4 d' e' f' }
2855 複数のボイスを持つ score で、繰り返しを正しく MIDI 出力に展開するには、@c
2856 @emph{各ボイス} の繰り返し指示が完全に記譜されている必要があります。
2858 MIDI のために @code{\unfoldRepeats} を使用する楽譜ファイルを作成する場合、@c
2859 2 つの @code{\score} ブロックが必要になります:
2860 1 つは MIDI のため (繰り返しを展開します) で、@c
2862 (差し替え、トレモロ、パーセント記号の繰り返しを使用します) です。@c
2871 \unfoldRepeats @var{..music..}
2876 @node MIDI での音の強弱を制御する
2877 @subsection MIDI での音の強弱を制御する
2878 @translationof Controlling MIDI dynamics
2880 @c MIDI dynamics: MIDI での音の強弱?
2881 MIDI での音の強弱は @code{Dynamic_performer}
2882 -- これはデフォルトでは Voice コンテキストの中に存在します --
2884 MIDI 全体のボリューム、強弱記号による相対ボリューム、@c
2885 楽器間の相対ボリュームを制御することができます。
2887 @unnumberedsubsubsec 強弱記号
2888 @c @unnumberedsubsubsec Dynamic marks
2890 強弱記号は利用可能な MIDI ボリューム レンジ内のある固定の分数に翻訳されます。@c
2891 デフォルトでの分数の範囲は、@notation{ppppp} に対する 0.25 から、@c
2892 @notation{fffff} に対する 0.95 までです。@c
2893 強弱記号とそれに対応する分数のセットを @file{../scm/midi.scm} で@c
2895 -- @rlearning{Other sources of information} を参照してください。@c
2896 引数として強弱記号をとり、それに対する分数を返す関数を作成し、@c
2897 その関数を @code{Score.dynamicAbsoluteVolumeFunction} に@c
2898 セットすることによって、分数のセットを変更あるいは拡張することができます。
2900 例えば、@notation{リンフォルツァンド} 強弱記号 -- @code{\rfz} -- を@c
2902 この強弱記号はデフォルト セットの中に含まれていないため、@c
2903 MIDI ボリュームに影響を与えません。@c
2904 同様に @code{make-dynamic-script} で新しい強弱記号を定義した場合、@c
2905 その強弱記号もデフォルト セットには含まれません。@c
2906 以下の例は、そのような強弱記号に対する MIDI ボリュームを追加する方法を@c
2908 以下の Scheme 関数は、rfz の強弱記号があった場合は分数に 0.9 をセットし、@c
2909 そうでない場合はデフォルトの関数を呼び出します。
2911 @lilypond[verbatim,quote]
2912 #(define (myDynamics dynamic)
2913 (if (equal? dynamic "rfz")
2915 (default-dynamic-absolute-volume dynamic)))
2919 \set Staff.midiInstrument = #"cello"
2920 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2932 分数テーブル全体を再定義する必要がある場合、@c
2933 上記の方法の代わりに @file{../scm/midi.scm} の中にある
2934 @notation{default-dynamic-absolute-volume} プロシージャと@c
2935 そのモデルとなる関連テーブルを使用する方が良いでしょう。@c
2936 このセクションの最後の例で、その方法を示しています。
2938 @unnumberedsubsubsec MIDI 全体でのボリューム
2939 @c @unnumberedsubsubsec Overall MIDI volume
2941 強弱記号に対する MIDI 全体の最小ボリュームと最大ボリュームは
2942 @code{Score} レベルでプロパティ @code{midiMinimumVolume} と
2943 @code{midiMaximumVolume} を設定することで制御できます。@c
2944 これらのプロパティは強弱記号に対してのみ効果を発揮します。@c
2945 そのため、楽譜の開始からそれらのプロパティを適用するには、@c
2946 楽譜の開始点に強弱記号を置く必要があります。@c
2947 各強弱記号に対応する分数は以下の式で算出されます:
2950 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2953 以下の例では、MIDI 全体のボリュームの範囲は 0.2 - 0.5 の範囲に制限されています。
2955 @lilypond[verbatim,quote]
2961 \set Staff.midiInstrument = #"flute"
2962 \new Voice \relative c''' {
2970 \set Staff.midiInstrument = #"clarinet"
2971 \new Voice \relative c'' {
2983 midiMinimumVolume = #0.2
2984 midiMaximumVolume = #0.5
2990 @unnumberedsubsubsec 楽器の音の強さを均一化する (i)
2991 @c @unnumberedsubsubsec Equalizing different instruments (i)
2993 @code{Staff} コンテキストの中で最小 MIDI ボリューム プロパティと@c
2994 最大 MIDI ボリューム プロパティが設定されている場合、@c
2995 MIDI 楽器間の相対ボリュームを制御することができます。@c
2996 これは基本的な楽器イコライザであり、@c
2997 MIDI 出力の品質を著しく高めることができます。
2999 以下の例では、クラリネットのボリュームはフルートのボリュームよりも@c
3001 これを正しく機能させるには、それぞれの楽器の最初の音符に@c
3004 @lilypond[verbatim,quote]
3010 \set Staff.midiInstrument = #"flute"
3011 \set Staff.midiMinimumVolume = #0.7
3012 \set Staff.midiMaximumVolume = #0.9
3013 \new Voice \relative c''' {
3021 \set Staff.midiInstrument = #"clarinet"
3022 \set Staff.midiMinimumVolume = #0.3
3023 \set Staff.midiMaximumVolume = #0.6
3024 \new Voice \relative c'' {
3038 @unnumberedsubsubsec 楽器の音の強さを均一化する (ii)
3039 @c @unnumberedsubsubsec Equalizing different instruments (ii)
3041 MIDI 最小/最大ボリューム プロパティが設定されていない場合、@c
3042 デフォルトでは、LilyPond はいくつかの楽器に軽度の均一化を適用します。@c
3043 適用を受ける楽器とその equalization は @file{../scm/midi.scm} の中にある@c
3044 テーブル @notation{instrument-equalizer-alist} に示されています。
3046 引数として MIDI 楽器名だけを受け入れて、その楽器に適用する@c
3047 最小/最大ボリュームの分数ペアを返す Scheme プロシージャを
3048 @code{Score} コンテキストの中にある
3049 @code{instrumentEqualizer} にセットすることで、@c
3050 この基本的なデフォルト イコライザを置き換えることができます。@c
3051 この置き換えは、このセクションの始めでの
3052 @code{dynamicAbsoluteVolumeFunction} の再設定の方法とまったく同じです。@c
3053 @file{../scm/midi.scm} の中にあるデフォルト イコライザ
3054 @notation{default-instrument-equalizer} は@c
3055 そのようなプロシージャをどのように記述するのかを示しています。
3057 以下の例は、フルートとクラリネットの相対ボリュームを@c
3060 @lilypond[verbatim,quote]
3061 #(define my-instrument-equalizer-alist '())
3063 #(set! my-instrument-equalizer-alist
3066 ("flute" . (0.7 . 0.9))
3067 ("clarinet" . (0.3 . 0.6)))
3068 my-instrument-equalizer-alist))
3070 #(define (my-instrument-equalizer s)
3071 (let ((entry (assoc s my-instrument-equalizer-alist)))
3080 \set Score.instrumentEqualizer = #my-instrument-equalizer
3081 \set Staff.midiInstrument = #"flute"
3082 \new Voice \relative c''' {
3090 \set Staff.midiInstrument = #"clarinet"
3091 \new Voice \relative c'' {
3106 @c Delete when satisfied this is adequately covered elsewhere -td
3108 @n ode Microtones in MIDI (MIDI での微分音)
3109 @s ubsection Microtones in MIDI (MIDI での微分音)
3111 @cindex microtones in MIDI (MIDI での微分音)
3113 半シャープと半フラットからなる微分音は MIDI ファイルにエクスポートされ、@c
3114 ピッチ ベンドをサポートする MIDI プレーヤで正しく演奏されます。@c
3115 @ref{Note names in other languages} を参照してください。@c
3116 以下の例は 1 オクターブの中にあるすべての半シャープと半フラットの音を@c
3118 この例をコピーしてコンパイルすることで、@c
3119 あなたが持っている MIDI プレイやで微分音をテストすることができます。
3121 @lilypond[verbatim,quote]
3139 @subsection MIDI での打楽器
3140 @translationof Percussion in MIDI
3142 打楽器は一般的に @code{DrumStaff} コンテキストの中で記譜され、@c
3143 そのように記譜された場合、その打楽器は正しく MIDI チャンネル 10 に@c
3145 しかしながら、いくつかのピッチを持つ打楽器
3146 -- ザイロフォン、マリンバ、ビブラフォン、ティンパニなど --
3147 は @qq{通常の} 楽器のように扱われ、正しい MIDI 出力を得るには、@c
3149 通常の @code{Staff} コンテキストに入力する必要があります
3150 -- @code{DrumStaff} には入力しません。
3154 -- メロディック トム、太鼓、シンセドラムなど --
3155 のサウンドは一般の MIDI 標準に含まれ、MIDI チャネル@tie{}10 経由では@c
3157 そのため、そのような楽器の記譜も適切なピッチを使って@c
3158 通常の @code{Staff} コンテキストに入力すべきです。
3160 多くの打楽器 -- カスタネットなど -- は一般の MIDI 標準には含まれません。@c
3161 そのような楽器のための記述を行っている場合に MIDI 出力を作り出すための@c
3162 最も容易な -- けれども不十分な -- 方法は、@c
3163 標準セットから最も近いサウンドを代わりに用いることです。
3165 @c TODO Expand with examples, and any other issues
3169 一般の MIDI 標準はリム ショットを含まないため、@c
3174 @translationof The Articulate script
3176 奏法スクリプトを用いることにより、よりリアルな MIDI 出力を得ることができます。@c
3177 奏法スクリプトは、音符を適切な時間比率の音符とスキップで置き換えることにより、@c
3178 アーティキュレーション (スラー、スタッカート等) を考慮に入れようとします。@c
3179 さらに、トリルやターンを展開しようとし、@c
3180 さらにラレンタンドとアッチェレランドを考慮に入れようとします。
3183 入力ファイルの先頭で以下をインクルードする必要があります。
3186 \include "articulate.ly"
3189 さらに、@code{\score} セクションで以下のようにします。
3192 \unfoldRepeats \articulate <<
3193 all the rest of the score...
3197 この方法で入力ファイルを変更すると、@c
3198 出力される楽譜の見た目は著しく変わってしまいますが、@c
3199 標準の @code{\midi} ブロックはより良い MIDI ファイルを作り出します。
3201 奏法スクリプトを機能させるための必須事項ではありませんが、@c
3202 上記の例のように @code{\unfoldRepeats} コマンドを挿入することにより、@c
3203 @notation{トリル} などの短縮記譜の演奏が可能になります。
3208 Articulate shortens chords といくつかの音楽 (特にオルガン音楽) の演奏は@c
3214 @translationof Extracting musical information
3216 グラフィカルな出力と MIDI を作り出すことに加えて、@c
3217 LilyPond は音楽情報をテキストとして表示することができます。
3220 * LilyPond 記譜法を表示する::
3221 * Scheme 音楽表記を表示する::
3222 * 音楽イベントをファイルに保存する::
3225 @node LilyPond 記譜法を表示する
3226 @subsection LilyPond 記譜法を表示する
3227 @translationof Displaying LilyPond notation
3229 @funindex \displayLilyMusic
3231 LilyPond 記譜法で書かれた音楽表記を@c
3232 音楽関数 @code{\displayLilyMusic} で表示することが可能です。@c
3233 出力を見るには、通常、コマンド ラインで LilyPond を実行します。@c
3238 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3245 @{ a,4 cis e fis g @}
3248 デフォルトでは、LilyPond は上記のメッセージを@c
3249 他のすべてのメッセージと一緒にコンソールに表示します。@c
3250 上記のメッセージを分離して @code{\display@{STUFF@}} の結果を保存するには、@c
3254 lilypond file.ly >display.txt
3259 LilyPond は音楽表記を表示するだけでなく、それを解釈します
3260 (なぜなら、@code{\displayLilyMusic} は追加で音楽表記を表示するために@c
3262 既存の音楽に @code{\displayLilyMusic} を挿入するだけで@c
3263 その音楽の情報を得るられるので便利です。@c
3264 本当に LilyPond に音楽を解釈させたくないのであれば、@c
3265 @code{\void} を使ってその音楽を無視させます:
3269 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3274 @node Scheme 音楽表記を表示する
3275 @subsection Scheme 音楽表記を表示する
3276 @translationof Displaying scheme music expressions
3278 @rextend{Displaying music expressions} を参照してください。
3281 @node 音楽イベントをファイルに保存する
3282 @subsection 音楽イベントをファイルに保存する
3283 @translationof Saving music events to a file
3285 以下のファイルをインクルードすることにより、@c
3286 音楽イベントをファイルに保存することができます。
3289 \include "event-listener.ly"
3292 これは譜毎に @file{FILENAME-STAFFNAME.notes} あるいは
3293 @file{FILENAME-unnamed-staff.notes} というファイルを作成します。@c
3295 すべての譜のイベントが同じファイルに出力されるということに注意してください。@c
3299 0.000 note 57 4 p-c 2 12
3301 0.250 note 62 4 p-c 7 12
3302 0.500 note 66 8 p-c 9 12
3303 0.625 note 69 8 p-c 14 12
3308 出力はタブ区切り行で、各行には 2 つの固定フィールドがあり、@c
3309 その後にオプション パラメータが続きます。
3312 @var{time} @var{type} @var{...params...}
3316 簡単に Python スクリプト等の他のプログラムに読み込ませることができ、@c
3317 LilyPond で音楽分析や録音再生実験を行おうとする研究者にとってとても有用です。
3322 lilypond 音楽イベントすべてが @file{event-listener.ly} で@c
3324 @file{event-listener.ly} は、良く作られた @qq{概念実証} を意図しています。
3326 読み取りたい音楽イベントがサポートされていないのであれば、@c
3327 あなたが作業している lilypond ディレクトリに @file{event-listener.ly} を@c
3328 コピーして、編集することで、望みの情報を出力させることができます。