16/rac/RAC.DOC

   1                               ÂÂÄÄ¿ ÂÂÄÄ¿ ÚÂÄÄ¿\r
   2                               ³³  ³ ³³  ³ ³³\r
   3                               ³ÃÄÂÙ ³ÃÄÄ´ ³³\r
   4                               ³³ À¿ ³³  ³ ³³\r
   5                               ÀÙ  À ÀÙ  Á ÀÁÄÄÙ\r
   6     ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ\r
   7 \r
   8                   Written by Roman Dolejsi (RDOS / DIMENSION)\r
   9 \r
  10                               December 31, 1996\r
  11                  Last update: December 31, 1996\r
  12 \r
  13 \r
  14        This is the documentation belonging to and explaining the use of\r
  15 \r
  16                               RAC version 0.01a\r
  17                    OPL2/OPL3 music module grabber for MS-DOS\r
  18 \r
  19 \r
  20    TOPICS covered in this document:\r
  21 \r
  22          DISCLAIMER\r
  23          APOLOGIZE\r
  24          PURPOSE OF RAC\r
  25          REQUIREMENTS\r
  26          INSTALLATION OF RAC\r
  27          RAC IN ACTION\r
  28          DIALOG LINE\r
  29          FREQUENTLY ASKED QUESTIONS\r
  30          COPYRIGHT\r
  31          WHERE TO FIND RAC\r
  32          THANX\r
  33          CONTACTING ME\r
  34 \r
  35 \r
  36 DISCLAIMER:\r
  37 -----------\r
  38   Although RAC has been tested on several systems, I cannot guarantee that it\r
  39 is bugless. Therefore I do not take responsibility for any damage directly or\r
  40 indirectly caused by RAC as a result of known/unknown  errors in it or errors\r
  41 caused by its access to your devices.\r
  42 \r
  43 \r
  44 APOLOGIZE:\r
  45 ----------\r
  46   Sorry, english is not my  native language. However, I wrote this nice docy in\r
  47 english without any help. I APOLOGIZE for any mistakes in the document. Take it\r
  48 easy... Nobody is perfect.. :-)\r
  49 \r
  50 \r
  51 PURPOSE OF RAC:\r
  52 ---------------\r
  53   Rdos Adlib Catcher is an OPL2/OPL3 music module grabber for IBM PC compatible\r
  54 computers  running  MS-DOS operating system. This means that you can use it for\r
  55 grabbing your favorite melody from some music player / demo or game. I've coded\r
  56 it because of lack of any such grabber of this type in PC-world.\r
  57 \r
  58 \r
  59 REQUIREMENTS:\r
  60 -------------\r
  61   RAC is coded in protected mode 386-assembler. For grabbing you will need 386\r
  62 or compatible computer without memory manager installed and adlib card. Grabbed\r
  63 music can be replayed with RdosPlay (RDOS OPL Player).\r
  64 \r
  65 \r
  66 INSTALLATION OF RAC:\r
  67 --------------------\r
  68 - first  you have to make some directory on your drive. Then you have to unpack\r
  69   there archive file RACxyyz.ZIP.\r
  70   (you probably did all this when you read these lines :-)\r
  71 \r
  72 - RAC pack should consist of these files:\r
  73 \r
  74     RAC.EXE - Main file - OPL grabber\r
  75     RAC.DOC - Documentation for RAC (this file)\r
  76     RAC.REV - RAC changes/revision history file\r
  77     FILE_ID.DIZ  - quick info file\r
  78 \r
  79 - now you have RAC successfully installed :-)\r
  80 \r
  81 \r
  82 RAC IN ACTION:\r
  83 --------------\r
  84   RAC can store all  acesses to Adlib (OPL2) or some OPL3 card's I/O ports into\r
  85 special  file  with RAW extension. That file can be later played with something\r
  86 capable of playing that (hint: what about RdosPlay?).\r
  87   After you start RAC, it initializes  internal  music  buffer. Every access to\r
  88 desired  ports  will  be  stored it that buffer. Therefore you have to run some\r
  89 game, demo or player which  uses  adlib. When you later  want to save buffer in\r
  90 file or clear it you have to run RAC again with special parameter.\r
  91 \r
  92 \r
  93 DIALOG LINE:\r
  94 ------------\r
  95 Dialog line looks as follows:\r
  96   RAC.EXE [c] [s]\r
  97 \r
  98   possibilities:\r
  99     c - clear music buffer\r
 100     s - save music buffer into file RACDATA.RAW in this directory\r
 101 \r
 102 \r
 103 RAW FILE SPECIFICATIONS:\r
 104 ------------------------\r
 105 RAW is originally founded probably by Future Crew demogroup which used it in\r
 106 their BBS intro StarPort. RAW file generated by RAC is a derived version\r
 107 which is also capable of OPL3 extension (ie. full four port access: 388-38Bh).\r
 108 RAW files can be played with RdosPlay (look at Dimension homepage).\r
 109 \r
 110 format:   [0]=db     'RAWADATA'                 ... file identifier\r
 111           [8]=dw     clock                      ... clock speed (like c-20)\r
 112          [10]=dw     data_size dup (data)       ... adlib data\r
 113          [..]=dw     0ffffh                     ... end of file\r
 114 data: parameter, command.   command==0: data==n ... wait n times.\r
 115                             command==2: data==0 ... set speed (next word)\r
 116                             command==2: data==1 ... set OPL3 port A default\r
 117                             command==2: data==2 ... set OPL3 port B default\r
 118 \r
 119 \r
 120 FREQUENTLY ASKED QUESTIONS:\r
 121 ---------------------------\r
 122 * RAC does not want to run with PM driver (EMM386/QEMM/Win) installed.\r
 123   - RAC uses clear 32-bit PM manager. It needs completely free environment\r
 124     to operate. Therefore other PM managers will NEVER be supported.\r
 125     What RAC uses is from the beginning meant as a complete memory manager\r
 126     so it's internal functionality is absolutely incompatible with anything\r
 127     other (even VCPI's ProtMode level 0).\r
 128 \r
 129 * Coprocessor seems not to be installed when RAC is running !! Why !?!\r
 130   - I have to agree.. sorry for this.. still don't know why.. Maybe another\r
 131     version... really sorry.\r
 132 \r
 133 * When I install RAC there is no EMS memory in system. Some of my programs\r
 134   don't want to run at all.\r
 135   - EMS services are not yet supported, sorry. Maybe another version..\r
 136 \r
 137 * My application told me I have no VCPI compatible environment and refused\r
 138   to run when I started it under RAC.\r
 139 * My application refused to run with exit message about impossibility to enter\r
 140   DPMI protected mode.\r
 141   - VCPI/DPMI are 32-bit Protected mode interfaces allowing your applications\r
 142     to run 32-bit code under other 32-bit PM environment installed in memory.\r
 143     Although these ifaces are not yet supported, there exist light of hope\r
 144     that DPMI will be supported some day.\r
 145 \r
 146 * How much system memory takes RAC for its work ?\r
 147   - RAC takes about 1k of conventional mem. In fact, everything is in\r
 148     Xmemory (above 1MB) and takes there about 550kB. But Xmemory requirements\r
 149     probably don't bother anyone.\r
 150 \r
 151 * Programs tend to be slower under RAC.\r
 152   - Yes, especially Adlib playing routines are slower, because PM exception\r
 153     handling eats some of the system resources.\r
 154 \r
 155 * Are there any other known problems with RAC ?\r
 156   - RAC counts waitstates via timer. When some music does not use timer for\r
 157     playing (not such often case), RAC won't insert waitstates in generated\r
 158     RAW file - file is not playable :-( Don't know any solution right now.\r
 159 \r
 160 \r
 161 WHERE TO FIND RAC:\r
 162 ------------------\r
 163 Each time I have a new version of RAC available, I'll upload it to this place:\r
 164 \r
 165   ftp://sorry.vse.cz/dimension   (Dimension FTP site in Prague, Czech Republic)\r
 166  http://sorry.vse.cz/dimension   (Dimension Inet HeadQuarters, Czech Republic)\r
 167 \r
 168 RAC will be probably also available at ftp.cdrom.com or ftp.sunet.se\r
 169 FTP archives.\r
 170 \r
 171    Ask your local Internet or FTP expert on how to reach them.\r
 172 \r
 173 Another way is to visit RAC's homepage at address:\r
 174 \r
 175     http://sorry.vse.cz/dimension/rdos/rac   (Http site in Prague, CZE)\r
 176 \r
 177 \r
 178 THANX:\r
 179 ------\r
 180 Although I did all the programming, there is a friend which helped me:\r
 181 \r
 182 David Voracek (Assassin/Dimension) - idea, testing, suggestions\r
 183 \r
 184 and other friends for their (mostly) betatesting..\r
 185 \r
 186 \r
 187 CONTACTING ME:\r
 188 --------------\r
 189   If you want to contact me, write to address listed below. If you want to send\r
 190 me suggestions, tips or simply greets, send it freely. Also some money would be\r
 191 good as a power and motivation for further work :-)\r
 192 \r
 193 My address:                           E-Mail: (non-commercial)\r
 194   Roman Dolejsi (RDOS)                    roman@sorry.vse.cz\r
 195   Husova 419, Vcelna                      roman@romeo.pf.jcu.cz\r
 196   37382 Ceske Budejovice\r
 197   Czech Republic\r
 198 \r
 199 Please do not send me E-mails longer than 150kB (because of our local smtp\r
 200 server limit).\r
 201 \r
 202 *** end of RAC documentation ***