@needle-tools/engine 2.24.0-pre

package/lib/engine-components/AvatarLoader.js

@@ -0,0 +1,203 @@
+import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader";
+import * as THREE from "three";
+import * as utils from "../engine/engine_utils";
+import * as object from "../engine/engine_gltf_builtin_components";
+import * as loaders from "../engine/engine_loaders";
+import { GameObject, InstantiateOptions } from "./Component";
+import { download_file } from "../engine/engine_web_api";
+import { parseSync } from "../engine/engine_scenetools";
+const debug = utils.getParam("debugavatar");
+export class AvatarModel {
+    root;
+    head;
+    leftHand;
+    rigthHand;
+    get isValid() {
+        return this.head !== null && this.head !== undefined;
+    }
+    constructor(root, head, leftHand, rigthHand) {
+        this.root = root;
+        this.head = head;
+        this.leftHand = leftHand;
+        this.rigthHand = rigthHand;
+        this.root?.traverse(h => h.layers.set(2));
+        // this.head?.traverse(h => h.layers.set(2));
+        // this.leftHand?.traverse(h => h.layers.set(2));
+        // this.rigthHand?.traverse(h => h.layers.set(2));
+    }
+    // createNewInstance(): AvatarModel {
+    //     const head = GameObject.instantiate(this.head);
+    //     const lh = GameObject.instantiate(this.leftHand);
+    //     const rh = GameObject.instantiate(this.rigthHand);
+    //     const model = new AvatarModel(this.root, head, lh, rh);
+    //     this.assignRandomColors();
+    //     return model;
+    // }
+    assignRandomColors() {
+        AvatarLoader.assignRandomPlayerColors(this);
+    }
+}
+export class AvatarLoader {
+    avatarRegistryUrl = null; // = "https://needle-storage-castle-demo.glitch.me";//"https://smol-worlds.glitch.me/files/";
+    // private loader: GLTFLoader | null;
+    avatarModelCache = new Map();
+    async getOrCreateNewAvatarInstance(context, avatarId) {
+        if (!avatarId) {
+            console.error("Can not create avatar: failed to provide id or root object");
+            return null;
+        }
+        let root = null;
+        if (typeof avatarId === "string") {
+            root = await this.loadAvatar(context, avatarId);
+            if (!root) {
+                const opts = new InstantiateOptions();
+                // opts.parent = context.scene.uuid;
+                root = GameObject.instantiate(utils.tryFindObject(avatarId, context.scene), opts);
+            }
+        }
+        else
+            root = avatarId;
+        if (!root) {
+            return null;
+        }
+        const model = this.findAvatar(root);
+        // console.log(model);
+        model.assignRandomColors();
+        // this.cacheModel(avatarId, model);
+        if (model.isValid) {
+            if (debug)
+                console.log("[Custom Avatar] valid config", avatarId, debug ? model : "");
+            return model;
+        }
+        else {
+            console.warn("[Custom Avatar] config isn't valid", avatarId, debug ? model : "");
+            return null;
+        }
+    }
+    async loadAvatar(context, avatarId) {
+        console.assert(avatarId !== undefined && avatarId !== null && typeof avatarId === "string", "Avatar id must not be null");
+        if (avatarId.length <= 0)
+            return null;
+        if (!avatarId)
+            return null;
+        if (debug)
+            console.log("[Custom Avatar] " + avatarId + ", loading...");
+        // should probably be done by the server?!
+        if (!avatarId.endsWith(".glb"))
+            avatarId += ".glb";
+        // for the demo we use the storage backend we uploaded the avatar to (by file drop)
+        if (this.avatarRegistryUrl === null) {
+            // try loading avatar from local file
+            const download_res = await fetch("./" + avatarId);
+            let bin = null;
+            if (download_res.ok) {
+                const blob = await download_res.blob();
+                if (blob)
+                    bin = await blob.arrayBuffer();
+            }
+            if (!bin) {
+                bin = await download_file(avatarId, avatarId, 0, "no url here go away", true);
+                if (!bin)
+                    return null;
+            }
+            const gltf = await parseSync(context, bin, null, 0);
+            return gltf?.scene ?? null;
+        }
+        // if (this.avatarModelCache.has(avatarId)) {
+        //     console.log("[Custom Avatar] " + avatarId + ", found in cache");
+        //     return new Promise((res, _) => {
+        //         var model = this.avatarModelCache.get(avatarId)?.createNewInstance();
+        //         res(model);
+        //     });
+        // }
+        // return null;
+        const loader = new GLTFLoader();
+        loaders.addDracoAndKTX2Loaders(loader, context);
+        // TODO: cache binary (fetch finary from model gallery and use binary method)
+        return new Promise((resolve, _reject) => {
+            const url = this.avatarRegistryUrl + "/" + avatarId;
+            loader.load(url, async (gltf) => {
+                await object.createBuiltinComponents(context, url, gltf);
+                resolve(gltf.scene);
+            }, progress => {
+                if (debug)
+                    console.log("[Custom Avatar] " + (progress.loaded / progress.total * 100) + '% loaded of ' + (progress.total / 1024) + "kB");
+            }, error => {
+                console.error("[Custom Avatar] " + "Error when loading: " + error);
+                resolve(null);
+            });
+        });
+    }
+    cacheModel(_id, _model) {
+        // this.avatarModelCache.set(id, model);
+    }
+    // TODO this should be burned to the ground once 🤞 we have proper extras that define object relations.
+    findAvatar(obj) {
+        const root = obj;
+        let searchIn = root;
+        // some GLTFs have a "scene" root it seems, others don't, we skip the root here if there's only one child
+        if (searchIn.children.length == 1)
+            searchIn = obj.children[0];
+        let head = this.findAvatarPart(searchIn, "head");
+        const leftHand = this.findAvatarPart(searchIn, "left");
+        const rightHand = this.findAvatarPart(searchIn, "right");
+        if (!head) {
+            // very last fallback, entire root is used as head
+            head = root;
+            // normalize size, if the object isn't properly setup the scale might be totally off
+            let boundsSize = new THREE.Vector3();
+            new THREE.Box3().setFromObject(head).getSize(boundsSize);
+            let maxAxis = Math.max(boundsSize.x, boundsSize.y, boundsSize.z);
+            console.warn("[Custom Avatar] " + "Normalizing head scale, it's too big: " + maxAxis + " meters! Should be < 0.3m");
+            if (maxAxis > 0.3) {
+                head.scale.multiplyScalar(1.0 / maxAxis * 0.3);
+            }
+        }
+        const model = new AvatarModel(root, head, leftHand, rightHand);
+        return model;
+    }
+    findAvatarPart(obj, searchString) {
+        for (let child of obj.children) {
+            if (child.name.toLowerCase().indexOf(searchString) > -1)
+                return child;
+        }
+        return null;
+    }
+    handleCustomAvatarErrors(response) {
+        if (!response.ok) {
+            throw Error(response.statusText);
+        }
+        return response;
+    }
+    static assignRandomPlayerColors(model) {
+        const foundMaterials = new Map();
+        function findPlayerColorMeshesAndAssignColors(o) {
+            // console.log(o);
+            if (o.type === "Mesh") {
+                const mesh = o;
+                const mat = mesh.material;
+                if (mat && mat.name) {
+                    if (foundMaterials.has(mat.uuid)) {
+                        const found = foundMaterials.get(mat.uuid);
+                        if (found)
+                            mesh.material = found;
+                        return;
+                    }
+                    if (mat.name.endsWith("_playercolor") || mat.name.endsWith("_player_color2")) {
+                        const uuid = mat.uuid;
+                        mesh.material = mat.clone();
+                        mesh.material["color"] = new THREE.Color(Math.random(), Math.random(), Math.random());
+                        foundMaterials.set(uuid, mesh.material);
+                    }
+                }
+            }
+        }
+        if (model.head)
+            model.head.traverse(findPlayerColorMeshesAndAssignColors);
+        if (model.leftHand)
+            model.leftHand.traverse(findPlayerColorMeshesAndAssignColors);
+        if (model.rigthHand)
+            model.rigthHand.traverse(findPlayerColorMeshesAndAssignColors);
+    }
+}
+//# sourceMappingURL=AvatarLoader.js.map

