Community影像github.com

切片精靈旋轉

把四張正交像素視圖刻成可以旋轉的偽三維切片,再為 Canvas、Godot、Unity 或 Phaser 渲一張清晰的轉台。

切片精靈旋轉 是什麼?

精靈堆疊的一條管線。橫條從左到右是俯視切片,地面在左、頂部在右。自下而上畫,同一角度旋轉,按機位壓扁,每層抬高一像素。可以從切片條、四視圖或一句提示開始。沒有渲出來看過的堆疊不算完成。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Sprite stacking(精靈疊層)

一個物體是由水平條狀的扁平頂視圖切片組成,地面切片在左側,屋頂在右側。從下到上繪製它們,每個旋轉相同角度,垂直壓縮以模擬相機俯角,每個切片抬高 1 像素。一張小圖表就能以清晰像素呈現所有角度。

未經渲染和查看,切勿發布疊層。以下路徑相對於此技能的文件夾。

0. 選擇路徑

你有什麼?
├── 切片條狀 PNG 或 MagicaVoxel 圖層匯出 ──▶ 步驟 3(渲染)
├── 四視圖圖表(頂視圖、側視圖、前視圖、後視圖)───────▶ 步驟 1 關卡 ─▶ 步驟 2(雕刻)
└── 提示或想法 ──────────────────────────▶ 步驟 1 ─▶ 步驟 2 ─▶ 步驟 3

在現有專案中,先閱讀渲染器:引擎、像素縮放、精靈的繪製和排序方式、哪些物體會旋轉。將疊層融入該渲染器。切勿添加第二個畫布或渲染管線。

1. 取得四視圖圖表

圖表:一個 1x4 的水平行,順序為頂視圖 (TOP)、側視圖 (SIDE)、前視圖 (FRONT)、後視圖 (BACK),位於純白背景上,各視圖之間有清晰的間隙。頂視圖是垂直向下看,前方朝下。側視圖的前方朝左。所有四個視圖的縮放比例相同。

選擇一個層級:

  • 復古像素風: 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 倍時出現的粗大輪廓階梯和旋轉晃動。能夠在 360° 範圍內清晰辨識的建築微細節(百葉窗、花箱、陽台欄杆、屋頂苔蘚、睡蓮、燈柱、懸崖藤蔓、瀑布)能提升立體模型,同時不破壞調色盤紀律。

然後選取第一個適用的來源。

a. 你有圖像生成工具。 使用此提示。替換主體,其餘保持不變:

[SUBJECT] 的像素風正投影模型圖表,具有豐富的三色調色相偏移像素著色(深冷偏移陰影、飽和的中間色調、沿輪廓和邊緣的明亮暖色頂部高光)、大膽的 3-4 像素條紋/強調,以及玻璃上的清晰鏡面高光像素。四個視圖排列在一個整潔的 1x4 水平行(或 2x2 網格)中,背景為完全平坦的純白或淺灰色:
1. 頂視圖:垂直向下看,前方朝下。
2. 側視圖:前方朝左。
3. 前視圖。
4. 後視圖。
嚴格正投影:零透視、零傾斜、零 3/4 角度。所有四個視圖的縮放比例完全相同,因此長度、寬度和高度在像素級別上匹配。每個視圖周圍有 1 像素粗的深色輪廓,純色塊狀簇,清晰的內部面板著色,零抗鋸齒、零柔和邊緣、零地面陰影、零網格線、零文字,視圖之間有充足的空白空間。

b. 使用者已有圖表。 使用它。

c. 兩者都沒有。 使用簡短的 Python/PIL 腳本,以原生分辨率(每美術像素一個像素)自行繪製四個視圖的像素藝術(使用 numpy 陣列或 ImageDraw)。為每個視圖添加 1 像素的深色輪廓,確保所有視圖的長度、寬度和高度相同,使用 Image.NEAREST 放大 8 倍,然後將它們貼在一個水平行中,視圖之間至少有 40 像素的間距,背景為純白。使用 --slices 雕刻,設定為側視圖的原生高度(包括其輪廓),以便切片落回你的像素上。

切片器僅在每個視圖都覆蓋該體素時才保留它,因此對於 (c):

  • 圓形物體(罐子、天篷、圓頂、從上方看的輪子)在頂視圖中需要一個像素圓。正方形的頂視圖會雕刻出一個方塊。如果一個圓形部分的寬度小於最寬的部分(寬底座上的塔,籃子上方的氣球),也要使用 --round 雕刻,否則它會變成方形。

  • 鰭片、葉子、翅膀和任何不規則的平面需要在頂視圖中有真實的輪廓,否則它們會雕刻成塊狀。

  • 側視圖和前視圖的輪廓設定輪廓:矩形會產生圓柱體,所以要將它們弄圓以形成球體。

  • 牆壁細節(窗戶、門、面板線條)放在側視圖、前視圖和後視圖中。屋頂細節放在頂視圖中。

  • 任何從牆壁伸出的東西(花箱、門廊、招牌)會沿著整面牆雕刻出一個壁架。將小的突出物畫成扁平的,並為煙囪提供一條平坦的脊線來站立。

  • 使用 3-4 色調色相偏移漸層著色:冷深陰影、飽和中間色調、暖色高光。無漸層、無抗鋸齒。

  • 將物體居中:疊層圍繞其邊界框的中間旋轉,因此一個在一側延伸更遠的底座會使其偏離軸心旋轉。

