@base2datadesign/viewer-kit 0.2.13 → 0.2.15

package/dist/camera.d.ts

@@ -0,0 +1,28 @@
+import * as THREE from "three";
+export type CameraFrameMode = "iso" | "interior";
+export type CameraFrameConfig = {
+    mode?: CameraFrameMode;
+    padding?: number;
+    direction?: [number, number, number];
+};
+export type CameraNormalizationConfig = {
+    recenter?: boolean;
+    floorToZero?: boolean;
+    normalizePlan?: {
+        target?: number;
+        maxScale?: number;
+    };
+};
+export type CameraNormalizationResult = {
+    bounds: THREE.Box3;
+    center: THREE.Vector3;
+    size: THREE.Vector3;
+    scale: number;
+    offset: THREE.Vector3;
+};
+export declare const normalizeObject3d: (object: THREE.Object3D, config?: CameraNormalizationConfig) => CameraNormalizationResult;
+export declare const computeCameraFrame: (bounds: THREE.Box3, fovDegrees: number, config?: CameraFrameConfig) => {
+    position: THREE.Vector3;
+    target: THREE.Vector3;
+};
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,UAAU,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;CACvB,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,KAAK,CAAC,QAAQ,EACtB,SAAS,yBAAyB,KACjC,yBA8CF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,KAAK,CAAC,IAAI,EAClB,YAAY,MAAM,EAClB,SAAS,iBAAiB,KACzB;IAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CAmBlD,CAAC"}

package/dist/camera.js

@@ -0,0 +1,62 @@
+import * as THREE from "three";
+const DEFAULT_FRAME_PADDING = 1.22;
+const DEFAULT_FRAME_DIRECTION = [1, 0.7, 1];
+export const normalizeObject3d = (object, config) => {
+    const resolved = config ?? {};
+    const offset = new THREE.Vector3();
+    let scale = 1;
+    object.updateMatrixWorld(true);
+    let bounds = new THREE.Box3().setFromObject(object);
+    let size = new THREE.Vector3();
+    let center = new THREE.Vector3();
+    bounds.getSize(size);
+    bounds.getCenter(center);
+    const targetPlan = resolved.normalizePlan?.target;
+    if (typeof targetPlan === "number" && Number.isFinite(targetPlan) && targetPlan > 0) {
+        const planMax = Math.max(size.x, size.z);
+        if (planMax > 1e-6) {
+            const maxScale = resolved.normalizePlan?.maxScale ?? 3;
+            scale = Math.min(maxScale, targetPlan / planMax);
+            if (Number.isFinite(scale) && scale > 0 && scale !== 1) {
+                object.scale.multiplyScalar(scale);
+                object.updateMatrixWorld(true);
+                bounds = new THREE.Box3().setFromObject(object);
+                bounds.getSize(size);
+                bounds.getCenter(center);
+            }
+        }
+    }
+    if (resolved.recenter) {
+        offset.x -= center.x;
+        offset.z -= center.z;
+    }
+    if (resolved.floorToZero) {
+        offset.y -= bounds.min.y;
+    }
+    if (offset.lengthSq() > 0) {
+        object.position.add(offset);
+        object.updateMatrixWorld(true);
+        bounds = new THREE.Box3().setFromObject(object);
+        bounds.getSize(size);
+        bounds.getCenter(center);
+    }
+    return { bounds, center, size, scale, offset };
+};
+export const computeCameraFrame = (bounds, fovDegrees, config) => {
+    const size = new THREE.Vector3();
+    const center = new THREE.Vector3();
+    bounds.getSize(size);
+    bounds.getCenter(center);
+    const mode = config?.mode ?? "iso";
+    if (mode === "interior") {
+        const position = new THREE.Vector3(center.x, center.y + size.y * 0.2, center.z + size.z * 0.2);
+        return { position, target: center };
+    }
+    const padding = config?.padding ?? DEFAULT_FRAME_PADDING;
+    const direction = new THREE.Vector3(...(config?.direction ?? DEFAULT_FRAME_DIRECTION)).normalize();
+    const radius = Math.max(0.5, size.length() * 0.5);
+    const vFov = THREE.MathUtils.degToRad(fovDegrees);
+    const distance = (radius / Math.sin(vFov / 2)) * padding;
+    const position = center.clone().add(direction.multiplyScalar(distance));
+    return { position, target: center };
+};

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export type { ViewerCreateOptions, ViewerHandle, ViewerSnapshot, CameraState, RenderPresetDefinition, PresetCatalog, LightingRigConfig, PostFxConfig, SceneExtrasConfig, SkyDefinition, SkyHdrConfig, SkyCubeConfig, ViewerDebugInfo, } from "./engine/types";
+export type { CameraFrameConfig, CameraFrameMode, CameraNormalizationConfig, CameraNormalizationResult, } from "./camera";
 export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
 export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
 export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
 export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
 export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
 export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
 export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";

