Sets shadow range multiplier for light shadow coverage area.
Takes light (light handle from b3dCreateLight), multiplier (shadow range multiplier, typical 1.0-3.0).
Returns nothing.
3D Graphics
Parameters & Returns
Parameters
lightInt
multiplierDouble
Returns
Void
Quick Summary
Sets shadow range multiplier for light shadow coverage area.
Takes light (light handle from b3dCreateLight), multiplier (shadow range multiplier, typical 1.0-3.0).
Returns nothing.
Technical Exegesis...
Sets shadow range multiplier for light shadow coverage area. Takes light (light handle from b3dCreateLight), multiplier (shadow range scale factor, 1.0 = default, > 1.0 = larger coverage, < 1.0 = smaller coverage, typical 1.0-3.0). Returns nothing. Scales shadow map orthographic projection size for directional lights.
Sets shadow range multiplier for light shadow coverage area. Takes light (light handle from b3dCreateLight), multiplier (shadow range scale factor, 1.0 = default, > 1.0 = larger coverage, < 1.0 = smaller coverage, typical 1.0-3.0). Returns nothing. Scales shadow map orthographic projection size for directional lights.
Shadow coverage: multiplier scales orthographic projection width/height (larger multiplier = shadow map covers wider area, smaller multiplier = shadow map covers tighter area), affects shadow resolution per unit (larger coverage = lower pixels per unit = less detail, tighter coverage = higher pixels per unit = more detail). Typical values: tight (0.5-1.0 for close-up detailed shadows), medium (1.0-1.5 for balanced coverage), wide (2.0-3.0+ for large outdoor scenes).
Use cases: (1) Large outdoor (multiplier 2-3 to cover terrain), (2) Indoor (multiplier 0.5-1.0 for detail), (3) Following camera (adjust multiplier based on zoom level). Trade-off: larger multiplier reduces shadow detail (same shadow map resolution spread over larger area), smaller multiplier increases detail but may not cover entire scene.
Related: b3dCreateLight creates light, b3dLightShadowNearFar sets depth range, b3dLightShadowCameraDistance offsets camera position, b3dLightShadowMaxDistance sets maximum distance.
Example
Example.bam
; Standard coverage
sun = b3dCreateLight(1)
b3dLightShadowRangeMultiplier(sun, 1.0)
; Large outdoor scene (wider coverage)
b3dLightShadowRangeMultiplier(sun, 2.5)
; Tight detailed shadows
b3dLightShadowRangeMultiplier(sun, 0.75)