util
Small numeric helpers.
Functions
util.clamp
util.clamp(v, lo, hi) -> number| Name | Type |
|---|---|
| v | number |
| lo | number |
| hi | number |
Clamps v into [lo, hi].
util.lerp
util.lerp(a, b, t) -> number| Name | Type | Description |
|---|---|---|
| a | number | |
| b | number | |
| t | number | 0 gives a, 1 gives b. |
Linear interpolation; t is not clamped.
Returns a + (b - a) * t
util.round
util.round(v) -> integer| Name | Type |
|---|---|
| v | number |
Rounds halves up: -2.5 gives -2.
Returns floor(v + 0.5)
util.sign
util.sign(v) -> integer| Name | Type |
|---|---|
| v | number |
Sign of a number.
Returns 1, -1 or 0
util.map
util.map(v, a, b, c, d) -> number| Name | Type | Description |
|---|---|---|
| v | number | |
| a | number | Source range start. |
| b | number | Source range end. |
| c | number | Target range start. |
| d | number | Target range end. |
Remaps v from [a, b] to [c, d], unclamped.
Returns c when a == b.
util.normalize_yaw
util.normalize_yaw(yaw) -> number| Name | Type | Description |
|---|---|---|
| yaw | number | Degrees. |
Wraps an angle into -180 to 180 degrees.
util.approach
util.approach(cur, target, delta) -> number| Name | Type | Description |
|---|---|---|
| cur | number | |
| target | number | |
| delta | number | Max step; sign ignored. |
Steps cur towards target by at most delta.
Returns no overshoot
util.spring_damper
util.spring_damper([stiffness] [, damping]) -> spring| Name | Type | Description |
|---|---|---|
| stiffnessoptional | number | Default 120. |
| dampingoptional | number | Omit for critical (no overshoot). |
Spring that eases the view toward a target, for human-like aim.
Damping under 2 * sqrt(stiffness) overshoots a little, then settles.
spring:step
spring:step(delta, dt) -> Angle| Name | Type | Description |
|---|---|---|
| delta | Angle | Target minus current view. |
| dt | number | Seconds. |
Turn to apply this step.
Yaw in delta wraps to -180 to 180.
spring:reset
spring:reset()Drops the carried speed; call it when the target changes.
spring:set
spring:set(stiffness [, damping])| Name | Type | Description |
|---|---|---|
| stiffness | number | |
| dampingoptional | number | Omit for critical. |
Changes the spring.
spring:velocity
spring:velocity() -> AngleCurrent turn speed in degrees per second.
util.hash
util.hash(s) -> integer| Name | Type |
|---|---|
| s | string |
32-bit FNV-1a of a string, 0 to 4294967295.
Fast, not for passwords.