關卡:在切片前查看圖表

  1. 方向: 頂視圖的前方朝下。側視圖的前方朝左(如果朝右,則傳遞 --side-nose right)。
  2. 比例: 頂視圖長度 = 側視圖長度,頂視圖寬度 = 前視圖/後視圖寬度,側視圖高度 = 前視圖/後視圖高度。
  3. 硬邊緣: 扁平填充、清晰的輪廓。柔和的噴槍邊緣或細小的 1 像素內部線條會在切片旋轉時模糊。應重新生成或重繪,而非補救。
  4. 孔洞: 在側視圖中顯示空隙的懸垂物(升起的後翼)會保留下來。從所有四個輪廓隱藏的凹陷(卡車車廂、中空拱門)會被填充。在雕刻後手動修復這些切片。
  5. 教訓: 查看此文件末尾的教訓表。

2. 雕刻並檢查

scripts/views_to_slices.py 需要 Python 3 以及 Pillow 和 NumPy。它移除背景(透明或扁平),去除 1 像素的視圖輪廓,量化為一個共享調色盤,雕刻切片,並寫入一個檢查圖表和一個獨立檢視器。

python3 scripts/views_to_slices.py views.png slices.png \
  --slices 36 --shade 0.2 --preview check.png --html viewer.html
旗標預設值何時更改
--slices N自動(若側視圖高度超過 64 像素則為 36,否則為原生高度)15-20 用於復古風,32-48 用於高彩風,原生高度用於手繪圖表,0 保留圖表的原始像素
--orderautoauto 透過匹配比例選擇頂視圖和側視圖(頂視圖長度 = 側視圖長度,頂視圖寬度 = 前視圖寬度,側視圖高度 = 前視圖高度);平手時採用讀取順序。reading 強制使用頂視圖、側視圖、前視圖、後視圖的順序
--round關閉塔樓、氣球、罐子、瓶子:將每個切片裁剪為其側視圖和前視圖跨度所描述的橢圓。對於鰭片、翅膀和盒子則保持關閉
--side-noseleft若側視圖朝右,則設為 right
--top-noseauto自動讀取車廂。對非車輛物體傳遞 down,若翻轉車輛則傳遞 up 或 down
--shade0.20.12-0.15 用於豐富著色的視圖,0.25 用於平坦的視圖,0 表示無
--colours2432-48 用於詳細的塗裝,0 保留所有顏色
--bg-tol28若 JPEG 噪點留下邊緣則稍微調高
--dark-thresh700 保留非常暗的輪廓上的輪廓
--normals(無)保存匹配的 3D 法線貼圖切片條狀 PNG
--emissive(無)保存自動偵測的發射光遮罩條狀 PNG

在雕刻後立即打開 check.png 並查看它:所有四個提取出的視圖、四個旋轉台角度和分解視圖。在編寫任何整合程式碼之前執行此操作。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. 按 `squash` 縮放 y(相機俯角)
  // 3. 按 -round(z * spacing) 提升
  // 4. 平移到整數像素的 `pos`,使用最近鄰濾波繪製
}

