User Tools

Site Tools


en:orx:config:settings_main:input_joystick

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:orx:config:settings_main:input_joystick [2018/09/10 12:10 (2 months ago)]
sausage POV removed according to 2539541824329a50fc90663f86b42e6f621a061e
en:orx:config:settings_main:input_joystick [2018/09/22 15:21 (7 weeks ago)] (current)
sausage
Line 6: Line 6:
  
 Here's the list of the available joystick buttons for the input config system (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**): Here's the list of the available joystick buttons for the input config system (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**):
 +
   * JOY_1_''​*''​   * JOY_1_''​*''​
   * JOY_2_''​*''​   * JOY_2_''​*''​
Line 22: Line 23:
   * JOY_15_''​*''​   * JOY_15_''​*''​
   * JOY_16_''​*''​   * JOY_16_''​*''​
 +
 +There are also special re-mapped named buttons to suit just about every controller:
 +
 +  * JOY_A_*
 +  * JOY_B_*
 +  * JOY_X_*
 +  * JOY_Y_*
 +  * JOY_LBUMPER_*
 +  * JOY_RBUMPER_*
 +  * JOY_BACK_*
 +  * JOY_START_*
 +  * JOY_GUIDE_*
 +  * JOY_LTHUMB_*
 +  * JOY_RTHUMB_*
 +  * JOY_UP_*
 +  * JOY_RIGHT_*
 +  * JOY_DOWN_*
 +  * JOY_LEFT_*
  
 ===== Joystick axes ===== ===== Joystick axes =====
  
 Here's the list of the available joystick axes for the input config system (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**): Here's the list of the available joystick axes for the input config system (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**):
-  * JOY_X_''​*''​ 
-  * JOY_Y_''​*''​ 
-  * JOY_Z_''​*''​ 
-  * JOY_R_''​*''​ 
-  * JOY_U_''​*''​ 
-  * JOY_V_''​*''​ 
  
-Each is a axis. For example: JOY_X_ is usually the left right of an analog stick, while JOY_Y_ is the up down axis of the same stick. ​+  * JOY_LX_''​*''​ 
 +  * JOY_LY_''​*''​ 
 +  * JOY_RX_''​*''​ 
 +  * JOY_RY_''​*''​
  
-JOY_Z_ ​and JOY_R_ can be the left/right up/down of another ​stick.+Each is a axis. For example: JOY_LX_1 is the left/right of the left analog stick on controller 1, while JOY_LY_1 is the up/down axis of the same stick on controller 1.  
 + 
 +{{ :​tutorials:​xbox-one-mapping.jpg |}} 
 +{{ :​tutorials:​logitech-mapping.jpg |}} 
 + 
 +JOY_RX_1 ​and JOY_RY_1 will be the left/rightup/down of the right stick on controller 1. 
 + 
 +Each controller will implement its layout differently. But Orx makes use of the [[https://​github.com/​gabomdq/​SDL_GameControllerDB|SDL_GameControllerDB community database]] internally to make the mapping consistent for all controllers playing your game 
 + 
 +To allow the user to customise mapping, it is helpful to consider providing [[en:​tutorials:​remapping_inputs|remapping in your game]]. 
 + 
 +===== Triggers ===== 
 + 
 +Triggers are technically an axis as well. They are read as a range of values rather than on/off like a button. These are available on newer console controllers like the Xbox 360 or PS4: 
 + 
 +  * JOY_LTRIGGER_* 
 +  * JOY_RTRIGGER_*
  
-Each controller will implement its layout differently. It is helpful to consider providing [[en:​tutorials:​remapping_inputs|remapping in your game]]. 
 ===== Joystick half-axes ===== ===== Joystick half-axes =====
  
-Here's the list of the available joystick half axes for the input config system which allow you to easily use the axis like an 8-way old school joystick (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**):+Here's the list of the available joystick half axes for the input config system which allow you to easily use the axis like an [[en:​tutorials:​8way_joystick_control|8-way old school joystick]] (**replace the ''​*''​ with the ID of the joystick you want to use, a number between 1 and 16**): 
 + 
 +  * +JOY_LX_''​*''​ (Binds the left joystick'​s positive X half-axis to an input) 
 +  * -JOY_LX_''​*''​ (Binds the left joystick'​s negative X half-axis to an input) 
 +  * +JOY_LY_''​*''​ (Binds the left joystick'​s positive Y half-axis to an input) 
 +  * -JOY_LY_''​*''​ (Binds the left joystick'​s negative Y half-axis to an input) 
 +  * +JOY_RX_''​*''​ (Binds the right joystick'​s positive X half-axis to an input) 
 +  * -JOY_RX_''​*''​ (Binds the right joystick'​s negative X half-axis to an input) 
 +  * +JOY_RY_''​*''​ (Binds the right joystick'​s positive Y half-axis to an input) 
 +  * -JOY_RY_''​*''​ (Binds the right joystick'​s negative Y half-axis to an input) 
 + 
  
-  * +JOY_X_''​*''​ (Binds joystick'​s positive X half-axis to an input) 
-  * -JOY_X_''​*''​ (Binds joystick'​s negative X half-axis to an input) 
-  * +JOY_Y_''​*''​ (Binds joystick'​s positive Y half-axis to an input) 
-  * -JOY_Y_''​*''​ (Binds joystick'​s negative Y half-axis to an input) 
-  * +JOY_Z_''​*''​ (Binds joystick'​s positive Z half-axis to an input) 
-  * -JOY_Z_''​*''​ (Binds joystick'​s negative Z half-axis to an input) 
-  * +JOY_R_''​*''​ (Binds joystick'​s positive R half-axis to an input) 
-  * -JOY_R_''​*''​ (Binds joystick'​s negative R half-axis to an input) 
-  ​ 
en/orx/config/settings_main/input_joystick.1536581459.txt.gz · Last modified: 2018/09/10 12:10 (2 months ago) by sausage