Add target emissive config parameter and document

Author: bboudaoud-nv

docs/experimentConfigReadme.md

@@ -83,6 +83,7 @@ The following configuration is universal to all target types.
 * `visualSize` is a vector indicating the minimum ([0]) and maximum ([1]) visual size for the target (in deg)
 * `colors` is an array of 2 colors (max and min health) which are interpolated between based on target damage (note this setting overrides the experiment or session-level [`targetHealthColors`](general_config.md#target-rendering) setting). If unspecified the experiment/session level settings are used.
 * `gloss` is a `Color4` representing glossyness, the first 3 channels are RGB w/ alpha representing minimum reflection (F0). Set all channels to 0 or do not specify to disable glossy reflections (note this setting overrides the experiment or session-level [`targetGloss`](general_config.md#target-rendering) setting). If unspecified the experiment/session level settings are used.
+* `emissive` is an array of 2 colors (max and min health) which are interpolated between based on the target damage (note this setting overrides the experiment or session-level [`targetEmissive`](general_config.md#target-rendering) setting). If unspecified the experiment/session level settings are used.
 * `destSpace` the space for which the target is rendered (useful for non-destiantion based targets, "player" or "world")
 * `hitSound` is a filename for the sound to play when the target is hit but not destroyed (for no sound use an empty string).
 * `hitSoundVol` provides the volume (as a float) for the hit sound to be played at (default is `1.0`).

docs/general_config.md

@@ -508,6 +508,7 @@ These flags help control the behavior of click-to-photon monitoring in applicati
 |-----------------------|-----------------------|------------------------------------------------------------------------------------|
 |`targetHealthColors`   |[`Color3`, `Color3`]   | The max/min health colors for the target as an array of [`max color`, `min color`], if you do not want the target to change color as its health drops, set these values both to the same color                                              |
 |`targetGloss`          |`Color4`               | The target glossy (reflection) value, first 3 channels are RGB w/ alpha representing minimum reflection (F0). Set all channels to 0 or do not specify to disable glossy reflections. This sets the glossy color for the reference target in addition to trial targets       |
+|`targetEmissive`       |[`Color4`, `Color4`]   | The max/min health emissive colors for the target as an array of [`max color`, `min color`], if you do not want the target to change color as its health drops set the values both to the same color. If no value is specified a default of 0.7 * the target color is used to match historical behavior. |
 |`showReferenceTarget`   |`bool`                | Show a reference target to re-center the view between trials/sessions?             |
 |`referenceTargetColor` |`Color3`               | The color of the "reference" targets spawned between trials                        |
 |`referenceTargetSize`  |m                      | The size of the "reference" targets spawned between trials                         |
@@ -542,6 +543,10 @@ These flags help control the behavior of click-to-photon monitoring in applicati
 "showReferenceTargetMissDecals" : true,         // Show miss decals for reference targets
 "previewTargetColor" = Color3(0.5, 0.5, 0.5),   // Use gray for preview targets (if they are shown)
 "targetGloss" = Color4(0.4f, 0.2f, 0.1f, 0.8f), // Use the target gloss behavior from FPSci v22.02.01 and earlier
+"targetEmissive" = [
+    Color4(0, 0.7, 0, 1);
+    Color4(0.7, 0, 0, 1);
+],
 ```
 
 ### Target Health Bars

source/FpsConfig.cpp

@@ -440,6 +440,7 @@ void TargetViewConfig::load(FPSciAnyTableReader reader, int settingsVersion) {
 			throw "Specified \"healthColors\" doesn't contain at least one Color3!";
 		}
 		reader.getIfPresent("targetGloss", gloss);
+		reader.getIfPresent("targetEmissive", emissive);
 		reader.getIfPresent("targetHealthBarColors", healthBarColors);
 		reader.getIfPresent("showFloatingCombatText", showCombatText);
 		reader.getIfPresent("floatingCombatTextSize", combatTextSize);

source/FpsConfig.h

@@ -192,12 +192,13 @@ class FeedbackConfig {
 class TargetViewConfig {
 public:
 	// Target color based on health
-	Array<Color3>   healthColors = {									    ///< Target start/end color (based on target health)
+	Array<Color4>   healthColors = {									    ///< Target start/end color (based on target health)
 		Color3(0.0, 1.0, 0.0),
 		Color3(1.0, 0.0, 0.0)
 	};
 
-	Color4 gloss;		///< Target glossyness (alpha is F0 or minimum reflectivity, see G3D docs)
+	Color4 gloss;				///< Target glossyness (alpha is F0 or minimum reflectivity, see G3D docs)
+	Array<Color4> emissive;		///< Target emissive color
 
 	// Target health bars
 	bool            showHealthBars = false;									///< Display a target health bar?

source/TargetEntity.cpp

@@ -75,6 +75,7 @@ TargetConfig::TargetConfig(const Any& any) {
 		reader.getIfPresent("destroyedSound", destroyedSound);
 		reader.getIfPresent("destroyedSoundVol", destroyedSoundVol);
 		reader.getIfPresent("colors", colors);
+		reader.getIfPresent("emissive", emissive);
 		hasGloss = reader.getIfPresent("gloss", gloss);
 
 		break;

source/TargetEntity.h

@@ -81,9 +81,10 @@ class TargetConfig : public ReferenceCountedObject {
 	float           destroyedSoundVol = 1.0f;
 
 	// Target color based on health
-	Array<Color3>   colors;									///< Target start/end color (based on target health)
+	Array<Color4>   colors;									///< Target start/end color (based on target health)
 	Color4			gloss;									///< Target gloss (alpha is F0, see docs)
 	bool			hasGloss = false;						///< Target has gloss specified
+	Array<Color4>	emissive;								///< Target start/end emissive color (similar to colors above)
 
 	Any modelSpec = PARSE_ANY(ArticulatedModel::Specification{			///< Basic model spec for target
 		filename = "model/target/low_poly_sphere.obj";