TOAW III Logo

TOAW III Scenario Viewer

The TOAW III Scenario Viewer parses and displays either scenario text dump files from the TOAW III Editor or the scenario files themselves (the latter as of Version 2.0). The sections are displayed in a navigable tree in one pane and the contents of a section in another when a tree node is selected.

Currently there is a problem (in the TOAW III Editor) with the text dump of detailed equipment inventory. Force 2 data is not displayed correctly. However, The TOAW III Scenario Viewer can make use of a XML OOB dump from the TOAW III Editor to generate this and other relevant information nodes. If a .OOB file exists with the same name in the same location as the .TXT file it will use it.

It can also use an .MML file to generate a "Places" node. This also provides named location information to other nodes. If a .MML file exists with the same name in the same location as the .TXT file it will use it.

It can also use an .EVT file to generate event nodes. If a .EVT file exists with the same name in the same location as the .TXT file it will use it.

Note: As of Version 2.0 most of the above is somewhat academic since the TOAW III Scenario Viewer can now read SCE files directly (thanks to Ralph for facilitating that little gem). However, the functionality is retained for compatibility purposes

Note: As already mentioned, the TOAW III Scenario Viewer V2.0 reads SCE files. It does this via a conversion to XML. This resultant XML file is saved in the same folder as the source scenario and is available to load into the Viewer (from the load dialog - change the file type in the dropdown). Some scenarios are large and can take some time to convert to XML which then has to be parsed by the Viewer. Using the saved XML speeds up the file processing.

Note: As of Version 2.1, the TOAW III Scenario Viewer V2.0 now caters for scenarios using custom equipment databases and will now return the correct equipment types. To retain this capability when using cached XML files, another file is written along with the XML file. This has the extension ".eqpfile" and merely contains the equipment database name. If it's deleted it will be recreated - the recreation process, however, entails re-reading the orginal .SCE file.

Note: SS rune characters (present in a number of scenarios) used to cause the TOAW III Scenario Viewer to throw exceptions when reading an OOB file and would cause odd characters to appear in a TXT dump. These lightning bolts are now converted to 'SS' and should no longer cause problems.

Known limitations: Orphaned events are not displayed. No weather zone information as yet.

Downloads:

Installer for V2.4.0.0

Shortcuts are placed on the Desktop and in the TOAW III Folder accessible from Start->Program Files. Uninstall should be done through Control Panel. Newer versions will automatically upgrade an installation.

Please post any problems/comments/requests either on the TOAW forums at the GameSquad website or on the TOAW forums at the Matrix Games website.

Compatibility

The TOAW III Scenario Viewer was built using Visual Studio 2008 has been tested only on Windows XP 32-bit SP3 and Windows 7 64-bit.

Disclaimer

The author of the TOAW III Scenario Viewer accepts no responsibility for damages resulting from the use of this product and makes no warranty or representation, either express or implied, including but not limited to, any implied warranty of merchantability or fitness for a particular purpose. This software is provided "AS IS", and you, its user, assume all risks when using it.


Release History

2.4.0.0: 21st January 2011. Bug fix/Change release.

Fix: Force proficiency spelling error in XML.
Change: Rebuilt with Ralph's new 3.4 Dlls.

2.3.0.0: 12th January 2010. Bug fix/Change release.

Fix: Now runs on Windows 7.
Change: Replacements/Inventory nodes combined into one.
Change: Deployment by Event node now gives a hotlink for event details.
Change: Some hotkeys changed to support integration into new Editor.
Change(internal): Data structures refactored to support integration into new Editor.

2.2.0.0: 10th November 2009. Change release.

Change: Supply Points node added.
Change: Replacements node for each force added.
Change(internal): Consistent use of StringBuilder for speed.
Change(internal): Viewer is now a UserControl.

2.1.1.0: 2nd November 2009. Bug fix/Change release.

Fix: More exceptions caused by invalid events now handled.
Fix: "Nuke" event effect now handled correctly.
Change: If "GetEquipmentFileName" returns empty default to standard equipment file

2.1.0.0: 1st November 2009. Bug fix/Change release.

Fix: Custom equipment databases now used.
Fix: Invalid Unit Ids in Events no longer cause exceptions.
Change: Equipment database used added to Scenario information.
Change: Equipment file name stored for use with XML copies of the scenario.
Change: Where units are deployed by an event this is now clearer.

2.0.2.0: 27th October 2009. Bug fix release.

Fix: Now checks standard equipment database exists before opening it.
Fix: The use of the '#' character for hyperlinks replaced with '|'.
(because '#' is used in XML files you muppet).

2.0.1.0: 26th October 2009. Bug fix/Change release.

Fix: Now reads equipment databases to attempt to show correct equipment names.
Fix: All non-displayable characters are now replaced.
Fix: Now checks for invalid event id in deployment nodes.
Change: Outcome nodes combined into one (meant to do this before).

2.0.0.0: 24th October 2009. Change release.

Change: Now reads .SCE files directly (no need to dump the scenario first).
Change: New event nodes show event chains by trigger and by turn.
Change: New popups will give details on activated events/ available theater options etc.
Change: New popups will give details on formations/units activated by events.
Change: New unit type nodes show all formation/units categorised by type.
Change: File load supports multiple types (TXT, SCE, XML).
Change: Popup dialog size now calculated based on content.
Change: Popups may be closed with ESC or ENTER key.
Change: Popups automatically close after 5 minutes.

1.1.1.0: 24th September 2009. Bug fix/Change release.

Change: Now adds a "Deployed by Event" node to the Deployment section if required.
Fix: Duplicate formation names no longer cause problems.

1.1.0.0: 23rd September 2009. Bug fix/Change release.

Change: Now uses MML file to generate and provide place information.
Change: Now uses OOB file to generate deployment information.
Change: Unit names in deployment and inventory sections are now hyperlinks.
Fix: No longer barfs on SS rune characters.
Fix: Errors in loading should no longer screw things up irretrievably.

1.0.0.1: 16th September 2009. Now uses OOB file to generate equipment inventory.

1.0.0.0: 8th September 2009. Initial port to C#.