@needle-tools/engine 2.24.0-pre

package/lib/engine/engine_serialization_core.js

@@ -0,0 +1,417 @@
+import { getParam } from "./engine_utils";
+import { isPersistentAsset } from "./extensions/NEEDLE_persistent_assets";
+import { debugExtension } from "../engine/engine_default_parameters";
+const debug = getParam("debugserializer");
+// internal helper class that we can ask for registered type serializers
+// register your own type by deriving from ITypeSerializer and calling helper.register
+class SerializationHelper {
+    register(type, ser) {
+        if (this.typeMap[type] !== undefined) {
+            if (this.typeMap[type] === ser)
+                return;
+            console.warn("Type " + type + " is already registered", ser, this.typeMap[type]);
+        }
+        if (debug)
+            console.log("Register type serializer for " + type, ser);
+        this.typeMap[type] = ser;
+    }
+    typeMap = {};
+    getSerializer(type) {
+        if (!type)
+            return undefined;
+        return this.typeMap[type];
+    }
+    getSerializerForConstructor(type, level = 0) {
+        if (level > 20)
+            return undefined;
+        if (!type || !type.constructor) {
+            if (debug)
+                console.log("invalid type");
+            return undefined;
+        }
+        const name = type.name ?? type.constructor?.name;
+        if (!name) {
+            if (debug)
+                console.log("invalid name", name);
+            return undefined;
+        }
+        const res = this.getSerializer(name);
+        if (res !== undefined) {
+            if (debug)
+                console.log("FOUND " + name, type.name, type.constructor.name, res, this.typeMap);
+            return res;
+        }
+        let parent = Object.getPrototypeOf(type);
+        const hasPrototypeOrConstructor = parent.prototype || parent.constructor;
+        // console.log(name, type, parent);
+        if (!hasPrototypeOrConstructor) {
+            if (debug)
+                console.warn("No prototype for " + name, type, type.name, type.prototype, type.constructor.name);
+            // console.log(type.constructor);
+            // console.dir(type);
+            // console.log(Object.getPrototypeOf(type))
+            // console.dir(parent, Object.getPrototypeOf(type));
+            // if(level <= 0){
+            //     const t = TypeStore.get(type.name);
+            //     console.log(type['__proto__'].name);
+            //     if(t) return this.getSerializerForConstructor(t, level + 1);
+            // }
+            return undefined;
+        }
+        const prot = parent.prototype ?? parent.constructor;
+        if (prot !== type) {
+            const resultFromChildren = this.getSerializerForConstructor(prot, ++level);
+            if (resultFromChildren) {
+                if (debug)
+                    console.log("FOUND " + prot.constructor.name, prot.name, prot, resultFromChildren);
+                // register sub type
+                const typeName = prot.name ?? prot.constructor.name;
+                if (typeName === "Function") {
+                    console.error("Registering Function is not allowed, something went wrong", type, prot, resultFromChildren);
+                }
+                else
+                    this.register(typeName, resultFromChildren);
+            }
+            return resultFromChildren;
+        }
+        return undefined;
+    }
+}
+export const helper = new SerializationHelper();
+/**
+ * implement and call super(<type string or array>) with the type names this serializer can handle
+ * for example:
+ * class ColorSerializer extends TypeSerializer {
+ *  constructor() {
+ *      super("Color")
+ *  }
+ * }
+*/
+export class TypeSerializer {
+    // register<T>(c: Constructor<T> | Constructor<T>[])
+    // {
+    //     if (Array.isArray(c)) {
+    //         for (const t of c) {
+    //             helper.register(t.name, this);
+    //         }
+    //     }
+    //     else {
+    //         helper.register(c.name, this);
+    //     }
+    // }
+    constructor(type) {
+        if (Array.isArray(type)) {
+            for (const key of type)
+                helper.register(key.name, this);
+        }
+        else
+            helper.register(type.name, this);
+    }
+}
+// passed to serializers
+export class SerializationContext {
+    root;
+    gltf;
+    gltfId;
+    object;
+    target;
+    nodeId;
+    nodeToObject;
+    objectToNode;
+    context;
+    path;
+    constructor(root) {
+        this.root = root;
+    }
+}
+;
+export function serializeObject(obj, context) {
+    const types = obj.$serializedTypes;
+    if (types === undefined)
+        return null;
+    const res = {};
+    for (const key in types) {
+        let val = obj[key];
+        // if the object bein serialized is some type of object check if we have special handling registered for it
+        if (val !== undefined && val !== null && typeof val === "object") {
+            // get type name
+            // get registered serialization handler
+            const ser = helper.getSerializerForConstructor(val);
+            if (ser) {
+                // serialize data using that handler
+                res[key] = ser.onSerialize(val, context);
+                continue;
+            }
+        }
+        res[key] = val;
+    }
+    // name is the component type
+    res["name"] = obj.constructor.name;
+    // serialize guid
+    if (typeof obj["guid"] === "string")
+        res["guid"] = obj["guid"];
+    return res;
+}
+const buffer = [];
+function collectSerializedTypesInBaseTypes(obj, typeInfoObject) {
+    if (!obj)
+        return typeInfoObject;
+    if (typeof obj.$serializedTypes === "object") {
+        if (!typeInfoObject)
+            typeInfoObject = {};
+        Object.assign(typeInfoObject, obj.$serializedTypes);
+    }
+    const parentTarget = Object.getPrototypeOf(obj);
+    return collectSerializedTypesInBaseTypes(parentTarget, typeInfoObject);
+}
+export function deserializeObject(obj, serializedData, context) {
+    if (!obj)
+        return false;
+    context.target = obj;
+    if (obj.onBeforeDeserialize !== undefined) {
+        const res = obj.onBeforeDeserialize(serializedData, context);
+        if (typeof res === "boolean")
+            return res;
+    }
+    // const typeInfo = obj.$serializedTypes;
+    const typeInfo = collectSerializedTypesInBaseTypes(obj);
+    if (serializedData) {
+        // restore guid (see serializeObject)
+        if (typeof serializedData["guid"] === "string")
+            obj["guid"] = serializedData["guid"];
+        if (typeInfo) {
+            for (const key in typeInfo) {
+                const serializedEntryInfo = typeInfo[key];
+                const data = serializedData[key];
+                context.path = key;
+                if (serializedEntryInfo === null) {
+                    obj[key] = data;
+                }
+                else {
+                    if (obj.onBeforeDeserializeMember !== undefined) {
+                        // callback to the instance, if it returns true assume it's done all the things itself
+                        if (obj.onBeforeDeserializeMember(key, data, context) === true)
+                            continue;
+                    }
+                    if (Array.isArray(serializedEntryInfo)) {
+                        for (let i = 0; i < serializedEntryInfo.length; i++) {
+                            const typeInfoOrConstructor = serializedEntryInfo[i];
+                            const res = tryResolve(typeInfoOrConstructor);
+                            if (res !== undefined || i === serializedEntryInfo.length - 1) {
+                                obj[key] = res;
+                                break;
+                            }
+                        }
+                    }
+                    else {
+                        obj[key] = tryResolve(serializedEntryInfo);
+                    }
+                    function tryResolve(typeInfoOrConstructor) {
+                        const typeInformationOrConstructor = typeInfoOrConstructor;
+                        // if the entry does specify an object of type ITypeInformation and has the type field set
+                        const type = typeInformationOrConstructor.type;
+                        if (type) {
+                            return deserializeObjectWithType(data, type, context, undefined, obj[key]);
+                        }
+                        // it can also just contain a constructor
+                        else {
+                            const constructor = typeInfoOrConstructor;
+                            return deserializeObjectWithType(data, constructor, context, undefined, obj[key]);
+                        }
+                    }
+                    buffer.length = 0;
+                    if (obj.onAfterDeserializeMember !== undefined) {
+                        obj.onAfterDeserializeMember(key, data, context);
+                    }
+                }
+            }
+        }
+        // ***
+        // the code below could be used to implictly assign serialized data if they are primitive types
+        // if we decide not to do this we always have to write out all the $serializedTypes
+        // *** 
+        implictlyAssignPrimitiveTypes(obj, serializedData);
+    }
+    if (obj.onAfterDeserialize !== undefined) {
+        obj.onAfterDeserialize(serializedData, context);
+    }
+    context.path = undefined;
+    return true;
+}
+function implictlyAssignPrimitiveTypes(obj, serializedData) {
+    // implictly assign serialized primitive fields
+    for (const key of Object.keys(serializedData)) {
+        const data = serializedData[key];
+        if (typeof data === "object" && data !== null && data !== undefined) {
+            const member = obj[key];
+            if (!member) {
+                if (debug)
+                    console.log(key, "is undefined on", obj);
+                continue;
+            }
+            for (const key of Object.keys(data)) {
+                const targetMember = member[key];
+                // implictly assign number, string, boolean if they are undefined
+                if (targetMember !== undefined)
+                    continue;
+                // resolve serialized primitive types
+                if (isPrimitiveType(data[key]) && !isPrimitiveType(member)) {
+                    // console.log("ASSIGN", key, member, member[key], targetMember, data[key]);
+                    member[key] = data[key];
+                }
+            }
+        }
+    }
+    function isPrimitiveType(val) {
+        switch (typeof val) {
+            case "number":
+            case "string":
+            case "boolean":
+                return true;
+        }
+        return false;
+    }
+}
+function deserializeObjectWithType(data, typeOrConstructor, context, typeContext, currentValue) {
+    // e.g. @serializable((data) => { })
+    let typeIsFunction = typeof typeOrConstructor === "function" && (typeOrConstructor.prototype === undefined);
+    let type = typeOrConstructor;
+    if (typeIsFunction) {
+        // it's possible to assign a function to serializable to dynamically say which type we expect
+        // e.g. if you have an array of types and you want the array to be resolved with different class instances
+        try {
+            const resolvedType = typeOrConstructor?.call(typeOrConstructor, currentValue);
+            type = resolvedType;
+            typeIsFunction = false;
+            if (type === null || type === undefined)
+                return;
+        }
+        catch (err) {
+            console.error("Error in callback", err, data);
+        }
+    }
+    // e.g. when @serializable(Texture) and the texture is already resolved via json pointer from gltf
+    // then we dont need to do anything else
+    if (!typeIsFunction && currentValue instanceof type)
+        return currentValue;
+    // if the value was already resolved via the persistent asset extension dont try to override that again
+    if (currentValue && typeof currentValue === "object" && isPersistentAsset(currentValue)) {
+        // if the persistent asset was already resolved to a concrete instance we dont need to do anything anymore
+        if (currentValue["__concreteInstance"]) {
+            return currentValue["__concreteInstance"];
+        }
+        const serializeableInstance = currentValue;
+        if (!serializeableInstance.$serializedTypes && type.prototype.$serializedTypes)
+            serializeableInstance.$serializedTypes = type.prototype.$serializedTypes;
+        if (serializeableInstance.$serializedTypes) {
+            deserializeObject(serializeableInstance, data, context);
+        }
+        if (currentValue && type !== undefined) {
+            try {
+                // we create a concrete instance for a persistent asset here
+                // hence we want to have the same instance across all usages of this asset
+                const instance = new type();
+                if (debugExtension)
+                    console.log("Create concrete instance for persistent asset", currentValue, "instance:", instance);
+                assign(instance, currentValue);
+                // save it so if another component references the same persistent asset it will automatically use the concrete instance
+                currentValue["__concreteInstance"] = instance;
+                currentValue = instance;
+            }
+            catch (err) {
+                console.error("Error creating instance or creating values on instance", err, currentValue, type);
+            }
+        }
+        return currentValue;
+    }
+    // try to resolve the serializer for a type only once
+    if (!typeContext) {
+        typeContext = {
+            serializer: helper.getSerializerForConstructor(type)
+        };
+    }
+    // if the type is an array resolve each entries recursively
+    if (Array.isArray(data)) {
+        const newArr = [];
+        for (let i = 0; i < data.length; i++) {
+            const obj = data[i];
+            // debugger;
+            const res = deserializeObjectWithType(obj, typeOrConstructor, context, typeContext, obj);
+            newArr.push(res);
+        }
+        // return value;
+        return newArr;
+    }
+    const ser = typeContext.serializer;
+    if (ser) {
+        return ser.onDeserialize(data, context);
+    }
+    // console.log(type.prototype.get("$serializedTypes"));
+    let instance = undefined;
+    if (data && (data.isMaterial || data.isTexture || data.isObject3D)) {
+        // if the data is already a threejs object we dont want to create a new instance
+        // e.g. if we have a serialized class with a serializeable(Material)
+        instance = data;
+    }
+    else {
+        // the fallback - this assumes that the type has a constructor that accepts the serialized arguments
+        // made originally with THREE.Vector3 in mind but SHOULD actually not be used/called anymore
+        instance = new type(...setBuffer(data));
+    }
+    // recurse if the deserialized member also implements ISerializeable
+    const serializeableInstance = instance;
+    if (serializeableInstance.$serializedTypes) {
+        deserializeObject(serializeableInstance, data, context);
+    }
+    return instance;
+}
+function setBuffer(value) {
+    buffer.length = 0;
+    if (typeof value === "object" && value !== null && value !== undefined) {
+        for (const key of Object.keys(value)) {
+            buffer.push(value[key]);
+        }
+    }
+    return buffer;
+}
+// const developmentMode = getParam("dev")
+/** Object.assign behaviour but check if property is writeable (e.g. getter only properties are skipped) */
+export function assign(target, source) {
+    if (source === undefined || source === null)
+        return;
+    if (target === undefined || target === null)
+        return;
+    let onlyDeclared = false;
+    // if (onlyDeclared === true && target.constructor) {
+    //     if (target.constructor[ALL_PROPERTIES_MARKER] === true)
+    //         onlyDeclared = false;
+    // }
+    // if (onlyDeclared !== true && target.constructor) {
+    //     if (target.constructor[STRICT_MARKER] === true)
+    //         onlyDeclared = true;
+    // }
+    // if (onlyDeclared === undefined)
+    //     onlyDeclared = true;
+    // if (developmentMode)
+    //     onlyDeclared = false;
+    for (const key of Object.keys(source)) {
+        const desc = getPropertyDescriptor(target, key);
+        if (onlyDeclared && desc === undefined)
+            continue;
+        if (!desc || desc.writable === true) {
+            target[key] = source[key];
+        }
+        else if (desc?.set !== undefined) {
+            target[key] = source[key];
+        }
+    }
+}
+// we need to recurse because the property might be defined in a base class
+function getPropertyDescriptor(obj, prop) {
+    let desc;
+    do {
+        desc = Object.getOwnPropertyDescriptor(obj, prop);
+    } while (!desc && (obj = Object.getPrototypeOf(obj)));
+    return desc;
+}
+//# sourceMappingURL=engine_serialization_core.js.map

