Community画像github.com

スプライトスタッキング

四方向のドット絵を回転できる偽3Dの積層にし、Canvas、Godot、Unity、Phaser 向けの鮮明なターンテーブルを描く。

スプライトスタッキング とは?

スプライトスタッキングの手順。左が地面、右が屋根の上面スライスを下から積み、同じ角度で回し、カメラの俯角で縦につぶし、一段ごとに1ピクセル上げる。スライス帯、四视图、またはプロンプトから始められる。レンダーして見ていない積層は完成にしない。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danielwh2/sprite-stacking/tree/HEAD/skills/sprite-stacking

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Sprite stacking

オブジェクトは、左側に地面スライス、右側に屋根がある水平な平らなトップダウンスライスのストリップです。スライスを下から上に描画し、すべて同じ角度で回転させ、カメラのピッチに合わせて垂直方向に押しつぶし、スライスごとに1ピクセルずつ持ち上げます。1枚の小さなシートで、すべての角度を鮮明なピクセルで表現できます。

レンダリングして確認していないスタックは、絶対に出荷しないでください。以下のパスは、このスキルのフォルダを基準としています。

0. パスを選択

何を持っていますか?
├── スライスストリップPNGまたはMagicaVoxelレイヤーエクスポート ──▶ ステップ3(レンダリング)
├── 4ビューシート(上、横、前、後ろ) ───────────────────────────▶ ステップ1 ゲート ─▶ ステップ2(カービング)
└── プロンプトまたはアイデア ─────────────────────────────────────▶ ステップ1 ─▶ ステップ2 ─▶ ステップ3

既存のプロジェクトでは、最初にレンダラーを読んでください。エンジン、ピクセルスケール、スプライトの描画とソート方法、どのオブジェクトが回転するかを確認します。スタックをそのレンダラーに適合させてください。2つ目のキャンバスやレンダーパイプラインを追加しないでください。

1. 4ビューシートを入手

シート:フラットな白の背景に、TOP、SIDE、FRONT、BACKの順に並んだ1x4の行。各ビューの間には明確な隙間があります。TOPは真上から見下ろし、正面が下を向いています。SIDEは正面が左を向いています。すべてのビューでスケールは同じです。

階層を選択してください:

  • Chunkyレトロ: 15〜20スライス、約25×48ピクセル。太いシルエット、3〜4ピクセルのストライプ、8〜10倍で表示。
  • 詳細ハイビット: 26〜44スライス、36×72〜46×107ピクセル。ベント、ロゴ、スポークリム、ガラスの反射、リアスポイラーを保持。
  • ショーケース / 1080pビデオ: 36〜56スライス、30×30〜148×148ピクセル、4〜6倍の整数スケールで表示。小さなスプライトをHDビデオで7〜9倍に拡大したときの、chunkyなシルエットの段差と回転のぐらつきを回避。360°でクリーンに読み取れる建築のマイクロディテール(シャッター、フラワーボックス、バルコニー手すり、屋根の苔、スイレンの葉、ランタンポスト、崖の蔓、滝)は、パレットの規律を壊すことなくジオラマを引き立てます。

次に、該当する最初のソースを使用します。

a. 画像生成ツールがある場合。 このプロンプトを使用します。被写体を入れ替え、残りはそのままにしてください。

[SUBJECT]の、豊かな3トーンの色相シフトされたピクセルシェーディング(深い冷たいシフトの影、飽和した中間色、尾根やエッジに沿った明るい暖色のハイライト)、大胆な3〜4pxのストライプ/アクセント、ガラス上の鮮明なスペキュラーピクセルを備えた、Chunkyピクセルアートの正投影モデルシート。完全にフラットな無地の白または淡い灰色の背景に、クリーンな1x4の水平行(または2x2グリッド)での4つのビュー:
1. 真上から見下ろすTOPビュー、正面は下を向いています。
2. SIDEビュー、正面は左を向いています。
3. FRONTビュー。
4. BACKビュー。
厳密に正投影:遠近感ゼロ、傾きゼロ、3/4アングルゼロ。4つのビューすべてで同一のスケールなので、長さ、幅、高さがピクセル単位で一致します。各ビューの周りに太い1pxの暗いアウトライン、ソリッドなフラットカラークラスター、鮮明な内部パネルシェーディング、アンチエイリアシングゼロ、ソフトエッジゼロ、キャストグラウンドシャドウゼロ、グリッド線ゼロ、テキストゼロ、ビュー間に十分な空きスペース。

b. ユーザーがシートを持っている場合。 それを使用します。

