three-cad-viewer 4.3.7 → 4.3.8

package/dist/rendering/environment.d.ts

@@ -31,6 +31,14 @@ interface EnvironmentManagerOptions {
 declare class EnvironmentManager {
     /** Cached PMREM render targets keyed by environment name or URL */
     private _cache;
+    /**
+     * Cached raw equirectangular HDR textures keyed by the same name/URL.
+     * Preserved (not disposed after PMREM generation) so `scene.background`
+     * can sample the original HDR at full source resolution instead of the
+     * 256² PMREM cubemap. Only populated by `_loadHdr` — procedural
+     * environments have no source HDR.
+     */
+    private _hdrCache;
     /** Cached light detection results keyed by environment name or URL */
     private _lightDetectionCache;
     /** In-flight load promises keyed by environment name or URL */
@@ -47,6 +55,13 @@ declare class EnvironmentManager {
     private _hdrLoader;
     /** The last loaded PMREM texture (stateful — used by apply() for IBL) */
     private _currentTexture;
+    /**
+     * Raw HDR texture corresponding to `_currentTexture`, used for
+     * `scene.background` to keep the backdrop at source resolution. Null when
+     * the current environment is procedural ("studio" RoomEnvironment) — in
+     * that case the background falls back to `_currentTexture` (the PMREM).
+     */
+    private _currentBackgroundTexture;
     /** Whether this manager has been disposed */
     private _disposed;
     /**
@@ -221,9 +236,10 @@ declare class EnvironmentManager {
      * Load an HDR file and generate a PMREM texture from it.
      *
      * Uses HDRLoader to fetch the .hdr file, then PMREMGenerator.fromEquirectangular()
-     * to create the PMREM cubemap. The source equirectangular texture is disposed
-     * after PMREM generation. The PMREM texture itself serves as both the IBL
-     * environment and the background (in "environment" mode).
+     * to create the PMREM cubemap for IBL. The source equirectangular HDR is
+     * preserved and cached separately (in `_hdrCache`) so that "environment"
+     * background mode can sample the full-resolution equirectangular texture
+     * instead of the 256² PMREM cubemap.
      *
      * @param url - URL of the .hdr file
      * @param cacheKey - Cache key for the resulting PMREM render target