File: System\Windows\Input\Stylus\Common\StylusPointPropertyId.cs
Web Access
Project: src\src\Microsoft.DotNet.Wpf\src\PresentationCore\PresentationCore.csproj (PresentationCore)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
namespace System.Windows.Input
{
    /// <summary>
    /// StylusPointPropertyIds
    /// </summary>
    /// <ExternalAPI/>
    internal static class StylusPointPropertyIds
    {
        #region Property GUIDs
 
        /// <summary>
        /// The x-coordinate in the tablet coordinate space.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid X = new Guid(0x598A6A8F, 0x52C0, 0x4BA0, 0x93, 0xAF, 0xAF, 0x35, 0x74, 0x11, 0xA5, 0x61);
        /// <summary>
        /// The y-coordinate in the tablet coordinate space.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid Y = new Guid(0xB53F9F75, 0x04E0, 0x4498, 0xA7, 0xEE, 0xC3, 0x0D, 0xBB, 0x5A, 0x90, 0x11);
        /// <summary>
        /// The z-coordinate or distance of the pen tip from the tablet surface.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid Z = new Guid(0x735ADB30, 0x0EBB, 0x4788, 0xA0, 0xE4, 0x0F, 0x31, 0x64, 0x90, 0x05, 0x5D);
        /// <summary>
        /// The width value of touch on the tablet surface.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid Width = new Guid(0xbaabe94d, 0x2712, 0x48f5, 0xbe, 0x9d, 0x8f, 0x8b, 0x5e, 0xa0, 0x71, 0x1a);
        /// <summary>
        /// The height value of touch on the tablet surface.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid Height = new Guid(0xe61858d2, 0xe447, 0x4218, 0x9d, 0x3f, 0x18, 0x86, 0x5c, 0x20, 0x3d, 0xf4);
        /// <summary>
        /// SystemTouch
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid SystemTouch = new Guid(0xe706c804, 0x57f0, 0x4f00, 0x8a, 0x0c, 0x85, 0x3d, 0x57, 0x78, 0x9b, 0xe9);
        /// <summary>
        /// The current status of the pen pointer.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid PacketStatus = new Guid(0x6E0E07BF, 0xAFE7, 0x4CF7, 0x87, 0xD1, 0xAF, 0x64, 0x46, 0x20, 0x84, 0x18);
        /// <summary>
        /// Identifies the packet.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid SerialNumber = new Guid(0x78A81B56, 0x0935, 0x4493, 0xBA, 0xAE, 0x00, 0x54, 0x1A, 0x8A, 0x16, 0xC4);
        /// <summary>
        /// Downward pressure of the pen tip on the tablet surface.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid NormalPressure = new Guid(0x7307502D, 0xF9F4, 0x4E18, 0xB3, 0xF2, 0x2C, 0xE1, 0xB1, 0xA3, 0x61, 0x0C);
        /// <summary>
        /// Diagonal pressure of the pen tip on the tablet surface.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid TangentPressure = new Guid(0x6DA4488B, 0x5244, 0x41EC, 0x90, 0x5B, 0x32, 0xD8, 0x9A, 0xB8, 0x08, 0x09);
        /// <summary>
        /// Pressure on a pressure sensitive button.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid ButtonPressure = new Guid(0x8B7FEFC4, 0x96AA, 0x4BFE, 0xAC, 0x26, 0x8A, 0x5F, 0x0B, 0xE0, 0x7B, 0xF5);
        /// <summary>
        /// The x-tilt orientation is the angle between the y,z-plane and the pen and y-axis plane.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid XTiltOrientation = new Guid(0xA8D07B3A, 0x8BF0, 0x40B0, 0x95, 0xA9, 0xB8, 0x0A, 0x6B, 0xB7, 0x87, 0xBF);
        /// <summary>
        /// The y-tilt orientation is the angle between the x,z-plane and the pen and x-axis plane.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid YTiltOrientation = new Guid(0x0E932389, 0x1D77, 0x43AF, 0xAC, 0x00, 0x5B, 0x95, 0x0D, 0x6D, 0x4B, 0x2D);
        /// <summary>
        /// Clockwise rotation of the pen about the z axis through a full circular range.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid AzimuthOrientation = new Guid(0x029123B4, 0x8828, 0x410B, 0xB2, 0x50, 0xA0, 0x53, 0x65, 0x95, 0xE5, 0xDC);
        /// <summary>
        /// Angle between the axis of the pen and the surface of the tablet.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid AltitudeOrientation = new Guid(0x82DEC5C7, 0xF6BA, 0x4906, 0x89, 0x4F, 0x66, 0xD6, 0x8D, 0xFC, 0x45, 0x6C);
        /// <summary>
        /// Clockwise rotation of the pen about its own axis.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid TwistOrientation = new Guid(0x0D324960, 0x13B2, 0x41E4, 0xAC, 0xE6, 0x7A, 0xE9, 0xD4, 0x3D, 0x2D, 0x3B);
        /// <summary>
        /// Identifies whether the tip is above or below a horizontal line that is perpendicular to the writing surface.  Requires 3D digitizer.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid PitchRotation = new Guid(0x7F7E57B7, 0xBE37, 0x4BE1, 0xA3, 0x56, 0x7A, 0x84, 0x16, 0x0E, 0x18, 0x93);
        /// <summary>
        /// Clockwise rotation of the pen about its own axis.  Requires 3D digitizer.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid RollRotation = new Guid(0x5D5D5E56, 0x6BA9, 0x4C5B, 0x9F, 0xB0, 0x85, 0x1C, 0x91, 0x71, 0x4E, 0x56);
        /// <summary>
        /// Yaw identifies whether the tip is turning left or right around the center of its horzontal axis (pen is horizontal).  Requires 3D digitizer.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid YawRotation = new Guid(0x6A849980, 0x7C3A, 0x45B7, 0xAA, 0x82, 0x90, 0xA2, 0x62, 0x95, 0x0E, 0x89);
        /// <summary>
        /// Identifies the tip button of a stylus.  Used for identifying StylusButtons in StylusPointDescription.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid TipButton = new Guid(0x39143d3, 0x78cb, 0x449c, 0xa8, 0xe7, 0x67, 0xd1, 0x88, 0x64, 0xc3, 0x32);
        /// <summary>
        /// Identifies the button on the barrel of a stylus.  Used for identifying StylusButtons in StylusPointDescription.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid BarrelButton = new Guid(0xf0720328, 0x663b, 0x418f, 0x85, 0xa6, 0x95, 0x31, 0xae, 0x3e, 0xcd, 0xfa);
        /// <summary>
        /// Identifies the secondary tip barrel button of a stylus.  Used for identifying StylusButtons in StylusPointDescription.
        /// </summary>
        /// <ExternalAPI/>
        public static readonly Guid SecondaryTipButton = new Guid(0x67743782, 0xee5, 0x419a, 0xa1, 0x2b, 0x27, 0x3a, 0x9e, 0xc0, 0x8f, 0x3d);
 
