Edit

PacketProperty GUIDs

  • Article

The following table lists packet property GUIDs used by the PACKET_PROPERTY structure.

GUID Description
GUID_ALTITUDE_ORIENTATION
 Angle between the axis of the pen and the surface of the tablet. The value is 0 when the pen is parallel to the surface and 90 when the pen is perpendicular to the surface. The values are negative when the pen is inverted.
GUID_AZIMUTH_ORIENTATION
 Clockwise rotation of the cursor around the z-axis through a full circular range.
GUID_BOXNUMBER
 The GUID that is used to retrieve the box number for an ink recognition alternate when the recognizer is operating in box mode.
GUID_BUTTON_PRESSURE
 Pressure on a pressure-sensitive button.
GUID_NORMAL_PRESSURE
 The GUID for the PacketProperty object that represents pressure of the pen tip perpendicular to the tablet surface. The greater the pressure put on the pen tip, the more ink that is drawn.
GUID_PACKET_STATUS
 Contains one or more of the following flag values:
  • The cursor is touching the drawing surface (Value = 1).
  • The cursor is inverted. For example, the eraser end of the pen is pointing toward the surface (Value = 2).
  • Not used (Value = 4).
  • The barrel button is pressed (Value = 8).
GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
 The device contact identifier for a packet.
GUID_SERIAL_NUMBER
 Identifies the packet. This is the same value you use to retrieve the packet from the packet queue.
GUID_TANGENT_PRESSURE
 The GUID for the PacketProperty object that represents pressure of the pen tip along the plane of the tablet surface.
GUID_TIMER_TICK
 Time the packet was generated.
GUID_TWIST_ORIENTATION
 Clockwise rotation of the cursor around its own axis.
GUID_X
 The x-coordinate in the tablet coordinate space. Each packet contains this property by default. The origin (0,0) of the tablet is the upper-left corner.
GUID_X_TILT_ORIENTATION
 For a pen cursor, the x-tilt orientation is the angle between the y,z-plane and the pen and y-axis plane. The value is 0 when the pen is perpendicular to the drawing surface and is positive when the pen is to the right of perpendicular.
GUID_Y
 The y-coordinate in the tablet coordinate space. Each packet contains this property by default. The origin (0,0) of the tablet is the upper-left corner.
GUID_Y_TILT_ORIENTATION
 For a pen cursor, the y-tilt orientation is the angle between the x,z-plane and the pen and x-axis plane. The value is 0 when the pen is perpendicular to the drawing surface and is positive when the pen is upward, or away from the user.
GUID_Z
 The z-coordinate or distance of the pen tip from the tablet surface. The PROPERTY_UNITS enumeration type determines the unit of measurement for this property.

 

Note

The TangentPressure field represents pressure along the plane of the tablet surface; the NormalPressure field represents pressure perpendicular to the plane of the tablet surface.