ゴースト

GPXファイルを ゴースト として、マップ上に表示します。メイン画面のデータを ベース と呼びます。ゴーストとベースとの比較データはゴーストHUDに表示できます。

ゴーストはGPXの愉しみ方の1つで、データを詳細に分析するなどの本気モード用ではありません。

ゴーストとは

ゴースト用のGPXファイルを読み込み、ベースを基準にゴーストデータを生成します。ゴーストは、ベースの現在位置に対応するゴースト側の位置を計算して表示します。

ゴーストGPXに日時データがない場合は、ゴーストを生成できません。

ゴーストの生成ロジック

ゴーストは、ベースに対して、 同じ経過時間でどこまで移動したか を、ゴーストGPXから計算し、想定位置を表示します。

ベースがスタートから t 秒後にいる
↓
ゴースト側の t 秒後の位置を求める
↓
その位置にゴーストカーソルを表示する

マルチゴースト

複数のGPXファイルをゴーストとして読み込み、同時に表示します。マルチゴーストは Ghost JSON で指定します。



Ghost JSON は、複数のゴーストGPXと表示設定をまとめるためのJSONファイルです。ベースは現在開いているGPXです。Ghost JSON には、ゴーストGPXを指定します。

Ghost JSON の主な項目

Ghost JSON仕様

Ghosts に指定した順番が、基本的なゴースト番号になります。順番を変更したい場合は、JSON内の並び順を変更してください。

Enabled=false のゴーストは生成されません。HUD上の G1, G2 は、有効なゴーストの表示順として扱われます。

各ゴーストには、カーソル画像フォルダ、不透明度、カーソル表示、トラック表示を個別に指定できます。

省略時の動作

CursorOpacity は 0 から 255 の範囲で指定します。0は完全に透明、255は完全に不透明です。

注意事項

• ゴーストGPXには日時データが必要です
• 有効なゴーストが1つもない場合、ゴーストは生成されません
• 指定したGPXファイルが存在しない場合、ゴーストは生成できません
• 10個目以降のゴーストは読み込まれません
• ゴースト番号はJSON内の順番で決まります
• Enabled=false のゴーストは番号表示の対象外になります

スタートとゴール

スタートとゴールの設定には2つの方法があります。

全データ方式

ベースデータの先頭がスタート、末尾がゴールになります。それに合わせて、不要なポイントを削除して、データを調整します。

GPXの先頭をそのまま開始点として使いたい場合は、Use Raw Start をONにします。

ライン方式

マップ上で任意の2点を設定し、ラインを引きます。ライン上を交差した点をスタート/エンド(ゴール)地点とします。検出したスタート/エンド地点のインデックスが表示されます。

🚩でラインの1点目を設定します。クリック後に2点目を設定し、ラインが引かれます。クリアボタンでラインをクリアします。オプションの Start Pin / End Pin が使用されます。

ラインはインデックスを決めるためのものです。ゴーストデータがクリアされてもラインは残ります。ラインをクリアしたいときはクリアボタンを押してください。

Ghost JSON の StartLine / EndLine

Ghost JSON では、Settings 内に StartLine と EndLine を指定できます。

StartLine はスタート判定用ラインです。EndLine はエンド判定用ラインです。

"Settings": {
  "StartLine": {
    "Enabled": true,
    "P1": {
      "Lat": 35.6810000,
      "Lon": 139.7660000
    },
    "P2": {
      "Lat": 35.6820000,
      "Lon": 139.7670000
    }
  },
  "EndLine": {
    "Enabled": true,
    "P1": {
      "Lat": 35.6815000,
      "Lon": 139.7665000
    },
    "P2": {
      "Lat": 35.6825000,
      "Lon": 139.7675000
    }
  }
}

オプション

全データ方式でGPXの先頭をそのまま開始点にしたい場合は、Use Raw Start = ON を使用します。

ライン方式で検出した開始位置を使う場合は、Use Raw Start = OFF を使用します。

マップ表示

ゴーストのカーソルとトラックが表示されます。

Cursor用のフォルダを指定します。内容はオプションの Cursor Pin と同じです。

UI設定とJSON設定の関係

UI側のチェックは全ゴーストに影響します。

