home *** CD-ROM | disk | FTP | other *** search
/ Internet MPEG Audio Archive / IMAA.mdf / UTIL / DOS / L3V100 / MANUAL.TXT < prev    next >
Encoding:
Text File  |  1994-07-18  |  8.9 KB  |  204 lines
  1. Manual.txt for Version 1.00 of ISO/MPEG Audio Layer 3 software only 
  2. encoder/decoder for PCs.
  3.  
  4. 1. ENCODER
  5.    =======
  6.  
  7.  L3ENC.EXE is an ISO/MPEG Layer III software only encoder. It takes 
  8.  PCM audio data files as input and delivers Layer III coded bit stream 
  9.  files as output. Several options can be selected via command line 
  10.  switches. Usage:
  11.  
  12.    L3ENC <PCM audio data> <bitstream> [-switch1 [-switch2 [...]]]
  13.  
  14.  L3ENC.EXE should work on any IBM PC compatible computer with a 386 type 
  15.  CPU or better with external or built in 387 hardware floating point 
  16.  support. A 486DX CPU or better is recommended.
  17.  
  18.  L3ENC uses one of the Dos extenders EMX.EXE or RSX.EXE supplied together 
  19.  with this shareware package. EMX.EXE is used for Dos Real Mode and RSX.EXE
  20.  is used for V86 Mode (e.g. Dos Box under Windows). L3ENC automatically 
  21.  loads the appropriate extender when started. In order to find the extender, 
  22.  L3ENC needs the environment variables EMX and RSX. So before you start
  23.  L3ENC, please execute the commands:
  24.    SET EMX=C:\PATH\EMX.EXE
  25.    SET RSX=C:\PATH\RSX.EXE
  26.  where "C:\PATH\" shows the directory where EMX.EXE and RSX.EXE can be found.
  27.  
  28.  EMX.EXE is copyright by Eberhard Mattes and RTX.EXE is copyright by
  29.  Rainer Schnither. Please read the documentation supplied with the 
  30.  dos extenders for details.
  31.  
  32. 1.1 PCM audio input file
  33.  The first command line argument specifies the name for the PCM audio
  34.  data file. Version 1.00 of the encoder accepts either raw PCM audio 
  35.  data files or PCM audio data files in RIFF/WAVE format as used by
  36.  Microsoft Windows. The samples must be 16 bit signed integer values.
  37.  The sampling rate must be 44.1 kHz.
  38.    
  39.  A) raw PCM audio data
  40.     By default the input file is assumed to contain raw PCM audio data.
  41.     Stereo audio data is input in interleaved format, the first channel
  42.     beeing the left channel.
  43.       <sample #1 channel #1> <s. #1 ch. #2> <s.#2 ch.#1> <s.#2 ch.#2> ...
  44.     Mono audio data has the format
  45.       <sample #1> <sample #2> <sample #3> ....
  46.     Whether the input file is treated as mono or stereo audio data is set
  47.     by the encoding mode parameter (1.3). Default is stereo.
  48.  
  49.  B) RIFF/WAVE format
  50.     If the '-wav' option is specified, the input file is assumed to contain
  51.     16 bit PCM audio data in RIFF/WAVE format as used by Microsoft Windows.
  52.     Audio parameters are extracted from the Wave header and checked against
  53.     the settings of the encoder. If not supported options are found 
  54.     (e.g. 8 bits/sample), the encoding process is aborted. The encoding
  55.     mode (mono or stereo) is determined by the settings in the WAVE header.
  56.  
  57. 1.2 bitstream output file
  58.  The second command line argument specifies the name for the bitstream 
  59.  output file. As for now there is no default value for the filename or for 
  60.  the extension of the file name. The format of the bit stream is as defined 
  61.  in the ISO/MPEG publication IS11172-3.
  62.  
  63. 1.3 encoding mode
  64.  Depending on the setting of the '-mod' switch, the encoder will treat the 
  65.  two input channels as:
  66.     -mod 1  stereo (joint stereo),
  67.     -mod 2  mono audio data.
  68.  
  69.  Default is joint stereo. 
  70.  For stereo, the first channel is the left channel. The second channel is 
  71.  the right channel.
  72.  
  73.  If input files in WAVE format are used, the encoding mode is determined by
  74.  the settings in the Wave header.
  75.  
  76. 1.4 sampling rate
  77.  Version 1.00 of the encoder is still restricted to 44.1 kHz.
  78.  Look for support of 32kHz, 44.1 kHz and 48 kHz in the near future.
  79.  
  80. 1.5 bitrate
  81.  The bitrate of the bit stream output is selected via the '-br' switch.  The 
  82.  bitrate is specified in bits/second. The bitrate is the total bitrate for 
  83.  all encoded channels, i.e. if you select 'br 128000' and 'stereo', both 
  84.  channels will be stuffed into one bit stream of 128000 bits/second. 
  85.  Currently only ISO bit rates are accepted by the encoder. Valid bit rates 
  86.  are:
  87.  
  88.  32k  40k  48k  56k  64k  80k  96k  112k  128k  160k  192k  224k  256k  320k   
  89.  
  90.  The default bitrate is 128000 bits/sec.
  91.  
  92.  Version 1.00 of the encoder is restricted to stereo bit rates greater 
  93.  than 64 kBit/s and to mono bit rates less than 320 kBit/s. 
  94.  
  95. 1.6 crc check
  96.  If '-crc' is asserted, ISO/MPEG1 crc checking is enabled. Without the 'crc' 
  97.  switch, crc checking is disabled.
  98.  
  99. 1.7 swap low and high byte of input samples
  100.  If the '-tfs' option is specified, the low and high bytes of each audio
  101.  data input sample are swapped. Use '-tfs' if you move your PCM audio data
  102.  from little endian to big endian machines (or vice versa).
  103.  
  104. 1.8 examples of switch settings
  105.     L3ENC infile.pcm out.bit -br 112000 -cr
  106.     L3ENC c:\music\pcm\newage.pcm c:\bitstr\l3\newage.bit -mod 2 -br 64000
  107.     L3ENC pop.wav -wav -br 96000
  108.  
  109.  
  110. 2. DECODER
  111.    =======
  112.  
  113.  L3DEC.EXE is an ISO/MPEG Layer 3 software only decoder. It takes 
  114.  Layer 3 bit stream files as input and delivers PCM audio data files 
  115.  as output. A number of options can be selected via command line 
  116.  switches. Usage:
  117.  
  118.     l3dec <bit_stream> [<PCM_audio_data>] [-switch1 [switch2 [...]]]
  119.  
  120.  L3DEC.EXE should work on any IBM PC compatible computer with a 386 CPU 
  121.  or better with external or built in 387 hardware floating point support.
  122.  
  123.  If you specify no output file name, the bit stream is nevertheless 
  124.  (partially) decoded but PCM audio output is discarded. This option is 
  125.  only useful, if you want to check the correct format of a a bit stream 
  126.  file without actually producing any output. And yes --- this is much 
  127.  faster than the full decoding process.
  128.  
  129. 2.1 bit stream input file
  130.  The format of the bit stream input file must comply with ISO/IEC
  131.  IS11172-3. Currently there is no default file name extension.
  132.  
  133.  The decoder will process all valid MPEG1 Layer3 bit stream data 
  134.  without restrictions to bit rate or sampling frequency.
  135.  
  136. 2.2 PCM audio data output file
  137.  Audio data is output as samples of 16 bit signed integer PCM data. 
  138.  The default format is raw PCM data and can be either one channel or 
  139.  two interleaved channels.
  140.     format of one (mono) channel PCM audio data:
  141.         <sample #1><sample #2>....
  142.     format of two channel (stereo) PCM audio data:
  143.         <spl.#1 ch.#1><spl.#1 ch.#2><sp.#2 ch.#1><spl.#2 ch.#2>...
  144.  If one or two audio channels are used depends on the encoded information in 
  145.  the bit stream. For stereo output data the first channel is the left 
  146.  channel. Information about sampling frequency and number of used channels 
  147.  is displayed at the beginning of the decoding process.
  148.  
  149. 2.3 RIFF/WAVE format
  150.  If selected by the '-wav' switch, audio data is output in RIFF/WAVE format 
  151.  (*.WAV) as used by Microsoft Windows. The audio data itself is still 
  152.  written as 16 bit PCM data as described in 2.2 but it is preceded by a 
  153.  WAVE-header. The WAVE-Header contains information about the number of 
  154.  channels (1 or 2), sampling frequency (32k/44.1k/48k) and used bits per 
  155.  sample (16).
  156.  
  157. 2.4 [Sound Header]
  158.  If selected by the '-snd' switch, audio data files are output in
  159.   [description of audio format]
  160.  
  161. 2.5 skip frames
  162.  With the '-fb' option you can skip a number of frames in the bit stream 
  163.  before the decoding starts. '-fb nnn' skips the first nnn frames. Each 
  164.  frame contains 1152 samples of audio data. Depending on the used sampling 
  165.  frequency, the duration of a frame is calculated as 24 msec (@ 48kHz), 26.1 
  166.  msec (@ 44.1kHz) or 36 msec (@ 32kHz). 
  167.  
  168. 2.6 decode only nnn frames
  169.  If you want to decode only a certain number of frames, specify the '-fn' 
  170.  option. '-fn xxx' will decode only xxx frames (see also 2.5).
  171.  
  172. 2.7 search again after loss of synchronisation
  173.  Normally the decoding process is stopped, if a loss of synchronisation is 
  174.  detected, i.e. the synch information is incorrect. To enable decoding of 
  175.  partially damaged bit stream files, you may assert the '-sa' option. In 
  176.  this mode the decoding is not stopped and the file is searched for valid 
  177.  synch information until end of file is encountered.
  178.  
  179. 2.8 write audio data as ascii hex 24bit output file
  180.  If the option '-h24 xxx' is specified an (additional) output file with 
  181.  name 'xxx' is opened. PCM Audio data is output as 24 bit ascii hex values
  182.  followed by carriage return and line feed. Accuracy of the output values
  183.  is 24 bit compared to the 16 bits raw output mode. Files output in 
  184.  'h24' format take four times the storage capacity necessary for raw 
  185.  16bit output format.
  186.  
  187. 2.9 ignore error messages
  188.  If errors in the bit stream are detected, the decoding process is normally
  189.  halted. If the '-ign' option is specified, the decoder tries to continue 
  190.  with the decoding process.
  191.  
  192. 2.10 accept free format bitstream
  193.  If the '-ff' option is specified, a free format bitstream is accepted.
  194.  
  195. 2.11 ancillary data
  196.  If the bit stream contains ancillary data (user data integrated into
  197.  the bit stream) the decoder can write this data into an ancillary 
  198.  data file. Ancillary data will be supported in a future version of the
  199.  encoder.
  200.  
  201.     
  202. All brand names are registered trade marks of their respective owners.
  203.  
  204.