home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / datatypes / fp_adpcm / hifi2adpcm / hifi2adpcm.doc < prev    next >
Text File  |  1997-07-30  |  4KB  |  142 lines
  1.  
  2.                     -----------------------------------
  3.                     *** Flowerpower's ADPCM package ***
  4.                     -----------------------------------
  5.  
  6.                          Hifi2ADPCM documentation
  7.  
  8.                This software package is in the public domain.
  9.                        Do with it whatever you want.
  10.  
  11.  
  12.  
  13. Introduction
  14. ------------
  15.  
  16. This  program  can convert HIFI Stereo and Mono music data to ADPCM format.
  17. Its  main  purpose  is to convert CD-DA data and decoded MPeg audio file to
  18. ADPCM format.
  19.  
  20.  
  21. Technical Info
  22. --------------
  23.  
  24. This  program  will  either  read  RAW PCM or 8 and 16 bit AIFF files.  The
  25. CD-DA  data  will be converted to MONO.  An optional scaling can be done as
  26. well.   Then the data will be compressed using ADPCM2 or ADPCM3.  The ADPCM
  27. algorithm  is  taken  from  example sourcecodes for the ZyXEL modem's voice
  28. files.
  29.  
  30.  
  31. Usage
  32. -----
  33.  
  34. This  is  a  Shell-only program.  Do not try to start it from Workbench.  A
  35. user interface may be added in the future.
  36.  
  37. FROM/A
  38.  
  39. The name of the source RAW PCM or AIFF file.
  40.  
  41. FREQ=FREQUENCY/K/N
  42.  
  43. Define or override the sampling frequency of the input file.
  44.  
  45. TRK=TRACKS/K/N
  46.  
  47. The number of audio tracks of the input file. 1 for Mono. 2 for Stereo.
  48.  
  49. BPS=BITSPERSAMPLE/K/N
  50.  
  51. The number of bits the input file is quantized with. Either 8 or 16.
  52.  
  53. TO/K/A
  54.  
  55. This  keyword  must exist.  After that you must specify a file name to save
  56. the ADPCM sample to.
  57.  
  58. FD=FREQDIV/K/N
  59.  
  60. The factor to downsample the input frequency with.  Any number >1 allowed.
  61.  
  62. BITS/K/N
  63.  
  64. Either specify 2 or 3 for ADPCM2 or ADPCM3 compression.  Other values might
  65. be added in the future (e.g.  8 or 16 for saving as IFF or WAV file)
  66.  
  67. MAXIMIZE/S
  68.  
  69. If  you  give this parameter, the program will first scan through the audio
  70. track(s)  and  try to find the maximum peak (similar to PEAK SEARCH on your
  71. CD-Player).  Then it will scale the sample to maximum 8 bit dynamics.  This
  72. will  reduce  the quantisation noise level.  Your sample will be louder and
  73. clearer. But it will take twice the time to convert the track.
  74.  
  75. BOOST/S
  76.  
  77. Here  you  can  give a scaling factor for your sample in percent.  100 will
  78. mean  no  scaling,  50  means  half  the volume, 200 will double the volume
  79. etc...  You can also combine this parameter with the MAXIMIZE switch.
  80.  
  81. The  boost  factor can further improve the sound quality as it improves the
  82. signal-to-noise  ratio.   Values  between  100  and  400  usually give best
  83. results.   Using  too  high  boost  values  may lead to audible distortion,
  84. similar to overmodulating an audio amplifier.
  85.  
  86. INTEL/S
  87.  
  88. Defines the byte ordering of 16 bit PCM files.  The INTEL switch will allow
  89. you to read little endian byte order.
  90.  
  91.  
  92. Examples
  93. --------
  94.  
  95. This example will convert an AIFF file to 2 Bit ADPCM. Easy, isn't it?
  96.  
  97. Hifi2ADPCM Around_the_World.AIFF to Around_the_World.ADPCM
  98.  
  99.  
  100. This  is  an  example script for converting HIFI MPegAudio streams to ADPCM
  101. format  with a frequency downscaling of 2.  Note that you require the MPega
  102. program  V2.9  or  3.x  by Stephane Tavenard.  The frequency downscaling is
  103. done   by  the  mpega  program.   This  avoids  the  creation  of  aliasing
  104. frequencies  that  will  be  caused  by the simple downscaling algorithm of
  105. Hifi2ADPCM.   Not that your T:  volume should be assigned to your hard disk
  106. because the AIFF file can become very large.
  107.  
  108.  
  109. Save  this to your S:  or script file directory and don't forget to set the
  110. s bit in the protection flags.
  111.  
  112. .KEY From/A,To/A
  113. mpega -s -q2 -d2 -A -T -b64 "<From>" T:MPeg.TMP
  114. Hifi2ADPCM T:MPeg.TMP BITS=3 MAXIMIZE BOOST=150 To "<To>"
  115. Delete T:MPeg.TMP quiet
  116.  
  117.  
  118. To Do
  119. -----
  120.  
  121. -implement a loader for uncompressed AIFC files.
  122. -implement a 8SVX format reader.
  123. -implement a WAVE format reader.
  124.  
  125.  
  126.  
  127. The Author
  128. ----------
  129.  
  130. Christian Buchner
  131. Steinbergstraße 2
  132. 82110 Germering
  133. Germany
  134. Tel.: +49-89-849868
  135.  
  136. EMAIL: flowerp@eikon.e-technik.tu-muenchen.de
  137.  
  138. <flowerp> on irc #amiga and #amigager
  139.  
  140.   //
  141. \X/ Flowerpower
  142.