        #endregion
 
        #region HID Constants
 
        /// <summary>
        ///
        /// WM_POINTER stack must parse out HID spec usage pages
        /// <see cref="http://www.usb.org/developers/hidpage/Hut1_12v2.pdf"/> 
        /// </summary>
        internal enum HidUsagePage
        {
            Undefined = 0x00,
            Generic = 0x01,
            Simulation = 0x02,
            Vr = 0x03,
            Sport = 0x04,
            Game = 0x05,
            Keyboard = 0x07,
            Led = 0x08,
            Button = 0x09,
            Ordinal = 0x0a,
            Telephony = 0x0b,
            Consumer = 0x0c,
            Digitizer = 0x0d,
            Unicode = 0x10,
            Alphanumeric = 0x14,
            BarcodeScanner = 0x8C,
            WeighingDevice = 0x8D,
            MagneticStripeReader = 0x8E,
            CameraControl = 0x90,
            MicrosoftBluetoothHandsfree = 0xfff3,
        }
 
        /// <summary>
        ///
        /// 
        /// WISP pre-parsed these, WM_POINTER stack must do it itself
        /// 
        /// See Stylus\biblio.txt - 1
        /// <see cref="http://www.usb.org/developers/hidpage/Hut1_12v2.pdf"/> 
        /// </summary>
        internal enum HidUsage
        {
            TipPressure = 0x30,
            X = 0x30,
            BarrelPressure = 0x31,
            Y = 0x31,
            Z = 0x32,
            XTilt = 0x3D,
            YTilt = 0x3E,
            Azimuth = 0x3F,
            Altitude = 0x40,
            Twist = 0x41,
            TipSwitch = 0x42,
            SecondaryTipSwitch = 0x43,
            BarrelSwitch = 0x44,
            TouchConfidence = 0x47,
            Width = 0x48,
            Height = 0x49,
            TransducerSerialNumber = 0x5B,
        }
 
        #endregion
 
        #region HID Associations
 
        /// <summary>
        ///
        /// WM_POINTER stack usage preparation based on associations maintained from the legacy WISP based stack
        /// </summary>
        private static Dictionary<HidUsagePage, Dictionary<HidUsage, Guid>> _hidToGuidMap = new Dictionary<HidUsagePage, Dictionary<HidUsage, Guid>>()
        {
            { HidUsagePage.Generic,
                new Dictionary<HidUsage, Guid>()
                {
                    { HidUsage.X, X },
                    { HidUsage.Y, Y },
                    { HidUsage.Z, Z },
                }
            },
            { HidUsagePage.Digitizer,
                new Dictionary<HidUsage, Guid>()
                {
                    { HidUsage.Width, Width },
                    { HidUsage.Height, Height },
                    { HidUsage.TouchConfidence, SystemTouch },
                    { HidUsage.TipPressure, NormalPressure },
                    { HidUsage.BarrelPressure, ButtonPressure },
                    { HidUsage.XTilt, XTiltOrientation },
                    { HidUsage.YTilt, YTiltOrientation },
                    { HidUsage.Azimuth, AzimuthOrientation },
                    { HidUsage.Altitude, AltitudeOrientation },
                    { HidUsage.Twist, TwistOrientation },
                    { HidUsage.TipSwitch, TipButton },
                    { HidUsage.SecondaryTipSwitch, SecondaryTipButton },
                    { HidUsage.BarrelSwitch, BarrelButton },
                    { HidUsage.TransducerSerialNumber, SerialNumber },
                }
            },
        };
 
