Skip to main content

Type Alias: ShadowCaster

type ShadowCaster = {
  bias: Float;
  nearDist: Float;
  farDist: Float;
  quality: Int32;
  cascadeSplitLambda: Float;
  cascadeCount: Int8;
  accumulateShadowCascades: boolean;
};

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:892

Enables a light to cast real-time shadows with configurable map resolution, depth range, and (for directional lights) cascades.

Properties​

bias​

bias: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:897

Depth bias applied during shadow tests to reduce self-shadowing (acne). Increase to mitigate artifacts; too high causes peter-panning.

Default Value​

0.004;

nearDist​

nearDist: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:902

Shadow camera near clip distance (meters). Tighten to improve depth precision.

Default Value​

0.1;

farDist​

farDist: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:907

Shadow camera far clip distance (meters). Use the smallest range that contains casters/receivers.

Default Value​

100;

quality​

quality: Int32;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:912

Shadow map resolution (pixels per side). Higher values increase detail at the cost of memory and performance.

Default Value​

1024;

cascadeSplitLambda​

cascadeSplitLambda: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:917

Directional lights only: cascade split distribution for CSM. 0 = uniform (linear) splits; 1 = logarithmic (more resolution near the camera). Values in [0,1] blend between the two.

Default Value​

0.94;

cascadeCount​

cascadeCount: Int8;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:922

Directional lights only: number of cascades for CSM. 0 = static shadow map, 1–4 = increasing cascade count.

Default Value​

4;

accumulateShadowCascades​

accumulateShadowCascades: boolean;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:927

Directional lights only: blend/accumulate all cascades to reduce visible transitions between splits.

Default Value​

true;