summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2014-07-08 11:45:36 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2014-07-09 12:48:44 +1000
commit066092a04fd2a9419c392575cd1675d91c550d8c (patch)
tree6f2795a2e81972517fedc58b57367e78f6fa48fa
parent289949d0c43e4753ecc77ee05ee2092c893f7941 (diff)
downloadlibinput-066092a04fd2a9419c392575cd1675d91c550d8c.tar.gz
filter: annotate the various variables we have with units
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
-rw-r--r--src/filter.c40
1 files changed, 20 insertions, 20 deletions
diff --git a/src/filter.c b/src/filter.c
index 6fbd4d91..7db78bae 100644
--- a/src/filter.c
+++ b/src/filter.c
@@ -51,22 +51,22 @@ filter_destroy(struct motion_filter *filter)
* Default parameters for pointer acceleration profiles.
*/
-#define DEFAULT_CONSTANT_ACCELERATION 10.0
-#define DEFAULT_THRESHOLD 4.0
-#define DEFAULT_ACCELERATION 2.0
+#define DEFAULT_CONSTANT_ACCELERATION 10.0 /* unitless factor */
+#define DEFAULT_THRESHOLD 4.0 /* in units/ms */
+#define DEFAULT_ACCELERATION 2.0 /* unitless factor */
/*
* Pointer acceleration filter constants
*/
-#define MAX_VELOCITY_DIFF 1.0
+#define MAX_VELOCITY_DIFF 1.0 /* units/ms */
#define MOTION_TIMEOUT 300 /* (ms) */
#define NUM_POINTER_TRACKERS 16
struct pointer_tracker {
- double dx;
- double dy;
- uint64_t time;
+ double dx; /* delta to most recent event, in device units */
+ double dy; /* delta to most recent event, in device units */
+ uint64_t time; /* ms */
int dir;
};
@@ -76,10 +76,10 @@ struct pointer_accelerator {
accel_profile_func_t profile;
- double velocity;
- double last_velocity;
- int last_dx;
- int last_dy;
+ double velocity; /* units/ms */
+ double last_velocity; /* units/ms */
+ int last_dx; /* device units */
+ int last_dy; /* device units */
struct pointer_tracker *trackers;
int cur_tracker;
@@ -183,7 +183,7 @@ calculate_tracker_velocity(struct pointer_tracker *tracker, uint64_t time)
dx = tracker->dx;
dy = tracker->dy;
distance = sqrt(dx*dx + dy*dy);
- return distance / (double)(time - tracker->time);
+ return distance / (double)(time - tracker->time); /* units/ms */
}
static double
@@ -227,7 +227,7 @@ calculate_velocity(struct pointer_accelerator *accel, uint64_t time)
}
}
- return result;
+ return result; /* units/ms */
}
static double
@@ -254,7 +254,7 @@ calculate_acceleration(struct pointer_accelerator *accel,
factor = factor / 6.0;
- return factor;
+ return factor; /* unitless factor */
}
static void
@@ -264,8 +264,8 @@ accelerator_filter(struct motion_filter *filter,
{
struct pointer_accelerator *accel =
(struct pointer_accelerator *) filter;
- double velocity;
- double accel_value;
+ double velocity; /* units/ms */
+ double accel_value; /* unitless factor */
feed_trackers(accel, motion->dx, motion->dy, time);
velocity = calculate_velocity(accel, time);
@@ -329,12 +329,12 @@ calc_penumbral_gradient(double x)
double
pointer_accel_profile_smooth_simple(struct motion_filter *filter,
void *data,
- double velocity,
+ double velocity, /* units/ms */
uint64_t time)
{
- double threshold = DEFAULT_THRESHOLD;
- double accel = DEFAULT_ACCELERATION;
- double smooth_accel_coefficient;
+ double threshold = DEFAULT_THRESHOLD; /* units/ms */
+ double accel = DEFAULT_ACCELERATION; /* unitless factor */
+ double smooth_accel_coefficient; /* unitless factor */
if (threshold < 1.0)
threshold = 1.0;