Struct PenPacket 

pub struct PenPacket {
    pub tool: PenKind,
    pub position: Point,
    pub pressure: f32,
    pub tilt: Option<(f32, f32)>,
    pub twist: Option<f32>,
    pub buttons: PenButtons,
    pub in_proximity: bool,
    pub down: bool,
    pub device_time_ms: Option<u32>,
}

One digitizer packet, normalised.

A packet is a level, not an edge: it describes the tool’s complete state at one instant, and the translator derives the transitions (enter, down, up, leave, button changes) by comparing consecutive packets. That is the shape both backends produce naturally — Wayland accumulates axes and commits them on frame, Win32 fills one POINTER_PEN_INFO per message — and it means a dropped packet costs a sample, never a stuck button.

Fields

tool: PenKind

The tool the digitizer says is in use. The eraser end is a tool, not a button.

position: Point

Window-logical position, already divided by the window’s scale factor.

pressure: f32

Normalised tip pressure, 0.0..=1.0. 0.0 while hovering.

tilt: Option<(f32, f32)>

(tilt_x, tilt_y) in degrees, each -90.0..=90.0, or None when the tool has no tilt axis.

twist: Option<f32>

Barrel rotation in degrees, 0.0..=359.0, or None when the tool has no rotation axis.

buttons: PenButtons

The stylus buttons held.

in_proximity: bool

Whether the tool is within the digitizer’s detection range. A packet with in_proximity: false ends the hover session.

down: bool

Whether the tip is touching the surface.

device_time_ms: Option<u32>

The device’s own millisecond counter, on whatever clock the OS uses, or None from a source that has no clock at all.

Deliberately not an EventTime: the epoch is unknown. Wayland’s frame time is the compositor’s, Win32’s dwTime is GetTickCount’s, and neither has a known offset from the tree’s epoch, so as an absolute this number is a lie dressed as precision.

Within one drained batch it is exact as a relative, and that is the only way it is ever read: back_date places a batch on the tree’s timeline by anchoring the newest packet at the poll’s now and walking backwards through these deltas. That is what stops twenty packets spanning one drain from all claiming a single instant, which is what they did while this field did not exist.

A u32 because both platforms report one, wrap included: back_date reads the deltas with wrapping_sub, so a counter rolling over inside a batch costs nothing.

Implementations

impl PenPacket

pub fn hovering(tool: PenKind, position: Point) -> Self

A hovering packet: in proximity, tip up, no pressure, no buttons.

pub fn out_of_proximity(tool: PenKind, position: Point) -> Self

The packet a tool leaving the digitizer’s range produces. Position is the last known one — the tool did not move, it stopped being seen.

pub fn down_at(self, pressure: f32) -> Self

This packet with the tip in contact at pressure.

pub const fn at_device_ms(self, ms: u32) -> Self

This packet stamped with the device’s own millisecond counter.

The value a shim reads off the digitizer — Wayland’s frame time, Win32’s dwTime. See device_time_ms for why it stays a raw counter rather than becoming an EventTime.

Trait Implementations

impl Clone for PenPacket

fn clone(&self) -> PenPacket

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PenPacket

impl Debug for PenPacket

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for PenPacket

fn eq(&self, other: &PenPacket) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PenPacket