Class AmbientLight

Create an ambient light that equally illuminates all objects in the scene.

This light cannot cast shadows.

Example

// assuming 'renderer' is a valid Camera renderer
const ambientLight = new AmbientLight(renderer, {
  color: new Vec3(1),
  intensity: 0.1,
})

Hierarchy (View Summary)

Light
- AmbientLight

Constructors

constructor

new AmbientLight(
renderer: GPUCurtains | CameraRenderer,
parameters?: LightBaseParams,
): AmbientLight
AmbientLight constructor
Parameters
- renderer: GPUCurtains | CameraRenderer
  CameraRenderer or GPUCurtains used to create this AmbientLight.
- parameters: LightBaseParams = ...
  LightBaseParams used to create this AmbientLight.
Returns AmbientLight
Overrides Light.constructor
- Defined in src/core/lights/AmbientLight.ts:26

Properties

type

type: string

Type of the light.

`Readonly`uuid

uuid: string

The universal unique id of this Light

index

index: number

Index of this Light, i.e. the number of time a Light of this type has been created.

renderer

renderer: CameraRenderer

CameraRenderer used by this Light

options

options: LightBaseParams

Options used to create this Light.

color

color: Vec3

Current color of this Light.

rendererBinding

rendererBinding: BufferBinding

CameraRenderer corresponding BufferBinding that holds all the bindings to send to the shaders.

userData

userData: Record<string, unknown>

Empty object to store any additional data or custom properties into your Light.

_onBeforeRenderCallback

_onBeforeRenderCallback: () => void

function assigned to the onBeforeRender callback

Vec3 used by the lookAt method, to determine the orientation of the result. Default to new Vec3(0, 1, 0).

actualPosition

actualPosition: Vec3

Vec3 holding the actual position of this Object3D from its worldMatrix.

children

children: Object3D[]

Children Object3D in the scene graph, used to compute their own worldMatrix.

object3DIndex

object3DIndex: number

Index (order of creation) of this Object3D. Used in the parent / children relation.

matricesNeedUpdate

matricesNeedUpdate: boolean

Whether at least one of this Object3D matrix needs an update.

Accessors

intensity

get intensity(): number
Get this Light intensity.

Returns number
- The Light intensity.
Inherited from Light.intensity
- Defined in src/core/lights/Light.ts:164
set intensity(value: number): void
Set this Light intensity and update the CameraRenderer corresponding BufferBinding.
Parameters
- value: number
  The new Light intensity.
Returns void
Inherited from Light.intensity
- Defined in src/core/lights/Light.ts:172

actualColor

get actualColor(): Vec3
Get the actual Vec3 color used in the shader: convert color to linear space, then multiply by intensity.

Returns Vec3
- Actual Vec3 color used in the shader.
Inherited from Light.actualColor
- Defined in src/core/lights/Light.ts:181

parent

get parent(): Object3D
Get the parent of this Object3D if any

Returns Object3D
Inherited from Light.parent
- Defined in src/core/objects3D/Object3D.ts:101
set parent(value: Object3D): void
Set the parent of this Object3D
Parameters
- value: Object3D
  new parent to set, could be an Object3D or null
Returns void
Inherited from Light.parent
- Defined in src/core/objects3D/Object3D.ts:109

rotation

get rotation(): Vec3
Get our rotation vector

Returns Vec3
Inherited from Light.rotation
- Defined in src/core/objects3D/Object3D.ts:154
set rotation(value: Vec3): void
Set our rotation vector
Parameters
- value: Vec3
  new rotation vector
Returns void
Inherited from Light.rotation
- Defined in src/core/objects3D/Object3D.ts:162

quaternion

get quaternion(): Quat
Get our quaternion

Returns Quat
Inherited from Light.quaternion
- Defined in src/core/objects3D/Object3D.ts:170
set quaternion(value: Quat): void
Set our quaternion
Parameters
- value: Quat
  new quaternion
Returns void
Inherited from Light.quaternion
- Defined in src/core/objects3D/Object3D.ts:178

position

get position(): Vec3
Get our position vector

