User:Napalm

2015-04-21T16:00:49Z

Napalm: Grammar correction.

I've been around in the keen-modding community since 2007. I grew up with DOS games and I've always had a desire to make one. Never actually getting around to coming up with an entire game plot. I satisfied myself with working out how the games work 'under-the-hood'. I have contributed a little here and there over the years. Every-time I get a urge to go old skool I revisit and dig out my old code.

TSRMusic

2015-04-21T07:42:09Z

Napalm: added link to Napalm's profile.

'''TSRMusic''' is a utility created by [[User:Napalm]] and modified by [[User:Lemm]] to allow Keen Vorticons mods to play IMF music. The program is Terminate Stay Resident (TSR), meaning it is run before Keen, "ends" and stays resident in memory while the game runs. It allows any level to have its own IMF music as long as that music file is no larger than 32KB in size. As the help file notes:

<blockquote>
<p>
TSR plays 560Hz Type-1 IMF files in the Keen Vorticon games. TSR is installed before game and uninstalled immediately afterwards. It intercepts the keen timer interrupt and polls certain game variables to determine when the song should be changed.
</p><p>
Note if running under Dosbox: cycles should be set below 3000 when the TSR is loaded or else may not detect the adlib card.
</p>
</blockquote>

== Use ==

There are components to TSRMusic, the program, a batch file used to start it (this will most likely be the same file used to start the mod), various IMF music files, and a song list file containing information on what songs to play in what levels.

The batch file will be something like this:

tsrmusic.com
ckXpatch keenXpat.pat
tsrmusic.com /u

A simple songlist file will be something like:

#This is my song list
%l 1 "K5T05.IMF" #Level 1 song 'Metal.imf'
%l 80 "worldmap.imf" #Map song
%x #Stop reading stuff here.

== Patches ==

The following patches are used to allow TSRMusic to work with Keen 1–3 (Versions 1.31):

<patch title="Keen 1">
#Play music with TSRMusic:
%patch $BE97 $65
%patch $BEE2 $65
</patch>

<patch title="Keen 2">
#Play music with TSRMusic:
%patch $B5AF $65
%patch $B5FA $65
</patch>

<patch title="Keen 3">
#Play music with TSRMusic:
%patch $C90D $65
%patch $C958 $65
</patch>

== Download ==

* [http://www.shikadi.net/wiki/files/tools/tsrmusic-0.7.zip tsrmusic-0.7.zip] (includes source code, released 2010-07-17)

[[Category:Modding Tools (Vorticons)]]
[[Category:Audio Modding Tools (Vorticons)]]

KeenWiki - User contributions [en-gb]

User:Napalm

TSRMusic