walkthrough.md

Portfolio: Chronicle Portrait Studio Final Polish

The latest updates transform the RPGPortrait studio into a fully-fledged character management tool with a focus on workflow and portability.

✨ Highlights

👤 Character Identity & Auto-Naming

We've moved beyond generic portraits. You can now define a Character Name which acts as the anchor for your creation:

• 🎲 Instant Naming: A new dice button next to the name field generates thematic fantasy names instantly.
• Zero Latency: Powered by a local procedural generator using the fictional-names library—no API tokens required.

📥 Named Downloads & Portability

Saving your work is now smarter:

• Automatic Filenames: Portraits and data files are saved with your character's name (e.g., Gildur_portrait_gemini.png).
• Embedded Metadata: Your generation prompts and character names are embedded directly inside the PNG file. You can view them in any image viewer with metadata support (like Windows Properties > Details).

📋 UI Workflow Improvements

• Clipboard Sync: Added native "Copy" buttons to all prompt outputs for quick sharing.
• Robustness: Implemented a background "UI Head-Check" to ensure the interface is always stable and error-free.

---

🛠️ Technical Implementation

• Library: Switched to fictional-names for high-quality, race-specific naming conventions (Tolkien, Viking, etc.).
• Metadata: Leveraged Pillow's PngInfo to inject context without bloating file size.
• Modular Fixes: Refactored the internal logic to ensure the character name propagates from the UI all the way to the final disk write.

Happy Portrait Crafting! ⚔️🛡️