Note:
Aminet admins only: Use address from [Uploader] field to contact me
All others: Use the email address stated on my homepage www.toms-home.de

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-2007 Martin Blom.


Important
---------
Don't blame me if you AHI driver doesn't work! If this program malfunctions
due to a bug in my code I'll try to fix it as soon as possible. However, if
this program fails because of a badly coded AHI driver or because of a
conflict with one of the numerous hacks or patches out there -- bad luck!


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

 - Automatic file generation for recording several tracks sequentially:
   If you specify a default filename using the NAME ToolType, AHIRecord
   will enter rec-pause-mode immediately once you've set the audiomode.
   After you've pressed stop you will be asked for the real filename which
   will be the default filename followed by a three digit number. Once
   you've confirmed that filename, AHIRecord will re-enter rec-pause-mode
   so that you can start recording your next track immediately.
   The three digit "track number" will be increased by one.

 - Unattended automatic recording:
   The TIMER parameter allows you to record for a given number of minutes
   and quit AHIRecord afterwards. This way you can use your favourite
   scheduling program for precisely timed automated recordings. If you
   also want AHIRecord to handle the input level just set ALC=YES.

Tooltypes/CLI parameters
------------------------

 - 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_16bit, AIFF_24bit, WAVE_16bit or
             WAVE_24bit

 - 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.

 - TIMER     Limit recording time to specified number of minutes

 - GAIN      Initial gain setting (0..100)

 - ALC       Turn on automatic level control (set to YES)

 - AUTOBIAS  Set to YES: Automatically determine and subtract any bias
             from the sampled data. Still experimental, please use with
             caution! Currently not supported for 24/32-bit modes.

 - 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
             (only valid on screens of 8-bit depth or less)

 - 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

 - PUBSCREEN Public screen name to open window on

 - SAVEPRI   Priority of the save task (defaults to 5 if not specified)
             Use with care!

CLI-Examples
------------
AHIRecord MODE=786438 FREQ=44100 INPUT=0 FORMAT=AIFF_16bit
NAME=Work:Recording.aiff TIMER=45 GAIN=30 ALC=YES


Minimum Requirements
--------------------
AHI audio system V6
AmigaOS 4.0
asyncio.library V50
PowerPC CPU


Revision history
----------------
1.15 - Fixed file writing routines in OS4 version
     - Fixed buffer size probing by levelmeter-task

1.14 - AmigaOS4 version available
     - Now writing AIFF files instead of AIFF-C
     - Various code cleanups

1.13 - Improved pen allocation and/or Cybergraphics usage for level meter
     - Increased level meter persistence

1.12 - Fixed GAIN setting
     - AUTOBIAS tooltype

1.11 - Fixed enforcer hit when starting from CLI
     - GAIN tooltype
     - SAVEPRI tooltype

1.10 - New parameters for unattended automated recordings:
       TIMER tooltype
       ALC tooltype

1.9  - 16-bit or 24-bit filemode now individually selectable
     - 24-bit filemode support for both WAV and AIFF
     - Better compatibility with various 24-bit AHI audiomodes

1.8  - Fixed illegal memory access when pressing Pause

1.7  - Fixed a display bug in the format selection cycle gadget
     - Added 24-bit AIFF support
     - Added PubScreen support

1.6  - Removed MAUD support (sorry, folks!)
     - Added mono filetypes
     - Added support for sequentially recording several tracks
     - Added Cancel button to escape from rec-pause mode
     - Improved default filename handling
     - Keeping AHI driver opened so that monitor volume changes
       are possible even after the recording has stopped

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

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

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

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

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.1  - Optimized levelmeter speed. Should run better on slow Amigas
     - Added WAVE save format

1.0  - First public release


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 :-)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 5260    6206  84.8% -lh5- 7b21 Jan 19 18:27 AHIRecord.info
[generic]                25755   61008  42.2% -lh5- 33d0 Feb 16 19:43 AHIRecord/AHIRecord
[generic]                10211   10855  94.1% -lh5- 0169 Jan 19 14:55 AHIRecord/AHIRecord.info
[generic]                 2789    6073  45.9% -lh5- fc33 Feb 16 19:40 AHIRecord/AHIRecord.readme
[generic]                 6809    9498  71.7% -lh5- a9a9 Jan 19 14:55 AHIRecord/AHIRecord.readme.info
[generic]                 8296   10561  78.6% -lh5- 2e25 Jan 19 14:55 AHIRecord/def_sound.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         6 files   59120  104201  56.7%            Feb 17 07:34