@needle-tools/engine 3.28.6-beta → 3.28.7-beta.1

package/lib/engine-components/Camera.js

@@ -1,451 +1,451 @@
-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 { Behaviour, GameObject } from "./Component.js";
-import { getParam } from "../engine/engine_utils.js";
-import { serializable } from "../engine/engine_serialization_decorator.js";
-import { RGBAColor } from "./js-extensions/RGBAColor.js";
-import { XRSessionMode } from "../engine/engine_setup.js";
-import { isDevEnvironment, showBalloonMessage, showBalloonWarning } from "../engine/debug/index.js";
-import { getWorldPosition } from "../engine/engine_three_utils.js";
-import { Gizmos } from "../engine/engine_gizmos.js";
-import { EquirectangularReflectionMapping, OrthographicCamera, PerspectiveCamera, Ray, SRGBColorSpace, Vector3 } from "three";
-import { OrbitControls } from "./OrbitControls.js";
-import { RenderTexture } from "../engine/engine_texture.js";
-export var ClearFlags;
-(function (ClearFlags) {
-    ClearFlags[ClearFlags["Skybox"] = 1] = "Skybox";
-    ClearFlags[ClearFlags["SolidColor"] = 2] = "SolidColor";
-    ClearFlags[ClearFlags["Uninitialized"] = 4] = "Uninitialized";
-})(ClearFlags || (ClearFlags = {}));
-const debug = getParam("debugcam");
-const debugscreenpointtoray = getParam("debugscreenpointtoray");
-export class Camera extends Behaviour {
-    get isCamera() {
-        return true;
-    }
-    get aspect() {
-        if (this._cam instanceof PerspectiveCamera)
-            return this._cam.aspect;
-        return (this.context.domWidth / this.context.domHeight);
-    }
-    get fieldOfView() {
-        if (this._cam instanceof PerspectiveCamera) {
-            return this._cam.fov;
-        }
-        return this._fov;
-    }
-    set fieldOfView(val) {
-        const changed = this.fieldOfView != val;
-        this._fov = val;
-        if (changed && this._cam) {
-            if (this._cam instanceof PerspectiveCamera) {
-                if (this._fov === undefined) {
-                    console.warn("Can not set undefined fov on PerspectiveCamera");
-                    return;
-                }
-                this._cam.fov = this._fov;
-                this._cam.updateProjectionMatrix();
-            }
-        }
-    }
-    get nearClipPlane() { return this._nearClipPlane; }
-    set nearClipPlane(val) {
-        const changed = this._nearClipPlane != val;
-        this._nearClipPlane = val;
-        if (this._cam && changed) {
-            this._cam.near = val;
-            this._cam.updateProjectionMatrix();
-        }
-    }
-    _nearClipPlane = 0.1;
-    get farClipPlane() { return this._farClipPlane; }
-    set farClipPlane(val) {
-        const changed = this._farClipPlane != val;
-        this._farClipPlane = val;
-        if (this._cam && changed) {
-            this._cam.far = val;
-            this._cam.updateProjectionMatrix();
-        }
-    }
-    _farClipPlane = 1000;
-    get clearFlags() {
-        return this._clearFlags;
-    }
-    set clearFlags(val) {
-        if (val === this._clearFlags)
-            return;
-        this._clearFlags = val;
-        this.applyClearFlagsIfIsActiveCamera();
-    }
-    orthographic = false;
-    orthographicSize = 5;
-    ARBackgroundAlpha = 0;
-    /**
-     * The [`mask`](https://threejs.org/docs/#api/en/core/Layers.mask) value of the three camera object layers
-     * If you want to just see objects on one layer (e.g. layer 2) then you can use `cullingLayer = 2` on this camera component instead
-    */
-    set cullingMask(val) {
-        this._cullingMask = val;
-        if (this._cam) {
-            this._cam.layers.mask = val;
-        }
-    }
-    get cullingMask() {
-        if (this._cam)
-            return this._cam.layers.mask;
-        return this._cullingMask;
-    }
-    _cullingMask = 0xffffffff;
-    /** Set only a specific layer active to be rendered by the camera. This is equivalent to calling `layers.set(val)` */
-    set cullingLayer(val) {
-        this.cullingMask = (1 << val | 0) >>> 0;
-    }
-    set backgroundBlurriness(val) {
-        if (val === this._backgroundBlurriness)
-            return;
-        if (val === undefined)
-            this._backgroundBlurriness = undefined;
-        else
-            this._backgroundBlurriness = Math.min(Math.max(val, 0), 1);
-        this.applyClearFlagsIfIsActiveCamera();
-    }
-    get backgroundBlurriness() {
-        return this._backgroundBlurriness;
-    }
-    _backgroundBlurriness;
-    set backgroundIntensity(val) {
-        if (val === this._backgroundIntensity)
-            return;
-        if (val === undefined)
-            this._backgroundIntensity = undefined;
-        else
-            this._backgroundIntensity = Math.min(Math.max(val, 0), 10);
-        this.applyClearFlagsIfIsActiveCamera();
-    }
-    get backgroundIntensity() {
-        return this._backgroundIntensity;
-    }
-    _backgroundIntensity;
-    set environmentIntensity(val) {
-        this._environmentIntensity = val;
-    }
-    get environmentIntensity() {
-        return this._environmentIntensity;
-    }
-    _environmentIntensity;
-    get backgroundColor() {
-        return this._backgroundColor ?? null;
-    }
-    set backgroundColor(val) {
-        if (!val)
-            return;
-        if (!this._backgroundColor) {
-            if (!val.clone)
-                return;
-            this._backgroundColor = val.clone();
-        }
-        else
-            this._backgroundColor.copy(val);
-        // set background color to solid if provided color doesnt have any alpha channel
-        if (val.alpha === undefined)
-            this._backgroundColor.alpha = 1;
-        this.applyClearFlagsIfIsActiveCamera();
-    }
-    set targetTexture(rt) {
-        this._targetTexture = rt;
-    }
-    get targetTexture() {
-        return this._targetTexture;
-    }
-    _targetTexture = null;
-    _backgroundColor;
-    _fov;
-    _cam = null;
-    _clearFlags = ClearFlags.SolidColor;
-    _skybox;
-    get cam() {
-        if (this.activeAndEnabled)
-            this.buildCamera();
-        return this._cam;
-    }
-    static _origin = new Vector3();
-    static _direction = new Vector3();
-    screenPointToRay(x, y, ray) {
-        const cam = this.cam;
-        const origin = Camera._origin;
-        origin.set(x, y, -1);
-        this.context.input.convertScreenspaceToRaycastSpace(origin);
-        if (debugscreenpointtoray)
-            console.log("screenPointToRay", x.toFixed(2), y.toFixed(2), "now:", origin.x.toFixed(2), origin.y.toFixed(2), "isInXR:" + this.context.isInXR);
-        origin.z = -1;
-        origin.unproject(cam);
-        const dir = Camera._direction.set(origin.x, origin.y, origin.z);
-        const camPosition = getWorldPosition(cam);
-        dir.sub(camPosition);
-        dir.normalize();
-        if (ray) {
-            ray.set(camPosition, dir);
-            return ray;
-        }
-        else {
-            return new Ray(camPosition.clone(), dir.clone());
-        }
-    }
-    awake() {
-        if (debugscreenpointtoray) {
-            window.addEventListener("pointerdown", evt => {
-                const px = evt.clientX;
-                const py = evt.clientY;
-                console.log("touch", px.toFixed(2), py.toFixed(2));
-                const ray = this.screenPointToRay(px, py);
-                const randomHex = "#" + Math.floor(Math.random() * 16777215).toString(16);
-                Gizmos.DrawRay(ray.origin, ray.direction, randomHex, 10);
-            });
-        }
-    }
-    onEnable() {
-        if (debug)
-            console.log(`Camera enabled: \"${this.name}\". ClearFlags=${ClearFlags[this._clearFlags]}`, this);
-        this.buildCamera();
-        if (this.tag == "MainCamera" || !this.context.mainCameraComponent) {
-            this.context.setCurrentCamera(this);
-            handleFreeCam(this);
-        }
-        this.applyClearFlagsIfIsActiveCamera();
-    }
-    onDisable() {
-        this.context.removeCamera(this);
-    }
-    onBeforeRender() {
-        if (this._cam) {
-            // because the background color may be animated!
-            if (this._clearFlags === ClearFlags.SolidColor)
-                this.applyClearFlagsIfIsActiveCamera();
-            if (this._targetTexture) {
-                if (this.context.isManagedExternally) {
-                    // TODO: rendering with r3f renderer does throw an shader error for some reason?
-                    if (!this["_warnedAboutExternalRenderer"]) {
-                        this["_warnedAboutExternalRenderer"] = true;
-                        console.warn("Rendering with external renderer is not supported yet. This may not work or throw errors. Please remove the the target texture from your camera: " + this.name, this.targetTexture);
-                    }
-                }
-                // TODO: optimize to not render twice if this is already the main camera. In that case we just want to blit
-                const composer = this.context.composer;
-                const useNormalRenderer = true; // this.context.isInXR || !composer;
-                const renderer = useNormalRenderer ? this.context.renderer : composer;
-                if (renderer) {
-                    // TODO: we should do this in onBeforeRender for the main camera only
-                    const mainCam = this.context.mainCameraComponent;
-                    this.applyClearFlags();
-                    this._targetTexture.render(this.context.scene, this._cam, renderer);
-                    mainCam?.applyClearFlags();
-                }
-            }
-        }
-    }
-    buildCamera() {
-        if (this._cam)
-            return;
-        const cameraAlreadyCreated = this.gameObject["isCamera"];
-        // TODO: when exporting from blender we already have a camera in the children
-        let cam = null;
-        if (cameraAlreadyCreated) {
-            cam = this.gameObject;
-            cam?.layers.enableAll();
-            if (cam instanceof PerspectiveCamera)
-                this._fov = cam.fov;
-        }
-        else
-            cam = this.gameObject.children[0];
-        if (cam && cam.isCamera) {
-            if (cam instanceof PerspectiveCamera) {
-                if (this._fov)
-                    cam.fov = this._fov;
-                cam.near = this._nearClipPlane;
-                cam.far = this._farClipPlane;
-                cam.updateProjectionMatrix();
-            }
-        }
-        else if (!this.orthographic) {
-            cam = new PerspectiveCamera(this.fieldOfView, window.innerWidth / window.innerHeight, this._nearClipPlane, this._farClipPlane);
-            if (this.fieldOfView)
-                cam.fov = this.fieldOfView;
-            this.gameObject.add(cam);
-        }
-        else {
-            const factor = this.orthographicSize * 100;
-            cam = new OrthographicCamera(window.innerWidth / -factor, window.innerWidth / factor, window.innerHeight / factor, window.innerHeight / -factor, this._nearClipPlane, this._farClipPlane);
-            this.gameObject.add(cam);
-        }
-        this._cam = cam;
-        this._cam.layers.mask = this._cullingMask;
-        if (this.tag == "MainCamera") {
-            this.context.setCurrentCamera(this);
-        }
-    }
-    applyClearFlagsIfIsActiveCamera() {
-        if (this.context.mainCameraComponent === this) {
-            this.applyClearFlags();
-        }
-    }
-    applyClearFlags() {
-        if (!this._cam) {
-            if (debug)
-                console.log("Camera does not exist (apply clear flags)");
-            return;
-        }
-        // restore previous fov (e.g. when user was in VR or AR and the camera's fov has changed)
-        this.fieldOfView = this._fov;
-        if (debug) {
-            const msg = `Camera \"${this.name}\" clear flags: ${ClearFlags[this._clearFlags]}`;
-            console.log(msg);
-        }
-        switch (this._clearFlags) {
-            case ClearFlags.Skybox:
-                if (Camera.backgroundShouldBeTransparent(this.context)) {
-                    if (!this.ARBackgroundAlpha || this.ARBackgroundAlpha < 0.001) {
-                        this.context.scene.background = null;
-                        this.context.renderer.setClearColor(0x000000, 0);
-                        return;
-                    }
-                }
-                this.enableSkybox();
-                if (this._backgroundBlurriness !== undefined)
-                    this.context.scene.backgroundBlurriness = this._backgroundBlurriness;
-                if (this._backgroundIntensity !== undefined)
-                    //@ts-ignore
-                    this.context.scene.backgroundIntensity = this._backgroundIntensity;
-                break;
-            case ClearFlags.SolidColor:
-                if (this._backgroundColor) {
-                    let alpha = this._backgroundColor.alpha;
-                    // when in WebXR use ar background alpha override or set to 0
-                    if (Camera.backgroundShouldBeTransparent(this.context)) {
-                        alpha = this.ARBackgroundAlpha ?? 0;
-                    }
-                    this.context.scene.background = null;
-                    this.context.renderer.setClearColor(this._backgroundColor, alpha);
-                }
-                else {
-                    if (debug)
-                        console.warn(`Camera \"${this.name}\" has no background color`, this);
-                }
-                break;
-            case ClearFlags.Uninitialized:
-                this.context.scene.background = null;
-                this.context.renderer.setClearColor(0x000000, 0);
-                break;
-        }
-    }
-    enableSkybox() {
-        if (!this._skybox)
-            this._skybox = new CameraSkybox(this);
-        this._skybox.enable();
-    }
-    /** Returns true when in XR on a pass through device where the background shouldbe invisible */
-    static backgroundShouldBeTransparent(context) {
-        const session = context.renderer.xr?.getSession();
-        if (!session)
-            return false;
-        if (typeof session["_transparent"] === "boolean") {
-            return session["_transparent"];
-        }
-        const environmentBlendMode = session.environmentBlendMode;
-        if (debug)
-            showBalloonMessage("Environment blend mode: " + environmentBlendMode + " on " + navigator.userAgent);
-        let transparent = environmentBlendMode === 'additive' || environmentBlendMode === 'alpha-blend';
-        if (context.xrSessionMode === XRSessionMode.ImmersiveAR) {
-            if (environmentBlendMode === "opaque") {
-                // workaround for Quest 2 returning opaque when it should be alpha-blend
-                // check user agent if this is the Quest browser and return true if so
-                if (navigator.userAgent?.includes("OculusBrowser")) {
-                    transparent = true;
-                }
-                // Mozilla WebXR Viewer
-                else if (navigator.userAgent?.includes("Mozilla") && navigator.userAgent?.includes("Mobile WebXRViewer/v2")) {
-                    transparent = true;
-                }
-            }
-        }
-        session["_transparent"] = transparent;
-        return transparent;
-    }
-}
-__decorate([
-    serializable()
-], Camera.prototype, "fieldOfView", null);
-__decorate([
-    serializable()
-], Camera.prototype, "nearClipPlane", null);
-__decorate([
-    serializable()
-], Camera.prototype, "farClipPlane", null);
-__decorate([
-    serializable()
-], Camera.prototype, "clearFlags", null);
-__decorate([
-    serializable()
-], Camera.prototype, "orthographic", void 0);
-__decorate([
-    serializable()
-], Camera.prototype, "orthographicSize", void 0);
-__decorate([
-    serializable()
-], Camera.prototype, "ARBackgroundAlpha", void 0);
-__decorate([
-    serializable()
-], Camera.prototype, "cullingMask", null);
-__decorate([
-    serializable()
-], Camera.prototype, "backgroundBlurriness", null);
-__decorate([
-    serializable()
-], Camera.prototype, "backgroundIntensity", null);
-__decorate([
-    serializable()
-], Camera.prototype, "environmentIntensity", null);
-__decorate([
-    serializable(RGBAColor)
-], Camera.prototype, "backgroundColor", null);
-__decorate([
-    serializable(RenderTexture)
-], Camera.prototype, "targetTexture", null);
-class CameraSkybox {
-    _camera;
-    _skybox;
-    get context() { return this._camera?.context; }
-    constructor(camera) {
-        this._camera = camera;
-    }
-    enable() {
-        this._skybox = this.context.lightmaps.tryGetSkybox(this._camera.sourceId);
-        if (!this._skybox) {
-            if (!this["_did_log_failed_to_find_skybox"]) {
-                this["_did_log_failed_to_find_skybox"] = true;
-                console.warn(`Camera \"${this._camera.name}\" failed to load/find skybox texture`, this._camera.sourceId, this.context.lightmaps, "Current background: ", this.context.scene.background);
-            }
-            if (debug || isDevEnvironment())
-                showBalloonWarning(`Camera \"${this._camera.name}\" has no skybox texture`);
-        }
-        else if (this.context.scene.background !== this._skybox) {
-            if (debug)
-                console.log(`Camera \"${this._camera.name}\" set skybox`, this._camera, this._skybox);
-            this._skybox.colorSpace = SRGBColorSpace;
-            this._skybox.mapping = EquirectangularReflectionMapping;
-            this.context.scene.background = this._skybox;
-        }
-    }
-}
-function handleFreeCam(cam) {
-    const isFreecam = getParam("freecam");
-    if (isFreecam) {
-        if (cam.context.mainCameraComponent === cam) {
-            GameObject.getOrAddComponent(cam.gameObject, OrbitControls);
-        }
-    }
-}
+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 { Behaviour, GameObject } from "./Component.js";
+import { getParam } from "../engine/engine_utils.js";
+import { serializable } from "../engine/engine_serialization_decorator.js";
+import { RGBAColor } from "./js-extensions/RGBAColor.js";
+import { XRSessionMode } from "../engine/engine_setup.js";
+import { isDevEnvironment, showBalloonMessage, showBalloonWarning } from "../engine/debug/index.js";
+import { getWorldPosition } from "../engine/engine_three_utils.js";
+import { Gizmos } from "../engine/engine_gizmos.js";
+import { EquirectangularReflectionMapping, OrthographicCamera, PerspectiveCamera, Ray, SRGBColorSpace, Vector3 } from "three";
+import { OrbitControls } from "./OrbitControls.js";
+import { RenderTexture } from "../engine/engine_texture.js";
+export var ClearFlags;
+(function (ClearFlags) {
+    ClearFlags[ClearFlags["Skybox"] = 1] = "Skybox";
+    ClearFlags[ClearFlags["SolidColor"] = 2] = "SolidColor";
+    ClearFlags[ClearFlags["Uninitialized"] = 4] = "Uninitialized";
+})(ClearFlags || (ClearFlags = {}));
+const debug = getParam("debugcam");
+const debugscreenpointtoray = getParam("debugscreenpointtoray");
+export class Camera extends Behaviour {
+    get isCamera() {
+        return true;
+    }
+    get aspect() {
+        if (this._cam instanceof PerspectiveCamera)
+            return this._cam.aspect;
+        return (this.context.domWidth / this.context.domHeight);
+    }
+    get fieldOfView() {
+        if (this._cam instanceof PerspectiveCamera) {
+            return this._cam.fov;
+        }
+        return this._fov;
+    }
+    set fieldOfView(val) {
+        const changed = this.fieldOfView != val;
+        this._fov = val;
+        if (changed && this._cam) {
+            if (this._cam instanceof PerspectiveCamera) {
+                if (this._fov === undefined) {
+                    console.warn("Can not set undefined fov on PerspectiveCamera");
+                    return;
+                }
+                this._cam.fov = this._fov;
+                this._cam.updateProjectionMatrix();
+            }
+        }
+    }
+    get nearClipPlane() { return this._nearClipPlane; }
+    set nearClipPlane(val) {
+        const changed = this._nearClipPlane != val;
+        this._nearClipPlane = val;
+        if (this._cam && changed) {
+            this._cam.near = val;
+            this._cam.updateProjectionMatrix();
+        }
+    }
+    _nearClipPlane = 0.1;
+    get farClipPlane() { return this._farClipPlane; }
+    set farClipPlane(val) {
+        const changed = this._farClipPlane != val;
+        this._farClipPlane = val;
+        if (this._cam && changed) {
+            this._cam.far = val;
+            this._cam.updateProjectionMatrix();
+        }
+    }
+    _farClipPlane = 1000;
+    get clearFlags() {
+        return this._clearFlags;
+    }
+    set clearFlags(val) {
+        if (val === this._clearFlags)
+            return;
+        this._clearFlags = val;
+        this.applyClearFlagsIfIsActiveCamera();
+    }
+    orthographic = false;
+    orthographicSize = 5;
+    ARBackgroundAlpha = 0;
+    /**
+     * The [`mask`](https://threejs.org/docs/#api/en/core/Layers.mask) value of the three camera object layers
+     * If you want to just see objects on one layer (e.g. layer 2) then you can use `cullingLayer = 2` on this camera component instead
+    */
+    set cullingMask(val) {
+        this._cullingMask = val;
+        if (this._cam) {
+            this._cam.layers.mask = val;
+        }
+    }
+    get cullingMask() {
+        if (this._cam)
+            return this._cam.layers.mask;
+        return this._cullingMask;
+    }
+    _cullingMask = 0xffffffff;
+    /** Set only a specific layer active to be rendered by the camera. This is equivalent to calling `layers.set(val)` */
+    set cullingLayer(val) {
+        this.cullingMask = (1 << val | 0) >>> 0;
+    }
+    set backgroundBlurriness(val) {
+        if (val === this._backgroundBlurriness)
+            return;
+        if (val === undefined)
+            this._backgroundBlurriness = undefined;
+        else
+            this._backgroundBlurriness = Math.min(Math.max(val, 0), 1);
+        this.applyClearFlagsIfIsActiveCamera();
+    }
+    get backgroundBlurriness() {
+        return this._backgroundBlurriness;
+    }
+    _backgroundBlurriness;
+    set backgroundIntensity(val) {
+        if (val === this._backgroundIntensity)
+            return;
+        if (val === undefined)
+            this._backgroundIntensity = undefined;
+        else
+            this._backgroundIntensity = Math.min(Math.max(val, 0), 10);
+        this.applyClearFlagsIfIsActiveCamera();
+    }
+    get backgroundIntensity() {
+        return this._backgroundIntensity;
+    }
+    _backgroundIntensity;
+    set environmentIntensity(val) {
+        this._environmentIntensity = val;
+    }
+    get environmentIntensity() {
+        return this._environmentIntensity;
+    }
+    _environmentIntensity;
+    get backgroundColor() {
+        return this._backgroundColor ?? null;
+    }
+    set backgroundColor(val) {
+        if (!val)
+            return;
+        if (!this._backgroundColor) {
+            if (!val.clone)
+                return;
+            this._backgroundColor = val.clone();
+        }
+        else
+            this._backgroundColor.copy(val);
+        // set background color to solid if provided color doesnt have any alpha channel
+        if (val.alpha === undefined)
+            this._backgroundColor.alpha = 1;
+        this.applyClearFlagsIfIsActiveCamera();
+    }
+    set targetTexture(rt) {
+        this._targetTexture = rt;
+    }
+    get targetTexture() {
+        return this._targetTexture;
+    }
+    _targetTexture = null;
+    _backgroundColor;
+    _fov;
+    _cam = null;
+    _clearFlags = ClearFlags.SolidColor;
+    _skybox;
+    get cam() {
+        if (this.activeAndEnabled)
+            this.buildCamera();
+        return this._cam;
+    }
+    static _origin = new Vector3();
+    static _direction = new Vector3();
+    screenPointToRay(x, y, ray) {
+        const cam = this.cam;
+        const origin = Camera._origin;
+        origin.set(x, y, -1);
+        this.context.input.convertScreenspaceToRaycastSpace(origin);
+        if (debugscreenpointtoray)
+            console.log("screenPointToRay", x.toFixed(2), y.toFixed(2), "now:", origin.x.toFixed(2), origin.y.toFixed(2), "isInXR:" + this.context.isInXR);
+        origin.z = -1;
+        origin.unproject(cam);
+        const dir = Camera._direction.set(origin.x, origin.y, origin.z);
+        const camPosition = getWorldPosition(cam);
+        dir.sub(camPosition);
+        dir.normalize();
+        if (ray) {
+            ray.set(camPosition, dir);
+            return ray;
+        }
+        else {
+            return new Ray(camPosition.clone(), dir.clone());
+        }
+    }
+    awake() {
+        if (debugscreenpointtoray) {
+            window.addEventListener("pointerdown", evt => {
+                const px = evt.clientX;
+                const py = evt.clientY;
+                console.log("touch", px.toFixed(2), py.toFixed(2));
+                const ray = this.screenPointToRay(px, py);
+                const randomHex = "#" + Math.floor(Math.random() * 16777215).toString(16);
+                Gizmos.DrawRay(ray.origin, ray.direction, randomHex, 10);
+            });
+        }
+    }
+    onEnable() {
+        if (debug)
+            console.log(`Camera enabled: \"${this.name}\". ClearFlags=${ClearFlags[this._clearFlags]}`, this);
+        this.buildCamera();
+        if (this.tag == "MainCamera" || !this.context.mainCameraComponent) {
+            this.context.setCurrentCamera(this);
+            handleFreeCam(this);
+        }
+        this.applyClearFlagsIfIsActiveCamera();
+    }
+    onDisable() {
+        this.context.removeCamera(this);
+    }
+    onBeforeRender() {
+        if (this._cam) {
+            // because the background color may be animated!
+            if (this._clearFlags === ClearFlags.SolidColor)
+                this.applyClearFlagsIfIsActiveCamera();
+            if (this._targetTexture) {
+                if (this.context.isManagedExternally) {
+                    // TODO: rendering with r3f renderer does throw an shader error for some reason?
+                    if (!this["_warnedAboutExternalRenderer"]) {
+                        this["_warnedAboutExternalRenderer"] = true;
+                        console.warn("Rendering with external renderer is not supported yet. This may not work or throw errors. Please remove the the target texture from your camera: " + this.name, this.targetTexture);
+                    }
+                }
+                // TODO: optimize to not render twice if this is already the main camera. In that case we just want to blit
+                const composer = this.context.composer;
+                const useNormalRenderer = true; // this.context.isInXR || !composer;
+                const renderer = useNormalRenderer ? this.context.renderer : composer;
+                if (renderer) {
+                    // TODO: we should do this in onBeforeRender for the main camera only
+                    const mainCam = this.context.mainCameraComponent;
+                    this.applyClearFlags();
+                    this._targetTexture.render(this.context.scene, this._cam, renderer);
+                    mainCam?.applyClearFlags();
+                }
+            }
+        }
+    }
+    buildCamera() {
+        if (this._cam)
+            return;
+        const cameraAlreadyCreated = this.gameObject["isCamera"];
+        // TODO: when exporting from blender we already have a camera in the children
+        let cam = null;
+        if (cameraAlreadyCreated) {
+            cam = this.gameObject;
+            cam?.layers.enableAll();
+            if (cam instanceof PerspectiveCamera)
+                this._fov = cam.fov;
+        }
+        else
+            cam = this.gameObject.children[0];
+        if (cam && cam.isCamera) {
+            if (cam instanceof PerspectiveCamera) {
+                if (this._fov)
+                    cam.fov = this._fov;
+                cam.near = this._nearClipPlane;
+                cam.far = this._farClipPlane;
+                cam.updateProjectionMatrix();
+            }
+        }
+        else if (!this.orthographic) {
+            cam = new PerspectiveCamera(this.fieldOfView, window.innerWidth / window.innerHeight, this._nearClipPlane, this._farClipPlane);
+            if (this.fieldOfView)
+                cam.fov = this.fieldOfView;
+            this.gameObject.add(cam);
+        }
+        else {
+            const factor = this.orthographicSize * 100;
+            cam = new OrthographicCamera(window.innerWidth / -factor, window.innerWidth / factor, window.innerHeight / factor, window.innerHeight / -factor, this._nearClipPlane, this._farClipPlane);
+            this.gameObject.add(cam);
+        }
+        this._cam = cam;
+        this._cam.layers.mask = this._cullingMask;
+        if (this.tag == "MainCamera") {
+            this.context.setCurrentCamera(this);
+        }
+    }
+    applyClearFlagsIfIsActiveCamera() {
+        if (this.context.mainCameraComponent === this) {
+            this.applyClearFlags();
+        }
+    }
+    applyClearFlags() {
+        if (!this._cam) {
+            if (debug)
+                console.log("Camera does not exist (apply clear flags)");
+            return;
+        }
+        // restore previous fov (e.g. when user was in VR or AR and the camera's fov has changed)
+        this.fieldOfView = this._fov;
+        if (debug) {
+            const msg = `Camera \"${this.name}\" clear flags: ${ClearFlags[this._clearFlags]}`;
+            console.log(msg);
+        }
+        switch (this._clearFlags) {
+            case ClearFlags.Skybox:
+                if (Camera.backgroundShouldBeTransparent(this.context)) {
+                    if (!this.ARBackgroundAlpha || this.ARBackgroundAlpha < 0.001) {
+                        this.context.scene.background = null;
+                        this.context.renderer.setClearColor(0x000000, 0);
+                        return;
+                    }
+                }
+                this.enableSkybox();
+                if (this._backgroundBlurriness !== undefined)
+                    this.context.scene.backgroundBlurriness = this._backgroundBlurriness;
+                if (this._backgroundIntensity !== undefined)
+                    //@ts-ignore
+                    this.context.scene.backgroundIntensity = this._backgroundIntensity;
+                break;
+            case ClearFlags.SolidColor:
+                if (this._backgroundColor) {
+                    let alpha = this._backgroundColor.alpha;
+                    // when in WebXR use ar background alpha override or set to 0
+                    if (Camera.backgroundShouldBeTransparent(this.context)) {
+                        alpha = this.ARBackgroundAlpha ?? 0;
+                    }
+                    this.context.scene.background = null;
+                    this.context.renderer.setClearColor(this._backgroundColor, alpha);
+                }
+                else {
+                    if (debug)
+                        console.warn(`Camera \"${this.name}\" has no background color`, this);
+                }
+                break;
+            case ClearFlags.Uninitialized:
+                this.context.scene.background = null;
+                this.context.renderer.setClearColor(0x000000, 0);
+                break;
+        }
+    }
+    enableSkybox() {
+        if (!this._skybox)
+            this._skybox = new CameraSkybox(this);
+        this._skybox.enable();
+    }
+    /** Returns true when in XR on a pass through device where the background shouldbe invisible */
+    static backgroundShouldBeTransparent(context) {
+        const session = context.renderer.xr?.getSession();
+        if (!session)
+            return false;
+        if (typeof session["_transparent"] === "boolean") {
+            return session["_transparent"];
+        }
+        const environmentBlendMode = session.environmentBlendMode;
+        if (debug)
+            showBalloonMessage("Environment blend mode: " + environmentBlendMode + " on " + navigator.userAgent);
+        let transparent = environmentBlendMode === 'additive' || environmentBlendMode === 'alpha-blend';
+        if (context.xrSessionMode === XRSessionMode.ImmersiveAR) {
+            if (environmentBlendMode === "opaque") {
+                // workaround for Quest 2 returning opaque when it should be alpha-blend
+                // check user agent if this is the Quest browser and return true if so
+                if (navigator.userAgent?.includes("OculusBrowser")) {
+                    transparent = true;
+                }
+                // Mozilla WebXR Viewer
+                else if (navigator.userAgent?.includes("Mozilla") && navigator.userAgent?.includes("Mobile WebXRViewer/v2")) {
+                    transparent = true;
+                }
+            }
+        }
+        session["_transparent"] = transparent;
+        return transparent;
+    }
+}
+__decorate([
+    serializable()
+], Camera.prototype, "fieldOfView", null);
+__decorate([
+    serializable()
+], Camera.prototype, "nearClipPlane", null);
+__decorate([
+    serializable()
+], Camera.prototype, "farClipPlane", null);
+__decorate([
+    serializable()
+], Camera.prototype, "clearFlags", null);
+__decorate([
+    serializable()
+], Camera.prototype, "orthographic", void 0);
+__decorate([
+    serializable()
+], Camera.prototype, "orthographicSize", void 0);
+__decorate([
+    serializable()
+], Camera.prototype, "ARBackgroundAlpha", void 0);
+__decorate([
+    serializable()
+], Camera.prototype, "cullingMask", null);
+__decorate([
+    serializable()
+], Camera.prototype, "backgroundBlurriness", null);
+__decorate([
+    serializable()
+], Camera.prototype, "backgroundIntensity", null);
+__decorate([
+    serializable()
+], Camera.prototype, "environmentIntensity", null);
+__decorate([
+    serializable(RGBAColor)
+], Camera.prototype, "backgroundColor", null);
+__decorate([
+    serializable(RenderTexture)
+], Camera.prototype, "targetTexture", null);
+class CameraSkybox {
+    _camera;
+    _skybox;
+    get context() { return this._camera?.context; }
+    constructor(camera) {
+        this._camera = camera;
+    }
+    enable() {
+        this._skybox = this.context.lightmaps.tryGetSkybox(this._camera.sourceId);
+        if (!this._skybox) {
+            if (!this["_did_log_failed_to_find_skybox"]) {
+                this["_did_log_failed_to_find_skybox"] = true;
+                console.warn(`Camera \"${this._camera.name}\" failed to load/find skybox texture`, this._camera.sourceId, this.context.lightmaps, "Current background: ", this.context.scene.background);
+            }
+            if (debug || isDevEnvironment())
+                showBalloonWarning(`Camera \"${this._camera.name}\" has no skybox texture`);
+        }
+        else if (this.context.scene.background !== this._skybox) {
+            if (debug)
+                console.log(`Camera \"${this._camera.name}\" set skybox`, this._camera, this._skybox);
+            this._skybox.colorSpace = SRGBColorSpace;
+            this._skybox.mapping = EquirectangularReflectionMapping;
+            this.context.scene.background = this._skybox;
+        }
+    }
+}
+function handleFreeCam(cam) {
+    const isFreecam = getParam("freecam");
+    if (isFreecam) {
+        if (cam.context.mainCameraComponent === cam) {
+            GameObject.getOrAddComponent(cam.gameObject, OrbitControls);
+        }
+    }
+}
 //# sourceMappingURL=Camera.js.map