package/lib/engine-components/AvatarLoader.js.map

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

package/lib/engine-components/AxesHelper.d.ts

@@ -0,0 +1,9 @@
+import { Behaviour } from "./Component";
+export declare class AxesHelper extends Behaviour {
+    length: number;
+    depthTest: boolean;
+    isGizmo: boolean;
+    private _axes;
+    onEnable(): void;
+    onDisable(): void;
+}

package/lib/engine-components/AxesHelper.js

@@ -0,0 +1,43 @@
+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 } from "./Component";
+import * as params from "../engine/engine_default_parameters";
+import { serializeable } from "../engine/engine_serialization_decorator";
+import { AxesHelper as _AxesHelper } from "three";
+export class AxesHelper extends Behaviour {
+    length = 1;
+    depthTest = true;
+    isGizmo = true;
+    _axes = null;
+    onEnable() {
+        if (this.isGizmo && !params.showGizmos)
+            return;
+        if (!this._axes)
+            this._axes = new _AxesHelper(this.length);
+        this.gameObject.add(this._axes);
+        const mat = this._axes.material;
+        if (mat) {
+            if (mat.depthTest !== undefined)
+                mat.depthTest = this.depthTest;
+        }
+    }
+    onDisable() {
+        if (!this._axes)
+            return;
+        this.gameObject.remove(this._axes);
+    }
+}
+__decorate([
+    serializeable()
+], AxesHelper.prototype, "length", void 0);
+__decorate([
+    serializeable()
+], AxesHelper.prototype, "depthTest", void 0);
+__decorate([
+    serializeable()
+], AxesHelper.prototype, "isGizmo", void 0);
+//# sourceMappingURL=AxesHelper.js.map

