Added SoundPanningEffectStrength to SettingsMan and made it read and print

Fixed some comments and default values in SoundContainer

Author: garethyr

Entities/SoundContainer.cpp

@@ -11,7 +11,7 @@ namespace RTE {
 		m_Sounds.clear();
 		m_SelectedSounds.clear();
 		m_PlayingChannels.clear();
-		m_AttenuationStartDistance = 0;
+		m_AttenuationStartDistance = 1;
 		m_Loops = 0;
 		m_Priority = AudioMan::PRIORITY_NORMAL;
 		m_AffectedByGlobalPitch = true;

Entities/SoundContainer.h

@@ -42,9 +42,9 @@ namespace RTE {
 		/// <param name="loops">The number of times this SoundContainer's sounds will loop. 0 means play once. -1 means play infinitely until stopped.</param>
 		/// <param name="affectedByGlobalPitch">Whether this SoundContainer's sounds' frequency will be affected by the global pitch.</param>
 		/// <param name="attenuationStartDistance">The distance at which this SoundContainer's sounds should start attenuating away.</param>
-		/// <param name="immobile">Whether this SoundContainer's sounds' positions will be treated as immobile, i.e. they won't be affected by 3D sound manipulation.</param>
+		/// <param name="immobile">Whether this SoundContainer's sounds will be treated as immobile, i.e. they won't be affected by 3D sound manipulation.</param>
 		/// <returns>An error return value signaling success or any particular failure. Anything below 0 is an error signal.</returns>
-		int Create(int loops = 0, bool affectedByGlobalPitch = true, float attenuationStartDistance = 0, bool immobile = false) { SetLoopSetting(loops); m_AffectedByGlobalPitch = affectedByGlobalPitch; m_AttenuationStartDistance = attenuationStartDistance; m_Immobile = immobile; return 0; }
+		int Create(int loops = 0, bool affectedByGlobalPitch = true, float attenuationStartDistance = 1, bool immobile = false) { SetLoopSetting(loops); m_AffectedByGlobalPitch = affectedByGlobalPitch; m_AttenuationStartDistance = attenuationStartDistance; m_Immobile = immobile; return 0; }
 
 		/// <summary>
 		/// Creates a SoundContainer and gives it a path to its first sound.
@@ -53,9 +53,9 @@ namespace RTE {
 		/// <param name="loops">The number of times this SoundContainer's sounds will loop. 0 means play once. -1 means play infinitely until stopped.</param>
 		/// <param name="affectedByGlobalPitch">Whether this SoundContainer's sounds' frequency will be affected by the global pitch.</param>
 		/// <param name="attenuationStartDistance">The distance at which this SoundContainer's sounds should start attenuating away.</param>
-		/// <param name="immobile">Whether this SoundContainer's sounds' positions will be treated as immobile, i.e. they won't be affected by 3D sound manipulation.</param>
+		/// <param name="immobile">Whether this SoundContainer's sounds will be treated as immobile, i.e. they won't be affected by 3D sound manipulation.</param>
 		/// <returns>An error return value signaling success or any particular failure. Anything below 0 is an error signal.</returns>
-		int Create(std::string const soundPath, int loops = 0, bool affectedByGlobalPitch = true, float attenuationStartDistance = 0, bool immobile = false) { int result = Create(loops, affectedByGlobalPitch, attenuationStartDistance, immobile); AddSound(soundPath); return result; }
+		int Create(std::string const soundPath, int loops = 0, bool affectedByGlobalPitch = true, float attenuationStartDistance = 1, bool immobile = false) { int result = Create(loops, affectedByGlobalPitch, attenuationStartDistance, immobile); AddSound(soundPath); return result; }
 
 		/// <summary>
 		/// Adds a new Sound to this SoundContainer, loaded from a file.

Managers/SettingsMan.cpp

@@ -56,6 +56,7 @@ void SettingsMan::Clear()
 	m_ForceNonOverlayedWindowGfxDriver = false;
 	m_AllowSavingToBase = false;
 	m_RecommendedMOIDCount = 240;
+    m_SoundPanningEffectStrength = 0.5;
 	m_NetworkServerName = "";
 	m_PlayerNetworkName = "";
 
@@ -233,6 +234,8 @@ int SettingsMan::ReadProperty(std::string propName, Reader &reader)
         reader >> m_PrintDebugInfo;
 	else if (propName == "RecommendedMOIDCount")
 		reader >> m_RecommendedMOIDCount;
+    else if (propName == "SoundPanningEffectStrength")
+        reader >> m_SoundPanningEffectStrength;
 	else if (propName == "PlayerNetworkName")
 		reader >> m_PlayerNetworkName;
 	else if (propName == "NetworkServerName")
@@ -403,6 +406,8 @@ int SettingsMan::Save(Writer &writer) const
     writer << m_PrintDebugInfo;
 	writer.NewProperty("RecommendedMOIDCount");
 	writer << m_RecommendedMOIDCount;
+    writer.NewProperty("SoundPanningEffectStrength");
+    writer << m_SoundPanningEffectStrength;
 	writer.NewProperty("PlayerNetworkName");
 	if (m_PlayerNetworkName == "")
 		writer << "Dummy";

Managers/SettingsMan.h

@@ -409,6 +409,11 @@ class SettingsMan:
 
 	void SetPrintDebugInfo(bool printDebugInfo) { m_PrintDebugInfo = printDebugInfo; }
 
+	/// <summary>
+	/// The strength of the sound panning effect. 0 - 1, where 0 is no panning and 1 is fully panned
+	/// </summary>
+	float SoundPanningEffectStrength() const { return m_SoundPanningEffectStrength; }
+
 
 //////////////////////////////////////////////////////////////////////////////////////////
 // Method:			ForceSoftwareGfxDriver
@@ -596,6 +601,8 @@ class SettingsMan:
 	bool m_EndlessMode;
 	// Print some debug info in console
 	bool m_PrintDebugInfo;
+	// The strength of the sound panning effect, 0 (no panning) - 1 (full panning)
+	float m_SoundPanningEffectStrength;
 	//Whether CC uses additional Draws during MO's PreTravel and PostTravel to 
 	//update MO layer this frame with more precision(true), or it just uses data from the last frame with less precision(false)
 	bool m_PreciseCollisions;