        #endregion
 
        #region Utility Functions
 
        /// <summary>
        /// Retrieves the GUID of the stylus property associated with the usage page and usage ids
        /// within the HID specification.
        /// </summary>
        /// <param name="page">The usage page id of the HID specification</param>
        /// <param name="usage">The usage id of the HID specification</param>
        /// <returns>
        /// If known, the GUID associated with the usagePageId and usageId.
        /// If not known, GUID.Empty
        /// </returns>
        internal static Guid GetKnownGuid(HidUsagePage page, HidUsage usage)
        {
            Guid result = Guid.Empty;
 
            Dictionary<HidUsage, Guid> pageMap = null;
 
            if (_hidToGuidMap.TryGetValue(page, out pageMap))
            {
                pageMap.TryGetValue(usage, out result);
            }
 
            return result;
        }
 
        /// <summary>
        /// Called by the StylusPointProperty constructor.
        /// Any new Guids in this static class should be added here
        /// </summary>
        /// <param name="guid">guid</param>
        internal static bool IsKnownId(Guid guid)
        {
            if (guid == X ||
                guid == Y ||
                guid == Z ||
                guid == Width ||
                guid == Height ||
                guid == SystemTouch ||
                guid == PacketStatus ||
                guid == SerialNumber ||
                guid == NormalPressure ||
                guid == TangentPressure ||
                guid == ButtonPressure ||
                guid == XTiltOrientation ||
                guid == YTiltOrientation ||
                guid == AzimuthOrientation ||
                guid == AltitudeOrientation ||
                guid == TwistOrientation ||
                guid == PitchRotation ||
                guid == RollRotation ||
                guid == YawRotation ||
                guid == TipButton ||
                guid == BarrelButton ||
                guid == SecondaryTipButton)
            {
                return true;
            }
            return false;
        }
 
        /// <summary>
        /// Called by the StylusPointProperty constructor.
        /// Any new Guids in this static class should be added here
        /// </summary>
        /// <param name="guid">guid</param>
        internal static string GetStringRepresentation(Guid guid)
        {
            if (guid == X)
            {
                return "X";
            }
            if (guid == Y)
            {
                return "Y";
            }
            if (guid == Z)
            {
                return "Z";
            }
            if (guid == Width)
            {
                return "Width";
            }
            if (guid == Height)
            {
                return "Height";
            }
            if (guid == SystemTouch)
            {
                return "SystemTouch";
            }
            if (guid == PacketStatus)
            {
                return "PacketStatus";
            }
            if (guid == SerialNumber)
            {
                return "SerialNumber";
            }
            if (guid == NormalPressure)
            {
                return "NormalPressure";
            }
            if (guid == TangentPressure)
            {
                return "TangentPressure";
            }
            if (guid == ButtonPressure)
            {
                return "ButtonPressure";
            }
            if (guid == XTiltOrientation)
            {
                return "XTiltOrientation";
            }
            if (guid == YTiltOrientation)
            {
                return "YTiltOrientation";
            }
            if (guid == AzimuthOrientation)
            {
                return "AzimuthOrientation";
            }
            if (guid == AltitudeOrientation)
            {
                return "AltitudeOrientation";
            }
            if (guid == TwistOrientation)
            {
                return "TwistOrientation";
            }
            if (guid == PitchRotation)
            {
                return "PitchRotation";
            }
            if (guid == RollRotation)
            {
                return "RollRotation";
            }
            if (guid == AltitudeOrientation)
            {
                return "AltitudeOrientation";
            }
            if (guid == YawRotation)
            {
                return "YawRotation";
            }
            if (guid == TipButton)
            {
                return "TipButton";
            }
            if (guid == BarrelButton)
            {
                return "BarrelButton";
            }
            if (guid == SecondaryTipButton)
            {
                return "SecondaryTipButton";
            }
            return "Unknown";
        }
 
        /// <summary>
        /// Called by the StylusPointProperty constructor.
        /// Any new button Guids in this static class should be added here
        /// </summary>
        /// <param name="guid">guid</param>
        internal static bool IsKnownButton(Guid guid)
        {
            if (guid == TipButton ||
                guid == BarrelButton ||
                guid == SecondaryTipButton)
            {
                return true;
            }
            return false;
        }
 
        #endregion
    }
}