
 Written by John W. Ratcliff (c) 1994
	  Compuserve: 70253,3237
	  Genie: J.RATCLIFF3
	  BBS: 1-314-939-0200
	  Addresss:
			  747 Napa Lane
			  St. Charles, MO 63304

 A $500 per product license fee applies to all commercial software
 products distributed with ANY DIGPAK and another $500 for MIDPAK
 drivers.  That's a total of $1,000 if your product uses BOTH
 DIGPAK and MIDPAK drivers.  If you distribute any commercial title with
 DIGPAK and/or MIDPAK drivers resident then this license fee applies.

 To pay a license, simply write a check for $500 for just DIGPAK $500
 for just MIDPAK, or $1,000 for both DIGPAK and MIDPAK single product
 distribution license payable to:

   The Audio Solution
   747 Napa Lane
   St. Charles, MO 63304

 with a copy of your commerical product.  You will receive a signed
 license agreement from The Audio Solution shortly thereafter. This
 license fee applies specifically to the inclusion with your
 distribution disk any of the DIGPAK and/or MIDPAK drivers. These
 drivers are copyrighted works, created by me, to enhance the use of
 sound and music in DOS based commercial software.  The license
 fees collected are used to maintain the drivers and keep the BBS
 running.

 WARNING!!!!!!	You would be ill-advised to distribute a commercial
 product containing either DIGPAK and/or MIDPAK drivers without having
 paid the distribution license fee.  Since your product would contain
 unlicensed copyrighted software from The Audio Solution, your product
 could be required to be immediately removed from retail distribution.
 I doubt this is going to be a problem.  Clearly if your product is
 enhanced by the use of these drivers, your company can easily afford a
 nominal license fee of $1,000 in exchange for getting the use of
 several man-years of software engineering resources.

Brief documentation concerning the files contained in the flat-model
version of DIGPAK/MIDPAK.

About the source:

	All C was compiled with Watcom's flat-model C compiler.  Executes
	via the DOS4GW dos extender.  All assembly language was produced
	using Borland assembler in ideal mode.	All assembly language
	assumes the ES=DS and both ES and DS are selectors to base address
	000000000000000h in the machine.  This is the assumption for DOS4GW.
	Any changes necessary to work with other DOS extenders is an
	excercise left for the student.  Assumes all pamaters passed to
	assembly routines are on the stack in conventional 'cdecl' format
	with 4 bytes per paramater, even if that paramter is only a one
	byte data item.  This is particular to Watcom and might not be
	true for other compilers.

	All make files are in the format for Microsoft make because
	I have never been able to figure out how Borland's make
	utility works.	Just use the make files as a guidline for
	doing a build.


D.BAT			A batch file to invoke Watcom's piece of crap
			excuse for a 'debugger'.

DIGPLAY.H		The C prototype header file for the DIGPAK
			API link layer.

DIGPLAY.ASM		Borland IDEAL mode, flat-model, assembly language
			source to the DIGPAK API link layer.

DIGPLAY.OBJ		Object module for DIGPLAY.ASM

DOSCALLS.H		C prototype header file for DOSCALLS.ASM low
			memory allocation and de-allocation routines.

DOSCALLS.ASM		Borland IDEAL mode assembly source for DOS
			memory allocations routines.

DOSCALLS.OBJ		Object module for DOSCALLS.ASM

KEYS.H			C prototype header file with #define's for DOS
			extended key codes.

LOADER.H		C prototype header file for the DIGPAK/MIDPAK loader
			system.

LOADER.C                C source to the DIGPAK/MIDPAK loader system.

LOADER.OBJ		Object module for LOADER.C

M.BAT			Batch file to invoke my Microsoft make for the
			DIGPAK/MIDPAK test program.

MIDPAK.H		C prototypes for the MIDPAK API link layer.

MIDPAK.ASM		Borland assembler source to the MIDPAK API link
			layer.

MIDPAK.OBJ		Object module for MIDPAK.ASM

PEND.C			C source to the demonstration program demonstrating
			how to use the DIGPAK PostAudioPending calls and
			auto-init DMA transfer.

PEND.MAK		Microsoft MAKE file to build PEND.EXE

PEND.OBJ		Object module to PEND.C

SEGUE.C 		C source to the MIDPAK example program demonstrating
			how to Segue multiple XMI sequences using the
			controller 119 event controller.

SEGUE.MAK		Microsoft Make file for SEGUE.EXE

SEGUE.OBJ		Object module for SEGUE.C

SUPPORT.H		C prototype header for SUPPORT.C.  Provides basic
			file loading and memory allocation functions needed
			by all programs.

SUPPORT.C		C source code to provide basic file loading and
			memory allocation functions.

SUPPORT.OBJ		Object module for SUPPORT.C

T16.H			C prototype header file for T16.ASM.  Provides
			simple routines to convert an 8 bit mono sound
			effect into various data formats for testing
			purposes in the TEST16 program.

T16.ASM 		Borland Assembler source to tiny sound conversion
			routines.

T16.OBJ 		Object module to T16.ASM

TEST.C			C source to DIGPAK/MIDPAK test program.

TEST.MAK                Microsoft Make to build TEST.EXE

TEST.OBJ		Object module for TEST.C

TEST16.C		C source to DIGPAK test/demonstration program
			that shows using all of the various 8 bit mono/
			stereo and 16 bit mono/stereo DIGPAK functions.

TEST16.MAK		Microsoft make file to build TEST16.EXE

TEST16.OBJ		Object module for TEST16.C

VECTOR.H		C prototype header file to hook and unhook
			VECTOR.COM, the real-mode function call
			manager.

VECTOR.ASM		Borland assembly language source the link layer
			to provide access to VECTOR.COM

VECTOR.OBJ		Object module for VECTOR.ASM

VECTOR.COM		This is a tiny program which hooks through real
			mode interrupt vector 66h, that let's me simulate
			a real-mode far procedure call.  Normally this
			is function 301h of any 0.9 compliant DPMI.  However
			the royalty free version of DOS4GW doesn't support
			this function, so this is a placeholder hack to
			provide real-mode access to far procedues.  A
			requirement for the DIGPAK & MIDPAK dynamic loading
			and unloading mechanism.  Must be in the directory
			of the executable when it runs.

VIDEO.H 		C prototype header file for some very limited
			VGA mode 13h graphics functions used by the PEND
			example program.

VIDEO.ASM		Borland assembly source to some basic Mode 13h
			functions used by the PEND example program.

VIDEO.OBJ		Object module for VIDEO.ASM

