API
Babylon Lite API|
CsmDirectionalShadowGeneratorConfig

Interface CsmDirectionalShadowGeneratorConfig

Configuration for a directional-light cascaded shadow generator.

interface CsmDirectionalShadowGeneratorConfig {
    bias?: number;
    cascadeBlendPercentage?: number;
    darkness?: number;
    forceRefreshEveryFrame?: boolean;
    frustumEdgeFalloff?: number;
    lambda?: number;
    mapSize?: number;
    numCascades?: number;
    shadowMaxZ?: number;
    stabilizeCascades?: boolean;
    worldSpaceBias?: number;
}
Index
bias? cascadeBlendPercentage? darkness? forceRefreshEveryFrame? frustumEdgeFalloff? lambda? mapSize? numCascades? shadowMaxZ? stabilizeCascades? worldSpaceBias?
bias?: number

Depth bias added during shadow-map generation. Default 0.00005.

cascadeBlendPercentage?: number

Fraction of a cascade used to cross-fade into the next one. Default 0.1. Set 0 to disable blending.

darkness?: number

Shadow darkness (0 = black shadow, 1 = no shadow). Default 0.

forceRefreshEveryFrame?: boolean

Regenerate every cascade every frame even when nothing moved. Default false.

frustumEdgeFalloff?: number

Soft fade-out at the edge of each cascade frustum, 0..1. Default 0.

lambda?: number

Split blend between logarithmic and uniform partitioning, 0..1. Default 0.5.

mapSize?: number

Shadow map resolution per cascade (square). Default 1024.

numCascades?: number

Number of cascades. Default 4 (max 4).

shadowMaxZ?: number

Maximum shadow distance in world units. Default = camera far plane.

stabilizeCascades?: boolean

Use a stable bounding-sphere fit (no shimmering) instead of a tight AABB fit. Default false.

worldSpaceBias?: number

Caster depth offset in world units. Overrides bias when supplied; non-positive or non-finite values disable bias.