//---------------------------------------------------------------------------
/**
 ** DDS Converter 2.0
 ** >>> Documentation <<<
 ** Copyright © 2004 Yannick 'Bluehair' Leon <bluehair@wanadoo.fr>
 **
 ** $File:	./DDS Converter 2.txt$
 ** $Designer:	Bluehair$
 ** $Date (US):	08-03-2k4$
 ** $Revision:	08-04-2k4$
 **
 **/
//---------------------------------------------------------------------------


[---- MANIFEST ----]

	|- DDS Converter 2.txt
	|- DDS Converter 2.exe		; the main program
	|---------------------
	|- DevIL.dll			; open source image library used to
	|- ILU.dll			; load all supported image files and
	|- ILUT.dll			; save non-dds files
	|---------------------
	|- nvdxt.exe			; nVidia's command line tool used
	|				; to save DDS files
	|---------------------
	|- s3tc.exe			; older S3 Graphics' tool simply
	|- vic32.dll			; included as an alternative to
					; nVidia's

	Those latter tools are only provided for your convenience. I haven't created them

	You can download the latest iteration of nvDXT @ http://developper.nvidia.com


[---- OVERVIEW ----]

	The primary goal of this program is to enable the conversion in batch and
	in control of game textures into DDS format, be them saved in TGA, JPG, PNG ...
	However, other kinds of conversion are also possible


[---- WHAT'S NEW OVER v1.20 ----]

	I have rewritten the original program from scratch using Microsoft Foundation
	Classes framework (MFC); the better layout of the code would make the addition
	of new functionalities a snap; for you, this means that all the issues from
	the previous version are now over :)

	An options dialog is now included so you can customize several aspects of
	the program; in particular, you can select the DXT compression to apply
	to DDS files; for that matter, remember that DXT3 will produce larger files
	than DXT1; likewise, building mipmaps into them will add up to the final size

	You can now thoroughly follow the evolution of the conversion process; any
	error encountered will be reported back to you through an 'event viewer'

	Still no PK3 support in this version; however, if I make it (which must not
	be excluded), I will only have to redistribute one file to have the
	'Browse PK3' button enabled


[---- INSTALLATION ----]

	Nothing special: just put the files from this zip into a directory of your
	choice. Then, double-click on 'DDS Converter 2.exe' to start the application


[---- USAGE NOTES ----]

	> Some facts:

		* nvDXT crashes when the input is either a BMP or PNG
		* likewise, S3TC only supports TGA on input

	To bypass these limitations, DDS Converter 2 generates a temporary TGA file
	to effectively have any type of input file converted into DDS

	This means that nvDXT and S3TC will work faster when the inputs are:

		* in JPG/PSD/TGA format for nvDXT
		* and in TGA for S3TC

	> The small button on the left hand side of 'Reset', '.\', sets the
	output folder the same as the input one

	> The 'Convert' button will be disabled if you haven't set the output folder

	> The 'Opacity' slider won't have any effect on Win9x systems


[---- BOTTOM LINE ----]

	I would like thank Rob Manderson, a regular contributor to The Code Project
	(http://wwww.codeproject.com) for his insight on how to extensively
	customize the Windows file open dialog using undocumented tricks; actually,
	this site helped me than once during the development of this program :)

	Also, thank you for having downloaded so many times DDS Converter 1.20; of
	course, this does not necessarily means you liked it but even so, this
	pleases me ;)

	I have definitely chosen my way in programming, and in particular in
	game programming which is my primary field of interest and goal. I'm
	doing progress every single day that elapses and then you will very
	likely see more multimedia-like programs from me in the future.

	Cya,

	-Bluehair


//---------------------------------------------------------------------------