obj v0002 g_headerObj - cwtickle/danoniplus GitHub Wiki

← オブジェクトリファレンスに戻る

g_headerObj

概要

初期化時に作成されるオブジェクト。preheaderConvert() および headerConvert() 関数にて生成される。
譜面データ（g_rootObj）のヘッダー情報を変換・補完して格納している。

g_headerObj.keyLabels[0]; // 1譜面目のキー数

生成タイミング

  • preheaderConvert() : タイトル画面呼び出し前（スキン・JSファイル読み込み前）
  • headerConvert() : スキン・カスタムJSファイル読み込み後

補足

  • ほとんどの項目は譜面ヘッダー項目とリンクしている。
  • 基本的に一度定義されれば変わらないが、一部例外あり（@ で示す）。

プロパティ

（* : 初期定義中に値が決まるプロパティ、@ : 設定により置き換わる可能性のあるプロパティ）

ファイル読込・スキン設定

（preheaderConvert で設定）

  • jsData (array2) — カスタムJS・スキンJS・カスタムCSSのファイル名とディレクトリ名
g_headerObj.jsData = [
    [`danoni_custom.js`, `../js/`],
    [`danoni_skin_default.js`, `../skin/`]
];
  • defaultSkinFlg (boolean) — デフォルトスキンを使用するかどうか
  • syncBackPath (boolean) — 背景・マスクモーションのパス指定方法を他設定に合わせるか
  • stepRtnUse (boolean) — ステップ回転設定を有効にするか（常にtrue）
  • customTitleUse (boolean) — デフォルト曲名表示をカスタム化するか
  • customTitleArrowUse (boolean) — デフォルト背景矢印をカスタム化するか
  • customBackUse (boolean) — デフォルト背景をカスタム化するか
  • customBackMainUse (boolean) — メイン画面のデフォルト背景をカスタム化するか
  • customReadyUse (boolean) — デフォルトReady表示をカスタム化するか

フォント設定

  • customFont (string) * — カスタムフォント名

オブジェクト（矢印）の種類設定

  • imgType (array) — オブジェクト種別の定義リスト 
g_headerObj.imgType[0] = {
    name: ``,            // フォルダ名（空の場合はデフォルト）
    extension: `svg`,    // 拡張子
    rotateEnabled: true, // 画像回転の有無
    flatStepHeight: 50,  // FlatBar時のステップ高さ(px)
    remoteDir: ``,       // リモート取得先ディレクトリ
};
  • titleArrowNo (number) — タイトル背景矢印に使用するimgTypeの番号
  • titleArrowRotate (number) — タイトル背景矢印の回転角度

ウィンドウサイズ設定

  • autoSpread (boolean) — キー数に合わせた横幅自動拡張の有無
  • heightVariable (boolean) — URLパラメータ h による高さ変更の許可

楽曲情報

  • musicTitles (array) — 楽曲ごとの曲名（1行表示用）
  • musicTitlesForView (array2) — 楽曲ごとの曲名（複数行管理用）
  • musicNos (array) — 譜面番号→楽曲番号のマッピング 
// 1・2譜面目は楽曲0、3譜面目は楽曲1
g_headerObj.musicNos = [0, 0, 1];
g_headerObj.musicTitles = [`曲名1`, `曲名2`];
g_headerObj.musicTitlesForView = [[`曲名1`, ``], [`曲名2`, ``]];
  • artistNames (array) — 楽曲ごとのアーティスト名
  • artistUrls (array) — 楽曲ごとのアーティストURL
  • bpms (array) — 楽曲ごとのBPM表示文字列
  • musicTitle (string) — 単一作品用の曲名（musicTitles[0]）
  • musicTitleForView (array) — 単一作品用の複数行曲名（musicTitlesForView[0]）
  • artistName (string) — 単一作品用のアーティスト名
  • artistUrl (string) — 単一作品用のアーティストURL

