FreeCNC v0.3 README
-------------------

Contents:
Disclaimer
Selecting other maps
Maps available in the demo versions
Controls
New features from 0.2.0
Known bugs

Disclaimer
==========
FreeCNC is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See version two of the GNU General Public License for more
details.

Selecting other maps
====================
The naming scheme used by Westwood for their single player maps is roughly:

SC[GB][0-9][0-9][WE][ABC]

Examples: SCB01EA (first NOD mission), SCG15EB (one of the final GDI missions),
SCB13EC (one of the final NOD missions).  Higher map numbers are used for the
Covert Operations missions.

Mulitplayer maps have 'M' instead of G or B.

Red Alert maps are similar, but with of SCU instead of SCB for the Soviets.
Note that Red Alert isn't fully supported by this release.

FreeCNC is able to load maps that do not conform to this naming scheme (useful
for organising collections of custom maps).

Maps available in the demo versions
===================================
The maps available in the Tiberian Dawn demo are: SCG01EA, SCG03EA, SCG05EA,
SCG06EA, SCG07EA and SCG10EA (No NOD missions).

The Red Alert demo has SCG02EA SCG05EA and SCU01EA (which is misnamed as it's
actually the second Soviet mission).

Controls
========
The controls are very similar to the original, with some improvements:
- Holding down shift whilst drawing a box around units adds them to your
  selection.
- Holding down the right mouse button and dragging will scroll the map;
  the further you move the mouse from where you started, the faster the
  scroll (upto a limit).
- The mouse wheel can be used to scroll the sidebar (page up/down also
  scrolls the sidebar).

Map locations can be bookmarked: hold down control and press a
function key between F1 and F5 (inclusive) to store a location, then
press that function key to return to that location in the map.  Each
bookmark defaults to the top left corner of the map.

Selections can also be stored: hold down control and press any number
key to store your current selection in that slot.  Press that number
again later to retrieve that selection.  There is no restriction on
units or structures being exclusively in at most one stored selection.

Other controls in FreeCNC v0.3-CVS (mostly for debugging/testing purposes):
* 'v' reveals the whole map.
* 'c' lets you build on any clear terrain, regardless of proximity.
* 'b' makes all units and structures available to be built.
  Even with this enabled, you can't build units without an appropriate
  construction building.
* 'm' lets you continue building even if you don't have any money.

New features from previous release (0.2.0)
==========================================
* Much improved INIFile and talkback parser: startup times are
  dramatically reduced.
* New VQA decoding code that can scale to higher resolutions.
* New scrolling code.  The map scrolls very smoothly now, and the
  right mouse button can be used to scroll the map.
* The fog of war now has smooth edges.
* If a sidebar icon can not be found, the type name is drawn instaead.
* Targetting enemy infantry with the mouse should now be easier (picks
  nearest soldier if mouse isn't on one)

See the TODO file for a list of new features being worked on.

Known bugs
==========
* Although Red Alert support has improved significantly, there is still a lot of
  code that was based around assumptions that only hold true with Tiberian Dawn.
  Therefore, Red Alert isn't supported by the 0.3 release.  We hope to have
  fixed the remaining issues by the 0.4 release (but it won't be considerred a
  blocker for the release).

* Performance is significantly impacted by running in a colour depth
  other than 16 bits per pixel.

* VQAs play as fast as possible if sound is disabled.

* The values for weapon ranges, how much damage they do, etc. need
  adjusting.  Please send in your ideas on how to improve them.

* Some maps rely on triggers to supply the human player with units, so
  you will get a free MCV.  The map will be revealed and you will be
  able to place the MCV on any clear cell (proximity checks are then
  re-enabled).

* Some maps in the original game have bugs in them, such as units and
  structures placed on the same cell and more importantly not all
  GDI/Civilian alliances are explicitly stated in all maps.  The
  existing win detection code requires you to destroy /all/ enemies,
  which will include civilians on these maps (even as GDI).  We'll fix
  this in later releases by patching the maps.

* Although this is an SDL issue, it's worth mentioning here:
  If FreeCNC crashes when fullscreen, the mouse may be locked and you
  may not be able to change the resolution back.  To fix this, rerun
  FreeCNC in fullscreen then exit cleanly (you may have to change your
  resolution back manually afterwards).

"Eye-candy" bugs:
* Muzzle flash animations aren't properly centred.
* Construction Yard appears to build something when damaged to 50%
  health.
* MCV doesn't turn when deploying.
* Buildings that start off with a rotation don't crumble when damaged to 50%+

