ChordPro

ChordPro ファイル形式は、他のソフトウェアアプリケーションで使用される一般的な形式です。OnSong はこの形式をネイティブに理解します。OnSong は以下のファイル拡張子を持つファイルを認識します: .chordpro, .chopro, .cho, .crd, .pro

ChordPro 形式では、曲情報を中括弧で区切られたタグで表現できます。この情報は、メタデータタグとインラインタグに論理的に分割できます。

メタデータタグ

これらは曲のメタデータ部分で使用する ChordPro タグです。以下のタグでは、3 つのドット (...) はコロンと閉じ中括弧の間に入力するテキストを表します。例えば:

{title: Amazing Grace}
{key: G}

OnSong は以下の ChordPro タグをサポートしています:

• {title: ...} または {t: ...} 曲のタイトル。
• {subtitle: ...}、{st: ...} または {su: ...} アーティスト名またはその他のバイライン情報。セミコロンで区切ることで複数のアーティストを指定できます。- Kim Walker-Smith; Chris Quilala
• {album: ...} 曲が含まれるアルバムの名前。
• {artist: ...} または {a: ...} アーティスト名またはその他のバイライン情報。セミコロンで区切ることで複数のアーティストを指定できます。- Kim Walker-Smith; Chris Quilala
• {author: ...} コード譜を作成した人の名前。これはコード譜の下部と歌詞プロジェクションに表示されます。
• {key: ...} または {k: ...} または {ok: ...} キーの設定（調号と、マイナーを示すオプションの「m」付き）。- アルファベット形式、例: Bb または Em
• {capo: ...} カポの位置（フレット数）- 数値
• {tempo: ...} ビート毎分 (BPM) - 数値
• {time: ...} 拍子記号 - 数値（小節単位、例: 3/4）
• {duration: ...} オートスクロール用の曲の長さ - 秒または mm:ss
• {book: ...} 曲を配置するブック名。これはコンマで区切られたブック名のリストです。ブックが存在しない場合は自動的に作成されます。
• {number: ...} 曲の番号 - 数値。讃美歌や年号などに使用。番号で曲をソートして参照できます。
• {flow: ...} セクションの配列 - セクションラベルのリスト。曲のフローを配置する詳細は Flow を参照してください。
• {midi: ...} 曲を表示するときに送信する MIDI コマンド。OnSong でテキストとして MIDI コマンドを表現する方法については MIDI Syntax を参照してください。
• {midi-index: ...} この曲を Song Viewer で開くようにトリガーする MIDI コマンド。OnSong でテキストとして MIDI コマンドを表現する方法については MIDI Syntax を参照してください。
• {pitch: ...} Pitch Pipe 機能を使用するときに再生するノート。
• {keywords: ...} または {topic: ...} トピック検索に使用するタグのリスト。トピック別の閲覧の詳細については Topics を参照してください。
• {copyright: ...} または {footer: ...} または {f: ...} ページの下部または歌詞プロジェクションに表示される著作権フッターテキストを指定します。
• {ccli: ...} 曲の CCLI 番号。
• {restrictions: ...} 曲の権利管理（コンマで区切られた制限事項のリスト）。曲の制限事項の設定の詳細は「Restrictions」を参照してください。
• {composer: ...} 曲の音楽を作曲した個人。このリストはセミコロンで区切る必要があります。
• {lyricist: ...} 曲の歌詞を作成した個人。このリストはセミコロンで区切る必要があります。

インラインタグ

これらのタグは曲のコンテンツ内で使用され、セクションを定義したり、曲の一部をフォーマットしたりできます。

• {define: ...} はカスタムコード図を定義するために使用されます。詳細については Defining Chords を参照してください。
• {comment: ...} または {c: ...} コメントを定義し、楽譜の指示として表示されます。
• {comment_bold: ...} または {cb: ...} 太字で表示するテキストを定義します。
• {comment_italic: ...} または {ci: ...} イタリックで表示するテキストを定義します。
• {guitar_comment: ...} または {gc: ...} 楽譜の指示として表示されるコメントを定義します。
• {start_of_verse: ..} または {sov} オプションのセクションラベル付きでヴァースセクションの開始を宣言します。
• {end_of_verse} または {eov} ヴァースセクションの終了を宣言します。
• {start_of_chorus: ...} または {soc} オプションのセクションラベル付きでコーラスセクションの開始を宣言します。
• {end_of_chorus} または {eoc} コーラスセクションの終了を宣言します。
• {start_of_bridge: ...} または {sob} オプションのセクションラベル付きでブリッジセクションの開始を宣言します。
• {end_of_bridge} または {eob} ブリッジセクションの終了を宣言します。
• {start_of_part: ..} または {sop} オプションのセクションラベル付きでパートの開始を宣言します。
• {end_of_part} または {eop} パートの終了を宣言します。
• {start_of_tab} または {sot} OnSong が等幅フォントでレンダリングするタビュラチュアの開始を宣言します。
• {end_of_tab} または {eot} タビュラチュアセクションの終了を宣言します。
• {new_page} または {np} 新しいページを宣言するために使用されます。
• {new_physical_page} または {npp} 新しいページを宣言するために使用されます。

フォーマットタグ

以下のタグは、コード譜のデフォルトのフォントとサイズを定義するために使用されます。

• {textsize: ...} 歌詞のサイズをポイント単位の数値で定義します。
• {textfont: ...} 歌詞に使用するフォントの名前を定義します。プラットフォームでサポートされている必要があります。
• {chordsize: ...} コードのサイズをポイント単位の数値で定義します。
• {chordfont: ...} コードに使用するフォントの名前を定義します。プラットフォームでサポートされている必要があります。

サポートされているファイル拡張子

ChordPro ファイル形式は、一般的に合意された構文ですが、標準形式ではありません。つまり、さまざまなベンダーが異なる方法と異なるファイル拡張子で実装できます。OnSong は ChordPro 形式のファイルをインポートするときに以下のファイル拡張子をサポートしています:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm