//===========================================================================//
// File:    rpl4environ.h                                                    //
// Project: MUNGA           Brick: Red Planet LBE Application                //
// Contents: environ.ini - written on first run, then the player's           //
//---------------------------------------------------------------------------//
// Copyright (C) 1994-1995, Virtual World Entertainment, Inc.                //
//                      PROPRIETARY AND CONFIDENTIAL                         //
//===========================================================================//

#pragma once

#include "..\munga\style.h"

//########################################################################
//
// environ.ini is the game's configuration: one KEY=VALUE per line, read
// once at startup and pushed into the environment, so every option the
// engine reads through getenv can be set from a file a player can open.
//
// The exe owns the template and writes it when the file is absent, the
// same way bindings.txt works, rather than the packaging script laying
// one down on every unzip. That is what lets a tester drop a new build
// over an old folder and keep their settings: the file is theirs from
// the moment it exists, and nothing overwrites it.
//
// It cannot simply be optional. Without it L4GAUGE is unset, which
// disables the gauge renderer and takes every MFD with it, and
// L4MFDSPLIT is unset, which is the packed-window arcade layout rather
// than the glass cockpit. The shipped values are the desktop game; the
// built-in getenv fallbacks are the 1995 pod.
//
// The cost of a file that is never overwritten is that a tester carrying
// one across many builds stops being offered new options. Options added
// later default to "behave as before", so nothing breaks - but it does
// go unnoticed, so the load names any template key the player's file
// does not mention. That line in rpl4.log is what turns "the podium does
// not work" into "your environ.ini predates RP412PODIUM".
//
//########################################################################

// Write environ.ini if it is not there, then read it into the
// environment. Call once, before anything reads a setting.
void
	RPL4Environ_Load();