workbench/devs/AHI/Docs/readme.main

   1
   2 --------------------------------------------------------------------------------
   3
   4 TITLE
   5
   6      AHI Audio system
   7
   8 VERSION
   9
  10      Release AHIVERSION
  11
  12 AUTHOR
  13
  14      Martin Blom <martin@blom.org>
  15
  16 DESCRIPTION
  17
  18      Retargetable Audio for AmigaOS
  19      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  20
  21      (When refering to this software, the correct term is
  22      'AHI audio system' or just 'AHI', never 'Audio Hardware
  23      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  24
  25      AHI now supports the PowerPC processor. Thanks to the users who
  26      donated money and Syscom & Mematex AB who sponsored the hardware,
  27      I was finally able you buy a Cyberstorm PPC card. The current
  28      version is for MorphOS only, but a WarpUp version will hopefully
  29      follow later.
  30
  31      Version AHIVERSION supports 68020, 68030, 68040 and 68060 from
  32      the m68k family and 603 and 604 from the PowerPC family.
  33
  34      Staring with version 6, the 68000 processor is no longer supported.
  35      68000 owners should use version 4 instead.
  36
  37      Quick overview
  38      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  39
  40      * Driver based
  41
  42      Each supported sound card is controlled by a library-based audio
  43      driver. For a 'dumb' sound card, a new driver should be written in
  44      a few hours. For a 'smart' sound card, it is possible to utilize an
  45      on-board DSP, for example, to maximize performance and sound quality.
  46      For sound cards with own DSP but little or no memory, it is possible
  47      to use the main CPU to mix channels and do the post-processing
  48      with the DSP. Available today are drivers for
  49
  50      · Aura (sampler only)
  51      · Clarity (sampler only)
  52      · Concierto (Picasso IV sound module)
  53      · Delfina DSP and Delfina Lite
  54      · DraCo Motion
  55      · Maestro Pro
  56      · Melody Z2 and 1200
  57      · Paula (8/14/14c bit)
  58      · Prelude and Prelude 1200
  59      · Toccata
  60      · Wavetools
  61      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  62      · ...and more.
  63
  64      * Fast, powerful mixing routines (yeah, right... haha)
  65
  66      The device's mixing routines mix 8- or 16-bit signed samples, both
  67      mono and stereo, located in Fast-RAM and outputs 32-bit mono or stereo
  68      (with stereo panning if desired) data, using any number of channels
  69      (as long as 'any' means less than 128...).  Tables are no longer
  70      used, which might affect performace slightly. Instead, version 6
  71      forcuses slightly more on the quality of the sound.
  72
  73      * Support for non-realtime mixing
  74
  75      By providing a timing feature, it is possible to create high-
  76      quality output even if the processing power is lacking, by saving
  77      the output to disk, for example as an IFF AIFF or 8SXV file.
  78      There are so-called HiFi mixing routines that can be used, which
  79      use linear interpolation and gives 32 bit output.
  80
  81      * Audio database
  82
  83      Uses ID codes, much like Screenmode IDs, to select the many
  84      parameters that can be set. The functions to access the audio
  85      database are not too different from those in 'graphics.library'.
  86      The device also features a requester to get an ID code from the
  87      user.
  88
  89      * Both high- and low-level protocol
  90
  91      By acting both like a device and a library, AHI gives the programmer
  92      a choice between full control and simplicity. The device API allows
  93      several programs to use the audio hardware at the same time, and
  94      the AUDIO: dos-device driver makes playing and recording sound very
  95      simple for both the programmer and user.
  96
  97      * Future Compatible
  98
  99      When AmigaOS gets device-independent audio worth it's name, it should
 100      not be too difficult to write a driver for AHI, allowing applications
 101      using 'ahi.device' to automatically use the new OS interface. At
 102      least I hope it wont.
 103
 104      Funny how things turned out, isn't it? Sigh.
 105
 106 SPECIAL REQUIREMENTS
 107
 108      AmigaOS release 2.
 109      MC68020 processor or better.
 110
 111 AVAILABILITY
 112
 113      Aminet, for example:
 114      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahi6dev.lha
 115      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahi6src.lha
 116      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahi6usr.lha
 117
 118      WWW:
 119      http://www.lysator.liu.se/~lcs/ahi.html
 120
 121 PRICE
 122
 123      Free. As in speech. And beer too! However, should you want to
 124      make a donation, my PayPal account is martin@blom.org.
 125
 126 DISTRIBUTABILITY
 127
 128      Copyright ©1994-2005 Martin Blom.
 129
 130      AHI version 6 is (L)GPL:ed. See COPYING and COPYING.LIB inside the
 131      archive for more information.