Sisch is right of course... My biggest concern is whether the user interface will make these useful at all.
In any case, and without further ado:
Riley's Mesh Reconstruction Utilities
These utilities perform the following functions:
- Mesh Reports : Outputs information about a given mesh file. This also performs analysis on the mesh data, resolving where each 3D object can be found. Use the information from this utility to figure out your commands for the Prop Extraction utility.
- Prop Extraction : Extracts props from a given mesh file. This is the most complex, but most powerful, of all these utilities. Make texture and material changes, isolate individual 3D objects, perform 3D transformations, and apply rectangular clipping regions. A "modder's tool" through and through.
- Prop Transformations : Performs basic transformations to an entire prop. Make global texture changes, alter light-maps, and center, scale, or rotate a prop.
- Set Dressing to Prop : Take a saved set dressing file and combine its contents into a single prop, for easy use on any of the various Blue Screen sets.
Download the Riley Mesh Reconstruction Utilities here. (784 Kb) This is version 0.0.11a.
View the online user's guide here. (PDF format, requires Adobe Reader) Installation instructions are on the first page. Or continue reading for more information.
It will likely take you some reading, and some playing around, to get comfortable with the command-line nature of these utilities. I have done my best to type up a user's guide that will make sense.
The user's guide has appendices that list all the mesh filenames for all sets and facilities. It also has an appendix that explains all the game's directories and what they are used for. You'll need to know the actual filename of the mesh files you want to work with.
On the plus side, these applications are completely self-contained. They are written in C++ for optimal performance. There is also no need to use Med or Reshoot to extract game files. These utilities will do it on their own, on demand.
Installation
These utilities do not have an automatic setup program. You can decide where on your hard drive to extract them. I'd recommend "C:\Program Files\r3tm\". You can then navigate to that directory at a command prompt with the "cd" commands, as explained below.
Use WinZip or any other extraction program to extract the files in the ZIP archive. (I think Windows XP should be able to recognize and extract the files on its own...?)
Windows Command Prompt
A throwback to the DOS prompt of the 1980's, the Windows Command Prompt is not as complicated as you might first think.
To get to a command prompt, go to: Start --> Programs --> Accessories --> Command Prompt.
Instead of navigating in Windows Explorer to a folder, you type "cd" commands. This stands for "change directory". The blackslash character is used to separate sub-folders. You can also type the drive letter, followed by a colon, to switch to a different hard drive or partition (if you have them). For example:
c: - Goes to the "C:\" drive, which is usually the drive Windows is installed on.
cd \ - Goes to the root directory of the current drive.
cd blah - Goes to the "blah" folder in the current directory.
cd "Program Files" - If a folder name has spaces in it, you have to surround it with quote marks.
Running Commands
To use these utilities, you must type commands for them. Navigate to the folder that you extracted them into. Then enter commands like:
r3-tm-meshreport -xo set_hotelbedroom.msh
Setting the Output Folder
Props will, by default, be output in their own folder. Chances are, you'll want to place all your props for a given movie project in the same output folder. The prop extraction, prop transformation, and set dressing to prop utilities all share a common option for setting the output folder:
r3-tm-extractprop -workdata tests set_hotelbedroom.msh p_test_armchair -g 4
The "-workdata tests" part of that command tells it to place the prop in a "tests" folder. Use this "-workdata" option to organize your props.
DOS Batch Files
I highly recommend you make use of batch files to type your commands. Use Notepad or any other text editor, and give your batch files a filename that ends in ".bat". Save them in the same folder as you extracted these utilities.
If you have a batch file named "mymovie-props.bat", you would type the following at a command prompt:
mymovie-props
I would recommend each movie project (or mod-pack) have its own batch file. Each command should use the same "-workdata" folder. There's plenty of more advanced stuff you can do with batch files. If you felt so inclined, read about that here.
Looking to the Future
As much as I've tried typing up a decent user's guide, these utilities probably aren't for everyone. I plan on incorporating this functionality into Derobrash's MED. These things always take coordination and time, though... So if you just can't get these to work, be patient.
In Case of Errors or Unexpected Behaviour
Before filling my PM box, please read the appropriate sections in the user's guide! Test things out - don't just jump in and expect your first attempt to work. Be prepared to have to spend a
hour learning all the commands and options available.
You shouldn't get any major crashes, nor should you get any "this program terminated in an unexpected manner" error messages. If you do, send me the exact command you typed that caused the error.
I've tested things a fair bit, but there's always a chance there will be bugs. If a prop you export (especially with the r3-tm-extractprop utility) comes out looking wrong, and you're certain you typed the command correctly, send me the exact command and I'll see what I can do for you.
Riley Entertainment Website - Movies, Mods, and Modding Applications!
Riley Entertainment on TMU