Returns Vec3
Inherited from Light.position
- Defined in src/core/objects3D/Object3D.ts:185
set position(value: Vec3): void
Set our position vector
Parameters
- value: Vec3
  new position vector
Returns void
Inherited from Light.position
- Defined in src/core/objects3D/Object3D.ts:193

scale

get scale(): Vec3
Get our scale vector

Returns Vec3
Inherited from Light.scale
- Defined in src/core/objects3D/Object3D.ts:200
set scale(value: Vec3): void
Set our scale vector
Parameters
- value: Vec3
  new scale vector
Returns void
Inherited from Light.scale
- Defined in src/core/objects3D/Object3D.ts:208

transformOrigin

get transformOrigin(): Vec3
Get our transform origin vector

Returns Vec3
Inherited from Light.transformOrigin
- Defined in src/core/objects3D/Object3D.ts:217
set transformOrigin(value: Vec3): void
Set our transform origin vector
Parameters
- value: Vec3
  new transform origin vector
Returns void
Inherited from Light.transformOrigin
- Defined in src/core/objects3D/Object3D.ts:225

modelMatrix

get modelMatrix(): Mat4
Get our model matrix

Returns Mat4
Inherited from Light.modelMatrix
- Defined in src/core/objects3D/Object3D.ts:281
set modelMatrix(value: Mat4): void
Set our model matrix
Parameters
- value: Mat4
  new model matrix
Returns void
Inherited from Light.modelMatrix
- Defined in src/core/objects3D/Object3D.ts:289

worldMatrix

get worldMatrix(): Mat4
Get our world matrix

Returns Mat4
Inherited from Light.worldMatrix
- Defined in src/core/objects3D/Object3D.ts:305
set worldMatrix(value: Mat4): void
Set our world matrix
Parameters
- value: Mat4
  new world matrix
Returns void
Inherited from Light.worldMatrix
- Defined in src/core/objects3D/Object3D.ts:313

Methods

setRenderer

setRenderer(renderer: GPUCurtains | CameraRenderer): void
Set or reset this light CameraRenderer.
Parameters
- renderer: GPUCurtains | CameraRenderer
  New CameraRenderer or GPUCurtains instance to use.
Returns void
Inherited from Light.setRenderer
- Defined in src/core/lights/Light.ts:109

setRendererBinding

setRendererBinding(): void
Set or reset this Light CameraRenderer corresponding BufferBinding.

Returns void
Inherited from Light.setRendererBinding
- Defined in src/core/lights/Light.ts:145

reset

reset(resetShadow?: boolean): void
Resend all properties to the CameraRenderer corresponding BufferBinding. Called when the maximum number of corresponding Light has been overflowed or when updating the Light renderer.
Parameters
- resetShadow: boolean = true
  Whether to reset the Light shadow if any.
Returns void
Inherited from Light.reset
- Defined in src/core/lights/Light.ts:155

onPropertyChanged

onPropertyChanged(propertyKey: string, value: number | Vec3): void
Update the CameraRenderer corresponding BufferBinding input value and tell the renderer camera, lights and shadows bind group to update.
Parameters
- propertyKey: string
  name of the property to update.
- value: number | Vec3
  new value of the property.
Returns void
Inherited from Light.onPropertyChanged
- Defined in src/core/lights/Light.ts:190

onMaxLightOverflow

onMaxLightOverflow(lightsType: LightsType): void
Tell the renderer that the maximum number for this type of light has been overflown.
Parameters
- lightsType: LightsType
  type of light.
Returns void
Inherited from Light.onMaxLightOverflow
- Defined in src/core/lights/Light.ts:209

onBeforeRenderScene

onBeforeRenderScene(): void
Called by the Scene before updating the matrix stack.

Returns void
Inherited from Light.onBeforeRenderScene
- Defined in src/core/lights/Light.ts:231

onBeforeRender

onBeforeRender(callback: () => void): this
Callback to execute before updating the Scene matrix stack. This means it is called early and allows to update transformations values before actually setting the Light matrices. The callback won't be called if the renderer is not ready.
Parameters
- callback: () => void
  callback to run just before updating the Scene matrix stack.
