// =============================================================================================
// ---------------------------------------------------------------------------------------------
// msRSDExporter Version 1.1 by Andrew Murray (leon17)
// ---------------------------------------------------------------------------------------------
// =============================================================================================

// --Contents-----------------------------------------------------------------------------------

1. Version History
2. Intro
3. Abstract
4. Features
5. Instructions
6. Bugs/Issues
7. Thanks

// --Version History----------------------------------------------------------------------------

 - Version 1.0 Released 13th February 2003
 - Version 1.1 Released 20th March 2003
	- Added support for groups.
	- Fixed a bug where the TIM file could not be accessed after an export.

// --Intro--------------------------------------------------------------------------------------

This is the first release of the RSD exporter for MilkShape 3D.

If you find any problems while using it please get in contact with me as soon as possible 
at sckoobs@yahoo.com so that I can put it right, your help is much appreciated.

If you havn't already got MilkShape 3D then you can download a 30 day trial version 
(thereafter it costs $25, around £16) from:

http://www.swissquake.ch/chumbalum-soft/

// --Abstract-----------------------------------------------------------------------------------

I hope this helps you with your PlayStation modelling as I programmed this more out of
neccessity than interest. Using RSDTool as a texture tool is plain insanity, I don't know
of any other texturing tools for RSD files hence the reason for this plug-in.

It took me quite a while doing this one, the MilkShape API and the RSD file format aren't
exactly a perfect match.

// --Features-----------------------------------------------------------------------------------

The exporter currently supports:

* Multiple textures (upto a limit of 8, it will crash if you exceed this. Don't get 
  confused between materials and textures, as each material may or may not have a texture.
  Surely you can't have more than eight textures per model?)
* Smooth (Gouraud) shading
* Flat shading
* Material colours i.e. the colours that you applied to materials, which are applied to 
  groups in MilkShape.
* Textures that are applied to materials, which are applied to groups in MilkShape.
* Grouping of polygons which allows access to individual groups of a model in Yaroze
  programs.

// --Instructions-------------------------------------------------------------------------------

Put the msRSDExporter.dll file into the MilkShape 3D install directory (there should
be other dll files there as well).

When texturing your model in MilkShape 3D use any image format (although BMP is probably the
best as you will no doubt need to create a TIM using the BMP). Before exporting to RSD 
convert the textures to .tim format files and place them in the same directory as your model,
make sure they have the same file name as that of the texture you used for texturing inside
MilkShape 3D and that they are the same pixel dimensions i.e. width and height. Also
note that the maximum size of textures for the PlayStation (without going to too much 
trouble) is 256 x 256 pixels.

Make sure that the aforementioned steps are taken before exporting because the RSD 
export requires the .tim files in order to extract the width and height of the image for
U, V coordinate calculation. If the files aren't there you'll get an error when 
exporting.

When you have the RSD file use 'rsdlink' to make a tmd from them.

// --Bugs/Issues--------------------------------------------------------------------------------

Once you export your TMD, do you have a desire to fire up RSDTool and check if everything is 
ok? Well, I do, but that may just be because I coded this exporter. However, RSDTool (version
3.12), either through a lack of updates or an oversight while coding (most likely both) 
does not fully support the new RSD file implementation and therefore some things such 
as coloured & textured polygons will appear blank, as will some other combinations. DO NOT
save the exported files after opening them up in RSDTool unless you are sure the features in
the file are supported by it. The model should work on the PlayStation with all the polygon
types supported by this plug in.

Any other bugs should be reported to: sckoobs@yahoo.com (with much appreciation from me :)).

// -Thanks--------------------------------------------------------------------------------------

 - Loads of thanks to Edmund Kapusniak

 - Mete Cirigan for the great MilkShape 3D API