AGI Sound to MIDI Hack

From Sierra Wiki
Jump to navigationJump to search
AGI Sound to MIDI Hack
Version 0.5
Author: Anders M. Olsson
1998-05-03

Not to be confused with Jens Christian Restemeier's AGI Sound Resource to MIDI

AGI Sound to MIDI Hack
Latest Version:  0.5
Release Date:  1998-05-03[1]
Company: N/A
Development Status:  Abandoned
Publication Status:  Published
Developer(s): Anders M. Olsson
Interface: N/A
Language: C
Open Source: Closed
Source Availability:  No
License:
Type: Interpreter Hacker
Relevant Engine: AGI
Platform: DOS
Localization: English
Website: N/A




A.K.A.


Description

An experimental patch for Sierra's old AGI games, to make them play three voice music and sound effects via a MIDI synth. See included README for more information.


Features


Requirements

You need a Sierra game with an interpreter version 2.911 or above. NOTHING OLDER WILL WORK! To check the version number of your Sierra interpreters, use Jeremy W. Hayes program AGIVER.

If you see more than one line of output from AGIVER, only use the first line. For example:

3.002.102
2.102

This means that you have an AGI-interpreter version 3, so AGI-MIDI should work fine!

Another example:

2.435

That will not work. You need to find a more recent interpreter. If your game does not qualify as version 2.911 or above, please read on.

Usage

To apply the patch, simply run the program AGIMIDI.EXE from your game directory. By default, the file AGI will be patched, and no backup is made. IT IS YOUR OWN RESPONSIBILITY TO MAKE A BACKUP COPY OF THE FILE AGI BEFORE PROCEEDING! I will not accept any responsibility for any damage caused by using this program, even if it erases your hard disk. (Not very likely, though!)

If you wish to use other file names than the default, give them as arguments on the command line. Like this:

AGIMIDI [infile] [outfile]


How to configure

After an initial welcome screen, a configuration menu will appear.

There are three things to consider.

  • First: What kind of MIDI interface do you have, Roland or SoundBlaster? Select Roland if you have an MPU-401 compatible MIDI interface. Select SoundBlaster if you use the MIDI-port on a SoundBlaster or compatible card. Incorrect setting here will most likely cause your game to hang.

Please note that a SoundBlaster card alone will not work. You need an external synth connected to the MIDI interface. (Unless you plan to use MT-32 or GM emulation on an AWE- card - more about that below).

  • Second: MIDI notes for the noise track. The defaults have been selected to work with an MT-32, so if you have some other synth, you may want to change them. Noise data is always output on MIDI channel 10, which many synthesizers use for rhythm and sound effects.
  • Third: The init string. The default init string sends program change on channels 2 through 4, selecting the first instrument on each channel. This typically translates to the acoustic piano. You may want to change this after consulting the manual for your synth. Currently, the maximum length of the init string is 26 characters.

Press F10 to save when you are done.

You can run the AGI-MIDI utility again at any time to change the options.


SoundBlaster AWE32

MT-32 or General MIDI emulation on an AWE card. If you have a SoundBlaster AWE32 or similar card, you may want to try emulating MT-32 or GM by loading the special drivers that came with your card.

IMPORTANT: In this special case only, you must configure AGI-MIDI for Roland, even though the hardware really is a SoundBlaster card!

I also recommend that you thoroughly read the manual for your card. It can sometimes be tricky to get it to work. It is probably not possible to run under Windows at all. Try to boot DOS as cleanly as possible. Unload all resident programs, except the drivers for the sound card. Memory managers (like EMM386 etc.) are likely to cause trouble, and should be removed.


Unsupported Interpreter

If your game has an unsupported interpreter version you can extract a version 2.9xx interpreter from another game! When you apply the patch, a small fix is also applied to disable the detection of game IDs. So a patched version 2.9xx interpreter should happily play any version 2 game without complaining. But please don't try to use a version 2 interpreter with a version 3 game or vice versa! All version 3 games should probably work directly, without substituting the interpreter.

To move the interpreter from one game to another, copy the files:

  • SIERRA.COM
  • AGI
  • All files ending with .OVL
  • optionally HGC_FONT

** The loader - SIERRA.COM - is sometimes renamed to reflect the name of the game, for example KQ1.COM.

If you don't own any games at all with the correct interpreter versions, you can download any of the files DEMOPACK1.ZIP, DEMOPACK2.ZIP or DEMOPACK3.ZIP from http://www.ozemail.com.au/~ptrkelly/agi/games/demos.html

and extract the mentioned files from there.


Version History

  • Version 0.5, May 3, 1998 - Initial release.


Development Status

Further development of AGI Sound to MIDI Hack has been abandoned.


Options


Download

Download from here:


Known Issues

  • None known


Credits

Anders M. Olsson


Legal

This program can be freely distributed and shared as long as no money is involved. Shareware libraries may charge reasonable media and/or handling costs.

Contact

Anders M Olsson
Jaktstigen 37
SE-226 52 Lund
SWEDEN

E-mail: anders.m.olsson@abc.se


Games that use


References

  1. ↑ From the included README file


See Also

 

Retrieved from "http://wiki.sierrahelp.com/index.php?title=AGI_Sound_to_MIDI_Hack&oldid=106360"