c. どちらもない場合。 短いPython/PILスクリプトで、ネイティブ解像度で4つのビューをピクセルアートとして自分で描画します。1ピクセルはアートの1ピクセル(numpy配列またはImageDraw)です。各ビューに1pxの暗いアウトラインを付け、長さ、幅、高さをすべてのビューで同一に保ち、Image.NEARESTで8倍に拡大し、フラットな白の背景に少なくとも40ピクセルの間隔をあけて1行に貼り付けます。--slicesをSIDEビューのネイティブの高さ(アウトラインを含む)に設定してカービングすると、スライスが元のピクセルに戻ります。

スライサーは、すべてのビューが覆っている場合にのみボクセルを保持するため、(c)の場合:

  • 丸いオブジェクト(鉢、キャノピー、ドーム、上から見た車輪)は、TOPビューにピクセルサークルが必要です。正方形のTOPは箱を彫ります。丸い部分が最も広い部分よりも狭い場合(広い台座の上の塔、バスケットの上の風船)、--roundも使ってカービングしないと、正方形になってしまいます。

  • フィン、葉、翼、および不規則な平面形状は、TOPビューに実際の輪郭が必要です。そうしないと、ブロックとして彫られます。

  • SIDEとFRONTのシルエットがプロファイルを設定します。長方形は円柱を作るので、ボールの場合は丸くします。

  • 壁のディテール(窓、ドア、パネルライン)はSIDE、FRONT、BACKに入ります。屋根のディテールはTOPに入ります。

  • 壁から突き出ているもの(フラワーボックス、ポーチ、看板)は、その壁全体に沿って棚を彫ります。小さな突起は平らに塗り、煙突には平らな尾根のストリップを付けてその上に立たせます。

  • 3〜4トーンの色相シフトされたランプでシェーディングします。冷たい深い影、飽和した中間色、暖かいハイライト。グラデーション、アンチエイリアシングはなし。

  • オブジェクトを中央に配置:スタックはバウンディングボックスの中央を中心に回転するため、ベースが片側に大きく張り出すと、軸から外れて軌道を描くようになります。

ゲート: スライスする前にシートを確認

  1. 向き: TOPの正面は下を向いています。SIDEの正面は左を向いています(右を向いている場合は、--side-nose rightを渡します)。
  2. プロポーション: TOPの長さ = SIDEの長さ、TOPの幅 = FRONT/BACKの幅、SIDEの高さ = FRONT/BACKの高さ。
  3. ハードエッジ: フラットな塗りつぶし、鮮明な輪郭。ソフトなエアブラシエッジや細い1pxの内部ラインは、スライスが回転するとにじみます。修正しようとせず、再生成または再描画してください。
  4. 穴: SIDEビューで光が見えるオーバーハング(リフトアップしたリアウィング)は残ります。4つのシルエットすべてから隠れている空洞(トラックの荷台、中空のアーチ)は埋められます。それらのスライスは、カービング後に手作業で修正してください。
  5. 教訓: このファイルの最後にある教訓テーブルを確認してください。

2. カービングと検査

scripts/views_to_slices.py は、Python 3、Pillow、およびNumPyが必要です。背景(透明またはフラット)を除去し、1pxのビューアウトラインを取り除き、1つの共有パレットに量子化し、スライスを彫り、チェックシートとスタンドアロンビューアを書き出します。

python3 scripts/views_to_slices.py views.png slices.png \
  --slices 36 --shade 0.2 --preview check.png --html viewer.html
フラグデフォルトいつ変更するか
--slices Nauto(SIDEビューが64ピクセルより高い場合は36、それ以外はネイティブ)15-20 chunky、32-48 hi-bit、描画シートの場合はネイティブの高さ、0はシートの生のピクセルを保持
--orderautoautoはプロポーションの一致(TOPの長さ = SIDEの長さ、TOPの幅 = FRONTの幅、SIDEの高さ = FRONTの高さ)によってTOPとSIDEを選択します。同点の場合は読み取り順が優先されます。readingはTOP、SIDE、FRONT、BACKを強制します
--roundoff塔、風船、鉢、ボトル:各スライスを、そのSIDEおよびFRONTスパンが記述する楕円にクリップします。フィン、翼、ボックスにはオフのままにします
--side-noseleftSIDEビューが右を向いている場合はright
--top-noseauto自動で車のキャビンを読み取ります。車両以外のものにはdownを渡し、車の向きを反転させる場合はupまたはdownを渡します
--shade0.2豊かにシェーディングされたビューの場合は0.12-0.15、フラットなビューの場合は0.25、なしの場合は0
--colours24詳細な塗装の場合は32-48、すべての色を保持する場合は0
--bg-tol28JPEGノイズがフリンジを残す場合は、少し上げます
--dark-thresh70非常に暗いシルエットでアウトラインを保持する場合は0
--normals(なし)対応する3D法線マップスライスストリップPNGを保存します
--emissive(なし)自動検出されたエミッシブマスクストリップPNGを保存します

