home *** CD-ROM | disk | FTP | other *** search
/ 1,000 Games / Disc1.iso / ARCADE / ROCKET / S_DR / README.PRN < prev    next >
Encoding:
Text File  |  1995-01-16  |  40.4 KB  |  910 lines

  1.  
  2.    Documentation for the DIGPAK & MIDPAK Developers Kit v1.50
  3.  
  4.  
  5.  
  6.                 by
  7.  
  8.               John W. Ratcliff
  9.            Compuserve: 70253,3237
  10.               Genie: J.RACLIFF3
  11.              BBS: 1-314-939-0200, 14.4kb
  12.  
  13.              TO GET THE DEVELOPERS KIT CALL
  14.              THIS BBS NUMBER AT UP TO 14.4KB
  15.  
  16.              DIGPAK & MIDPAK DEVELOPERS KIT
  17.              EXISTS IN THE MAIN LIBRARY AS:
  18.  
  19.              DMKIT.ZIP
  20.  
  21.  
  22.              Document first draft: January 3, 1994
  23.  
  24.                   second release: March 8, 1994
  25.  
  26.                   third release: March 25, 1994
  27.                          fixes to SB16.COM
  28.                          and first release
  29.                          AWE32 driver.
  30.  
  31.                   fourth release: April 19, 1994
  32.                           BETA VESA release.
  33.  
  34.                   fifth release:  January 1, 1995
  35.                     DIGAUTO, auto-detect DIGPAk
  36.                     TMIX - The new digital mixer!
  37.                     RECORD - audio recording tool
  38.                     PEND - now has volume control too!
  39.  
  40.                   sixth release: January 13, 1995
  41.                     Flat model TMIX now supports
  42.                     MOD files!!!!
  43.  
  44.                   seventh release: January 16, 1995
  45.                    Added protected mode GUS
  46.                    support.
  47.  
  48.  
  49. IMPORTANT NEW FILES FOR BETA VESA RELEASE:
  50.  
  51.  
  52. PASWAVE  COM         6,825  ProAudio Spectrum VESA Driver
  53. SBWAVE     COM         7,091  Creative Labs SoundBlaster VESA Driver
  54. OPL2     COM         6,567  OPL2 VESA MIDI driver (early beta, music
  55.                 implementation very incomplete.)
  56. MPU     COM         4,656  MPU401 VESA MIDI Driver.
  57.  
  58. DIGVESA  COM         5,792  DIGPAK VESA Driver
  59. VESADIG  ADV         6,288  AIL VESA Digital Driver
  60. VESAMID  ADV        12,352  MIDPAK & AIL VESA MIDI Driver
  61. VESAMID  ADD            MIDPAK MIDI Descriptor file.
  62.  
  63. You must load the VESA drivers in your autoexec.bat, or whatever
  64. prior to using the DIGPAK & MIDPAK VESA drivers which talk to that
  65. beta VESA interface.
  66.  
  67. IMPORTANT NEW FILES FOR v1.5 DMKIT RELEASE:
  68.  
  69. PEND.EXE    Now let's you modulate volume on the fly.
  70.  
  71. RECORD.EXE      Records audio and writes it to disk in real-time.
  72.  
  73. DIGAUTO.COM     This is an auto-detect DIGPAK driver.  It fully autodetects
  74.         the 5 most popular sound cards.  It can only be used
  75.         as a TSR, not as a demand loadable driver.
  76.  
  77. TMIX.EXE        The 4 channel digpak digital mixer.  Way cool.
  78.  
  79. MIX1-8.SND      These are test sound effects for the DIGPAK digital
  80.         mixer.    These sound effects are owned by John W. Ratcliff
  81.         and you do not have usage right to these sound effects
  82.         in any fashion.  These sound effects are copyright (c) 1995
  83.         John W. Ratcliff
  84.  
  85. TUNE.MOD        Demonstration MOD file, for the protected mode MOD player.
  86.  
  87. ORPHAN.ZIP    This zip file contains timer based, and other DIGPAK drivers
  88.         for sound cards which now appear to be effectively obsolete
  89.         in the market place.  Not all of these drivers have been
  90.         kept up with more recent revs of DIGPAK, and shouldn't
  91.         be relied upon, without thorough testing for your
  92.         application.  Few, if any, will work in protected mode.
  93.  
  94.  
  95.  
  96.  
  97.              Copyright (c) 1994, 1995
  98.              The Audio Solution
  99.              747 Napa Lane
  100.              St. Charles, MO 63304
  101.  
  102.  
  103.  
  104.         DIGPAK : DOS based digital sound drivers.
  105.              Written by John W. Ratcliff (CIS:70253,3237)
  106.              Copyright (c) 1994, The Audio Solution.
  107.              $500 per/product distribution license fee.
  108.  
  109.         MIDPAK:  DOS based MIDI music player.
  110.              Written by John W. Ratcliff and John Miles
  111.              Copyright (c) 1994, The Audio Solution.
  112.              $500 per/product distribution license fee.
  113.  
  114.  
  115. ==============================================================================
  116. What is DIGPAK and MIDPAK?
  117. ========================================================================
  118. DIGPAK and MIDPAK are a set of drivers which provide a device
  119. independent API layer under DOS real-mode and protected mode that
  120. supports virtually all sound cards.  DIGPAK allows playback of digital
  121. sound and MIDPAK allows the playback of General MIDI music on ALL sound
  122. cards (including Adlib, SoundBlaster, and other non-MIDI devices through
  123. the best MIDI emulation package available.)  DIGPAK and MIDPAK
  124. operate either as DOS TSR's or can be demand loaded and dynamically linked
  125. by your application.  (The preferred method).
  126.  
  127. Unzip this file, with sub-directories, into a directory called THEAUDIO
  128. and point your PATH statement to the directory.  Once you have done this
  129. you can go to any directory on your machine containing MIDI files or
  130. sound files and type MENU to use MIDPAK and DIGPAK to peruse them.
  131.  
  132. DIGPAK & MIDPAK are for use by professional DOS developers who need to
  133. incorporate sound and music in their products across a wide range of
  134. hardware devices.  These tools are not for the layperson, or beginning
  135. programmer.  All programming examples and interface specifications are
  136. presented in the C and 8086/80386 assembly languages.  If you are not
  137. familiar with digital sound, MIDI music, and C and assembly language
  138. programming then this programmers kit is probably not for you.
  139.  
  140. This kit supports both DOS real-mode as well as DOS protected mode
  141. interface layers.  All assembly language source code must be assembled
  142. with Borland Assembler (in IDEAL mode) and the C code may be compiled
  143. with any C compiler.  The real-mode C code presented here was developed
  144. with Borland C 3.1 DOS IDE and the flat-model C code was generated under
  145. Watcom C386 v9.0.
  146.  
  147. ==============================================================================
  148. Who developed DIGPAK & MIDPAK?
  149. ========================================================================
  150. DIGPAK and MIDPAK were developed by John W. Ratcliff, a game developer
  151. for Electronic Arts.  These drivers were created to allow me to
  152. incorporte sound and music in my game Seawolf for Electronic Arts.
  153. MIDPAK uses the MIDI drivers developed by John Miles of Miles Design.
  154.  
  155. ==============================================================================
  156. What's the quickest way to look at the software?
  157. ==============================================================================
  158. Run SETUP to configure both DIGPAK and MIDPAK for your sound card.  Then
  159. type MENU to play some music and sound.  After running SETUP you can
  160. also run TEST, TEST16, or SEGUE, to run the demo programs.
  161.  
  162. ==============================================================================
  163. Who uses DIGPAK & MIDPAK?
  164. ========================================================================
  165. The list which follows are just some of the companies which use the
  166. DIGPAK and MIDPAK drivers in their DOS based entertainment products.
  167.  
  168.  Electronic Arts             Epyx
  169.  Activision                 Fun Univ Netwk
  170.  Spectrum Holobyte             Home Brew Software
  171.  The Software Toolworks          Humongous Entertainment
  172.  SSI, Strategic Simulations Inc.     ICOM Simulations
  173.  Milliken Publishing Company         Interplay
  174.  Commodore Computer             IntraCorp
  175.  Virgin Games                 Kram
  176.  Compu-Teach                 Legacy Software
  177.  Knowledge Adventure             Macmillan/McGraw Hill
  178.  Gametek                 Magnetic Images
  179.  Access Software             MECC
  180.  Alive Software              Merit Software
  181.  Azeroth Publishing             Microleage Sports Assoc.
  182.  Bethesda Softworks             Ninga
  183.  C.R.A.P.O., Inc.             Norsehelm Productions
  184.  Concepteva                 Objects, Inc
  185.  Cooper, R.J. & Assoc.             Optimum Resource
  186.  DC True                 Presage Software Co. Inc.
  187.  Dennis Cunningham             Quantum Quality Productions
  188.  Three-Sixty Pacific             Redwood Games
  189.  Destiny Software             Saddleback Graphics
  190.  Edmark Corpoartion             Safari Software
  191.  Simutronics                 White Wolf Productions, Inc.
  192.  Stragem                 XOR Corporation
  193.  T&t Research                 Trilobyte
  194.  Waterford Institute             Masque Publishing
  195.  Wesson International             Iterated Systems
  196.  
  197.         and many more...
  198.  
  199.  
  200. ==============================================================================
  201. What products use DIGPAK & MIDPAK?
  202. ========================================================================
  203. Below is just a very PARTIAL list of the product that use DIGPAK & MIDPAK
  204. drivers.
  205.  
  206. Guardians of Eden    Access Software         MidPak
  207. Return to Zork        Activision            DigPak
  208. Mechwarrior II        Activision            DigPak
  209. Animal Quest        Alive Software            DigPak+MidPak
  210. Magic Crayon        Alive Software            DigPak+MidPak
  211. VGA Jigsaw        Alive Software            DigPak+MidPak
  212. Inspector Gadget:    Azeroth Publishing        DigPak+MidPak
  213. Terminator 2029     Bethesda Softworks        DigPak
  214. Le Ponctueur        C.R.A.P.O., Inc.        DigPak
  215. Bilou            Concepteva            DigPak
  216. Switch Progressions    Cooper, R.J. & Assoc.        DigPak+MidPak
  217. Switch Quik        Cooper, R.J. & Assoc.        DigPak+MidPak
  218. Stepping Stones Bonus    Compu-Teach, Inc.        DigPak+MidPak
  219. Shadow President    DC True             DigPak
  220. T-Zero            Dennis Cunningham        DigPak+MidPak
  221. Battle Cruiser 3000AD    Three-Sixty Pacific        DigPak
  222. Creepers        Destiny Software        DigPak+MidPak
  223. Millie's Math House     Edmark Corpoartion              DigPak
  224. KidDesk         Edmark Corporation        DigPak
  225. Fun Univ Ntwk Intfc    Fun Univ Netwk            DigPak+MidPak
  226. Wheel of Fortune    Gametek             DigPak+MidPak
  227. Gateworld Trilogy    Home Brew Software        MidPak
  228. PuttPutt's FunPack      Humongous Entertainment         DigPak+MidPak
  229. PuttPutt Joins Parade    Humongous Entertainment     DigPak+MidPak
  230. Fatty Bear        Humongous Entertainment     DigPak+MidPak
  231. PuttPutt Goes to the Moon Humongous Entertainment    DigPak+MidPak
  232. Beyond Shadowgate    ICOM Simulations        DigPak+MidPak
  233. Battle Chess 4000    Interplay            DigPak
  234. Grandmaster Chess    IntraCorp            DigPak+MidPak
  235. Space Adventure     Knowledge Adventure        DigPak
  236. Dinosaur Adventure    Knowledge Adventure        DigPak
  237. Realms of Avarton    Kram                DigPak
  238. Mutanoid Math Challenge Legacy Software         DigPak+MidPak
  239. Mutanoid Word Challenge Legacy Software         DigPak+MidPak
  240. Sights & Sounds     Macmillan/McGraw Hill        DigPak
  241. Places to Play        Magnetic Images         DigPak
  242. Oregon Trail Deluxe    MECC                DigPak+MidPak
  243. Tom Landry Football    Merit Software            DigPak+MidPak
  244. MicroLeague Baseball IV Microleague Sports Assoc.    DigPak+MidPak
  245. MicroLeague Football II Microleauge Sports Assoc.    DigPak+MidPak
  246. Microleage Cards    Microleage Sports Assoc.    DigPak
  247. Math Zone        Milliken Publishing        DigPak
  248. Marvin The Moose    Milliken Publishing        DigPak
  249. Milliken Storyteller    Milliken Publishing        DigPak
  250. Math Sequences        Milliken Publishing        DigPak
  251. Cribbage Master     Ninga                DigPak
  252. Ragarok (Valhalla)    Norsehelm Productions        DigPak
  253. Layout for DOS        Objects, Inc            DigPak+MidPak
  254. Stickybear Townbuilder    Optimum Resource        DigPak
  255. Contraption ZAck    Presage Software Co. Inc.    DigPak+MidPak
  256. Spaceward Ho PC     Presage Software Co. Inc.    DigPak+MidPak
  257. Solitaire's Journey     Quantum Quality Productions     DigPak+MidPak
  258. Pickle Wars        Redwood Games            DigPak+MidPak
  259. Guzzle Puzzles        Redwood Games            DigPak
  260. My Paint        Saddleback Graphics        DigPak
  261. Space Chase 1,2,3    Safari Software         MidPak
  262. GemStone III        Simutronics            DigPak+MidPak
  263. Cyberstrike        Simutronics            DigPak+MidPak
  264. WorldAtlas        The Software Toolworks        DigPak+MidPak
  265. Chessmaster 3000    The Software Toolworks        DigPak
  266. BodyLink        Stragem             DigPak
  267. Pools of Darkness    Strategic Simulations Inc.    DigPak
  268. Gateway to the Savage    Strategic Simulations Inc.    DigPak
  269. DNA Parrot        T&t Research            DigPak
  270. Monopoly Deluxe     Virgin Games            DigPak
  271. Waterford Mental Math    Waterford Institute        DigPak+MidPak
  272. ATC/Tracon        Wesson International        DigPak
  273. Empire Deluxe        White Wolf Productions, Inc.    DigPak+MidPak
  274. NFL Challenge        XOR Corporation         DigPak
  275. Chess Maniac 5,000,001    Spectrum Holobyte        DigPak+AIL
  276. The 7th Guest        Virgin/Trilobyte        DigPak+AIL
  277. Seawolf         Electronic Arts         DigPak+MidPak
  278. KaleidoSonics        Masque Publishing        DigPak+MidPak
  279. Gambit            Electronic Arts         DigPak+MidPak
  280. Warlords II        SSG                DigPak+MidPak
  281.  
  282. ==============================================================================
  283. What type of 'commercial products' does the license fee apply to?
  284. ============================================================================
  285. Any piece of software which uses the DIGPAK & MIDPAK drivers for which
  286. the developer collects a fee REQUIRES a license. Yes, this INCLUDES
  287. shareware proudcts as well as those that sit on the shelf at a computer
  288. store. This also includes distributable multimedia demos, for which the
  289. multimedia authors were paid a fee to create.  If you are bidding on a
  290. multimedia project and intend to use MIDPAK and DIGPAK, then be sure to
  291. include the $1,000 license fee in your budget!
  292.  
  293. If you are making money because of the value that these drivers add to
  294. your product, then we deserve a license.  There are several man-YEARS of
  295. engineering work in these drivers, as well as continued expenses to
  296. maintain them.    The license fee serves as little more than a
  297. 'maintenance' fee for us to keep the drivers up to date, as well as run
  298. the BBS for people to get continued improvements and updates.
  299.  
  300. Do NOT use DIGPAK and MIDPAK if you are not prepared to pay the license
  301. fee.  Every single one of the products and companies listed above have
  302. paid this same license fee for the right to distribute the DIGPAK and
  303. MIDPAK drivers.
  304.  
  305. ==============================================================================
  306. Can I get a DIGPAK and MIDPAK license for a development tool?
  307. ============================================================================
  308. NO!!  The license for DIGPAK and MIDPAK is for multimedia,
  309. entertainment, and educational products which need support for
  310. interactive sound and music.  Development tools based on the DIGPAK and
  311. MIDPAK drivers are NOT allowed!!  If you want to create a development
  312. package that utilizes the DIGPAK and MIDPAK drivers then you must
  313. contact me directly to discuss such an arrangment.  You are NOT allowed
  314. to resell, DIGPAK and MIDPAK drivers under any conditions as a
  315. developers toolkit. This includes any sort of multimedia authoring
  316. toolkit.  The reason for this should be obvious. You would be in effect
  317. re-distributing DIGPAK and MIDPAK drivers license free, to other
  318. developers, and this is not allowed.  That's not to say we can't come to
  319. an agreement, but you cannot obtain a license for any type of
  320. developement or authoring system using DIGPAK and MIDPAK drivers.
  321.  
  322. ==============================================================================
  323. What do I do if I want to add sound and music support by don't want
  324. to pay a license?
  325. ============================================================================
  326. Call Mystic Software at 1-510-865-9189.  The Worx toolkit from Mystic
  327. software does not require any license fee and is a very nice development
  328. package.  Though it does not support as many sound cards as DIGPAK &
  329. MIDPAK, it is a very servicable development tool.
  330.  
  331. ==============================================================================
  332. What if my shareware product has a free portion, and then a registered
  333. portion?
  334. ============================================================================
  335. Then no license fee applies for the FREE version.  If you are developing
  336. public domain tools and utilities that support DIGPAK & MIDPAK, and they
  337. are truely FREE, then no license fee applies.  If that public domain
  338. tool is a development aid, tool, or authoring system, then the DIGPAK
  339. and MIDPAK portion of that tool MUST contain this COMPLETE document and
  340. make it extremely clear that the distribution license fee still applies
  341. to anyone using that authoring tool.
  342.  
  343. ==============================================================================
  344. If I use both DIGPAK and MIDPAK in a product how much is the total
  345. license then?
  346. ============================================================================
  347. $500 for DIGPAK and $500 for MIDPAK, for a total of $1,000.  Even if you
  348. sell 100,000 copies of the product, the license is still only $1,000.
  349. Unfortunatly even if you sell just 100 copies, the fee applies as well.
  350.  
  351. ==============================================================================
  352. How do I pay my license?
  353. ==============================================================================
  354. Write a check payable to The Audio Solution, and include with it a copy
  355. or your product.  Mail the check to:
  356.  
  357.     The Audio Solution
  358.     John W. Ratcliff
  359.     747 Napa Lane
  360.     St. Charles, MO 63304
  361.  
  362. Shortly thereafter you will receive a signed copy of the license agreement.
  363. Once you have paid the license fee, the agreement is considered in effect
  364. and you may distribute your product with the drivers.  You must, however,
  365. pay the license fee PRIOR to your product being shipped.
  366.  
  367. DIGPAK & MIDPAK are copyrighted software components.  If you distribute
  368. The Audio Solution drivers without having a signed license agreement you
  369. will be in violation of our copyright.    Your product could be required to
  370. be immediatly removed from retail distribution.  I don't think this is
  371. going to be a problem.
  372.  
  373. If you don't think DIGPAK & MIDPAK add $1,000 of value to your product, then
  374. do not use them, period.  Use the Worx Toolkit from Mystic, or write your
  375. own sound code.  But DO NOT use these drivers unless you intend to pay the
  376. license fee.
  377.  
  378. All DIGPAK drivers combined equal almost 20,000 lines of assembly code.
  379. And the same is true for all of the MIDPAK drivers.  John Miles and myself
  380. have invested over 4 years creating and maintaining these drivers.  We
  381. are making this developers kit widely available to the developer community
  382. as a service to the industry.  It is our goal to make these excellent
  383. development tools available to everyone.  But we have bills to pay like anyone
  384. else.  As a self-employed entrepenuer I do not get a paycheck,
  385. health insurance, paid vacations, or any of the outher ammenities that
  386. salaried employees have.  If people use these tools to enhance their product
  387. and generate revenue, then I feel strongly that I should be paid a
  388. license fee for these drivers.
  389.  
  390. ==============================================================================
  391. I'm a shareware author and I can't afford $1,000 until I get enough
  392. registrations.    What do I do?
  393. ============================================================================
  394. Send me a copy of your shareware product on my BBS along with a piece of
  395. e-mail explaining your situation.  In most cases I will issue a SHAREWARE
  396. LICENSE AGREEMENT that will require payment of the FULL license fee once
  397. you have received 500 paid registrations for your product.  If you don't
  398. receive 500 registrations, then you will not have to pay the license fee.
  399. But once you have received 500 registrations you MUST pay the license fee.
  400. As a shareware author I'm certain you understand not wanting to be ripped
  401. off, and likewise I would expect you to pay your license for the DIGPAK
  402. and MIDPAK drivers in good faith.  You must come to an agreement with me
  403. prior to the release of your shareware package.
  404.  
  405. ==============================================================================
  406. I'm doing software development for the disabled.  Even though I have
  407. to charge a fee for the software to cover expenses, we are a non-profit
  408. organization.  Could I be exempted from the license fee?
  409. =========================================================================
  410. In general yes.  I would like to provide exemptions to anyone using
  411. DIGPAK and MIDPAK to create software to help the disabled.  However, you
  412. will still need to receive a signed license agreement with that
  413. exemption. Please contact me ahead of time (via Compuserve or my BBS),
  414. and let me know about what you are doing.  When your project is complete
  415. you will receive a signed distribution license agreement, with the
  416. exemption.  Simply send me a copy of your product and a check for $1 to
  417. cover the license fee.    This DOES NOT include EDUCATIONAL SOFTWARE
  418. created by any FOR PROFIT organization.
  419.  
  420. ==============================================================================
  421. What kind of digitized sound format does DIGPAK support?
  422. ==========================================================================
  423. None.  DIGPAK is a low-level API layer.  It simply insulates the programmer
  424. from having to talk DIRECTLY to the hardware.  The data you pass to DIGPAK
  425. is the same data you would have been passing to the sound card itself.
  426. DIGPAK requires raw 8 bit unsigned PCM data in the first 1mb of address
  427. space in under 64k lengths.  Stereo 8 bit support is provided with
  428. interleaved left channel/right channel 8 bit samples.  Support for
  429. 16 bit digital sound in DIGPAK is provided through raw 16 bit SIGNED
  430. data.  Why signed?  Because every single 16 bit PC sound card I have
  431. encountered supports 8 bit unsigned PCM and 16 bit signed PCM.    The
  432. DIGPAK drivers, in almost every case, simply passes that chunk of
  433. audio data out to the DMA controller.
  434.  
  435. Interpreting .WAV files, .VOC files, or .ANYTHING files is a higher application
  436. level problem, one that you will have to provide support for yourself.    Since
  437. I always use audio data in RAW format by brining it over from the Macintosh
  438. I have no use or need for various sound file formats.
  439.  
  440. If you don't know what 8 bit unsigned PCM, 8 bit interleaved sound, and
  441. 16 bit signed sound means, then you will have to ask around on the networks
  442. or read some books.  Though I have insulated the user from the ugly
  443. details of the hardware layer, I can't insulate you from knowing about
  444. sound programming.  That you will still have to do on your own.
  445.  
  446. ==============================================================================
  447. How do I play many sounds at once?
  448. ==============================================================================
  449. DIGPAK supports only a single channel of sound at once, which reflects
  450. the nature of almost every single PC sound card on the market.    To play
  451. multiple sounds at one time requires that you 'mix' digital sound
  452. samples in real-time.  Under protected mode DIGPAK I have a digital mixer
  453. that keeps a constantly running stream of audio data, up to 16 channels
  454. in 16 bit 11khz stereo in real-time taking almost none of the machine's
  455. CPU.
  456.  
  457. With this release (v1.5) there is now a full 4 channel digital mixer for
  458. DIGPAK, look at the demo application TMIX
  459.  
  460. ==============================================================================
  461. How do I get technical support?
  462. ==============================================================================
  463. You ask around.  Look at the list of products above.  DIGPAK and MIDPAK work.
  464. Many other programmers as well as myself have been able to do tremendous
  465. things with the DIGPAK and MIDPAK programming interface.  Just look at any
  466. of the PuttPutt products from Humongous Entertainment, or the music and sound
  467. in The 7th Guest (which doesn't directly use MIDPAK but uses the same MIDI
  468. driver and patch bank).  Programming a computer is extremely difficult.
  469. That's why I have provided and will continue to provide lots of sample
  470. source code for DIGPAK and MIDPAK.
  471.  
  472. But I cannot provide one-on-one technical support.  I have to write my games
  473. too, and I have found out that just answering hundreds of people's programming
  474. questions is a full-time job I'm not capable of keeping up with.  First
  475. of all DIGPAK and MIDPAK licenses barely cover the cost of keeping the BBS
  476. up and running.  Nobody wants me to charge even MORE for the drivers.
  477.  
  478. I haven't sold the DIGPAK and MIDPAK programmers kit for over a year.  By
  479. making the DIGPAK and MIDPAK programmers kit widely available electronically
  480. I hope to make lots of people educated in the use of the DIGPAK and MIDPAK
  481. programmers interface.    Thus help will be available on the Internet,
  482. Compuserve, and other places in the electronic community.
  483.  
  484. ==============================================================================
  485. What about VESA?
  486. ==============================================================================
  487. The multimedia sound card industry is highly political.  I am fully
  488. supporting the VESA standard for sound and music.  But it's not going to
  489. happen overnight.  It will take at least the next 18 months before you
  490. will be able to get the kind of sound driver support under VESA that is
  491. currently available with DIGPAK and MIDPAK.  Additionally DIGPAK and
  492. MIDPAK act as a value added API layer on top of VESA.  Especially MIDPAK
  493. which provides extensive support for midi parsing, and interrupt service
  494. control.
  495.  
  496.  
  497. ==============================================================================
  498. How do I use DIGPAK drivers?
  499. ==============================================================================
  500. The DIGPAK drivers all have the filename extension of .COM.  Starting at
  501. byte offset 3 from the beginning of the file is the ascii string
  502. 'DIGPAK'.  The default DIGPAK driver should always be copied to the
  503. filename SOUNDRV.COM.  DIGPAK drivers hook user interrupt vector 66h,
  504. which is documented briefly in the book 'PC Interrupts: A Programmer's
  505. Reference To BIOS, DOS, and Third-Party Calls' by Ralf Brown and Jim
  506. Kyle, published by Addison Wesley.
  507.  
  508. You configure a DIGPAK driver by running the program SETD.EXE.
  509.  
  510. The complete API documentation for DIGPAK is in the file DIGPKAPI.DOC.
  511. The C link layer for DIGPAK is through the C prototype header file
  512. DIGPLAY.H and by linking to the object module DIGPLAY.OBJ produced
  513. from DIGPLAY.ASM.
  514.  
  515. A DIGPAK driver can be loaded as a TSR simply by typing it's name.
  516. You can load the default sound driver, as a TSR, by typing 'SOUNDRV'
  517. and hitting enter.  You can unload that driver by typing 'SOUNDRV U'.
  518. The preferred method of using a DIGPAK driver is to demand load it
  519. in your program.  This is done by including the header file LOADER.H
  520. in your program and linking to LOADER.C.
  521.  
  522. Simply look at the sample program TEST.C which fully demonstrates
  523. loading both DIGPAK and MIDPAK and plays both music and sound effects.
  524.  
  525.  
  526. ==============================================================================
  527. How do I use MIDPAK drivers?
  528. ==============================================================================
  529. The SETM program will configure MIDPAK appropriately for your sound card
  530. configuration.    SETM creates the three file components for MIDPAK.  They
  531. are MIDPAK.COM, MIDPAK.ADV, and MIDPAK.AD. MIDPAK.COM is the MIDPAK
  532. driver itself, which provides the API functionality through user
  533. interrupt vector 66h.  MIDPAK loads into INT 66h as a layer ON TOP OF
  534. DIGPAK.  Meaning if you want to use both DIGPAK and MIDPAK at the same
  535. time, you first load DIGPAK, and then load MIDPAK.  The file MIDPAK.ADV
  536. is the AIL MIDI driver from Miles Design Inc.  MIDPAK represents a
  537. subset of the full AIL specification.  The complete AIL (Audio Interface
  538. Library) supports vastly greater interactive control over music.  If you
  539. are interested in purchasing the complete AIL system you can call Miles
  540. Design at 1-512-345-2642.  The AIL license includes full-source code
  541. disclosure, real-mode, protected mode, and Windows DLL versions, and a
  542. $7,500 one-time license fee (not for all three versions, but for each).
  543. Please don't call if you aren't prepared to pay the full license amount.
  544.  
  545. The last file is MIDPAK.AD.  This is the instrument definition file for
  546. OPL2 and OPL3 base sound cards (adlib, soundblaster, etc.).  This file
  547. is ignored on hardware MIDI implementation sound cards like the Sound
  548. Canvas, but is still must exist in the directory at load time.
  549.  
  550. This instrument file conforms to the general MIDI specification and
  551. was created by The Fat Man.  There is a distribution license fee
  552. associated with the use of this MIDPAK.AD file!  You must mail a
  553. copy of your product, a check for $1, and include the following credit:
  554.  
  555.  "General MIDI patches (c) 1994 The Fat Man and K. Weston Phelan"
  556.  
  557.  
  558.     The Fat Man
  559.     7611 Shoal Creek Blvd.
  560.     Austin, TX 78757
  561.     1-512-454-5775
  562.     BBS: 1-512-454-9990
  563.  
  564. Call the Fat Farm BBS to obtain more detailed information regarding the
  565. General MIDI license agreement.
  566.  
  567. Like DIGPAK, MIDPAK can be loaded and unloaded as a TSR.  Simply type
  568. 'MIDPAK' and it will load and stay resident.  Typing 'MIDPAK U' will
  569. unload the MDIPAK driver.
  570.  
  571.  
  572. ==============================================================================
  573. What is 'eXtended MIDI'?
  574. ==============================================================================
  575. MIDPAK, because it uses the AIL drivers from Miles Design, does not play
  576. MIDI files DIRECTLY.  Your MIDI file must be converted into eXtended
  577. MIDI format.  This is a pre-parsed MIDI file format created by Miles Design.
  578. The eXtended MIDI file format supports multiple MIDI sequences in a
  579. single file, that MIDPAK will let you switch to almost instantly using
  580. the PlaySequence command.  You add multiple MIDI files to a single eXtended
  581. MIDI file (XMI) as follows:  Say you have three song files call SONGA.MID
  582. SONGB.MID and SONGC.MID and wanted to put them all in one XMI file.
  583. You would do the following:
  584.  
  585.     MIDIFORM SONG.XMI SONGA.MID SONGB.MID SONGC.MID
  586.  
  587. This places the three MIDI sequences into the single eXtended MIDI
  588. file SONG.XMI.    They would be accessed in MIDPAK as PlaySequence(0)
  589. PlaySequence(1) and PlaySequence(2).
  590.  
  591.  
  592. ==============================================================================
  593. What format should the MIDI data be in?
  594. ==============================================================================
  595. On a true MIDI device like an MPU401 MT-32 or SoundCanvas, exactly what
  596. is found in the MIDI stream is passed to the device.  So however that
  597. MIDI device responds to MIDI is what gets passed down.    (Excluding
  598. SysEx messages).
  599.  
  600. But on an Adlib or SoundBlaster MIDPAK EMULATES a MIDI device.    And that
  601. EMULATION has certain restrictions.
  602.  
  603. Channels 2-9 are the melodic tracks.
  604. Channel  10 percussions.
  605.  
  606. The patch set is in the general MIDI format.
  607.  
  608. I know very little about MIDI, and rely heavily on professional MIDI
  609. composers to provide my music.    To get your MIDI music into MIDPAK
  610. compatible format so that is sounds GREAT, you can contact the
  611. following composers:
  612.  
  613.  
  614.     Wallace Music & Sound
  615.     Rob Wallace, Executive Producer
  616.     6210 West Pershing Avenue
  617.     Glendale, Arizona 85304-1141
  618.     1-602-979-6201
  619.  
  620.     Computer Music Consulting
  621.     Donald S. Griffin
  622.     239 Richland Avenue
  623.     San Francisco, CA 94110
  624.     415-285-3852
  625.  
  626.     The Fat Man
  627.     7611 Shoal Creek Blvd.
  628.     Austin, TX 78757
  629.     1-512-454-5775
  630.  
  631. These guys have all done numerous projects composing with AIL and
  632. MIDPAK.  They know how to make an Adlib, SoundBlaster, and SoundCanvas
  633. sound AWESOME.    But they are also professionals.  Please DO NOT CALL
  634. any of these guys unless you are prepared to accept a bid for a project.
  635.  
  636. If you think the license fee for MIDPAK at $500 is high, then wait
  637. until you find out how much a professional music score costs.  Even
  638. for a small project you are talking several thousand dollars.  So
  639. unless you have a legitimate music budget please do not call these
  640. guys.
  641.  
  642. I would recommend that you call Rob Wallace and get a bid on having
  643. all of your musical scores tweaked for the various sound cards.
  644.  
  645.  
  646. ==============================================================================
  647. When I play my MIDI music with MIDPAK some of the music seems to be missing?
  648. ==============================================================================
  649. Check your channel assignments.  MIDI emulation on SoundBlaster etc, occurs
  650. on channels 2-9 for melodic tracks, and channel 10 for percussions.  A lot
  651. of sequencing software saves MIDI out starting with channel 1.    Channel
  652. 1 is ignored under MIDPAK's MIDI emulation.  MIDPAK channel assignments
  653. were designed to emulate those of a Roland MT-32.  Even though we have
  654. provided a set of General MIDI patch assignments, the channel assignments
  655. are still limited to 2-9 and 10 as indicated here.
  656.  
  657. ==============================================================================
  658. The music on MIDPAK sounds differently than inside my sequencer?
  659. ==============================================================================
  660. Your sequencer is using a different set of patchs than MIDPAK uses.  Contact
  661. any of the composers mentioned above to get your MIDI tweaked to sound good
  662. with the MIDPAK patches.  BE PREPARED TO PAY A REASONABLE FEE FOR THIS
  663. SERVICE!!  I strongly recommend getting your music done professionally.
  664. The composers listed above have great experience at making music
  665. sound good with MIDPAK.
  666.  
  667. ==============================================================================
  668. When I specify a volume change with MIDPAK nothing happens?
  669. ==============================================================================
  670. MIDPAK's volume changes are relative to the base volume for that channel.
  671. If you didn't specify a base volume for each channel in your MIDI file then
  672. MIDPAK can't change the volume.  You specify the base volume for a MIDI channel
  673. with a controller 7.
  674.  
  675. ==============================================================================
  676. Can I use the same MIDI file for all sound cards?
  677. ==============================================================================
  678. No.  But you can come close.  Start by scoring for general MIDI, but it's
  679. best to tweak for SoundCanvas, General MIDI, OPL2/OPL3, and re-patch for
  680. MT-32.    Base volumes are quite a bit different on each device, and different
  681. patches sound better/worse across these devices.  The source code to the
  682. SETM (MIDPAK configuration program) is provided within (SETUP.ZIP) and
  683. depending on which sound driver the user selects you can copy different
  684. versions of your music.
  685.  
  686. ==============================================================================
  687. Why does MIDPAK hang under Windows?
  688. ==============================================================================
  689. Because of a bug in Microsoft Windows it doesn't support all of the
  690. hardware interrupts on the machine.  Specifically the CMOS real-time
  691. clock which MIDPAK uses.  If you use the TMIDPAK.COM version if MIDPAK
  692. this will work under Windows but it might casue other conflicts with
  693. your application.  One option is to use PMIDPAK.COM (polled MIDPAK) and
  694. to service the MIDI interrupt (at 120hz) yourself.
  695.  
  696.  
  697. ==============================================================================
  698. What are all of these files?
  699. ==============================================================================
  700.  
  701. ADLIB.ADV    Adlib AIL MIDI driver.
  702. ADLIB.ADD    Description file for ADLIB.ADV
  703. ADLIB.COM    DIGPAK Adlib digital sound driver.
  704.  
  705. ADLIBG.COM    Adlib Gold DIGPAK sound driver.
  706. ADLIBG.ADV    Adlib Gold AIL MIDI driver.
  707. ADLIBG.ADD    Description file for ADLIBG.ADV
  708.  
  709. AGU16.XMI    Demonstration MIDI file by The Fat Man
  710. AGU16.DES    MENU Description file for AGU16.XMI
  711.  
  712. ARIA.COM    DIGPAK sound driver for Sierra Semiconductors Aria cards.
  713. ARIAXMID.ADV    Aria AIL MIDI driver.
  714. ARIAXMID.ADD    Description file for ARIAXMID.ADV
  715. GM2.BNK     General MIDI intrument file for ARIA (REQUIRED!)
  716.  
  717. BIGMOUTH.COM    DIGPAK driver for Talking Technologies BigMouth card.
  718.  
  719. CMIDPAK.COM    CMOS real-time clock version of MIDPAK>
  720.  
  721. COOL!.SND    Demonstration sound effect from Wallace Music & Sound
  722. COOL!.DES    MENU Description file for COOL!.SND
  723.  
  724. CREDITS.XMI    Demonstration MIDI file from Wallace Music & Sound
  725. CREDITS.DES    MENU Description file for CREDITS.XMI
  726.  
  727. CVXSND.COM    DIGPAK sound driver for Covox Speech Thing.
  728.  
  729. DESERT.XMI    Demonstration MIDI file from Wallace Music & Sound
  730. DESERT.DES    MENU Description file for DESERT.XMI
  731.  
  732. DIGISP.COM    DIGPAK driver for Digispeech DS201.
  733.  
  734. DIGPKAPI.DOC    API Specification Documentation for DIGPAK.
  735.  
  736. DIGVESA.COM    DIGPAK sound driver for VESA compliant Wave interface.
  737.  
  738. DOS4GW.EXE    DOS 4GW DOS Extender used for Flat-Model DEMO programs.
  739.  
  740. EARTH.XMI    Demonstration MIDI file from Wallace Music & Sound
  741. EARTH.DES    MENU Description file for EARTH.XMI
  742.  
  743. ECHOII.COM    DIGPAK sound driver for Street Electronics Echo II
  744.  
  745. FAT.OPL     MIDPAK General MIDI patch set by the Fat Man.
  746.  
  747. FLAT <DIR>    Contains full source to protected mode interface for
  748.         DIGPAK & MIDPAK.
  749.  
  750. GENMID.ADV    AIL MPU401 General MIDI driver.
  751. GENMID.ADD    Description file for GENMID.ADV
  752.  
  753. GF166.COM    DIGPAK driver for Gravis Ultrasound
  754. GF1MIDI.ADV    AIL MIDI driver for Gravis Ultrasound
  755. GF1MIDI.ADD    Description file for GF1MIDI.ADV
  756.  
  757. GU23.XMI    Demonstration MIDI file by The Fat Man
  758. GU23.DES    MENU Description file for GU23.XMI
  759.  
  760. IBM1BIT.COM    DIGPAK PC Speaker driver 1 bit sound.
  761. IBMBAK.COM    DIGPAK PC Speaker driver, foreground only.
  762. IBMSND.COM    DIGPAK PC Speaker driver, limited background audio.
  763.  
  764. LANTSND.COM    DIGPAK driver for Lantastic Audio Adaptor from Artistoft.
  765.  
  766. LSIZE.COM    DIGPAK driver for the Life Size Sound Enhancer.
  767.  
  768. MAJESTY.XMI    Demonstration MIDI file from Wallace Music & Sound
  769. MAJESTY.DES    MENU Description file for MAJESTY.XMI
  770.  
  771. MARIO.XMI    Demonstration MIDI file from Wallace Music & Sound
  772. MARIO.DES    MENU Description file for MARIO.XMI
  773.  
  774. MENU.EXE    MIDPAK & DIGPAK Music & Sound browser.
  775.  
  776. MIDIFORM.EXE    Convert MIDI files into eXtended MIDI file format (XMI)
  777.  
  778. MIDPAK.ADV    Currently configured AIL MIDI driver.
  779. MIDPAK.COM    Currently configured MIDPAK driver.
  780. MIDPAK.AD    Currently configured MIDPAK patch bank file.
  781.  
  782. MIDPKAPI.DOC    API Specification Documentation for MIDPAK.
  783.  
  784. MT32MPU.ADV    AIL MIDI driver for MT-32/LAPC
  785. MT32MPU.ADD    Description file for MT32MPU.ADV
  786.  
  787. MULTISND.ADV    Turtle Beach Multisound AIL MIDI driver.
  788. MULTISND.ADD    Description file for MULTISND.ADV
  789. MULTISND.COM    DIGPAK Turtle Beach Multisound driver.
  790.         (BETA, requires PRESETS utility to have been run,
  791.         see TURTLE.ZIP)
  792.  
  793. NEWS.XMI    Demonstration MIDI file from Wallace Music & Sound
  794. NEWS.DES    MENU Description file for NEWS.XMI
  795.  
  796. NOSOUND.COM    Functional DIGPAK driver that plays no sound.  Responds
  797.         to all DIGPAK functions, for timing considerations but
  798.         takes little CPU.  Sometimes preferable over the lame
  799.         PC Speaker drivers.
  800.  
  801. PAS16.COM    DIGPAK sound driver for MediaVision ProAudio Spectrum 16
  802.         and Logitech Soundman 16.  Full 16 bit sound support.
  803.  
  804. PASFM.ADV    AIL MIDI driver for ProAudio Spectrum
  805. PASFM.ADD    Description file for PASFM.ADV
  806.  
  807. PASOPL.ADV    AIL MIDI driver for ProAudio Spectrum 16, etc.
  808. PASOPL.ADD    Description file for PASOPL.ADD
  809.  
  810. PAUDIO.COM    ProAudio Spectrum DIGPAK sound driver.
  811.  
  812. PCSPKR.ADV    AIL PC Speaker driver (only responds to channel 2 of MIDI)
  813. PCSPKR.ADD    Description file for PCSPKR.ADV
  814.  
  815. PEND.EXE    Flat model demo program, uses PostAudioPending calls
  816.         and auto-init DMA.  To use type PEND PEND.SND after
  817.         you have configured a DIGPAK sound driver.
  818.  
  819. PEND.SND    Demo sound effect for PEND.EXE
  820.  
  821. PMIDPAK.COM    Polled version of MIDPAK.  Application required to
  822.         provide timer services.
  823.  
  824. REAL<DIR>    Demonstration source code in normal DOS real-mode.
  825.  
  826. REMOVE.BAT    Batch file to remove configured MIDPAK and DIGPAK
  827.         sound drivers.
  828.  
  829. SB16.COM    BETA DIGPAK sound driver for SoundBlaster 16.
  830.         Supports 16 bit stereo sound.
  831.  
  832. SBCLONE.COM    DIGPAK sound driver for SoundBlaster Clones.
  833.  
  834. SBFM.ADV    AIL SoundBlaster MIDI driver.
  835. SBFM.ADD    Description file for SBFM.ADV
  836.  
  837. SBLASTER.COM    Creative Labs SoundBlaster DIGPAK sound driver.
  838.  
  839. SBP1FM.ADV    AIL SoundBlaster Pro original MIDI driver.
  840. SBP1FM.ADD    Description file for SBP1FM.ADV
  841.  
  842. SBP2FM.ADV    AIL SoundBlaster Pro current MIDI driver (OPL3).
  843. SBP2FM.ADD    Description file for SBP2FM.ADV
  844.  
  845. SBPRO.COM    Creative Labs SoundBlaster Pro DIGPAK sound driver.
  846.  
  847. SC32MPU.ADV    AIL MIDI driver for Roland Sound Canvas
  848. SC32MPU.ADD    Description file for SC32MPU.ADV
  849.  
  850. SEA.XMI     Demonstration MIDI file from Wallace Music & Sound
  851. SEA.DES     MENU Description file for SEA.XMI
  852.  
  853. SEGUE.EXE    Demonstration flat model program using SegueSequence.
  854.  
  855. SENSAT.ADV    AIL MIDI driver for Tandy Sensation.
  856. SENSAT.ADD    Description file for SENSAT.ADV
  857.  
  858. SETD.SND    Demonstration sound effect for DIGPAK setup program SETD
  859. SETD.EXE    DIGPAK setup/config program.  Source in SETUP.ZIP
  860. SETD.DES    MENU Description file for SETD.SND
  861.  
  862. SETM.XMI    Demonstration MIDI file for MIDPAK setup program SETM
  863. SETM.EXE    MIDPAK setup program. Source code in SETUP.ZIP
  864. SETM.DES    Description file for SETM.XMI
  865.  
  866. SETUP.ZIP    Source code to SETM and SETD.  Borland C 3.1 format.
  867.  
  868. SETUP.BAT    Batch file to configure both DIGPAK and MIDPAK drivers.
  869.  
  870. SHYA!.SND    Demonstration sound effect from Wallace Music & Sound
  871. SHYA!.DES    MENU Description file for SHYA!.SND
  872.  
  873. SKY.XMI     Demonstration MIDI file from Wallace Music & Sound
  874. SKY.DES     MENU Description file for SKY.XMI
  875.  
  876. SMSND.COM    Covox Voice Master II, SoundMaster I, DIGPAK driver.
  877.  
  878. SNDSYS.COM    Microsoft Windows Sound System DIGPAK driver.
  879.  
  880. SOUNDRV.COM    Default configured DIGPAK sound driver.
  881.  
  882. SOURCE.COM    Walt Disney Sound Source DIGPAK sound driver.
  883.  
  884. STFX.COM    ATI Stereo FX DIGPAK sound driver.
  885.  
  886. TANEXTX.COM    Tandy EX/TX/SX/HX PC jr, DIGPAK sound driver.
  887.  
  888. TANSLTL.COM    Tandy Sensation DIGPAK sound driver.
  889.  
  890. TEST.EXE    Flat Model DIGPAK/MIDPAK demonstration program.
  891. TEST.SND    Demonstration sound effect.
  892. TEST.XMI    Demonstration MIDI file.
  893. TEST1.SND    Another test sound effect.
  894. TEST16.EXE    Flat model DIGPAK demo program of all DIGPAK play modes.
  895. TEST2.SND    Another test sound effect.
  896.  
  897. TITLE.XMI    Demonstration MIDI file from Wallace Music & Sound
  898. TITLE.DES    Description file for TITLE.XMI
  899.  
  900. TMIDPAK.COM    8253 Timer Based MIDPAK.
  901.  
  902. VECTOR.COM    Interrupt vector handler used by flat-model demo programs.
  903.  
  904. VMSND.COM    Covox Voice Master I DIGPAK sound driver.
  905.  
  906. WSS.ADV     AIL MIDI driver for Microsoft Windows Sound System.
  907. WSS.ADD     Description file for WSS.ADV
  908.  
  909.  
  910.