メタデータ

メタタグは曲に関する情報を提供する方法であり、メタデータセクションで表現されます。メタデータは、曲の最初のセクション、最初の空白行までの間、またはメタタグがこれ以上ないまで表現されます。メタタグは名前と値のペアであり、名前は左側にあり、値はコロンで区切られて右側にあります。1行に表示できるメタタグは1つだけです。ChordPro形式でメタデータを表現する方法の詳細については、ChordPro ファイル形式を参照してください。

OnSongは、メタタグ形式でない場合、テキストファイルの最初の行を曲のタイトルとして自動的に割り当てます。さらに、メタタグが定義されていない限り、2番目の行は曲のアーティスト/署名と見なされます。以下は、タイトルとアーティストを最初と2番目の行として設定し、キーとテンポも設定する典型的な曲のメタデータセクションの例です。

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

歌詞とコードはここから始まります...

メタデータタグ

OnSongがサポートしている以下のタグがあります:

• タイトル: 曲のタイトル。これは曲のコンテンツの最初の行で表現することもできます。
• アーティスト: アーティスト名またはその他の署名情報。これは曲のコンテンツの2番目の行で表現することもできます。複数のアーティストを指定する場合は、セミコロンで名前を区切ります。 - Kim Walker-Smith; Chris Quilala
• 作成者: コードチャートを作成した人の名前。これはコードチャートの下部と歌詞投影に表示されます。
• キー: キーを持つ曲のキー(異名同音の選択肢を持つ)と、短調を示すためのオプションの「m」。 - アルファベット、例: Bb または Em
• TransposedKey: 曲が書かれているキーと異なる可能性のある、曲を演奏する必要のある目的のキー。 - アルファベット、例: Bb または Em
• In: トランスポーズされたキーメタデータタグの別名です。
• カポ: カポを設定するフレット数として設定します。これは通常正の整数(1〜11)ですが、負の整数に設定することもできます。 - 数値
• テンポ: ビート数/分(BPM)。 - 数値
• 時間: 拍子記号。 - 数値ビート/小節、例: 3/4
• 期間: オートスクロール用の曲の長さ。 - 秒またはmm:ss
• ブック: 曲を配置するブックの名前。これは、曲を配置するブック名のコンマ区切りリストです。ブックが存在しない場合は、自動的に作成されます。
• 番号: 曲の番号 - 数値。賛美歌、年など用に使用します。参照用に曲を番号でソートできます。
• フロー: セクションの配置。 - セクションラベルのリスト。 曲のフロー配置の詳細については、フローを参照してください。
• MIDI: 曲を表示するときに送信するMIDIコマンド。OnSongでMIDIコマンドをテキストとして表現する方法については、MIDI構文を参照してください。
• MIDI-Index: この曲を曲ビューアーで開くことをトリガーするMIDIコマンド。OnSongでMIDIコマンドをテキストとして表現する方法については、MIDI構文を参照してください。
• キーワード: または トピック: トピック検索で使用するタグのリスト。トピック別の閲覧の詳細については、トピックを参照してください。
• 著作権: または フッター: または f: 曲の著作権情報。これはコードチャートと歌詞投影の下部に表示されます。
• CCLI: 曲のCCLI番号。これはコードチャートと歌詞投影の下部に表示されます。
• 制限: これらは曲内で特定のアクションが発生するのを防ぐ制限です。曲の制限の設定の詳細については、制限を参照してください。
• ピッチ: ピッチパイプ機能を使用するときに再生するノートまたはノート。これは、オプションのオクターブを備えたスペース区切りのノートのリストとして定義されます。 - 例: A3 C#4 E5
• サブディビジョン: または ビート: 曲のサブディビジョンを選択できます。これは、whole、half、quarter、eighth、shuffle、またはsixteenthを含む値にすることができます。または、1、2、4、8、または16などの整数を使用できます。
• トランスポーズ: 曲をトランスポーズする半音の数。これは曲の途中で使用して曲を上下に変調し、トランスポーションスライダーで設定されたキーに対応します。この数値は正または負の整数である必要があります。
• チューニング: 曲に割り当てる楽器チューニング。これらは楽器固有であり、現在ギターのみがサポートされており、以下の値があります: Standard、Celtic、Drop D、Drop DD、Drop C、Drop B、Drop A、Open C、Open D、Open G、またはOpen E。
• シーン: 曲がロードされるときに再生するシーン。コロンの後にシーンの名前を入力して設定できます。

インラインタグ

一部のタグは曲内で使用して、曲の途中でトランスポーズに影響を与えることができます。これには以下が含まれます:

• カポ: 曲の途中でカポを適用して曲を変調し、カポを適用して演奏するコードを提供するために使用できます。カポ設定で変調の方向を調整できます。これは通常正の整数(1〜11)ですが、前のカポを削除するために負の整数に設定することもできます。 - 数値
• キー: 曲のキーを明示的に設定する。括弧付きコードを使用する場合に値をブラケットで囲むと、結果のキーもトランスポーズされます。 - アルファベット、例: Bb または Em
• トランスポーズ: 曲を目的の半音数トランスポーズします。これは正または負の整数です。たとえば、2または+2を使用して曲を全音上にトランスポーズするか、-3を使用して3つの半音下にトランスポーズします。 - 数値

セクションタグ

一部のタグは曲の各セクションに関する情報を提供するために使用できます。これには以下が含まれます:

• MIDI: セクションが選択されたときに送信するMIDIコマンド。OnSongでMIDIコマンドをテキストとして表現する方法については、MIDI構文を参照してください。
• シーン: セクションが選択されたときに再生するシーン。コロンの後にシーンの名前を入力して設定できます。

注: メタタグは大文字と小文字を区別しません