ThreePipe
    Preparing search index...

    Interface IScene<TE>

    interface IScene<TE extends ISceneEventMap = ISceneEventMap> {
        __exportState?: {
            fomMap: Map<
                IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
                undefined | Material<MaterialEventMap> | Material<MaterialEventMap>[],
            >;
            geomMap: Map<
                IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
                undefined | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            >;
            matCloneMap: Map<
                IMaterial<IMaterialEventMap>,
                IMaterial<IMaterialEventMap>,
            >;
            meshLines: Map<
                IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
                IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            >;
            objectList: Set<
                IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
            >;
            savedTextures: Map<
                | IMaterial<IMaterialEventMap>
                | IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
                Record<string, ITexture<TextureEventMap>>,
            >;
        };
        __meshSetup?: boolean;
        __objectSetup?: boolean;
        __objExtUiConfigs?: Record<
            string,
            | undefined
            | (
                | UiObjectConfig<any, string, any>
                | Fof<ValOrArrOp<UiObjectConfig<any, string, any>>>
            )[],
        >;
        _currentGeometry?:
            | null
            | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>;
        _currentMaterial?:
            | null
            | IMaterial<IMaterialEventMap>
            | IMaterial<IMaterialEventMap>[];
        _customDepthMaterial?: Material<MaterialEventMap>;
        _customGBufferMaterial?: Material<MaterialEventMap>;
        _customNormalMaterial?: Material<MaterialEventMap>;
        _loadingPromise?: Promise<any>;
        _onGeometryUpdate?: EventListener2<
            "geometryUpdate",
            BufferGeometryEventMap,
            IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
        >;
        _rootPathRefreshed?: boolean;
        _rootPathRefreshing?: boolean;
        _sChildren?: Object3D<Object3DEventMap>[];
        acceptChildEvents?: boolean;
        activeCamera: ICamera;
        assetType?: "model" | "light" | "camera" | "widget";
        autoUpgradeChildren?: boolean;
        background: null | ITexture<TextureEventMap> | Color | "environment";
        backgroundColor: null | Color;
        backgroundIntensity: number;
        boundingBox?: null | Box3;
        boundingSphere?: null | Sphere;
        children: IObject3D<
            IObject3DEventMap,
            undefined
            | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
        >[];
        currentMaterial?:
            | null
            | IMaterial<IMaterialEventMap>
            | IMaterial<IMaterialEventMap>[];
        customGBufferMaterial?: Material<MaterialEventMap>;
        customNormalMaterial?: Material<MaterialEventMap>;
        defaultCamera: ICamera;
        environment: null | ITexture<TextureEventMap>;
        envMapIntensity: number;
        fixedEnvMapDirection: boolean;
        forcedOverrideGeometry?: IGeometry<
            NormalBufferAttributes,
            BufferGeometryEventMap,
        >;
        forcedOverrideMaterial?: | Material<MaterialEventMap>
        | Material<MaterialEventMap>[];
        geometry?: IGeometry<NormalBufferAttributes, BufferGeometryEventMap>;
        isAmbientLight?: boolean;
        isCamera?: boolean;
        isDirectionalLight?: boolean;
        isHemisphereLight?: boolean;
        isInstancedMesh?: boolean;
        isLight?: boolean;
        isLine?: boolean;
        isLine2?: boolean;
        isLineSegments?: boolean;
        isLineSegments2?: boolean;
        isMesh?: boolean;
        isMeshLine?: boolean;
        isPointLight?: boolean;
        isPoints?: boolean;
        isRectAreaLight?: boolean;
        isScene: true;
        isSkinnedMesh?: boolean;
        isSpotLight?: boolean;
        isWidget?: boolean;
        isWireframe?: boolean;
        mainCamera: ICamera;
        material?: IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[];
        materials?: IMaterial<IMaterialEventMap>[];
        modelRoot: IObject3D;
        morphTargetDictionary?: Record<string, number>;
        morphTargetInfluences?: number[];
        objectExtensions?: IObjectExtension[];
        objectProcessor?: IObjectProcessor;
        parent:
            | null
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >;
        parentRoot?:
            | null
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >;
        renderCamera: ICamera;
        type: "Scene";
        uiConfig?: UiObjectConfig<any, string, any>;
        userData: IObject3DUserData;
        visible: boolean;
        add(
            ...object: IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >[],
        ): this;
        addObject<
            T extends
                IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >,
        >(
            imported: T,
            options?: AddObjectOptions,
        ): T & IObject3D<
            IObject3DEventMap,
            undefined
            | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
        >;
        autoCenter(setDirty?: boolean, undo?: boolean): void;
        autoScale(
            autoScaleRadius?: number,
            isCentered?: boolean,
            setDirty?: boolean,
            undo?: boolean,
        ): void;
        clone(recursive?: boolean): this;
        computeBoundingBox(): void;
        computeBoundingSphere(): void;
        computeLineDistances(): void;
        copy(
            source:
                | IObject3D<
                    IObject3DEventMap,
                    undefined
                    | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,

                        | undefined
                        | IMaterial<IMaterialEventMap>
                        | IMaterial<IMaterialEventMap>[],
                >
                | Scene<Object3DEventMap>
                | IScene<ISceneEventMap>,
            recursive?: boolean,
        ): IScene<ISceneEventMap> & IScene<TE>;
        dispose(removeFromParent?: boolean): any;
        findObjectsByName(name: string, parent?: any): any[];
        getBounds(precise?: boolean, ignoreInvisible?: boolean): Box3B;
        getObjectById(
            id: number,
        ):
            | undefined
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >;
        getObjectByName(
            name: string,
        ):
            | undefined
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >;
        getObjectByProperty(
            name: string,
            value: string,
        ):
            | undefined
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >;
        pivotToBoundsCenter(setDirty?: boolean): () => void;
        pivotToPoint(point: Vector3, setDirty?: boolean): this;
        refreshUi(): void;
        remove(
            ...object: IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >[],
        ): this;
        setDirty(e?: ISceneSetDirtyOptions): void;
        toJSON(): any;
        traverse(callback: (object: IObject3D) => void): void;
        traverseAncestors(callback: (object: IObject3D) => void): void;
        traverseModels(
            callback: (object: IObject3D) => boolean | void,
            options: { visible: boolean; widgets: boolean; [key: string]: any },
        ): void;
        traverseVisible(callback: (object: IObject3D) => void): void;
        updateMorphTargets(): void;
        updateShaderProperties(
            material: {
                defines: Record<string, string | number | undefined>;
                uniforms: { [name: string]: IUniform<any> };
            },
        ): this;
    }

    Type Parameters

    Hierarchy (View Summary)

    Implemented by

    Index

    Properties

    __exportState? __meshSetup? __objectSetup? __objExtUiConfigs? _currentGeometry? _currentMaterial? _customDepthMaterial? _customGBufferMaterial? _customNormalMaterial? _loadingPromise? _onGeometryUpdate? _rootPathRefreshed? _rootPathRefreshing? _sChildren? acceptChildEvents? activeCamera assetType? autoUpgradeChildren? background backgroundColor backgroundIntensity boundingBox? boundingSphere? children currentMaterial? customGBufferMaterial? customNormalMaterial? defaultCamera environment envMapIntensity fixedEnvMapDirection forcedOverrideGeometry? forcedOverrideMaterial? geometry? isAmbientLight? isCamera? isDirectionalLight? isHemisphereLight? isInstancedMesh? isLight? isLine? isLine2? isLineSegments? isLineSegments2? isMesh? isMeshLine? isPointLight? isPoints? isRectAreaLight? isScene isSkinnedMesh? isSpotLight? isWidget? isWireframe? mainCamera material? materials? modelRoot morphTargetDictionary? morphTargetInfluences? objectExtensions? objectProcessor? parent parentRoot? renderCamera type uiConfig? userData visible

    Methods

    add addObject autoCenter? autoScale? clone computeBoundingBox? computeBoundingSphere? computeLineDistances? copy dispose? findObjectsByName getBounds getObjectById getObjectByName getObjectByProperty pivotToBoundsCenter? pivotToPoint? refreshUi? remove setDirty toJSON traverse traverseAncestors traverseModels? traverseVisible updateMorphTargets? updateShaderProperties

    Properties

    Optional__exportState

    __exportState?: {
        fomMap: Map<
            IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >,
            undefined | Material<MaterialEventMap> | Material<MaterialEventMap>[],
        >;
        geomMap: Map<
            IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >,
            undefined | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
        >;
        matCloneMap: Map<
            IMaterial<IMaterialEventMap>,
            IMaterial<IMaterialEventMap>,
        >;
        meshLines: Map<
            IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >,
            IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
        >;
        objectList: Set<
            IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >,
        >;
        savedTextures: Map<
            | IMaterial<IMaterialEventMap>
            | IObject3D<
                IObject3DEventMap,
                undefined
                | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
                undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
            >,
            Record<string, ITexture<TextureEventMap>>,
        >;
    }

    Optional Internal__meshSetup

    __meshSetup?: boolean

    If a mesh has been converted to IObject3D using upgradeObject3D, this flag is set to true.

    Optional Internal__objectSetup

    __objectSetup?: boolean

    If an object has been converted to IObject3D using upgradeObject3D, this flag is set to true.

    Optional__objExtUiConfigs

    __objExtUiConfigs?: Record<
        string,
        | undefined
        | (
            | UiObjectConfig<any, string, any>
            | Fof<ValOrArrOp<UiObjectConfig<any, string, any>>>
        )[],
    >

    Optional_currentGeometry

    _currentGeometry?:
        | null
        | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>

    Optional Internal_currentMaterial

    _currentMaterial?:
        | null
        | IMaterial<IMaterialEventMap>
        | IMaterial<IMaterialEventMap>[]

    Optional Internal_customDepthMaterial

    _customDepthMaterial?: Material<MaterialEventMap>
    • store for the actual customDepthMaterial

    Optional Internal_customGBufferMaterial

    _customGBufferMaterial?: Material<MaterialEventMap>
    • store for the actual customGBufferMaterial

    Optional Internal_customNormalMaterial

    _customNormalMaterial?: Material<MaterialEventMap>
    • store for the actual customNormalMaterial

    Optional_loadingPromise

    _loadingPromise?: Promise<any>

    A promise can be set by the object to indicate that the object is loading. This can be used by the scene, viewer, plugins to defer actions until the object is loaded.

    Optional Internal_onGeometryUpdate

    _onGeometryUpdate?: EventListener2<
        "geometryUpdate",
        BufferGeometryEventMap,
        IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
    >
    • for embedded objects

    Optional Internal_rootPathRefreshed

    _rootPathRefreshed?: boolean
    • for embedded objects

    Optional Internal_rootPathRefreshing

    _rootPathRefreshing?: boolean
    • when embedded objects are loading

    Optional Internal_sChildren

    _sChildren?: Object3D<Object3DEventMap>[]

    If this is present, only the objects in this array will be saved in the glb/gltf files, and the object.children array will be ignored. The other properties are expected to be loaded/filled at runtime by default values or from an external asset loaded from IImportResultUserData.rootPath.

    • for embedded objects.
    acceptChildEvents?: boolean

    Set to false to disable propagation of any events from its children.

    activeCamera: ICamera

    renamed to mainCamera

    assetType?: "model" | "light" | "camera" | "widget"
    autoUpgradeChildren?: boolean

    Set to false to disable automatic call of upgradeObject3D when a child is added.

    background: null | ITexture<TextureEventMap> | Color | "environment"

    Defines the background of the scene.

    Valid inputs are:

    • A THREE.Color | Color for defining a uniform colored background.
    • A THREE.Texture | Texture for defining a (flat) textured background.
    • Texture cubes (THREE.CubeTexture | CubeTexture) or equirectangular textures for defining a skybox.
    • A value 'environment' will force the background to be same as environment.

    null

    backgroundColor: null | Color

    Custom property for background tint, or just background color rendered in the shader

    backgroundIntensity: number

    Attenuates the color of the background. Only applies to background textures.

    1

    Expects a Float

    boundingBox?: null | Box3

    For InstancedMesh, SkinnedMesh etc

    boundingSphere?: null | Sphere

    For InstancedMesh, SkinnedMesh etc

    children: IObject3D<
        IObject3DEventMap,
        undefined
        | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
        undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
    >[]

    Array with object's children.

    THREE.Object3DGroup | Group for info on manually grouping objects.

    []

    currentMaterial?:
        | null
        | IMaterial<IMaterialEventMap>
        | IMaterial<IMaterialEventMap>[]
    customGBufferMaterial?: Material<MaterialEventMap>

    Required for plugins like GBufferPlugin

    customNormalMaterial?: Material<MaterialEventMap>

    Required for plugins like NormalBufferPlugin

    defaultCamera: ICamera
    environment: null | ITexture<TextureEventMap>

    Sets the environment map for all physical materials in the scene. However, it's not possible to overwrite an existing texture assigned to THREE.MeshStandardMaterial.envMap | MeshStandardMaterial.envMap.

    null

    envMapIntensity: number
    fixedEnvMapDirection: boolean
    forcedOverrideGeometry?: IGeometry<
        NormalBufferAttributes,
        BufferGeometryEventMap,
    >

    If this is set, it will be returned when accessing geometry property.

    forcedOverrideMaterial?:
        | Material<MaterialEventMap>
        | Material<MaterialEventMap>[]

    If this is set, it will be returned when accessing material property. see GBufferRenderPass for sample usage

    geometry?: IGeometry<NormalBufferAttributes, BufferGeometryEventMap>
    isAmbientLight?: boolean
    isCamera?: boolean
    isDirectionalLight?: boolean
    isHemisphereLight?: boolean
    isInstancedMesh?: boolean
    isLight?: boolean
    isLine?: boolean
    isLine2?: boolean
    isLineSegments?: boolean
    isLineSegments2?: boolean
    isMesh?: boolean
    isMeshLine?: boolean
    isPointLight?: boolean
    isPoints?: boolean
    isRectAreaLight?: boolean
    isScene: true

    Read-only flag to check if a given object is of type Scene.

    This is a constant value

    true

    isSkinnedMesh?: boolean
    isSpotLight?: boolean
    isWidget?: boolean
    isWireframe?: boolean
    mainCamera: ICamera

    Main camera that the user controls

    material?: IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[]
    materials?: IMaterial<IMaterialEventMap>[]

    Same as material but always returns an array. To set, just set material property

    modelRoot: IObject3D
    morphTargetDictionary?: Record<string, number>
    morphTargetInfluences?: number[]
    objectExtensions?: IObjectExtension[]
    objectProcessor?: IObjectProcessor
    parent:
        | null
        | IObject3D<
            IObject3DEventMap,
            undefined
            | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
        >

    Object's parent in the scene graph.

    An object can have at most one parent.

    null

    parentRoot?:
        | null
        | IObject3D<
            IObject3DEventMap,
            undefined
            | IGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
            undefined | IMaterial<IMaterialEventMap> | IMaterial<IMaterialEventMap>[],
        >

    Parent/Ancestor of this object to bubble events to. This is set internally by setupObject3D.

    renderCamera: ICamera

    Camera that in currently being rendered.

    type: "Scene"

    Scene

    uiConfig?: UiObjectConfig<any, string, any>
    userData: IObject3DUserData

    An object that can be used to store custom data about the Object3D.

    It should not hold references to functions as these will not be cloned.

    {}

    visible: boolean

    Object gets rendered if true.

    true

    Methods

    • Moves the bounding box center of the object to the center of the world

      Parameters

      • OptionalsetDirty: boolean

        calls setDirty

      • Optionalundo: boolean

        undo any previous autoCenter operation

      Returns void

      true

    • Scales the object to fit the given radius.

      Parameters

      • OptionalautoScaleRadius: number

        optional (taken from userData.autoScaleRadius by default)

      • OptionalisCentered: boolean

        optional (taken from userData.isCentered by default)

      • OptionalsetDirty: boolean

        true by default

      • Optionalundo: boolean

        undo any previous autoScale operation

      Returns void

    • Returns a clone of this object and optionally all descendants.

      Parameters

      • Optionalrecursive: boolean

        If true, descendants of the object are also cloned. Default true

      Returns this

    • For InstancedMesh, SkinnedMesh etc Computes bounding box, updating .boundingBox attribute.

      Returns void

      Bounding boxes aren't computed by default. They need to be explicitly computed, otherwise they are null.

    • Parameters

      • Optionalprecise: boolean
      • OptionalignoreInvisible: boolean

      Returns Box3B

    • Moves the object pivot to the center of the bounding box.

      The object will rotate around the new pivot.

      Parameters

      • OptionalsetDirty: boolean

        calls setDirty

      Returns () => void

      undo function

      true

    • Moves the object pivot to the given point

      The object will rotate around the new pivot.

      Parameters

      • point: Vector3

        point to move the pivot to

      • OptionalsetDirty: boolean

        calls setDirty

      Returns this

      undo function

      true

    • Executes the callback on this object and all descendants.

      Parameters

      • callback: (object: IObject3D) => void

        A function with as first argument an Object3D object.

      Returns void

      Note: Modifying the scene graph inside the callback is discouraged.

    • Traverse only upgraded objects with extra options

      Parameters

      • callback: (object: IObject3D) => boolean | void
      • options: { visible: boolean; widgets: boolean; [key: string]: any }

        visible: traverse only visible objects, widgets: traverse widgets also

      Returns void

    • Like traverse, but the callback will only be executed for visible objects

      Parameters

      • callback: (object: IObject3D) => void

        A function with as first argument an Object3D object.

      Returns void

      Descendants of invisible objects are not traversed. Note: Modifying the scene graph inside the callback is discouraged.

    Settings

    Member Visibility

    On This Page

    Properties
    __exportState__meshSetup__objectSetup__objExtUiConfigs_currentGeometry_currentMaterial_customDepthMaterial_customGBufferMaterial_customNormalMaterial_loadingPromise_onGeometryUpdate_rootPathRefreshed_rootPathRefreshing_sChildrenacceptChildEventsactiveCameraassetTypeautoUpgradeChildrenbackgroundbackgroundColorbackgroundIntensityboundingBoxboundingSpherechildrencurrentMaterialcustomGBufferMaterialcustomNormalMaterialdefaultCameraenvironmentenvMapIntensityfixedEnvMapDirectionforcedOverrideGeometryforcedOverrideMaterialgeometryisAmbientLightisCameraisDirectionalLightisHemisphereLightisInstancedMeshisLightisLineisLine2isLineSegmentsisLineSegments2isMeshisMeshLineisPointLightisPointsisRectAreaLightisSceneisSkinnedMeshisSpotLightisWidgetisWireframemainCameramaterialmaterialsmodelRootmorphTargetDictionarymorphTargetInfluencesobjectExtensionsobjectProcessorparentparentRootrenderCameratypeuiConfiguserDatavisible
    Methods