 
  RA-MIXer 5.1 for Command & Conquer RED ALERT [ENGLISH/GERMAN/FRENCH]
               and Counterstrike               [ENGLISH/GERMAN/FRENCH]
               and The Aftermath               [ENGLISH/GERMAN]

  Copyright (C) 1997,1998 by Moritz Mertinkat (MoehrchenSoft)

  eMail: ramixer@gmx.net
  WWW 1: http://come.to/tesla                    (THE TESLA COIL)
  WWW 2: http://members.xoom.com/tesla           (THE TESLA COIL)
  WWW 3: http://home.t-online.de/home/moehrchen    (Turbo Pascal)
 

 Documentation [ENGLISH]
 

 CHAPTER 1: About RA-MIXer
   [1.1] Important notices
   [1.2] Files in this archive
   [1.3] Built-in viewers                  (NEW!)
   [1.4] MIX-Support
   [1.5] Hardware requirements
   [1.6] RAMIX.INI                         (IMPORTANT!)
   [1.7] Hotkeys
   [1.8] QuickInfo                         (IMPORTANT!)
   [1.9] RA-MIXer Style Sheets             (NEW!)
   [1.10] The BIG RA-MIX test

 CHAPTER 2: Tools in this package
   [2.1] Conversation tools
     [2.1.1] CPS => PCX
     [2.1.2] SHP => PCX
     [2.1.3] WSA => PCX
     [2.1.4] TMP/RMT => PCX
     [2.1.5] AUD => WAV and WAV => AUD
     [2.1.6] PCX => SHP
     [2.1.7] PCX => CPS
     [2.1.8] Palette converter
   [2.2] MIX-Fix!

 CHAPTER 3: RA-MIXer ADD-ONs               (VERY IMPORTANT!)
   [3.1] RAMView (MPR-viewer)
   [3.2] AUD Play

 CHAPTER 4: About MIX-files
   [4.1] General information
   [4.2] SHP-files
   [4.3] TMP-files
   [4.4] RMT-files
   [4.5] CPS-files
   [4.6] Palettes
   [4.7] VQA-movies
   [4.8] WSA-animations
   [4.9] AUD-audio-files
   [4.10] PCX-files (ZSoft)
   [4.11] MPR-files

 APPENDIX A: RA-MIXer versions
   [A.1] History
   [A.2] Support and bug-fixing

 APPENDIX B: Other information
   [B.1] The NEW MIX-format                (IMPORTANT!)
   [B.2] Official RA-MIXer Web-pages
   [B.3] Thanks

 


 CHAPTER 1: About RA-MIXer
 
 This program was written to extract the graphics, sounds and
 MIXs from MAIN.MIX. All files (in the MIX-files) have to be
 defined in NEWMIX.OFS - this is because the new MIX-header is
 encoded in any way, but I don't know how to decode it!

 If YOU have some information about RA-MIX-files, please contact
 me at: ramixer@gmx.net (Moritz Mertinkat) - THANX.....

 > Example on how to extract CONQUER.MIX from MAIN.MIX on the CD:
 >   (1) Start RA-MIXer from any directory on your HD.
 >   (2) Press ALT-F1 to change the drive (using the arrow-keys).
 >   (3) Move the cursor on MAIN.MIX and press ENTER
 >   (4) RA-MIXer should now read the MIX file and switch to
 >       MIX-Mode where should be able to see some files in MAIN.MIX
 >   (5) Select the file (e.g. CONQUER.MIX) you want to extract
 >   (6) and press "E" to start the extraction of that file
 >   (7) Enter [a path and] a filename and press Enter.


 > Download the LATEST version of NEWMIX.OFS from "THE TESLA COIL":
 > http://come.to/tesla


 [1.1] Important notices
 
 "Command & Conquer" and "Red Alert" are trademarks of Westwood
 Studios Inc., Copyright (C) Westwood Studios 1995/1996

 RA-MIXer is Copyright (C) 1997,98 by Moritz Mertinkat/MoehrchenSoft
 All rights reserved.

 The author is NOT responsible for any damages caused by RA-MIXer!!
 So, before modifying files make BACKUP copies of them!!

 RA-MIXer is Public Domain, that means you can freely distribute this
 program as long as all files in this package aren't modified in any
 way and all files in the filelist (section [1.2]) are included in
 this archive. If a file is missing, please contact me at:
 ramixer@gmx.net

 BTW: If you have some information about the RA-MIX-files, can you
      please email me???? THANX.

 My website at GeoCities was now hacked two times.... So I decided
 to set up a NEW TESLA COIL on some other (better) servers.
    http://come.to/tesla
    http://members.xoom.com/tesla
    http://members.freepage.de/tesla
    http://members.xoom.com/ramixer
    http://www.east-development.com/tesla

 If you want to include this program on a CD or on a disk of a computer-
 magazine, please get the authors permission: ramixer@gmx.net


 [1.2] Files in this archive
 
 The RA-MIXer 5.1 package should contain the following files:

   RAMIX.EXE           RA-MIXer 5.1 (Main program)
   RAMIX.INI           INI-file
   NEWMIX.OFS          Offsets and descriptions for MIX-files

   RAMIXGER.TXT        German documentation
   RAMIXENG.TXT        This documentation
   FILENAME.TXT        MIX Editing documentation
   VERSIONS.TXT        History of RA-MIXer

   CPS2PCX.EXE         CPS to PCX converter
   SHP2PCX.EXE         SHP to PCX converter
   WSA2PCX.EXE         WSA to PCX converter
   MPCX2SHP.EXE        PCX to SHP converter  (by Vladan Bato)
   PCX2CPS.EXE         PCX to CPS converter  (by Vladan Bato)
   RMT2PCX.EXE         RMT to PCX converter
   TMP2PCX.EXE         TMP to PCX converter
   AUD2WAV.EXE         AUD to WAV converter
   WAV2AUD.EXE         WAV to AUD converter
   PALCONV.EXE         Palette converter  (MS, JASC, NEO,...)
   MIXFIX.EXE          MIX-Fix! (please read [2.2])
   RMIXSITE.GIF        Official RA-MIXer Site 1998-logo
   *.PAL               Palettes

   RA-HD\RA-HD.EXE     RA-HD Installer 2.0
   RA-HD\RA-HD.TXT     Documentation for RA-HD and vdc
   RA-HD\RASTART.EXE   vIRTUAL dISk cHANGER 1.0 (PR)
   RA-HD\RASTART.DAT   vIRTUAL dISk cHANGER Data file
   RA-HD\SNOW_VTX.PAL  Red Alert palette (SNOW)
   RA-HD\TEMP_VTX.PAL  Red Alert palette (TEMPERAT)

   STYLES\*.RSS        RA-MIXer Style Sheets (please read [1.9])


 [1.3] Graphic-viewers
 
 RA-MIXer can read graphic-files of the following formats:
   * PCX (max. 2560x4096)
   * CPS (320x200-image)
   * WSA (320x200-animation)
   * SHP (small animations/structures/units)
   * TMP (Command & Conquer TeMPlates)
   * RMT (Redalert Map Tiles)
   * PAL (Palettes)
   * AUD (ADD-ON "AUD Play": Audio files)
   * MPR (ADD-ON "RA-MAP Viewer": Multiplayer maps and Missions)

 (The Add-Ons are NOT included in this archive; you have to download
  them seperatly from THE TESLA COIL or any other good RA site)

 Filetypes detected by RA-MIXer:
   RMX, MIX, SHP, RMT, TMP, CPS, PCX, WSA, VQA, AUD, PAL, MPR

 RA-MIXer NOW supports PCX-files!!
 In every graphics-viewer you can press "P" to change the palette.
 Note that all palette-files have to be defined in RAMIX.INI in
 the [PALETTE]-section.
 There are some more commands available in the SHP-viewer.
 By pressing the "B"-key you can toggle the background on or off.
 Press "S" to display the shadow (if there's one for the image).

 The PCX-viewer supports XMS and VESA. So you can even view
 large images (up to 8192x8192 pixel => scroll with cursor-keys)
 Without XMS, you cannot scroll the images. For this reason:
   if you don't have VESA, you can only view PCX-files with a
   max. size of 320x200 and with a VESA-card/-driver you can
   display images up to 640x480!

 To use the VESA viewer, a VESA BIOS (version 1.x and higher) or
 a VESA-driver (like UniVBE) is required.
 UniVBE can be downloaded from "THE TESLA COIL"!


 [1.4] MIX-Support
 
 To create a new MIX-file, simply go to the filemanager and press "C".
 (If you are in the MIX-viewer: press ESC).
 Then insert the desired name in the input field in the dialogbox
 and press ENTER (don't specify the file-extension ".MIX" or some-
 thing else)!
 Now select the new file and press ENTER to switch to the MIX-
 viewer. With the "A"-key (for Add) you can add new files to this
 MIX-file. After having pressed "A" (or "R" for replacing the
 selected file), you'll see a "light"-version of the filemanager.
    Here you can choose the file you want to add (or replace) -
 [if you have selected the file, press ENTER]!

 If you want to delete a file from your MIX-file, press "F8" or
 "Del" (and the selected file will be deleted)!

 All MIX-commands:
   - A        Add files
   - R        Replace the selected file
   - F8, Del  Delete the selected file
   - F4       Change QuickInfo
   - F6       Change ID (not necessary)


 [1.5] Hardware required
 
 RA-MIXer 5.1 requires a
  * i386-processor, 40 MHz (or a compatible 80x86 32-bit processor)
  * VGA-card with 512 Kb
  * 190 kilobyte of free conventional memory

 Recommanded is a
   * 486/Pentium-Processor with 60+ MHz
   * VGA/VESA-card with 1MB or above (==> faster)
   * XMS-driver (like HIMEM.SYS)
   * 300-350 kilobyte of free conventional memory


 [1.6] RAMIX.INI
 
 Section:
   [OPTIONS]
   Icons=no         (Possibilities are "yes" and "no")
   Style=nu95.rss   (Specifies the RA-MIXer Style Sheet file.
                     For more information, read chapter [x.x])

   [WSAPLAY]
   VRetrace=n       (n is a value between 0 and 20
                     This is the number of vertical retraces
                     between each frame.
                     If you have a fast (PCI-)graphics card you
                     should use 3 or 4 for n)

   [TESTSYSTEM]     (Possibilities for THIS section are "yes" and "no")
   CPU=yes          (Check CPU?)
   Bustype=yes      (Get BUS Type?)
   BIOS=yes         (Get BIOS date?)
   Windows=yes      (Is Windows(R) running?)
   MSCDEX=yes       (Is MSCDEX there?)
   VESA=yes         (Does your card support VESA?)
   XMS=yes          (XMS test: is XMS available [HIMEM.SYS loaded]?)

   [PALETTE]        (Specifies the palettes used by RA-MIXer)
   Pals=9           (Number of palettes. Maximum is 10)
   1=RA.PAL         (Filenames...)
   2=TEMPERAT.PAL
   3=DESERT.PAL
   4=RASETUP.PAL
   5=SETUP.PAL
   6=RASCORE.PAL
   7=SCORE.PAL
   8=MAP.PAL
   9=AFTRMATH.PAL
   Standard=1       (The palette that was used last)


 [1.7] Hotkeys
 
 Here's a list with all hotkeys available in RA-MIXer 5.1. In
 the program itself, you can press F1 to view the standard-hotkeys!

 Filemanager
    * F1          Help
    * F2          Change sortorder
    * F3          Text viewer
    * Alt+F3      HEX viewer
    * F4          Change QuickInfo
    * F6          Rename file/dir
    * F7          Create new directory
    * F8, Del     Delete file
    * ENTER       Change directory,
                  Start graphics viewer (if available),
    * Alt+F1      Change drive
    * SPACE, INS  Tag/unTag file
    * BACKSPACE   Switches between the current directory and
                  the directory from which you started RA-MIXer
    * R           Reread directory
    * H           Switches between the current directory and
                  the dir. which contains RAMIX.EXE (H = home)
    * I           Switch icons on/off
    * PLUS (+)    Tag all files
    * MINUS (-)   Untag all files
    * STAR (*)    Invert selection
    * Ctrl+\      CD \
    * Esc         Go back (if in "file-mode", then quit)
    * Alt+X       Exit RA-MIXer

 MIX-viewer
    * F1          Help
    * F2          Change sortorder
    * F3          Text viewer
    * Alt+F3      HEX viewer
    * F6          Changer ID
    * F8, Del     Delete file (from MIX)
    * E           Extract file
    * R           Replace file
    * A           Add a file (to MIX)
    * ENTER       Start graphics viewer or soundplayer (if available)
    * ESC         Go back (to filemanager)
    * Alt+X       Exit RA-MIXer


 [1.8] QuickInfo
 
 RA-MIXer's QuickInfo is a new enhancement to save descriptions and
 filenames directly to the MIX file (this works only with OLD MIX files;
 if you want to change the filenames/descriptions for new MIX files look
 in NEWMIX.OFS).
 To activate QuickInfo, just press F4 while you're in the MIX viewer!
 A dialog box will pop up where you can enter a filename and/or
 description for that file.

 Example:
   (1) Create a new MIX file (press "C" in the file manager)
   (2) Add a file to this new MIX
   (3) Move the cursor to file you've just added
   (4) Now, simply press F4 to change the description and
       filename of this file

 QuickInfo was developed to make MIX editing more easier for you!
 So, you can publish MIX files without using a second file for the
 descriptions and/or filenames!

 [The QuickInfo is stored using the ID 7FFFFFFF hex; so don't use
  this ID for normal files]


 [1.9] RA-MIXer Style Sheets
 
 RA-MIXer Style Sheets are files that contain lots of information
 about the colors and palettes which are used by RA-MIXer.
 Hereby you can easily change the appearence of RA-MIXer so it fits in
 your individuell purposes.

 You have (probably) already noticed that RA-MIXer 5.1 doesn't use the
 "classic" colors of the earlier versions any longer, but a new
 color pattern that is also used in a slightly different version
 by the Norton Utilities(R).

 If you don't like this style, you can also use the classic RA-MIXer
 colors again without any difficulties or you can even use a totally
 different and new style that come with RA-MIXer 5.1!

 RA-MIXer Style Sheets (with the internal version 1.0) have a file-
 size of 211 bytes and the extension ".RSS".

 To change the RA-MIXer colors to the classic color style again,
 please follow the four instructions below:
   (1) Load the file RAMIX.INI into an editor (either DOS or Windows)
       and search for the section "[OPTIONS]".

   (2) Add the following line to this section (or simply remove
       the semicolon before the line in RAMIX.INI):

       Style=styles\classic.rss

   (3) In this case "styles\" specifies the RA-MIXer Style Sheet
       directory, starting from the RA-MIXer directory (the directory
       that contains RAMIX.INI).
       If you've installed RA-MIXer in C:\RA-MIXER, for example,
       RA-MIXer tries to open the RMX Style Sheet file
       "C:\RA-MIXER\styles\classic.rss".

       (You can also use absolute pathes like
        Style=F:\DATEN\STYLES\SUPER.RSS)

   (4) Restart RA-MIXer....


  Here's a list of the Style Sheets that come with the RA-MIXer 5.1
  package (in the directory STYLES):

    CLASSIC  RSS  The classic RA-MIXer colors
    ADVANCED RSS  Advanced "classic RA-MIXer" colors #1
    ADVANCE2 RSS  Advanced "classic RA-MIXer" colors #2
    WIN95    RSS  Windows 95 standard look
    NU95     RSS  Norton Utilities for Win95 colors
    RIPPER   RSS  Colors from Sound-Ripper for RA
    SOFTBLUE RSS  Soft blue
    DRHARD   RSS  Dr. Hardware colors (standard)
    NC       RSS  Norton Commander look
    BW       RSS  Black & white
    CHRIS    RSS  Gray, gray, gray...
    NONAME   RSS  Can you find a name?

 Please also read chapter [1.6] about using the RAMIX.INI file.


 [1.10] The BIG RA-MIX test
 
 I've tested some of the tools/functions in the RA-MIXer 5.0 package:

 Replace-routine (in RA-MIXer)
  550 MB replaced
  ==> Result: Very fast as no temp-file is required, no errors!

 Add-routine
  600 MB added to MIX
  ==> Result: Very fast as no temp-file is required, no errors!

 Delete-routine
  90 MB deleted
  ==> Result: Good, no errors!

 AUD2WAV:
  400 MB AUD-files  (approx. 9 hours, 55 minutes)
  1.6 GB WAV-files  [11:00 p.m. and I'm tired....]
  ==> Result: WAV-quality is very good; fast; no errors!

 WAV2AUD:
  300 MB WAV-files
  75 MB  AUD-files
  ==> Result: Good; fast; no errors!

 SHP2PCX:
  15 MB SHP-files
  ?? MB PCX-files  (can't remember how many MBs...)
  ==> Result: Good; best compression (with PCX-compression); no errors!

 MPCX2SHP:  (by Vladan Bato)
  The problem with SHP-files > 64KB has been fixed by Vladan!
  ==> Result: Good; very fast; low compression



 CHAPTER 2: Tools in this package
 
 All tools described in this chapter may be distributed outside
 the original RA-MIXer package! So you can include them with your
 programs, cheats, etc.


 [2.1] Conversation tools
 
 The programs described in the sections below ([2.1.1]-[2.1.8])
 are usefull if you want to create your own graphics or sounds
 for Command & Conquer/Red Alert. As Command & Conquer/Red Alert
 cannot read all the graphics/sound formats, you must "convert"
 these files (to files that can be read by C&C/Red Alert).


 [2.1.1] CPS => PCX
 
 The CPS to PCX converter is Copyright (C) 1997,98 by Moritz Mertinkat.
 All Rights reserved. (ramixer@gmx.net).

 Syntax (cps2pcx.exe):
   cps2exe [option] <cpsfile[.cps]> [pcxfile[.pcx]]

 Options:
   /p:filename.pal  Specify a palette. If you don't use this option,
                    cps2pcx will use the palette from the CPS-file.


 [2.1.2] SHP => PCX
 
 The SHP to PCX converter is Copyright (C) 1997,98 by Moritz Mertinkat.
 All Rights reserved (ramixer@gmx.net).

 Syntax (shp2pcx.exe):
   shp2pcx <options> <shpfile[.shp]> [pcxfile[.pcx]]

 Options:
   /p:filename.pal  Specify a palette. If you don't use this option,
                    shp2pcx will use the standard-palette RA.PAL.
   /s               Convert with shadows
   /b               Convert with white background
   /i               Display information about the SHP-file.


 If you specify "pcxfile", then a name of up to 5 character should
 be used for this, as SHP2PCX will append a three-digit number for
 each frame. Otherwise, the last the characters are cut off.


 [2.1.3] WSA => PCX
 
 The WSA to PCX converter is Copyright (C) 1998 by Moritz Mertinkat.
 All Rights reserved (ramixer@gmx.net).

 Syntax (wsa2pcx.exe):
   wsa2pcx <options> <wsafile[.shp]> [wsafile[.pcx]]

 Options:
   /p:filename.pal  Specifies a palette. If you don't use this option,
                    shp2pcx will use the standard-palette RA.PAL.
   /i               Display information about the specified WSA file.


 [2.1.4] TMP/RMT => PCX
 
 The TMP/RMT to PCX-converter are (C) 1997 bei Moritz Mertinkat.
 All rights reserved (ramixer@gmx.net).

 Syntax (tmp2pcx.exe and rmt2pcx.exe):
   tmp2pcx <option> <tmpfile[.tmp]> [pcxfile[.pcx]] or
   rmt2pcx <option> <rmtfile[.rmt]> [pcxfile[.pcx]]

 Options:
   /p:filename.pal  Specify a palette. If you don't use this option,
                    the standard-palette RA.PAL is used.
   /i               Display info, do not convert.

 You can change the width and height of the TMP/RMT-image with
 the cursors. Press <ENTER> to convert the image.


 [2.1.5] AUD => WAV and WAV => AUD
 
 The AUD2WAV and WAV2AUD converter are (C) 1997,98 bei Moritz Mertinkat.
 All rights reserved (ramixer@gmx.net).

 Syntax (AUD2WAV-converter):
   aud2wav <auddatei[.AUD]> [wavdatei[.WAV]]

 Syntax (WAV2AUD-converter):
   wav2aud <wavdatei[.WAV]> [auddatei[.AUD]]

 NOTE: Only 22050 Hz, Mono, 16-bit (PCM) wav-files are supported!!
       These AUD/WAV-converter are the FASTEST available on the NET!


 [2.1.6] PCX => SHP
 
 The PCX to SHP converter is Copyright (C) 1995,96 by Vladan Bato.
 All Rights reserved (bat22@geocities.com).

 This utility converts a set of PCX files to a single SHP file.
 The names of the files should be composed of a base name of up
 to 5 characters plus a 3 digit number.
 For example : TEST001.PCX, TEST002.PCX,....

 Note also that all the PCX file should have the same dimensions
 (as all the frames in a SHP image must have the same width and height).
 The program won't check this, and will use the dimensions of the
 first PCX file.

 When specifying the source filename, use only the base name, without
 the numbers.

 Syntax (PCX2SHP-converter):
   mpcx2shp options source[.pcx] [dest[.shp]]

 The options are:
   -n:<NumImg>
     Specifies the total number of images. You must specify this option.

   -u1:<hhhh>
     Unknown header field 1, Hex (word)

   -u2:<hhhh>
     Unknown header field 2, Hex (word)

   -u3:<hhhhhhhh>
     Unknown header filed 3, Hex (longint)

 If you have problems with this tool, please contact Vladan!


 [2.1.7] PCX => CPS
 
 The PCX to CPS converter is Copyright (C) 1995,96 by Vladan Bato.
 All Rights reserved (bat22@geocities.com).

 This utility converts a PCX file to CPS.

 The PCX file must be a 256 color image and it must be 320x200 as
 these are the only dimensions supported by the CPS format.

 Syntax (PCX2CPS-converter):
   pcx2cps [-f] source[.pcx] [dest[.cps]]

 The -f switch is used to automatically fix the palette for the TITLE.PIC.

 The problem with the palette of TITLE.PIC is that if you change it
 (i.e., you replace TITLE.PIC with an image that has a different palette),
 the colors of the main menu will be garbled.

 C&C expects to find the green colors of the menu in certain positions
 of the palette, and will use whatever colors are there to display the
 menu. There are 25 such colors.

 The -f option will automatically fix the palette. It will replace those
 colors with the original ones, and approximate the replaced colors
 with those available.

 Sometimes this can produce odd results, but I can't do anything about it.

 If you have problems with this tool, please contact Vladan!


 [2.1.8] Palette converter
 
 The Palette converter is Copyright (C) 1997,98 by Moritz Mertinkat.
 All Rights reserved. (ramixer@gmx.net)

 Syntax (palconv.exe):
   palconv <inputfile[.pal]> [outputfile[.pal]]

 The palette converter is usefull for converting "standard palettes"
 (used by Red Alert) to JASC-palettes for using them in Paint Shop Pro!
 The following types are supported:
   - Standard palette files (raw data, without header, RGB-encoded)
   - Microsoft palettes
   - JASC palettes      (Paint Sho Pro)
   - NEOSoft palettes   (NeoPaint)


 [2.2] MIX-Fix!
 
 MIX-Fix! is Copyright (C) 1997,98 by Moritz Mertinkat.
 All Rights reserved. (ramixer@gmx.net)

 Syntax (mixfix.exe):
   mixfix <mixfile[.mix]>

 Some MIX files that were created with RA-MIXer 4.1 are NOT
 compatible with Red Alert and Command & Conquer!
 (There was a little bug in RA-MIXer 4.1... Sorry ;-)
 If you don't want to create all your MIX files again, just
 use MIX-Fix! to repair these MIX files!



 CHAPTER 3: RA-MIXer ADD-ONs
 
 At the moment, there are only two Add-Ons available for RA-MIXer.
 I think I'll release a VQA-Player as soon as I've figured out
 the VQA-format.
 All the Add-Ons can be downloaded from THE TESLA COIL:
 http://come.to/tesla

 If you want to write an Add-On for RA-MIXer, please contact
 me: ramixer@gmx.net


 [3.1] RAMView (MPR-viewer)
 
 This Add-On can be downloaded from THE TESLA COIL.
 Program: RAMView
 Version: 1.3 Standard

 To use this Add-On, just click on a MPR-file in RA-MIXer and
 RAMView will be started.
 In the viewer itself use the cursor-keys to scroll. ESC quits
 RA-MAP-view. If you want to zoom out/zoom in the map, simply press
 PLUS ('+') on the num pad!

 For more information please read RAMVIEW.TXT in the RA-MAP Viewer
 package!

 Note: RA-MAP Viewer 1.3 Professional will be released soon!
       This version was developed for "Power users", but is
       as fast as the Standard version and also easy to use.
       The difference is, that it works in high resolution
       modes only (640x480 or 800x600).
       RA-MAP View Professional also displays some of the map
       overlays like trees, gem stones, ore and walls.
       => Requires: i386, 2 MB RAM, VESA 1.x
       => Recommanded: Pentium, 2 MB RAM, VESA 2 with LFB


 [3.2] AUD Player
 
 This Add-On can be downloaded from THE TESLA COIL.
 Program: AUD Player
 Version: 1.0b (BETA Release)

 To use this Add-On, start RA-MIXer select an AUD-file, press ENTER
 and the AUD Player will be started.
 AUD Play was designed to run on Soundblaster and 100% compatible
 cards. Perhaps I'll add support for Gravis Ultrasound, Sound Man 16
 and Pro Audio later!
 The AUD Player Add-On should work with all Soundblaster types,
 including Soundblaster 1.0.

 The Audio Player uses the BLASTER environment variable to initialize
 the Soundcard correcly. Therefore, you've to define this variable
 via "set" in your AUTOEXEC.BAT!
 Example:
   SET BLASTER=A220 I5 D1

 Soundblaster at address 220h, using interrupt 5 and 8-Bit DMA 1.

 For further instructions please read AUDPLAY.TXT in the AUD Player package!


 CHAPTER 4: About MIX-files
 

 [4.1] General information
 
 The MIX-files contain almost everything: movies, small animations,
 map tiles like bridges, water, cliffs, sound-files, structures,
 vehicles and soldiers.
 RA-MIXer 5.1 can read both; the old C&C-MIX-files and the new
 RedAlert-MIXs.
 However, to read the new RA-MIX-files, RA-MIXer needs a filelist
 with the offset and the size of the files inside the MIX, as the
 header of those new MIXs is UNKNOWN.  ["Offset": a position in a file]
 The header is perhaps encoded with a random-number-generator.
 If you have information about the MIX-files, can you PLEASE
 email me??? My email-address is ramixer@gmx.net
    You will be mentioned in RA-MIXer and in this document as well.

 The formats (with header and compression) of all filetypes
 mentioned in sections [4.2]-[4.11] can be found on THE TESLA COIL:
 >> http://come.to/tesla


 [4.2] SHP-files
 
 The SHP-files contain multiple images or small animations like
 soldiers, vehicles, trees and structures.
 The images are compressed with Format40 or Format80 or encoded
 with Format20. These Formats are explained in Vladan Batos
 document about C&C-files (3rd release). SHP-files don't contain
 a palette-file. You can use TEMPERAT.PAL for almost all old
 C&C-files and RA.PAL for the RED ALERT-SHPs.


 [4.3] TMP-files
 
 The TeMPlate-files contain all the map-tiles. Every TMP-file
 has a size of 24x24 pixels. The image is NOT compressed and
 there's no palette. You have to use TEMPERAT.PAL for TEMPERAT-tiles,
 WINTER.PAL for WINTER-tiles and DESERT.PAL for DESERT-tiles ;-).

 NOTE: There's no hint to the dimension of TMP-files, so
       you have to try...)


 [4.4] RMT-files
 
 The same as the TMP-files under RedAlert. The only thing that
 changed is the header. I called this files RMT for
 "R"edalert "M"ap "T"iles, because I figured out this format.
 If you need a documentation on these files, please contact me!


 [4.5] CPS-files
 
 CPS-files contain 320x200 pixel-images. The CPS-files may
 or may not contain a palette (all CPS-images that can be found
 in Red Alert have a palette). The only exception are those found
 in \SETUP\SETUP.MIX on the CD. The CPS-files are compressed with
 Format80.


 [4.6] Palettes
 
 Standard-palette-files have a size of 768 bytes. The palette
 information is stored in a Red,Green,Blue record. So, for
 256 colors the size is  256*3 = 768.

 This RA-MIXer package contains a program (PALCONV.EXE) that convert
 between "Standard", JASC (PSP), NeoPaint and Microsoft-palette files.
 So, If you want to convert RA.PAL (for use in Paint Shop Pro) just
 type "palconv.exe ra.pal rapsp.pal" and follow the instructions on
 the screen.


 [4.7] VQA-movies
 
 The VQA-files are used for movies. They conatain graphics and
 sounds. The graphics are compressed with Format80 or uncompressed.
 For more detail, see Aaron Glover's documentation on VQA-files,
 which can be found either on Vladan's Command & Conquer Page
 >>  http://come.to/tesla
 or on my homepage.


 [4.8] WSA-animations
 
 The WSA-files contain small animations like the spinnig earth or
 the mission selection. All WSA-files are 320x200 pixels large.
 The graphics are first compressed with Format80 and then with
 encoded with Format40.
 These files can be found in CONQUER.MIX and GENERAL.MIX (RMX).


 [4.9] AUD-audio-files
 
 This version of RA-MIXer now supports AUD-files!!
 There's even an AUD-Player that works with almost all Sound-
 blaster cards (or with a 100% SB-compatible Soundcard).
 For more detail go to section [NONE].


 [4.10] PCX-files (ZSoft)
 
 The PCX-files (256-colors, ZSoft-format) are only used in the
 Red Alert for Windows 95 (RA95.EXE), as this version requires
 pictures with a size of 640x400-pixel (the CPS-format can only
 store graphics with 320x200 pixel).

 => You'll find the PCX-files in REDALERT.MIX and in EXPAND.MIX
    (from "Counterstrike").


 [4.11] MPR-files
 
 The MPR files contain multiplayer or mission maps (for missions,
 the extension is .INI). The map data is first compressed with
 Format 80 and then encoded with Base64 (so you can send them over
 the INTERNET [like email attachments]).



 APPENDIX A: RA-MIXer versions
 

 [A.1] History
 
 [= Version 1.0 == 1.Feb.1997 =]
   First release to the public domain.
   This version can only read MIX (RA), SHP and RMT-files.

 [= Version 1.1 == 2.Feb.1997 =]
   Fixed bug with offset of CONQUER.MIX in MAIN.MIX

 [= Version 2.0 == 12.Feb.1997 =]
   RA-MIXer has been totally REWRITTEN!
   A lot of new features and other improvements (and BUG-FIXING):
     * CPS and TMP support
     * old MIX-file support
     * a PAL-file viewer
     * CPS to PCX-converter
     * SHP to PCX-    "
     * RMT to PCX-    "
     * TMP to PCX-    "

 [= Version 2.1 - 2.5 (BETA 3.0) == 1.-10.Mar.1997 =]
   Bugfixing and about 350 NEW offsets (icons)

 [= Version 3.0 == 20.Mar.1997 =]
   * FULL WSA-support
   * Icons (directory/file - press "I" to switch on/off)
   * 400 NEW offsets
   * 270 Offsets for "Alarmstufe Rot" [GERMAN-version]
   * Improved "Exctract"-function (status bar etc...)
   * SHP to PCX-converter 1.2
   * RA-HD Installer 1.0

 [= Version 4.0 == 18.Jun.1997 =]
   No BUG-FIXING as there weren't any bugs!
   * Replace function for OLD MIX-files
   * PCX-viewer (scrollable, supports VESA and XMS)
   * AUD2WAV and WAV2AUD-converter
   * AUD/VQA/PCX-detection
   * Offsets for AUD/VQA/PCX-files
   * Palette-Converter 1.0 (Microsoft/JASC/NEO/standard-pal support)
   * Over 100 offsets for Counterstrike
   * RA-HD Installer 2.0 (GERMAN/ENGLISH, supports Counterstrike)
   * PCX2SHP and PCX2CPS-converter (thanks to Vladan Bato)
   * RAMIX.OFS 4.00
   * All offsets for the German Red-Alert version (AND German Counterstrike)

 [= Version 4.1 == 28.Jun.1997 =]
   No BUG-FIXING as there weren't any bugs!
   * Create MIX-files
   * Replace function for old MIX-files (improved)
   * Add files (to MIX)
   * Delete files (from MIX)
   * Change ID
   * Filemanager improved
     - Rename file/dir
     - Create new directories
     - Delete files
   * RA-HD Installer 2.0 (GERMAN/ENGLISH, supports Counterstrike)
   * All offsets for the German Red-Alert version (AND German Counterstrike)
   * Over 1200 new FRENCH offsets!
   * PCX2SHP 1.3 (now compatible with PCX2SHP)
   * BBS Ready (with "FILE_ID.DIZ")
   * RAMIX.OFS 4.10

 [= Version 5.0 == 15.Nov.1997 =]
   Fixed a stupid bug in the "Add to MIX"-routine. Now you can create
   MIX-files that will WORK with RA (and C&C)!!!!
   * Optimized RA-MIXer a lot!
   * Offsets for Aftermath!
   * Text viewer
   * AUD detection
   * AUD Player (AUDPLAY 0.9b, ADD-ON)
   * QuickInfo
     - change description while you're in RA-MIXer
     - even stores filenames
   * MPR detection (for muliplayer maps and missions)
   * MPR Viewer (RAMVIEW 1.2 PRO, ADD-ON)
   * Filemanager improved
     - Tag/Untag files
     - Delete tagged files
   * PCX viewer improved (max. res: 2560x4096)
   * SHP2PCX 1.1 (by Vladan Bato)
   * RA-HD Installer 1.4 (GERMAN/ENGLISH/FRENCH)
   * BBS Ready (with "FILE_ID.DIZ")
   * Offset file v5.00 (NEWMIX.OFS)
   * ...and a lot of other improvements!


 [= Version 5.1 == 24.Mar.1998 =]
   * Over 6900 offsets for 65 RA-files!
   * All offsets for The Aftermath [ENG/GER]!
   * New offsets for Red Alert [GER]
   * RA-MIXer Style Sheets
   * PCX Viewer improved
     - Max. res: 8192x8192 Pixel
     - about 190-300% faster
     - now works with VESA 1.x
   * Quick Info improved
   * WSA to PCX converter
   * Fixed a bug in WAV to AUD 1.1
   * RA-HD Installer 2.0 [GERMAN/ENGLISH/FRENCH]
     - Virtual Disk Changer (PRE-RELEASE 1)
       Play Counterstrike and The Aftermath from your hard disk!
   * BBS Ready (with "FILE_ID.DIZ")
   * Offset file v5.10 (NEWMIX.OFS)
   * ...and of course some improvements you can't see!



 Future extensions:
   * FULL RA-MIX-FILE SUPPORT
   * VQA support (with SOUND)
   * C&C-map to RA-map converter?
   * RA-MIXer for Windows 95.....


 [A.2] Support and bug-fixing
 
 Attention! Some MIX files created by RA-MIXer 4.x aren't
 compatible with RED ALERT (and Command & Conquer). So, if you
 have problems with these MIX files, please read section [2.2]
 on how to fix the MIX files!

 If you have questions around RA-MIXer or you've found a bug :-(,
 simply contact me.
 All known BUGs are and will be published on THE TESLA COIL - The
 Home of RA-MIXer (http://come.to/tesla)!

 There you can also find the LATEST version of RA-MIXer and updates!

 If you don't get a reply within three weeks I'm (probably) on vaction
 (or ...I didn't receive your email... :-)



 APPENDIX B: Other information
 
 Yep, if someone needs information on a C&C/RA file format, please
 contact me. Or check out THE TESLA COIL:

   http://come.to/tesla   or   http://members.xoom.com/tesla

 There you can download a document about C&C files. In this document
 Vladan Bato explains all the C&C formats which are known.
 In one or two weeks there will be also a textfile about decoding
 VQA-movie-files.

 Note that my ENGLISH isn't very good...... :-(
 If you would like to correct my mistakes: ramixer@gmx.net


 [B.1] The NEW MIX-format
 
 The format of those new RMIX-files is UNKNOWN! For this reason,
 RA-MIXer can only read the new MIX-files if the offsets (positions
 of files in a MIX-file) are defined in NEWMIX.OFS!

 The RMIX Header is probably encoded with a random-number generator,
 but it includes at least:
  * The offsets of the files, from the start of the body.
  * The lengths of the files
  * The ID, calculated the same way C&C does it

 I think the "easiest" way to decrypt the header is to disassemble
 the GAME.DAT file (GAME.DAT is an EXE file!).


 [B.2] Official RA-MIXer Web-pages
 
 Official RA-MIXer sites
  http://come.to/tesla                                  (THE TESLA COIL)

  http://www.gametemple.com/ra                          (RA GAMETEMPLE)
  http://www.geocities.com/TimesSquare/Arcade/4837
  http://www.geocities.com/TimesSquare/Arcade/5553      (CONSTRUCTION YARD)
  http://www.geocities.com/TimesSquare/Arcade/5416
  http://www.geocities.com/TimesSquare/Arcade/8131
  http://www.geocities.com/TimesSquare/Arcade/9210
  http://www.geocities.com/TimesSquare/Castle/3993
  http://www.geocities.com/TimesSquare/Dungeon/6610
  http://www.geocities.com/SiliconValley/Lakes/9980
  http://www.geocities.com/SiliconValley/Pines/7845     (RED ALERT MAPS)
  http://www.stchris.force9.co.uk/john/ra
  http://www.rio.com/~goforth/redalert.html
  http://www.top.net/kvnj/RedAlert
  http://www.users.globalnet.co.uk/~alpat/red.htm
  http://www.igl.net/ra
  http://members.aol.com/cc2ra/index.htm
  http://www.mother.com/~erichull/red.htm
  http://members.tripod.com/~Calgarian/rafiles.html
  http://www.cybermail.net
  http://www.geocities.com/TimesSquare/Arcade/2066/ra.html
  http://www.geocities.com/TimesSquare/Alley/9290
  http://www.matthew-b.demon.co.uk/games/ra
  http://www.geocities.com/TimesSquare/5611
  http://www.algonet.se/~chriswe
  http://www.sci.fi/~jusas/redalert/redalert.html
  http://www.hn.pl.net/seager/ra/index.html
  http://www.geocities.com/TimesSquare/7241
  http://www.geocities.com/SiliconValley/Way/1910/ra.htm
  Computer Games Forum on the Microsoft Network (MSN)

 Other links at http://come.to/tesla


 [B.3] Thanks
 
 Thanks to the following persons, which helped me developing RA-MIXer:

   * Vladan Bato for helping me with the SHP-compression
     and -of course- for his AUD-documentation.
     Email: bat22@geocities.com
   * Pascal Martin for ALL the French offsets!
     EMail: Feedback.Pascal.Martin@wanadoo.fr
   * Iain Lattimer for the Counterstrike-offsets in GENERAL.MIX!
     EMail: Iain@ibrus.demon.co.uk
   * Thomas Muthman for the German MIX-offsets in MAIN.MIX
     EMail: <He doesn't want his email-address to be published>
   * Mix - I've used some AUD-descriptions from his Sound-Ripper
     EMail: mix@lim.dsi.unimi.it
   * Christian Scheuermann for helping me with the FIRST SHP offsets,
     for his text viewer and of course for ALL Aftermath MPR-offsets!
     EMail: KDSerb@t-online.de (Konstruktionsbuero D. Scheuermann, Erbach)
   * Sh4d for some MIX-offstes in MAIN.MIX
     EMail: lecmax20@clic.net
   * Thanks to Linus Wiklund, for the mission-offsets in RA-GENERAL.MIX!!
     EMail: alwi.1176@nynashamn.mail.telia.com
   * William C. Vest for the MAIN.MIX offsets of The Afthermath
     EMail: hissky@cybertron.com
   * Jens Hartmann for "testing" RA-MIXer
     EMail: Jens.Hartmann@gmx.de (hey, keep on testin'!)


