4.13.2 Packet class

4.13.2 Packet class

class Packet( )

pktdata: This is a copy of the pktdata attribute of the corresponding context, i.e. this attribute determines which of the following attributes are actually valid.

context: Specifies the context that generated the event.

status

Contains a combination of the following status and error conditions:

Status bit	Description
`TPS_PROXIMITY`	The cursor is out of the context
`TPS_QUEUE_ERR`	The event queue for the context has overflowed
`TPS_MARGIN`	The cursor is in the margin of the context
`TPS_GRAB`	The cursor is out of the context, but the context has grabbed input
`TPS_INVERT`	The cursor is in its inverted state

time: In absolute mode, specifies the system time at which the event was posted. In relative mode, specifies the elapsed time in milliseconds since the last packet.

changed: Specifies which of the included packet data items have changed since the previously posted event.

serial: Contains a serial number assigned to the packet by the context.

cursor: Specifies which cursor type generated the packet.

buttons: In absolute, contains the current button state. In relative mode, the low word contains a button number and the high word contains one of the following codes: TBN_NONE if there was no change in button state, TBN_UP if the button was released or TBN_DOWN if the button was pressed.

x: In absolute mode, contains the scaled cursor location along the x axis. In relative mode, contains the scaled change in cursor position.

y: In absolute mode, contains the scaled cursor location along the y axis. In relative mode, contains the scaled change in cursor position.

z: In absolute mode, contains the scaled cursor location along the z axis. In relative mode, contains the scaled change in cursor position.

normalpressure: In absolute mode, contains the adjusted state of the normal pressure. In relative mode, contains the change in adjusted pressure state.

tangentpressure: In absolute mode, contains the adjusted state of the tangential pressure. In relative mode, contains the change in adjusted pressure state.

orient_azimuth: Specifies the clockwise rotation of the cursor about the z axis through a full circular range.

orient_altitude: Specifies the angle with the x-y plane through a signed, semicircular range.

orient_twist: Specifies the clockwise rotation of the cursor about its own major axis.

rot_pitch: Specifies the pitch of the cursor.

rot_roll: Specifies the roll of the cursor.

rot_yaw: Specifies the yaw of the cursor.