Dawn of War SGA Explorer
===============================

Welcome to the Dawn of War SGA Explorer. This small application is designed to allow you to extract files from Relic's SGA file format (a type of archive). It is based on the same back-end file handling as the Command-line SGA Extractor, only with updates and a graphical interface.

The latest version of the Texture Tool can always be found at http://skins.hiveworldterra.co.uk/SGAExplorer/


Requirements
------------

This application requires the .Net Framework v1.1 (http://msdn.microsoft.com/netframework/downloads/framework1_1/). It may also be compatible with the .Net Framework 2.0, but this has not yet been tested.


Installation
------------

1) Extract the Zip file to a location you want (the Dawn of War folder is recommended)
2) Run the EXE.


Using the SGA Explorer
----------------------

Select "Open" from the "Files" menu to open an SGA file. Once you've opened a file, the application then behaves like Windows Explorer. Clicking on a folder shows the files it contains in the right panel, expanding a folder shows the subfolders, right-clicking brings up a context menu to extract the selected files, or the selected folder and its sub-folders.

If you know the path of a file within an archive, you can enter a path in the address box and press "Go". Entering a folder path selects the folder, entering a file path selects the folder and then selects the file within the folder.

Warning: When extracting large numbers of small files (especially when those files are also compressed) the SGA Explorer is known to become unresponsive. Please either try to be more selective with the files you extract, or leave the application until it completes.


FAQ
---

I receive an error saying "[insert error message here]". What does it mean?

  Firstly, check the "Troubleshooting" section for the most common errors. If this does not cover it, send the information from the Debug window to IBBoard at webmaster@ibboard.co.uk
  
Why are all of the file type icons the Windows "Unknown Type" icons?

  Mainly because I'm not very good at art. Kresjah has offered to make some icons and displayed an initial example (http://forums.relicnews.com/showthread.php?t=98358) but the icons themselves are being developed on his schedule, as and when he has time.
  
Why would I want to hex-edit the files when I extract them?  
  
  Generally, this is used when you're creating a cloned race (e.g. IBBoard's Halved and Quartered Marine races). If a cloned race shares the models (WHM and WHE files) and/or textures (RSH files) with another race then as soon as a player uses one of the races the enemy models of either of the races will all use the player's teamcolours in the players view. This phenomenon is known as 'colour bleed', and is the scourge of many a first-time model-shared-between-races Modder.
  
  There are two solutions to the colour bleed problem. The first is to entirely recreate all of the models, which requires 3DSMax and a model extraction tool (such as Santos' Tools). The second is to simply hex-edit each and every WHM and RSH to contain the new race's art path instead of the old race's path. Although this can be done manually after extraction, auto-magic hex-editing at extraction time is simpler, quicker, and less prone to missing a file!
  
Can I drag and drop files out of the archive to extract them?

  At the moment, no, but it is a planned feature for the future.
  
Can I drag and drop files in to the archive to add them?

  At the moment, no, but it is a planned feature for the future.
  
Can I alter the archives in any way using this tool?
  
  Again, no, not at the moment, but a future version of the program should hopefully be able to do it.


Troubleshooting
---------------

Known errors:
  "The application failed to initialize properly (0xc0000135). Click OK to termintate the application" - This error only occurs if you do not have the .Net Framework (v1.1) installed on your computer. Please go to http://msdn.microsoft.com/netframework/downloads/framework1_1/ for instructions on how to download and install the framework.

If you have any problems, please email me at webmaster@ibboard.co.uk with as much information as you can about the error and what you were doing, and I will look into it.
Please note that you need the .Net framework to run this application.  Later builds may be created that include the required framework code within the build, but until a free version is developed, that would cost several thousand pounds.


Distribution
------------

Feel free to use this application for working with Relic's SGA files.

Do not redistribute this file in any way - either in part or in whole. Only IBBoard, Hive World Terra (www.hiveworldterra.co.uk) and Skins@HWT (skins.hiveworldterra.co.uk) have that right. The author retains the right to add other sites to the list of allowed hosts, and any new 'official' hosts will be listed on Skins@HWT.

If you feel that the tool is good enough, please feel free to link to the download page (not directly to the download) and email me about your link.


History
-------

Version 1.1:	Added additional code to handle the SGAv4 files used by Relic's Company of Heroes game. 'Default location' resorts to the folder the SGA file is in, as the SGA reader doesn't read the new details that CoH uses to define archive folders etc.
				Added "Extract type" options to context menu on folders so that all files of a type (e.g. all WTP files) can be extracted)

