Skip to content

🎨 Assets & Placeholder Generator

πŸ“ Asset Structure

assets/
β”œβ”€β”€ bg/    # Background images (opaque)
β”œβ”€β”€ sta/   # Pose/stance images (transparent)
β”œβ”€β”€ act/   # Action images (transparent)
β”œβ”€β”€ exp/   # Expression images (transparent)
β”œβ”€β”€ cg/    # CG illustrations (full-scene, replaces all other layers)
└── manifest.json

Browse the full asset directory on GitHub: assets/

πŸ“ Canvas Size

All assets share the same canvas size (default: 1024x1024) with consistent alignment anchors.

πŸ› οΈ Placeholder Generator

Generate debug placeholder assets:

uv run talk2scene mode=generate-assets

✨ Features:

  • ⬜ Transparent PNGs for STA/EXP/ACT
  • ⬛ Opaque PNGs for BG and CG
  • 🏷️ Visual debug labels with code text
  • 🌈 Color-coded by category
  • πŸ”„ Idempotent (use --force to regenerate)
  • πŸ“„ Writes asset manifest

πŸ“‡ Manifest

assets/manifest.json contains paths, sizes, and anchor info for all generated assets.