home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / sndbords / proaudio / mvdoc / cmpwav.doc next >
Text File  |  1992-10-22  |  3KB  |  103 lines
  1. CMPWAV - Compress .WAV Files
  2.  
  3.  
  4. Syntax
  5.  
  6.     cmpwav sndfile
  7.  
  8.     cmpwav [-amw] sndfile
  9.  
  10.     cmpwav sndfile.wav
  11.  
  12.     cmpwav source[.wav] [target[.wav]]
  13.  
  14.  
  15. Options
  16.  
  17.     a    - use ALAW method
  18.     m    - use MULAW method
  19.     w    - use MSADPCM method
  20.  
  21. Usage
  22.  
  23.     Use "cmpwav" to compress and uncompress .wav files using 
  24.     any one of a variety of different formats.  
  25.  
  26.         The program will compress uncompressed files,
  27.         and uncompress compressed files.
  28.  
  29.     The program will compress/uncompress a file "in-place",
  30.     by first saving the output in a temporary file, then
  31.     removing the target file (if it exists) and renaming the
  32.     file containing the generated output.
  33.  
  34.         If the eventual output file is read-only, the
  35.         program will change the file attribute, remove
  36.         it, rename the temporary file, then reset the
  37.         read-only attribute.
  38.  
  39.     The program will prompt for a compression method, unless a
  40.     method is specified on the command line or if the program is
  41.     going to uncompress the file.
  42.  
  43.     The program "tpcm.exe" is synchronized with this program, in
  44.     that what cmpwav writes, tpcm will read.  (Use "tpcm" to 
  45.     play and display .wav files, after loading the TSR "pcm.com".)
  46.  
  47.  
  48. Examples
  49.  
  50.     C:> cmpwav sndfile
  51.  
  52.     This example will cause the program to look for the file
  53.     "sndfile.wav", prompt for a compression method, then perform 
  54.     the action and save the output in the same file "sndfile.wav", 
  55.     assuming "sound.wav" is an uncompressed file.
  56.  
  57.     If the file "sndfile.wav" is already compressed, then the
  58.     the program will uncompress the data back into "sndfile.wav".
  59.  
  60.     C:> cmpwav -a sound.wav
  61.  
  62.     This command will compress the data in the file "sound.wav"
  63.     using the ALAW method, saving the output in "sound.wav".
  64.  
  65.     C:> cmpwav -a sound soundcmp
  66.  
  67.     This command will compress the data in the file "sound.wav"
  68.     using the ALAW method, saving the output in "soundcmp.wav".
  69.  
  70.  
  71. Limitations
  72.  
  73.     Compresses 16-bit files only.
  74.  
  75.     Can not "uncompress" and "compress" in the same command;
  76.     that is, will not read a file compressed with one format,
  77.     uncompress it and generate a compressed file in another
  78.     or different format.
  79.     
  80.  
  81. Caveats
  82.  
  83.     Attempts to process files not conforming to its requirements
  84.     (non 16-bit files, unrecognized formats, etc.) may generate
  85.     unpredictable results, although every attempt has been made
  86.     to eliminate crashes, hangs and lock-ups.
  87.  
  88.     ADPCM Compression Algorithm: Microsoft Corporation 8/20/1992
  89.     From the Multimedia Standards Update 8/20/92  
  90.  
  91.     MULAW, ALAW, IMA Compression Algorithms: various public domain
  92.     sources.
  93.  
  94.     We use wavformat.fmttag == 3 for "IMA", whereas this value has
  95.     not been defined by Microsoft;  this may cause incompatibilty
  96.     problems in the future.
  97.  
  98. =======================================================================
  99. Copyright (c) 1992.  Media Vision, Inc.  All Rights Reserved.
  100. Programmers: Bart Crane, Shao Ma
  101.  
  102.  
  103.