SuperAPI AI 工具集

sprite-pipeline

设计与创作

查看项目

更新于 10-16 03:05

技能介绍

用途:用于 2D 精灵的生成与规范化。工作流刻意以一张已确认帧和整条动画条为核心,因为逐帧生成容易出现漂移。该技能仅针对 2D;若涉及 3D 角色、网格或材质,应转回 ../game-studio/SKILL.md。

主要流程:先准备一张已确认的游戏内种子帧,使其已具备正确剪影、调色板、服装与比例;用 ../../scripts/build_sprite_edit_canvas.py 围绕该帧构建更大的透明参考画布;在一次编辑请求中要求完整动画条,除非用户明确接受较低一致性,否则不要逐帧独立生成;用 ../../scripts/normalize_sprite_strip.py 规范化为固定尺寸游戏帧,整条使用共享缩放,并以共享锚点(通常底部中央)对齐;可选锁回第 01 帧到已发布的种子帧,用于动画从游戏内精确待机或基准姿势开始;用 ../../scripts/render_sprite_preview_sheet.py 渲染预览表并在引擎内检查后再批准。

提示规则:提示中始终保留同一角色、同一朝向、同一调色板族、同一剪影族、可读的面部或关键特征、相同的服装比例、透明背景、精确帧数与槽位布局。始终要求一次生成一条、透明画布、无场景标签或海报式构图、像素作品保持清晰像素簇、产物为生产素材调性而非概念艺术。实时生成或编辑使用当前工作区已安装的 imagegen 技能,本技能定义游戏专用流程,imagegen 负责基于 API 的生成或编辑执行。

脚本示例: python3 scripts/build_sprite_edit_canvas.py
--seed output/sprites/idle-01.png
--out output/sprites/hurt-edit-canvas.png
--frames 4
--slot-size 256
--canvas-size 1024

python3 scripts/normalize_sprite_strip.py
--input output/sprites/hurt-raw.png
--out-dir output/sprites/hurt
--frames 4
--frame-size 64
--anchor output/sprites/idle-01.png
--lock-frame1

python3 scripts/render_sprite_preview_sheet.py
--frames-dir output/sprites/hurt
--out output/sprites/hurt-preview.png
--columns 4

质量门槛:各帧比例稳定、帧间尺寸不漂移、动作在游戏缩放下一目了然、透明保持、启用锁回时第 01 帧与已发布精灵匹配、更新引擎资源索引前预览正确。

限制:未提供收费、价格、平台与效果信息。