選曲機能設定

  • packageNames (array) — 選曲機能で使用するパッケージ名（改行区切りで複数行対応）
  • musicSelectUse (boolean) — 選曲機能の利用有無
  • bgmUseFlg (boolean) — 選曲画面でのBGM再生の有無
  • musicGroups (array) — 楽曲グループ化設定（musicGroup ヘッダーから生成）
  • musicIdxList (array) — 楽曲インデックスの一意リスト

難易度配色・カスタムリンク

  • difColorList (array) — 難易度数値に応じた配色定義
g_headerObj.difColorList = [
    { threshold: Infinity, color: `` },   // デフォルト（色なし）
    { threshold: 10, color: `rgb(100, 200, 100)` },
];
  • difCustomLink (array) — 譜面番号ごとの外部リンクURL（difCustomLink ヘッダーから生成）

速度上限・下限

  • minSpeed (float) — 速度設定の最小値
  • maxSpeed (float) — 速度設定の最大値

プレイ中ショートカットキー

  • keyRetry (number) @ — リトライキーのキーコード
  • keyRetryDef (number) — リトライキーのデフォルト値（キーコンフィグ変更前）
  • keyRetryDef2 (number) — リトライキーのデフォルト値（譜面ヘッダー定義値）
  • keyTitleBack (number) @ — タイトルバックキーのキーコード
  • keyTitleBackDef (number) — タイトルバックキーのデフォルト値
  • keyTitleBackDef2 (number) — タイトルバックキーのデフォルト値（譜面ヘッダー定義値）

フリーズアロー許容フレーム数

  • frzAttempt (number) — フリーズアローを離した後の許容フレーム数

制作者クレジット

  • tuning (string) @ — 現在表示中の制作者名
  • tuningInit (string) — 制作者名の初期値
  • tuningNames (array) — 制作者名のリスト（複数制作者対応）
  • tuningUrls (array) — 制作者URLのリスト
  • creatorUrl (string) — 単一作品用の制作者URL（tuningUrls[0]）

譜面ファイル分割設定

  • dosNos (array) — 譜面番号に対応する分割ファイル番号
  • scoreNos (array) — 譜面番号に対応する譜面内番号

譜面情報

  • keyLabels (array) — 譜面ごとのキー数ラベル
  • difLabels (array) — 譜面ごとの難易度名
  • initSpeeds (array) — 譜面ごとの初期速度
  • difficulties (array) — 譜面ごとの難易度数値（difData の3番目の値）
  • lifeBorders (array) — 譜面ごとのクリアボーダー
  • lifeRecoverys (array) — 譜面ごとのゲージ回復量
  • lifeDamages (array) — 譜面ごとのゲージダメージ量
  • lifeInits (array) — 譜面ごとのゲージ初期値
  • creatorNames (array) — 譜面ごとの制作者名
  • viewLists (array) — 選択画面に表示する譜面番号のリスト
  • keyLists (array) — 使用するキー種の重複排除リスト
  • undefinedKeyLists (array) — 未定義のキー種リスト
  • keyExtraList (array) — 追加定義されたキー種リスト
  • difSelectorUse (boolean) — 譜面変更セレクターの利用有無

グラデーション・矢印色設定

  • baseBrightFlg (boolean) — ベース背景が明色かどうか（グラデーションの中間色決定に使用）
  • defaultColorgrd (array) — 自動グラデーションの設定（[有効化フラグ, 中間色]）
  • colorCdPaddingUse (boolean) — カラーコードのゼロパディング有無
  • defaultFrzColorUse (boolean) — フリーズアローのデフォルト色セット利用有無
  • frzScopeFromArrowColors (array) — 矢印色変化追随対象の設定（Normal/Hit）
  • dfColorgrdSet (object) — デフォルトのグラデーション設定セット
