Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
feat(chroma): report changed pixels and document the tint outcome
Soohong Kimac886b5edbd7
diff --git a/sprite_gen/frames/decontam.py b/sprite_gen/frames/decontam.pyindex 3738639..f86b0a2 100644--- a/sprite_gen/frames/decontam.py+++ b/sprite_gen/frames/decontam.py@@ -36,6 +36,9 @@ Guards, in order of the decision they make:when the subject owns no key-coloured material is a residual key hue on such apixel capped (`KEY_HUE_TINT`), which lowers the keyed channel and never raisesanother.+- *Tint.* Between the two: a pixel pushed from its colour toward the key by at+ least `TINT_SHIFT`, and `TINT_RATIO` times more than the fit misses by, is+ recoloured with its coverage left alone (a faint cast, not proven coverage).- *Depth.* Coverage is refitted only within `alpha_depth` of the keyed region(the engine's unmix reach, same meaning). Deeper band pixels get colour only,so a key reflection on a solid surface is recoloured, not turned see-through.@@ -341,6 +344,7 @@ def decontaminate(source_rgb: np.ndarray, keyed: np.ndarray, keyed_mask: np.ndarout[detached] = 0out[out[..., 3] == 0] = 0recovered = int(np.count_nonzero(flank & (out[..., 3] > 0)))+ changed = int(np.count_nonzero((out != np.asarray(keyed, dtype=np.uint8)).any(axis=-1)))stats = {"mode": "palette","fit": fit,@@ -354,6 +358,7 @@ def decontaminate(source_rgb: np.ndarray, keyed: np.ndarray, keyed_mask: np.ndar"key_material_share": round(key_material, 5),"noise_sigma_rgb": round(sigma_rgb, 3),"opaque_margin": round(margin, 3),+ "changed_px": changed,"refit_px": int(np.count_nonzero(blend & ~tinted)),"tint_px": int(np.count_nonzero(tinted)),"recovered_px": recovered,diff --git a/sprite_gen/video/frames.py b/sprite_gen/video/frames.pyindex f921a14..9ab3993 100644--- a/sprite_gen/video/frames.py+++ b/sprite_gen/video/frames.py@@ -53,7 +53,7 @@ EDGE_MAX_PIXELS = 0 # any opaque pixel on the top/left/right edge band = contac# learned on the first frame, so the colours an edge may take cannot change between frames.DECONTAM_MODES = ("off", "palette")DECONTAM_FIT = "video"-DECONTAM_STAT_KEYS = ("refit_px", "tint_px", "recovered_px", "unexplained_px", "key_hue_capped_px")+DECONTAM_STAT_KEYS = ("changed_px", "refit_px", "tint_px", "recovered_px", "unexplained_px", "key_hue_capped_px")def _require(binary: str) -> str: