General Information Help file
for the RV-Tools by Chaos
© Chaos, Jan 2000
[This version updated by Gibbler, Jan 2000]

Table of Contents
General Information
Tool is the program name, given as an absolute or relative path
File is the filename you want to work with, given as an absolute or relative path
[options] means you can give options (parameters) to the program to influence the way it modifies the file

Absolute and relative Paths

Absolute Path
A Path given as Absolute looks like this:

An absolute Path contains the drive-letter and the full path from the root (C:\) of that drive.

An absolute Path is independent of your current location with in the file-system (ie. it doesn't matter which drive or directory you are in).

Relative Path
A Path given as Relative looks like this:

A Relative Path can look similar to an Absolute Path, but it misses something, eg. the drive-letter or the \ behind the : for starting at the root

Each Drive memorizes your last location on it - the last location is the current path for that drive.
If no drive-letter is given, and no \ is specified as the first letter for your path, the search starts in the current directory on the current drive.
Giving a drive-letter without a \ after the : means the search starts in the current directory on that drive (not the current drive!).
If you give a drive-letter with a \ after the : then you are specifying an absolute path.

Special Directories
For Relative and Absolut Paths there are two (2) special directories: the . (Dot) and the .. (DotDot)
Where the . (Dot) is the current Directory and the .. (DotDot) is the parent Directory (of the current directory)

Some Examples:
The relative path WIN.INI and .\WIN.INI are the same.
C:\WINDOWS\WIN.INI and C:\WINDOWS\.\SYSTEM\.\..\..\WINDOWS\..\.\.\WINDOWS\.\WINI.INI are the same.

Try it - open a DOS-Prompt and type: NOTEPAD C:\WINDOWS\.\SYSTEM\.\..\..\WINDOWS\..\.\.\WINDOWS\.\WINI.INI (Enter)
You will see your WIN.INI opened in Notepad (if \WINDOWS is the directory you installed Windows to).

RV-ReMap

Overview
RV-ReMap is a tool to move texture-references in a model file (.prm or .m) from one texture sheet to another. All models that use textures, reference a texture sheet "number". These numbers are then internally referenced by the Revolt engine to specifically named files, which are shown in the table below.

Notes:
1) Numbers shown in Blue are special textures used by Revolt that should preferably not be altered by the end user.
2) "xxx" before a filename letter indicates that the file can be named as anything, as long as it finishes with the letter indicated, plus the .bmp extension.. Eg: My_TrackA.BMP, My_TrackB.BMP.

Number Texture Filename Number Texture Filename
-1 No texture (normal Basecolor of object) 15 AI 5 Car.bmp
0 xxxA.bmp 16 AI 6 Car.bmp
1 xxxB.bmp 17 AI 7 Car.bmp
2 xxxC.bmp 18 AI 8 Car.bmp
3 xxxD.bmp 19 AI 9 Car.bmp
4 xxxE.bmp 20 AI 10 Car.bmp
5 xxxF.bmp 21 AI 11 Car.bmp
6 xxxG.bmp 22 GFX\Font.bmp
7 xxxH.bmp 23 GFX\Spru.bmp
8 xxxI.bmp 24 GFX\Envstill.bmp
9 xxxJ.bmp 25 GFX\Envroll.bmp
10 Own Car.bmp 26 GFX\Shadow.bmp
11 AI 1 Car.bmp 27 GFX\FxPage1.bmp
12 AI 2 Car.bmp 28 GFX\FxPage2.bmp
13 AI 3 Car.bmp 29 GFX\FxPage3.bmp
14 AI 4 Car.bmp 30 GFX\Loading.bmp

Without Options

RV-ReMap, run without options, tells you the number of polygons in the specified file, and the number of polygons with a reference to a specific bitmap.

Options

There is only one option type, but this can be used multiple times on the same command line.

The option look like this: x=y

x and y are numbers - x is the old reference (texture sheet number) and the y is the new reference (texture sheet number).

All the given options are executed at the same time, ie. you can swap two texture-sheet references with one line.

Examples

