b3dLightSpotAngle

Sets spotlight cone angle (spot lights only, stored as-is, interpretation shader-dependent). Takes light (light entity handle), angleInCosine (angle value, parameter name suggests cosine but stored directly). Returns nothing. Validates entity is ENTITY_LIGHT type, sets light->spotAngle=(float)angleInCosine. Controls cone width for LIGHT_SPOT (type=2) lights.

This function sets spot cone angle. Angle parameter: parameter named angleInCosine but value stored directly as-is (verify shader interpretation: may be degrees, cosine of half-angle, or full cone angle), default is 120 (suggests degrees for wide cone). Spot light cone: LIGHT_SPOT emits light in cone shape from position in forward direction (+Z local), surfaces inside cone illuminated, surfaces outside cone dark, angle controls cone width (wider angle = broader coverage, narrower angle = focused beam). Light types: only affects LIGHT_SPOT (type=2), LIGHT_POINT (type=0) and LIGHT_DIRECTIONAL (type=1) unaffected (omnidirectional and infinite respectively). Use cases: (1) Flashlights (30-45 degree cone for focused beam), (2) Headlights (60-90 degree cone for wide illumination), (3) Stage lights (15-30 degree cone for spotlights), (4) Searchlights (10-20 degree cone for narrow beam), (5) Ambient spots (120+ degree cone for soft area light). Common patterns: flashlight b3dLightSpotAngle(light, 30), headlight b3dLightSpotAngle(light, 75), spotlight b3dLightSpotAngle(light, 20), wide spot b3dLightSpotAngle(light, 120). Typical usage: set angle during light creation for fixed cone, animate angle for dynamic effects (narrowing/widening beam). Angle interpretation: if parameter is degrees then 0-180 range (0=narrow beam, 180=hemisphere), if cosine of half-angle then 0.0-1.0 range (1.0=narrow, 0.0=90 degrees, -1.0=hemisphere), verify with testing (default 120 suggests degrees). Cone shape: typically soft-edged (smooth falloff from center to edge), inner cone at full brightness, outer cone fades to zero, angle controls outer cone limit. Default angle: lights default to 120 degrees (very wide cone) if not set. Performance: narrower angles = better performance (fewer pixels affected), wider angles = more coverage but slower. Validation: prints error if invalid light handle or non-light entity. Related: b3dCreateLight creates spot light (type=2), b3dRotateEntity orients spotlight direction, b3dLightRange sets attenuation distance, b3dLightIntensity sets brightness.