Adding CLArgs --music_volume and --sfx_volume and improving help page formatting.

Author: razterizer

Pilot_Episode/pilot_episode.cpp

@@ -93,10 +93,13 @@
 class Game : public t8x::GameEngine<>
 {
 public:
-  Game(int argc, char** argv, const t8x::GameEngineParams& params, bool use_audio)
+  Game(int argc, char** argv, const t8x::GameEngineParams& params,
+       bool use_audio, float music_volume, float sfx_volume)
     : GameEngine(argv[0], params)
     , enable_audio(use_audio)
     , audio(use_audio)
+    , volume_music(music_volume)
+    , volume_sfx(sfx_volume)
   {
   //#ifndef _WIN32
     GameEngine::set_real_fps(15);
@@ -194,6 +197,7 @@ class Game : public t8x::GameEngine<>
       if (enable_audio && chip_tune.load_tune(folder::join_path({ tune_path, "chiptune2.ct" })))
       {
           //chip_tune.play_tune();
+          chip_tune.set_volume(volume_music);
           chip_tune.play_tune_async();
           chip_tune.wait_for_completion();
       }
@@ -206,8 +210,13 @@ class Game : public t8x::GameEngine<>
     if (enable_audio)
     {
       src_fx_0 = audio.create_source();
+      src_fx_0->set_volume(volume_sfx);
+      
       src_fx_1 = audio.create_source();
+      src_fx_1->set_volume(volume_sfx);
+      
       src_fx_2 = audio.create_source();
+      src_fx_2->set_volume(volume_sfx);
     }
 
     std::string font_data_path = t8x::get_path_to_font_data(get_exe_folder());
@@ -461,6 +470,8 @@ class Game : public t8x::GameEngine<>
   beat::AudioSource* src_fx_0 = nullptr;
   beat::AudioSource* src_fx_1 = nullptr;
   beat::AudioSource* src_fx_2 = nullptr;
+  float volume_music = 0.5f;
+  float volume_sfx = 0.5f;
 
   std::vector<t8x::ColorScheme> color_schemes;
   t8x::FontDataColl font_data;
@@ -483,6 +494,8 @@ int main(int argc, char** argv)
 
   bool use_audio = true;
   bool show_help = false;
+  float music_volume = 0.5f;
+  float sfx_volume = 0.5f;
 
   for (int i = 1; i < argc; ++i)
   {
@@ -500,23 +513,41 @@ int main(int argc, char** argv)
     }
     else if (std::strcmp(argv[i], "--disable_audio") == 0)
       use_audio = false;
+    else if (std::strcmp(argv[i], "--music_volume") == 0)
+      music_volume = static_cast<float>(std::atof(argv[i + 1]));
+    else if (std::strcmp(argv[i], "--sfx_volume") == 0)
+      sfx_volume = static_cast<float>(std::atof(argv[i + 1]));
     else if (std::strcmp(argv[i], "--help") == 0)
       show_help = true;
   }
 
   if (show_help)
     use_audio = false;
 
-  Game game(argc, argv, params, use_audio);
+  Game game(argc, argv, params,
+            use_audio, std::clamp(music_volume, 0.f, 1.f), std::clamp(sfx_volume, 0.f, 1.f));
 
   if (show_help)
   {
-    std::cout << "pilot_episode --help | [--log_mode (record | replay)] [--suppress_tty_output] [--suppress_tty_input] [--altitude_start_km <altitude_km>] [--disable_altitude_limiting] [--set_fps <fps>] [--set_sim_delay_us <delay_us>] [--disable_audio]" << std::endl;
+    std::cout << "pilot_episode --help |" << std::endl;
+    std::cout << "   [--log_mode (record | replay)]" << std::endl;
+    std::cout << "   [--suppress_tty_output]" << std::endl;
+    std::cout << "   [--suppress_tty_input]" << std::endl;
+    std::cout << "   [--altitude_start_km <altitude_km>]" << std::endl;
+    std::cout << "   [--disable_altitude_limiting]" << std::endl;
+    std::cout << "   [--set_fps <fps>]" << std::endl;
+    std::cout << "   [--set_sim_delay_us <delay_us>]" << std::endl;
+    std::cout << "   [--disable_audio]" << std::endl;
+    std::cout << "   [--music_volume <music_vol>]" << std::endl;
+    std::cout << "   [--sfx_volume <sfx_vol>]" << std::endl;
+    std::cout << std::endl;
     std::cout << "  default values:" << std::endl;
     // Will unfortunately report the wrong default value for <altitude_km> if ordering the arguments like this "--altitude_start_km <altitude_km> --help".
     std::cout << "    <altitude_km> : " << game.get_alt_km() << std::endl;
     std::cout << "    <fps>         : " << game.get_real_fps() << std::endl;
     std::cout << "    <delay_us>    : " << game.get_sim_delay_us() << std::endl;
+    std::cout << "    <music_vol>   : " << music_volume << " (valid range: [0, 1])" <<std::endl;
+    std::cout << "    <sfx_vol>     : " << sfx_volume << " (valid range: [0, 1])" <<std::endl;
     return EXIT_SUCCESS;
   }