package/lib/engine-components/AxesHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxesHelper.js","sourceRoot":"","sources":["../../../engine-components/AxesHelper.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,OAAO,UAAW,SAAQ,SAAS;IAE9B,MAAM,GAAW,CAAC,CAAC;IAEnB,SAAS,GAAY,IAAI,CAAC;IAE1B,OAAO,GAAW,IAAI,CAAC;IAEtB,KAAK,GAA4B,IAAI,CAAC;IAE9C,QAAQ;QACJ,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK;YACX,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,GAAG,GAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACrC,IAAI,GAAG,EAAE;YACL,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAC3B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;SACtC;IACL,CAAC;IAED,SAAS;QACL,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACJ;AAxBG;IADC,aAAa,EAAE;0CACU;AAE1B;IADC,aAAa,EAAE;6CACiB;AAEjC;IADC,aAAa,EAAE;2CACc"}

package/lib/engine-components/BasicIKConstraint.d.ts

@@ -0,0 +1,9 @@
+import { Behaviour } from "./Component";
+export declare class BasicIKConstraint extends Behaviour {
+    private from;
+    private to;
+    private hint;
+    private desiredDistance;
+    onEnable(): void;
+    update(): void;
+}

package/lib/engine-components/BasicIKConstraint.js

@@ -0,0 +1,44 @@
+import { Behaviour } from "./Component";
+import * as utils from "./../engine/engine_three_utils";
+import * as THREE from "three";
+export class BasicIKConstraint extends Behaviour {
+    from;
+    to;
+    hint;
+    desiredDistance = 1;
+    onEnable() {
+        // console.log(this);
+    }
+    update() {
+        if (!this.from || !this.to || !this.hint)
+            return;
+        // console.log(this);
+        // find center
+        let toPos = utils.getWorldPosition(this.to).clone();
+        let fromPos = utils.getWorldPosition(this.from).clone();
+        let dist = toPos.distanceTo(fromPos);
+        let dir0 = toPos.clone();
+        dir0.sub(fromPos);
+        let center = fromPos.clone();
+        center.add(toPos);
+        center.multiplyScalar(0.5);
+        // find direction we should offset in
+        let hintDir = utils.getWorldPosition(this.hint).clone();
+        hintDir.sub(center);
+        let offsetDir = new THREE.Vector3();
+        offsetDir.crossVectors(hintDir, dir0);
+        offsetDir.crossVectors(dir0, offsetDir);
+        offsetDir.normalize();
+        let halfDist = dist * 0.5;
+        let stretchDistance = Math.max(this.desiredDistance, halfDist);
+        let offsetLength = Math.sqrt(stretchDistance * stretchDistance - halfDist * halfDist);
+        let resultPos = offsetDir.clone();
+        resultPos.multiplyScalar(offsetLength);
+        resultPos.add(center);
+        utils.setWorldPosition(this.gameObject, resultPos);
+        let lookPos = center.clone();
+        lookPos.sub(offsetDir);
+        this.gameObject.lookAt(lookPos);
+    }
+}
+//# sourceMappingURL=BasicIKConstraint.js.map

