box.defのフォーマット - DTXMania Wiki - DTXMania

box.def のフォーマット

box.def ファイルを作成することで、曲データを music box (フォルダ) の中に格納することができ、曲データを階層化して整理することができます。 また、box.def ファイルによって、music box (フォルダ) の設定をすることもできます。

曲データを階層化するには、以下のようにします。

1. 適当な名前でフォルダを掘って、 そのフォルダの中に box.def という名前のファイルを作ります。
2. そのフォルダの中に、box.def ファイルを置きます。box.def の中身は、例えば以下のようにします。(個々の内容の説明は後述)

   #TITLE: ＦＲＯＭ DTX集
   #ARTIST: ＦＲＯＭ
   #COMMENT: てってけリズムでフロアタム炸裂。
   #PREIMAGE: preimage.jpg  (もしくは、#PREMOVIE: premovie.avi)
   #PREVIEW: preview.wav
   #FONTCOLOR: #FFFFFF
   #PERFECTRANGE: 34        (注: Release 068 (080427) 以降で使用可能)
   #GREATRANGE: 67          (注: Release 068 (080427) 以降で使用可能)
   #GOODRANGE: 84           (注: Release 068 (080427) 以降で使用可能)
   #POORRANGE: 117          (注: Release 068 (080427) 以降で使用可能)
   #SKINPATH: FROMSKIN      (注: Release 094 (120610) 以降で使用可能)
   #SKINPATH100: FROMSKIN100      (注: Release 104 (151212) 以降で使用可能)
   

3. そして、box.def ファイルのあるフォルダ以下に、DTXファイルを置きます。すると、その曲データは、box.def ファイルの #TITLE で指定した名前の musioc box (フォルダ) に格納されます。

以下、box.def で設定できる内容について説明します。

#TITLE	music box (フォルダ) の名前を設定します。
#ARTIST	music box (フォルダ) を選択しているときに表示するアーティスト情報を設定します。
#COMMENT	music box (フォルダ) を選択しているときに表示するアーティスト情報を設定します。
#PREIMAGE	music box (フォルダ) を選択しているときに表示するサムネイル画像を設定します。(#PREMOVIEとどちらか片方だけ指定してください)
#PREMOVIE	music box (フォルダ) を選択しているときに表示するサムネイル動画を設定します。(#PREIMAGEとどちらか片方だけ指定してください)
#PREVIEW	music box (フォルダ) を選択しているときに表示するプレビュー音楽を設定します。
#FONTCOLOR	music box (フォルダ) の名前の文字色を設定します。#rrggbbの形式で設定します(HTMLなどと同じ形式)。
#PERFECTRANGE, #GREATRANGE, #GOODRANGE, #POORRANGE	その music box (フォルダ) 内限定で、PERFECT～POORの判定許容時間(ms)を指定することができます。指定する値はConfig.iniのHitRangeで指定する値と同じで、基本的に必ず #PERFECTRANGE, #GREATRANGE, #GOODRANGE, #POORRANGE の4つをセットで指定する必要があります。この機能は、いわゆる IR (Internet Ranking) を想定した機能で、DTXMania Release 068 (080427) 以降で使用できます。
#SKINPATH, #SKINPATH100	この music box (フォルダ) 内限定で使うスキンのフォルダ名を、box.def ファイルからの相対パスで設定します。box.def ファイルでこの #SKINPATH を指定していると、この music box (フォルダ) に入った時に、指定したスキンに自動で切り替え、music box (フォルダ) から出たときに、スキンを自動的に元に戻します。#SKINPATHはこの機能は、DTXMania Release 094 (120610) 以降、Release099までの本体(VGAサイズのスキン)に対してのみ有効で、#SKINPATH100は、Release104以降の本体(FullHDサイズのスキン)に対してのみ有効です。なお、CONFIGURATION画面のSystem/Skin(Box)で、このスキン自動切替動作の有効/無効を設定できます(初期値は有効)。