Interface ICamera<E, ET>

Index

Properties

`Optional` _currentGeometry

_currentGeometry?: null | IGeometry<NormalBufferAttributes>

`Optional` _currentMaterial

_currentMaterial?: null | IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes> | IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>[]

`Optional` _onGeometryUpdate

_onGeometryUpdate?: ((e) => void)

Type declaration

- (e): void
- Parameters
  - e: IGeometryEvent<"geometryUpdate">
  Returns void

aspect

aspect: number

Camera frustum aspect ratio, window width divided by window height. It can be managed internally if autoAspect is true.

Default

assetType

assetType: "camera"

autoAspect

autoAspect: boolean

Automatically manage aspect ratio based on window/canvas size.

autoNearFar

autoNearFar: boolean

cameraObject

cameraObject: ICamera<E, ET>

Deprecated

use this instead

`Readonly` canUserInteract

canUserInteract: boolean

Check whether user can interact with this camera. Interactions can be enabled/disabled in a variety of ways, like interactionsEnabled, controlsMode, isMainCamera property

children

children: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]

`Readonly` controls

controls: undefined | ICameraControls<string>

`Optional` controlsMode

controlsMode?: string

far

far: number

Automatically managed when autoNearFar is true. See also maxFarPlane

`Optional` fov

fov?: number

`Optional` geometry

geometry?: IGeometry<NormalBufferAttributes>

interactionsEnabled

interactionsEnabled: boolean

isActiveCamera

isActiveCamera: boolean

Deprecated

use isMainCamera instead

`Readonly` isCamera

isCamera: true

`Optional` isLight

isLight?: boolean

`Optional` isLine

isLine?: boolean

`Readonly` isMainCamera

isMainCamera: boolean

`Optional` isMesh

isMesh?: boolean

`Optional` `Readonly` isOrthographicCamera

isOrthographicCamera?: boolean

`Optional` `Readonly` isPerspectiveCamera

isPerspectiveCamera?: boolean

`Optional` isScene

isScene?: boolean

`Optional` isWidget

isWidget?: boolean

`Optional` material

material?: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes> | IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>[]

`Optional` `Readonly` materials

materials?: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>[]

Same as material but always returns an array.

maxFarPlane

maxFarPlane: number

minNearPlane

minNearPlane: number

modelObject

modelObject: ICamera<E, ET>

Deprecated

use object directly

`Optional` morphTargetDictionary

morphTargetDictionary?: Record<string, number>

`Optional` morphTargetInfluences

morphTargetInfluences?: number[]

near

near: number

Automatically managed when autoNearFar is true. See also minNearPlane

`Optional` objectProcessor

objectProcessor?: IObjectProcessor

parent

parent: null | IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>

`Optional` parentRoot

parentRoot?: null | IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>

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

position

position: Vector3

Local position of camera.

target

target: Vector3

Target of camera, in world(global) coordinates.

`Optional` uiConfig

uiConfig?: UiObjectConfig<any, string, any>

userData

userData: ICameraUserData

zoom

zoom: number

Methods

activateMain

activateMain(options?, _internal?, _refresh?): void
Parameters
- Optional options: Partial<ICameraEvent>
- Optional _internal: boolean
- Optional _refresh: boolean
Returns void
- Defined in src/core/ICamera.ts:35

add

add(...object): ICamera<E, ET>
Parameters
- Rest ...object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]
Returns ICamera<E, ET>
Overrides IObject3D.add
- Defined in src/core/ICamera.ts:139

`Optional` autoCenter

autoCenter<T>(setDirty?): T
Default
```
true
```
Type Parameters
- T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T>
Parameters
- Optional setDirty: boolean
  
  calls setDirty
Returns T
Inherited from IObject3D.autoCenter
- Defined in src/core/IObject.ts:200

`Optional` autoScale

autoScale<T>(autoScaleRadius?, isCentered?, setDirty?): T
Type Parameters
- T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T>
Parameters
- Optional autoScaleRadius: number
  
  optional (taken from userData.autoScaleRadius by default)
- Optional isCentered: boolean
  
  optional (taken from userData.isCentered by default)
- Optional setDirty: boolean
  
  true by default
Returns T
Inherited from IObject3D.autoScale
- Defined in src/core/IObject.ts:194

clone

clone(recursive?): ICamera<E, ET>
Parameters
- Optional recursive: boolean
Returns ICamera<E, ET>
Overrides IObject3D.clone
- Defined in src/core/ICamera.ts:138