package/lib/engine/engine_serialization_core.js.map

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

package/lib/engine/engine_serialization_decorator.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from "../engine-components/Component";
+export declare type TypeResolver<T> = (data: any) => Constructor<T> | null;
+export declare const serializeable: <T>(type?: Constructor<T> | TypeResolver<T> | (Constructor<any> | TypeResolver<T>)[] | null | undefined) => (_target: any, _propertyKey: string) => void;
+export declare const ALL_PROPERTIES_MARKER = "__NEEDLE__ALL_PROPERTIES";
+/** @deprecated current not used */
+export declare function allProperties(constructor: Function): void;
+export declare const STRICT_MARKER = "__NEEDLE__STRICT";
+/** @deprecated  current not used */
+export declare function strict(constructor: Function): void;

package/lib/engine/engine_serialization_decorator.js

@@ -0,0 +1,44 @@
+export const serializeable = function (type) {
+    if (type === undefined)
+        type = null;
+    // for primitive types the serialization handles it without the constructor and just assigns the value
+    // if the user still passes in a primitive type constructor we can just throw it away :)
+    if (!Array.isArray(type)) {
+        type = setNullForPrimitiveTypes(type);
+    }
+    else {
+        for (let i = 0; i < type.length; i++) {
+            const entry = type[i];
+            type[i] = setNullForPrimitiveTypes(entry);
+        }
+    }
+    return function (_target, _propertyKey) {
+        // this is important so objects with inheritance dont override their serialized type 
+        // info if e.g. multiple classes inheriting from the same type implement a member with the same name
+        // and both use @serializable() with different types 
+        if (!Object.getOwnPropertyDescriptor(_target, '$serializedTypes'))
+            _target["$serializedTypes"] = {};
+        const types = _target["$serializedTypes"] = _target["$serializedTypes"] || {};
+        types[_propertyKey] = type;
+    };
+};
+function setNullForPrimitiveTypes(type) {
+    switch (type?.prototype?.constructor?.name) {
+        case "Number":
+        case "String":
+        case "Boolean":
+            return null;
+    }
+    return type;
+}
+export const ALL_PROPERTIES_MARKER = "__NEEDLE__ALL_PROPERTIES";
+/** @deprecated current not used */
+export function allProperties(constructor) {
+    constructor[ALL_PROPERTIES_MARKER] = true;
+}
+export const STRICT_MARKER = "__NEEDLE__STRICT";
+/** @deprecated  current not used */
+export function strict(constructor) {
+    constructor[STRICT_MARKER] = true;
+}
+//# sourceMappingURL=engine_serialization_decorator.js.map

