Skip to content

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

release: 2.42.0 candidate — the CHANGELOG section named for the release

Soohong Kim4c301e6afd76
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d1e97a8..e88fcd9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.
-## Unreleased (v2.42.0)
+## v2.42.0 - A set's directions on one sheet, standing on one ground line; a loop whose strip as cut is missing is refused by name
- **New `sprite-gen video-set-sheet`: the directions of one set on one sheet, standing on one ground line.** Each direction is cut on its own and a strip is the union of its own cycle's bodies, so laid side by side the directions stand at different heights and cell sizes. `video-set-sheet --loop-dir <dir> --view <view> …` (the views as `video-cycle-align` takes them; a strip turned over to face the other way is a direction like any other) writes `<name>.sheet.png` and `<name>.sheet.json`: a row per direction in the compass order S, SW, W, NW, N, NE, E, SE whatever order the loops are given in, a frame a column; one cell that holds every pixel of every cell of every direction, centred on the pivot each strip declares (`anchor`) or else its bottom centre, so every cell's pivot is its bottom centre; one ground line, `baseline_y`, the lowest body pixel (alpha 8 and over, as `video-loop` reads a body) of any cell — a fainter pixel, a soft shadow, is kept in the cell below the line and is no body — (a direction whose strip leaves room under its feet stands that much above it, as cut: `body_bottom_y`); and every row as cut, pixel for pixel — nothing is scaled direction by direction, one size across a set is `video-loop --body-height`'s. `--center <still>` stands a transparent still (the set's base) with its body on the same line at the rows' standing height (the median of their `body_h`, against the still's own as `video-loop` reads one), centred, in `<name>.center.png`. Loops of different lengths, in frames or frame time, are laid all the same, the shorter rows' last cells empty, with `same_length: false` and a warning. The record carries `order`, `columns`, `cell_w`, `cell_h`, `baseline_y`, `anchor`, `same_length`, per row its `code`, `view`, `frames`, `delay_ms`, strip `name`, `input`, `strip_sha256`, `body_h` and `body_bottom_y`, and the centre's `png`, `input`, `sha256`, `standing_h`, `body_h`, `scale` and `box`. A direction given twice, a front or back view with a side, a `--view` count other than the loops', a loop directory without one strip and its sidecar, an opaque centre still and a centre beside rows without `body_h` are refused before anything is written. The loop directories are only read. Every other verb writes what 2.41.0 writes. [docs/video-pipeline.md](docs/video-pipeline.md#7-one-sheet-for-a-set--video-set-sheet).
- **`tests/video/test_set_sheet.py`** lays synthetic strips of different sizes, one standing above its strip's bottom and one with a declared pivot: the rows come out in compass order from any order given, every cell is its strip's cell pixel for pixel with no alpha lost, the lowest body pixel of any cell is the ground line and the floating direction stands its gap above it, a soft shadow under the feet is kept below the line with no alpha lost, the cell is the bodies' union about the pivot and touches it where they do, and a declared pivot lands on the cell's centre. A sheet laid by hand — every strip centred in one wide cell and stood on its bottom, the ground line the lowest pixel of any cell — is the engine's sheet cropped by one offset, cell for cell, its ground line the same line. A centre still drawn twice the rows' size and wider than them, with a faint shadow, stands its body on the line at the rows' median standing height, centred, the cell made to hold it and its shadow. Rows of 12 and 10 frames, or of one length at two frame times, are laid and said to differ; each refusal writes nothing.