不要猜測這些:

  • spacing = 1.0 螢幕像素,以美術像素縮放為單位。
  • squash = 0.75 用於傾斜的俯視相機。1.0 是垂直向下看;低於 0.6 時屋頂會變平成為細條。對於可傾斜的相機,squash = sin(elevation),spacing = cos(elevation)。
  • 對稱旋轉中心。 在軟體/像素緩衝區光柵化器中,圍繞 (w - 1) * 0.5, (h - 1) * 0.5 進行採樣,使用 Math.round(...) 最近鄰採樣。在偶數大小的切片上使用 Math.floor(... + w / 2) 會將中心偏移 0.5 美術像素,並在 90°/180°/270° 旋轉時產生可見的旋轉晃動。
  • 流暢的 60 fps 放置。 在浮點螢幕像素中保持連續運動(上下浮動、漂浮、環繞、父級到子級的投影),並僅在最終的 1 螢幕像素 blit 時進行一次快照(使用 Math.round(dx), Math.round(dy)),並使用整數顯示 scale。切勿將運動量化為美術像素步長(Math.round(...) * scale)或獨立地對子級投影進行四捨五入——兩者都會導致劇烈的多像素跳躍和道具與地面之間的抖動。
  • 在加載時驗證條狀圖的計數。 在切割條狀圖時斷言 sheet.width % count === 0(以及預期的切片尺寸),以便升級條狀圖的切片計數時永遠不會靜默地在幀中間進行切片。
  • 最近鄰濾波。 在 Web 上使用 imageSmoothingEnabled = false 和 image-rendering: pixelated,在引擎中使用最近鄰/點濾波器。
  • 地面陰影: 對於車輛,在 z = 0 處的聯合足跡,偏移 +2、+3 美術像素,在切片 0 之前繪製。對於高大的道具,按層次沿太陽向量投影堆疊的切片,使用 Bayer 4×4 抖動邊緣,而非通用橢圓。
  • 一次繪製完成疊層的輪廓,而不是每個切片。 每個切片的輪廓會繪製接縫並在物體內部產生斑點。渲染到 1x 美術像素緩衝區,在其 alpha 周圍描繪 1 像素輪廓,然後放大。
  • 朝向: 圖表的前方朝下 (+y),因此 turn = atan2(vy, vx) - PI / 2。對於任何反向的物體,從儲存的朝向驅動 turn,而非原始速度。
  • 按地面點對整個疊層進行 Y 排序。 切勿交錯兩個物體的切片。
  • 在加載時將靜態疊層 烘焙成普通精靈。200 棵樹 × 30 個切片 = 每幀 6,000 次繪製。
  • 使用切片動畫化出場,而非透明度淡入淡出。 在半空中淡入疊層看起來很平;透過逐切片 lifts(切片綻放,帶有溫和的彈簧穩定和地面環)從下到上增長接地道具,並讓空中/水上疊層(雲、船)沿其移動弧線滑入。將 lifts 揭示邊界擴展到 count 之外,超出逐切片混合寬度(mix(start, count + width, ...)),以便頂部切片在將 lifts 切換回 null 之前達到完整的 spacing——否則上部切片會在單幀中突然出現。切勿在影片中透過 defocus 剪輯模糊清晰的疊層——改用連續的相機移動。
  • 透過逐切片偏移實現有機搖擺、3D 俯仰傾斜和身體波動。 對於固定的柔性道具(海藻、草、旗幟),將每個切片水平偏移 sin(t * freq - z * wave + phase) * amp * (z / (count - 1))²,以便 z = 0 保持固定,而尖端平滑搖擺。對於跳躍的生物(在出水時鼻子朝上 → 在最高點保持水平 → 在重新入水時鼻子朝下的海豚跳躍)或滾動的船隻,應用與 (z - centerZ) * sin(pitchAngle) 成比例的逐切片縱向/橫向傾斜偏移 (xOffsets, yOffsets) 沿身體軸線,以便俯仰和滾動被讀取為真正的 3D 傾斜,而不是平坦的垂直升降。
  • 驗證原生鼻子軸線並對淹沒的疊層進行深度衰減。 在綁定 turn = atan2(vy, vx) 之前,確認每個條狀圖的鼻子朝向 +x、+y 或 -y,以便船隻和生物以鼻子為前進方向移動。對於淹沒在水下的疊層(海底道具、深水蝠鱝、淹沒的海豚階段),應用 Beer-Lambert 深度著色(將紅色去飽和趨向水色),並柔化或省略硬的外輪廓;驅動浮動疊層的起伏、俯仰和滾動來自對共享波浪場的阻尼彈簧-質量響應(非即時波高)。

在接入 Web Canvas、React、Godot、Unity 或 Phaser 時,打開 references/engines.md。scripts/viewer.html 是完整的 Web 參考:緩衝區、輪廓、環繞、掃描、分解、匯出。

4. 完成條件

  • 垂直向下看: 在 squash = 1、turn = 0 時,渲染結果寬度為一個切片,高度為 sliceHeight + count - 1 像素。
  • 俯角和 90°: 0.75 明顯比 1.0 短;在 90° 時寬度等於 sliceHeight。
  • 間距: 0 繪製為扁平(僅頂部切片),2.5 則清晰地分隔每一層。
  • 乾淨的對角線: 在 45° 時物體內部沒有水平條紋或暗斑。
  • 朝向: 繞圈行駛時前方保持在路徑上;倒車時保持朝向。
  • 慢轉: 如果小精靈看起來粗糙,首先提高整數顯示縮放。僅在長直邊緣仍然爬行時嘗試 RotSprite,並透過眼睛比較:它會使微小精靈變圓。
  • 完整旋轉: 觀察每個角度,而非四個。一個部分出現又消失是一個教訓行。

教訓

當疊層出現問題時,修復它,然後修復導致問題的根本原因,使其不再發生:修改切片器以使錯誤無法發生,或使其發出包含修復方法的警告,並將基於實際錯誤的 case 添加到 tests/check.py,該 case 在更改前會失敗。只有程式碼無法判斷的判斷事項才能成為規則。在此添加一行;一旦程式碼使該錯誤不可能發生,就將其刪除。

日期錯誤規則強制執行方式
2026-11-201 像素的柱子、繩索和天線在疊層旋轉時閃爍出現和消失將細小部分繪製成至少 2 像素寬切片器警告(thin_runs),檢查 case 5
2026-11-20比其底座窄的圓形部分(塔、氣球、罐子)被雕刻成方形使用 --round 雕刻;它會將像柱子這樣的間隔行保持為方形--round,檢查 case 4
2026-11-20自動 --top-nose 翻轉任何非車輛的物體傳遞 --top-nose down規則
2026-11-20從牆壁伸出的東西沿整面牆雕刻出一個壁架將小的突出物畫成扁平的;為 …(此處截斷)

[供翻譯用]

相關技能