Add character portraits gym

docs/gyms/gym10_character_portraits/gym10_multichar.dtl

@@ -0,0 +1,70 @@
+# ============================================================
+# Gym 10.3 — Multi-Character Scenes
+# ============================================================
+# Demonstrates managing 3+ characters on screen:
+# join orchestration, z-index stacking, leave/rejoin flow.
+# ============================================================
+
+leave --All--
+
+# ---- Build up a full scene ----
+join Miko (neutral) center [animation="Fade In"]
+join Advisor (pl5) right [animation="Fade In" wait="true"]
+join Merchant (happy) left [animation="Fade In" wait="true"]
+
+Miko (neutral): Three characters on screen!
+Advisor (pl5): This is a full conversation scene.
+Merchant (happy): I feel included!
+
+[wait time="1.0"]
+
+# ---- Demonstrate z-index with 3 overlapping chars ----
+leave --All--
+
+join Miko (joy) center [animation="Fade In" z_index="2"]
+Miko (joy): Center with z_index 2.
+
+join Advisor (pl5) pos=x0.45y0.5 size=y400px rot=0 [animation="Fade In" z_index="1"]
+Advisor (pl5): Moved slightly left, behind Miko (z_index 1).
+
+join Merchant (surprise) pos=x0.55y0.5 size=y400px rot=0 [animation="Fade In" z_index="3"]
+Merchant (surprise): Moved slightly right, with highest z_index (3)!
+
+[wait time="1.5"]
+
+Miko (smile): Notice the stacking — Merchant is on top, then me, then Advisor.
+Advisor (doubt): This is how you control who appears in front.
+
+[wait time="1.5"]
+
+# ---- Leave and rejoin (dynamic cast) ----
+leave Merchant [animation="Fade Down"]
+
+Miko (neutral): The merchant left. Now it's just the two of us.
+
+[wait time="0.5"]
+
+join Merchant (happy) left [animation="Bounce In"]
+
+Merchant (happy): I'm back! And I moved to the left.
+
+[wait time="1.0"]
+
+Advisor (pl5): Characters can leave and rejoin at different positions.
+Advisor (doubt): This is essential for scene direction — characters\
+enter and exit the conversation naturally.
+
+[wait time="1.5"]
+
+# ---- Leave all at once ----
+Miko (smile): And with one command...
+leave --All-- [animation="Fade Down"]
+
+[wait time="1.0"]
+
+Advisor (pl5): `leave --All--` clears the stage instantly.
+Miko (neutral): Useful for scene transitions!
+
+[wait time="1.0"]
+
+jump gym10_main/menu