@needle-tools/engine 4.9.3-next.002c20b → 4.9.3-next.0facab6

package/lib/engine-components/web/HoverAnimation.js

@@ -0,0 +1,105 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { AnimationClip } from "three";
+import { AnimationUtils } from "../../engine/engine_animation.js";
+import { serializable } from "../../engine/engine_serialization_decorator.js";
+import { registerType } from "../../engine/engine_typestore.js";
+import { Animation } from "../Animation.js";
+import { Behaviour } from "../Component.js";
+/**
+ * @category Web
+ * @group Components
+ * @component
+ */
+let HoverAnimation = class HoverAnimation extends Behaviour {
+    /**
+     * Default hover animation type if no custom clip is provided.
+     * **Node**: This is only used if no custom hover animation clip is provided.
+     * @default "linear"
+     */
+    type = "linear";
+    /**
+     * Duration of the hover animation in seconds.
+     * **Node**: This is only used if no custom hover animation clip is provided.
+     * @default 0.1
+     */
+    duration = 0.1;
+    /**
+     * Scale factor to apply when hovering.
+     * **Node**: This is only used if no custom hover animation clip is provided.
+     * @default 1.1
+     */
+    scaleFactor = 1.1;
+    /**
+     * Animation clip to play when hovering. If null, a default scale-up animation is used.
+     */
+    hovered = null;
+    /**
+     * Animation clip to play when not hovering. If null, an empty clip is used.
+     */
+    idle = null;
+    animation = null;
+    start() {
+        if (!this.idle)
+            this.idle = AnimationUtils.emptyClip();
+        if (!this.hovered) {
+            this.hovered = AnimationUtils.createScaleClip({
+                type: "linear",
+                duration: this.duration || 0.1,
+                scale: this.gameObject.scale,
+                scaleFactor: this.scaleFactor || 1.1,
+            });
+        }
+        this.animation ??= this.gameObject.addComponent(Animation);
+        this.animation.playAutomatically = false;
+        this.playIdle();
+    }
+    onEnable() {
+        if (this.animation)
+            this.animation.enabled = true;
+        this.playIdle();
+    }
+    onDisable() {
+        if (this.animation)
+            this.animation.enabled = false;
+        this.playIdle();
+    }
+    onPointerEnter() {
+        this.playHover();
+    }
+    onPointerExit() {
+        this.playIdle();
+    }
+    playIdle() {
+        if (this.idle)
+            this.animation?.play(this.idle, { exclusive: true, fadeDuration: .1, loop: true });
+    }
+    playHover() {
+        if (this.hovered)
+            this.animation?.play(this.hovered, { exclusive: true, fadeDuration: .1, loop: false, clampWhenFinished: true });
+    }
+};
+__decorate([
+    serializable()
+], HoverAnimation.prototype, "type", void 0);
+__decorate([
+    serializable()
+], HoverAnimation.prototype, "duration", void 0);
+__decorate([
+    serializable()
+], HoverAnimation.prototype, "scaleFactor", void 0);
+__decorate([
+    serializable(AnimationClip)
+], HoverAnimation.prototype, "hovered", void 0);
+__decorate([
+    serializable(AnimationClip)
+], HoverAnimation.prototype, "idle", void 0);
+HoverAnimation = __decorate([
+    registerType
+], HoverAnimation);
+export { HoverAnimation };
+//# sourceMappingURL=HoverAnimation.js.map

