Introduction:

This  library is a trash-product of a problem definition which was described
in  a German-speaking forum.

This  library  was  intentionally  created  to support high-level languages,
such  as  BASIC, which can not natively deal with interrupts, in contrast to
low-level  languages,  like  C or assembler, where you can do it on your own
in case you have the needed knowledge.

IRE  library  is  designed for Classic Amigas and not for AROS/MorphOS/OS4 -
although  on  MorphOS/OS4  it  could  be used if you don't need more than 60
calls  per  second  (interruptions)  - but this is completely untested and I
guess  that  the  low-level  library  suits  better  in  order  to  generate
interrupts on these systems.

On  Classics  using  a  68060/50  MHz  CPU you can specify up to 40 thousand
calls per second but that would lead to entirely slow down the whole machine.
In  addition,  on  Classics you can digitize via a digitizer at the parallel
port audio tracks (8-bit mono).
With  that, there is a built-in digitizer for those who need it. Furthermore
this sound recorder outputs what it fetches.
You  may also digitize 16 bits of audio signals (interpolated; built-in) and
suppress  the  8-bit  output.  In  that case you'll need to provide your own
routines for outputting the recorded audio signals - for example using AHI.

IRE   library  offers  two  types  of  interrupts:  A  timer-device  related
interrupt  that  can  be  called upto 60 times per second and a CIA hardware
timer  with  the  possibility to create interruptions upto 40 thousand times
per second.



Four bug fixes applied to this version:
----------------------------------------
Using  TOGGLE_MAKE_AUDIBLE  during  the  interrupt  is  active  doesn't lead
anymore to crash the entire system.

Solved  all  Enforcer-hits  - which surfaced in case a resource could not be
procured.

The  parallel port is now correctly unlocked - even if other resources could
not  be  obtained  during  the  initialization (in that case InitIRQ() comes
back with an iHandle of zero).

A  memory leak has been fixed; in previous version each unsuccessful call to
InitIRQ() caused 40 bytes of memory to lose.


Improvements:
-------------
In  earlier  versions  you could only choose 6000 Hz for the sound recording
using  a 68030/50 MHz CPU without freezing the system - this versions allows
now the double amount.


NOTE:
-----
In  case  you  incorporate  assember-code  in your MBasic/HBasic program you
have to use CacheClearE() - otherwise you'll be faced with crashes.


Source codes:
-------------
I  revised  the  complete  source  code  by  using  exclusively  the English
language  and  with that now the source code of this library is available as
independent archive (Aminet dev/c/IREsrc.lha).

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[unknown]                 1359    1904  71.4% -lh5- d6c6 May 17 12:02 IREdev.info
[unknown]                 1390    1904  73.0% -lh5- 251f Dec 27 11:15 IREdev/BMAP.info
[unknown]                   70      78  89.7% -lh5- d855 Dec 27 11:15 IREdev/BMAP/ire.bmap
[unknown]                 1363    1904  71.6% -lh5- 4317 Dec 27 11:15 IREdev/Include.info
[unknown]                 1362    1904  71.5% -lh5- e2bd Dec 27 11:15 IREdev/Include/clib.info
[unknown]                  336     557  60.3% -lh5- e867 Dec 27 11:15 IREdev/Include/clib/ire_protos.h
[unknown]                  903    1534  58.9% -lh5- b9bf Dec 27 11:15 IREdev/Include/clib/ire_protos.h.info
[unknown]                 1360    1904  71.4% -lh5- 82d9 Dec 27 11:15 IREdev/Include/inline.info
[unknown]                  392    1019  38.5% -lh5- 12c2 Dec 27 11:15 IREdev/Include/inline/ire.h
[unknown]                  903    1534  58.9% -lh5- d071 Dec 27 11:15 IREdev/Include/inline/ire.h.info
[unknown]                  422    1279  33.0% -lh5- 76bd Dec 27 11:15 IREdev/Include/inline/ire_protos.h
[unknown]                  941    1535  61.3% -lh5- 502c Dec 27 11:15 IREdev/Include/inline/ire_protos.h.info
[unknown]                 1365    1904  71.7% -lh5- b2fd Dec 27 11:15 IREdev/Include/libraries.info
[unknown]                 1483    3394  43.7% -lh5- c73e Dec 27 11:15 IREdev/Include/libraries/ire.h
[unknown]                  903    1535  58.8% -lh5- 46c2 Dec 27 11:15 IREdev/Include/libraries/ire.h.info
[unknown]                 1366    1904  71.7% -lh5- 6bd4 Dec 27 11:15 IREdev/Include/pragma.info
[unknown]                  370     927  39.9% -lh5- e4ef Dec 27 11:15 IREdev/Include/pragma/ire_lib.h
[unknown]                  957    1534  62.4% -lh5- 49eb Dec 27 11:15 IREdev/Include/pragma/ire_lib.h.info
[unknown]                 1259    1904  66.1% -lh5- c4eb Dec 27 11:15 IREdev/Include/proto.info
[unknown]                  219     413  53.0% -lh5- 58d0 Dec 27 11:15 IREdev/Include/proto/ire.h
[unknown]                  980    1535  63.8% -lh5- 4ee7 Dec 27 11:15 IREdev/Include/proto/ire.h.info
[unknown]                 7567   29612  25.6% -lh5- e76f May 17 12:02 IREdev/IRE Deutsch.html
[unknown]                 2712    3387  80.1% -lh5- b050 May 17 12:02 IREdev/IRE Deutsch.html.info
[unknown]                 6977   27974  24.9% -lh5- 9f10 May 17 12:02 IREdev/IRE English.html
[unknown]                 2712    3387  80.1% -lh5- 4592 May 17 12:02 IREdev/IRE English.html.info
[unknown]                 1369    1904  71.9% -lh5- 4767 Dec 27 11:15 IREdev/Libs.info
[unknown]                 3096    5356  57.8% -lh5- 1ba3 Mar 23 02:32 IREdev/Libs/ire.library
[unknown]                 1320    1904  69.3% -lh5- 9db4 Dec 27 11:15 IREdev/SFD.info
[unknown]                  318     523  60.8% -lh5- 792e Dec 27 11:15 IREdev/SFD/ire_lib.sfd
[unknown]                  908    1534  59.2% -lh5- 2e2d Dec 27 11:15 IREdev/SFD/ire_lib.sfd.info
[unknown]                 1369    1904  71.9% -lh5- d8f3 Dec 27 11:15 IREdev/Source.info
[unknown]                 1638    4628  35.4% -lh5- f2c3 Dec 27 11:15 IREdev/Source/Sampler.bas
[unknown]                  928    1544  60.1% -lh5- 9a45 Dec 27 11:15 IREdev/Source/Sampler.bas.info
[unknown]                 2036    4778  42.6% -lh5- 5bb5 Dec 27 11:15 IREdev/Source/Sampler.c
[unknown]                 1941    2466  78.7% -lh5- 41b3 Dec 27 11:15 IREdev/Source/Sampler.c.info
[unknown]                 1378    1904  72.4% -lh5- 956f Dec 27 11:15 IREdev/Tools.info
[unknown]                 4925    8204  60.0% -lh5- f634 Dec 27 11:15 IREdev/Tools/Sampler
[unknown]                 1475    2388  61.8% -lh5- 0c14 Dec 27 11:15 IREdev/Tools/Sampler.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        38 files   62372  135503  46.0%            May 18 06:50