copy

copy(source, recursive?, distanceFromTarget?, worldSpace?, ...args): ICamera<E, ET>
Parameters
- source: ICamera<E, ET>
- Optional recursive: boolean
- Optional distanceFromTarget: number
- Optional worldSpace: boolean
- Rest ...args: any[]
Returns ICamera<E, ET>
Overrides IObject3D.copy
- Defined in src/core/ICamera.ts:137

deactivateMain

deactivateMain(options?, _internal?, _refresh?): void
Parameters
- Optional options: Partial<ICameraEvent>
- Optional _internal: boolean
- Optional _refresh: boolean
Returns void
- Defined in src/core/ICamera.ts:36

dispose

dispose(removeFromParent?): void
Parameters
- Optional removeFromParent: boolean
  
  remove from parent. Default true
Returns void
Inherited from IObject3D.dispose
- Defined in src/core/IObject.ts:218

getObjectById

getObjectById<T>(id): undefined | T
Type Parameters
- T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T> = IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
Parameters
- id: number
Returns undefined | T
Overrides IObject3D.getObjectById
- Defined in src/core/ICamera.ts:134

getObjectByName

getObjectByName<T>(name): undefined | T
Type Parameters
- T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T> = IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
Parameters
- name: string
Returns undefined | T
Overrides IObject3D.getObjectByName
- Defined in src/core/ICamera.ts:135

getObjectByProperty

getObjectByProperty<T>(name, value): undefined | T
Type Parameters
- T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T> = IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
Parameters
- name: string
- value: string
Returns undefined | T
Overrides IObject3D.getObjectByProperty
- Defined in src/core/ICamera.ts:136

getView

getView<T>(worldSpace?, cameraView?): T
Type Parameters
- T extends ICameraView = CameraView
Parameters
- Optional worldSpace: boolean
- Optional cameraView: T
Returns T
- Defined in src/core/ICamera.ts:112

refreshAspect

refreshAspect(setDirty?): void
Parameters
- Optional setDirty: boolean
Returns void
- Defined in src/core/ICamera.ts:46

refreshCameraControls

refreshCameraControls(setDirty?): void
Parameters
- Optional setDirty: boolean
Returns void
- Defined in src/core/ICamera.ts:107

refreshTarget

refreshTarget(): void
Returns void
- Defined in src/core/ICamera.ts:45

refreshUi

refreshUi(): void
Returns void
Inherited from IObject3D.refreshUi
- Defined in src/core/IObject.ts:183

remove

remove(...object): ICamera<E, ET>
Parameters
- Rest ...object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]
Returns ICamera<E, ET>
Overrides IObject3D.remove
- Defined in src/core/ICamera.ts:140

removeControlsCtor

removeControlsCtor(key): void
Parameters
- key: string
Returns void
- Defined in src/core/ICamera.ts:106

setControlsCtor

setControlsCtor(key, ctor, replace?): void
Parameters
- key: string
- ctor: TControlsCtor
- Optional replace: boolean
Returns void
- Defined in src/core/ICamera.ts:105

setDirty

setDirty(options?): void
Dispatches 'objectUpdate' event on object.
Parameters
- Optional options: IObjectSetDirtyOptions
Returns void
Overrides IObject3D.setDirty
- Defined in src/core/ICamera.ts:29

setView

setView(view): void
Parameters
- view: ICameraView
Returns void
- Defined in src/core/ICamera.ts:113

setViewFromCamera

setViewFromCamera(camera, distanceFromTarget?, worldSpace?): void
Set camera view from another camera.
Parameters
- camera: Camera<Event, string> | ICamera<ICameraEvent, ICameraEventTypes>
- Optional distanceFromTarget: number
  
  default = 4
- Optional worldSpace: boolean
  
  default = true
Returns void
- Defined in src/core/ICamera.ts:121

setViewToMain

setViewToMain(eventOptions): void
Dispatches the setView event which triggers the main camera to set its view to this camera's view.
Parameters
- eventOptions: Partial<ICameraEvent>
Returns void
- Defined in src/core/ICamera.ts:127

traverse

traverse(callback): void
Parameters
- callback: ((object) => void)
  - - (object): void
    - Parameters
      
      object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
      
      Returns void
Returns void
Overrides IObject3D.traverse
- Defined in src/core/ICamera.ts:131

traverseAncestors

traverseAncestors(callback): void
Parameters
- callback: ((object) => void)
  - - (object): void
    - Parameters
      
      object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
      
      Returns void
