Add character portraits gym

docs/gyms/gym10_character_portraits/README.md

@@ -0,0 +1,25 @@
+# Gym 10 — Character & Portrait Gym
+
+Tests every aspect of Dialogic's character/portrait system.
+
+## Demos
+
+| # | Timeline | What it covers |
+|---|----------|---------------|
+| 1 | `gym10_positions` | Preset positions (left/center/right/leftmost/rightmost), manual pos=, z-index stacking |
+| 2 | `gym10_portrait_switch` | `[portrait=name]` mid-text switching, emotional arcs, variable-driven portraits |
+| 3 | `gym10_multichar` | 3+ characters on screen, z-index layering, dynamic leave/rejoin flow |
+| 4 | `gym10_transforms` | mirror, scale, offset, rotation, smooth move transitions |
+| 5 | `gym10_spine` | Raptor's spine-animated portraits (walk/jump/roar) vs static PNG portraits |
+
+## Characters Used
+
+- **Miko** — portraits: neutral, smile, joy, anger, shock
+- **Advisor** — portraits: pl5, blink, doubt, surprise
+- **Merchant** — portraits: happy, blink, surprise, confusion
+- **Raptor** — spine-animated portraits: walk, jump, roar
+
+## How to Run
+
+- **From hub:** Pick option 10 in the main gym hub
+- **Standalone:** Open `gym10_main.tscn` → F6