sprite-gen

Sprite Gen

生成の開始点は、スプライトの作成、画像の作成、または静止画から動画へのアニメーション化です。既存の生成、抽出、エクスポートのツールが処理を行い、ユーザーが結果とプロバイダーを選択します。背景を繰り返す、影を投影する、動きを確認する、またはシーンを構成する場合は、既存のアセットを使って以下の独立したルートを直接利用してください。

すべての生成リクエストはここから開始します

単独の動画クリップを作成する場合は、video を読み、sprite-gen video を使用してください。 このルートはどのエージェントエンジンからでも利用でき、検証済みの MP4 とレポートを出力します。 スプライトまたは通常の画像の場合は、以下のガイドを使用してください。

user-workflow を読み、次に適切な読み取り専用ガイドを実行してください。

$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind sprite
$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind image

リクエスト内ですでに指定されている選択肢を渡してください。ガイドはアクセスを確認し、明示された選択肢と保存済みのデフォルトを組み合わせ、不足している質問のみを返します。開始と終了の各段階に従ってください。生成ツールには、解決済みのプロバイダーを必ず明示的に渡してください。確認済みのファイルを渡してから、整理用の表示を提示してください。デフォルトの保存は、ユーザーが同意した場合に限ります。会話と設定に関する完全な規約はリンク先のドキュメントで定義されており、個々のパイプラインのドキュメントには重複して記載しません。

横向きの向き

横向きの静止画、キャンバスへの配置、モーションプロンプトの向きを同じ方向に保ってください。 video-set はキャンバス配置の前に各横向き入力を一度だけ観察し、キャンバスとクリッププロンプトの両方に指定された --facing を使用します。観察結果はデフォルトでは記録のみで、要求された向きを変更することはありません。画像の修正には明示的なオプトインが必要です。

コマンドオプション	値とデフォルト	動作
gen --facing	preserve（デフォルト）、right、left	--ref を指定した場合、明示的な方向によってプロンプトに要件が追加され、生成された静止画がチェックされます。
gen --facing-fix	none（デフォルト）、mirror、regen	修正せずに記録します。観察された逆向きの画像のミラーリング、または一度だけ再生成して再確認する処理は、オプトインした場合に行われます。再生成後も静止画が逆向きの場合はミラーリングされます。
video --direction	side、front、back、front_diagonal、back_diagonal。デフォルトでは未設定	side を指定すると、向きの確認とそれに対応するプロンプト要件が有効になり、その他の値ではスキップされます。2つの斜め向きは右を向いた3/4ビュー（VIEW_TEXT）です。この向きで歩行または走行する場合は、最終フレームを固定して撮影します（pins_last_frame）。
video --facing、video-set --facing	right（デフォルト）、left	必須の横向きの方向です。
video --facing-fix、video-set --facing-fix	none（デフォルト）、mirror	観察結果を記録します。観察された逆向きの画像をコピー内でミラーリングするには、オプトインしてください。バッチでの横向き確認はデフォルトで有効です。

方向は生成プロンプトとモーションプロンプトで指定しますが、モデルが従うことは保証できません。 検出器は信頼度が高くても誤る場合があります。mirror または regen を選ぶ前に静止画を確認してください。 生成レポートには、方向、モデル、要求された方向、モデルが報告した信頼度、修正内容が extra.facing に記録されます。動画レポートとバッチ項目では facing が使用されます。final_direction は観察結果、またはその結果から導出された値であり、独立した検証ではありません。final_direction_source はその出所を示します。不確かな場合や確認に失敗した場合は、理由とともに unknown が記録され、修正せずに処理が続行されます。正面向きの観察結果も変更されません。ミラーリングしても、アクセサリーの左右の向きは保持されません。

実行経路