Returns this
- our Light
Inherited from Light.onBeforeRender
- Defined in src/core/lights/Light.ts:240

remove

remove(): void
Remove this Light from the renderer and destroy it.

Returns void
Inherited from Light.remove
- Defined in src/core/lights/Light.ts:251

destroy

destroy(): void
Destroy this Light.

Returns void
Inherited from Light.destroy
- Defined in src/core/lights/Light.ts:259

setTransforms

setTransforms(): void
Set our transforms properties and vectors onChange callbacks

Returns void
Inherited from Light.setTransforms
- Defined in src/core/objects3D/Object3D.ts:132

setMatrices

setMatrices(): void
Set our model matrix and world matrix

Returns void
Inherited from Light.setMatrices
- Defined in src/core/objects3D/Object3D.ts:263

shouldUpdateModelMatrix

shouldUpdateModelMatrix(): void
Set our model matrix shouldUpdate flag to true (tell it to update)

Returns void
Inherited from Light.shouldUpdateModelMatrix
- Defined in src/core/objects3D/Object3D.ts:297

shouldUpdateWorldMatrix

shouldUpdateWorldMatrix(): void
Set our world matrix shouldUpdate flag to true (tell it to update)

Returns void
Inherited from Light.shouldUpdateWorldMatrix
- Defined in src/core/objects3D/Object3D.ts:321

lookAt

lookAt(target?: Vec3): void
Rotate this Object3D so it looks at the target.
Parameters
- target: Vec3 = ...
  Vec3 to look at. Default to new Vec3().
Returns void
Inherited from Light.lookAt
- Defined in src/core/objects3D/Object3D.ts:329

applyLookAt

applyLookAt(target: Vec3, position: Vec3): void
Apply a look at rotation based on a target, a position and our up vectors.
Parameters
- target: Vec3
  Vec3 target to look at.
- position: Vec3
  Vec3 position from which to look at.
Returns void
Inherited from Light.applyLookAt
- Defined in src/core/objects3D/Object3D.ts:347

updateModelMatrix

updateModelMatrix(): void
Update our model matrix

Returns void
Inherited from Light.updateModelMatrix
- Defined in src/core/objects3D/Object3D.ts:356

updateWorldMatrix

updateWorldMatrix(updateParents?: boolean, updateChildren?: boolean): void
Update our model matrix.
Parameters
- updateParents: boolean = false
  Whether to update the parent worldMatrix beforehand. Default to false.
- updateChildren: boolean = true
  Whether to update the children worldMatrix afterward. Default to true.
Returns void
Inherited from Light.updateWorldMatrix
- Defined in src/core/objects3D/Object3D.ts:374

shouldUpdateMatrices

shouldUpdateMatrices(): void
Check whether at least one of the matrix should be updated

Returns void
Inherited from Light.shouldUpdateMatrices
- Defined in src/core/objects3D/Object3D.ts:398

updateMatrixStack

updateMatrixStack(): void
Check at each render whether we should update our matrices, and update them if needed

Returns void
Inherited from Light.updateMatrixStack
- Defined in src/core/objects3D/Object3D.ts:405

Class AmbientLight

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns AmbientLight

Properties

type

Readonlyuuid

index

renderer

options

color

rendererBinding

userData

_onBeforeRenderCallback

transforms

matrices

up

actualPosition

children

object3DIndex

matricesNeedUpdate

Accessors

intensity

Returns number

Parameters

Returns void

actualColor

Returns Vec3

parent

Returns Object3D

Parameters

Returns void

rotation

Returns Vec3

Parameters

Returns void

quaternion

Returns Quat

Parameters

Returns void

position

Returns Vec3

Parameters

Returns void

scale

Returns Vec3

Parameters

Returns void

transformOrigin

Returns Vec3

Parameters

Returns void

modelMatrix

Returns Mat4

Parameters

Returns void

worldMatrix

Returns Mat4

Parameters

Returns void

Methods

setRenderer

Parameters

Returns void

setRendererBinding

Returns void

reset

Parameters

Returns void

onPropertyChanged

Parameters

Returns void

`Readonly`uuid