softbox 4.18.0 → 4.20.0

package/README.md

@@ -32,6 +32,7 @@ Balanced studio lighting, a baked soft contact shadow that grounds the model, au
 ## What you get
 
 - **[Visual presets](#visual-presets)** — `studio · product · neutral · dark · outdoor`, one word, switched live
+- **[Scenes](#scenes)** — `studio_dome · studio_soft`, one word picks the set the model stands in
 - **[Turntable](#turntable)** — one-word showcase auto-rotate that pauses while the user drags
 - **[Animations](#animations)** — GLTF clips autoplay with one word; play/pause/clip-picker API
 - **[Photoreal mode](#photoreal-mode--stills)** — progressive path tracing + `captureStill()` PNG export
@@ -84,6 +85,26 @@ Let your users switch presets with the built-in picker (off by default):
 <SimpleViewer object={url} options={{ ui: { presets: true } }} />
 ```
 
+## Scenes
+
+Presets grade the picture; **scenes** choose the set. `options.scene` selects
+the physical set the model stands in — the floor, the backdrop and how the
+built-in studio environment is built. Unlike presets, a scene is structural:
+switching one rebuilds the viewer.
+
+```tsx
+<SimpleViewer object={url} options={{ scene: 'studio_soft' }} />
+// studio_dome (default) | studio_soft
+```
+
+- `studio_dome` — the default set: shadow-catcher floor, baked soft contact
+  shadow and a crisp, contrast-pushed studio light with distinct highlights.
+- `studio_soft` — the same set lit softly: an even, low-contrast wraparound
+  light that flatters matte materials and softens speculars.
+
+Scenes compose with presets — `scene` picks the set, `preset` grades it, and
+any explicit option you pass overrides both.
+
 ## Turntable
 
 One word puts the model on a slowly rotating showcase turntable. It pauses while the user drags and resumes on release; toggling is live, like presets.