AGI-MIDI

From Sierra WikiNew
Revision as of 20:01, 12 October 2024 by Andrew Branscom (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search
AGI-MIDI
Copyright Anders M Olsson
1998



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.

Enjoy! And please let me know if this utility worked for you!

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.


About

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.


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.


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.


Games that use

Download


Contact

Anders M Olsson
Jaktstigen 37
SE-226 52 Lund
SWEDEN

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


References


See Also