Store Page
Tex Murphy: Under a Killing Moon
All Discussions Screenshots Artwork Broadcasts Videos News Guides Reviews

Tex Murphy: Under a Killing Moon

Store Page
Tex Murphy: Under a Killing Moon > Guides > Oddbrother's Guides
Not enough ratings
Gravis UltraSound on Mac
By Oddbrother
Set up the UltraSound set for the Mac build of this (and any other Boxer Standalone) game.
   
Award
Favorite
Favorited
Unfavorite
Created by
Oddbrother
Offline
Category: Modding or Configuration
Languages: English
Posted
Updated
24 Jun, 2015 @ 3:39pm
24 Jun, 2015 @ 5:35pm
82 Unique Visitors
0 Current Favorites
Guide Index
Overview
Navigate to Your Game's DOS Toolkit 
Put in UltraSound Files 
Set the DOSBox Config File to Load Patches on Game Launch 
Configure In-game MIDI 
Important Notes 
Comments
Navigate to Your Game's DOS Toolkit
  1. First, find and navigate to the location where you installed your game.
    • If you installed the game from Steam, use the Browse Local Files button in the game's Properties window in your Steam library.

  2. Once you're there, navigate inside the game's app. DO NOT run it!

  3. Now that you're browsing inside the app, navigate to "DOS Toolkit".
    {Your game app}/Contents/Resources/DOS Toolkit
Put in UltraSound Files
Make a new tab/window. You will navigate to the directory where "ULTRASND" is in this tab/window.
If you're copying "ULTRASND" from Boxer, stop after step 4. Otherwise, skip to step 4.

  1. If you don't have Boxer yet, download the ZIP from the website[boxerapp.com] and extract it. Then navigate to where you extracted the app.
  2. Much like your installed game, navigate inside the Boxer app. DO NOT run it!
  3. Once inside, navigate to "DOS Toolbox".
  4. Once you are in the directory where the "ULTRASND" folder is, you will want to copy the "ULTRASND" folder and its contents over to the tab/window that points to the "DOS Toolbox" directory in your game. There are several methods[www.dummies.com] to do this. Proceed.
  5. After the "ULTRASND" folder has been copied over, switch back to your game's tab/window and go inside the "ULTRASND" folder. Open the ULTRASND.INI text file with TextEdit or whatever IDE you prefer.
  6. Check and edit all PatchDir lines so they are set to Y:\ULTRASND\MIDI\.

And there you go! You can now emulate Gravis Ultrasound. But considering the game we're setting this up for, we're not out of the woods yet.
Set the DOSBox Config File to Load Patches on Game Launch
Because Tex Murphy 3 has its own set of UltraSound patches, you need to set up an AutoExec command so that they always load up every time you start the game.
  1. In your game's tab/window, go back to the "Resources" directory.
  2. Navigate inside the gamebox (Tex_Murphy_Under_a_Killing_Moon.boxer). DO NOT run it!
  3. Open the configuration file (DOSBox Preferences.conf) in TextEdit or whatever IDE you prefer.
  4. Under the [autoexec] field, add the following line: C:\tex3\loadpats.exe.

  5. Save and close the file. You may quit TextEdit or whatever you used to edit the file as well.
Configure In-game MIDI
With the UltraSound files in the toolkit folder and the AutoExec set in the configuration file, you can now launch the game.

  1. Upon launch and a window appearing, it'll automatically run the Patch Loader.


    If the patches load successfully without errors, proceed to run the game as normal and begin to set the sound device in the Config menu. Otherwise, look to the previous steps and see if you missed anything.

  2. After you've set your digital sound device to your preference and are on the MIDI Music Format screen, set MIDI music device to Gravis Ultrasound and I/O port to 240h.


  3. Test the sound to hear if it plays successfully, and continue to listen to the entire song to make sure it doesn't crash your game. If it does, see "Important Notes" about setting arguments to Patch Loader and other workarounds.

You are now finished! Enjoy the game with a new piece of musical technology.
Important Notes
  • Boxer mounts the "DOS Toolkit" folder as hard disk letter Y. Keep this in mind when isntalling DOS programs on Boxer, or when installing a Boxer Standalone game from an online game distributor.
  • By default, Boxer and any game wrapped in Boxer Standalone always paths ULTRADIR to Y:\ULTRASND, whether or not you have the files. This makes it easier to set up and configure UltraSound later down the line when you want to set up any future DOS programs with it as the music device. But check and make sure that the paths in the INI files are pointed to the appropriate places as well.
  • If you get constant crashes whenever you use Gravis UltraSound in game, you may also add arguments to UltraSound Patch Loader (LOADPATS) so it uses less resources when loading and using its patches. I recommend forcing a low memory size (C:\tex3\loadpats.exe -mem1). If there are any other workarounds you may know of, please share them with the community by making a guide or posting a comment on this one.

    If you want to know more about the Patch Loader, here is a reference.
    UltraSound Patch Loader Version 1.9 Copyright (C) 1994 by Advanced Gravis Computer Technology Ltd. All Rights Reserved. USAGE: LOADPATS [options] NOTE: Items in brackets are optional. Valid options are: -H -? Display this help screen -Mxxx Specify music volume where xxx=1 to 100 (Default: xxx=100) -Iname Specify a different .INI file (Default: PATCHES.INI -Q Disable all screen output -V Verbose screen output -L Enable UltraSound line in Debugging options: -8 Load patches at 8 bit instead of 16 bit -16 Load patches at 16 bit instead of 8 bit -F22 Load patches at half sampling rate (approx 22kHz) -F44 Load patches at full sampling rate (approx 44kHz) -MEMx Force UltraSound memory size. x=1-4 for 256-1024 respectively
  • If you didn't get it the first time, DOSBox always sets UltraSound to 240h by default. So unless you changed this in any of the config files, be sure to have the in-game music setting be the same I/O port. The same thing goes for every program you've installed.
  • In the event that you must update the game or reset game data, you will have to set UltraSound up all over again.
1 Comments
< >
Oddbrother  [author] 4 Jul, 2015 @ 9:25pm 
Remember to read the "Important Notes" if you get constant crashes with this setup.