package/dist/systems/postfxSystem.d.ts

@@ -19,6 +19,7 @@ export declare class PostFxSystem {
     apply(config?: PostFxConfig): void;
     render(): void;
     resize(width: number, height: number): void;
+    private getDrawingBufferSize;
     dispose(): void;
     invalidate(): void;
     getState(): {

package/dist/systems/postfxSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postfxSystem.d.ts","sourceRoot":"","sources":["../../src/systems/postfxSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAA6B;gBAEtC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAM9F,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IA+GlC,MAAM,IAAI,IAAI;IAoBd,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAwB3C,OAAO,IAAI,IAAI;IAaf,UAAU,IAAI,IAAI;IAqBlB,QAAQ,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;CAOpF"}
+{"version":3,"file":"postfxSystem.d.ts","sourceRoot":"","sources":["../../src/systems/postfxSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,aAAa,CAA6B;gBAEtC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAM9F,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IAkHlC,MAAM,IAAI,IAAI;IAoBd,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA2B3C,OAAO,CAAC,oBAAoB;IAS5B,OAAO,IAAI,IAAI;IAaf,UAAU,IAAI,IAAI;IAqBlB,QAAQ,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;CAOpF"}

package/dist/systems/postfxSystem.js

@@ -46,15 +46,18 @@ export class PostFxSystem {
             this.renderPass = new RenderPass(this.scene, this.camera);
             this.renderPass.clearPass && (this.renderPass.clearPass.overrideClearAlpha = 1);
             this.composer.addPass(this.renderPass);
-            this.composer.setSize(this.lastWidth, this.lastHeight);
+            const buffer = this.getDrawingBufferSize();
+            this.composer.setSize(buffer.width, buffer.height);
         }
         this.composer.autoRenderToScreen = false;
         if (!this.aoPass) {
-            this.aoPass = new N8AOPostPass(this.scene, this.camera, this.lastWidth, this.lastHeight);
+            const buffer = this.getDrawingBufferSize();
+            this.aoPass = new N8AOPostPass(this.scene, this.camera, buffer.width, buffer.height);
             this.composer.addPass(this.aoPass);
         }
         else {
-            this.aoPass.setSize(this.lastWidth, this.lastHeight);
+            const buffer = this.getDrawingBufferSize();
+            this.aoPass.setSize(buffer.width, buffer.height);
         }
         if (!this.bloomEffect) {
             this.bloomEffect = new BloomEffect({
@@ -157,6 +160,9 @@ export class PostFxSystem {
             this.effectPass = null;
             this.enabled = false;
         }
+        const buffer = this.getDrawingBufferSize();
+        this.lastWidth = buffer.width;
+        this.lastHeight = buffer.height;
         if (this.currentConfig) {
             const config = this.currentConfig;
             this.currentConfig = null;
@@ -168,6 +174,14 @@ export class PostFxSystem {
             this.apply(pending);
         }
     }
+    getDrawingBufferSize() {
+        const size = new THREE.Vector2();
+        this.renderer.getDrawingBufferSize(size);
+        return {
+            width: Math.max(1, Math.round(size.x)),
+            height: Math.max(1, Math.round(size.y)),
+        };
+    }
     dispose() {
         if (this.composer) {
             this.composer.dispose();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base2datadesign/viewer-kit",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",