lights: Add cvars to add debug projected lights

Makes it easier to test dynamic lights.

Author: DolceTriade

src/engine/renderer/tr_scene.cpp

@@ -346,7 +346,7 @@ static void RE_RenderCubeProbeFace( const refdef_t* originalRefdef ) {
 		Log::Warn( "Cube probe face out of range! (%i/%i)", probeID, tr.cubeProbes.size() );
 		return;
 	}
-	
+
 	refdef_t refdef{};
 	const int faceID = globalID % 6;
 
@@ -467,6 +467,61 @@ static void RE_RenderCubeProbeFace( const refdef_t* originalRefdef ) {
 
 }
 
+// Debug spot light (projected) injection
+static Cvar::Cvar<bool> r_debugProjLight( "r_debugProjLight", "inject a directional sun light each frame", Cvar::NONE, false );
+static Cvar::Range<Cvar::Cvar<float>> r_debugProjLightYaw( "r_debugProjLightYaw", "debug projected yaw in degrees", Cvar::NONE, 45.0f, -360.0f, 360.0f );
+static Cvar::Range<Cvar::Cvar<float>> r_debugProjLightPitch( "r_debugProjLightPitch", "debug projected pitch in degrees", Cvar::NONE, -60.0f, -89.0f, 89.0f );
+static Cvar::Cvar<float> r_debugProjLightIntensity( "r_debugProjLightIntensity", "debug projected intensity (scale)", Cvar::NONE, 1.0f );
+static Cvar::Cvar<float> r_debugProjLightRadius( "r_debugProjLightRadius", "debug projected radius (size)", Cvar::NONE, 100.0f );
+static Cvar::Range<Cvar::Cvar<float>> r_debugProjLightR( "r_debugProjLightR", "debug projected color R", Cvar::NONE, 1.0f, 0.0f, 1.0f );
+static Cvar::Range<Cvar::Cvar<float>> r_debugProjLightG( "r_debugProjLightG", "debug projected color G", Cvar::NONE, 1.0f, 0.0f, 1.0f );
+static Cvar::Range<Cvar::Cvar<float>> r_debugProjLightB( "r_debugProjLightB", "debug projected color B", Cvar::NONE, 1.0f, 0.0f, 1.0f );
+static Cvar::Cvar<float> r_debugProjLightOriginX( "r_debugProjLightOriginX", "debug projected origin X", Cvar::NONE, 0.0f );
+static Cvar::Cvar<float> r_debugProjLightOriginY( "r_debugProjLightOriginY", "debug projected origin Y", Cvar::NONE, 0.0f );
+static Cvar::Cvar<float> r_debugProjLightOriginZ( "r_debugProjLightOriginZ", "debug projected origin Z", Cvar::NONE, 0.0f );
+static Cvar::Cvar<float> r_debugProjLightAngle( "r_debugProjLightAngle", "debug projected angle",
+                                                Cvar::NONE, 60.0f );
+
+static void AddDebugProjectedLight()
+{
+	if ( r_numLights + 1 >= MAX_REF_LIGHTS )
+	{
+		return;
+	}
+	refLight_t *light = &backEndData[ tr.smpFrame ]->lights[ r_numLights++ ];
+	*light = {};
+	light->rlType = refLightType_t::RL_PROJ;
+	// Compute direction from yaw/pitch cvars (in degrees)
+	float yaw = DEG2RAD( r_debugProjLightYaw.Get() );
+	float pitch = DEG2RAD( r_debugProjLightPitch.Get() );
+	// Right-handed: X forward, Y left, Z up. Direction vector components:
+	light->projTarget[ 0 ] = cosf( pitch ) * cosf( yaw );
+	light->projTarget[ 1 ] = cosf( pitch ) * sinf( yaw );
+	light->projTarget[ 2 ] = sinf( pitch );
+
+	vec3_t dir;
+	VectorCopy( light->projTarget, dir );
+	VectorNormalize( dir );
+
+	PerpendicularVector( light->projUp, dir );
+
+	float upLen = VectorLength( light->projUp );
+	float tgtLen = VectorLength( light->projTarget );
+
+	VectorScale( light->projUp, tanf( DEG2RAD( r_debugProjLightAngle.Get() ) ) / upLen / tgtLen,
+	             light->projUp );
+
+	// Color and intensity
+	light->color[ 0 ] = r_debugProjLightR.Get();
+	light->color[ 1 ] = r_debugProjLightG.Get();
+	light->color[ 2 ] = r_debugProjLightB.Get();
+	light->scale = r_debugProjLightIntensity.Get();
+	light->radius = r_debugProjLightRadius.Get();
+	light->origin[ 0 ] = r_debugProjLightOriginX.Get();
+	light->origin[ 1 ] = r_debugProjLightOriginY.Get();
+	light->origin[ 2 ] = r_debugProjLightOriginZ.Get();
+}
+
 /*
 @@@@@@@@@@@@@@@@@@@@@
 RE_RenderScene
@@ -542,6 +597,11 @@ void RE_RenderScene( const refdef_t *fd )
 		}
 	}
 
+	if ( r_debugProjLight.Get() )
+	{
+		AddDebugProjectedLight();
+	}
+
 	// derived info
 	if ( r_forceRendererTime.Get() >= 0 ) {
 		tr.refdef.floatTime = float( double( r_forceRendererTime.Get() ) * 0.001 );