//===========================================================================
// Makes many common UI settings changes at once, for use when beginning and
// ending cinematic sequences. Note that some affects apply to all players,
// such as game speed. This is unavoidable.
// - Clear the screen of text messages
// - Hide interface UI (letterbox mode)
// - Hide game messages (ally under attack, etc.)
// - Disable user control
// - Disable occlusion
// - Set game speed (for all players)
// - Lock game speed (for all players)
// - Disable black mask (for all players)
// - Disable fog of war (for all players)
// - Disable world boundary fog (for all players)
// - Dim non-speech sound channels
// - End any outstanding music themes
// - Fix the random seed to a set value
// - Reset the camera smoothing factor