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 revisionPrevious revision
Next revision
Previous revision
en:orx:config:settings_main:input_joystick [2011/10/19 11:17 (13 years ago)] – [Joystick axes] iarwainen:orx:config:settings_main:input_joystick [2020/08/31 05:44 (4 years ago)] (current) – ↷ Links adapted because of a move operation sausage
Line 1: Line 1:
 ====== Joystick inputs ====== ====== Joystick inputs ======
 +
 +Orx supports up to 16 joysticks or gamepad devices.
  
 ===== Joystick buttons ===== ===== Joystick buttons =====
  
-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, starting with 1**):+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 and 16**): 
   * JOY_1_''*''   * JOY_1_''*''
   * JOY_2_''*''   * JOY_2_''*''
Line 20: 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, starting with 1**): +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_LX_''*'' 
-  * JOY_Z_''*'' +  * JOY_LY_''*'' 
-  * JOY_R_''*'' +  * JOY_RX_''*'' 
-  * JOY_U_''*'' +  * JOY_RY_''*'' 
-  * JOY_V_''*'' + 
-  * JOY_POV_''*'' +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:input:xbox-one-mapping.jpg |}} 
 +{{ tutorials:input:logitech-mapping.jpg |}} 
 + 
 +JOY_RX_1 and JOY_RY_1 will be the left/right, up/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:input: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_* 
 + 
 +===== 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 [[en:tutorials:input:8way_joystick_control|8-way old school joystick]] (**replace the ''*'' with the ID of the joystick you want to use, a number between 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) 
 +  
en/orx/config/settings_main/input_joystick.1319048254.txt.gz · Last modified: 2017/05/30 00:50 (7 years ago) (external edit)