g_headerObj.dfColorgrdSet = {
    '':      [false, `#111111`],  // 通常
    'Type0': [true,  `#111111`],  // Type0（グラデ反転）
};
  • setColorInit (array) — 矢印色の初期値リスト
  • setColor (array) @ — グラデーション適用後の矢印色
  • setColorStr (array) — 譜面ヘッダー指定の矢印色文字列
  • setColorOrg (array) — 矢印色から抽出した先頭カラーコード
  • setColorType0 / setColorType1 / setColorType2 / setColorType3 / setColorType4 (array) — ColorTypeごとの矢印色
  • setShadowColorInit (array) — 影矢印色の初期値
  • setShadowColor (array) @ — 現在の影矢印色
  • setShadowColorStr (array) — 譜面ヘッダー指定の影矢印色
  • setShadowColorOrg (array) — 影矢印色から抽出した先頭カラーコード
  • frzColorInit (array) — フリーズアロー色の初期値
  • frzColor (array2) @ — 現在のフリーズアロー色
  • frzColorStr (array2) — 譜面ヘッダー指定のフリーズアロー色
  • frzColorOrg (array2) — フリーズアロー色から抽出した先頭カラーコード
  • frzColorDefault (array2) — フリーズアロー色のデフォルト値
  • frzColorType0 〜 frzColorType4 (array2) — ColorTypeごとのフリーズアロー色
  • frzShadowColorInit (array) — フリーズアロー影色の初期値
  • frzShadowColor (array2) — 現在のフリーズアロー影色
  • setDummyColor (array) — ダミーノート用の矢印色

矢印・フリーズアロー色（譜面番号別・タイプ別）

resetBaseColorList() によって動的に生成される。譜面番号 N に対し N+1 を接頭辞として付与（例: 1譜面目 → setColor1）。初回（スコアID未指定）は接頭辞なし。

各カラーグラデーションタイプ（dfColorgrdSet のキー: "" / "Type0"）に対し以下が生成される。

矢印色（通常・影）:

  • setColor{N}{Type} (array) — グラデーション適用後の矢印色（N: 譜面番号+1, Type: "" or "Type0"）
  • setColorStr{N}{Type} (array) — 元の矢印色文字列
  • setColorOrg{N}{Type} (array) — 先頭カラーコードのみ抽出
  • setColorDefault (array) — 生成時点のデフォルト色（setColor の退避）
  • setShadowColor{N}{Type} / Str / Org (array) — 影矢印色の同様セット
  • setShadowColorDefault (array)

フリーズアロー色（通常・影）:

  • frzColor{N}{Type} (array2) — フリーズアロー色
  • frzColorStr{N}{Type} (array2) — 元のフリーズアロー色文字列
  • frzColorOrg{N}{Type} (array2) — 先頭カラーコードのみ抽出
  • frzColorDefault (array2) — 生成時点のデフォルト色（frzColor の退避）
  • frzShadowColor{N}{Type} / Str / Org (array2) — フリーズアロー影色の同様セット
  • frzShadowColorDefault (array2)
// 例: 2譜面目(scoreId=1)の矢印色（Type0グラデーション適用後）
g_headerObj.setColor2Type0;   // → string[]

// 例: 初回（scoreIdなし）のフリーズアロー色（デフォルト）
g_headerObj.frzColor;         // → string[][]
g_headerObj.frzColorDefault;  // → string[][] (退避値)

注意: {N} は setScoreIdHeader() の返値に依存する。スコア分割(scoreLockFlg)時は dosNos / scoreNos の値が使われる場合がある。カスタムJS側から参照する場合は g_headerObj.setColor (接頭辞なし) が最も確実。

ライフゲージ上限

  • maxLifeVal (float) — ライフゲージの最大値（デフォルト: 1000）

ダミーノート設定

  • dummyScoreNos (array) — ダミーノート割り当て用の譜面番号

