beckhoff-xts-viewer-3d 4.1.0 → 4.2.0

package/dist/index.d.cts

@@ -12,7 +12,7 @@ import { GLTF } from 'three-stdlib';
  * Run `npm run sync-version` (or any script that depends on it) to refresh
  * after bumping the package version.
  */
-declare const VERSION: "4.1.0";
+declare const VERSION: "4.2.0";
 
 /**
  * Default CDN URL for the GLB asset bundle (`beckhoff-xts-viewer-3d-assets`).
@@ -508,6 +508,48 @@ interface DisplayOptions {
      * Default: `1.0`.
      */
     toneMappingExposure?: number;
+    /**
+     * Screen-space ambient occlusion (GTAO). Adds contact shadows in
+     * crevices and between adjacent surfaces for significantly more visual
+     * depth. Cost: one half-res pass per frame.
+     *
+     * Default: `false`.
+     */
+    ssao?: boolean;
+    /**
+     * SSAO blend intensity. Higher values darken crevices more.
+     * Range: 0.0–4.0. Default: `1.0`.
+     */
+    ssaoIntensity?: number;
+    /**
+     * SSAO sampling radius in world units (mm). Larger values spread the
+     * occlusion over a wider area. Default: `20`.
+     */
+    ssaoRadius?: number;
+    /**
+     * Bloom (glow) for bright metallic surfaces. Adds a soft halo around
+     * polished rails and highlights, giving metals a more realistic
+     * reflective appearance. Cost: one half-res pass per frame.
+     *
+     * Default: `false`.
+     */
+    bloom?: boolean;
+    /**
+     * Bloom intensity (strength). Higher values produce brighter glow.
+     * Range: 0.0–3.0. Default: `0.4`.
+     */
+    bloomIntensity?: number;
+    /**
+     * Bloom luminance threshold. Only pixels brighter than this value
+     * contribute to the bloom. Lower values bloom more of the scene.
+     * Range: 0.0–1.0. Default: `0.85`.
+     */
+    bloomThreshold?: number;
+    /**
+     * Bloom blur radius. Controls how far the glow spreads.
+     * Range: 0.0–1.0. Default: `0.4`.
+     */
+    bloomRadius?: number;
 }
 /**
  * Style + placement overrides for the per-mover-id 3D text labels
@@ -1632,6 +1674,28 @@ interface XtsViewer3DProps {
         maxFps?: number;
         instancing?: boolean;
         autoPauseOnHidden?: boolean;
+        /**
+         * Enable demand rendering: frames only render when something changes
+         * (camera move, mover position update, selection). Saves >90% GPU
+         * time when the scene is idle. Default: true.
+         */
+        demandRendering?: boolean;
+        /**
+         * Cap the device pixel ratio. Values above 2 rarely improve
+         * perceptible quality but double fill-rate cost on Retina/4K
+         * displays. Default: 2.
+         */
+        maxDpr?: number;
+        /**
+         * Disable automatic per-frame shadow map updates. Shadows only
+         * re-render on camera change. Default: true (when shadows enabled).
+         */
+        shadowOnDemand?: boolean;
+        /**
+         * Opt into the WebGPU renderer when the browser supports it.
+         * Falls back to WebGL automatically. Default: false (experimental).
+         */
+        webgpu?: boolean;
     };
     /**
      * Live override of the per-asset origin-correction sidecars. Useful for

package/dist/index.d.ts

@@ -12,7 +12,7 @@ import { GLTF } from 'three-stdlib';
  * Run `npm run sync-version` (or any script that depends on it) to refresh
  * after bumping the package version.
  */
-declare const VERSION: "4.1.0";
+declare const VERSION: "4.2.0";
 
 /**
  * Default CDN URL for the GLB asset bundle (`beckhoff-xts-viewer-3d-assets`).
@@ -508,6 +508,48 @@ interface DisplayOptions {
      * Default: `1.0`.
      */
     toneMappingExposure?: number;
+    /**
+     * Screen-space ambient occlusion (GTAO). Adds contact shadows in
+     * crevices and between adjacent surfaces for significantly more visual
+     * depth. Cost: one half-res pass per frame.
+     *
+     * Default: `false`.
+     */
+    ssao?: boolean;
+    /**
+     * SSAO blend intensity. Higher values darken crevices more.
+     * Range: 0.0–4.0. Default: `1.0`.
+     */
+    ssaoIntensity?: number;
+    /**
+     * SSAO sampling radius in world units (mm). Larger values spread the
+     * occlusion over a wider area. Default: `20`.
+     */
+    ssaoRadius?: number;
+    /**
+     * Bloom (glow) for bright metallic surfaces. Adds a soft halo around
+     * polished rails and highlights, giving metals a more realistic
+     * reflective appearance. Cost: one half-res pass per frame.
+     *
+     * Default: `false`.
+     */
+    bloom?: boolean;
+    /**
+     * Bloom intensity (strength). Higher values produce brighter glow.
+     * Range: 0.0–3.0. Default: `0.4`.
+     */
+    bloomIntensity?: number;
+    /**
+     * Bloom luminance threshold. Only pixels brighter than this value
+     * contribute to the bloom. Lower values bloom more of the scene.
+     * Range: 0.0–1.0. Default: `0.85`.
+     */
+    bloomThreshold?: number;
+    /**
+     * Bloom blur radius. Controls how far the glow spreads.
+     * Range: 0.0–1.0. Default: `0.4`.
+     */
+    bloomRadius?: number;
 }
 /**
  * Style + placement overrides for the per-mover-id 3D text labels
@@ -1632,6 +1674,28 @@ interface XtsViewer3DProps {
         maxFps?: number;
         instancing?: boolean;
         autoPauseOnHidden?: boolean;
+        /**
+         * Enable demand rendering: frames only render when something changes
+         * (camera move, mover position update, selection). Saves >90% GPU
+         * time when the scene is idle. Default: true.
+         */
+        demandRendering?: boolean;
+        /**
+         * Cap the device pixel ratio. Values above 2 rarely improve
+         * perceptible quality but double fill-rate cost on Retina/4K
+         * displays. Default: 2.
+         */
+        maxDpr?: number;
+        /**
+         * Disable automatic per-frame shadow map updates. Shadows only
+         * re-render on camera change. Default: true (when shadows enabled).
+         */
+        shadowOnDemand?: boolean;
+        /**
+         * Opt into the WebGPU renderer when the browser supports it.
+         * Falls back to WebGL automatically. Default: false (experimental).
+         */
+        webgpu?: boolean;
     };
     /**
      * Live override of the per-asset origin-correction sidecars. Useful for