check.pngを開き、カービング後すぐに確認します。抽出された4つのビューすべて、4つのターンテーブルアングル、および展開図。統合コードを記述する前に行ってください。viewer.htmlはブラウザで開き、ターンテーブル、シーン(リビングジオラマ:ネオンストリート / メドウアイランド(手続き的に積み重ねられた小道具+マルチPNG小道具ドロップ))、スライススキャン、展開図、およびプレイモード(無限のストリート/メドウ/グリッドワールドをドライブ、風、粉砕)、リアルタイムの時間帯(昼→夕日→夜(自動エミッシブグローと投影3Dシャドウ))、天気(雨(波打つ濡れた反射とさざ波))、雪(normZ雪のキャップ蓄積))、および16方向PNGエクスポートがあります。

3. レンダリング:ループとその数値

すべてのレンダラーは、下から上へ同じループを実行します。

// sheet: `count`個のスライスの水平ストリップ、各スライスはw × h、グラウンドスライスはz = 0
// pos: グラウンドコンタクトの中心、整数ピクセルに丸められます
for (let z = 0; z < count; z++) {
  // 1. スライスをその中心(-floor(w/2), -floor(h/2))を中心に `turn` だけ回転
  // 2. yを `squash`(カメラピッチ)でスケーリング
  // 3. -round(z * spacing) だけ持ち上げ
  // 4. 整数ピクセルの `pos` に平行移動し、最近傍フィルタで描画
}

これらは推測しないでください:

  • spacing = 1.0 アートピクセルスケールでのスクリーンピクセル。
  • squash = 0.75 斜め上からのカメラ用。1.0は真上を見下ろします。0.6未満では屋根が薄いスライバーにつぶれます。チルトカメラの場合、squash = sin(elevation)、spacing = cos(elevation)。
  • 対称的な回転中心。 ソフトウェア/ピクセルバッファラスタライザーでは、Math.round(...) 最近傍サンプリングで (w - 1) * 0.5, (h - 1) * 0.5 を中心にサンプリングします。偶数サイズのスライスで Math.floor(... + w / 2) を使用すると、中心が0.5アートピクセルずれ、90°/180°/270°の回転で目に見える回転ぐらつきが発生します。
  • スムーズな60fps配置。 連続した動き(ボビング、フローティング、軌道、親から子への投影)を浮動小数点スクリーンピクセルで維持し、最終的な1スクリーンピクセルのブリット(Math.round(dx), Math.round(dy))でのみ整数表示scaleでスナップします。動きをアートピクセルステップ(Math.round(...) * scale)に量子化したり、子の投影を個別に丸めたりしないでください。どちらも、粗いマルチピクセルのジャンプと小道具から地面へのジッターを引き起こします。
  • ロード時にストリップカウントを検証します。 ストリップをスライスするときに sheet.width % count === 0(および期待されるスライス寸法)をアサートして、ストリップのスライスカウントをアップグレードしても、フレームの途中でサイレントにスライスされないようにします。
  • 最近傍フィルタリング。 Webでは imageSmoothingEnabled = false と image-rendering: pixelated、エンジンでは Nearest/Point フィルタ。
  • グラウンドシャドウ: 車両の場合、z = 0 でのユニオンフットプリント、オフセット +2、+3 アートピクセル、スライス0の前に描画。背の高い小道具の場合、積み重ねられたスライスをレイヤーごとに太陽ベクトルに沿って投影し、Bayer 4×4ディザリングエッジを使用します。一般的な楕円ではありません。
  • 完成したスタックに一度だけアウトラインを付け、スライスごとには決して付けません。 スライスごとのアウトラインは、ボディに継ぎ目とスペックルを描画します。1xのアートピクセルバッファにレンダリングし、そのアルファの周りに1pxのアウトラインをトレースしてから、拡大します。
  • ヘディング: シートの正面は下向き(+y)なので、turn = atan2(vy, vx) - PI / 2。逆転するものについては、生の速度ではなく、格納されたヘディングからturnを駆動します。
  • Yソートは、スタック全体をグラウンドポイントで行います。 2つのオブジェクトのスライスをインターリーブしないでください。
  • 静的なスタックをロード時にプレーンスプライトにベイクします。 200本の木×30スライスは、1フレームあたり6,000ドローです。
  • エントランスをスライスでアニメーション化し、不透明度フェードは使用しません。 空中でスタックをフェードインさせると平坦に見えます。グラウンドに設置された小道具を下から上に、スライスごとのlifts(スライスブロームと穏やかなスプリングセトルおよびグラウンドリング)で成長させ、空中/水上のスタック(雲、ボート)を移動アークに沿ってグライドインさせます。liftsのリビールフロンティアをcountを超えて、スライスごとのブレンド幅(mix(start, count + width, ...))だけ拡張して、上のスライスがliftsをnullに戻す前に完全なspacingに達するようにします。そうしないと、上のスライスが1フレームでパッと表示されます。ビデオでは、defocusカットで鮮明なスタックをぼかさないでください。代わりに、連続したカメラムーブを使用してください。
  • スライスごとのオフセットによる有機的な揺れ、3Dピッチチルト、ボディの波打ち。 固定された柔軟な小道具(ケルプ、草、バナー)の場合、各スライスを水平に sin(t * freq - z * wave + phase) * amp * (z / (count - 1))² だけオフセットして、z = 0 が固定されたまま先端がスムーズに揺れるようにします。跳躍するクリーチャー(跳ねるイルカがブリーチ時に鼻を上に向け→頂点で水平→再突入時に鼻を下に向ける)や転がる船の場合、スライスごとの長手方向/横方向のチルトオフセット (xOffsets, yOffsets) を (z - centerZ) * sin(pitchAngle) に比例させてボディ軸に沿って適用し、ピッチとロールがフラットな垂直リフトではなく真の3Dチルトとして読み取られるようにします。
  • ネイティブノーズ軸を確認し、水中スタックを深度減衰させます。 各ストリップのノーズが+x、+y、または-yのどれを向いているかを確認してから turn = atan2(vy, vx) をバインドし、船やクリーチャーがノーズファーストで移動するようにします。水中に沈んだスタック(海底の小道具、深海のマンタ、水中のイルマフェーズ)には、Beer-Lambert深度ティント(赤みを水の色合いに脱色)を適用し、硬い外部アウトラインを柔らかくするか省略します。フローティングスタックのヒーブ、ピッチ、ロールを、瞬間的な波の高さではなく、共有波フィールドに対する減衰スプリングマス応答から駆動します。

