simvx.graphics.renderer.shadow_pass

Cascaded Shadow Map (CSM) rendering pass.

Module Contents

Classes

ShadowPass

Renders depth from directional light’s POV into a cascaded shadow map atlas.

Data

__all__
log
MAX_CASCADE_COUNT
DEFAULT_CASCADE_COUNT
SHADOW_MAP_SIZE
DEPTH_FORMAT
CASCADE_COUNT

API

simvx.graphics.renderer.shadow_pass.__all__

[‘ShadowPass’]

simvx.graphics.renderer.shadow_pass.log

‘getLogger(…)’

simvx.graphics.renderer.shadow_pass.MAX_CASCADE_COUNT

None

simvx.graphics.renderer.shadow_pass.DEFAULT_CASCADE_COUNT

None

simvx.graphics.renderer.shadow_pass.SHADOW_MAP_SIZE

2048

simvx.graphics.renderer.shadow_pass.DEPTH_FORMAT

None

simvx.graphics.renderer.shadow_pass.CASCADE_COUNT

None

class simvx.graphics.renderer.shadow_pass.ShadowPass(engine: Any)

Renders depth from directional light’s POV into a cascaded shadow map atlas.

Atlas layout: MAX_CASCADE_COUNT images side-by-side horizontally. Total size: SHADOW_MAP_SIZE * MAX_CASCADE_COUNT × SHADOW_MAP_SIZE. The fragment shader’s loop iterates active_cascade_count slices so 1–4 cascades can be selected at runtime via WorldEnvironment.shadow_cascade_count without recompiling shaders.

Initialization

setup(ssbo_layout: Any) → None

Initialize shadow map resources.

property shadow_texture_index: int

Bindless index of the shadow map atlas texture.

compute_cascades(view: numpy.ndarray, proj: numpy.ndarray, light_dir: numpy.ndarray, near: float = 0.0, far: float = 0.0) → None

Compute cascade split distances and light-space VP matrices.

Delegates to shadow_math.compute_cascades for self.cascade_count slices and transposes to GLSL column-major for the SSBO upload. Slots beyond self.cascade_count are zeroed so the shader’s active_cascade_count clamp leaves them untouched.

render(cmd: Any, instances: list, ssbo_set: Any, mesh_registry: Any) → None

Record shadow depth rendering commands.

cleanup() → None

Release all GPU resources.