Asepriteユーザー向け
Asepriteスプライトシート展開
Asepriteからスプライトシート画像とJSONデータを書き出してください。このツールは、切り抜いた各フレームを元のキャンバスサイズに復元します。
例：sheet.png + sheet.json → フルサイズのフレームPNG
このツールを試す- 1. 追加Asepriteの画像 + JSON
- 2. 調整フレームの位置を復元
- 3. 保存ZIPに入ったフルサイズPNG
1. Asepriteから書き出した2つのファイルを追加
Asepriteで、JSONデータ付きのスプライトシートを書き出してください。同じ書き出しの画像とJSONを選びます。
使い方
1. 画像とJSONを一緒に書き出す
AsepriteでJSONメタデータ付きのスプライトシートを書き出し、その書き出しの両方のファイルを保持してください。このツールが読むのは、JSONの配列またはハッシュデータ付きのPNG・WebPシートであり、ネイティブの.ase・.asepriteプロジェクトではありません。
2. 対応する組み合わせを読み込む
A. 画像シートとB. 対応するJSONデータを選び、復元してください。インポーターはmeta.sizeと、すべての切り抜き・オフセットを確認します。シートを再配置またはリサイズした後に、古いJSONを再利用しないでください。
3. 復元した連続フレームを確認して保存
フレームスライダーと再生プレビューで位置合わせを確認します。各切り抜きは、spriteSourceSizeのオフセットを使い、sourceSizeのキャンバスに配置されます。ZIPをダウンロードし、名前、時間、フレームタグのためmanifest.jsonを残してください。
3つの矩形で、トリミング済みスプライトが跳ぶ理由を説明
frameはパッキング済みシート内のピクセル位置です。xとyはアトラス座標であり、元のキャラクター位置ではありません。sourceSizeは元キャンバスの寸法、spriteSourceSizeはその中の切り抜き位置です。
64 × 64のポーズを22 × 38にトリミングすると、シート内では(128, 0)に配置されても、元のフレーム内の位置は(19, 20)かもしれません。復元では、透明な64 × 64のキャンバスを作り、その22 × 38の矩形をコピーして(19, 20)に配置します。(0, 0)に描画すると、キャラクターの位置が動いてしまいます。
復元は、元のフレーム内の意図した動きを元に戻したり、新しいピボットを作ったりしません。タグと表示時間はマニフェストに保持しますが、受け取り側が使う必要があります。均一FPSの再生では、不均等な停止を自動保持しません。
| 設定または入力 | 意味 |
|---|---|
| frame: 128, 0, 22, 38 | シートからこの矩形を読み取る |
| spriteSourceSize: 19, 20, 22, 38 | 切り抜きを(19, 20)へ配置 |
| sourceSize: 64 × 64 | キャンバス全体のPNGを書き出す |
| duration: 100 | Retain 100 ms in manifest.json |
ダウンロード前に確認
寸法が一致しても、配置の一致は証明されません
2つの出力は同じ寸法でも配置が異なる場合があります。見分けやすい最初・最後のポーズを確認し、同じ書き出しで作ったファイルを使ってください。
対応する書き出し形式を使う
回転フレームは非対応です。上限：JSON 2 MB、画像20 MB、100フレーム、シート各辺4096 px、シート1600万ピクセル、復元フレーム各辺1024 px、復元ピクセル合計2000万。
質問
Asepriteのネイティブ形式のプロジェクトをアップロードできますか？
いいえ。先にシートとJSONを書き出してください。編集可能なレイヤー、セル、ネイティブのプロジェクト構造は読み込みません。
回転して詰めたフレームが拒否されるのはなぜですか？
このインポーターは回転していない切り抜きに対応します。回転なしで再出力してください。JSONのrotatedをfalseにしても修復にはならず、保存ピクセルを誤って解釈します。
PNGがパッキング済みの切り抜きより大きいのはなぜですか？
各フレームは元のsourceSizeキャンバスと透明な余白を使い、ポーズの位置合わせを保ちます。テクスチャをコンパクトに保存することが目的なら、パック済みアトラスを保持してください。
ZIPは時間情報を保持しますか？
表示時間と有効なフレームタグはmanifest.jsonにあります。PNGファイルだけには再生の時間情報はありません。受け取り側のエディターやエンジンで、メタデータを取り込むか再現してください。
寸法エラーの後は何をすべきですか？
meta.sizeを画像と比較し、書き出し後にリサイズや再配置をしていないか確認してください。検証を回避するためにメタデータを変えるのではなく、両方のファイルを一緒に再生成してください。
関連ツールとチュートリアル
Asepriteのトリミング済みフレームを復元 — オフセットの例を参考にし、動く基準線を診断してください。
スプライトシートアニメーター — 不均等な表示時間が不要なら、復元したフレームを一定FPSで確認します。
Asepriteの書き出しドキュメント — 対応するシートとデータを生成するため、エディターの手順を読んでください。