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
• 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)