additional samples and docs reworking

README.md

@@ -41,7 +41,7 @@ It is a drop-in replacement for MOSS-Image Base: the same architecture, text enc
 
 More in [`samples/`](samples): [`portraits`](samples/portraits) (8-step street portraits),
 [`scenes`](samples/scenes) (8-step film scenes), [`scenes-50steps`](samples/scenes-50steps) (Full HD, 50 steps),
-[`pairs`](samples/pairs) (two people) and [`no-people`](samples/no-people).
+[`pairs`](samples/pairs) (two people), [`trios`](samples/trios) (three people) and [`no-people`](samples/no-people).
 
 ## Files
 
@@ -103,7 +103,7 @@ warehouse corridor at night, cold blue moonlight, 1990s film grain, cinematic fi
   leather duster coat in the cargo bay of a worn frontier spaceship" works, a film title does not.
 - **Write "photo of", not "RAW photo of"**: the word RAW can end up painted into the background.
 - **Two people: a man and a woman work well; two of the same gender are hit-or-miss.** See
-  [Two people in one shot](#two-people-in-one-shot).
+  [Two people in one shot](#two-people-in-one-shot) and [Three people](#three-people-in-one-shot).
 - Without a trigger, `photo of a woman, ...` gives an ordinary person, as in the base model.
 
 ## Characters
@@ -170,10 +170,28 @@ Samples (50 steps): [Firefly](samples/pairs/pair_firefly_nathan_morena_1_50steps
 [stadium duet](samples/pairs/pair_duet_taylor_miley_1_50steps_00001_.png) and the
 [palace audience](samples/pairs/pair_palace_helen_gillian_1_50steps_00001_.png) keep two distinct women.
 Others don't: in [this library scene](samples/pairs/pair_library_emma_jenna_1_50steps_00001_.png) the
-second woman has the right braids, collar and dress, yet a face pulled toward the first. Both triggers
+second woman has the right braids, collar and dress, yet a face pulled toward the first, and two men
+[on a beach](samples/pairs/pair_surf_brad_keanu_1_50steps_00001_.png) do the same (the second loses most
+of his likeness). Both triggers
 share the class word (`a woman`), which is likely where they meet. Costumes and hair always stay apart;
 the faces are what can drift. Try several seeds, or render each person separately.
 
+### Three people in one shot
+
+The same rule holds with three: **faces stay distinct across class words, and drift within one.**
+
+- **[One woman, two men](samples/trios/trio_matrix_keanu_olivia_samuel_1_50steps_00001_.png)** (a rainy
+  city alley): all three keep their own faces.
+- **[One man, two women](samples/trios/trio_firefly_nathan_morena_felicia_2_50steps_00001_.png)** (a
+  spaceship cargo bay): the man is solid; the two women keep their costumes and hair, but their faces
+  move partly toward each other.
+- **[Three women](samples/trios/trio_hogwarts_emma_jenna_sadie_1_50steps_00001_.png)** (a castle dining
+  hall): braids, red hair and house ties are all right, yet all three faces converge on the strongest
+  identity of the three.
+
+So for groups, mix genders where you can, and render same-gender groups with several seeds, or
+person by person.
+
 The film scenes describe each role's look (costume, hair, setting) rather than naming the film,
 which the model does not know: see [docs/generating.md](docs/generating.md#prompting).
 

docs/generating.md

@@ -135,7 +135,9 @@ colorful wristband lights behind her, warm golden spotlight
 - **Two people: a man and a woman work; two of the same gender are hit-or-miss.** Name both with their
   class word, place them (`on the left ...; on the right ...`) and describe each separately. A
   man and a woman keep their own faces; two women (or two men) always keep their costumes, but in some
-  seeds their faces drift toward each other. See [Two people in one shot](../README.md#two-people-in-one-shot).
+  seeds their faces drift toward each other. Three people follow the same rule: one woman with two
+  men holds, three women converge on one face. See [Two people in one shot](../README.md#two-people-in-one-shot)
+  and [Three people in one shot](../README.md#three-people-in-one-shot).
 - **No trigger, no person:** `photo of a woman, ...` gives an ordinary person; prior preservation
   kept the class words close to the base model.
 - **Seeds:** likeness varies a little by seed; try a few.