Version 1.0: 	The initial build, lets you extract files to their default locations or to a specified location. Also provides a variety of details about the files in Detail view.


Credits
-------

Thanks to Spooky and Corsix for the SGAv2 file format information they posted on the Relic News Forums.

Thanks to Kresjah for offering to make the file-type icons.


The Future
----------

Possible ideas for later builds of this app include:
	Extraction with hex-editing (as with the Command-line extractor, to allow new races to be easily created based on existing ones) - requires some form of repeatable GUI for "to find" and "replace with" strings
	Drag and drop extraction
	SGA creation/modification
	Drag and drop archive modification
	Improve efficiancy/interface update process
	Automatically include application in "Open With..." list
	Make visible columns customisable
	Separate file types and descriptions out into config files for easier editing
	
Any other ideas would be greatly appreciated.


Enjoy!

IBBoard
webmaster@ibboard.co.uk
www.hiveworldterra.co.uk and skins.hiveworldterra.co.uk


*****************
Legal/Disclaimer:
*****************

The following legal disclaimers are included for completeness:


This application is provided 'as is' without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of fitness for a purpose, or the warranty of non-infringement. Without limiting the foregoing, IBBoard makes no warranty that:

   1. the software will meet your requirements
   2. the software will be uninterrupted, timely, secure or error-free
   3. the results that may be obtained from the use of the software will be effective, accurate or reliable
   4. the quality of the software will meet your expectations
   5. any errors in the software will be corrected.

This application and its documentation:

   1. could include technical or other mistakes, inaccuracies or typographical errors. IBBoard may make changes to the software or documentation made available on the Skins@HWT web site.
   2. may be out of date, and IBBoard makes no commitment to update such materials.

IBBoard assumes no responsibility for errors or ommissions in the software or documentation available from Skins@HWT.

In no event shall IBBoard be liable to you or any third parties for any special, punitive, incidental, indirect or consequential damages of any kind, or any damages whatsoever, including, without limitation, those resulting from loss of use, data or profits, whether or not the BGS has been advised of the possibility of such damages, and on any theory of liability, arising out of or in connection with the use of this software.

The use of the software downloaded through Skins@HWT is done at your own discretion and risk and with agreement that you will be solely responsible for any damage to your computer system or loss of data that results from such activities. No advice or information, whether oral or written, obtained by you from IBBoard or Skins@HWT shall create any warranty for the software.



All logos and trademarks in this site are property of their respective owner. All textures are modified version of original textures create by Relic Entertainment, under license to Games Workshop Ltd. They are completely unofficial modifications, and in no way endorsed by Games Workshop, THQ, Relic or any other officially associated group.

Warhammer 40K: Dawn of War logos and information Copyright  2004

Relic Entertainment, Inc.
400-948 Homer Street Vancouver, BC, Canada V6B 2W7

and

THQ Incorporated
27001 Agoura Road, Suite 325
Calabasas Hills, CA 91301

All rights reserved. Names, trademarks, and copyrights are the property of the originating companies.

Adeptus Astartes, Blood Angels, Bloodquest, Cadian, Catachan, the Chaos devices, Cityfight, the Chaos logo, Citadel, Citadel Device, Codex, Daemonhunters, Dark Angels, Dark Eldar, 'Eavy Metal, Eldar, Eldar symbol devices, Eye of Terror, Fire Warrior, Forge World, Games Workshop, Games Workshop logo, Genestealer, Golden Demon, Gorkamorka, Great Unclean One, Inquisitor, the Inquisitor logo, the Inquisitor device, Inquisitor:Conspiracies, Keeper of Secrets, Khorne, Kroot, Lord of Change, Necron, Nurgle, Ork, Ork skull devices, Sisters of Battle, Slaanesh, Space Hulk, Space Marine, Space Marine chapters, Space Marine chapter logos, Tau, the Tau caste designations, Tyranid, Tyrannid, Tzeentch, Ultramarines, Warhammer, Warhammer 40k Device, White Dwarf, the White Dwarf logo, and all associated marks, names, races, race insignia, characters, vehicles, locations, units, illustrations and images from the Warhammer 40,000 universe are either , TM and/or  Copyright Games Workshop Ltd 2000-2004, variably registered in the UK and other countries around the world.

Used without permission. No challenge to their status intended. All Rights Reserved to their respective owners.