タスク	エントリーポイント	仕様
GPT 画像スプライト	prepare、gen-set --provider codex、extract、合成と QA	atlas-workflow
単独動画／静止画のアニメーション化、最終フレームの固定、参照画像	video（--image、--last-frame、--reference）	video
既存クリップの続行または編集	video-extend、video-edit	video
Grok 動画スプライト	video-set	video-pipeline
通常の画像生成または編集	gen --provider codex または gen --provider grok（サブスクリプション経由）	gen
ログインできない環境での画像生成（サーバー、コンテナー、SaaS）	gen --provider openai — OPENAI_API_KEY を使用するサーバー／SaaS 経由の方法です。呼び出しごとに課金され、デフォルトにもフォールバックにもなりません	gen
ベースアンカーと方向アンカー	anchor	directional-anchor-workflow
キュレーションビューまたは既存の画像候補	curation、unpack-atlas --pngs-dir	curation
背景の一括削除またはインポートしたシート	cutout、slice-sheet	sheet-slicing
パレットの置き換え	sprite-gen recolor-palette、sprite-gen recolor	recolor
リグレイヤーの合成	sprite-gen compose-layers	layer-tracks
待機時の呼吸動作	キュレーションで選択し、合成時に焼き込み	breathing
エンジン向けエクスポート	export-aseprite、export-pngs	engine-export
背景レシピまたは繰り返しタイル	既存の gen／cutout の後、必要に応じて background-tile	asset-tools
単独の投影シャドウ	shadow	asset-tools
重複ポーズ、足の接地、歩幅の計測	inspect-motion	asset-tools
シーンの配置、ライティング、カメラ、レンダリング（任意）	scene-render、scene-inspect	scene
デフォルト設定	defaults show、defaults save、defaults clear	user-workflow

背景削除、抽出、位置合わせ、エクスポートには、既存の自動パイプラインステージを使用してください。ユーザーに各スクリプトの選択を求めないでください。ユーティリティを直接指定された場合は、そのユーティリティを実行してください。関係のない生成に関する質問は不要です。画像スプライトでは、行単位のパイプラインとコンポーネント抽出を維持してください。一度のグリッド生成と固定セルの切り出しは、別のスプライト生成方法ではありません。

攻撃の反復カバレッジ、一度の呼び出しで観測された戻り値、構造化されたループ失敗レポートについては、video-pipeline に従ってください。

シーン作成では完成したアセットを使用し、引き続き任意の作業とします。アセットのメタデータでは、フレーム、ネイティブの長さ、アンカーを管理します。シーン仕様では、配置、スケール、再生速度、平面、カメラ、ライトを管理します。歩幅の計測は、同じ足が接地すると明示され、足の ROI が分離されている場合に限って行ってください。接地状態が不明な場合は未検証のままにしてください。選択したアセットそのものについて、シーンの方向が明示された検証済みレポートのみを適用してください。シルエットの最下部から歩行方向を推測したり、フレームを逆順にしたり、シーンに合わせるためにソースアセットを変更したりしないでください。

実行インタープリター

SPRITE_GEN_ROOT は、インストール済みリポジトリの絶対パスです。$SPRITE_GEN_ROOT/.venv/bin/sprite-gen または $SPRITE_GEN_ROOT/.venv/bin/python を使用してください。有効化済みのシェルを前提にしないでください。フォールバックは禁止です。venv がない場合は作成するか、失敗を報告してください。任意のグローバル Python は決して使用しないでください。NumPy がないインタープリターでは、パッケージのインポート時に失敗します。セットアップと診断については、interpreter を参照してください。

歩行・走行ループ向け RIFE

video-loop は歩行または走行のジャンプフレームを修復し、video-set は方向セットを 1 サイクルの長さにそろえます。どちらも RIFE の中間フレームを使用します。マシンごとに 1 回インストールしてください：$SPRITE_GEN_ROOT/.venv/bin/sprite-gen rife install（固定バージョンの rife-ncnn-vulkan 20221029 とモデル rife-v4.6 を SHA-256 で検証してユーザーデータディレクトリに配置し、最後にチェックフレームを出力します。GPU のない Linux では、先に libvulkan1 mesa-vulkan-drivers が必要です）。インストールされていない場合も、すべてのループは撮影時のまま切り出され、その旨が示されます：stderr の warning: 行、ループレポートの jump_repair.applied: false、および set.report.json の cycle_align.<state>.applied: false と warnings です。その場合は、どのループが未修復かをユーザーに伝え、インストールを案内してください。インストール後、該当するループを再度切り出し、video-cycle-align を実行してください。video-loop --repair on と video-cycle-align は、RIFE がない場合は失敗します。ループ修復。

コントラクトと高度なツール

実行コントラクト は、数値リクエスト、実行レイアウト、アトミックな公開、および厳選されたエクスポートを管理します。アーキテクチャでは、ドメインの所有範囲を説明しています。ドキュメント一覧には、すべての専門機能と QA 手順が記載されています。sprite-gen --help は、パッケージカタログからコマンドマップを生成します。パイプラインの出力として提示する際に、一時的なクロップスクリプトで標準の抽出処理を置き換えないでください。