Skip to content

πŸ’ƒ Free CC0 mannequin pose reference library for AI image tools (Nano Banana, ChatGPT, ComfyUI, Midjourney) β€” 250+ poses Γ— 5 angles in line art, names in ja/zh/en/ko

2.9 KB
Raw Blame
#!/usr/bin/env python3
"""Merge one generated series (a pose-gallery-* folder) into data/catalog.json.

Usage: python3 tools/import_series.py SRC --series sexy --added 0.2.0 [--general Cute,...]
Entries of that series are replaced; others are kept. Views become bare file names (null = not generated).
--general lists class_en values rated "general"; every other category of the series is "suggestive".
Without --general the whole series is rated by --rating (default general).
Per-pose decisions in data/rating_overrides.json (docs/qc/README.md, rating check) win over the category rule.
A pose redrawn from another source (tools/import_redraws.py) keeps its `source`, views and gaps.
"""
import argparse, json, pathlib

ROOT = pathlib.Path(__file__).resolve().parent.parent
VIEWS = ("front", "diag", "side", "above", "below")
FIELDS = ("id", "orig_id", "series", "added_in", "rating", "class_jp", "class_cn", "class_en", "class_kr",
          "name_jp", "name_cn", "name_en", "name_kr", "desc_en", "views", "photos")
OPTIONAL = ("bodies",)  # duo: MF / FF figure pairing; kept only when the source has it
REDRAWN = ("source", "views", "gaps")


def main() -> None:
    ap = argparse.ArgumentParser()
    ap.add_argument("src")
    ap.add_argument("--series", required=True)
    ap.add_argument("--added", required=True)
    ap.add_argument("--general", default="")
    ap.add_argument("--rating", default="general", choices=("general", "suggestive"))
    a = ap.parse_args()
    general = {s for s in a.general.split(",") if s}
    ov_path = ROOT / "data/rating_overrides.json"
    overrides = json.loads(ov_path.read_text()) if ov_path.exists() else {}
    src = json.loads((pathlib.Path(a.src).expanduser() / "catalog.json").read_text())
    path = ROOT / "data/catalog.json"
    old = json.loads(path.read_text())
    redrawn = {p["id"]: {k: p[k] for k in REDRAWN} for p in old if p.get("series") == a.series and p.get("source")}
    # Source sets after std carry no desc_en; keep the one tools/import_descs.py filled in.
    descs = {p["id"]: p.get("desc_en", "") for p in old if p.get("series") == a.series}
    cat = [p for p in old if p.get("series") != a.series]
    for p in src:
        q = dict(p)
        q["series"] = a.series
        q["added_in"] = a.added
        q["rating"] = ("general" if p["class_en"] in general else "suggestive") if general else a.rating
        q["rating"] = overrides.get(p["id"], {}).get("rating", q["rating"])
        q["desc_en"] = p.get("desc_en") or descs.get(p["id"], "")
        q["views"] = {v: (pathlib.Path(p["views"][v]).name if p["views"].get(v) else None) for v in VIEWS}
        q.setdefault("photos", [])
        cat.append({k: q.get(k) for k in FIELDS} | {k: q[k] for k in OPTIONAL if q.get(k)} | redrawn.get(p["id"], {}))
    path.write_text(json.dumps(cat, ensure_ascii=False, indent=1) + "\n")
    print(f"{a.series}: {len(src)} poses; catalog now {len(cat)}")


if __name__ == "__main__":
    main()