Skip to content

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

chore(release): prepare 2.15.0 a slow walk, or one that drifts toward the camera, still finds its loop

Soohong Kimfa2727bc7cf6
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fbeba66..2a1d748 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,16 @@
All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.
+## v2.15.0 - A slow walk, or one that drifts toward the camera, still finds its loop
+
+- When `video-loop --anchor motion-auto` finds no walk or run cycle, it now looks once more (`sprite_gen/video/gait_fallback.py`). A front walk asked to stay in place sometimes comes toward the camera, and the body grows through the clip, so the same pose never matches itself in size: when a straight-line fit of the subject's height changes by 3 % or more over the clip, every frame is scaled back to the first frame's height about its foot point, and the search, the cells and the seam gate all read the scaled-back frames. A calm walk in long clothing can also take longer than half the clip per cycle, the most the first search confirms: the second search allows up to 60 % of the clip and at most 2 s (43 frames of a 3 s clip at 24 fps, where the first stops at 36).
+- Only a failed search reaches this, so a clip that looped before is cut exactly as before, and every gate, the seam limit included, is unchanged. An explicit `--max-len` stays the ceiling. The report records what was tried in `gait_fallback`; when the second search fails too, the error still starts with `video-loop: no periodic cycle found` and says what was tried.
+- Measured on six stored 3 s front walks that had failed with `no periodic cycle found`: four loop now. Three takes of a kimono that hides the legs walked a 27 to 39 frame cycle (one clip grew 3.9 %, two grew 11 % and 16 %), and a front horse walk grew 6.4 % with a 42 frame cycle. One of the other two still shows no repeat; the other finds a 38 frame candidate that the seam gate refuses. On the walk clips we have kept, the median height change is 0.5 % and nine in ten stay under 2.7 %. Method: [docs/loop-review.md](docs/loop-review.md).
+
+![Kimono front walk: the forced cut beside the loops found in the same clips](https://github.com/aldegad/sprite-gen/releases/download/v2.15.0/kimono-walk-loop.webp)
+
+`kimono-walk-loop.mp4` is the same comparison as video.
+
## v2.14.0 - A single still can be drawn to a layout guide with crown and floor lines
- `gen --layout-guide` attaches the one-slot form of the row layout guide after any `--ref`: the frame, the inner safe box at the row guide's 9.4 % margin, the centre line, and an orange crown line and a teal floor line one margin inside the safe box (about 19 % and 81 % of the frame height). The prompt says what each line means: the anatomical top of the skull on the orange line, ignoring hair, hats, raised limbs and props; the supporting soles on the teal line, which is a ground-contact line and not a frame edge; nothing of the guide in the output. A still drawn from words tends to fill its frame top to bottom, and an in-place motion then has no room above the head. The lines sit inside the box because on its edges a crown line leaves hair and hats to fill the room above it and a floor line reads as a border the feet float above.
diff --git a/SKILL.md b/SKILL.md
index 5fa1104..05840c1 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.14.0
+version: 2.15.0
description: "Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation. Handles sprite requests, ordinary image generation/editing, standalone image-to-video clips (i2v, animate this still, 그록 영상, 이매진 비디오, 스틸 움직여줘, first/last frame, reference-to-video, 영상 이어붙이기, 영상 편집, extend/edit a clip), chroma removal, animation atlases, video loops, 큐레이션뷰, image candidates, 팔레트 스왑, palette swap, recolor, rig layers, engine exports, repeating backgrounds, projected shadows, motion/contact inspection and optional scene composition from existing assets."
license: Apache-2.0
depends_on:
diff --git a/pyproject.toml b/pyproject.toml
index d58d639..17681ed 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
name = "sprite-gen"
# Release discipline: keep this package metadata version synchronized with
# SKILL.md's `version:` field in the same release commit.
-version = "2.14.0"
+version = "2.15.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"