TSdlPenAxis

Pen axis indices.

These are the valid values for the Axis field in TSdlPenAxisEvent. All axes are either normalised to 0..1 or report a (positive or negative) angle in degrees, with 0.0 representing the centre. Not all pens/backends support all axes: unsupported axes are always zero.

To convert angles for tilt and rotation into vector representation, use Sin on the XTilt, YTilt, or Rotation component, for example:

Sin(XTilt * PI / 180).

Definition

Unit: Neslib.Sdl3.Input

type TSdlPenAxis = (Presssure, XTilt, YTilt, Distance, Rotation, Slider, TangentialPressure)

Enumeration Values

Presssure = SDL_PEN_AXIS_PRESSURE

Pen pressure. Unidirectional: 0 to 1.0

---

XTilt = SDL_PEN_AXIS_XTILT

Pen horizontal tilt angle. Bidirectional: -90.0 to 90.0 (left-to-right).

---

YTilt = SDL_PEN_AXIS_YTILT

Pen vertical tilt angle. Bidirectional: -90.0 to 90.0 (top-to-down).

---

Distance = SDL_PEN_AXIS_DISTANCE

Pen distance to drawing surface. Unidirectional: 0.0 to 1.0

---

Rotation = SDL_PEN_AXIS_ROTATION

Pen barrel rotation. Bidirectional: -180 to 179.9 (clockwise, 0 is facing up, -180.0 is facing down).

---

Slider = SDL_PEN_AXIS_SLIDER

Pen finger wheel or slider (e.g., Airbrush Pen). Unidirectional: 0 to 1.0

---

TangentialPressure = SDL_PEN_AXIS_TANGENTIAL_PRESSURE

Pressure from squeezing the pen ("barrel pressure").

---