                      AUD Conversion Utilities

AUD2WAV v1.2
WAV2AUD v1.2
AUDINFO v1.1

by Vladan Bato <bat22@geocities.com>

====================
1. Copyright Notice
====================

   Command & Conquer is a trademark of Westwood Studios, Inc.
   and Copyright (C)1995 Westwood Studios, Inc.
   Command & Conquer: Red Alert is a tradmark of Westwood Studions, Inc.
   and Copyright (C)1995-96 Westwood Studios, Inc.

   The AUD2WAV, WAV2AUD and AUDINFO utilities are
   Copyright (C)1997-1998 Vladan Bato. All rights reserved.

   You can freely distribute this utilities as long as you respect
   the following restrictions:
     a)  That no changes are made to any of the files, and that all the
         files (AUD2WAV.EXE, WAV2AUD.EXE, AUDINFO.EXE and README.TXT) are
         included.
     b)  That no charge is made for copying or distribution of this program
         and its associated files (beyond reasonable access fees).
     c)  It may not be included on cdrom compilations or magazine cover
         disks without the author's express permission.

   If you want the permission to include this program on a cdrom compilation
   or magazine cover disk, write to me at the following e-mail address:
      bat22@geocities.com

==============
2. Disclaimer
==============

   - I provide this programs as-is, without any warranties. I can't guarantee
     that they work as described in this document or that they work at all.
     I also can't guarantee that I will provide any support for these
     programs.

   - Use these programs at your own risk. I can't be held responsible for
     any damage caused directly or indirectly by these programs.
     For your own safety, back up any files before modifying them.

   - By modifying the C&C or Red Alert files you might be violating
     Westwood's copyright. I cannot be held responsible for any copyright
     violations that may arise from the use of these programs.
     It's entirely your responsibility.

==============
3. What's New
==============

In this version I have fixed the WAV2AUD program. The previous version of
the program generated a "pop" sound at the end.
I finally discovered where the problem was and fixed it.

===============
4. Description
===============

First a few words about the AUD files :

The AUD files in Red Alert use the same format as those in C&C so you can
use these programs on them too (as long as you can find a program that will
extract the AUD files from Red Alert's MIX files).

In C&C there are basically two types of AUD files. The majority of the files
use the IMA-ADPCM compression for 22kHz, 16-bit, mono sounds.

There's another compression type for 8-bit sounds which is used primarily
for death screams. This is a Westwood's proprietary compression and I don't
know how it works.
That's why the utilities won't work on these files.

AUDINFO :
----------
  These utility displays information (sampling frequency, compression, etc.)
  about the specified AUD file(s) (you can use whildcards).
  The two compression types are indicated by ADPCM and WWC. The conversion
  utilities work only on ADPCM files.

AUD2WAV :
----------
  This utility converts an AUD file to WAV format. It creates an
  uncompressed WAV file that will be approximately four times larger than
  the original AUD file.

  It works only on 16-bit, mono AUD files compressed with the IMA-ADPCM
  algorithm.

WAV2AUD :
----------
  This utility converts a WAV file to AUD format. It will compress it
  with IMA-ADPCM algorithm so the AUD file will be four times smaller.

  It works only with 16-bit, mono, uncompressed (PCM) WAV files. If your
  WAV file is 8-bit, stereo or compressed, please convert it to the above
  format, first.

  Note that all the AUD files in C&C and Red Alert are sampled at 22kHz.
  I have tried different sample rates in C&C, and found out that 11kHz
  works but 44kHz doesn't.
  I'd suggest that you use the 22kHz frequency to avoid potential problems.

  Another quick note : The WAV file must not contain multiple blocks (data
  and silence blocks). If you have such a file try converting it to a plain
  WAV with some wave editing program (such programs usually make a plain WAV
  file when saving). The WAV2AUD utility should be able to cope with comments
  in the WAV and some extra headers, but I haven't tested it.

  Should you have any problems, please e-mail me at :
    bat22@geocities.com

  Also, check out my homepage for any updates or additional info :
    http://www.geocities.com/SiliconValley/8682

  On these pages you can also find a document describing the format of
  the AUD files and the IMA-ADPCM compression.

===========
4. Credits
===========

Before you start thinking that I decoded the AUD files myself, I must tell
you the truth.
Actually it's Douglas McFadyen <DougMc@Attachmate.com> who decoded the
AUD files. Without his help I would never be able to completely work out
the file structure and the implementation of the IMA-ADPCM compression.

Thank you very much Doug !

Many thanks also to Moritz Mertinkat <Moehrchen@T-Online.de>. Without his
insistency I'd never had the will to write these utilities or the AUD
document.


Vladan Bato
bat22@geocities.com
http://www.geocities.com/SiliconValley/8682
