LilyPond 記譜法リファレンス: 4.1.1 \paper ブロック

### 4.1.1 `\paper` ブロック

`\paper` ブロック 3 つの異なる場所に配置することができ、以下の順番でブロックの階層構造を作り出します:

- 入力ファイルの先頭。全ての `\book`, `\bookpart`, `\score` ブロックの前。
- `\book` ブロックの中であるが、そのブックの全ての `\bookpart` や `\score` ブロックの外。
- `\bookpart` ブロックの中であるが、そのブック パートの全ての `\score` ブロックの外。

`\paper` ブロックは、`\score` ブロックの中には配置できません。

フィールドの値は、この順番に沿って継承されます。つまり、高い階層でセットされた値は、下の階層で値がセットされて上書きされない限り保たれます。

各階層で、`\paper` ブロックは複数配置することができます。例えば、`\include` されるファイル毎に `\paper` ブロックを配置できます。その場合、それぞれの階層でフィールドの値が統合されます。同じフィールドが存在する場合、最後に出現した値が用いられます。

`\paper` ブロックで可能な設定には以下のものがあります:

- `set-paper-size` Scheme 関数
- ページ レイアウトをカスタマイズするのに用いられる `\paper` 変数
- ヘッダ、フッタ、それにタイトルのレイアウトをカスタマイズするのに用いられるマークアップ定義

`set-paper-size` 関数は次のセクション 紙面サイズと自動拡縮 で説明します。ページ レイアウトを扱う `\paper` 変数は後のセクションで説明します。ヘッダ、フッタ、それにタイトルを扱うマークアップ定義は カスタム タイトル、ヘッダ、フッタ で説明します。

たいていの `\paper` 変数は `\paper` ブロック内でのみ機能します。`\layout` ブロック内でも機能するいくつかの `\paper` 変数を`\layout` ブロック でリスト アップしています。

ページの長さに関係する `\paper` 変数の単位は、ユーザによって他の単位が指定されていなければ、ミリメーターです。例えば、以下の宣言は `top-margin` を `10mm` に設定します:

>     \paper {
>       top-margin = 10
>     }

`top-margin` を `0.5` インチに設定するには、単位接尾辞 `\in` を使用します:

>     \paper {
>       top-margin = 0.5\in
>     }

利用可能な単位接尾辞は `\mm`, `\cm`, `\in`, それに `\pt` です。これらの単位はミリメーターから変換するための値であり、‘`ly/paper-defaults-init.ly`’ で定義されています。技術的には必要はありませんが、明快さのために、ミリメーターを用いる場合であっても `\mm` をコードに記述します。

Scheme を用いて `\paper` の値を定義することも可能です。上の例と等価な Scheme は以下のようになります:

>     \paper {
>       #(define top-margin (* 0.5 in))
>     }

#### 参照

記譜法リファレンス: 紙面サイズと自動拡縮, カスタム タイトル、ヘッダ、フッタ, `\layout` ブロック

インストールされているファイル: ‘`ly/paper-defaults-init.ly`’

#### LilyPond — 記譜法リファレンス v2.22.2 (安定版).

- 2. 専門的な記譜法
- 3. 入出力全般
- 4. スペースの問題
- 5. デフォルトを変更する
- A. 付表
- B. カンニング ペーパー
- C. GNU Free Documentation License
- D. LilyPond コマンド インデックス
- E. LilyPond インデックス