Skip to content

Documentation / scene / ShadowRegion

Class: ShadowRegion ​

Defined in: libs/scene/src/shadow/shadow_region.ts:20

Maintains the world-space region used by directional light shadow maps.

Extends ​

  • Disposable

Constructors ​

Constructor ​

new ShadowRegion(region?): ShadowRegion

Defined in: libs/scene/src/shadow/shadow_region.ts:39

Creates a shadow region.

Parameters ​

region? ​

AABB

Optional manual world-space AABB used to initialize the region.

Returns ​

ShadowRegion

Overrides ​

Disposable.constructor

Accessors ​

disposed ​

Get Signature ​

get disposed(): boolean

Defined in: libs/base/dist/index.d.ts:6107

Returns ​

boolean

Inherited from ​

Disposable.disposed


region ​

Get Signature ​

get region(): AABB

Defined in: libs/scene/src/shadow/shadow_region.ts:55

Final world-space shadow region.

Returns ​

AABB

The union of the manual, static caster, and dynamic caster regions, or null if no valid region exists.


manualRegion ​

Get Signature ​

get manualRegion(): AABB

Defined in: libs/scene/src/shadow/shadow_region.ts:64

Region contributed by manually assigned AABB.

Returns ​

AABB

The manually assigned region, or null if no manual region is set.


staticRegion ​

Get Signature ​

get staticRegion(): AABB

Defined in: libs/scene/src/shadow/shadow_region.ts:73

Region contributed by static shadow casters.

Returns ​

AABB

The combined static caster region, or null if no valid static caster region exists.


dynamicRegion ​

Get Signature ​

get dynamicRegion(): AABB

Defined in: libs/scene/src/shadow/shadow_region.ts:82

Region contributed by dynamic shadow casters.

Returns ​

AABB

The combined dynamic caster region, or null if no valid dynamic caster region exists.

Methods ​

on() ​

on<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:630

IEventTarget.on

Type Parameters ​

K ​

K extends "dispose"

Parameters ​

type ​

K

listener ​

EventListener<{ dispose: []; }, K>

context? ​

unknown

Returns ​

void

Inherited from ​

Disposable.on


once() ​

once<K>(type, listener, context?): void

Defined in: libs/base/dist/index.d.ts:634

IEventTarget.once

Type Parameters ​

K ​

K extends "dispose"

Parameters ​

type ​

K

listener ​

EventListener<{ dispose: []; }, K>

context? ​

unknown

Returns ​

void

Inherited from ​

Disposable.once


off() ​

off<K>(type, listener?, context?): void

Defined in: libs/base/dist/index.d.ts:638

IEventTarget.off

Type Parameters ​

K ​

K extends "dispose"

Parameters ​

type ​

K

listener? ​

EventListener<{ dispose: []; }>

context? ​

unknown

Returns ​

void

Inherited from ​

Disposable.off


dispatchEvent() ​

dispatchEvent<K>(type, ...args): void

Defined in: libs/base/dist/index.d.ts:642

IEventTarget.dispatchEvent

Type Parameters ​

K ​

K extends "dispose"

Parameters ​

type ​

K

args ​

...object[K]

Returns ​

void

Inherited from ​

Disposable.dispatchEvent


dispose() ​

dispose(): void

Defined in: libs/base/dist/index.d.ts:6108

Returns ​

void

Inherited from ​

Disposable.dispose


setRegion() ​

setRegion(region): void

Defined in: libs/scene/src/shadow/shadow_region.ts:91

Assigns a manual world-space AABB to the region.

Parameters ​

region ​

AABB

The manual world-space AABB to use, or null to clear the manual region.

Returns ​

void


addStaticCaster() ​

addStaticCaster(caster): this

Defined in: libs/scene/src/shadow/shadow_region.ts:102

Adds a static shadow caster using a snapshot of its current world-space AABB.

Parameters ​

caster ​

SceneNode

The mesh or clipmap terrain node to include as a static caster.

Returns ​

this

this for chaining.


addDynamicCaster() ​

addDynamicCaster(caster): this

Defined in: libs/scene/src/shadow/shadow_region.ts:125

Adds a dynamic shadow caster and tracks its bounding volume changes.

Parameters ​

caster ​

SceneNode

The mesh or clipmap terrain node to include as a dynamic caster.

Returns ​

this

this for chaining.


removeCaster() ​

removeCaster(caster): this

Defined in: libs/scene/src/shadow/shadow_region.ts:151

Removes a previously added shadow caster.

Parameters ​

caster ​

SceneNode

The caster node to remove from the static or dynamic caster list.

Returns ​

this

this for chaining.


clearCasters() ​

clearCasters(): void

Defined in: libs/scene/src/shadow/shadow_region.ts:185

Removes all shadow casters while keeping the manual region.

Returns ​

void


clear() ​

clear(): this

Defined in: libs/scene/src/shadow/shadow_region.ts:205

Clears the manual region and all shadow casters.

Returns ​

this

this for chaining.


onDispose() ​

protected onDispose(): void

Defined in: libs/scene/src/shadow/shadow_region.ts:212

Disposable.onDispose

Returns ​

void

Overrides ​

Disposable.onDispose

Released under the MIT License.