SJSON データ形式について

多くの Stingray リソースファイルは、広く使用されている JSON 規格に基づく、データの読み込み、編集、保持を簡単に行えるようにするためのカスタムの拡張と単純化をいくつか取り入れた、テキストベースの形式でデータを表します。この形式は、よく SJSON (単純化 JSON)と呼ばれます。

リソースファイルの多くのタイプは Stingray 編集ツールによって自動的に作成されて最新の状態に保たれますが、手動で変更する必要があるデータファイルの種類がいくつかあります。たとえば、ゲームで使用される物理シミュレーション用のさまざまなタイプの衝突マテリアルを設定するには、プロジェクトの global.physics_properties ファイルに直接変更を加える必要があります。

例

ゲームの settings.ini ファイルからの次の例は、SJSON の小さなブロックがどのようなものかを示しています。

// The script that should be started when the application runs.
boot_script = "boot"

// The port on which the console server runs.
console_port = 14030

// Settings for the win32 platform
win32 = {

    /* Sets the affinity mask for
       QueryPerformanceCounter() */
    query_performance_counter_affinity_mask = 0

}

render_config = "core/rendering/renderer"

より大きな例については、任意のプロジェクトの settings.ini、.physics_properties、.shading_environment ファイルで確認できます。

注: Script Editor を使用して、プロジェクト内の Stingray データリソースファイルを開いて編集することができます。

標準 JSON からの変更

SJSON 形式には、次のような標準 JSON との違いがあります。

コロン : の代わりに、等号 = がキー値のペアを定義するために使用されます。
キーにスペースまたは等号 = を含める必要がない限り、キー値のペアの文字列キーを囲う引用符はオプションです。
オブジェクトと配列の定義のコンマはオプションです。
C および C++ のコメントスタイルを使用して、コメントを使用できます。
- //は、行の最後までがすべて無視される単一行のコメントを開始します。
- /* ... */は、アスタリスクの間がすべて無視される複数行のコメントを作成します。
各 SJSON ファイルは、常に単一のオブジェクトの定義として解釈されます。これは、ファイルの内容を囲う波括弧 { ... } の暗黙的なセットとして考えることができます。

JSON を使用する

このように柔軟性が追加されていますが、SJSON パーサは標準の JSON と互換性があります。標準の JSON ファイルを SJSON パーサに対する入力として使用できます。これは、Stingray で使用されるデータを生成するためのカスタムツールを作成する場合、ツールでは標準 JSON を書き出せることを意味します。

注意すべき例外

次のようなデータファイルのいくつかのタイプは、SJSON を使用しません。

スクリプト。これは標準 Lua ファイルです。
ローテクスチャデータ。これは圧縮されていない .dds ファイルです。
読み込まれた .fbx アセット。
Stingray2D リソースファイル。フォントやイメージなどの項目が含まれている場合があります。

Github でこのページを編集