Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
docs(video-loop): the refused frame between in the CHANGELOG's Unreleased (v3.10.1)
Soohong Kim7ce52b690e8d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 60bb7bf..807d90c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -2,6 +2,15 @@All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.+## Unreleased (v3.10.1)++**Upgrading from 3.9.0: A cut with no held cell is unchanged (six synthetic cuts pinned to their decoded pictures still match). A cut whose frames between are real new pictures is unchanged (the synthetic stalled walk filled by a true in-between gives the same cells, 27/27). `--fill-held off` is unchanged. A run that 3.8.0 and 3.9.0 reported as filled although its frame between repeated a picture beside it is now made at another fraction where one passes, or kept as filmed with a warning; its `faults` in `held_fill.before.held_runs` list `held`. At `--out-fps`, such cells are now listed in `out_fps.shown_again` with a warning instead of being counted as made.**++- **Fix: A frame made that shows the same picture as a frame beside it or the cell delivered before it is no longer accepted.** In 3.8.0 and 3.9.0, an interpolator returning one of the two frames it was handed (or the same picture for two different times) made no frame between at all, but the run was recorded `filled: true`, its cells listed in `made`, with no retry and no warning, while poses over cells remained unchanged (for example 24/27 before and after). At `--out-fps`, such cells were counted as made and omitted from `out_fps.shown_again`. A frame made must now read as a distinct picture from both frames beside it and from the cell delivered before it; otherwise it receives the fault `held` and is refused. Refused frames are retried at the nearest other fractions of `RETIME_T` within half a cell. If none passes, the run is kept as filmed with a `warning:` line naming its cells and faults. At `--out-fps`, a cell refused this way is the nearer frame, listed in `out_fps.shown_again` and named in a `warning:` line.+- Python callers: New function `held_fill.same_picture` (`held_fill.same_picture(frame, others)`); `held_fill.judge(..., before=)` takes `before=` (the cell delivered before the frame).+- **Docs**: [loop-repair.md](docs/loop-repair.md) section 7: the rule and its measurements, the `--out-fps` cells; [video-pipeline.md](docs/video-pipeline.md); `SKILL.md`.+- **Tests**: `tests/video/test_held_fill.py` (stalled walk with held runs of two cells at cell 5 and three cells at cell 14 kept as filmed when an interpolator gives back the frame before or after, 24/27 poses/cells, each run's first cell tried at its own time and at every other fraction within half a cell, pictures delivered equal to `--fill-held off`, and warnings naming cells 5-6 and 14-16; an interpolator always drawing the half way time makes the run of two and keeps the run of three as filmed; `--out-fps` 60 from 24 with an interpolator returning the frame before lists all eight cells between in `out_fps.shown_again`, while drawing the half way time makes the cell at 0.4 and lists the cell at 0.8 as the nearer frame; synthetic fall sinking less than a pixel in half a frame refused as `held` at 0.5, 0.45, 0.55 and 0.4, then made at 0.6 where the body has moved; mutation check: eight tests fail with the new reading switched off, two fail without the comparison to the cell before, and two fail without the comparison to the frame after).+## v3.10.0 - Root motion on single-play cuts, their air retimed on a given gravity, length and speed (--air-retime), and a caller-named single play (--cycle once --start --length)**Upgrading from 3.9.0: a cut played once with a body (`video-loop --cycle once`, `once-return`, `one-shot`, and so `video-set`'s single-play states) gains `root_motion` in its report and strip metadata: each cell's root, what it stands on, and its airs. Its cells and every other key keep their bytes and values. The air is drawn again only when asked (`--air-retime`).**