音楽再生・タイミング設定

  • blankFrame (number) @ — 現在の無音フレーム数
  • blankFrameDef (number) — 基本となる無音フレーム数（blankFrameDefs[0]）
  • blankFrameDefs (array) — 譜面別の無音フレーム数リスト
  • startFrame (array) — 譜面別の開始フレーム数
  • endFrame (array) — 譜面別の終了フレーム数
  • fadeFrame (array2) — 譜面別のフェードアウトフレーム設定
  • adjustment (array) — 譜面別のタイミング調整値
  • playbackRate (float) — 再生速度倍率

楽曲ファイル設定

  • musicFolder (string) — 楽曲ファイルの格納フォルダ
  • musicUrls (array) — 楽曲ファイルのURLリスト
  • musicStarts (array) — 選曲BGMの再生開始位置（秒）
  • musicEnds (array) — 選曲BGMの再生終了位置（秒）

ハッシュタグ設定

  • hashTag (string) — X(Twitter)投稿用ハッシュタグ

画像・リソースの読込設定

  • autoPreload (boolean) * — 画像の自動プリロードの有無
  • preloadImages (array) — 追加プリロードする画像ファイルのリスト

初期表示・縦伸縮設定

  • keyGroupOrder (array2) — 初期表示する部分キーグループの設定
  • stretchYRate (array) — 譜面別の矢印縦伸縮率

最終演出・作品情報

  • finishView (string) — フルコンボ・パーフェクト演出の表示設定（none で無効）
  • releaseDate (string) — 作品更新日

Ready・リザルト表示設定

  • readyDelayFrame (number) — Ready表示の遅延フレーム数
  • resultDelayFrame (number) — リザルト表示の遅延フレーム数
  • readyAnimationFrame (number) — Readyアニメーションの長さ（フレーム数）
  • readyAnimationName (string) — Readyアニメーション名
  • readyColor (string) — Ready文字の先頭文字色
  • readyHtml (string) — Ready表示を上書きするHTMLテキスト

タイトル表示詳細設定

  • titlesize (string) — デフォルト曲名表示のフォントサイズ指定
  • titlefonts (array) — 曲名表示のフォントリスト（行ごとに指定可）
  • titlegrds (array) — 曲名表示のグラデーション指定
  • titlearrowgrds (array) — 背景矢印のグラデーション指定
  • titlegrd (string) — 曲名グラデーションの先頭値（titlegrds[0]）
  • titlearrowgrd (string) — 背景矢印グラデーションの先頭値
  • titlepos (array2) — 曲名表示の位置調整（行ごとに [x, y] で指定）
  • titlelineheight (number) — 曲名複数行時の縦間隔
  • titleAnimationName (array) — 曲名アニメーション名（行ごと）
  • titleAnimationDuration (array) — 曲名アニメーション時間（秒、行ごと）
  • titleAnimationDelay (array) — 曲名アニメーション遅延（秒、行ごと）
  • titleAnimationTimingFunction (array) — 曲名アニメーションのタイミング関数（行ごと）
  • titleAnimationClass (array) — 曲名アニメーションの追加CSSクラス（行ごと）

判定設定

  • frzStartjdgUse (boolean) — フリーズアロー始点で通常矢印判定を行うか
  • excessiveJdgUse (boolean) — 空押し判定の初期値（excessiveJdgUses[0]）
  • excessiveJdgUses (array) — 譜面別の空押し判定初期設定
  • excessiveUses (array) — 譜面別の空押し設定の有効化フラグ

制作者表示設定

  • makerView (boolean) @ — 譜面名に制作者名を付加するか
  • makerViewOrg (boolean) — makerView の元の設定値（makerView の変更前値）

Display設定（各項目の利用可否・初期値・連動OFF設定）

各Displayオプションについて、以下の3種のプロパティが定義される。

  • XXXXUse (boolean) — ボタンの有効・無効
  • XXXXSet (switch: ON/OFF) — ボタンの初期値
  • XXXXChainOFF (array) — ONからOFFになった際に連動してOFFにする対象名リスト

