Short:    Advanced AHI HD-Recorder V1.5
Author:   Thomas Wenzel <wenzel@unixserv.rz.fh-hannover.de>
Uploader: Thomas Wenzel <wenzel@unixserv.rz.fh-hannover.de>
Version:  1.5
Type:     mus/play

Legal stuff
-----------
This program is copyrighted freeware. It may be distributed freely as long
as no modifications are made to the executable and this document. A nominal
fee may be asked to cover distribution costs. However, it may not be
included in any commercial distribution without my permission.

It is based on the HardDiskRecord program from the AHI developer package.

AHI audio system is Copyright ©1994-97 Martin Blom.


Important
---------
This is my first attempt in writing a program with GUI, several subtasks
and realtime display. If you detect errors/bugs/crashes (I'm afraid you
will), please let me know. If the program crashes at first start dont't
just delete it angrily but send me a flame as well :)


Features
--------
 - Multithreaded level meter and status display
 - Asynchronous writes to harddisk
 - Generates AIFF, MAUD or WAVE files

Tooltypes
---------

 - MODE     Initial AHI audio mode to use

 - FREQ     Initial sampling frequency to use

 - INPUT    Number of the default input to use

 - FORMAT   Initial file format: AIFF, MAUD oder WAVE

 - NAME     Specify a temporary name for a file to be opened at startup
            When you finish the recording you will be asked for the
            final name.

 - BUFFERS  Set number of async buffers for recording to harddisk.
            A minimum of 4 is recommended. 4 is also the default

 - GPEN     Override the pen number for the green pen returned by AmigaOS

 - YPEN     Same for yellow pen

 - RPEN     Same for red pen

 - ICONS    If set to YES, an icon taken from ENVARC:sys/def_sound.info
            will be created for each recorded file


Limitations
-----------
Only 16 bit stereo recording at the moment.
Does anyone really need mono ?!?


Requirements
------------
AHI audio system V2
AmigaOS 3.0
asyncio.library V37
68020 CPU


Recommended
-----------
68030-25 or faster
High quality 16 bit soundcard (Prelude for example ;)
Play16 to play your recordings (Play16 is freeware, too!)


Revision history
----------------
1.0 - First public release

1.1 - Optimized levelmeter speed. Should run better on slow Amigas
    - Added WAVE save format

1.2 - Levelmeter sometimes 'lost' some segments. Hopefully fixed.
      Removed a bug in FORM size of MAUD and AIFF savers. Some programs
      refuse to load the file just because the sizes don't match :-(

1.3 - Fixed a nasty bug in cleanup routine that could lead to crashes
    - New tooltypes for user selectable pens

1.3a  Subtask handling slightly modified. Hopefully more stable now.

1.4 - Added tooltypes/templates for default values: It makes AHIRecord
      much more convenient to use
    - Added Rec/Pause feature

1.5 - Fixed a bug in the AIFF saver
    - Added the missing Tooltype for Initial file format

Known bugs
----------
In case of asyncio buffer overflow the program will hang. Don't expect it
to record 44.1 kHz to slow floppy disk :-)


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
   19808   11102 43.9% 08-Oct-97 20:46:16 +AHIRecord
    2084    1427 31.5% 08-Oct-97 20:46:16 +AHIRecord.info
    3111    1595 48.7% 08-Oct-97 20:46:16 +AHIRecord.readme
     468     236 49.5% 08-Oct-97 20:46:16 +AHIRecord.readme.info
    1146     805 29.7% 08-Oct-97 20:46:16 +def_sound.info
-------- ------- ----- --------- --------
   26617   15165 43.0% 08-Oct-97 23:01:36   5 files