package/lib/engine/engine_serialization_decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine_serialization_decorator.js","sourceRoot":"","sources":["../../../engine/engine_serialization_decorator.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAAG,UAAa,IAA0F;IAChI,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,GAAG,IAAI,CAAC;IACpC,sGAAsG;IACtG,wFAAwF;IACxF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACtB,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;KACzC;SACI;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;SAC7C;KACJ;IAED,OAAO,UAAU,OAAY,EAAE,YAAoB;QAC/C,qFAAqF;QACrF,oGAAoG;QACpG,qDAAqD;QACrD,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,CAAC;YAC7D,OAAO,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAA;QAC7E,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC/B,CAAC,CAAA;AACL,CAAC,CAAA;AAED,SAAS,wBAAwB,CAAC,IAAI;IAClC,QAAQ,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;QACxC,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACV,OAAO,IAAI,CAAC;KACnB;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAGD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAGhE,mCAAmC;AACnC,MAAM,UAAU,aAAa,CAAC,WAAqB;IAC/C,WAAW,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAGD,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEhD,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,WAAqB;IACxC,WAAW,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC"}

package/lib/engine/engine_setup.d.ts

@@ -0,0 +1,129 @@
+import * as THREE from 'three';
+import { Behaviour, Component } from '../engine-components/Component';
+import { Input } from './engine_input';
+import { Physics } from './engine_physics';
+import { Time } from './engine_time';
+import { NetworkConnection } from './engine_networking';
+import { Camera } from '../engine-components/Camera';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
+import { AssetDatabase } from './engine_assetdatabase';
+import { Light } from '../engine-components/Light';
+import { RendererData } from './engine_rendererdata';
+import { Addressables } from './engine_addressables';
+import { Application } from './engine_application';
+import { ILightDataRegistry } from './engine_lightdata';
+export declare const build_scene_functions: {
+    [name: string]: (context: Context) => Promise<void>;
+};
+declare type CoroutineData = {
+    comp: Component;
+    main: Generator;
+    chained?: Array<Generator>;
+};
+export declare class LoadingProgressArgs {
+    name: string;
+    progress: ProgressEvent;
+    index: number;
+    count: number;
+}
+export declare class LoadingOptions {
+    progress: (args: LoadingProgressArgs) => void;
+}
+export declare class ContextArgs {
+    name: string | undefined | null;
+    alias: string | undefined | null;
+    domElement: HTMLElement | null;
+    renderer?: THREE.WebGLRenderer;
+    constructor(domElement: HTMLElement | null);
+}
+export declare enum FrameEvent {
+    EarlyUpdate = 0,
+    Update = 1,
+    LateUpdate = 2,
+    OnBeforeRender = 3,
+    OnAfterRender = 4,
+    PhysicsStep = 10
+}
+export declare type OnBeforeRenderCallback = (renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, geometry: THREE.BufferGeometry, material: THREE.Material, group: THREE.Group) => void;
+export declare class Context {
+    private static _current;
+    static get Current(): Context;
+    static set Current(context: Context);
+    name: string;
+    alias: string | undefined | null;
+    isManagedExternally: boolean;
+    domElement: HTMLElement;
+    get domWidth(): number;
+    get domHeight(): number;
+    get domX(): number;
+    get domY(): number;
+    get isInXR(): boolean;
+    get AROverlayElement(): HTMLElement;
+    scene: THREE.Scene;
+    renderer: THREE.WebGLRenderer;
+    composer: EffectComposer | null;
+    scripts: Behaviour[];
+    scripts_earlyUpdate: Behaviour[];
+    scripts_update: Behaviour[];
+    scripts_lateUpdate: Behaviour[];
+    scripts_onBeforeRender: Behaviour[];
+    scripts_onAfterRender: Behaviour[];
+    scripts_WithCorroutines: Component[];
+    coroutines: {
+        [FrameEvent: number]: Array<CoroutineData>;
+    };
+    get mainCamera(): THREE.Camera | null;
+    mainCameraComponent: Camera | undefined;
+    post_setup_callbacks: Function[];
+    pre_update_callbacks: Function[];
+    pre_render_callbacks: Function[];
+    post_render_callbacks: Function[];
+    new_scripts: Behaviour[];
+    new_script_start: Component[];
+    new_scripts_pre_setup_callbacks: Function[];
+    new_scripts_post_setup_callbacks: Function[];
+    application: Application;
+    time: Time;
+    input: Input;
+    physics: Physics;
+    connection: NetworkConnection;
+    /**
+     * @deprecated AssetDataBase is deprecated
+     */
+    assets: AssetDatabase;
+    mainLight: Light | null;
+    rendererData: RendererData;
+    addressables: Addressables;
+    lightmaps: ILightDataRegistry;
+    private _sizeChanged;
+    private _isCreated;
+    private _stats;
+    constructor(args: ContextArgs | undefined);
+    private updateSize;
+    updateAspect(camera: THREE.PerspectiveCamera): void;
+    onCreate(buildScene: (context: Context, loadingOptions?: LoadingOptions) => Promise<void>, opts?: LoadingOptions): Promise<void> | null;
+    onDestroy(): void;
+    registerCoroutineUpdate(script: Component, coroutine: Generator, evt: FrameEvent): Generator;
+    unregisterCoroutineUpdate(coroutine: Generator, evt: FrameEvent): void;
+    stopAllCoroutinesFrom(script: Component): void;
+    private _cameraStack;
+    setCurrentCamera(cam: Camera): void;
+    private _onBeforeRenderListeners;
+    /** use this to subscribe to onBeforeRender events on threejs objects */
+    addBeforeRenderListener(target: THREE.Object3D, callback: OnBeforeRenderCallback): void;
+    removeBeforeRenderListener(target: THREE.Object3D, callback: OnBeforeRenderCallback): void;
+    private _requireDepthTexture;
+    private _requireColorTexture;
+    private _renderTarget?;
+    private _isRendering;
+    get isRendering(): boolean;
+    setRequireDepth(val: boolean): void;
+    setRequireColor(val: boolean): void;
+    get depthTexture(): THREE.DepthTexture | null;
+    get opaqueColorTexture(): THREE.Texture | null;
+    private internalOnCreate;
+    private render;
+    private renderRequiredTextures;
+    private executeCoroutines;
+}
+export {};