Revision history
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
ahi.device
ŻŻŻŻŻŻŻŻŻŻ
1.32
· AHI is no longer a library, but a device ("ahi.device").
· Doubled volume for stereo modes without panning.
· Changed the audio IDs for paula and wavetools.
· Moved the audio drivers from LIBS:AHI to DEVS:AHI.
1.286
· 'Cancel' text in the requester defaulted to the swedish word for
cancel. Oops.
· AHI_GetAudioAttrsA() now takes 3 arguments instead of 2.
· Improved mixing rutines for AHIST_M8U samples a bit. More
changes are needed!
· AHI_SetEffect() now only takes 2 arguments, and cannot be called
from interrupts anymore.
· Added the first effect: AHIET_MASTERVOLUME.
· Removed some useless mixing routines and added a few other.
When not using panning things should be faster now.
· Added a new database tag: AHIDB_Realtime.
· AHI_ControlAudioA() now returns an error code.
· More new data base tags: AHIDB_MaxPlaySamples,
AHIDB_MaxRecordSamples and AHIDB_MixFreq.
· The way audio drivers tell ahi.device it can be used for
recording has changed.
· Added second effect: AHIET_OUTPUTBUFFER.
· Sample frequencies can now be up to 131071 Hz, which should be
enough for most users.
· Improved most of the mixing routines. Fixed some bugs in the 16
bit routines aswell.
· The requester now has menus and is keyboard controllable.
· Yet another new database tag: AHIDB_FullDuplex.
· Samples can now be played backwards (AHIST_LOOP sounds, however,
cannot. ).
· I had to change the AHIAudioCtrl structure a little. Old
drivers will NOT work any longer - they will probably crash!
Hey, it's still a beta version - I'm allowed to do such things!
· The requester tags has been redefined, a recompile is
neccessary.
· Removed a memory leak in AHI_AudioRequestA().
· New tags for AHI_ControlAudioA(): AHIC_MonitorVolume and
AHIC_MonitorVolume_Query.
· Removed the AHIDB_MixFreq tag in AHI_GetAudioAttrsA() and added
AHIC_MixFreq_Query for AHI_ControlAudioA().
· Cursor keys can now control the audio mode requester.
· Added 32 bit mixing routines with linear interpolation.
2.4
· New field in the AHIAudioCtrlDrv structure: ahiac_BuffType.
· Rewrote parts of the mixing routines. Sometimes they read one
sample to much, causing clicks. Hopefully they work now. The
new routine is a little faster, by the way...
· Fixed the 32 bit linear interpolation mixing routines; they
ALWAYS read at least one sample too much, sometimes two.
· Loads of new tags for AHI_ControlAudioA(): AHIC_InputGain,
AHIC_InputGain_Query, AHIC_OutputVolume, AHIC_OutputVolume_Query,
AHIC_Input, AHIC_Input_Query, AHIC_Output, and AHIC_Output_Query.
· Even more new tags for AHI_GetAudioAttrsA():
AHIDB_MinMonitorVolume, AHIDB_MaxMonitorVolume,
AHIDB_MinInputGain, AHIDB_MaxInputGain, AHIDB_MinOutputVolume,
AHIDB_MaxOutputVolume, AHIDB_Inputs, AHIDB_InputArg, AHIDB_Input,
AHIDB_Outputs, AHIDB_OutputArg and AHIDB_Output.
· Increased the maximum frequency a sample can be played at to
262143 Hz.
· Previously, the requested number of channels was rounded to an
even power of two, i.e. an 18 channel song actually used 32
channels. This is no longer the case.
2.23
· Fixed a bug in AHI_GetAudioAttrsA(): Strings was not always
NULL- terminated.
· CloseDevice() trashed some registers it shouldn't. Not so
anymore.
· By mistake I used the function graphics.library/SetRPAttrs() in
the requester code, which caused AHI to crash on pre-39 machines.
· Fixed some bugs in the autodocs
AHI_AllocAudioA()/AHIA_RecordFunc. Note that the RecordFunc must
return NULL from now on!
· All PlayerFreq related values should now be Fixed instead of
ULONG. A kludge has been added to keep old programs going for
some time.
3.861
· Small bug fix in the requester code.
· AHI_DEFAULT_ID as AHIA_AudioID tag data (AHI_AllocAudioA())
didn't work.
· New function: AHI_PlayA().
· MC68000-version added.
· New mode for audio drivers: AHISB_CANPOSTPROCESS.
· Bug fix: Turning off the AHIET_OUTPUTBUFFER effect resulted in
an endless loop.
· Surround support added.
· New effects: AHIET_DSPMASK and AHIET_DSPECHO.
· New function: AHI_SampleFrameSize().
· New (private) functions: AHI_AddAudioMode(),
AHI_RemoveAudioMode() and AHI_LoadModeFile().
· AddAudioModes does not have to be run before AHI can be used
anymore. When 'ahi.device' is loaded, it will check if the audio
mode database is loaded. If not, it will automatically scan
DEVS:AudioModes/ for mode files and add them.
· Rewrote the last three non-critical functions in C instead of
assembly.
· Added the new tag AHIB_Dizzy to AHI_BestAudioIDA().
· New "effect": AHIET_CHANNELINFO.
· The first two device commands added: CMD_READ and CMD_WRITE
· The (obsolete) MultiLoop feature is not totally gone.
· Removed a bunch of mixing routines that almost never were used
anyway.
· AHI_LoadSound() does not handle unsigned 8 bit samples anymore.
You'll have to convert such samples before they can be played
from now on.
· Added Storm C include files.
· More device commands: CMD_RESET, CMD_STOP, CMD_START and
CMD_FLUSH.
· Stereo sounds can now be used too.
· Max frequency for AHI_SetFreq() increased once again: 1048575.
· Added two functions to calculate CPU usage and avoid lockups
(ahiac_PreTimer and ahiac_PostTimer).
· Localized it.
3.948
· AHIR_Locale should work now.
· AHIDB_MaxChannels didn't work in AHI_BestAudioID().
· The users preferred audio mode can now be selected in the
requester, by setting AHIR_DoDefaultMode to TRUE.
· Added an infowindow to the requester.
· All functions that take an audio mode id as input can now use
AHI_DEFAULT_ID as well.
· CMD_READ should actually work now. I hope.
· Faster 16 bit mixing of 16 bit samples when using a "fast" mode.
· New flag for OpenDevice(): AHIDF_NOMODESCAN (private).
· (Wrote user docs.)
· (Updated "Programming Guidelines".)
3.1080
· CMD_STOP and CMD_START should work better now?
· The freqgadget wasn't ghosted if the requester was opened with
audioid set to AHI_DEFAULT_ID. Now it is.
· Up to 4 device units are now available.
· No more alignment restriction for CMD_WRITE.
· Removed IORequest size check for OpenDevice(AHI_NO_UNIT) in
order to make some programs that open V3 without a valid V3
AHIRequest work.
· AHIST_INPUT redefined.
· Rewrote AHI_LoadSound() and AHI_UnloadSound() in C.
· Playing 16 bit stereo samples in mono-not-fast mode did not
work.
· AHI_BestAudioID() and FilterTags in the audio mode requester had
got the FullDuplex flag all wrong.
· The audio mode requester can now handle AHIR_PubScreenName set
to NULL, meaning that is should open on the default public
screen.
· The echo routines is now rewritten. "Fast echo" routines added.
"No-cross-Full-mix" too.
· I tried to get AHIST_INPUT working, but I couldn't make the
recording and playback sync. I suspect the problem is in the
Paula driver, but I don't know...
3.1091
· Major bug in the device interface code fixed. It could crash,
and never used more that one channel.
· Amiga E modules added.
4.20
· Bumped version to 4.
· (Transformed "Programming Guidelines" into "AHI Developer's
Guide".)
· Added AHIE_HALFDUPLEX error code.
4.26
· Some tweaks...
· AHIET_DSPMASK didn't work! Now it does.
4.99
· Fixed a race condition when playing small chunks with CMD_WRITE.
· Fixed the problems with unreplied IO requests.
· Fixed a lockup problem with CMD_START (it's still far from
perfect).
· Fixed some problems in AHI_BestAudioIDA().
· ahiam_AudioID and ahiam_MixFreq are now left unchanged if the
user cancels the audio mode requester.
· Added optional clipping when using master volume > 100%. So
there.
· The functions that returned BOOL (AHI_GetAudioAttrsA() and
AHI_AudioRequestA()) now sets all 32 bits and not just the lower
word of the return code (BOOL is only 16 bit).
· Bug fixes in the "normal" mixing routines (not fast or hifi).
· Much faster HiFi routines.
4.109
· Oops! I had some debug code left in the device (flashing
backgrounds, anyone?)...
· Added 68060 version.
4.158 (R4.14)
· AHI_LoadSound() now returns an error if the user tries to play
unsigned samples in HiFi modes (i.e., I removed the
AHI-Noteplayer-for-Delitracker kludge).
· AHI_LoadSound() always returned 0 if the driver overloaded the
function. Now it returns the correct value.
· AHI_SetEffect() would return 0 even if the driver overloaded the
function.
· Fixed an overflow error in the HiFi-routines.
· Removed distortion when playing sounds backwards in HiFi mode.
· CMD_START was never executed... Sigh.
· NSCMD_DEVICEQUERY didn't know about CMD_START and CMD_STOP.
· Echo will no longer trash memory.
· Bug in the 32 bit stereo echo routine removed.
4.164
· Bug fixes in the HiFi routines. There was also debug code left
(!), that disabled stereo for some 16 bit samples.
· Booleans variables in the tag lists and the audio mode database
are now compared using logical XNOR instead of equality.
4.165
· Removed an accidental KPrintF() from the device code.
4.180 (R4.15)
· Improved debugger output.
AHI preferences
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
0.1
· There is now a prefs program, written by Ruediger Sopp, that can
be used to select default audio mode, frequency etc.
1.0
· New preferences program, rewritten from scratch. This one
(barely) fits on a 640×200 screen using Topaz 8.
4.3
· Bumped version to 4.
· Localized it.
· "Reset to Defaults" didn't reset the Global Options.
· "Restore" fixed (always loaded ENV:Sys/ahi.prefs, even if
invoked with a FROM argument.
4.5
· New global option: Mastervolume with(%|out) clipping.
· MUI version written by Stéphane Barbaray added.
· Small bug fix in the MUI version, and CTRL-C also works now.
AddAudioModes
ŻŻŻŻŻŻŻŻŻŻŻŻŻ
1.1
· AddAudioModes rewritten. New switch: REMOVE.
1.2
· AddAudioModes got another switch, DBLSCAN, which tries to open
and then immediately close a native, double-scan screen. At
least CyberGraphX keeps the scan rate when ECS/AGA screens are
closed, so this enables >28 kHz sample rates for graphic card
owners. My guess is that this requires V39 or greater to work,
but it should work with both ECS and AGA. Don't forget to
install a doublescan monior driver if you don't already have one.
1.5
· AddAudioModes DBLSCAN now scans the audio mode database for the
screen mode that allows highest sample rates.
· The device is now opened with the AHIDF_NOMODESCAN flag.
4.1
· Bumped version to 4.
4.2 (R4.17)
· Added hardware-banging code to force VGA mode.
AHI-Handler
ŻŻŻŻŻŻŻŻŻŻŻ
1.8
· Changed the priority of the AUDIO: handler to 5.
4.1
· Bumped version to 4.
4.2
· Much improved error handling.
concierto.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
Note: concierto.audio is İ1997 Village Tronic Computer and
written by Olaf Barthel.
delfina.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻ
Note: delfina.audio is İ1996-1997 Petsoff Limited Partnership
and written by Teemu Suikki. The latest release of this driver
can be found at .
filesave.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
1.0
· First version.
1.1
· Updated for HiFi (32 bit) mixing routines.
2.0
· Bumped version to 2.
· Bug fix: Previously called AslRequest instead of
AslRequestTags, resulting in an Enforcer hit.
2.1
· Minor bug fixes.
· Added sampler emulation. This means that this driver can now be
used to simulate a sound card with sampler. Just select an audio
file when the requester pops up. (This feature is only for
programmers and requires OS 3.0 or higher, because
datatypes.library is used to load the audio file.)
2.2
· Now works with 2.0 systems, too. The file should be a raw 8 bit
signed sample (i.e. no headers).
2.3
· Changed the number of avalable mixing/sampling frequencies.
2.4
· MC68000-version added.
· Minor improvements and larger buffer makes it several times
faster.
· Fixed a bug in AHIsub_Enable().
· AHIsub_AllocAudio() did not return the correct error code on
failure.
2.5
· Now displays a requester instead of an alert if asl.library
cannot be opened.
2.6
· The requester about missing asl.library is now only showed once.
2.9
· Some source code cleanup.
· Added the Studio 16 file format.
2.10 (R4.17)
· Fixed a problem with broken headers.
maestropro.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
Note: maestropro.audio is İ1997 Richard Körber. The latest
release of this driver can be found at
.
melody.audio & melody1200.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
Note: melody.audio & melody1200.audio is İ1997 Kato and written by
Thorsten Hansen. The latest release of this driver can be
found at .
paula.audio
ŻŻŻŻŻŻŻŻŻŻŻ
2.0
· Bumped version to 2.
· Bug fix: 14 bit uncalibrated mode now works as it should.
2.2
· Various bugfixes.
· Added support for parallel port samplers (only generic mono this
time).
· Changed the number of avalable mixing/sampling frequencies.
· The video mode is now checked to see if mixing frequencies above
28867 Hz is possible.
2.3
· Bug fix: Driver reported wrong resolution for 14 bit modes.
· MC68000-version added.
· Bug fix: Distortion because of playing samples from an odd
address. Kinda lame bug: I made sure the length was even, but
forgot the start address.
2.4
· Can now use the Aura sound card as sampler instead of one in the
parallel port.
2.5
· Better handling of the Aura sampler. The driver is now defined
to have two inputs, instead of using two separate mode files.
3.0
· Added protection against CPU overload.
3.1
· The variable AHIpaulaFilterFreq is now checked when the audio is
allocated.
4.1
· Bumped version to 4.
4.2
· This is unbelievable, but I had swapped the left and right
channel!
4.5
· Crashed related to the PCMCIA code removed. Oops.
4.6
· Better checks for >28 kHz modes.
4.7
· Added variable AHIpaulaSampleLimit, to remove the screen mode
checks.
4.8
· Better checking of videomode with Picasso 96 (req. 1.18+).
4.10
· HiFi modes added.
· Added support for the Clarity sampler?
4.11
· Rewrote the conversion routines, they should be faster now?
· Added the AHIpaulaBufferLength environment variable.
4.12
· There were errors in the new conversion routines, when the tempo
changed.
· 8 bit modes now have hardware volume control.
4.13
· Added the AHIpaulaSwapChannels environment variable.
· AHIsub_GetAttr() is much faster now.
4.14 (R4.15)
· Enclosed FindTask("Picasso96") with Forbid()/Permit(), in order
to silence PatchWork.
4.15ß
· Added a DMA mode (beta).
4.16
· Fixed all known problems in the DMA mode.
4.17
· DMA version released.
4.19
· Fixed a problem that caused full duplex operations to hang AHI.
4.20
· The low pass filter state is now restored when the audio is
deallocated.
4.21 (R4.17)
· Added the AHIpaulaFakeMixFreq environment variable.
4.23 (R4.18)
· Much improved timing! This driver should now behave exactly like
the filesave driver (and most sound card drivers as well),
provided AHIpaulaFakeMixFreq is set to 1, of course.
prelude.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻ
Note: prelude.audio is İ1996-1997 A.C.T. and written by Thomas
Wenzel. The latest release of this driver and documentation can
be found at
.
toccata.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻ
2.1
· First public version.
2.10
· Lots of bug fixes, but there is need for many more.
2.11
· More bug fixes. I think it actually is usable now...
2.12
· Will now do all mixing in a software interrupt if the
environment variable AHItoccataNoTask is set to 1.
2.14
· Added support for the hacked "toccata..library". It works much
better than the AHItoccataNoTask kludge.
· AHIC_MonitorVolume works as it was supposed to now.
· Bug in the mutal exclusive code fixed.
2.15
· A little less clicks now.
2.17
· Better hardint checking.
· Doesn't fail to load anymore if toccata.library v12 cannot be
opened.
4.1
· Added protection against CPU overload.
· Added HiFi modes.
4.3
· Added the AHItoccataIrqSize environment variable.
4.4
· Added workarounds for bugs in the AD1845 chip. No more white
noise on the DraCo Motion!
wavetools.audio
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
1.10
· Updated for beta 2 (AHIC_MonitorVolume,
AHIC_MonitorVolume_Query)
2.0
· Bumped version to 2.
· Added support for AHIC_OutputVolume, AHIC_OutputVolume_Query,
AHIDB_MinMonitorVolume, AHIDB_MaxMonitorVolume,
AHIDB_MinOutputVolume, AHIDB_MaxOutputVolume, AHIDB_Inputs,
AHIDB_Input, AHIDB_Outputs and AHIDB_Output.
2.1
· Wow, at last! Somebody is actually USING this driver now!
Version 2.0 didn't even work, and nobody reported it until
recently...
Note: The following changes were done by Johan Nyblom
2.11
· Bug fixes, input gain added.
Other software
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
· The hook structure in PT-AHIPlay.s missed the userdata field.
· PT-AHIPlay.s doesn't use AHIST_LOOP sounds anymore.
· RecordTestQnD.s now uses AHIC_MonitorVolume.
· ScanAudioModes updated for V2.
· PT-AHIPlay.s updated to use Fixed instead of ULONG for player
frequencies.
· DoubleBuffer example program added.
· HarddiskRecord example program added.
· The protracker replay code has been rewritten.
· Protracker datatype added.
· RecordTest example program added.
· PlayTest example program added.
· Updated the AHI-Noteplayer for Delitracker to version 1.4.
· Audio handler added.
· Simpleplay updated.
· The protracker replay code fixed (left/righ channel swapped),
and a major bug in the example PlayerFunc was removed (didn't
save register a2!).
· Protracker datatype updated. Now it actually obeys the AHI
rules, which hopefully means no more crashes with Toccata.
· Added DSPECHO and DSPMASK to SimplePlay.
· Protracker datatype would cause a total lockup with the filesave
driver. Not anymore.
· ARGH!! The doublebuffer.c example used an incorrect formual for
calculating the buffer size!
· Moved the Delitracker noteplayer out of the developer archive
(what's the point when it doesn't include any source?).
· The protracker replay code called AHI_ControlAudioA() every
interrupt, since I fotgot to clear ptd_NewTempo.
· Added Melody to the distribution.
R4.15
· Added Maestro Pro to the distribution.
· The documentation now has the same version number as the
distribution.
R4.16
· Added Concierto to the distribution.
· Added the CheckAHIPrefs example.
R4.17
· Added the source code for Concierto to the distribution.
· The C includes called the "AHIEffDSPEcho" structure "AHIDSPEcho".
· Fixed the SimplePlay to use "AHIEffDSPEcho" instead of "AHIDSPEcho".
· Added Russian translation.