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: ...} 1 分あたりのビート数（BPM）- 数値
• {time: ...} 拍子記号 - 例：3/4 などの小節上の数値ビート
• {duration: ...} 自動スクロール用の曲の長さ - 秒または mm:ss
• {book: ...} 曲を配置するブック名またはブック名の名前。これは、曲が配置されるブック名のコンマ区切りリストです。ブックが存在しない場合は、自動的に作成されます。
• {number: ...} 曲の番号 - 数値、賛美歌、年など、参照用に曲を番号でソートできます。
• {flow: ...} セクションの配置 - セクションラベルのリスト。曲のフローを配置する詳細については、フローを参照してください。
• {midi: ...} 曲を表示するときに送信する MIDI コマンド。OnSong でテキストとして MIDI コマンドを表現する方法については、MIDI 構文を参照してください。
• {midi-index: ...} 曲ビューアでこの曲を開くトリガーとなる MIDI コマンド。OnSong でテキストとして MIDI コマンドを表現する方法については、MIDI 構文を参照してください。
• {pitch: ...} ピッチパイプ機能を使用するときに再生する音符。
• {keywords: ...} または {topic: ...} トピック検索で使用するタグのリスト。トピック別の参照の詳細については、トピックを参照してください。
• {copyright: ...} または {footer: ...} または {f: ...} ページの下部または歌詞投影に表示される著作権フッターテキストを指定します。
• {ccli: ...} 曲の CCLI 番号。
• {restrictions: ...} 曲の権利管理のコンマ区切り制限リスト。曲の制限を設定する詳細については、「制限」を参照してください。
• {composer: ...} 曲の音楽を作成した個人。このリストはセミコロンで区切られるべきです。
• {lyricist: ...} 曲の歌詞を作成した個人。このリストはセミコロンで区切られるべきです。

インラインタグ

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

• {define: ...} はカスタムコード図を定義するために使用されます。詳細については、弦の定義を参照してください。
• {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