Web Canvas、React、Godot、Unity、またはPhaserに配線するときは、references/engines.mdを開いてください。scripts/viewer.html は完全なWebリファレンスです。バッファ、アウトライン、軌道、スキャン、展開図、エクスポート。

4. 完了条件

  • 真下: squash = 1、turn = 0 の場合、レンダリングは幅が1スライス分、高さが sliceHeight + count - 1 ピクセルになります。
  • ピッチと90°: 0.75は1.0よりも明らかに短くなります。90°では、幅は sliceHeight に等しくなります。
  • 間隔: 0はフラットに描画し(上のスライスのみ)、2.5はすべてのレイヤーをきれいに分離します。
  • クリーンな対角線: 45°でボディ内に水平なストライプや暗いスペックルがありません。
  • ヘディング: 円を描いて運転すると、正面がパス上に保たれます。逆転するとヘディングが保持されます。
  • ゆっくりとした回転: 小さなスプライトがギクシャクして見える場合は、最初に整数表示スケールを上げてください。長い直線エッジがまだ這うように動く場合にのみRotSpriteを試し、目で比較してください。小さなスプライトを丸めてしまいます。
  • 全回転: 4つだけでなく、すべての角度を確認してください。出現したり消えたりする部分は、教訓の行です。

教訓

スタックがおかしくなった場合は、それを修正し、再発しないように原因を修正します。ミスが発生しないようにスライサーを変更するか、修正を含むメッセージで警告を表示するようにし、実際のミスから構築された tests/check.py に、変更前に失敗するケースを追加します。コードでは見えない判断の呼び出しだけがルールになります。ここに行を追加します。コードがミスを不可能にしたら、削除します。

日付ミスルール施行方法
2026-11-201pxのポスト、ロープ、アンテナがスタックの回転に応じて点滅/消失する細い部分は少なくとも2pxの幅で描画するスライサー警告(thin_runs)、チェックケース5
2026-11-20ベースより狭い丸い部分(塔、風船、鉢)が正方形に彫られる--round で彫る。ポストのようなギャップのある行は正方形のままにする--round、チェックケース4
2026-11-20自動 --top-nose が車両以外のものを反転させる--top-nose down を渡すルール
2026-11-20壁から突き出たものが壁全体に沿って棚を彫る小さな突起は平らに塗る。煙突には…

…[truncated for translation]

関連スキル