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 的新对话。

文档

精灵堆叠

一个对象是由水平方向排列的扁平俯视切片组成的条带,地面切片在左侧,屋顶在右侧。从底部到顶部绘制它们,每个切片旋转相同的角度,垂直压缩以模拟摄像机俯仰,每片向上提升1像素。一张小图就能以清晰的像素呈现所有角度。

在未渲染和检查之前,切勿发布任何堆叠。以下路径相对于本技能的文件夹。

0. 选择路径

你有什么?
├── 切片条带 PNG 或 MagicaVoxel 图层导出 ──▶ 第3步(渲染)
├── 四视图图集(俯视、侧视、前视、后视)────────────────▶ 第1步 门控 ─▶ 第2步(雕刻)
└── 提示或想法 ──────────────────────────▶ 第1步 ─▶ 第2步 ─▶ 第3步

在现有项目中,首先阅读渲染器:引擎、像素缩放比例、精灵的绘制和排序方式、哪些对象可以旋转。将堆叠适配到该渲染器中。切勿添加第二个画布或渲染管线。

1. 获取四视图图集

图集:一行1x4的图像,顺序为俯视、侧视、前视、后视,背景为纯白色,视图之间有明显间隙。俯视图从正上方看,前方向下。侧视图前方向左。所有视图比例相同。

选择层级:

  • 复古块状: 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. 你有图像生成工具。 使用此提示。替换主题,其余部分保持原样:

[主题]的块状像素艺术正交投影模型表,具有丰富的3色调色相偏移像素着色(深冷调阴影、饱和中间调、沿脊线和边缘的亮暖调高光)、粗犷的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.2对于丰富着色的视图为0.12-0.15,对于平坦视图为0.25,无则为0
--colours24对于详细涂装为32-48,0保留所有颜色
--bg-tol28如果JPEG噪声留下边缘则稍微提高
--dark-thresh700保留非常暗轮廓上的轮廓
--normals(无)保存匹配的3D法线贴图切片条带PNG
--emissive(无)保存自动检测的发射蒙版切片条带PNG

在雕刻后立即打开check.png并查看:所有四个提取的视图、四个转盘角度和分解视图。在编写任何集成代码之前执行此操作。viewer.html在浏览器中打开,包含转盘、场景(动态立体画:霓虹街/草甸岛,带有程序化堆叠道具 + 多PNG道具放置)、切片扫描、分解和播放模式(无限街道/草甸/网格世界驾驶、风、碎裂),实时时间(白天 → 日落 → 夜晚,带有自动发射辉光和投影3D阴影),天气(雨,带有波浪状湿反射和涟漪;雪,带有normZ积雪累积),以及16方向PNG导出。

3. 渲染:循环及其数字

每个渲染器运行相同的循环,从底部到顶部:

// sheet:水平方向排列的`count`个切片,每个宽×高,地面切片在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帧放置。 保持连续运动(弹动、浮动、绕轨、父级到子级投影)以浮点屏幕像素为单位,仅在最终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个切片之前绘制。对于高大道具,按层沿太阳向量投影堆叠的切片,使用拜耳4×4抖动边缘,而不是通用的椭圆。
  • 完成后一次性描边堆叠,而不是每片描边。 每片描边会在主体上绘制接缝和斑点。渲染到1倍艺术像素缓冲区,在其阿尔法周围追踪1像素轮廓,然后放大。
  • 航向: 图集正面指向下方(+y),因此turn = atan2(vy, vx) - PI / 2。对于反向的对象,使用存储的航向驱动turn,而不是原始速度。
  • 按地面点Y排序整个堆叠。 切勿交错两个对象的切片。
  • 在加载时将静态堆叠烘焙为普通精灵。 200棵树 × 30个切片就是每帧6000次绘制。
  • 使用切片动画化入口,而不是不透明度淡入淡出。 在空中淡入淡出堆叠看起来平面化;通过每片lifts(切片绽放,温和的弹簧沉降和地面环)从底部到顶部增长接地道具,并沿着其运动弧线滑入空中/水面上的堆叠(云、船)。将lifts的显示边界扩展到count之后,使用每片混合宽度(mix(start, count + width, ...)),使顶部切片在将lifts切换回null之前达到完全spacing——否则上部切片会在单帧中突然出现。切勿在视频中使用defocus剪切模糊清晰的堆叠——请改用连续摄像机移动。
  • 通过每片偏移实现有机摇摆、3D俯仰倾斜和身体波动。 对于锚定的柔性道具(海藻、草、横幅),水平偏移每个切片sin(t * freq - z * wave + phase) * amp * (z / (count - 1))²,使z = 0保持固定,而尖端平滑摇摆。对于跳跃生物(海豚在突破时仰头→在顶点保持水平→在重入时低头)或滚动船只,应用每片纵向/横向倾斜偏移(xOffsets, yOffsets),其与(z - centerZ) * sin(pitchAngle)沿身体轴线成比例,使俯仰和滚动表现为真正的3D倾斜,而不是平坦的垂直提升。
  • 验证原生鼻轴并对水下堆叠进行深度衰减。 在绑定turn = atan2(vy, vx)之前,确认每个条带的鼻部面向+x、+y或-y,以便船只和生物以鼻部为先移动。对于水下堆叠(海底道具、深海鳐鱼、水下海豚阶段),应用比尔-朗伯定律深度着色(将红色向水色去饱和),并柔化或省略硬的外轮廓;使用对共享波浪场(而非瞬时波高)的阻尼弹簧-质量响应来驱动浮动堆叠的升沉、俯仰和滚动。

在连接到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,并通过肉眼比较:它会舍入小精灵。
  • 完整旋转: 观察每个角度,而不是四个。出现和消失的部分是一个教训行。

教训

当堆叠出现问题时,修复它,然后修复导致问题的原因,使其不再发生:修改切片器使错误不可能发生,或使其警告并在消息中提供修复,并从真实错误中添加一个案例到tests/check.py,该案例在修改前会失败。只有代码无法判断的判断才成为规则。在此添加一行;一旦代码使错误不可能发生,就删除它。

日期错误规则强制执行方式
2026-11-201像素的柱、绳子和天线在堆叠旋转时闪烁出现和消失将细小的部分绘制成至少2像素宽切片器警告(thin_runs),检查案例5
2026-11-20比底座窄的圆形部分(塔、气球、盆)被雕刻成方形使用--round雕刻;它使像柱这样的有间隙的行保持方形--round,检查案例4
2026-11-20自动--top-nose翻转任何非车辆的对象传递--top-nose down规则
2026-11-20从墙壁突出的东西沿着整个墙壁雕刻出一个壁架将小的突起平面化绘制;给一个……

[为翻译而截断]

相关技能