Skip to content

Documentation / @ripl/3d / DirectionalLight

Class: DirectionalLight ​

Defined in: 3d/src/core/lights.ts:202

A light infinitely far away, casting parallel rays in a single direction.

Extends ​

Constructors ​

Constructor ​

new DirectionalLight(options?): DirectionalLight

Defined in: 3d/src/core/lights.ts:227

Parameters ​

ParameterType
options?DirectedLightOptions

Returns ​

DirectionalLight

Overrides ​

Light.constructor

Properties ​

PropertyModifierTypeDescriptionInherited fromDefined in
_colorprotectedstring-Light._color3d/src/core/lights.ts:108
_enabledprotectedboolean-Light._enabled3d/src/core/lights.ts:110
_intensityprotectednumber-Light._intensity3d/src/core/lights.ts:109
typereadonlyLightTypeThe kind of illumination this light contributes.Light.type3d/src/core/lights.ts:106

Accessors ​

color ​

Get Signature ​

get color(): string

Defined in: 3d/src/core/lights.ts:116

The light's colour.

Returns ​

string

Set Signature ​

set color(value): void

Defined in: 3d/src/core/lights.ts:120

Parameters ​
ParameterType
valuestring
Returns ​

void

Inherited from ​

Light.color


direction ​

Get Signature ​

get direction(): Vector3

Defined in: 3d/src/core/lights.ts:208

The direction the light travels in, normalized on assignment.

Returns ​

Vector3

Set Signature ​

set direction(value): void

Defined in: 3d/src/core/lights.ts:212

Parameters ​
ParameterType
valueVector3
Returns ​

void


enabled ​

Get Signature ​

get enabled(): boolean

Defined in: 3d/src/core/lights.ts:136

Whether the light contributes at all.

Returns ​

boolean

Set Signature ​

set enabled(value): void

Defined in: 3d/src/core/lights.ts:140

Parameters ​
ParameterType
valueboolean
Returns ​

void

Inherited from ​

Light.enabled


intensity ​

Get Signature ​

get intensity(): number

Defined in: 3d/src/core/lights.ts:126

How strongly the light contributes.

Returns ​

number

Set Signature ​

set intensity(value): void

Defined in: 3d/src/core/lights.ts:130

Parameters ​
ParameterType
valuenumber
Returns ​

void

Inherited from ​

Light.intensity


space ​

Get Signature ​

get space(): LightSpace

Defined in: 3d/src/core/lights.ts:218

Whether direction is fixed in world space or follows the camera.

Returns ​

LightSpace

Set Signature ​

set space(value): void

Defined in: 3d/src/core/lights.ts:222

Parameters ​
ParameterType
valueLightSpace
Returns ​

void

Methods ​

invalidate() ​

invalidate(): void

Defined in: 3d/src/core/lights.ts:158

Requests a repaint of whatever this light is attached to. Call after mutating derived state.

Returns ​

void

Inherited from ​

Light.invalidate