home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsp / pcjoy / !PCJoy / Docs / Instruct < prev    next >
Text File  |  1995-09-02  |  5KB  |  119 lines
  1. !PCJoy help file and instructions.                           
  2. ==================================
  3.  
  4. Machine requirements
  5. ====================
  6.  
  7. A Risc PC with a Acorn/Aleph1 PC card
  8.  
  9. or
  10.  
  11. An older machine with a podule PC card.
  12. (see below *)
  13.  
  14. Intro
  15. =====
  16.  
  17. !PCJoy is a small application & relocatable module which enables the Aleph1
  18. /Acorn Risc PC PC card use standard Acorn joysticks. (for playing PC games,
  19. etc).
  20.   
  21. All makes of joysticks are supported if they provide the standard
  22. Acorn joystick SWI's.  (Usually this comes in the form of some supporting
  23. module which provide the extra swi's).
  24.  
  25. I have personally tested !PCJoy with VTi's gamepad, and it works fine.
  26. Unfortunately I don't have access to any of the analogue joysticks which are
  27. available, so I cannot guarantee whether they will function correctly.
  28.  
  29. How to use the application.
  30. ===========================
  31.  
  32. 1) Before loading the !PC or !486PC software, double click on the !PCJoy
  33.    filer icon.  This should launch the desktop front end of the software.
  34.    
  35. 2) Load your 3rd Party joystick module (the one which emulates the Acorn
  36. joystick SWI's).   
  37.    
  38. 2) Now load your !PC/!486PC software as usual.
  39.  
  40. It is very important that you do it in this order.  (!PCJoy will not function
  41. if you load it after the pc software has been loaded).
  42.  
  43. I have now also added a dos executable to this release. (joytst.exe).  
  44. Install this into your /dos directory on your PC partition.  When you
  45. want to test if !PCJoy is working just type joytst at the dos prompt.  This
  46. should tell you how many joypads are connected, etc.
  47.  
  48. Available options.
  49. ==================
  50.  
  51. There are two available options from inside !PCJoy.  These options can be 
  52. accessed by clicking the middle button over the !PCJoy icon (on the iconbar).
  53.  
  54. The first option, 'type', selects the kind of joystick you have connected.
  55. This can either be analogue or digital.
  56.  
  57. The second option selects how many joysticks you have connected 
  58. (either 0,1 or 2).
  59.  
  60. Please note that you can change these options at any time (ie even after the
  61. !PC/!486PC software has been loaded).
  62.  
  63. Star Commands
  64. =============
  65.  
  66. There are two *commands available, which perform exactly the same function 
  67. as the available options mentioned above.
  68.  
  69. *PCJoy [0-2]         Selects the number of joysticks, where [number] is
  70.                         the number of joysticks connected (0-2)
  71.                         
  72. *PCJoyType  [0-1]       Selects the type of joysticks connected 
  73.                         (0 - analogue, 1 - digital)
  74.                         
  75. * Under normal circumstances you will never need to use these * commands, but
  76. I decided to document them incase users of non RiscOS3.5 machines wish to
  77. try the module with older PC podules.  (I don't even know if it will work - 
  78. if anyone tests it for me could they please let me know).
  79.                         
  80. Additional Notes.
  81. =================
  82.  
  83. Anyone who has used PC joysticks will know that they are the worst design
  84. ever.  Perhaps the fundamental floor is the fact that they can only have two
  85. buttons per joypad when two joypads are connected.
  86.  
  87. My software fully emulates this (for compatibility reasons).  Therefor if you
  88. are using one joypad, the PC game has access to all four buttons (if the ac-
  89. tual joypad has four buttons), otherwise if you have two joypads connected
  90. the PC game only has access to two buttons per joypad.
  91.  
  92. This may seem weird but it is yet another of those old design problems which
  93. has survived to modern day age (just like Intel processors :-) )
  94.  
  95. Problems, Problems and more problems.
  96. =====================================
  97.  
  98. What happens if it does not work.  
  99.  
  100. Well firstly check you have the software running and installed correctly.
  101. Then try executing joytst.exe on your PC card.  This dos executable should
  102. tell you how many Acorn joysticks are connected (as configured).
  103.  
  104. Another thing to check is that you have your third party Joystick module
  105. loaded (the one which provides the Acorn swi's).  The PCJoy application will
  106. not work without this loaded :-)
  107.  
  108. If weird things are still happening then get in contact me.  (see address
  109. file inside the docs directory).
  110.  
  111. **STOP PRESS** :-)
  112.  
  113. One other problem can occur with the VTi joystick module.  The current module
  114. provides the standard Acorn SWI's, but it also provices Auto fire functions
  115. (which do not work correctly with PCJoy).  To solve this problem run the
  116. VTi joystick application and save a joystick module from here (without
  117. altering any other settings).  This should now work fine.
  118.  
  119. Dan Simms.