Returns void
Overrides IObject3D.traverseAncestors
- Defined in src/core/ICamera.ts:133

traverseVisible

traverseVisible(callback): void
Parameters
- callback: ((object) => void)
  - - (object): void
    - Parameters
      
      object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>
      
      Returns void
Returns void
Overrides IObject3D.traverseVisible
- Defined in src/core/ICamera.ts:132

`Optional` updateMorphTargets

updateMorphTargets(): void
Returns void
Inherited from IObject3D.updateMorphTargets
- Defined in src/core/IObject.ts:166

updateProjectionMatrix

updateProjectionMatrix(): void
Returns void
- Defined in src/core/ICamera.ts:109

updateShaderProperties

updateShaderProperties(material): ICamera<E, ET>
Parameters
- material: {
      defines: Record<string, undefined | string | number>;
      uniforms: {
          [name: string]: IUniform;
      };
  }
  - defines: Record<string, undefined | string | number>
  - uniforms: {
    [name: string]: IUniform;
    }
    - [name: string]: IUniform
Returns ICamera<E, ET>
Inherited from IShaderPropertiesUpdater.updateShaderProperties
- Defined in src/materials/MaterialExtension.ts:103

Interface ICamera<E, ET>

Type Parameters

E extends ICameraEvent = ICameraEvent

ET extends ICameraEventTypes = ICameraEventTypes

Hierarchy

Implemented by

Index

Properties

Methods

Properties

Optional _currentGeometry

Optional _currentMaterial

Optional _onGeometryUpdate

Type declaration

Parameters

e: IGeometryEvent<"geometryUpdate">

Returns void

aspect

Default

assetType

autoAspect

autoNearFar

cameraObject

Deprecated

Readonly canUserInteract

children

Readonly controls

Optional controlsMode

far

Optional fov

Optional geometry

interactionsEnabled

isActiveCamera

Deprecated

Readonly isCamera

Optional isLight

Optional isLine

Readonly isMainCamera

Optional isMesh

Optional Readonly isOrthographicCamera

Optional Readonly isPerspectiveCamera

Optional isScene

Optional isWidget

Optional material

Optional Readonly materials

maxFarPlane

minNearPlane

modelObject

Deprecated

Optional morphTargetDictionary

Optional morphTargetInfluences

near

Optional objectProcessor

parent

Optional parentRoot

position

target

Optional uiConfig

userData

zoom

Methods

activateMain

Parameters

Optional options: Partial<ICameraEvent>

Optional _internal: boolean

Optional _refresh: boolean

Returns void

add

Parameters

Rest ...object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]

Returns ICamera<E, ET>

Optional autoCenter

Default

Type Parameters

T extends IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes, T>

Parameters

Optional setDirty: boolean

Returns T

Optional autoScale

Type Parameters

`Optional` _currentGeometry

`Optional` _currentMaterial

`Optional` _onGeometryUpdate

`Readonly` canUserInteract

`Readonly` controls

`Optional` controlsMode

`Optional` fov

`Optional` geometry

`Readonly` isCamera

`Optional` isLight

`Optional` isLine

`Readonly` isMainCamera

`Optional` isMesh

`Optional` `Readonly` isOrthographicCamera

`Optional` `Readonly` isPerspectiveCamera

`Optional` isScene

`Optional` isWidget

`Optional` material

`Optional` `Readonly` materials

`Optional` morphTargetDictionary

`Optional` morphTargetInfluences

`Optional` objectProcessor

`Optional` parentRoot

`Optional` uiConfig

`Optional` options: Partial<ICameraEvent>

`Optional` _internal: boolean

`Optional` _refresh: boolean

`Rest` ...object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]

`Optional` autoCenter

`Optional` setDirty: boolean

`Optional` autoScale

`Optional` autoScaleRadius: number

`Optional` isCentered: boolean

`Optional` setDirty: boolean

`Optional` recursive: boolean

`Optional` recursive: boolean

`Optional` distanceFromTarget: number

`Optional` worldSpace: boolean

`Rest` ...args: any[]

`Optional` options: Partial<ICameraEvent>

`Optional` _internal: boolean

`Optional` _refresh: boolean

`Optional` removeFromParent: boolean

`Optional` worldSpace: boolean

`Optional` cameraView: T

`Optional` setDirty: boolean

`Optional` setDirty: boolean

`Rest` ...object: IObject3D<IObject3DEvent<IObject3DEventTypes>, IObject3DEventTypes>[]