書き出し形式を選ぶ
動画、PNG連番、JSON付きスプライトシート、エンジン向けパックの内容と透過・利用権限の条件を比較します。
このページの目次
利用先から選ぶ
まず結果を確認するならPNGフレームのZIP、独自のゲーム実装ならスプライトシートと対応するJSON、ゲームエンジンに取り込むならそのエンジン用パックを選び、同梱の説明を読んでください。
Webの書き出し画面は最初にPNGフレームZIPを選びます。一方、ワンステップPublic APIでoutput_formatsを省略すると、既定はspritesheetです。特定のファイルが必要な連携では、形式を明示してください。
形式一覧
| API形式 | 受け取るもの | 主な用途 |
|---|---|---|
clip_video |
選択した不透明のMP4動画 | 確認、通常の動画再生 |
webm_alpha |
Alpha付きWebM | 対応する透過動画プレーヤー。利用先で動作確認が必要 |
prores_4444 |
Alpha付きProRes 4444 | 合成、動画編集 |
gif |
アニメーション GIF、透過も選択可 | 短いアニメーションの共有 |
frames_zip |
PNGフレームのZIP | 個別フレームの確認、独自の取り込み |
spritesheet |
PNGテクスチャーアトラス | 1枚にまとめたスプライト画像 |
spritesheet_json |
対応するフレーム情報 | フレームの矩形とタイミング |
unity_meta |
Unity用のテクスチャーメタデータ | 対応するスプライトシートと一緒に使用 |
unity_pack |
Unity向けZIP | アトラス、メタデータ、JSON、マニフェスト、説明 |
godot_pack |
Godot 4向けZIP | SpriteFramesとAnimatedSprite2D素材 |
unreal_paper2d_pack |
Unreal Paper2D向けZIP | PNGアトラスとPaper2Dスプライト情報 |
cocos_creator_pack |
Cocos Creator 3.x向けZIP | PNG/PLISTアトラスとプレーヤー例 |
construct3_pack |
Construct 3 アニメーション読み込みパック | PNG フレーム、ネイティブ読み込み設定、参照アトラス、手順 |
Construct 3 では外側のパックを展開し、Sprite アニメーションエディター上部の Load animations から内部の animation.zip を読み込みます。設定には順序、FPS、ループ、原点が含まれます。画像、再生確認、r495.2 の右クリック取り込みに関する注意は Construct 3 ガイドを参照するか、サンプルをダウンロードしてください。これは .c3p プロジェクトやアドオンではありません。
メタデータ形式だけでは画像になりません。対応するテクスチャーも取得してください。返却されたoutputsを実際の成果物一覧として扱い、配列の位置や拡張子を決め打ちしないでください。
透過は元素材と形式の両方で決まる
通常のMP4と生成された元動画は不透明です。透明なPNG、アトラス、エンジン素材、WebM Alpha、ProRes 4444には、適切な元素材と書き出し設定が必要です。
Public APIの透過はAlpha Key素材だけをサポートします。任意の背景を自動で除去する機能ではありません。透過アニメーションも参照してください。
ファイルにAlphaがあっても、再生側が無視する場合があります。利用先で確認し、表示側の問題と書き出しの問題を切り分けるにはPNGフレームや対応エディターを使ってください。
エンジン向けパックは構造を保って取り込む
エンジン用ZIPにはanimgen-manifest.jsonと説明が入っています。相対パスを維持してください。Godotの素材はパック内のパスを参照し、Unreal Paper2Dの取り込みには該当するエンジン側ツールが必要です。
マニフェストのフレーム矩形は左上原点、正規化されたピボット座標は左下原点です。テクスチャーの大きさから推測せず、マニフェストを確認してください。ゲーム全体に組み込む前に小さなテストシーンで順番、速度、スケール、ピボット、透過を確かめます。
クレジット、利用権限、ダウンロード
無料のWeb利用にはGIFとPNGフレームZIPが含まれます。高度な形式には有料の書き出し権限が必要です。クレジット残高と形式の利用権限は別々に確認されます。クレジットと利用権限をご覧ください。
ファイルは短期間有効な署名付きダウンロードリンクから取得します。URLではなくファイル本体を保存してください。APIからの取得はポーリングとダウンロードを参照してください。
エンジンへの取り込みを完了する
Unity、Godot 4、Unreal Paper2D、Cocos Creator 3の手順へ進んでください。各ガイドは実際のパック内容とパス、再生補助に対応しますが、すべてのエンジンでの実行試験を保証するものではありません。
Construct 3 については、r495.2 で検証したサンプル付きの取り込みガイドを参照してください。
位置合わせはキャンバスとピボット、透過動画の合成は形式の互換性を参照してください。
Alphaに対応する一般的な三つの書き出し形式は、実測したWebM Alpha、ProRes 4444、PNG連番の比較で比較できます。2Dゲーム向けには、同じ96フレームのファイル容量、展開後のRGBAサイズ、メタデータ、最大テクスチャー寸法を比べたスプライトシートとPNG連番の比較もあります。
GIF の書き出し
無料アカウントで GIF と PNG連番 ZIP を書き出せます。書き出し画面で GIF を選択すると、Studio と Advanced Editor の編集済みフレームが使われます。Studio はループ再生、Advanced Editor はループ設定を保持します。完了後にジョブを選ぶと GIF とファイルサイズを確認できます。
GIF は最大256色で、半透明には対応しません。柔らかい影や光の表現が変わる場合があります。フレーム時間は10ミリ秒単位に丸め、合計時間もその精度で保持します。最大50 FPSです。サイズ、FPS、区間を小さくすると容量を減らせます。AI生成と有料マッティングは既存の見積もりに従い、GIF変換自体は追加クレジット不要です。商用利用権は別途必要です。
Public API/MCP は output_formats: ["gif"] と frame_count を指定します。独立した fps モードは引き続きスプライトシートとJSON専用です。GIF は選択区間とフレーム数で再生します。
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー