Add documentation folder READMEs and visual previews
Create an index README in docs/ and every tracked docs subfolder, with relative image galleries for Blender previews, screen designs, screenshots and concepts. Generated realism-run READMEs were also created on disk but remain gitignored. Validate all Markdown/image links.
This commit is contained in:
zwitschi committed
1 parent
fbd2ab2cb3
commit
e79a37beba
8 files changed
+251
-33
No files matched your search
@@ -1,40 +1,83 @@
|
||||
# Scene concepts: the realistic target look
|
||||
|
||||
These are AI-generated example frames (`python3 tools/scene_concepts.py generate --group scene`,
|
||||
`openai/gpt-5-image-mini`, 1280×720) for the realism pass. They are art direction, not
|
||||
assets. `tools/scene_concepts.py realism` pairs them with the in-game shots from
|
||||
`src/test/capture_realism.gd` (see `SHOTS` in the tool). New generations never overwrite a
|
||||
file here; they are saved as `<name>-vN.png`.
|
||||
These are AI-generated example frames (`python3 tools/scene_concepts.py generate --group scene`, `openai/gpt-5-image-mini`, 1280×720) for the realism pass. They are art direction, not assets. `tools/scene_concepts.py realism` pairs them with the in-game shots from `src/test/capture_realism.gd` (see `SHOTS` in the tool). New generations never overwrite a file here; they are saved as `<name>-vN.png`.
|
||||
|
||||
| Concept | Visual targets it sets |
|
||||
| --- | --- |
|
||||
| `hollywood_entrance_morning` | warm low sun, long soft shadows, brick with visible mortar and wear, stone plinth, potted topiary, haze that fades the far street to beige |
|
||||
| `hollywood_entrance_golden_hour` | strong back light and rim light on people, marquee bulbs reading even in daylight |
|
||||
| `hollywood_entrance_rain_night` | dark scene lit by practical lights only (marquee, sodium lamps), wet glossy ground with reflections, fog |
|
||||
| `boulevard_skyline_day` | deep layered skyline with real towers and haze, palms lining the road, red curb paint, believable asphalt |
|
||||
| `boulevard_skyline_dusk` | purple/orange gradient sky, neon signs, lit windows, car light trails |
|
||||
| `joke_shop_alley_evening` | narrow brick alley, one warm wall lantern as key light, deep shadows, people in dark jackets |
|
||||
| `joke_shop_door_closeup` | close material detail: brick, mortar, aged wood door, brass |
|
||||
| `studio_stage_door_night` | granite facade, a bright bulb canopy as the main light, a glossy black car, stanchions and a barrier |
|
||||
| `sidewalk_material_closeup` | paver joints, stains, granite curb, aggregate asphalt and a tree grate at grazing light |
|
||||
| `entrance_steps_podium` | granite steps, handrails, glass doors, the check-in podium |
|
||||
| `crowd_barrier_line` | steel barriers, a red carpet, a crowd with depth-of-field haze |
|
||||
| `responder_arrival_wide` | fire engine, turnout gear, red/blue light spill on wet pavement |
|
||||
| `npc_portrait_day` | close portrait of a pedestrian: skin with visible pores and stubble, fabric weave, shallow depth of field. The bar for an avatar close-up, not for the crowd shots |
|
||||
## Concept list
|
||||
|
||||
The `npc_portrait` capture in `capture_realism.gd` is staged, not posed by the
|
||||
crowd: it freezes one NPC on an open patch of sidewalk, parks the rest of the
|
||||
crowd out of frame, turns the subject into the camera and stands the guard on the
|
||||
sunlit side. It is the only shot where a face fills the frame, so it is the one to
|
||||
eyeball after an avatar change (generate a local run under `docs/screens/realism/`).
|
||||
### Hollywood Entrance
|
||||
|
||||
|
||||
warm low sun, long soft shadows, brick with visible mortar and wear, stone plinth, potted topiary, haze that fades the far street to beige
|
||||
|
||||
### Hollywood Entrance Golden Hour
|
||||
|
||||
|
||||
strong back light and rim light on people, marquee bulbs reading even in daylight
|
||||
|
||||
### Hollywood Entrance Rain Night
|
||||
|
||||
|
||||
dark scene lit by practical lights only (marquee, sodium lamps), wet glossy ground with reflections, fog
|
||||
|
||||
### Boulevard Skyline
|
||||
|
||||
|
||||
deep layered skyline with real towers and haze, palms lining the road, red curb paint, believable asphalt
|
||||
|
||||
### Boulevard Skyline Dusk
|
||||
|
||||
|
||||
purple/orange gradient sky, neon signs, lit windows, car light trails
|
||||
|
||||
### Joke Shop Alley Evening
|
||||
|
||||
|
||||
narrow brick alley, one warm wall lantern as key light, deep shadows, people in dark jackets
|
||||
|
||||
### Joke Shop Door Closeup
|
||||
|
||||
|
||||
close material detail: brick, mortar, aged wood door, brass
|
||||
|
||||
### Studio Stage Door Night
|
||||
|
||||
|
||||
granite facade, a bright bulb canopy as the main light, a glossy black car, stanchions and a barrier
|
||||
|
||||
### Sidewalk Material Closeup
|
||||
|
||||
|
||||
paver joints, stains, granite curb, aggregate asphalt and a tree grate at grazing light
|
||||
|
||||
### Entrance Steps Podium
|
||||
|
||||
|
||||
granite steps, handrails, glass doors, the check-in podium
|
||||
|
||||
### Crowd Barrier Line
|
||||
|
||||
|
||||
steel barriers, a red carpet, a crowd with depth-of-field haze
|
||||
|
||||
### Responder Arrival Wide
|
||||
|
||||
|
||||
fire engine, turnout gear, red/blue light spill on wet pavement
|
||||
|
||||
### NPC Portrait Day
|
||||
|
||||
|
||||
close portrait of a pedestrian: skin with visible pores and stubble, fabric weave, shallow depth of field. The bar for an avatar close-up, not for the crowd shots
|
||||
|
||||
The `npc_portrait` capture in `capture_realism.gd` is staged, not posed by the crowd: it freezes one NPC on an open patch of sidewalk, parks the rest of the crowd out of frame, turns the subject into the camera and stands the guard on the sunlit side. It is the only shot where a face fills the frame, so it is the one to eyeball after an avatar change (generate a local run under `docs/screens/realism/`).
|
||||
|
||||
Cross-cutting targets, for comparison with locally generated realism runs:
|
||||
|
||||
- **Exposure.** The concepts keep the ground mid-grey. The game's sidewalk is close to white,
|
||||
so it is overexposed.
|
||||
- **Night means dark.** The night/dusk concepts are lit by practical lights. The game's
|
||||
"Evening" phase is a bright pink-orange frame.
|
||||
- **Depth.** The concepts show a layered skyline fading into haze. The new v2 skyline strips
|
||||
supply this; the old box skyline did not.
|
||||
- **Geometry and foliage.** The facades have plinths, cornices and deep window reveals, and the
|
||||
trees and shrubs are organic. The game uses flat walls and blob trees.
|
||||
- **Exposure.** The concepts keep the ground mid-grey. The game's sidewalk is close to white, so it is overexposed.
|
||||
- **Night means dark.** The night/dusk concepts are lit by practical lights. The game's "Evening" phase is a bright pink-orange frame.
|
||||
- **Depth.** The concepts show a layered skyline fading into haze. The new v2 skyline strips supply this; the old box skyline did not.
|
||||
- **Geometry and foliage.** The facades have plinths, cornices and deep window reveals, and the trees and shrubs are organic. The game uses flat walls and blob trees.
|
||||
|
||||
## Additional previews
|
||||
|
||||
|
||||
Reference in new issue
Block a user