Chronicle / walkthrough.md
topguy's picture
UX Polish, Metadata Embedding & Local Name Generation
de132df
# 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!** ⚔️🛡️