I'm assuming that RV-ReMap is located in the Revolt root-directory.

  1. Firstly, open a MS-DOS Prompt window and go to the Revolt root-directory.
  2. Type: rv-remap (Enter)
    You will see the usage-message: 
     Usage: RV-REMAP.EXE FILENAME [?=?]

        Version: 1.10

        FILENAME is the name of the file to be remaped

        ?=?     the first ? is the old Referencnumber
                the second ? is the new Referencnumber

                the Referencnumber for bitmap A is 0,
                for B it is 1 and so on, for none it is -1 (only as second)

                the number in front of the = has to be >= 0
                the number behind the = has to be -1 <= x <= 38

                if none are given, the used references are displayed
  3. Type: rv-remap .\models\abcblock.m (Enter)
    You should see: 
    RV-ReMap Version 1.10
6 Polygons found
Bitmap 6 (xxxG.bmp) is used 6 times
  4. Type: rv-remap .\models\abcblock.m 6=7 (Enter)
    You should see: 
    RV-ReMap Version 1.10
6 Polygons found
  5. Type: rv-remap .\models\abcblock.m (Enter)
    You should see: 
    RV-ReMap Version 1.10
6 Polygons found
Bitmap 7 (xxxH.bmp) is used 6 times
  6. Type: rv-remap .\models\abcblock.m 7=6 (Enter)
    You should see: 
    RV-ReMap Version 1.10
6 Polygons found
  7. Type: rv-remap .\models\abcblock.m (Enter)
    You should see: 
    RV-ReMap Version 1.10
6 Polygons found
Bitmap 6 (xxxG.bmp) is used 6 times
RV-Sizer

Overview
RV-Sizer is a tool to change the size of a model along one or more of it's axis. It only works with .prm and .m files, other files will be damaged!

Without Options
RV-Sizer, run without options, tells you the total bounding-box area of the model.

Options
There is only one option type, but this type can be given multiple times on the same command-line.
The options look like this: Sx=y
Where x is a letter (x, y, z or a) and y is a number. Note: the S is always required.

The letter (x) specifies the axis to scale, and the number (y) is the scaling-factor. Scaling means multiplying, ie. 1 has no effect, 2 makes it twice as large, 0.5 halfs the size and -1 mirrors the model.

Examples
I'm assuming that RV-Sizer is located in the Revolt root-directory.
  1. Firstly, open a MS-DOS Prompt window and go to the Revolt root-directory.
  2. Type: rv-sizer (Enter)
    You should see the usage-message: 
     Usage: RV-SIZER.EXE FILENAME [S?=?]

        Version: 1.00

        FILENAME is the name of the file to be remaped

        S?      ? can be X, Y, Z or A meaning which axis to scale (A for all)

        =?      ? is the multiplier for the axis
                        1       -> no effect
                        0       -> eliminate that axis
                        negativ -> mirroring and scaling
  3. Type: rv-sizer .\models\abcblock.m (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found

               -30.0000000000 <= x <=         30.0000000000
                30.0000000000 <= y <=        -30.0000000000
               -30.0000000000 <= z <=         30.0000000000
  4. Type: rv-sizer .\models\abcblock.m sa=2 (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found
  5. Type: rv-sizer .\models\abcblock.m (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found

               -60.0000000000 <= x <=         60.0000000000
                60.0000000000 <= y <=        -60.0000000000
               -60.0000000000 <= z <=         60.0000000000
  6. Type rv-sizer .\models\abcblock.m sx=0.5 (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found
  7. Type: rv-sizer .\models\abcblock.m (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found

               -30.0000000000 <= x <=         30.0000000000
                60.0000000000 <= y <=        -60.0000000000
               -60.0000000000 <= z <=         60.0000000000
  8. Type: rv-sizer .\models\abcblock.m sy=0.5 sz=2 sz=0.25 (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found
  9. Type: rv-sizer .\models\abcblock.m (Enter)
    You should see: 
    RV-SIZER.EXE Version 1.00
8 Points found

               -30.0000000000 <= x <=         30.0000000000
                30.0000000000 <= y <=        -30.0000000000
               -30.0000000000 <= z <=         30.0000000000