|
|
1.1 root 1: Title: Description of Windows 95 Quake 2 support for DirectInput devices such as:
2: standard joysticks
3: FPgaming Assassin 3D www.fpgaming.com
4: Logitech WingMan Warrior www.logitech.com
5: Mad Catz Panther www.madcatz.com
6: Mad Catz Panther XL www.madcatz.com
7: SpaceTec IMC SpaceOrb 360 www.spacetec.com
8: File: JOYSTICK.TXT
9: Revision History:
10: 02/21/97 JCB Quake 1: Created by FPgaming, Inc. (www.fpgaming.com) -- Creators of the Assassin 3D.
11: 03/12/97 id Quake 1: Joysticks are disabled by default now.
12: 10/28/97 JCB Quake 2: Added up/down axis control for SpaceOrb 360 users, changed names to joy_* and changed 'joystick to 'in_joystick'.
13: Overview:
14: The input device support in Quake 2 is designed to take full advantage of your DirectInput device. Standard joysticks, digital joysticks and new advanced controllers are all supported.
15:
16:
17: Standard Joystick Directions:
18: 1. Verify your joystick or game controller is selected in the Joystick (or Game Controllers) control panel applet.
19: 2. Verify your device has been calibrated and tested.
20: 3. Launch Quake 2 (quake2.exe).
21: 4. Type 'in_joystick 1' at the console to enable your joystick (only needs to by typed in one time).
22: From then on, just launch Quake 2.
23:
24:
25: Advanced Controller Directions:
26: 1. Verify your joystick or game controller is selected in the Joystick (or Game Controllers) control panel applet.
27: 2. Verify your device has been calibrated and tested.
28: 3. Get the configuration file for your controller from your manufacturer's website or copy from the selections below.
29: 4. Place the configuration file in your quake2\baseq2 directory.
30: 6. Launch Quake 2 (quake2.exe).
31: 7. Type 'exec <configuration file name here>' at the console to enable your advanced controller each time you launch Quake 2.
32: Optionally you can:
33: Create or modify quake2\baseq2\autoexec.cfg to include an exec to your configuration file (i.e. 'exec adva3d.cfg'). This will automatically load your configuration file each time you launch Quake 2.
34: From then on, just launch Quake 2.
35:
36:
37: Details:
38: (This may be more information than you ever wanted to know.)
39: Standard Joystick Support
40: The standard joystick support has been enhanced to provide the following:
41: 1. proportional movement (the farther you move the stick, the faster you move)
42: 2. support for up to 32 buttons (JOY1-JOY4 and AUX5-AUX32)
43: 3. sensitivity setting for each control (allows tuning and inverting the control direction)
44: 4. dead-zone setting for each control
45:
46: The default joystick setting is for joystick left/right movement to control turning and for joystick forward/backward movement to control moving forward/backward. For optional strafing, add the 'sidestep' feature to one of your buttons (via the Customize menu). For optional looking, add the 'mouse look' feature to one of your buttons (also via the Customize menu).
47:
48: Additionally, there are several features that you can set from the Options menu. 'Always Run' allows you change your maximum speed from walking to running. 'Invert Mouse' allows you to change the direction the joystick has to move to when looking up and down. 'Lookspring' enables automatic look-forward-when-moving. And, 'Lookstrafe' automatically enables strafing when the 'mouse look' button is pressed.
49:
50: The following variables control your sensititivity settings:
51: joy_forwardsensitivity - controls the ramp-up speed for moving forward and backward
52: joy_sidesensitivity - controls the ramp-up speed for moving side to side
53: joy_upsensitivity - controls the ramp-up speed for moving up and down
54: joy_pitchsensitivity - controls the speed that you look up and down
55: joy_yawsensitivity - controls the speed that you look left to right
56: You can set the sensitivity settings to negative numbers. This inverts the direction of movement for the control. The default sensitivity settings are 1 (or -1). There is no limit on the range; whatever feels good.
57:
58: The following variables control your threshold settings:
59: joy_forwardthreshold - controls the dead-zone for moving forward and backward
60: joy_sidethreshold - controls the dead-zone for moving side to side
61: joy_upthreshold - controls the dead-zone for moving up and down
62: joy_pitchthreshold - controls the dead-zone for looking up and down
63: joy_yawthreshold - controls the dead-zone for looking left and right
64: The threshold settings allow you to control your dead-zone (or no-movement zone). The default threshold settings are .15 (meaning 15% of the full-range). The range of the threshold settings is from 0 to 1. Troublesome analog joysticks may need a larger number (like .2). Premium joysticks can use a smaller number (like .1).
65:
66: The joystick sensitivity settings and the threshold settings are not saved after you quit your game as inadvertent settings can really hose your control. If you want to keep any changes, add them into your autoexec.cfg file or add an 'exec' call to your configuration file.
67:
68: If your joystick has a POV hat, the buttons are mapped to AUX29-AUX32. So, you get 8 buttons with the Logitech WingMan Extreme and 12 buttons with the Microsoft SideWinder 3D Pro, etc.
69:
70:
71: Advanced Controller Support
72: The following features have been added:
73: 1. support for all 6 axes (X, Y, Z, R, U, V)
74: 2. mapping of any axis to any control (Forward, Look, Side, Turn, Up)
75: 3. proportional movement for all controls
76: 4. sensitivity setting for any control (allows tuning and inverting the control direction)
77: 5. threshold setting for any control (allows dead-zone setting)
78: 6. support for absolute controls (like joysticks) and relative controls (like trackballs)
79: 7. support for up to 32 buttons (JOY1-JOY4 and AUX5-AUX32)
80:
81: ******************************************************************************
82: NOTE: The information below is for game controller companies to integrate their device and for anyone wanting to create a custom setup.
83:
84: In addition to the above new variables, there are six more for axis mapping. These are:
85: joy_advaxisx - controls mapping of DirectInput axis X (typically joystick left and right)
86: joy_advaxisy - controls mapping of DirectInput axis Y (typically joystick forward and backward)
87: joy_advaxisz - controls mapping of DirectInput axis Z (typically joystick throttle)
88: joy_advaxisr - controls mapping of DirectInput axis R (typically joystick rudder)
89: joy_advaxisu - controls mapping of DirectInput axis U (custom axis - Assassin 3D trackball left and right and SpaceOrb roll)
90: joy_advaxisv - controls mapping of DirectInput axis V (custom axis - Assassin 3D trackball forward and backward and SpaceOrb yaw)
91: Each joy_advaxis variable can be set to the following controls:
92: 0 = Axis not used
93: 1 = Axis is for forward and backward movement
94: 2 = Axis is for looking up and down (pitch)
95: 3 = Axis is for side to side movement
96: 4 = Axis is for turning left and right (yaw)
97: 5 = Axis is for up and down movement
98: Additionally, each axis can be designated as an absolute axis (like a joystick) or a relative axis (like the FPgaming trackball). Absolute axes are defined as having a stopping position whereas relative axes don't have a stopping position and just go around and around. To designate an axis as a relative axis, add 16 to the above control number. For example, to set the Assassin 3D's axis U to be looking left and right, type 'joyadvaxisu 20'. As another example, to make your rudder pedals contol turning left and right, type 'joyadvaxisr 4'. It's a bit complicated, but only needs to be done once.
99:
100: The advanced axes variables will not have any effect until joyadvanced is set to 1. Additionally, any changes to the to the axes will not take effect until the joyadvancedupdate command is executed. So, the procedure for creating an advanced mapping is:
101: 1. set 'joy_advanced 1'
102: 2. make any desired mapping changes
103: 3. make any desired sensitivity changes
104: 4. make any desired threshold changes
105: 3. call 'joy_advancedupdate'
106:
107: Here is the config file for the FPgaming Assassin 3D:
108: // ADVA3D.CFG
109: // Revision 2.0 -- refer to www.fpgaming.com for updates
110: joy_name "FPgaming Assassin 3D"
111: +mlook
112: in_joystick 1
113: joy_advanced 1
114: joy_advaxisx 3
115: joy_advaxisy 1
116: joy_advaxisz 0
117: joy_advaxisr 0
118: joy_advaxisu 20
119: joy_advaxisv 18
120: joy_forwardsensitivity -1.0
121: joy_sidesensitivity 1.0
122: joy_upsensitivity 1.0
123: joy_pitchsensitivity -0.25
124: joy_yawsensitivity -0.5
125: joy_forwardthreshold 0.15
126: joy_sidethreshold 0.15
127: joy_upthreshold 0.15
128: joy_yawthreshold 0.0
129: joy_pitchthreshold 0.0
130: joy_advancedupdate
131:
132: Here is a config file for the Mad Catz Panther and Mad Catz Panther XL:
133: // ADVPNTHR.CFG
134: // Revision 2.0 -- refer to www.madcatz.com for updates
135: joy_name "Mad Catz Panther/Panther XL"
136: +mlook
137: in_joystick 1
138: joy_advanced 1
139: joy_advaxisx 3
140: joy_advaxisy 1
141: joy_advaxisz 0
142: joy_advaxisr 0
143: joy_advaxisu 20
144: joy_advaxisv 18
145: joy_forwardsensitivity -1.0
146: joy_sidesensitivity 1.0
147: joy_upsensitivity 1.0
148: joy_pitchsensitivity -0.25
149: joy_yawsensitivity -0.5
150: joy_forwardthreshold 0.15
151: joy_sidethreshold 0.15
152: joy_upthreshold 0.15
153: joy_yawthreshold 0.0
154: joy_pitchthreshold 0.0
155: joy_advancedupdate
156:
157: Here is a config file for the Logitech WingMan Warrior:
158: // ADVWW.CFG
159: // Revision 0.2 -- refer to www.logitech.com for updates
160: joy_name "Logitech WingMan Warrior"
161: in_joystick 1
162: joy_advanced 1
163: joy_advaxisx 3
164: joy_advaxisy 1
165: joy_advaxisz 0
166: joy_advaxisr 4
167: joy_advaxisu 0
168: joy_advaxisv 0
169: joy_forwardsensitivity -1.0
170: joy_sidesensitivity 1.0
171: joy_upsensitivity 1.0
172: joy_pitchsensitivity 0.0
173: joy_yawsensitivity -3.0
174: joy_forwardthreshold 0.15
175: joy_sidethreshold 0.15
176: joy_upthreshold 0.15
177: joy_pitchthreshold 0.0
178: joy_yawthreshold 0.0
179: joy_advancedupdate
180:
181: Here is a config file for the SpaceTec IMC SpaceOrb 360:
182: // ADVSPORB.CFG
183: // Revision 0.2 -- refer to www.spacetec.com for updates
184: joy_name "SpaceTec IMC SpaceOrb 360"
185: +mlook
186: in_joystick 1
187: joy_advanced 1
188: joy_advaxisx 3
189: joy_advaxisy 0
190: joy_advaxisz 1
191: joy_advaxisr 2
192: joy_advaxisu 4
193: joy_advaxisv 5
194: joy_forwardsensitivity 2.5
195: joy_sidesensitivity 2.0
196: joy_upsensitivity -2.0
197: joy_pitchsensitivity 2.0
198: joy_yawsensitivity 5.0
199: joy_forwardthreshold 0.0
200: joy_sidethreshold 0.0
201: joy_upthreshold 0.15
202: joy_pitchthreshold 0.1
203: joy_yawthreshold 0.0
204: joy_advancedupdate
205:
206: Here is a config file for making your joystick operate looking around and strafing, your rudder pedals control turning left and right and throttle control moving forward and backward:
207: joy_name "Joystick, Rudder & Throttle"
208: in_joystick 1
209: joy_advanced 1
210: joy_advaxisx 3
211: joy_advaxisy 2
212: joy_advaxisz 1
213: joy_advaxisr 4
214: joy_advaxisu 0
215: joy_advaxisv 0
216: joy_forwardsensitivity -1.0
217: joy_sidesensitivity -1.0
218: joy_upsensitivity 1.0
219: joy_pitchsensitivity 1.0
220: joy_yawsensitivity -1.0
221: joy_forwardthreshold 0.15
222: joy_sidethreshold 0.15
223: joy_upthreshold 0.15
224: joy_pitchthreshold 0.15
225: joy_yawthreshold 0.15
226: joy_advancedupdate
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.