home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 18 / CD_ASCQ_18_111294_W.iso / dos / prg / bas / ruckus / newstuf / readme < prev    next >
Text File  |  1994-10-21  |  8KB  |  172 lines

  1. Documentation on use is at end of this text.
  2.  
  3. ----------------------
  4. 21-Oct-94  Jaleo 0.63z
  5.  
  6. Version included with Ruckus 1.1 shareware release.
  7.  
  8. ---------------------
  9. 8-Oct-94   Jaleo 0.63
  10.  
  11. MIDI files with SysEx events could cause problems in the 0.62 version
  12. code when using the GUS device, though you may not have noticed any problem.
  13.  
  14. ---------------------
  15. 26-Sep-94  Jaleo 0.62
  16.  
  17. HIMEM.SYS can now be used.
  18.  
  19. HIMEM.SYS is limited to 128 handles, and defaults to only 32.  To get 128
  20. use /NUMHANDLES=128.  More might be available under Windows enhanced.  Best,
  21. get 386MAX, or QEMM, or Memory/Net Commander, or something that permits more
  22. than 128 XMS handles.  (One handle is used for each SuperCached patch, plus
  23. one for the INI and another for housekeeping.)
  24.  
  25. ----------------------
  26. 25-Sep-94  Jaleo 0.61b
  27.  
  28. This is Jaleo.  It's not quite ready for prime-time, but sure is close.
  29. It supports MIDI playback on OPL2, OPL3 (stereo), MPU-401 (generic, and
  30. specific support for TBS Maui and Rio), and the GUS (including SuperCache
  31. and patch caching).
  32.  
  33. ===========================================================================
  34. How To Use Jaleo
  35.  
  36. Jump start:
  37.  
  38.         0. You must SET PATDIR=path of R2*.INI and OPL *.PAT files
  39.  
  40. This must be set if you play a file from other than the current directory.
  41. For example, if Jaleo's support files are in D:\TEST, do:
  42.  
  43.         C>set PATDIR=d:\test
  44.  
  45. GUS users see R2GUS.INI files for additional path requirements.
  46.  
  47.  
  48.         1. move MC (mouse cursor) to upper-right area and click
  49.         2. at first box (Setup), click the down arrow
  50.         3. select MIDI
  51.         4. change anything in the dialog box (default should be okay)
  52.         5. select okay
  53.         6. move MC to upper-left area and click
  54.         7. at first box (MIDI), click on device to use
  55.         8. change anything in the dialog box
  56.            (default should be okay, but if OPL3 and SB-Pro, set
  57.             base port to 2x0 (as in 220, 240, etc.))
  58.         9. select init or cancel
  59.            (only way to close the dialog box is to successfully init
  60.             or to cancel)
  61.        10. move MC to upper-right, click on FILE box down arrow
  62.        11. select PLAY FROM
  63.        12. at file dialog box, select drive (if needed), and move to
  64.            any directory (if needed), then pick up to 8 MIDs
  65.        13. select okay
  66.        14. press Play
  67.        15. alt-X is the only way to exit
  68.  
  69.  
  70. Odds and evens and in-betweens:
  71.  
  72. 1) GUS in Windows needs to use PIO (selected with DMArate) unless you
  73. don't have the Gravis Windows driver installed, then you can use DMA.
  74. The Gravis VxD prevents notification of a DMA TC IRQ and so will time-
  75. out.
  76.  
  77. GUS users will probably want to boost the PercEQ to +6dB or so.  This
  78. is in the MIDI setup dialog box.  Makes a big difference.
  79.  
  80. 2) Jaleo under Windows enhanced mode reports a CPU MHz rate always
  81. lower than it really is (I've seen from 5% to 50% of true speed).  The
  82. CPU Load% bar and readings, likewise, are skewed to nonsense (the
  83. bar is pegged at 100%, as are the readings).  No ill effects -- it's
  84. just the way Windows 3.x works.  OS/2 should report correct results for
  85. both MHz and Load%, though it won't allow any of the font changes
  86. (I don't think it will, anyway).
  87.  
  88. 3) Not sure how any of this runs in OS/2 2.0 (not recommended when
  89. using the DMA routines since 2.0 doesn't support VDS).  Should run
  90. a-okay in 2.1.  OS/2 behaves more like DOS in a VDM than Windows
  91. 3.x ever could, especially when you need to get directly to the metal.
  92.  
  93. 4) A short error-is text message to accompany error numbers. See the
  94. errcode.txt file for more detail on those.
  95.  
  96. 5) Color VGA is recommended.  Mono VGA should do okay.  CGA should have
  97. its colors mapped okay, and same with MDA, but results will be less than
  98. intended (and not much was intended to begin with).
  99.  
  100. 6) Rio/Maui users, when selecting specific support during init (i.e.,
  101. not generic MPU-401 device), the DevLvl should be set to -6dB or lower
  102. (as in -9, etc.).  Or, you can validate that no "DAC saturation" is
  103. occuring by looking at the pL: and pR: (peak L/R) and sC: (saturation
  104. count, to 32) which is updated every 7 seconds.  This info is in the
  105. LOAD-STAT view screen, at the lower-right.  Values of 7FFF means that
  106. that channel's DAC (left/right) is clipping.  The sC: value indicates
  107. how many times it has clipped since the last reading (taken once every
  108. seven seconds or so).  The access to on-board state info does tend
  109. to slow things down, so best results when using the Rio/Maui selection
  110. is to use a view other than LOAD-STAT, or to simply select "generic".
  111. Using the IRQ line would improve things when waiting for specific data
  112. from the device -- but you don't really need to read access the device
  113. while playing something, except if you want to look at those peak levels.
  114.  
  115. 6a) SB16 + Rio users may want to use a /OPGAIN:3 since lower (1 or 2)
  116. results in too low of an output level, and 4 or higher seems to cause
  117. the SB16 grief (especially the right channel which pops obnoxiously).
  118. It's a shame that the Rio has to be mated to the SB16, considering how
  119. poor quality the SB16 is (SB line in general if you want my opinion).
  120.  
  121.  
  122. For AWE32 support -- it is not planned, nor possible, until Creative Labs
  123. releases adequate low-level documentation for it.  CL's current policy
  124. is to restrict all programming development to in-house, CL drivers.  Take
  125. my advice, don't buy an AWE32.  You'll just be throwing out $300.  The
  126. SB16 part of the AWE32 is of the same quality as regular SB16s, low.  Buy
  127. something else, you'll be glad you did.
  128.  
  129.  
  130. 7) Rio/Maui users can set the number of voices if Rio/Maui support is
  131. specifically specified (i.e., not generic MPU-401 device).  All MPU
  132. devices play only extended WDS (Windows dual-sequenced files) correctly,
  133. so do not select basic WDS (none is fine).  The IRQ line is not required.
  134.  
  135. 8) The 4op OPL patches are included though a 4op switch in this version
  136. is not provided.  Basically a UI problem (have to code a channel selection
  137. routine (those 012345...EF drop menus).  They need work, anyway, but then
  138. so do the 2op ones.  A patch editor is already available.
  139.  
  140. 8a) OPL users may want to reset the device (just drop the DEVICE MIDI and
  141. select OPLx again) to clear any remaining sound from an early out (stop
  142. pressed).  I just noticed this (at a high volume).  The included MIDI
  143. file sounds very good on the Rio; pretty good on the GUS, but pretty odd
  144. on the OPLs.  If you want to move into decent sound, pick up a Turtle Beach
  145. Maui.  About $130 mail-order.  It's a stand-alone MIDI soundcard (MPU-401
  146. UART compatible, which is perfect).  You can use it with your current
  147. SB, PAS, or whatever, to replace the often-funky sounding OPLx hardware.
  148. ...Night and Day.
  149.  
  150.  
  151. 9) The AIR value (in MIDI SETUP) should be at least 50% of DIR for good
  152. results.  Less is okay, but you may notice slurring of notes.  Bump the
  153. AIR (actual interrupt rate) to around 512 and all will be peachy (or try
  154. 32 if you want, or even 8192).  The GUS has an onboard clock source that
  155. can be used (other cards currently need to use timer-0 or the RTC) and
  156. its clock works with DIR=AIR (or close).  The GUS can also use the other
  157. two clock sources.
  158.  
  159. 10) The SuperCache system is for the GUS and can load the entire standard
  160. patch set (5.5MB) into extended memory for near-instant loads.  Patch
  161. caching is standard.  If full 16-bit resolution won't fit in available
  162. GRAM (GUS RAM), a retry at 8-bit resolution is made (and R½ shown in the
  163. LOAD-STAT view).  You can SuperCache all patches, a selected subset (see
  164. the R2GUS.INI file for all-stars), or just the INI file.  Each patch
  165. file SuperCached requires an XMS handle, so you may need to extend this
  166. amount.  200 should do it.
  167.  
  168. Alt-x exits.
  169. --
  170. cornel@crl.com
  171. BBS/fax: +1-210-684-8065 / Monday-Friday after 5pm / Weekends 24 hours [-0500]
  172.