OOF2ORF Conversion Utility v1.2.3 BETA
Copyright (c) 2000-2001  Virtual-Creations

--------------------
Introduction:
--------------------

The OOF2ORF Conversion Utility is designed to make converting OOF's(Outrage Object Format)
to ORF's(Outrage Room Format) quick and easy while preserving all Sub-Objects, Textures,
UV Mappings, everything as it was in the OOF. Some of the features include-

* Import OOF files and Display the Model information
* Import P3D files and send them to POFGEN, after completion, showing OOF model information.
* Export ORF files. Converts all Sub-models, textures, UV mapping to ORF.

You can see POFGEN's output by clicking the Display POFGEN Output in your Options window.
This is the same information that you would see running POFGEN from the command line. You
should attempt to make your file names have no spaces in them, because otherwise they will be
converted to DOS short names. This is required by POFGEN.

Textures are converted by a Texture Translate Look Up table now which creates the appropriate
ORF texture names for each OOF texture name. Thanks to Garry Knudson for this one. Now you
will see all of your textures in D3Edit.


------------------------
Menus/Options:
------------------------

OOF2ORF should be fairly straight forward in its usage however I have briefly described the
included options and menus.

File/Import P3D:	Load a P3D from the disk and send it to POFGEN for processing using all
		command line options set in the Edit/Options Window.

File/Import OOF:	Load an OOF from the disk and display the Model information.

File/Export ORF:	Export the Model out as an ORF using the options set in the Edit/Options
		Window.

Edit/Options:	Display the POFGEN Command Line & OOF2ORF Conversion Options window.
		All command line switches that POFGEN uses are included. A brief description
		of each option if I have an idea of what it does is included.
		* If you have more information about a particular option, please let me know
		so I can update the readme.

Edit/Window Font/Colors:
		Change the Font, color of the Display window

Edit/Clear Window:	Clears the Display Window

Reload P3D:	Reload the P3D file from disk and send it to Pofgen for Analysis

----------------------------
POFGEN Options:
----------------------------

Scale Factor:	Scales the OOF by the amount shown. 1.0 would be the same size.
Error Tolerance:	Haven't used this much but I believe its the tolerance used when checking
		verts and faces for combining, and/or removal.
Shading Mode:	I believe this will apply a brightness to each vertex in the model based on the
		lighting, or the normals.
Chunk Splits:	Splits your model into chunks.
Sub-Object Seperation Planes (debug):
		Probably used for BSP trees and such. I have no idea how you would use
		this feature.
Use First Seperation Plane (debug):
		See above note.
Use Local Seperation Planes:
		See above note.
Conflict/Split Ratio:	Don't have a clue.
Combine Objects:	This forces POFGEN to combine all Sub-Objects into 1.
Animation Output:	Not sure what this does, as I have animated objects without this checked.
Capital Ships:	No clue.
POFGEN.EXE Path:	The path to POFGEN. This is needed before you can do any Import P3D
		functions.

Display POFGEN Output:
		If set, this will display POFGEN's output. This is what you would normally
		see if you ran POFGEN from the command line.

-------------------------------------------------
OOF2ORF Conversion Options:
-------------------------------------------------

OOF2ORF Conversion Settings:
		This allows you to specify whether each Sub-Object should be saved as a
		Seperate Room, or if all Sub-Objects should be combined into a single room.

------------
Notes:
------------

A few notes about what types of problems you may experience while using this program-

If you recieve errors on start up like file not found or other weird error messages, find the file
named OOF2ORF.ini and delete it. This is where all the configuration settings are stored. If
this file becomes corrupt, it would most likely be the culprit.

Here is a rundown of the Command Line Switches that are sent to POFGEN for the various
Command Line Options-

-sX.XXXXXX	- Scale Factor=X.XXXXXXX
-eX.XXXXXX	- Error Tolerance=X.XXXXXXX
-d1		- Shading Mode-Shaded by Normals
-d2 		- Shading Mode-Shaded by Lightsource
-nX,Y,Z		- Chunk Splits=X,Y,Z amounts
-p		- Sub-Object Seperation Planes
-f		- Use First Seperation Plane
-m		- Conflict/Split Ratio
-g		- Use Local Seperation Planes
-1		- Combine Objects
-a		- Animation Output
-b		- Capital Ships

---------------------------
Release History:
---------------------------

January 21,2001	- Version 1.23 BETA released. Added a Texture Translate Look up table
		compliments of Garry Knudson. You now will have all your textures come
		up in D3Edit. Major Upgrade.
January 17,2001	- Version 1.13 BETA released. Made some major additions to the program.
		Now you can see POFGEN's output. This is what you would see if you ran
		POFGEN from the command line. Also, the program now sends the DOS
		filename to POFGEN as opposed to the Windows Long filename. It will
		only do this if there are Spaces present in your directory, or file name. So,
		if you want the filename to be what you wanted it, don't put any spaces in it.
January 16, 2001	- Version 1.0.2 BETA released. Fixed an error in the saving of options, and
		window colors. Now saves all options correctly. Additional Model details are
		now displayed in the output window.
January 4, 2001	- Initial BETA release of OOF2ORF Conversion Utility v1.0.0


-------------
Credits:
-------------

Thank you to the following companies, people:

Garry Knudson	- for graciously lending me his D3Tool Source. All I can say is Garry,
		you are a God! Just so you all know, that is where the Texture Translate
		look up table came. Thank you very much Garry!

Outrage & Interplay	- for making a great game! Descent III.

Otherone		- For continuing to update D3Edit

Nick		- for helping BETA test the OOF2ORF Conversion Utility and providing
		some great suggestions.

-------------
Contact:
-------------

I hope you enjoy using the program and find it useful. If you have any questions about this program, or
would like to make comments or suggestions, or correct my mistakes, please contact me at-

Robert Piontek
rpiontek@virtual-creations.com

If you would like to see what I do for a living, visit my website at-

http://www.virtual-creations.com/