F Mapping editing
- First row is source
- First source is the one used to calculate destination value, except if or/xor is in use (see below), then it adapt
- A popup reminds you if the first source is not filled in, because we need it to calculate the destination value
- You have null, half and full if you need a neutral source
- Solo is central led and battery status
- central led is working as long as the mapping is active and doesn't react to conditions
- Eight ones are destination (together, or in a timeline)
- Group of checkboxes is for mouse choice (to use with special action ACTIVE_MOUSE)
- Group of numbers, Grid, is either for special actions,
- or to use mouse in a zone instead of the full screen, divided or not in a grid
- or to use mouse in the full screen, divided
- Two digits in the lower right corner are the mouse coordinates (see Efficiency)
- At the right of button OK, it's relaod, window pop again
- After validating an edition of a single mapping, to make some different quick tests, with same datas
- After adding a new mapping, to directly add a new one, with fresh datas
______________________________________________________________________________________ Input method
Under first source you'll find 3 checkboxes which determine the method
| Checkboxes | Method | Description |
|---|---|---|
| None | Simple | Start when pressed, stop when release |
| First | Short(1) | You have to press and release quickly |
| Second | Double | You'll have to double press in a limited time |
| Third | Long | You have to stay pressed from a certain time |
| 1 & 2 | Double short(1) | Second press acting like short |
| 2 & 3 | Double long | Second press acting like long |
| 1 & 3 | Medium long | Like long but after double long |
| All | Very long |
(1) you'll have to use timestamp, otherwise you can simply use on release or go to timestamp too
In terms of time:
| Method | Press times |
|---|---|
| Simple | Immediate |
| Short | found in settings |
| Double | ~first press and second press < long |
| Long | found in settings |
| Double | ~first press and second press < long + second press duration < short |
| Double short* | ~first press and second press < long + second press duration > long |
| Medium long | ~press > twice the time as long |
| Very long | found in settings |
______________________________________________________________________________________ If mouse/Force
Over first source you can find special requirements
- If mouse, if a mouse is already in use
- double, if none mouse is actually in use
- And Force, to ignore if a button has been disabled by a precedent mapping
- double, this will work only if this mapping is already working
______________________________________________________________________________________ Or/Xor
Over two next sources you'll find 'or'
- double, 'xor' conditions instead of simple combination
- If only first 'or' is used and first source is killed to launch the mapping (for example, pushed more than a short press), and still pushed, second source is still available. But both will have to be released to be available to trigger the mapping again
- The mapping is launched over those conditions:
| OrXor1 | OrXor2 | Source1 | Source2 | Source3 | ||||
|---|---|---|---|---|---|---|---|---|
| 0 | 0 | val | & | val | & | val | ||
| 1/2 | 0 | ( | val | OrXor | val | ) & | val | |
| 0 | 1/2 | val | & ( | val | OrXor | val | ) | |
| 1/2 | … | ( | val | OrXor | val | ) | & | |
| … | 1/2 | ( | val | OrXor | val | ) |
- The source value used to calculate destination value is then:
| OrXor1 | OrXor2 | Sustain ? | Source1 | Source2 | Source3 | Source1 | |||
|---|---|---|---|---|---|---|---|---|---|
| 0 | 0 | 'No Sustain' ? | val | > | released1 | ||||
| 1/2 | 0 | > : 0xFF | val | > | val | > | released1 | ||
| 0 | 1/2 | (see Controls/ | val | > | released1 | ||||
| 1/2 | 1/2 | Interrupt) | val | > | val | > | val | > | released1 |
- sustain is released and time stamps is in use (and no 'Interrupt' else mapping is stopped when released)
______________________________________________________________________________________ Not
Over two last sources you'll find not condition,
- The mapping won't be launched if this button is pressed
- double, except if this mapping is already running
- see 'Pause' for more informations about not condition
- Taking into consideration that 'LastResult' is the result of the last or/xor table, the mapping is launched over those conditions:
| Not1 | Not2 | LastResult | Source4 | Source5 | ||
|---|---|---|---|---|---|---|
| 0 | 0 | val | & | val | & | val |
| 1 | 0 | val | & Not | val | & | val |
| 0 | 1 | val | & | val | & Not | val |
| 1 | 1 | val | & Not | val | & Not | val |
______________________________________________________________________________________ Time stamps
Destinations can be effected with time stamps for tricky actions, macros or combos
- Enter start (if not as soon as) or/and end (if not when release)
- If you enter an odd number, 0-9 milliseconds will be added, different each time
______________________________________________________________________________________ OnRelease
- Middle check box, OnRelease, is to begin the action on release
- double, only the up press, even if some other timestamps are finished
- Upper one, NoRelease, is to decide to not do release action while transitivity mode active (see Transitivity) and mode changed
- double, one turn of this release action will still be performed then stopped
- Upper one again, NlRelease (normal release), is to decide not perform NoRelease condition if back to initial mode
- double, not perform NoRelease condition while the new mode
______________________________________________________________________________________ Disabling
Under each source and destination, you'll find disabling
- this button will be disabled for next mappings if this mapping is running (except with Force)
- double (only source), if Short (or Double), even when release time, before time to activate spent (or second press)
- double (only destination), if time stamp is in use, disabling will be effective until whole mapping is finished instead this destination only
______________________________________________________________________________________ Controls
Under central led, you'll find 4 checkboxes
- Interrupt: Interrupt macros on release (even if timestamp not finished)
- double, No sustain: we use release value of first source instead of 0xFF if timestamp is still in use and we have released sources
- second source too if first is not pushed and OrXor1
- third source too if first is not pushed, second isn't in used and OrXor1 + OrXor2
- double, No sustain: we use release value of first source instead of 0xFF if timestamp is still in use and we have released sources
- Pause: pause this mapping while a 'not1' condition
- double: pause this mapping while a 'not2' condition
- triple: pause this mapping while a 'not' condition
- otherwise:
- if 'not' is a simple, and 'not' button is pressed, the mapping is interrupted
- if 'not' is a double, and 'not' button is pressed, the mapping still continue
- Transitivity: Brings different behaviors and transition possibilities while mode changed (see table of transitivity below)
- Toggle: Satisfy mapping condition once to start, once again one to stop
- double, destinations states begin activated at program launch
- can be used to time based mouse actions too,
- and for mouse if ACTIVE_MOUSE special action is used (see below)
______________________________________________________________________________________ Transitivity
Table of Transitivity:
| Transitivity | Result |
|---|---|
| Conduct | If the source is already pushed when entering the new mode, the mapping is triggered |
| Complete | You can release and trigger again in new mode if it was already active before changing mode |
| Limited | Action continue while changing mode, but you can't trigger again if release |
| Retroactive | Instead of continuation, button is released, but triggered again if still pushed when initial mode is back |
| One time back | The same as Retroactive, but while pushed, you can change mode and get it triggered again only one time |
| After, you have to release and trigger it again in its own mode |
- in any case, you cannot launch the mapping of a mode when another mode is active, if it was not activated before this change of mode
- except conduct, especially useful to, for example: FULL>Led2 (placed under a tab switched to mode 2) to indicate mode 2 is well activating
- IF RELEASED GOTO, IF PUSHED GOTO and RETURN_TO time actions, are not concerned by transitivity
You can find this help directly in Ds2vJoy by pressing help below grid entries or in tooltips
______________________________________________________________________________________ Overcontrol
Upper one, Overcontrol:
Like for normal axis, the value of axis movement takes place over last axis values of the same type (for example X, XTR, XINV, XY_C_UR: XY center to UpRight)
- but you can use Overcontrol checkbox to fuse values
- double, Protect: further axis action which should overpass this one won't be permit (may be used on other Mapping buttons)
- if there are merged Mapping axes of type X, Y, Z, RZ in the mapping, the threshold is removed on, respectively, the LX, LY, RX, RY axes of ds
______________________________________________________________________________________ Switch
Downer one, Switch:
simple, On
- double, Off Switch can be use in conjunction or independently from Toggle
- In conjuction it forces the toggle state
- Otherwize it acts as a linear commutator
______________________________________________________________________________________ Mouse
The mouse group of checkboxes at the bottom, let you use mouse in conjuction with ACTIVE_MOUSE special action
- With left stick (left column)
- With the touchpad (central column)
- With the right stick (right column)
- double, deactivate this mouse
There is different modes for each
| Value | stick | touchpad | Description |
|---|---|---|---|
| 0 | None | None | |
| 1 | Absolute | Absolute | you move at a point which correspond to the coordinates of the stick or touchpad |
| 2 | Mouse | Mouse | as a normal mouse with acceleration |
| 3 | Move | Slow | the same but adapted for game movements, or precise mouse |
| 4 | Sniper | Accuracy | extreme precision |
| 5 | Raid | Grid | move inside a zone whom coordinates are entered in numbers group at the right |
- Last solo checkbox is for when you have together raid/grid and another mouse mode active, to determine which one is the default one
- Sniper mouse mode, which require liberty of movement but not erratic while near center, use Sniper Axis, near no threshold and not no threshold, to help stabilizating when little force is exerted or even released
______________________________________________________________________________________ Grid
In this numbers group at the right
- left ones are for first point, central ones for second point,
- Or they are for MOVE_TO_XY/MOVE_TO_WH/MOVE_TO_NN, SAVE_AND_MOVE_TO_XY/SAVE_AND_MOVE_TO_WH/SAVE_AND_MOVE_TO_NN special mouse actions (two left/central numbers of the grid)
- two last ones are for third point,
- Or to divide the zone in a grid, then you are always docked to a point of this grid (or whole screen)