lights: Fix directional lights and add debug cvars to add a fake sun

Directional lights should affect all light tiles, so set a really high
radius to ensure they are included in all light tiles.

Also add some cvars to allow adding a debug sun.

Author: DolceTriade

src/engine/renderer/glsl_source/lighttile_fp.glsl

@@ -130,6 +130,7 @@ void main() {
 	or use compute shaders with atomics so we can have a variable amount of lights for each tile. */
 	for( uint i = uint( u_lightLayer ); i < uint( u_numLights ); i += uint( NUM_LIGHT_LAYERS ) ) {
 		Light l = GetLight( i );
+
 		vec3 center = ( u_ModelMatrix * vec4( l.center, 1.0 ) ).xyz;
 		float radius = max( 2.0 * l.radius, 2.0 * 32.0 ); // Avoid artifacts with weak light sources
 

src/engine/renderer/tr_scene.cpp

@@ -540,6 +540,38 @@ static void AddDebugProjectedLight()
 	light->origin[ 2 ] = r_debugProjLightOriginZ.Get();
 }
 
+// Debug sun light (directional) injection
+Cvar::Cvar<bool> r_debugSun( "r_debugSun", "inject a directional sun light each frame", Cvar::CHEAT, false );
+Cvar::Range<Cvar::Cvar<float>> r_debugSunYaw( "r_debugSunYaw", "debug sun yaw in degrees", Cvar::NONE, 45.0f, -360.0f, 360.0f );
+Cvar::Range<Cvar::Cvar<float>> r_debugSunPitch( "r_debugSunPitch", "debug sun pitch in degrees", Cvar::NONE, -60.0f, -89.0f, 89.0f );
+Cvar::Range<Cvar::Cvar<float>> r_debugSunR( "r_debugSunR", "debug sun color R", Cvar::NONE, 1.0f, 0.0f, 10.0f );
+Cvar::Range<Cvar::Cvar<float>> r_debugSunG( "r_debugSunG", "debug sun color G", Cvar::NONE, 1.0f, 0.0f, 10.0f );
+Cvar::Range<Cvar::Cvar<float>> r_debugSunB( "r_debugSunB", "debug sun color B", Cvar::NONE, 1.0f, 0.0f, 10.0f );
+
+static void AddDebugSunLight()
+{
+	if ( r_numLights >= MAX_REF_LIGHTS )
+	{
+		return;
+	}
+	refLight_t *sun = &backEndData[ tr.smpFrame ]->lights[ r_numLights++ ];
+	*sun = {};
+	sun->rlType = refLightType_t::RL_DIRECTIONAL;
+	// Compute direction from yaw/pitch cvars (in degrees)
+	float yaw = DEG2RAD( r_debugSunYaw.Get() );
+	float pitch = DEG2RAD( r_debugSunPitch.Get() );
+	// Right-handed: X forward, Y left, Z up. Direction vector components:
+	sun->projTarget[ 0 ] = cosf( pitch ) * cosf( yaw );
+	sun->projTarget[ 1 ] = cosf( pitch ) * sinf( yaw );
+	sun->projTarget[ 2 ] = sinf( pitch );
+	VectorNormalize( sun->projTarget );
+	sun->color[ 0 ] = r_debugSunR.Get();
+	sun->color[ 1 ] = r_debugSunG.Get();
+	sun->color[ 2 ] = r_debugSunB.Get();
+	// Max radius to ensure it is always included.
+	sun->radius = std::numeric_limits<float>::max();
+}
+
 /*
 @@@@@@@@@@@@@@@@@@@@@
 RE_RenderScene
@@ -619,6 +651,10 @@ void RE_RenderScene( const refdef_t *fd )
 	{
 		AddDebugProjectedLight();
 	}
+	if ( r_debugSun.Get() )
+	{
+		AddDebugSunLight();
+	}
 
 	// derived info
 	if ( r_forceRendererTime.Get() >= 0 ) {