Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

docs(changelog): 2.18.0 — video-frames --decontam palette adds no edge contact

Soohong Kim9d41a2976858
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 47175f1..a196530 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,7 @@ All notable public changes to `sprite-gen` are recorded here. Versions track the
- **One cycle per direction set**: new `sprite-gen video-cycle-align --loop-dir … --loop-dir …` resamples every loop to the set's median length at times k·L/L* — a time on a source frame keeps that frame, only times between frames are made by RIFE — turns each to start on a foot strike, and rebuilds its cycle, strip, GIF and WebP in place (`cycle_align` in `strip.json`). The cut as filmed is kept in `cycle.source/`, so a second run never resamples a resampled loop. `video-set` runs it for every walk or run filmed in two or more directions (`--align-cycles auto`, default). Strip metadata now records `cell_height_cap`.
- **Measured walk defaults**: `build_prompt(model=...)` calms a Lite walk (`LITE_WALK_TEXT`; Lite read "walks naturally" as a run) and holds a Lite back-diagonal walk's head (`LITE_HEAD_TEXT`; sideways sway 2.7-3.8 % fell to 1.7-3.1 %, Pro 0.88 %); Pro prompts are unchanged. A front or back walk films from its base still redrawn mid-step (`WALK_START_TEXT`, `walk_start_prompt`, `starts_mid_step`; 1 of 14 front clips walked straight from a standing still, 14 of 16 from a mid-step one); `video-set --walk-start redraw` (default) draws it with one `sprite-gen gen --ref` call.
- Method, measurements and the regression on the eight-direction set: [docs/loop-repair.md](docs/loop-repair.md).
+- **`video-frames --decontam palette` adds no edge contact**: within the edge band the gate reads (4 px of the top, left and right edges), a pixel the matte left transparent stays transparent (`decontaminate(edge_band=...)`, `cutout(decontam_edge_band=...)`, `edge_band` in the report's `decontam`). A decoded frame's blur runs the subject on into the key as a smooth tail that the video fit reads as a faint blend, so a head a few pixels under the frame edge got faint flank coverage on the edge band and a clip that passes with decontam off was refused with it on, as "the key survived the matte". No floor tells that tail from a strand's side, so the rule is positional; the flank keeps what it recovers everywhere else, and the still fit is unchanged. [docs/chroma-alpha.md](docs/chroma-alpha.md#decontam--give-the-edge-the-subjects-own-colour-back).
## v2.17.0 - Two three-quarter views: a character walks down and up to the right as in an isometric game