package/lib/engine-components/web/HoverAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HoverAnimation.js","sourceRoot":"","sources":["../../../src/engine-components/web/HoverAnimation.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;;GAIG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,SAAS;IAEzC;;;;OAIG;IAEH,IAAI,GAAkB,QAAQ,CAAC;IAE/B;;;;OAIG;IAEH,QAAQ,GAAW,GAAG,CAAC;IAEvB;;;;OAIG;IAEH,WAAW,GAAW,GAAG,CAAC;IAG1B;;OAEG;IAEH,OAAO,GAAyB,IAAI,CAAC;IAErC;;OAEG;IAEH,IAAI,GAAyB,IAAI,CAAC;IAE1B,SAAS,GAAqB,IAAI,CAAC;IAE3C,KAAK;QACD,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC;QAEvD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACf,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC;gBAC1C,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;gBAC9B,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;gBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG;aACvC,CAAC,CAAC;SACN;QAED,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED,QAAQ;QACJ,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IACD,SAAS;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED,cAAc;QACV,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,aAAa;QACT,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IAEO,QAAQ;QACZ,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtG,CAAC;IACO,SAAS;QACb,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IACtI,CAAC;CAEJ,CAAA;AA1EG;IADC,YAAY,EAAE;4CACgB;AAQ/B;IADC,YAAY,EAAE;gDACQ;AAQvB;IADC,YAAY,EAAE;mDACW;AAO1B;IADC,YAAY,CAAC,aAAa,CAAC;+CACS;AAMrC;IADC,YAAY,CAAC,aAAa,CAAC;4CACM;AArCzB,cAAc;IAD1B,YAAY;GACA,cAAc,CAkF1B;SAlFY,cAAc"}

package/lib/engine-components/web/ScrollFollow.d.ts

