Skip to content

v1.3.0 — Scoped recoloring, atlas pages, tile previews, and PNG frame export / 局部改色、图集分页、地块预览与 PNG 动画帧导出

Latest

Choose a tag to compare

@Chenamel Chenamel released this 14 Nov 17:33
6dad1be

English · 中文说明 · English notes · 中文版

English

Compared with v1.2.2, v1.3.0 adds scoped color replacement, paged review for large atlases, tile seam and scene previews, and packaging for existing PNG animation frames. Existing commands and JSON v1 remain available.

Changes

  • recolor replaces exact RGBA colors inside rectangles or a mask while leaving identical colors outside unchanged. Use verify to check changed pixels and confirm edits stay within the allowed area.
  • review_atlas.py splits large named atlases into bounded native-size pages and lists which cells appear on each page.
  • tile_preview.py repeats a single tile to inspect seams; tile_scene.py places explicitly named atlas tiles into a scene and exports scene and seam views.
  • animation_export.py packages equal-size PNG frames, action ranges, and millisecond timings into a relocatable directory while keeping original PNG bytes, with optional GIF previews.

The repository also updates the editable travel-kit demo (in the repository, not the Skill ZIP).

Fixes and limits

  • Strict named-atlas operations verify that layout records match the image pixels; embedded layout reads and writes share a 256 KiB limit; and if output replacement and rollback both fail, old-file backups are retained and reported (without promising atomic recovery across crashes or power loss).
  • Exact editing (recolor and verify) requires single-frame PNGs with channel depth at most 8 bits; multi-frame PNGs/APNGs are rejected. animation_export.py does not draw frames or export sprite sheets/APNGs, tile_scene.py does not auto-generate terrain or perspective, and review_atlas.py page lists do not mean an agent viewed every page. See the English release notes.

Downloads and channels

中文说明

相对 v1.2.2,v1.3.0 新增局部改色、大型图集原尺寸分页、瓦片接缝与命名场景预览,以及已有 PNG 动画帧的整理导出。既有绘图命令与 JSON v1 继续提供。

主要变化

  • recolor 在指定矩形或蒙版内替换精确 RGBA 颜色,范围外的同色像素保持不变;可配合既有的 verify 命令核对改动像素是否越界。
  • review_atlas.py 按原生像素尺寸将大型命名图集分成尺寸受控的预览页,并记录每页包含的单元。
  • tile_preview.py 重复平铺单块瓦片以检查接缝;tile_scene.py 按显式名称把图集地块排成场景,输出场景图、接缝图与可搬移工程。
  • animation_export.py 将已有的等尺寸 PNG 帧、动作区间和毫秒时长整理为可搬移目录,保留原始 PNG 字节,并可附带 GIF 预览。

仓库还更新了可编辑旅行用品示范(位于仓库源码中,不含在独立 Skill ZIP 内)。

修正与限制

  • 命名图集的严格操作会核对布局与图片像素是否一致;内嵌布局的写入与读取共用 256 KiB 上限;覆盖输出与回滚均失败时保留旧文件备份并报告路径(不承诺断电或进程崩溃下的多文件原子恢复)。
  • 精确编辑(recolor 与 verify)要求单帧、通道位深不超过 8 位的 PNG;多帧 PNG/APNG 会被拒绝。animation_export.py 只整理已有帧,不负责画帧或导出精灵表/APNG;tile_scene.py 不做自动地形或透视生成;分页清单也不代表模型看过了每页图片。更多细节见中文发行说明。

下载与渠道状态