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 色調色相偏移漸層著色:冷深陰影、飽和中間色調、暖色高光。無漸層、無抗鋸齒。
-
將物體居中:疊層圍繞其邊界框的中間旋轉,因此一個在一側延伸更遠的底座會使其偏離軸心旋轉。
關卡:在切片前查看圖表
- 方向: 頂視圖的前方朝下。側視圖的前方朝左(如果朝右,則傳遞
--side-nose right)。 - 比例: 頂視圖長度 = 側視圖長度,頂視圖寬度 = 前視圖/後視圖寬度,側視圖高度 = 前視圖/後視圖高度。
- 硬邊緣: 扁平填充、清晰的輪廓。柔和的噴槍邊緣或細小的 1 像素內部線條會在切片旋轉時模糊。應重新生成或重繪,而非補救。
- 孔洞: 在側視圖中顯示空隙的懸垂物(升起的後翼)會保留下來。從所有四個輪廓隱藏的凹陷(卡車車廂、中空拱門)會被填充。在雕刻後手動修復這些切片。
- 教訓: 查看此文件末尾的教訓表。
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 保留圖表的原始像素 |
--order | auto | auto 透過匹配比例選擇頂視圖和側視圖(頂視圖長度 = 側視圖長度,頂視圖寬度 = 前視圖寬度,側視圖高度 = 前視圖高度);平手時採用讀取順序。reading 強制使用頂視圖、側視圖、前視圖、後視圖的順序 |
--round | 關閉 | 塔樓、氣球、罐子、瓶子:將每個切片裁剪為其側視圖和前視圖跨度所描述的橢圓。對於鰭片、翅膀和盒子則保持關閉 |
--side-nose | left | 若側視圖朝右,則設為 right |
--top-nose | auto | 自動讀取車廂。對非車輛物體傳遞 down,若翻轉車輛則傳遞 up 或 down |
--shade | 0.2 | 0.12-0.15 用於豐富著色的視圖,0.25 用於平坦的視圖,0 表示無 |
--colours | 24 | 32-48 用於詳細的塗裝,0 保留所有顏色 |
--bg-tol | 28 | 若 JPEG 噪點留下邊緣則稍微調高 |
--dark-thresh | 70 | 0 保留非常暗的輪廓上的輪廓 |
--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-20 | 1 像素的柱子、繩索和天線在疊層旋轉時閃爍出現和消失 | 將細小部分繪製成至少 2 像素寬 | 切片器警告(thin_runs),檢查 case 5 |
| 2026-11-20 | 比其底座窄的圓形部分(塔、氣球、罐子)被雕刻成方形 | 使用 --round 雕刻;它會將像柱子這樣的間隔行保持為方形 | --round,檢查 case 4 |
| 2026-11-20 | 自動 --top-nose 翻轉任何非車輛的物體 | 傳遞 --top-nose down | 規則 |
| 2026-11-20 | 從牆壁伸出的東西沿整面牆雕刻出一個壁架 | 將小的突出物畫成扁平的;為 …(此處截斷) |
[供翻譯用]