package/lib/engine-components/BasicIKConstraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicIKConstraint.js","sourceRoot":"","sources":["../../../engine-components/BasicIKConstraint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,gCAAgC,CAAC;AACxD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAEpC,IAAI,CAAc;IAClB,EAAE,CAAc;IAChB,IAAI,CAAc;IAClB,eAAe,GAAW,CAAC,CAAC;IAEpC,QAAQ;QACJ,qBAAqB;IACzB,CAAC;IAED,MAAM;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QAEjD,qBAAqB;QAErB,cAAc;QACd,IAAI,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACpD,IAAI,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,IAAI,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAE3B,qCAAqC;QACrC,IAAI,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,IAAI,SAAS,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACpC,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACxC,SAAS,CAAC,SAAS,EAAE,CAAC;QAEtB,IAAI,QAAQ,GAAG,IAAI,GAAG,GAAG,CAAC;QAC1B,IAAI,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;QAEtF,IAAI,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QAClC,SAAS,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACvC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAEnD,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACJ"}

package/lib/engine-components/BoxCollider.d.ts

@@ -0,0 +1,2 @@
+import { BoxCollider } from "./Collider";
+export default BoxCollider;

package/lib/engine-components/BoxCollider.js

@@ -0,0 +1,3 @@
+import { BoxCollider } from "./Collider";
+export default BoxCollider;
+//# sourceMappingURL=BoxCollider.js.map

package/lib/engine-components/BoxCollider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxCollider.js","sourceRoot":"","sources":["../../../engine-components/BoxCollider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,eAAe,WAAW,CAAC"}

package/lib/engine-components/BoxHelperComponent.d.ts

@@ -0,0 +1,16 @@
+import { Behaviour } from "./Component";
+import * as THREE from "three";
+export declare class BoxHelperComponent extends Behaviour {
+    private box;
+    private testBox;
+    private _lastMatrixUpdateFrame;
+    private static _position;
+    private static _size;
+    isInBox(obj: THREE.Object3D): boolean | undefined;
+    intersects(box: THREE.Box3): boolean;
+    updateBox(force?: boolean): THREE.Box3;
+    private _helper;
+    private _color;
+    awake(): void;
+    showHelper(col?: THREE.ColorRepresentation | null, force?: boolean): void;
+}

package/lib/engine-components/BoxHelperComponent.js

