home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Sound / AHIpre2 / ahidev.readme next >
Text File  |  1999-10-12  |  5KB  |  152 lines
  1. Short:    Retargetable audio v4.21, Developer's Archive
  2. Type:     dev/misc
  3. Author:   Martin Blom <martin@blom.org>
  4. Uploader: Martin Blom <martin@blom.org>
  5.  
  6.      This archive contains the developer documentation and
  7.      example source code for AHI, both for programmer who wish
  8.      to use AHI in their own applications and those who want
  9.      to write hardware drivers.
  10.  
  11.      Changes since last release
  12.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13.      This release includes a couple of bug fixes and
  14.      support for WarpUp.
  15.  
  16. --------------------------------------------------------------------------------
  17.  
  18. TITLE
  19.  
  20.      AHI Audio system
  21.  
  22. VERSION
  23.  
  24.      Release 4
  25.  
  26. AUTHOR
  27.  
  28.      Martin Blom <martin@blom.org>
  29.  
  30. DESCRIPTION
  31.  
  32.      Retargetable Audio for AmigaOS
  33.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  34.  
  35.      (When refering to this software, the correct term is
  36.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  37.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  38.  
  39.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  40.      However, many features are lacking:
  41.  
  42.      · Very limited volime control when using 16 bit samples
  43.      · No HiFi mixing routines are available.
  44.      · No stereo samples
  45.      · No DSP effects are available.
  46.      · Less precision on some calculations
  47.      · Slower
  48.  
  49.      As you can see, this version is very primitive.  Get yourself an
  50.      accelerator!  I cannot guarantee that I will continue to support this
  51.      processor in the future.
  52.  
  53.      AHI now supports the PowerPC processor. Thanks to the users who
  54.      donated money and Syscom & Mematex AB who sponsored the hardware,
  55.      I was finally able you buy a Cyberstorm PPC card. The current
  56.      version is of PowerUp only, but a WarpUp version will follow later.
  57.  
  58.      Quick overview
  59.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  60.  
  61.      * Driver based
  62.  
  63.      Each supported sound card is controlled by a library-based audio
  64.      driver. For a 'dumb' sound card, a new driver should be written in
  65.      a few hours. For a 'smart' sound card, it is possible to utilize an
  66.      on-board DSP, for example, to maximize performance and sound quality.
  67.      For sound cards with own DSP but little or no memory, it is possible
  68.      to use the main CPU to mix channels and do the post-processing
  69.      with the DSP. Available today are drivers for
  70.  
  71.      · Aura (sampler only)
  72.      · Clarity (sampler only)
  73.      · Concierto (Picasso IV sound module)
  74.      · Delfina DSP and Delfina Lite
  75.      · DraCo Motion
  76.      · Maestro Pro
  77.      · Melody Z2 and 1200
  78.      · Paula (8/14/14c bit)
  79.      · Prelude and Prelude 1200
  80.      · Toccata
  81.      · Wavetools
  82.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  83.  
  84.      * Fast, powerful mixing routines (yeah, right... haha)
  85.  
  86.      The device's mixing routines mix 8- or 16-bit signed samples, both
  87.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  88.      (with stereo panning if desired) data, using any number of channels
  89.      (as long as 'any' means less than 128...).  Tables can be used speed
  90.      the mixing up (especially when using 8-bit samples).  The samples can
  91.      have any length (including odd) and can have any number of loops.
  92.      
  93.      * Support for non-realtime mixing
  94.  
  95.      By providing a timing feature, it is possible to create high-
  96.      quality output even if the processing power is lacking, by saving
  97.      the output to disk, for example as an IFF AIFF or 8SXV file.
  98.      There are so-called HiFi mixing routines that can be used, which
  99.      use linear interpolation and gives 32 bit output.
  100.  
  101.      * Audio database
  102.  
  103.      Uses ID codes, much like Screenmode IDs, to select the many
  104.      parameters that can be set. The functions to access the audio
  105.      database are not too different from those in 'graphics.library'.
  106.      The device also features a requester to get an ID code from the
  107.      user.
  108.  
  109.      * Both high- and low-level protocol
  110.  
  111.      By acting both like a device and a library, AHI gives the programmer
  112.      a choice between full control and simplicity. The device API allows
  113.      several programs to use the audio hardware at the same time, and
  114.      the AUDIO: dos-device driver makes playing and recording sound very
  115.      simple for both the programmer and user.
  116.  
  117.      * Future Compatible
  118.  
  119.      When AmigaOS gets device-independent audio worth it's name, it should
  120.      not be too difficult to write a driver for AHI, allowing applications
  121.      using 'ahi.device' to automatically use the new OS interface. At
  122.      least I hope it wont.
  123.  
  124. SPECIAL REQUIREMENTS
  125.  
  126.      AmigaOS release 2.
  127.      MC68020 processor or better strongly recommended.
  128.  
  129. AVAILABILITY
  130.  
  131.      Aminet, for example:
  132.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  133.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  134.  
  135.      WWW:
  136.      http://www.lysator.liu.se/~lcs/ahi.html
  137.  
  138. PRICE
  139.  
  140.      Free. But if you use it in a shareware of commercial product,
  141.      I would like a registered copy for me and each of the audio driver
  142.      authors (this is merely a wish, you don't have to do it if you don't
  143.      think we deserve it). See the AHI User's Guide for more information.
  144.  
  145.      Please note that the PowerPC-version is shareware.
  146.  
  147. DISTRIBUTABILITY
  148.  
  149.      Copyright ©1994-1999 Martin Blom.
  150.      Freely distributable in unmodified form.
  151.      See the AHI User's Guide for more information.
  152.