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 time: EventTime,
}

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.

time: EventTime

The backend’s timestamp on the tree’s timeline, or EventTime::ZERO when it has none.

Both shipped shims stamp ZERO: Wayland’s frame time and Win32’s dwTime are millisecond counters on device clocks with no known offset from the tree’s epoch, and inventing one would be a lie dressed as precision. The translator then stamps the poll’s now, which is the tree’s own clock and is never more than one event-loop turn late.

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.

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