Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
docs(video): the changelog describes the tests of the set's suspects and the two-step loop's alignment as they now read video-cycle-align run on its own with a loop whose report holds its cut; text by the writing hand-off
Soohong Kim19f4e358ace4
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 1ea4be0..0fb10ef 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -71,6 +71,9 @@ All notable public changes to `sprite-gen` are recorded here. Versions track the- `batch.align_gaits` with three directions, two loops of one cycle (20 and 24 frames) and one loop of two cycles (40 frames) whose strip says `steps: 2` and whose cut witness says four steps: the two-cycle loop is left out under `left_out` (`["cycle-four-steps"]`) and named in the warning, its loop and strip kept as cut (40 frames, `steps: 2`), and the other two are aligned to their median length.- three walker loops with reports beside them, the third loop marked held (`cut_witness.held` "unwitnessed") or four steps (`cut_witness.says` "four steps", strip `steps: 2`, walker two cycles long): standalone `video-cycle-align` stops with one suspect, `held` value `{reason, report}`, `settle` value `=1` and `=2`, nothing rewritten; `--multi-cycle warn` aligns and names reason; `--cycles` 1 or 2 aligns it, suspect `status` "counted" (previously aligned as one cycle without a word).- **Tests**: `tests/video/test_one_step_cut.py`: a side walker whose cycle (42 frames) the walk window cannot hold is cut one step long (21 frames) by the pixel search, its feet read as unseen, and the step screen names it; before, the test said nothing else speaks (no `steps` and no warning about steps), whereas now there are still no `steps`, the walker is carried whole on its legs, so its cut witness holds the cut (`cut_witness.held` is `"unwitnessed"`, `local_cycle.unwitnessed` is true), and the one warning that speaks of steps is the witness's (`local_cycle.held_verdict`), naming `cycle-unwitnessed`. In a set of two items, the same walker on a 25-frame cycle (front, cut a whole cycle) and the one-step side walk, their rows now carry the marks `run_set` records (`cycle-unwitnessed` from `local_cycle.unwitnessed`, and `step_screen`) instead of rows built without them; both are left out of the alignment (`left_out` `["cycle-unwitnessed"]` each, `why: "fewer than two directions left to align"`), each warning says nothing witnesses its cut whole cycles and it may hold half a cycle or two, only the side walk's warning adds that it may be one step (cut it again with `video-loop --steps 1` if it is), `video-cycle-align` run on the items' loops reads the step screen in the report beside the side walk's loop and stops on it (`one_step`), naming `--steps 1`, and the set table still marks the side walk's cycle `(one step?)`. The walker carried whole on its legs across the two set tests: `video-cycle-align` now stops on both loops, each named `held`, `reason` "cycle-unwitnessed", the side loop also suspected one step; a count of one cycle for each settles it.+- **Tests**: `tests/video/test_cycle_suspects.py` and `tests/video/test_loop_prop_seam_held.py` cover standalone `video-cycle-align` on loops whose cut reports hold their cuts:+ - three synthetic loops in `tests/video/test_cycle_suspects.py` (S and E one stride of 24 frames each, NE two strides of 15 frames, 30 frames held on twos, as a two-cycle cut leaves it, with NE's cut report beside it as `video-loop` writes it holding its cut because nothing witnesses it whole cycles): stopping the set, run twice, names NE with its report beside it both for what the report holds (`held`, reason `cycle-unwitnessed`, with the report's path: it may hold half a cycle, one or two, and the message names `video-loop` to cut it again if it is one step) and for its return at 15 frames (it may also hold 2 cycles of 15 frames), while with the report removed (a loop cut by other means) it is named only for its return with no `held` and no mention of `video-loop`, both offering settle `=1` and `=2` with nothing rewritten (previously one run, NE named only for its return, and the message never named `video-loop`); `--multi-cycle warn` aligns the set as it is, NE's warning starting with nothing having witnessed its cut whole cycles and adding that it may also hold 2 cycles (previously the warning started with it may hold 2 cycles); the command line (`align.main`) without a count exits naming the held cut and the return at 15 frames, and with `--cycles NE=2` aligns as before (previously the exit named only the return).+ - two synthetic loops in `tests/video/test_loop_prop_seam_held.py` (one cut two steps long, one cycle, strip `steps: 2`, and one cut one cycle with no `steps`, neither walker's body rising and falling and its feet never passing, so both reports hold their cuts, nothing witnessing either whole cycles): on copies whose reports the test rewrites to witness their cuts (`cut_witness` saying "two steps" by the screen, nothing held), the aligner works as before: the two-step loop returns half way at its second step, which is no suspect (`status` "steps", `steps` 2, candidates `[2]`), and both loops are resampled to the median of their lengths as cut, nothing kept twice as long, the strip of the two-step copy still saying `steps: 2`, the other none; on the loops as cut, `video-cycle-align` stops on both, each named `held` with reason `cycle-unwitnessed`; a count of one cycle for each (`cycles`, the caller's word) aligns them as they are, to the same median length, each suspect `status` "counted"; a count of 2 for the two-step loop (and 1 for the other) still takes one half out of it, and its strip no longer says `steps`; two copies of the loop with no held part, aligned with a count of one cycle each, are written as before: no `cycles_kept` and no `steps` in their rows, their strip metadata with the same keys, and the cut's source (`source_cut`) as the cut wrote it (previously both aligned with no count, the two-step loop's return read as its steps).## v3.5.0 - Widened square canvas framing for side walk and run stride and trailing parts, measured background matte cutout for flat backgrounds of any colour, and failure when a cutout removes nothing