softbox 4.21.0 → 4.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -32,7 +32,7 @@ Balanced studio lighting, a baked soft contact shadow that grounds the model, au
32
32
  ## What you get
33
33
 
34
34
  - **[Visual presets](#visual-presets)** — `studio · product · neutral · dark · outdoor`, one word, switched live
35
- - **[Scenes](#scenes)** — `studio_dome · studio_soft`, one word picks the set the model stands in
35
+ - **[Scenes](#scenes)** — `studio_dome · studio_soft · outdoor_concrete`, one word picks the set the model stands in
36
36
  - **[Turntable](#turntable)** — one-word showcase auto-rotate that pauses while the user drags
37
37
  - **[Animations](#animations)** — GLTF clips autoplay with one word; play/pause/clip-picker API
38
38
  - **[Photoreal mode](#photoreal-mode--stills)** — progressive path tracing + `captureStill()` PNG export
@@ -93,14 +93,23 @@ built-in studio environment is built. Unlike presets, a scene is structural:
93
93
  switching one rebuilds the viewer.
94
94
 
95
95
  ```tsx
96
- <SimpleViewer object={url} options={{ scene: 'studio_soft' }} />
97
- // studio_dome (default) | studio_soft
96
+ <SimpleViewer object={url} options={{ scene: 'outdoor_concrete' }} />
97
+ // studio_dome (default) | studio_soft | outdoor_concrete
98
98
  ```
99
99
 
100
100
  - `studio_dome` — the default set: shadow-catcher floor, baked soft contact
101
101
  shadow and a crisp, contrast-pushed studio light with distinct highlights.
102
102
  - `studio_soft` — the same set lit softly: an even, low-contrast wraparound
103
103
  light that flatters matte materials and softens speculars.
104
+ - `outdoor_concrete` — open air: a daylight HDRI lights the model and paints
105
+ the sky (ground-projected, so the model stands *in* the world), on a large
106
+ photographic PBR concrete ground rendered with untiled sampling — no
107
+ visible texture repetition at any distance. The HDRI and concrete maps
108
+ (CC0, [Poly Haven](https://polyhaven.com/), ~6 MB total on first view)
109
+ come from their CDN by default; override or self-host via
110
+ `environment.url` and `helpers.grid.styleOptions`, like the
111
+ [decoder paths](#loaders). Offline, the ground falls back to a built-in
112
+ procedural concrete and the lighting to the studio environment.
104
113
 
105
114
  Scenes compose with presets — `scene` picks the set, `preset` grades it, and
106
115
  any explicit option you pass overrides both.