home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CD32 / ctrl.LZX / ctrl.doc < prev    next >
Encoding:
Text File  |  1995-05-02  |  7.4 KB  |  160 lines
  1.  
  2.         __ ________                                                   ________
  3. _______|_ /  _____/____________       __ _________     ______ _ _____|     _ /
  4. \    ___//  ___/     _ /  ____/______(___\    ___/____(_____________ \     //
  5.  \    \ /_______     //   \|     _ /    _/\_____    /    /       \  \ \    /
  6.   \_________|  `-----/______     //     \ _ _______/____/    |   \\_|\    /
  7.                            `-----/-- - --\\ /-Mo!       \_________/   \  /
  8.  
  9. welcome  to  another  production  of our fabolous group.  this time it's called
  10. gamecontroller emulator (short:  'ctrl') done by no one else than me.
  11.  
  12.                               - GALAXY/DECISION -
  13.  
  14. requirements:
  15. ~~~~~~~~~~~~~
  16. an  amiga  which  supports  kickstart  2.04  or  higher,  any  version  of  the
  17. 'lowlevel.library'  version  40.x or higher and 'reqtools.library' version 38.x
  18. or higher!
  19.  
  20. these  libraries are copyrighted therefore i didn't put them with this archive.
  21. (should  be  clear  why ;) well you could get them on any bulletin board system
  22. avail  in  your  local  area..   or  get a look in your libs:  directory if you
  23. didn't  already have them.  this tool will also look for them for you.  you get
  24. notified if something is missing!
  25.  
  26. introduction:
  27. ~~~~~~~~~~~~~
  28. this  tool  should be able to emulate the extended buttons of an gamecontroller
  29. on  the nummeric keypad of your keyboard, it will also emulate the moving cross
  30. (moving  cross=up,  down,  left,  right and diagonals) on your cursorkeys.  but
  31. well you could use your joystick.  i extended this cursor option only for those
  32. who can't afford a joystick or the joystick is broken right now or could better
  33. do  moving  with the keys than the joystick.  well at least..  try out yourself
  34. what's best for you.
  35.  
  36. information:
  37. ~~~~~~~~~~~~
  38. it's  always possible that errors appears, well so please don't fool me (no one
  39. is  perfect), if you do so then try a better emulator yourself.  be afraid that
  40. somone did it.  and i know it works..
  41.  
  42. it  could  be  possible  that the one, or other game won't react/ work with the
  43. emulator!  so please don't blame me.  get another game :).  this so i will call
  44. it  'non'  function is set back that the game won't use extended buttons and so
  45. uses  only  the internal joystick stuff of the dma register $dff00a or $dff00c.
  46. mostly  these games are equal to the disk versions and often have allready keys
  47. defined.   in  real seldom times, games could have a gamepad option avail which
  48. where  written  in  real  hardware..  (as the library is only software, so this
  49. could  be  adapted  in own routine).  i heard from some people that the gamepad
  50. emulator  will  only  react if something is plugged in the port!  well might be
  51. but who cares?
  52.  
  53. programlogic:
  54. ~~~~~~~~~~~~~
  55. - i allocated memory and didn't free'ed it after leaving the utility..
  56. - i opened a library but didn't closed it after leaving the utility..
  57. - i  used  address $0.w to  set one single bit (bit 0) in it (in a multitasking
  58.   utility) well this one i will fix sooner or later
  59.  
  60. but  well these FAILURES are NEEDED and WANTED so don't fool me without knowing
  61. the  sence  why  i  made  it....   the  internal  library  stuffs  has it's own
  62. functions.   like  (libopen,  close,  expunge...)  sometimes the system decides
  63. itself  to  remove  an library out of the list of open libraries.  (as far as i
  64. understood  it!)  so,  to  avoid this problem i didn't closed the library.  the
  65. memory  was'nt free'ed, because the main routine of the game could overwrite my
  66. patching  routine.   well  this  could  still  happen  if the game uses a kinda
  67. absolutely  location transfer routine in it or something equal.  well mostly we
  68. have enough memory for game'ing so who cares to!
  69.  
  70. how  does  it work.  well the most cd32 games use the 'lowlevel.library' to get
  71. all  gamecontroller/  joystick/  mouse/ alien device moving from it.  this tool
  72. will  cheat  the  offset:   -30  (getjoyport)  of  this library.  will show the
  73. address up to my routine.  there it will jump in the original library come out,
  74. check my routine for pressed keys and went back into the game...  thats all..
  75.  
  76. usage:
  77. ~~~~~~
  78. theoreticaly  this  might  work  with  gamecontroller  port 0-3, no matter what
  79. you've connected there (i don't own a gamepad yet, because i live at the end of
  80. this  world  and to order it could take ages (as my isdn line took ages to ;)..
  81. you  could  also  disconnect  the  whole  moving device (mouse, gamecontroller,
  82. joystick...   etc..)  and  could  be  able  to  play  the game with my emulator
  83. heheheh..   well  there's nothing more to say just start the tool and check out
  84. the  requesters..  that's all.  maybe you write the keys down to a sheet to get
  85. a better overview...  because all games differ in the usage of the buttons..
  86.  
  87. tooltypes:
  88. ~~~~~~~~~~
  89. create  an  icon  named 'ctrl.info' (eg:  the mainprogramm should keep the name
  90. 'ctrl') in that directory where the mainprogramm was located...
  91.  
  92. add the following tooltypes:
  93.  
  94. REQUESTER=YEAH            ;yes i want an requester every time!
  95.  
  96. or
  97.  
  98. REQUESTER=NOPE            ;nope i hate requesters
  99.  
  100. and
  101.  
  102. MONITOR=HEXADDRESS        ;locate an monitor ad address eg: $1a0000
  103.  
  104. or
  105.  
  106. MONITOR=NOPE            ;no monitor wanted
  107.  
  108. btw:  the last option with the monitor is not implemented in this version, i am
  109. working  at  it  and  do betatesting it here.  with different monitor programms
  110. avail here.
  111.  
  112. disclaimer:
  113. ~~~~~~~~~~~
  114. there  is  no  warranty  for the program, to the extent permitted by applicable
  115. law.   except  when  otherwise  stated  in writing the copyright holder and/ or
  116. other  parties provide the program "as is" without warranty of any kind, either
  117. expressed  or implied, including, but not limited to, the implied warranties of
  118. merchantability  and  fitness  for a particular purpose.  the entire risk as to
  119. the  quality  and  performance  of the program is with you.  should the program
  120. prove  defective,  you  assume  the  cost of all necessary servicing, repair or
  121. correction.
  122.  
  123. in  no event unless required by applicable law or agreed to in writing will any
  124. copyright  holder,  or  any  other  party  who  may redistribute the program as
  125. permitted  above, be liable to you for damages, including any general, special,
  126. incidental  or consequential damages arising out of the use or inability to use
  127. the  program  (including but not limited to loss of data or data being rendered
  128. inaccurate  or  losses  sustained  by  you or third parties or a failure of the
  129. program to operate with any other programs), even if such holder or other party
  130. has been advised of the possibility of such damages.
  131.  
  132. copyright:
  133. ~~~~~~~~~~
  134. this  utility  and  it's  document  are COPYRIGHTED.  soft/, hard/, aminet/ and
  135. other  publicdomain companies MUST contact me to get an allowment to distribute
  136. this  piece of software in any way.  this means in easy words 'you must contact
  137. me  and  ask  me  first before you distribute/ trade/ spread this software' you
  138. will  have  to pay a license fee for doing this.  the amount of the fee depends
  139. on the way you want to distribute it.
  140.  
  141. if  i see you making money with my program in any way (above meant rules in any
  142. way  without  permission  of  me,  the  author)  then  you  have  to  take  the
  143. consequencies..
  144.  
  145.        >>>> licensed owners/companies get an enchanted version!!!! <<<<
  146.  
  147.                                  contact ways
  148.                                  ~~~~~~~~~~~~
  149.  
  150.    you can reach me on any bulletin board system in germany, write mail to:
  151.  
  152.                                  '- GALAXY -'
  153.  
  154. versions:
  155. ~~~~~~~~~
  156.  
  157. - v1.0        - released version..
  158. - v1.1        - internal enchantments..
  159. - v1.2        - released version..
  160.