@@ -0,0 +1,72 @@
+import { Behaviour } from "./Component";
+import * as THREE from "three";
+import { getParam } from "../engine/engine_utils";
+import { CreateWireCube } from "../engine/engine_gizmos";
+import { getWorldPosition, getWorldScale } from "../engine/engine_three_utils";
+const gizmos = getParam("gizmos");
+export class BoxHelperComponent extends Behaviour {
+    box = null;
+    testBox = new THREE.Box3();
+    _lastMatrixUpdateFrame = -1;
+    static _position = new THREE.Vector3();
+    static _size = new THREE.Vector3(.01, .01, .01);
+    isInBox(obj) {
+        if (!obj)
+            return undefined;
+        // if (!obj.geometry.boundingBox) obj.geometry.computeBoundingBox();
+        // if (!obj.geometry.boundingBox) return undefined;
+        if (!this.box) {
+            this.box = new THREE.Box3();
+        }
+        this.updateBox(false);
+        if (obj.type === "Mesh")
+            this.testBox.setFromObject(obj);
+        else {
+            const wp = getWorldPosition(obj, BoxHelperComponent._position);
+            const size = getWorldScale(obj, BoxHelperComponent._size);
+            this.testBox.setFromCenterAndSize(wp, size);
+        }
+        // this.tp.copy(obj.geometry.boundingBox);
+        // // this.tp.setFromCenterAndSize(obj.position, obj.scale);
+        // this.tp.applyMatrix4(obj.matrixWorld);
+        // console.log(this.tp);
+        // console.log(this.box?.min, this.box?.max, this.tp.min, this.tp.max);
+        return this.box?.intersectsBox(this.testBox);
+    }
+    intersects(box) {
+        if (!box)
+            return false;
+        return this.updateBox(false).intersectsBox(box);
+    }
+    updateBox(force = false) {
+        if (!this.box) {
+            this.box = new THREE.Box3();
+        }
+        if (force || this.context.time.frameCount != this._lastMatrixUpdateFrame) {
+            this._lastMatrixUpdateFrame = this.context.time.frameCount;
+            this.box.setFromCenterAndSize(new THREE.Vector3(0, 0, 0), new THREE.Vector3(1, 1, 1));
+            this.box.applyMatrix4(this.gameObject.matrixWorld);
+        }
+        return this.box;
+    }
+    _helper = null;
+    _color = null;
+    awake() {
+        this._helper = null;
+        this._color = null;
+        this.box = null;
+    }
+    showHelper(col = null, force = false) {
+        if (!gizmos && !force)
+            return;
+        if (this._helper) {
+            if (col)
+                this._color?.set(col);
+            this.gameObject.add(this._helper);
+            return;
+        }
+        this._helper = CreateWireCube(col);
+        this.gameObject.add(this._helper);
+    }
+}
+//# sourceMappingURL=BoxHelperComponent.js.map

package/lib/engine-components/BoxHelperComponent.js.map

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

package/lib/engine-components/Camera.d.ts

@@ -0,0 +1,38 @@
+import { Behaviour } from "./Component";
+import * as THREE from "three";
+import { RGBAColor } from "./js-extensions/RGBAColor";
+export declare enum ClearFlags {
+    Skybox = 1,
+    SolidColor = 2,
+    Uninitialized = 4
+}
+export declare class Camera extends Behaviour {
+    get aspect(): number;
+    get fieldOfView(): number;
+    set fieldOfView(val: number);
+    get nearClipPlane(): number;
+    set nearClipPlane(val: number);
+    get farClipPlane(): number;
+    set farClipPlane(val: number);
+    get clearFlags(): ClearFlags;
+    set clearFlags(val: ClearFlags);
+    orthographic: boolean;
+    orthographicSize: number;
+    ARBackgroundAlpha: number;
+    private _nearClipPlane;
+    private _farClipPlane;
+    get backgroundColor(): RGBAColor | null;
+    set backgroundColor(val: RGBAColor | null);
+    private _backgroundColor?;
+    private _fov;
+    private _cam;
+    private _clearFlags;
+    private _skybox?;
+    get cam(): THREE.PerspectiveCamera | THREE.OrthographicCamera;
+    awake(): void;
+    onEnable(): void;
+    buildCamera(): void;
+    applyClearFlagsIfIsActiveCamera(): void;
+    private enableSkybox;
+}
+export declare function createCameraWithOrbitControl(scene: THREE.Scene): Camera;