Function FreeThisLevel

Descent3/gamesequence.cpp:1768–1826

frees any data/esc that was created for that level

// frees any data/esc that was created for that level
void FreeThisLevel() {
  if (!Level_started)
    return;

  bool original_controls = Control_poll_flag;

  Cinematic_Stop();

  // make sure our controls are correct (this is needed for failed missions)
  if (Control_poll_flag != original_controls) {
    if (Control_poll_flag)
      SuspendControls();
    else
      ResumeControls();
  }

  Multi_bail_ui_menu = false;

  DemoAbort();

  // closes hud.
  FreeCockpit();
  CloseShipHUD();

  //	end music sequencer's run.
  D3MusicStop();

  FreeScriptsForLevel();
  ClearAllEvents();

  // Resets the ambient life controller
  a_life.ALReset();

  DestroyAllMatcens();
  Level_goals.CleanupAfterLevel();

  Sound_system.StopAllSounds();

  // Clear out all memory that was used for this past level
  FlushDataCache();

  InitGamePaths(); // DAJ LEAKFIX

  DSSoarEnd();

  // Reset the camera if need be
  if (Player_camera_objnum != -1) {
    SetObjectDeadFlag(&Objects[Player_camera_objnum]);
    Player_camera_objnum = -1;
    Viewer_object = &Objects[Players[Player_num].objnum];
  }

  ResetHUDMessages();

  DestroyDefaultBSPTree();

  Level_started = false;
  IsRestoredGame = false;