home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / msdos / c / dmkit / flat / readme.prn < prev    next >
Encoding:
Text File  |  1994-01-03  |  6.4 KB  |  183 lines

  1.  
  2.  Written by John W. Ratcliff (c) 1994
  3.       Compuserve: 70253,3237
  4.       Genie: J.RATCLIFF3
  5.       BBS: 1-314-939-0200
  6.       Addresss:
  7.               747 Napa Lane
  8.               St. Charles, MO 63304
  9.  
  10.  A $500 per product license fee applies to all commercial software
  11.  products distributed with ANY DIGPAK and another $500 for MIDPAK
  12.  drivers.  That's a total of $1,000 if your product uses BOTH
  13.  DIGPAK and MIDPAK drivers.  If you distribute any commercial title with
  14.  DIGPAK and/or MIDPAK drivers resident then this license fee applies.
  15.  
  16.  To pay a license, simply write a check for $500 for just DIGPAK $500
  17.  for just MIDPAK, or $1,000 for both DIGPAK and MIDPAK single product
  18.  distribution license payable to:
  19.  
  20.    The Audio Solution
  21.    747 Napa Lane
  22.    St. Charles, MO 63304
  23.  
  24.  with a copy of your commerical product.  You will receive a signed
  25.  license agreement from The Audio Solution shortly thereafter. This
  26.  license fee applies specifically to the inclusion with your
  27.  distribution disk any of the DIGPAK and/or MIDPAK drivers. These
  28.  drivers are copyrighted works, created by me, to enhance the use of
  29.  sound and music in DOS based commercial software.  The license
  30.  fees collected are used to maintain the drivers and keep the BBS
  31.  running.
  32.  
  33.  WARNING!!!!!!    You would be ill-advised to distribute a commercial
  34.  product containing either DIGPAK and/or MIDPAK drivers without having
  35.  paid the distribution license fee.  Since your product would contain
  36.  unlicensed copyrighted software from The Audio Solution, your product
  37.  could be required to be immediately removed from retail distribution.
  38.  I doubt this is going to be a problem.  Clearly if your product is
  39.  enhanced by the use of these drivers, your company can easily afford a
  40.  nominal license fee of $1,000 in exchange for getting the use of
  41.  several man-years of software engineering resources.
  42.  
  43. Brief documentation concerning the files contained in the flat-model
  44. version of DIGPAK/MIDPAK.
  45.  
  46. About the source:
  47.  
  48.     All C was compiled with Watcom's flat-model C compiler.  Executes
  49.     via the DOS4GW dos extender.  All assembly language was produced
  50.     using Borland assembler in ideal mode.    All assembly language
  51.     assumes the ES=DS and both ES and DS are selectors to base address
  52.     000000000000000h in the machine.  This is the assumption for DOS4GW.
  53.     Any changes necessary to work with other DOS extenders is an
  54.     excercise left for the student.  Assumes all pamaters passed to
  55.     assembly routines are on the stack in conventional 'cdecl' format
  56.     with 4 bytes per paramater, even if that paramter is only a one
  57.     byte data item.  This is particular to Watcom and might not be
  58.     true for other compilers.
  59.  
  60.     All make files are in the format for Microsoft make because
  61.     I have never been able to figure out how Borland's make
  62.     utility works.    Just use the make files as a guidline for
  63.     doing a build.
  64.  
  65.  
  66. D.BAT            A batch file to invoke Watcom's piece of crap
  67.             excuse for a 'debugger'.
  68.  
  69. DIGPLAY.H        The C prototype header file for the DIGPAK
  70.             API link layer.
  71.  
  72. DIGPLAY.ASM        Borland IDEAL mode, flat-model, assembly language
  73.             source to the DIGPAK API link layer.
  74.  
  75. DIGPLAY.OBJ        Object module for DIGPLAY.ASM
  76.  
  77. DOSCALLS.H        C prototype header file for DOSCALLS.ASM low
  78.             memory allocation and de-allocation routines.
  79.  
  80. DOSCALLS.ASM        Borland IDEAL mode assembly source for DOS
  81.             memory allocations routines.
  82.  
  83. DOSCALLS.OBJ        Object module for DOSCALLS.ASM
  84.  
  85. KEYS.H            C prototype header file with #define's for DOS
  86.             extended key codes.
  87.  
  88. LOADER.H        C prototype header file for the DIGPAK/MIDPAK loader
  89.             system.
  90.  
  91. LOADER.C                C source to the DIGPAK/MIDPAK loader system.
  92.  
  93. LOADER.OBJ        Object module for LOADER.C
  94.  
  95. M.BAT            Batch file to invoke my Microsoft make for the
  96.             DIGPAK/MIDPAK test program.
  97.  
  98. MIDPAK.H        C prototypes for the MIDPAK API link layer.
  99.  
  100. MIDPAK.ASM        Borland assembler source to the MIDPAK API link
  101.             layer.
  102.  
  103. MIDPAK.OBJ        Object module for MIDPAK.ASM
  104.  
  105. PEND.C            C source to the demonstration program demonstrating
  106.             how to use the DIGPAK PostAudioPending calls and
  107.             auto-init DMA transfer.
  108.  
  109. PEND.MAK        Microsoft MAKE file to build PEND.EXE
  110.  
  111. PEND.OBJ        Object module to PEND.C
  112.  
  113. SEGUE.C         C source to the MIDPAK example program demonstrating
  114.             how to Segue multiple XMI sequences using the
  115.             controller 119 event controller.
  116.  
  117. SEGUE.MAK        Microsoft Make file for SEGUE.EXE
  118.  
  119. SEGUE.OBJ        Object module for SEGUE.C
  120.  
  121. SUPPORT.H        C prototype header for SUPPORT.C.  Provides basic
  122.             file loading and memory allocation functions needed
  123.             by all programs.
  124.  
  125. SUPPORT.C        C source code to provide basic file loading and
  126.             memory allocation functions.
  127.  
  128. SUPPORT.OBJ        Object module for SUPPORT.C
  129.  
  130. T16.H            C prototype header file for T16.ASM.  Provides
  131.             simple routines to convert an 8 bit mono sound
  132.             effect into various data formats for testing
  133.             purposes in the TEST16 program.
  134.  
  135. T16.ASM         Borland Assembler source to tiny sound conversion
  136.             routines.
  137.  
  138. T16.OBJ         Object module to T16.ASM
  139.  
  140. TEST.C            C source to DIGPAK/MIDPAK test program.
  141.  
  142. TEST.MAK                Microsoft Make to build TEST.EXE
  143.  
  144. TEST.OBJ        Object module for TEST.C
  145.  
  146. TEST16.C        C source to DIGPAK test/demonstration program
  147.             that shows using all of the various 8 bit mono/
  148.             stereo and 16 bit mono/stereo DIGPAK functions.
  149.  
  150. TEST16.MAK        Microsoft make file to build TEST16.EXE
  151.  
  152. TEST16.OBJ        Object module for TEST16.C
  153.  
  154. VECTOR.H        C prototype header file to hook and unhook
  155.             VECTOR.COM, the real-mode function call
  156.             manager.
  157.  
  158. VECTOR.ASM        Borland assembly language source the link layer
  159.             to provide access to VECTOR.COM
  160.  
  161. VECTOR.OBJ        Object module for VECTOR.ASM
  162.  
  163. VECTOR.COM        This is a tiny program which hooks through real
  164.             mode interrupt vector 66h, that let's me simulate
  165.             a real-mode far procedure call.  Normally this
  166.             is function 301h of any 0.9 compliant DPMI.  However
  167.             the royalty free version of DOS4GW doesn't support
  168.             this function, so this is a placeholder hack to
  169.             provide real-mode access to far procedues.  A
  170.             requirement for the DIGPAK & MIDPAK dynamic loading
  171.             and unloading mechanism.  Must be in the directory
  172.             of the executable when it runs.
  173.  
  174. VIDEO.H         C prototype header file for some very limited
  175.             VGA mode 13h graphics functions used by the PEND
  176.             example program.
  177.  
  178. VIDEO.ASM        Borland assembly source to some basic Mode 13h
  179.             functions used by the PEND example program.
  180.  
  181. VIDEO.OBJ        Object module for VIDEO.ASM
  182.  
  183.