Difference between revisions of "cock.setJoystickDeadzone"

(Created page with "Sets joystick deadzones per axis. == Synopsis == === Function === <source lang="Lua">cock.setJoystickDeadzone ( self, joystick, axis, threshold )</source> === Arguments === {{par...")
 
(Remarks)
Line 13: Line 13:
 
== Remarks ==
 
== Remarks ==
 
Axis value "true" will set given threshold to all axis. Threshold value must be less than 1.
 
Axis value "true" will set given threshold to all axis. Threshold value must be less than 1.
 +
 +
Setting a threshold results in axis readings range being "shrinked" towards the end. E.g., setting a threshold to 0.2 will only trigger joystick motion if reading surpass the threshold, but at that point it will return 0, gradually catching up with actual readings while going up to 1. This maintains entire axis range while getting rid of jittering, like when thumbstick doesn't goes to the dead center and jitters a little bit. Here's a figure displaying this:
 +
 +
[[File:cock.threshold.gif]]
  
 
==See also==
 
==See also==

Revision as of 18:11, 1 September 2013

Sets joystick deadzones per axis.

Synopsis

Function

cock.setJoystickDeadzone ( self, joystick, axis, threshold )

Arguments

table self
An object to use.
number joystick
Internal joystick number.
string joystick
Internal joystick name.
number axis
LÖVE joystick axis.
string axis
Axis name.
boolean axis
Value "true" will affect all axis.
number threshold
Deadzone threshold.

Remarks

Axis value "true" will set given threshold to all axis. Threshold value must be less than 1.

Setting a threshold results in axis readings range being "shrinked" towards the end. E.g., setting a threshold to 0.2 will only trigger joystick motion if reading surpass the threshold, but at that point it will return 0, gradually catching up with actual readings while going up to 1. This maintains entire axis range while getting rid of jittering, like when thumbstick doesn't goes to the dead center and jitters a little bit. Here's a figure displaying this:

cock.threshold.gif

See also