なぜ ASEPRITE を JSON に変換するのですか？
Phaser、PixiJS、Unity などのゲームエンジンやフレームワークは、画像だけでなく、フレームの座標やアニメーションのメタデータを必要とします。.json にエクスポートすることで、付属のスプライトシート内の各フレームとタグをマッピングした、マシン読み取り可能なアトラスが提供されます。これが PNG とデータファイルがペアになる理由です。
ASEPRITE から JSON への変換方法
Export Sprite Sheet ダイアログ EASIEST
«File > Export > Export Sprite Sheet» を選択し、«JSON Data» チェックボックスを有効にして、データファイル名を選択します。Aseprite はシートの PNG と .json アトラスを書き出します。
Aseprite CLI
ヘッドレスでアトラスを生成するには、aseprite -b sprite.aseprite --sheet sheet.png --data sheet.json --format json-hash を実行します。順序付きリストが必要な場合は --format json-array を使用します。
Aseprite CLI から標準出力へ
スクリプト作成やビルドステップへのパイプ処理のために、JSON をコンソールに直接出力するには aseprite -b --data="" sprite.aseprite を使用します。
これらの形式について
An .aseprite file is the native project format of Aseprite, an animated sprite editor and pixel art tool. It keeps a sprite's full editable state including layers, frames, palette, tags and…
.ASEPRITE の詳細を開く →
.JSON
JavaScript Object Notation file
JSON ファイルは JavaScript Object Notation 形式のプレーンテキストデータファイルで、ウェブ API、アプリの設定、データのエクスポートに使用されます。Windows のメモ帳や Mac の TextEdit など、あらゆるテキストエディタで開くことができますが、本格的な作業には VS Code や Notepad++…
.JSON の詳細を開く →品質と注意点
- JSON にはピクセルデータは含まれていません。フレームを記述しているだけなので、エクスポートされたシートの PNG を常に一緒に保持する必要があります。
- «--format» の選択は重要です。
json-hashはフレームをファイル名でキー指定し、json-arrayは順序付きリストを提供します。エンジンがどちらを期待しているか確認してください。 - タグ、スライス、持続時間のメタデータは、スプライトで実際に定義されている場合にのみ含まれます。
よくある質問
JSON に画像データは含まれますか？
json-hash と json-array の違いは何ですか？
json-hash は各フレームをファイル名でキー指定します。json-array は順序付きリストを返します。エンジンのローダーが期待する方を選択してください。アプリを開かずにこれを自動化できますか？
-b バッチフラグと --sheet および --data を使用すると、ビルドスクリプト内でヘッドレスに実行できます。