対象のDisplay項目: stepZone / judgment / lifeGauge / score / musicInfo / filterLine / velocity / color / background / arrowEffect / special

// 設定例
g_headerObj.stepZoneUse = true;              // ボタン有効
g_headerObj.stepZoneSet = `OFF`;             // デフォルトOFF
g_headerObj.stepZoneChainOFF = [`judgment`]; // StepZone OFFで Judgment も連動OFF

その他:

  • arrowEffectUseOrg (boolean) — arrowEffectUse の元の設定値
  • arrowEffectSetFlg (boolean) — arrowEffectSet が ON かどうか

別キーモード設定

  • transKeyUse (boolean) — 別キーパターンの使用有無

背景・マスク・スキン変更設定（タイトル・リザルト）

各アニメーション種別（back/mask/style）について、タイトルとリザルトの両方で以下が定義される。

  • back{Title|Result|Failed}Data (array2) — 背景モーションデータ
  • back{Title|Result|Failed}MaxDepth (number) — 使用する最大深度
  • mask{Title|Result|Failed}Data (array2) — マスクモーションデータ
  • mask{Title|Result|Failed}MaxDepth (number) — 使用する最大深度
  • style{Title|Result|Failed}Data (array2) — スキン変更データ（CSSカスタムプロパティ切替）
  • style{Title|Result|Failed}MaxDepth (number) — 使用する最大深度（常に1） 
// 背景データの構造例（back/mask共通）
g_headerObj.backTitleData[frame][depth] = {
    depth: 2,
    command: `[jump]`,        // [loop] または [jump]
    jumpFrame: `1000:2000`,   // ジャンプ先フレーム（コロン区切りでランダム分岐）
    maxLoop: 4,               // [jump] のループ終了回数
    animationName: `fadeIn`,  // アニメーション名
    htmlText: `<img ...>`,    // 表示するHTML
};
// スキン変更データの構造例
g_headerObj.styleTitleData[frame][0] = {
    depth: `--main-color`,    // CSSカスタムプロパティ名
    styleData: `#ff0000`,     // 設定する値
};
  • masktitleButton (boolean) — タイトルマスクのクリックを有効にするか
  • maskresultButton (boolean) — リザルトマスクのクリックを有効にするか
  • resultMotionSet (boolean) — リザルトモーションをDisplay:BackgroundのON/OFFと連動させるか

判定位置リセット設定

  • jdgPosReset (boolean) — Display:Background OFF時に判定位置をリセットするか

コメント表示設定

  • commentVal (string) — タイトル画面に表示するコメント文
  • commentExternal (boolean) — コメントを外部要素（commentArea）に出力するか

Reverse時の歌詞反転設定

  • wordAutoReverse (string) — Reverse時の歌詞自動反転の制御（auto/ON/OFF）

プレイ画面レイアウト設定

  • playingWidth (number) — プレイエリアの横幅（px）
  • playingHeight (number) — プレイエリアの縦幅（px）
  • playingX (number) — プレイエリアのX座標オフセット
  • playingY (number) — プレイエリアのY座標オフセット
  • customViewWidth (number) — クレジット非表示エリアの横幅（px）
  • scAreaWidth (number) — ショートカット表示用の拡張エリア幅（px）
  • playingLayout (boolean) — ショートカット表示を右側に配置するか
  • justFrames (number) — Fast/Slow判定の基準フレーム数（デバッグ時: 0、通常: 1）

リザルトカスタマイズ設定

  • resultFormat (string) — リザルトテキストのフォーマット文字列
  • resultValsView (array) — リザルト画像に表示するカスタム項目のキーリスト

フェードイン時のデータ蓄積設定

  • unStockCategories (array) — フェードイン時にそれ以前のデータを蓄積しない種別（word/back/mask等）

© 2018 ティックル & Contributors.

⚠️ **GitHub.com Fallback** ⚠️