Turbo GPX | Ghost JSON | wastegate software

ゴーストGPXとゴースト表示設定をJSONファイルで定義できます。

概要

JSONファイルで定義します
1つのJSONファイルが1つのゴースト設定になります
複数のGPXファイルをゴーストとしてまとめて読み込めます
基準GPXは現在開いているGPXです
ゴーストは最大9個まで読み込めます

ファイル形式

項目	内容
形式	JSON
文字コード	UTF-8(BOMなし)
キー名	大文字/小文字を区別なし

ルート構造 - JSONのキー(トップレベル)

項目	型	必須	内容
FileType	String	○	ファイル種別識別子
Version	Integer	○	フォーマットバージョン
Settings	Object	-	ゴースト共通設定
Ghosts	Array	○	ゴーストGPX定義配列

各項目仕様

項目	型	必須	値 / 内容	省略時
FileType	String	○	`"TurboGPX.Ghost"`	-
Version	Integer	○	`1`	-
Settings	Object	-	ゴースト共通設定	既定値を使用
Ghosts	Array	○	ゴーストGPX定義の配列	-

Settings要素仕様

Settings は Object です。

項目	型	必須	内容	省略時
UseRawStart	Boolean	-	ゴーストGPXの先頭を開始基準として扱う	`false`
InterpolateCrossing	Boolean	-	ライン交点補間を使用する	`false`
Hud	Object	-	Ghost HUD設定	HUD項目なし
StartLine	Object	-	スタートライン設定	無効
EndLine	Object	-	エンドライン設定	無効

Hud要素仕様

Hud は Settings の中に定義します。

項目	型	必須	内容	省略時
Position	String / Integer	-	Ghost HUDの表示位置	現在のUI設定を維持
Items	Array	-	Ghost HUDに表示する項目	表示項目なし

Position

値	内容
`"TopLeft"`	左上
`"BottomLeft"`	左下
`"TopRight"`	右上
`"BottomRight"`	右下

Items

項目	内容
`LATI`	ゴースト緯度
`LONG`	ゴースト経度
`ELEV`	ゴースト標高
`SPED`	ゴースト速度
`DIST`	ゴースト距離
`HEAD`	ゴースト方角
`TYPE`	データ種別
`EDIF`	標高差
`SDIF`	速度差
`TDIF`	時間差
`DDIF`	距離差
`PDIF`	位置差
`DST`	残距離
`DSTB`	基準GPX残距離
`DSTG`	ゴーストGPX残距離
`DSTB/G`	基準GPX/ゴーストGPX残距離
`TIM`	残時間
`TIMB`	基準GPX残時間
`TIMG`	ゴーストGPX残時間
`TIMB/G`	基準GPX/ゴーストGPX残時間

Hudの注意事項

Items に不明な項目がある場合は無視されます
Items を省略した場合、Ghost HUDの表示項目はなしになります
マルチゴースト時は、選択されたHUD項目のうち先頭の1項目をマルチ表示します

StartLine / EndLine要素仕様

StartLine と EndLine は Settings の中に定義します。

項目	型	必須	内容	省略時
Enabled	Boolean	-	ラインを有効にする	`false`
P1	Object	Enabled=true時 ○	ライン始点	-
P2	Object	Enabled=true時 ○	ライン終点	-

P1 / P2要素仕様

P1 と P2 は Object です。

項目	型	必須	内容
Lat	Number	○	緯度
Lon	Number	○	経度

StartLine / EndLineの注意事項

Enabled が false の場合、そのラインは無効になります
Enabled を省略した場合、そのラインは無効になります
Enabled が true の場合、P1 と P2 が必要です
P1.Lat、P1.Lon、P2.Lat、P2.Lon が必要です
EndLine はTurbo GPX上のゴールラインとして扱われます

Ghosts要素仕様

Ghosts の各要素は Object です。

項目	型	必須	内容	省略時
Enabled	Boolean	-	このゴーストを使用する	`true`
GpxFileName	String	Enabled=true時 ○	ゴーストGPXファイルの絶対パス	空文字
CursorFolder	String	-	ゴーストマーカー画像フォルダ	空文字
CursorOpacity	Integer	-	ゴーストマーカー透明度	`128`
ShowCursor	Boolean	-	ゴーストマーカーを表示する	`false`
ShowTrack	Boolean	-	ゴーストトラックを表示する	`false`

GpxFileName

GpxFileName には、ゴーストとして使用するGPXファイルを指定します。

条件	内容
パス形式	絶対パスのみ
相対パス	使用不可
ファイル名のみ	使用不可
ファイル存在確認	読み込み時に確認されます

Windowsパスでは \ を \\ として記述します。

例:

"C:\\Users\\user\\Documents\\ghost_01.gpx"

サンプル

{
  "FileType": "TurboGPX.Ghost",
  "Version": 1,
  "Settings": {
    "UseRawStart": false,
    "InterpolateCrossing": false,
    "Hud": {
      "Position": "RightTop",
      "Items": [
        "PDIF",
        "DDIF",
        "TDIF"
      ]
    },
    "StartLine": {
      "Enabled": true,
      "P1": {
        "Lat": 35.681236,
        "Lon": 139.767125
      },
      "P2": {
        "Lat": 35.681500,
        "Lon": 139.767500
      }
    },
    "EndLine": {
      "Enabled": true,
      "P1": {
        "Lat": 35.682000,
        "Lon": 139.768000
      },
      "P2": {
        "Lat": 35.682300,
        "Lon": 139.768300
      }
    }
  },
  "Ghosts": [
    {
      "Enabled": true,
      "GpxFileName": "C:\\Users\\wgs\\gpx\\ghost_01.gpx",
      "CursorFolder": "C:\\Users\\wgs\\gpx\\pins\\ghost_blue",
      "CursorOpacity": 128,
      "ShowCursor": true,
      "ShowTrack": true
    },
    {
      "Enabled": true,
      "GpxFileName": "C:\\Users\\wgs\\gpx\\ghost_02.gpx",
      "CursorFolder": "C:\\Users\\wgs\\gpx\\pins\\ghost_red",
      "CursorOpacity": 128,
      "ShowCursor": true,
      "ShowTrack": true
    }
  ]
}

ゴーストJSON

概要