Pointer Lab

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181

local cfg = UI.Schema({
  enabled = UI.Toggle(true, {
    label = "Apply transforms",
    group = "Pointer Lab",
    tooltip = "Turn off to pass original movement through. The toggle key flips this setting.",
  }),
  toggle = UI.Keybind("F8", {
    label = "Toggle key",
    group = "Pointer Lab",
  }),
  invert_x = UI.Toggle(false, {
    label = "Invert horizontal input",
    group = "Direction",
    tooltip = "Reverse the mouse X axis before rotation.",
  }),
  invert_y = UI.Toggle(false, {
    label = "Invert vertical input",
    group = "Direction",
    tooltip = "Reverse the mouse Y axis before rotation.",
  }),
  rotation = UI.Slider(0, {
    label = "Rotation (clockwise)",
    group = "Direction",
    min = -180,
    max = 180,
    step = 1,
    suffix = "°",
    tooltip = "With inversion off, +90 degrees turns rightward input downward.",
  }),
  sensitivity_x = UI.Slider(1, {
    label = "Horizontal sensitivity",
    group = "Sensitivity",
    min = 0.1,
    max = 4,
    step = 0.05,
    suffix = "x",
    tooltip = "Scale the output X axis after rotation. 1x leaves it unchanged.",
  }),
  sensitivity_y = UI.Slider(1, {
    label = "Vertical sensitivity",
    group = "Sensitivity",
    min = 0.1,
    max = 4,
    step = 0.05,
    suffix = "x",
    tooltip = "Scale the output Y axis after rotation. 1x leaves it unchanged.",
  }),
  curve_enabled = UI.Toggle(false, {
    label = "Use a movement curve",
    group = "Movement curve",
    tooltip = "Vary gain with movement speed. Off keeps sensitivity constant.",
  }),
  curve = UI.Select("Smooth", { "Linear", "Smooth", "Quadratic" }, {
    label = "Curve shape",
    group = "Movement curve",
    showIf = "curve_enabled",
    tooltip = "Linear changes evenly. Smooth eases at both ends. Quadratic changes slowly at first.",
  }),
  slow_gain = UI.Slider(0.5, {
    label = "Slow movement gain",
    group = "Movement curve",
    showIf = "curve_enabled",
    min = 0.1,
    max = 3,
    step = 0.05,
    suffix = "x",
    tooltip = "Gain near rest, multiplied by each axis sensitivity.",
  }),
  fast_gain = UI.Slider(2, {
    label = "Fast movement gain",
    group = "Movement curve",
    showIf = "curve_enabled",
    min = 0.1,
    max = 3,
    step = 0.05,
    suffix = "x",
    tooltip = "Gain at and above the transition speed. Set below slow gain to decelerate.",
  }),
  transition_speed = UI.Slider(10, {
    label = "Transition speed",
    group = "Movement curve",
    showIf = "curve_enabled",
    min = 0.5,
    max = 50,
    step = 0.5,
    suffix = " counts/ms",
    tooltip = "Raw movement speed at which fast gain is reached. Mouse DPI affects this value.",
  }),
})

local pending_x, pending_y = 0, 0
local remainder_x, remainder_y = 0, 0

local function reset_motion()
  pending_x, pending_y = 0, 0
  remainder_x, remainder_y = 0, 0
end

-- saved UI values are not range-checked by the SDK.
local function number_setting(value, default, low, high)
  if type(value) ~= "number" or value ~= value then
    return default
  end
  return math.max(low, math.min(high, value))
end

Bind(cfg.toggle, function()
  cfg.enabled = not cfg.enabled
  reset_motion()
  UI.Notify(cfg.enabled and "Pointer Lab enabled." or "Pointer Lab bypassed.")
end)

function OnMove(dx, dy)
  if cfg.enabled ~= true then
    reset_motion()
    return true
  end
  -- combine separately delivered X/Y events before measuring speed or rotating.
  pending_x = pending_x + dx
  pending_y = pending_y + dy
  return false
end

function OnTick(dt_ms)
  if cfg.enabled ~= true then
    reset_motion()
    return
  end
  local dx, dy = pending_x, pending_y
  pending_x, pending_y = 0, 0
  if dx == 0 and dy == 0 then
    return
  end

  local gain = 1
  if cfg.curve_enabled == true then
    local elapsed = dt_ms > 0 and dt_ms or 1
    local speed = math.sqrt(dx * dx + dy * dy) / elapsed
    local transition = number_setting(cfg.transition_speed, 10, 0.5, 50)
    local t = math.min(speed / transition, 1)
    if cfg.curve == "Smooth" then
      t = t * t * (3 - 2 * t)
    elseif cfg.curve == "Quadratic" then
      t = t * t
    end
    local slow = number_setting(cfg.slow_gain, 0.5, 0.1, 3)
    local fast = number_setting(cfg.fast_gain, 2, 0.1, 3)
    gain = slow + (fast - slow) * t
  end

  if cfg.invert_x == true then
    dx = -dx
  end
  if cfg.invert_y == true then
    dy = -dy
  end
  local angle = math.rad(number_setting(cfg.rotation, 0, -180, 180))
  local c, s = math.cos(angle), math.sin(angle)
  local x = (dx * c - dy * s)
      * number_setting(cfg.sensitivity_x, 1, 0.1, 4)
      * gain
    + remainder_x
  local y = (dx * s + dy * c)
      * number_setting(cfg.sensitivity_y, 1, 0.1, 4)
      * gain
    + remainder_y
  local out_x, out_y = math.floor(x + 0.5), math.floor(y + 0.5)
  -- HID.Move accepts integers; carry fractions instead of losing slow movement.
  remainder_x, remainder_y = x - out_x, y - out_y
  if out_x ~= 0 or out_y ~= 0 then
    HID.Move(out_x, out_y)
  end
end

function OnStop()
  reset_motion()
end

function OnBlur()
  reset_motion()
end