Skip to content

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

refactor(spec): an external asset descriptor's kind is declared once, as spec.assets.ASSET_KIND, which load_asset reads and the shadow verb writes into shadow.asset.json

Soohong Kim374a18b1967f
diff --git a/sprite_gen/effects/shadow.py b/sprite_gen/effects/shadow.py
index 91d2cff..c042b28 100644
--- a/sprite_gen/effects/shadow.py
+++ b/sprite_gen/effects/shadow.py
@@ -196,7 +196,7 @@ def run(
source, out_dir = Path(source).resolve(), Path(out_dir).resolve()
# The shared adapter alone owns source formats and timing interpretation.
# Lazy import also keeps the pure image operation independent of file IO.
- from sprite_gen.spec.assets import load_asset
+ from sprite_gen.spec.assets import ASSET_KIND, load_asset
asset = load_asset(source, state=state, fps=fps, anchor=anchor)
if not asset.frames or len(asset.frames) != len(asset.durations):
@@ -227,7 +227,7 @@ def run(
payloads[target] = _png_bytes(rendered)
payloads[sheet_path] = _png_bytes(sheet)
descriptor = {
- "kind": "sprite-gen-asset", "version": 1,
+ "kind": ASSET_KIND, "version": 1,
"frames": [{"file": target.name, "duration": duration}
for target, duration in zip(targets, durations)],
"anchor": list(output_anchor),
diff --git a/sprite_gen/spec/assets.py b/sprite_gen/spec/assets.py
index f9f2ab3..f477e3b 100644
--- a/sprite_gen/spec/assets.py
+++ b/sprite_gen/spec/assets.py
@@ -20,6 +20,9 @@ from pathlib import Path
from PIL import Image
+# An external asset descriptor's kind: ordered frame files with their durations (`effects.shadow` writes one), read
+# by `load_asset`.
+ASSET_KIND = "sprite-gen-asset"
# The video-set direction sheet's kind: `video-set-sheet` writes it (`set_sheet.KIND` is this name, as set_sheet
# imports this module) and `load_asset` reads a descriptor that says it as one.
SET_SHEET_KIND = "sprite-gen-video-set-sheet"
@@ -275,7 +278,7 @@ def _load_asset(source, snapshot, *, state=None, fps=None, anchor=None):
raise ValueError("asset descriptor must be an object")
meta.update({key: data[key] for key in PLAYBACK_FIELDS if key in data})
declared_anchor = data.get("anchor")
- if data.get("kind") == "sprite-gen-asset":
+ if data.get("kind") == ASSET_KIND:
if data.get("version") != 1 or state is not None:
raise ValueError("external asset requires version 1 and no --state")
entries = data.get("frames")