Request #: HUTRR60 Title: Stylus Width and Type Usages, Diagnostics, and Errors Spec Release: 1.12 Received: Requester: Dave Fleck Company: Wacom Company Limited Phone: 360-896-9833 FAX: email: dfleck@wacom.com ----------------- CurrentStatus: Approved Priority: Normal Submitted: 26 Feb 2016 Voting Starts: 14 Mar 2016 Voting Ends: 21 Mar 2016 Required Voter: Wacom Required Voter: Intel Required Voter: Microsoft ---------------- Summary: -------- 1) We would like to add the ability for a stylus transducer to indicate a preferred line width and line style when inking. We would also like to indicate when the preferred characteristics of color, line width, and line style are “locked”. 2) We would like to add a diagnostic usage. 3) We would like to add error indicator usages for digitizers. Background: ----------- As styli become more widespread there is more likelihood for the same stylus to be used in multiple applications or on multiple systems. When moving between applications or systems it would be more intuitive for the user if the virtual on-screen ink was consistent between these applications and systems. These new usages allow for the stylus to indicate the preferred line width and line style. Also, there are times when these usages should be read only. Examples would be if the stylus has physical ink, a color set by selector switches, or does not have an ability to be written. Currently diagnostic feature reports are vendor defined and have to be referenced by their report ID, which requires coordinating report IDs across devices or possibly manufacturers. By having a diagnostic usage the diagnostic features can be discovered by their usage instead of report ID. Adding error usages allows for consistent error reporting. Proposal: --------- All changes are localized to Chapter 16 Digitizers (0x0D). New usages to be added to Table 18: Digitizer Page 5D Preferred Color is Locked MC 16.3.1 5E Preferred Line Width DV 16.3.1 5F Preferred Line Width is Locked MC 16.3.1 70 Preferred Line Style NAry 16.3.1 71 Preferred Line Style is Locked MC 16.3.1 72 Ink Sel 16.3.1 73 Pencil Sel 16.3.1 74 Highlighter Sel 16.3.1 75 Chisel Marker Sel 16.3.1 76 Brush Sel 16.3.1 77 No preference Sel 16.3.1 78-7F Reserved for future line styles 80 Digitizer Diagnostic CL 16.7 81 Digitizer Error NAry 16.7 82 Err Normal Status Sel 16.7 83 Err Transducers Exceeded Sel 16.7 84 Err Full Trans Features Unavail Sel 16.7 85 Err Charge Low Sel 16.7 86-8F Reserved for future errors Change the following in Table 18 Digitizer Page: From: Usage ID: 5D-FFFF Usage Name: Reserved To: Usage ID: 90-FFFF Usage Name: Reserved Additions referenced by the above usages: Section 16.3.1 Digitizer-Specific Fields Preferred Color is Locked MC - This is an indication that the preferred color cannot be changed. This may be because the body color or tail switch selection is expected to be honored, or that the transducer does not allow or is incapable of changing the preferred color. Preferred Line Width DV - An indication of what line width the transducer would prefer to render. This may be an indication of the physical width of the tip of a stylus. If the transducer allows writing to the usage it may store a width for later retrieval. The descriptor for this usage is expected to include logical and physical minimums and maximums. The recommended physical resolution is 0.1 mm. A zero line width indicates minimum possible width (such as one pixel width at any zoom factor). Preferred Line Width is Locked MC - This is an indication that the preferred line width cannot be changed. This may be because the line width indicates a physical tip size and is expected to be enforced, or that the transducer does not allow or is incapable of changing the preferred line width. Preferred Line Style NAry - An indication of what line style the transducer would prefer to render. This may be an indication of the physical characteristics of the stylus. If the transducer allows writing to the usage it may store a line style for later retrieval. Preferred Line Style is Locked MC - This is an indication that the preferred line style cannot be changed. This may be because the transducer has physical ink or pencil and style is expected to be enforced, or that the transducer does not allow or is incapable of changing the preferred line style. Ink Sel - This type indicates an inking pen, such as ballpoint, roller ball, gel, or fountain. This is usually the default style for note taking. Pencil Sel - This type indicates a graphite pencil style. Highlighter Sel - This type indicates a flat (not chisel) tip highlighter style. Chisel Marker Sel - This type indicates a chisel tip marker style. Brush Sel - This type indicates a round brush style. No preference Sel - This indicates a lack of preference or a generic style. Section 16.7 Device configuration usages Digitizer Diagnostic CL - This is a collection used for diagnostic purposes. This usage allows diagnostic feature reports to be discovered by usage instead of a report ID. Digitizer Status NAry – This is a collection of the status codes that the digitizer supports. The status codes are reported in a single location array. Err Normal Status Sel – This status indicates the digitizer is operating normally. Err Transducers Exceeded Sel – This error will occur if the number of transducers in range of a digitizer exceeds the number of simultaneously supported transducers. Err Full Trans Features Unavail Sel – This error will occur if all of the features of a transducer cannot be supported. This could happen, for example, if the available bandwidth between a transducer and digitizer is insufficient to transport all available data. In this situation the digitizer may fall back to only transporting the highest priority data. Err Charge Low Sel - This error occurs when the transducer’s battery or super-cap charge is low and the user needs to recharge their transducer. Response: ---------