|
|
(11 intermediate revisions by the same user not shown)
|
Line 8: |
Line 8: |
| * gimx-config can edit configs produced by gimx-fpsconfig, and vice-versa. | | * gimx-config can edit configs produced by gimx-fpsconfig, and vice-versa. |
| | | |
− | * Configuration files have to be saved into: | + | * To open the configuration directory, click on File>Open config directory in gimx-config, gimx-fpsconfig, or gimx-launcher. |
− | ** Ubuntu: the ~/.emuclient/config directory. ~ is the home directory. .emuclient folder is hidden (in the file manager, press ctrl+h to display hidden folders).
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/OpenConfigDirectory.png https://gimx.fr/img/screenshots/tuto/OpenConfigDirectory.png]</div> |
− | ** Windows 32bits: the C:\Program Files\GIMX\config directory.
| |
− | ** Windows 64bits: the C:\Program Files (x86)\GIMX\config directory.
| |
| | | |
| + | * In GIMX 0.51 and earlier, configurations were saved in C:\Program Files\GIMX\config (Windows 32bits) or C:\Program Files (x86)\GIMX\config (Windows 64bits). |
| + | |
| + | ==gimx-fpsconfig== |
| + | |
| + | gimx-fpsconfig is a config editor that helps to use a keyboard and a mouse in FPS games.<br /> |
| + | This means it only allows to: |
| + | * bind mouse and keyboard buttons to buttons |
| + | * bind mouse and keyboard buttons to the left stick |
| + | * bind the mouse axes to the right stick and edit the translation parameters |
| + | * use 2 profiles (first = hip fire, second = aiming down the sights, second profile trigger is the mouse right button, with switch back enabled) |
| + | |
| + | ===Start=== |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Start_gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Start_gimx-fpsconfig.jpg]</div> |
| + | |
| + | ===Bind controls=== |
| + | To bind a button to a button or a direction of the left stick, click on the GUI button (cross, l1, select, left stick up, etc), and click on the button (w, space, left button, etc).<br > |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Bind_button.jpg https://gimx.fr/img/screenshots/tuto/Bind_button.jpg]</div> |
| + | |
| + | ===Set mouse translation parameters=== |
| + | The mouse translation parameters can be edited in the bottom part of the GUI. It is advised to calibrate these parameters through the [[Mouse_Calibration|Mouse Calibration]] tool.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/mouse_translation-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/mouse_translation-gimx-fpsconfig.jpg]</div> |
| + | |
| + | ===Set control labels=== |
| + | To set a label, click on menu 'Advanced>Edit Label', click on the GUI button, and set the label.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Edit_labels-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Edit_labels-gimx-fpsconfig.jpg]</div> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/edit_label_select-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/edit_label_select-gimx-fpsconfig.jpg]</div> |
| + | The label will appear in the GUI button tooltip.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Label-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Label-gimx-fpsconfig.jpg]</div> |
| + | |
| + | ===Set the mouse DPI=== |
| + | In case the config is built from scratch (menu 'File>New'), the mouse DPI has to be set.<br /> |
| + | The value is used by the calibration tests that are run by the [[Mouse_Calibration|Mouse Calibration]] tool.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Mouse_DPI-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Mouse_DPI-gimx-fpsconfig.jpg]</div> |
| + | |
| + | ===Convert the mouse sensitivity=== |
| + | The "Convert sensitivity" GUI button allows to adjust the mouse sensitivity according to source/destination DPI values.<br /> |
| + | It is useful to convert a config that was built for a mouse that runs at a different DPI setting.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Convert_mouse_sens-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Convert_mouse_sens-gimx-fpsconfig.jpg]</div> |
| + | |
| + | ===Auto-bind controls=== |
| + | To auto bind controls according to the labels defined in a reference configuration, click on menu 'Advanced>Auto-bind controls'. The configuration to modify and the reference configuration should have labels configured.<br /> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Auto_bind-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Auto_bind-gimx-fpsconfig.jpg]</div> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/SelectReferenceConfig.png https://gimx.fr/img/screenshots/tuto/SelectReferenceConfig.png]</div> |
| + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Auto_bind_done-gimx-fpsconfig.jpg https://gimx.fr/img/screenshots/tuto/Auto_bind_done-gimx-fpsconfig.jpg]</div> |
| + | Controls not found or in conflict are colored in red. |
| + | |
| + | --todo: update |
| ==gimx-config== | | ==gimx-config== |
| | | |
| ===Start=== | | ===Start=== |
− | --todo: add screenshot | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Start_gimx-config.jpg https://gimx.fr/img/screenshots/tuto/Start_gimx-config.jpg]</div> |
| | | |
| ===Button tab=== | | ===Button tab=== |
| Bind controls (button or axis, from any device) to controller buttons (cross, select, etc.). | | Bind controls (button or axis, from any device) to controller buttons (cross, select, etc.). |
− | --todo: add screenshot | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Button_tab-gimx-config.png https://gimx.fr/img/screenshots/tuto/Button_tab-gimx-config.png]</div> |
| | | |
| ===Axis tab=== | | ===Axis tab=== |
| Bind controls (button or axis, from any device) to controller axes (left stick x, left stick y, pressure sensitive buttons, etc.). | | Bind controls (button or axis, from any device) to controller axes (left stick x, left stick y, pressure sensitive buttons, etc.). |
− | --todo: add screenshot | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Axis_tab-gimx-config.png https://gimx.fr/img/screenshots/tuto/Axis_tab-gimx-config.png]</div> |
| | | |
| ===Overall tab=== | | ===Overall tab=== |
| This is the place to configure: | | This is the place to configure: |
| * the profile trigger, which is the button that activate the profile | | * the profile trigger, which is the button that activate the profile |
− | :The profile activation can be delayed (for ex. 100ms).<br/> | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/ProfileTrigger.png https://gimx.fr/img/screenshots/tuto/ProfileTrigger.png]</div> |
− | :If the switch back checkbox is enabled, GIMX will switch back to the previous profile when the button is released.<br/> | + | :The profile activation can be delayed (for ex. 100ms).<br /> |
| + | :If the switch back checkbox is enabled, GIMX will switch back to the previous profile when the button is released.<br /> |
| :Typical use cases that allow to tweak the ADS mouse parameters in FPS games: | | :Typical use cases that allow to tweak the ADS mouse parameters in FPS games: |
− | :# second profile with right mouse button as trigger, and switch back enabled; right mouse button is bind to the ADS button (for ex. l1) in both profiles<br/> | + | :# second profile with right mouse button as trigger, and switch back enabled; right mouse button is bind to the ADS button (for ex. l1) in both profiles<br /> |
− | :# first and second profiles with right mouse button as trigger, and switch back disabled; right mouse button is bind to the ADS button (for ex. l1) in the first profile only ("toggle mode")<br/> | + | :# first and second profiles with right mouse button as trigger, and switch back disabled; right mouse button is bind to the ADS button (for ex. l1) in the first profile only ("toggle mode")<br /> |
− | * left or right stick intensities | + | * mouse options |
− | :This can be used to have a precise control over a stick with buttons.<br/> | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/MouseOptions.png https://gimx.fr/img/screenshots/tuto/MouseOptions.png]</div> |
− | :Typical use case for FPS games:<br/> | + | [[Mouse_Calibration#Smoothing|Mouse smoothing]] can be configured there if needed.<br /> |
− | :* WASD is bind to the left stick<br/> | + | The mouse mode can be either "aiming" or "driving/flying". |
− | :* mouse wheel down and up resp. decrease and increase the left stick intensity<br/> | + | * axis intensities |
− | :* dead zone = 20 (lowest stick position along each axis)<br/> | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/AxisIntensity.png https://gimx.fr/img/screenshots/tuto/AxisIntensity.png]</div> |
| + | :This can be used to have a precise control over a stick with buttons, or over a pressure-sensitive button with buttons.<br /> |
| + | :Typical use case for FPS games:<br /> |
| + | :* WASD is bind to the left stick<br /> |
| + | :* mouse wheel down and up resp. decrease and increase the left stick intensity<br /> |
| + | :* dead zone = 20 (lowest stick position along each axis)<br /> |
| :* steps = 3 (number of stick positions along each axis) | | :* steps = 3 (number of stick positions along each axis) |
− |
| |
− | <div class="image200px">[http://gimx.fr/img/screenshots/Sixemuconf-1.png http://gimx.fr/img/screenshots/Sixemuconf-1.png]</div>
| |
− | --todo: update screenshot
| |
| | | |
| ===Controllers=== | | ===Controllers=== |
− | This part is only applicable for bluetooth.<br/> | + | This part is only applicable for bluetooth.<br /> |
− | Up to 7 sixaxis controllers, each using a different bluetooth dongle, can be emulated by GIMX.<br/> | + | Up to 7 sixaxis controllers, each using a different bluetooth dongle, can be emulated by GIMX.<br /> |
| Each controller can be configured independently. | | Each controller can be configured independently. |
| | | |
− | --todo: add screenshot | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Controllers-gimx-config.png https://gimx.fr/img/screenshots/tuto/Controllers-gimx-config.png]</div> |
| | | |
| ===Profiles=== | | ===Profiles=== |
− | There are up to 8 profiles per controller.<br/> | + | There are up to 8 profiles per controller.<br /> |
| For example, it's possible to define a profile for aiming: copy-paste the profile #1 to profile #2, define the right mouse click as profile #2 trigger with switch back (Overall tab), and adjust the mouse sensitivity & acceleration (Axis tab). | | For example, it's possible to define a profile for aiming: copy-paste the profile #1 to profile #2, define the right mouse click as profile #2 trigger with switch back (Overall tab), and adjust the mouse sensitivity & acceleration (Axis tab). |
| | | |
− | <div class="image200px">[http://gimx.fr/img/screenshots/Sixemuconf-4.png http://gimx.fr/img/screenshots/Sixemuconf-4.png]</div> | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/Profiles-gimx-config.png https://gimx.fr/img/screenshots/tuto/Profiles-gimx-config.png]</div> |
− | --todo: update screenshot
| |
| | | |
| ===Config conversion=== | | ===Config conversion=== |
| Items of the "Edit" menu that allow to convert a configuration: | | Items of the "Edit" menu that allow to convert a configuration: |
| | | |
− | <div class="image200px">[http://gimx.fr/img/screenshots/tuto/2.3_2_replace_mouse_dpi.jpg http://gimx.fr/img/screenshots/tuto/2.3_2_replace_mouse_dpi.jpg]</div> | + | <div class="image200px">[https://gimx.fr/img/screenshots/tuto/2.3_2_replace_mouse_dpi.png https://gimx.fr/img/screenshots/tuto/2.3_2_replace_mouse_dpi.png]</div> |
| | | |
− | The "Replace Mouse" item allows to change the mouse name and id.<br/> | + | The "Replace Mouse" item allows to change the mouse name and id.<br /> |
− | The "Convert mouse sensitivity" item allows to adjust the mouse sensitivity according to source/destination DPI values.<br/> | + | The "Convert mouse sensitivity" item allows to adjust the mouse sensitivity according to source/destination DPI values.<br /> |
| The "Replace Keyboard" item allows to change the keyboard name and id. | | The "Replace Keyboard" item allows to change the keyboard name and id. |
| | | |
Line 75: |
Line 122: |
| :Use case: a same binding is defined in profiles 1 & 2; modify the binding in profile 1: the binding in profile 2 is updated. | | :Use case: a same binding is defined in profiles 1 & 2; modify the binding in profile 1: the binding in profile 2 is updated. |
| * Auto-bind controls: remap bindings according to the labels; the configuration to modify and the reference configuration should have labels configured (column 'Label' in Button and Axis tabs). | | * Auto-bind controls: remap bindings according to the labels; the configuration to modify and the reference configuration should have labels configured (column 'Label' in Button and Axis tabs). |
− |
| |
− | ==gimx-fpsconfig==
| |
− | --todo: write stuff!
| |
- gimx-config is the general purpose config editor, and the most complete of the 2 editors.
- gimx-fpsconfig is the config editor for FPS games, easier to use, but far less complete.
Notes
- gimx-config can edit configs produced by gimx-fpsconfig, and vice-versa.
- To open the configuration directory, click on File>Open config directory in gimx-config, gimx-fpsconfig, or gimx-launcher.
- In GIMX 0.51 and earlier, configurations were saved in C:\Program Files\GIMX\config (Windows 32bits) or C:\Program Files (x86)\GIMX\config (Windows 64bits).
gimx-fpsconfig
gimx-fpsconfig is a config editor that helps to use a keyboard and a mouse in FPS games.
This means it only allows to:
- bind mouse and keyboard buttons to buttons
- bind mouse and keyboard buttons to the left stick
- bind the mouse axes to the right stick and edit the translation parameters
- use 2 profiles (first = hip fire, second = aiming down the sights, second profile trigger is the mouse right button, with switch back enabled)
Start
Bind controls
To bind a button to a button or a direction of the left stick, click on the GUI button (cross, l1, select, left stick up, etc), and click on the button (w, space, left button, etc).
Set mouse translation parameters
The mouse translation parameters can be edited in the bottom part of the GUI. It is advised to calibrate these parameters through the Mouse Calibration tool.
Set control labels
To set a label, click on menu 'Advanced>Edit Label', click on the GUI button, and set the label.
The label will appear in the GUI button tooltip.
Set the mouse DPI
In case the config is built from scratch (menu 'File>New'), the mouse DPI has to be set.
The value is used by the calibration tests that are run by the Mouse Calibration tool.
Convert the mouse sensitivity
The "Convert sensitivity" GUI button allows to adjust the mouse sensitivity according to source/destination DPI values.
It is useful to convert a config that was built for a mouse that runs at a different DPI setting.
Auto-bind controls
To auto bind controls according to the labels defined in a reference configuration, click on menu 'Advanced>Auto-bind controls'. The configuration to modify and the reference configuration should have labels configured.
Controls not found or in conflict are colored in red.
--todo: update
gimx-config
Start
Button tab
Bind controls (button or axis, from any device) to controller buttons (cross, select, etc.).
Axis tab
Bind controls (button or axis, from any device) to controller axes (left stick x, left stick y, pressure sensitive buttons, etc.).
Overall tab
This is the place to configure:
- the profile trigger, which is the button that activate the profile
- The profile activation can be delayed (for ex. 100ms).
- If the switch back checkbox is enabled, GIMX will switch back to the previous profile when the button is released.
- Typical use cases that allow to tweak the ADS mouse parameters in FPS games:
- second profile with right mouse button as trigger, and switch back enabled; right mouse button is bind to the ADS button (for ex. l1) in both profiles
- first and second profiles with right mouse button as trigger, and switch back disabled; right mouse button is bind to the ADS button (for ex. l1) in the first profile only ("toggle mode")
Mouse smoothing can be configured there if needed.
The mouse mode can be either "aiming" or "driving/flying".
- This can be used to have a precise control over a stick with buttons, or over a pressure-sensitive button with buttons.
- Typical use case for FPS games:
- WASD is bind to the left stick
- mouse wheel down and up resp. decrease and increase the left stick intensity
- dead zone = 20 (lowest stick position along each axis)
- steps = 3 (number of stick positions along each axis)
Controllers
This part is only applicable for bluetooth.
Up to 7 sixaxis controllers, each using a different bluetooth dongle, can be emulated by GIMX.
Each controller can be configured independently.
Profiles
There are up to 8 profiles per controller.
For example, it's possible to define a profile for aiming: copy-paste the profile #1 to profile #2, define the right mouse click as profile #2 trigger with switch back (Overall tab), and adjust the mouse sensitivity & acceleration (Axis tab).
Config conversion
Items of the "Edit" menu that allow to convert a configuration:
The "Replace Mouse" item allows to change the mouse name and id.
The "Convert mouse sensitivity" item allows to adjust the mouse sensitivity according to source/destination DPI values.
The "Replace Keyboard" item allows to change the keyboard name and id.
Advanced
- Multiple mice and keyboards: check this box if you want two mice or two keyboards to be independent.
- Use case: use the mouse wheel of a keypad (such as the n52te) independently from the mouse wheel.
- Link controls: updates bindings in all controller profiles.
- Use case: a same binding is defined in profiles 1 & 2; modify the binding in profile 1: the binding in profile 2 is updated.
- Auto-bind controls: remap bindings according to the labels; the configuration to modify and the reference configuration should have labels configured (column 'Label' in Button and Axis tabs).