@@ -31,6 +31,10 @@ type ScrollFollowEvent = {
  * 2. Add a ScrollFollow component to the same GameObject or another GameObject in the scene.
  * 3. Assign the PlayableDirector component to the ScrollFollow's target property.
  * 4. The timeline will now scrub based on the scroll position of the page.
+ *
+ * @category Web
+ * @group Components
+ * @component
  */
 export declare class ScrollFollow extends Behaviour {
     /**

package/lib/engine-components/web/ScrollFollow.js

@@ -36,6 +36,10 @@ import { PlayableDirector } from "../timeline/PlayableDirector.js";
  * 2. Add a ScrollFollow component to the same GameObject or another GameObject in the scene.
  * 3. Assign the PlayableDirector component to the ScrollFollow's target property.
  * 4. The timeline will now scrub based on the scroll position of the page.
+ *
+ * @category Web
+ * @group Components
+ * @component
  */
 export class ScrollFollow extends Behaviour {
     /**

package/lib/engine-components/web/ScrollFollow.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollFollow.js","sourceRoot":"","sources":["../../../src/engine-components/web/ScrollFollow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ScrollFollow.js","sourceRoot":"","sources":["../../../src/engine-components/web/ScrollFollow.ts"],"names":[],"mappings":"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"}

package/lib/engine-components/web/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./Clickthrough.js";
 export * from "./CursorFollow.js";
+export * from "./HoverAnimation.js";
 export * from "./ScrollFollow.js";

package/lib/engine-components/web/index.js

@@ -1,4 +1,5 @@
 export * from "./Clickthrough.js";
 export * from "./CursorFollow.js";
+export * from "./HoverAnimation.js";
 export * from "./ScrollFollow.js";
 //# sourceMappingURL=index.js.map

package/lib/engine-components/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine-components/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine-components/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "4.9.3-next.002c20b",
+  "version": "4.9.3-next.0facab6",
   "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in.",
   "main": "dist/needle-engine.min.js",
   "exports": {

package/src/engine/api.ts

@@ -24,7 +24,8 @@ export * from "./engine_addressables.js";
 export { AnimationUtils } from "./engine_animation.js";
 export { Application } from "./engine_application.js";
 export * from "./engine_assetdatabase.js";
-export { getCameraController, setAutoFitEnabled, setCameraController, useForAutoFit } from "./engine_camera.js"
+export * from "./engine_camera.fit.js";
+export { getCameraController, setAutoFitEnabled, setCameraController, useForAutoFit } from "./engine_camera.js";
 export * from "./engine_components.js";
 export * from "./engine_components_internal.js";
 export * from "./engine_components_internal.js";

package/src/engine/codegen/register_types.ts

@@ -139,6 +139,7 @@ import { VideoPlayer } from "../../engine-components/VideoPlayer.js";
 import { Voip } from "../../engine-components/Voip.js";
 import { ClickThrough } from "../../engine-components/web/Clickthrough.js";
 import { CursorFollow } from "../../engine-components/web/CursorFollow.js";
+import { HoverAnimation } from "../../engine-components/web/HoverAnimation.js";
 import { ScrollFollow } from "../../engine-components/web/ScrollFollow.js";
 import { Avatar } from "../../engine-components/webxr/Avatar.js";
 import { XRControllerFollow } from "../../engine-components/webxr/controllers/XRControllerFollow.js";
@@ -295,6 +296,7 @@ TypeStore.add("VideoPlayer", VideoPlayer);
 TypeStore.add("Voip", Voip);
 TypeStore.add("ClickThrough", ClickThrough);
 TypeStore.add("CursorFollow", CursorFollow);
+TypeStore.add("HoverAnimation", HoverAnimation);
 TypeStore.add("ScrollFollow", ScrollFollow);
 TypeStore.add("Avatar", Avatar);
 TypeStore.add("XRControllerFollow", XRControllerFollow);

package/src/engine/engine_animation.ts

@@ -1,4 +1,4 @@
-import { AnimationAction, AnimationClip, AnimationMixer, Object3D, PropertyBinding } from "three";
+import { AnimationAction, AnimationClip, AnimationMixer, KeyframeTrack, Object3D, PropertyBinding, Vector3Like } from "three";
 
 import type { Context } from "./engine_context.js";
 import { GLTF, IAnimationComponent, Model } from "./engine_types.js";
@@ -151,4 +151,72 @@ export class AnimationUtils {
             return findAnimationComponentInParent(obj.parent);
         }
     }
+
+
+    static emptyClip(): AnimationClip {
+        return new AnimationClip("empty", 0, []);
+    }
+
+    static createScaleClip(options?: ScaleClipOptions): AnimationClip {
+        const duration = options?.duration ?? 0.3;
+
+        let baseScale: Vector3Like = { x: 1, y: 1, z: 1 };
+        if (options?.scale !== undefined) {
+            if (typeof options.scale === "number") {
+                baseScale = { x: options.scale, y: options.scale, z: options.scale };
+            }
+            else {
+                baseScale = options.scale;
+            }
+        }
+        const type = options?.type ?? "linear";
+        const scale = options?.scaleFactor ?? 1.2;
+
+        const times = new Array<number>();
+        const values = new Array<number>();
+        switch (type) {
+            case "linear":
+                times.push(0, duration);
+                values.push(
+                    baseScale.x, baseScale.y, baseScale.z,
+                    baseScale.x * scale, baseScale.y * scale, baseScale.z * scale
+                );
+                break;
+
+            case "spring":
+                times.push(0, duration * 0.3, duration * 0.5, duration * 0.7, duration * 0.9, duration);
+                values.push(
+                    baseScale.x, baseScale.y, baseScale.z,
+                    baseScale.x * scale, baseScale.y * scale, baseScale.z * scale,
+                    baseScale.x * 0.9, baseScale.y * 0.9, baseScale.z * 0.9,
+                    baseScale.x * 1.05, baseScale.y * 1.05, baseScale.z * 1.05,
+                    baseScale.x * 0.98, baseScale.y * 0.98, baseScale.z * 0.98,
+                    baseScale.x, baseScale.y, baseScale.z
+                );
+                break;
+
+        }
+
+        const track = new KeyframeTrack(".scale", times, values);
+        return new AnimationClip("scale", times[times.length - 1], [track]);
+    }
+}
+
+/**
+ * Type of scale animation to create.  
+ * - "linear": Simple linear scale up animation.  
+ * - "spring": Spring-like scale animation with overshoot and settling.  
+ */
+export type ScaleClipType = "linear"  | "spring";
+
+type ScaleClipOptions = {
+    /**
+     * Type of scale animation to create.
+     * - "linear": Simple linear scale up animation.
+     * - "spring": Spring-like scale animation with overshoot and settling.
+     */
+    type?: ScaleClipType,
+    duration?: number,
+    scale?: number | Vector3Like,
+    scaleFactor?: number
 }

package/src/engine/engine_camera.fit.ts

@@ -0,0 +1,288 @@
+import { Camera, Object3D, PerspectiveCamera, Vector3, Vector3Like } from "three";
+
+import { GroundProjectedEnv } from "../engine-components/GroundProjection.js";
+import { findObjectOfType } from "./engine_components.js";
+import { Context } from "./engine_context.js";
+import { Gizmos } from "./engine_gizmos.js";
+import { getBoundingBox } from "./engine_three_utils.js";
+import { NeedleXRSession } from "./xr/NeedleXRSession.js";
+
+
+/**
+ * Options for fitting the camera to the scene. Used in {@link OrbitControls.fitCamera}
+ */
+export type FitCameraOptions = {
+    /** When enabled debug rendering will be shown */
+    debug?: boolean,
+
+    /**
+     * If true the camera position and target will be applied immediately
+     * @default true
+     */
+    autoApply?: boolean,
+
+    /**
+     * The context to use. If not provided the current context will be used
+     */
+    context?: Context,
+
+    /**
+     * The camera to fit. If not provided the current camera will be used
+     */
+    camera?: Camera,
+
+    currentZoom?: number,
+    minZoom?: number,
+    maxZoom?: number,
+
+    /**
+     * The objects to fit the camera to. If not provided the scene children will be used
+     */
+    objects?: Object3D[] | Object3D;
+
+    /** Fit offset: A factor to multiply the distance to the objects by
+     * @default 1.1
+     */
+    fitOffset?: number,
+
+    /** The direction from which the camera should be fitted in worldspace. If not defined the current camera's position will be used */
+    fitDirection?: Vector3Like,
+
+    /** If set to "y" the camera will be centered in the y axis */
+    centerCamera?: "none" | "y",
+    /** Set to 'auto' to update the camera near or far plane based on the fitted-objects bounds */
+    cameraNearFar?: "keep" | "auto",
+
+    /**
+     * Offset the camera position in world space
+     */
+    cameraOffset?: Partial<Vector3Like>,
+    /**
+     * Offset the camera position relative to the size of the objects being focused on (e.g. x: 0.5).  
+     * Value range: -1 to 1
+     */
+    relativeCameraOffset?: Partial<Vector3Like>,
+
+    /**
+     * Offset the camera target position in world space
+     */
+    targetOffset?: Partial<Vector3Like>,
+    /**
+     * Offset the camera target position relative to the size of the objects being focused on.  
+     * Value range: -1 to 1
+     */
+    relativeTargetOffset?: Partial<Vector3Like>,
+
+    /**
+     * Field of view (FOV) for the camera
+     */
+    fov?: number,
+}
+
+export type FitCameraReturnType = {
+    camera: Camera,
+    position: Vector3,
+    lookAt: Vector3,
+    fov: number | undefined
+}
+
+
+export function fitCamera(objectsOrOptions?: Object3D | Array<Object3D> | FitCameraOptions, options?: FitCameraOptions): null | FitCameraReturnType {
+
+    if (NeedleXRSession.active) {
+        // camera fitting in XR is not supported
+        console.warn('[OrbitControls] Can not fit camera while XR session is active');
+        return null;
+    }
+
+    const context = Context.Current;
+    if (!context) {
+        console.warn('[OrbitControls] No context found');
+        return null;
+    }
+    const camera = options?.camera || context.mainCamera;
+
+    let objects: Object3D | Array<Object3D> | undefined = undefined;
+    // If the user passed in an array as first argument
+    if (Array.isArray(objectsOrOptions)) {
+        objects = objectsOrOptions;
+    }
+    // If the user passed in an object as first argument
+    else if (objectsOrOptions && "type" in objectsOrOptions) {
+        objects = objectsOrOptions;
+    }
+    // If the user passed in an object as first argument and options as second argument
+    else if (objectsOrOptions && typeof objectsOrOptions === "object") {
+        if (!(objectsOrOptions instanceof Object3D) && !Array.isArray(objectsOrOptions)) {
+            options = objectsOrOptions;
+            objects = options.objects;
+        }
+    }
+    // Ensure objects are setup correctly
+    if (objects && !Array.isArray(objects)) {
+        objects = [objects];
+    }
+    if (!Array.isArray(objects) || objects && objects.length <= 0) {
+        objects = context.scene.children;
+    }
+
+    // Make sure there's anything to fit to
+    if (!Array.isArray(objects) || objects.length <= 0) {
+        console.warn("No objects to fit camera to...");
+        return null;
+    }
+
+
+    // const controls = this._controls as ThreeOrbitControls | null;
+
+    if (!camera) {
+        console.warn("No camera or controls found to fit camera to objects...");
+        return null;
+    }
+
+    if (!options) options = {}
+    options.autoApply = options.autoApply !== false; // default to true
+    options.minZoom ||= 0;
+    options.maxZoom ||= Infinity;
+
+    const {
+        centerCamera,
+        cameraNearFar = "auto",
+        fitOffset = 1.1,
+        fov = camera instanceof PerspectiveCamera ? camera?.fov : -1
+    } = options;
+
+    const size = new Vector3();
+    const center = new Vector3();
+    const aspect = camera instanceof PerspectiveCamera ? camera.aspect : 1;
+    // TODO would be much better to calculate the bounds in camera space instead of world space - 
+    // we would get proper view-dependant fit.
+    // Right now it's independent from where the camera is actually looking from,
+    // and thus we're just getting some maximum that will work for sure.
+    const box = getBoundingBox(objects, undefined, camera?.layers);
+    const boxCopy = box.clone();
+    box.getCenter(center);
+
+    const box_size = new Vector3();
+    box.getSize(box_size);
+
+    // project this box into camera space
+    if (camera instanceof PerspectiveCamera) camera.updateProjectionMatrix();
+    camera.updateMatrixWorld();
+    box.applyMatrix4(camera.matrixWorldInverse);
+
+    box.getSize(size);
+    box.setFromCenterAndSize(center, size);
+    if (Number.isNaN(size.x) || Number.isNaN(size.y) || Number.isNaN(size.z)) {
+        console.warn("Camera fit size resultet in NaN", camera, box);
+        return null;
+    }
+    if (size.length() <= 0.0000000001) {
+        console.warn("Camera fit size is zero", box);
+        return null;
+    }
+
+    const verticalFov = fov;
+    const horizontalFov = 2 * Math.atan(Math.tan(verticalFov * Math.PI / 360 / 2) * aspect) / Math.PI * 360;
+    const fitHeightDistance = size.y / (2 * Math.atan(Math.PI * verticalFov / 360));
+    const fitWidthDistance = size.x / (2 * Math.atan(Math.PI * horizontalFov / 360));
+
+    const distance = fitOffset * Math.max(fitHeightDistance, fitWidthDistance) + size.z / 2;
+    options.maxZoom = distance * 10;
+    options.minZoom = distance * 0.01;
+
+    if (options.debug === true) {
+        console.log("Fit camera to objects", { fitHeightDistance, fitWidthDistance, distance, verticalFov, horizontalFov });
+    }
+
+    const verticalOffset = 0.05;
+    const lookAt = center.clone();
+    lookAt.y -= size.y * verticalOffset;
+    if (options.targetOffset) {
+        if (options.targetOffset.x !== undefined) lookAt.x += options.targetOffset.x;
+        if (options.targetOffset.y !== undefined) lookAt.y += options.targetOffset.y;
+        if (options.targetOffset.z !== undefined) lookAt.z += options.targetOffset.z;
+    }
+    if (options.relativeTargetOffset) {
+        if (options.relativeTargetOffset.x !== undefined) lookAt.x += options.relativeTargetOffset.x * size.x;
+        if (options.relativeTargetOffset.y !== undefined) lookAt.y += options.relativeTargetOffset.y * size.y;
+        if (options.relativeTargetOffset.z !== undefined) lookAt.z += options.relativeTargetOffset.z * size.z;
+    }
+    // this.setLookTargetPosition(lookAt, immediate);
+    // this.setFieldOfView(options.fov, immediate);
+
+    if (cameraNearFar == undefined || cameraNearFar == "auto") {
+        // Check if the scene has a GroundProjectedEnv and include the scale to the far plane so that it doesnt cut off
+        const groundprojection = findObjectOfType(GroundProjectedEnv);
+        const groundProjectionRadius = groundprojection ? groundprojection.radius : 0;
+        const boundsMax = Math.max(box_size.x, box_size.y, box_size.z, groundProjectionRadius);
+        // TODO: this doesnt take the Camera component nearClipPlane into account
+        if (camera instanceof PerspectiveCamera) {
+            camera.near = (distance / 100);
+            camera.far = boundsMax + distance * 10;
+            camera.updateProjectionMatrix();
+        }
+
+        // adjust maxZoom so that the ground projection radius is always inside
+        if (groundprojection) {
+            options.maxZoom = Math.max(Math.min(options.maxZoom, groundProjectionRadius * 0.5), distance);
+        }
+    }
+
+    // ensure we're not clipping out of the current zoom level just because we're fitting
+    if (options.currentZoom !== undefined) {
+        if (options.currentZoom < options.minZoom) options.minZoom = options.currentZoom * 0.9;
+        if (options.currentZoom > options.maxZoom) options.maxZoom = options.currentZoom * 1.1;
+    }
+
+    const direction = center.clone();
+    if (options.fitDirection) {
+        direction.sub(new Vector3().copy(options.fitDirection).multiplyScalar(1_000_000));
+    }
+    else {
+        direction.sub(camera.worldPosition);
+    }
+    if (centerCamera === "y")
+        direction.y = 0;
+    direction.normalize();
+    direction.multiplyScalar(distance);
+    if (centerCamera === "y")
+        direction.y += -verticalOffset * 4 * distance;
+
+    let cameraLocalPosition = center.clone().sub(direction);
+    if (options.cameraOffset) {
+        if (options.cameraOffset.x !== undefined) cameraLocalPosition.x += options.cameraOffset.x;
+        if (options.cameraOffset.y !== undefined) cameraLocalPosition.y += options.cameraOffset.y;
+        if (options.cameraOffset.z !== undefined) cameraLocalPosition.z += options.cameraOffset.z;
+    }
+    if (options.relativeCameraOffset) {
+        if (options.relativeCameraOffset.x !== undefined) cameraLocalPosition.x += options.relativeCameraOffset.x * size.x;
+        if (options.relativeCameraOffset.y !== undefined) cameraLocalPosition.y += options.relativeCameraOffset.y * size.y;
+        if (options.relativeCameraOffset.z !== undefined) cameraLocalPosition.z += options.relativeCameraOffset.z * size.z;
+    }
+    if (camera.parent) {
+        cameraLocalPosition = camera.parent.worldToLocal(cameraLocalPosition);
+    }
+    // this.setCameraTargetPosition(cameraLocalPosition, immediate);
+
+    if (options.debug) {
+        Gizmos.DrawWireBox3(box, 0xffff33, 10);
+        Gizmos.DrawWireBox3(boxCopy, 0x00ff00, 10);
+    }
+
+    if (options.autoApply) {
+        camera.position.copy(cameraLocalPosition);
+        camera.lookAt(lookAt);
+        if (fov > 0 && camera instanceof PerspectiveCamera) {
+            camera.fov = fov;
+            camera.updateProjectionMatrix();
+        }
+    }
+
+    return {
+        camera: camera,
+        position: cameraLocalPosition,
+        lookAt: lookAt,
+        fov: options.fov,
+    }
+}

package/src/engine/engine_gizmos.ts

@@ -230,8 +230,8 @@ export class Gizmos {
      * Draw a 3D wiremesh box gizmo in the scene
      * @param box the box in world space
      * @param color the color of the box
-     * @param duration the duration in seconds the box will be rendered. If 0 it will be rendered for one frame
-     * @param depthTest if true the box will be rendered with depth test
+     * @param duration the duration in seconds the box will be rendered. If 0 it will be rendered for one frame. Default: 0
+     * @param depthTest if true the box will be rendered with depth test. Default: true
      */
     static DrawWireBox3(box: Box3, color: ColorRepresentation = defaultColor, duration: number = 0, depthTest: boolean = true) {
         if (!Gizmos.enabled) return;

package/src/engine/engine_physics.ts

@@ -592,7 +592,7 @@ namespace NEMeshBVH {
                 const timeSinceLastUpdate = now - skinnedMesh.staticGeometryLastUpdate!;
                 const interval = skinnedMesh.autoUpdateMeshBvhInterval ?? 100;
                 if (skinnedMeshBVHNeedsUpdate || timeSinceLastUpdate > interval) {
-                    if(debugPhysics) console.warn(`Physics: updating skinned mesh bvh for ${mesh.name} after ${timeSinceLastUpdate.toFixed(2)}ms`);
+                    if (debugPhysics) console.warn(`Physics: updating skinned mesh bvh for ${mesh.name} after ${timeSinceLastUpdate.toFixed(2)}ms`);
                     skinnedMesh.bvhNeedsUpdate = false;
                     skinnedMesh.staticGeometryLastUpdate = now;
                     skinnedMesh.staticGenerator?.generate(skinnedMesh.staticGeometry);
@@ -709,8 +709,11 @@ namespace NEMeshBVH {
             else {
                 if (debugPhysics) console.warn("No bounds tree found for mesh", mesh.name, { workerTask: geom[workerTaskSymbol], hasAcceleratedRaycast: _acceleratedRaycast != null });
                 if (options.allowSlowRaycastFallback === false) {
-                    if (debugPhysics) console.warn("Skipping raycast because no bounds tree is available and allowSlowRaycastFallback is false");
-                    return false;
+                    const vertices = geom.getAttribute("position")?.array?.length ?? 0;
+                    if (vertices > 2000) {
+                        if (debugPhysics) console.warn("Skipping raycast because no bounds tree is available and allowSlowRaycastFallback is false");
+                        return false;
+                    }
                 }
             }
             const prevFirstHitOnly = raycaster.firstHitOnly;

package/src/engine/webcomponents/needle-engine.ts

@@ -85,12 +85,17 @@ export class NeedleEngineWebComponent extends HTMLElement implements INeedleEngi
      * <needle-engine></needle-engine>
      * @returns {boolean | null} if the attribute is not set it returns null
      */
-    public get cameraControls(): boolean | null {
+    get cameraControls(): boolean | null {
         const attr = this.getAttribute("camera-controls") as NeedleEngineAttributes["camera-controls"] | ({} & string)
         if (attr == null) return null;
         if (attr === null || attr === "False" || attr === "false" || attr === "0" || attr === "none") return false;
         return true;
     }
+    set cameraControls(value: boolean | null) {
+        if (value === null) this.removeAttribute("camera-controls");
+        else this.setAttribute("camera-controls", value ? "true" : "false");
+    }
+    
 
     /**
      * Get the current context for this web component instance. The context is created when the src attribute is set and the loading has finished.