Skip to content

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

Merge plan/size-hold-cut-reach-1024 (size-hold: a walk or run cut by hand (--cycle fixed, any anchor) is held as a search's cut is, before the cut is read, where the cut itself shows the change a cycle of its length apart — each frame of the cut read against one partner a cycle later or, where the clip ends before that, earlier (gait_fallback.at_cut); the hold holds the feet on the first frame's row where they climb or sink 1 % of the height or more, for motion-auto too; a cut that shows no change is cut as filmed and size_hold says why) into main, after held-walk-gate-picture-unit, validated in sprite-gen/size-hold-cut-reach-1024

Soohong Kim941dcf2e815e
diff --cc sprite_gen/video/loop.py
index a8d3de7,5d1ac8b..4a51966
--- a/sprite_gen/video/loop.py
+++ b/sprite_gen/video/loop.py
@@@ -2552,16 -2472,8 +2596,16 @@@ def add_arguments(parser: argparse.Argu
parser.add_argument("--unfixed", choices=UNFIXED_MODES, default="warn", help="walk/run, under --repair auto or on: a frame the jump repair leaves off the walk's flow — no group of up to two drawings brings it back, or the group that would was refused (its RIFE frame had a fault) — is recorded in jump_repair.unfixed; warn (default): a warning line, the loop kept; refuse: the loop fails")
parser.add_argument("--jolt-max", type=float, default=None, help=f"walk/run: fail the repaired loop when its jolt index (how far each step strays from its neighbours' mean, over the median step) exceeds this. Default: no gate — the index is reported and a value over {repair_mod.JOLT_REFERENCE} is a warning line")
parser.add_argument("--head-step-max", type=float, default=None, help=f"walk/run: fail the repaired loop when the head's largest sideways move in one frame exceeds this %% of the body height. Default: no gate — reported, and over {repair_mod.HEAD_STEP_REFERENCE} is a warning line")
+ parser.add_argument("--seam-pop-max", type=_seam_pop_max, default=repair_mod.SEAM_POP_REFERENCE, metavar="BOUND|off",
+ help=f"walk/run: fail the loop when the top of the silhouette (the head, or a part held above it) jumps into "
+ f"its first frame more than this many times its median step (`jolt.seam_pop`, read on the loop as it "
+ f"plays; default {repair_mod.SEAM_POP_REFERENCE:g}), a cut fixed by hand as one --anchor motion-auto "
+ "chooses — which reads the cuts it chooses among the same way and takes the next where the gate would "
+ "refuse the first. A top that cannot be read is not refused (`seam_pop_gate: unreadable`); a pinned "
+ f"cut is gated by its pin. --seam-max does not lift it. off: no gate — over {repair_mod.SEAM_POP_REFERENCE:g} "
+ "is a warning line (docs/loop-repair.md section 3, \"The seam pop\")")
parser.add_argument("--facing", choices=FACINGS, default="right", help="which way the body faces in the frames (default right): the jolt index's hair, and the size reading video-loop-compare's jump guard reads, are behind it; the jump repair reads the flow either way")
- parser.add_argument("--size-hold", choices=SIZE_HOLD_MODES, default="auto", help="--anchor motion-auto: auto (default) scales a clip whose height, read one cycle on (the same pose a cycle later), changes by 1 %% or more over the clip back to its first frame's size before the cycle search, so the loop's last frame is the size of its first (recorded as size_hold, with the evidence); off: search the frames as filmed")
+ parser.add_argument("--size-hold", choices=SIZE_HOLD_MODES, default="auto", help="walk/run, --anchor motion-auto or --cycle fixed: auto (default) scales a clip whose height, read one cycle on, changes by 1 %% or more over the clip back to its first frame's size about its feet, and moves its feet to the first frame's row where they climb or sink by 1 %% of the height or more, applied before the cycle search or over the whole clip before a fixed cut is read (a fixed cut is held only where the cut itself shows the change a cycle of its length apart; recorded as size_hold; a held cut is not restored from source frames); off: the frames as filmed, except motion-auto's gait fallback, which after a first search that finds nothing still scales back a change of 3 %% or more by the same reading, its feet where they were filmed (recorded as gait_fallback)")
parser.add_argument("--steps", type=int, choices=STEPS, default=None,
help="--anchor motion-auto: how many steps the cut it takes without this holds, as counted by whoever looked "
"at the loop (how often each foot lands) — the report's `cycle.step_screen` names a cut that may be one "