一方、CursorOpacity は各ゴーストの個別設定です。マルチゴーストでは、ゴーストごとに異なる不透明度を指定できます。

ゴーストHUD

ゴーストの各種情報を表示します。

TDIF

TDIF は、ベースとゴーストの同距離地点における時間差です。

TDIF = ゴーストが同距離へ到達した経過時間 - ベースの経過時間

TDIF が正の場合、ゴーストの方が同距離地点への到達が遅いことを示します。つまり、ベースがゴーストより先行している状態です。

ベースがゴールした時点のTDIFが、最終的なタイム差の目安になります。

ゴーストカーソルは「同じ時間でどこにいるか」を表示し、TDIF は「同じ距離に何秒差で到達したか」を表示します。

マルチゴーストHUD

マルチゴーストでは、HUDにゴースト番号が付きます。

TDIF G1 +12.34 s
     G2 -03.21 s

G1, G2 は、有効なゴーストの表示順を示します。

マルチゴーストHUDの表示項目

マルチゴーストHUDでは、指定されたHUD項目をすべて並べるのではなく、優先順位が最も高い1項目だけをゴースト数分表示します。

マルチゴーストで TDIF を表示したい場合は、Ghost JSON の Items に TDIF だけを指定するのが安全です。

"Hud": {
  "Position": "TopRight",
  "Items": [
    "TDIF"
  ]
}

HUD項目の優先順

HUD項目の表示順は、Ghost JSON の Items に書いた順番ではありません。内部の固定順で扱われます。

1. LATI
2. LONG
3. ELEV
4. SPED
5. DIST
6. HEAD
7. TYPE
8. EDIF
9. SDIF
10. TDIF
11. DDIF
12. PDIF
13. DST
14. TIM

例えば、次のように指定した場合、マルチゴーストHUDでは TDIF ではなく SPED が表示対象になります。

"Items": [
  "TDIF",
  "SPED"
]

これは SPED の方が優先順が上のためです。

Ghost JSON例

1ゴースト

{
  "FileType": "TurboGPX.Ghost",
  "Version": 1,
  "Settings": {
    "UseRawStart": false,
    "InterpolateCrossing": false,
    "Hud": {
      "Position": "TopRight",
      "Items": [
        "TDIF"
      ]
    }
  },
  "Ghosts": [
    {
      "Enabled": true,
      "GpxFileName": "C:\\GPX\\ghost01.gpx",
      "CursorFolder": "C:\\Turbo GPX\\image\\ghost\\ghost01",
      "CursorOpacity": 255,
      "ShowCursor": true,
      "ShowTrack": true
    }
  ]
}

マルチゴースト

{
  "FileType": "TurboGPX.Ghost",
  "Version": 1,
  "Settings": {
    "UseRawStart": false,
    "InterpolateCrossing": false,
    "Hud": {
      "Position": "TopRight",
      "Items": [
        "TDIF"
      ]
    }
  },
  "Ghosts": [
    {
      "Enabled": true,
      "GpxFileName": "C:\\GPX\\ghost01.gpx",
      "CursorFolder": "C:\\Turbo GPX\\image\\ghost\\ghost01",
      "CursorOpacity": 255,
      "ShowCursor": true,
      "ShowTrack": true
    },
    {
      "Enabled": true,
      "GpxFileName": "C:\\GPX\\ghost02.gpx",
      "CursorFolder": "C:\\Turbo GPX\\image\\ghost\\ghost02",
      "CursorOpacity": 192,
      "ShowCursor": true,
      "ShowTrack": true
    },
    {
      "Enabled": false,
      "GpxFileName": "C:\\GPX\\ghost03.gpx",
      "CursorFolder": "C:\\Turbo GPX\\image\\ghost\\ghost03",
      "CursorOpacity": 128,
      "ShowCursor": true,
      "ShowTrack": true
    }
  ]
}

この例では、Ghost #1 と Ghost #2 が有効です。Ghost #3 は Enabled=false のため生成されません。

GPXデータに関する注意

ゴーストの精度は、GPXデータの品質に依存します。

正確に比較したい場合は、ベースGPXとゴーストGPXのスタート位置、ゴール位置、コース形状をできるだけ揃えてください。