AboutLoadingChart

譜面データ読込順仕様

• 譜面データを読み込むパターンが複数あるため、備忘的にまとめます。

1. 譜面データ読込パターン

パターン1. HTMLファイル内（id=dos）に直接譜面データがある

<input type="hidden" name="dos" id="dos" value='譜面データ'>

パターン2. 外部ファイル(.js, .txt)に譜面データがある（1ファイル目）

<!--// 外部dos定義 //-->
<input type="hidden" name="externalDos" id="externalDos" value="musicscore.txt">

• もしくはgetクエリ(例. ?dos=0001_test)が指定されている場合、dos/0001_test.txtを譜面ファイルとして読み込みます。

パターン3. 外部ファイル(.js, .txt)に譜面データがある（2ファイル目以降）

• 下記の場合、musicscore.txt ⇒ 1譜面目、musicscore2.txt ⇒ 2譜面目, ... となります。
• getクエリ(例. ?dos=0001_test)で指定している形式の場合は、dos/0001_test.txtが1譜面目、dos/0001_test2.txtが2譜面目となります。

<!--// 外部dos定義 //-->
<input type="hidden" name="externalDos" id="externalDos" value="musicscore.txt">

<!--// 譜面分割フラグ（valueを"true"にすると譜面毎にファイル分割） //-->
<input type="hidden" name="externalDosDivide" id="externalDosDivide" value="true">

2. 読み込むデータの種類と優先度

• 1.のパターンにより、読み込むデータの種類が異なる場合があります。
• 外部ファイル(2ファイル目以降)は読み込み順や適用順の関係で、譜面ヘッダーの大半が読み込み対象外となります。
• ただし、内部的にはg_rootObjには格納され、データ的には後勝ちとなります。

種類	パターン1	パターン2	パターン3
譜面ヘッダー (◆のみ)	✔️	✔️	✔️
譜面ヘッダー (◆以外)	✔️	✔️	❌
譜面本体	✔️	✔️	✔️
譜面エフェクト	✔️	✔️	✔️

2-1. 同時に読み込みが発生する場合の優先順

• 基本的に後勝ちとなります。
• パターン1 ⇒ パターン2 ⇒ パターン3 の順に適用されます。
• プレイ開始直前に再度読み込みが走ります。

2-2. 特殊な読み込み方法（譜面番号固定）

• 通常は譜面分割を行う場合、1ファイル目＝1譜面目(left_data)、2ファイル目＝2譜面目(left2_data)となりますが、
  譜面番号固定(externalDosLock)を使うことで複雑な譜面読み込みが可能になります。

<!--// 譜面番号固定フラグ（valueを"true"にすると譜面番号が変わっても譜面番号は1譜面目と同じ） //-->
<input type="hidden" name="externalDosLock" id="externalDosLock" value="true">

• さらに、譜面ヘッダー「dosNo」を使うことで1, 2譜面目は1ファイル目、3, 4譜面目は2ファイル目から取得することが可能です。
• ただし、dosNoを使った場合の譜面ヘッダー (◆のみ)の対応についてはver48の現状では不完全です。
  dosNoを併用する場合は、1ファイル目に譜面ヘッダーの設定をまとめることを推奨します。