/* -------------------------------- pktdef.h -------------------------------- *//* Combined 16 & 32-bit version. *//*------------------------------------------------------------------------------The text and information contained in this file may be freely used,copied, or distributed without compensation or licensing restrictions.This file is copyright 1991-1998 by LCS/Telegraphics.------------------------------------------------------------------------------*//*------------------------------------------------------------------------------How to use pktdef.h:1. Include wintab.h2. if using just one packet format: a. Define PACKETDATA and PACKETMODE as or'ed combinations of WTPKT bits (use the PK_* identifiers). b. Include pktdef.h. c. The generated structure typedef will be called PACKET. Use PACKETDATA and PACKETMODE to fill in the LOGCONTEXT structure.3. If using multiple packet formats, for each one: a. Define PACKETNAME. Its text value will be a prefix for this packet's parameters and names. b. Define <PACKETNAME>PACKETDATA and <PACKETNAME>PACKETMODE similar to 2.a. above. c. Include pktdef.h. d. The generated structure typedef will be called <PACKETNAME>PACKET. Compare with 2.c. above and example #2 below.4. If using extension packet data, do the following additional steps for each extension: a. Before including pktdef.h, define <PACKETNAME>PACKET<EXTENSION> as either PKEXT_ABSOLUTE or PKEXT_RELATIVE. b. The generated structure typedef will contain a field for the extension data. c. Scan the WTI_EXTENSION categories to find the extension's packet mask bit. d. OR the packet mask bit with <PACKETNAME>PACKETDATA and use the result in the lcPktData field of the LOGCONTEXT structure. e. If <PACKETNAME>PACKET<EXTENSION> was PKEXT_RELATIVE, OR the packet mask bit with <PACKETNAME>PACKETMODE and use the result in the lcPktMode field of the LOGCONTEXT structure.Example #1. -- single packet format#include <wintab.h>#define PACKETDATA PK_X | PK_Y | PK_BUTTONS /@ x, y, buttons @/#define PACKETMODE PK_BUTTONS /@ buttons relative mode @/#include <pktdef.h>... lc.lcPktData = PACKETDATA; lc.lcPktMode = PACKETMODE;Example #2. -- multiple formats#include <wintab.h>#define PACKETNAME MOE#define MOEPACKETDATA PK_X | PK_Y | PK_BUTTONS /@ x, y, buttons @/#define MOEPACKETMODE PK_BUTTONS /@ buttons relative mode @/#include <pktdef.h>#define PACKETNAME LARRY#define LARRYPACKETDATA PK_Y | PK_Z | PK_BUTTONS /@ y, z, buttons @/#define LARRYPACKETMODE PK_BUTTONS /@ buttons relative mode @/#include <pktdef.h>#define PACKETNAME CURLY#define CURLYPACKETDATA PK_X | PK_Z | PK_BUTTONS /@ x, z, buttons @/#define CURLYPACKETMODE PK_BUTTONS /@ buttons relative mode @/#include <pktdef.h>... lcMOE.lcPktData = MOEPACKETDATA; lcMOE.lcPktMode = MOEPACKETMODE;... lcLARRY.lcPktData = LARRYPACKETDATA; lcLARRY.lcPktMode = LARRYPACKETMODE;... lcCURLY.lcPktData = CURLYPACKETDATA; lcCURLY.lcPktMode = CURLYPACKETMODE;Example #3. -- extension packet data "XFOO".#include <wintab.h>#define PACKETDATA PK_X | PK_Y | PK_BUTTONS /@ x, y, buttons @/#define PACKETMODE PK_BUTTONS /@ buttons relative mode @/#define PACKETXFOO PKEXT_ABSOLUTE /@ XFOO absolute mode @/#include <pktdef.h>...UINT ScanExts(UINT wTag){ UINT i; UINT wScanTag; /@ scan for wTag's info category. @/ for (i = 0; WTInfo(WTI_EXTENSIONS + i, EXT_TAG, &wScanTag); i++) { if (wTag == wScanTag) { /@ return category offset from WTI_EXTENSIONS. @/ return i; } } /@ return error code. @/ return 0xFFFF;}... lc.lcPktData = PACKETDATA; lc.lcPktMode = PACKETMODE;#ifdef PACKETXFOO categoryXFOO = ScanExts(WTX_XFOO); WTInfo(WTI_EXTENSIONS + categoryXFOO, EXT_MASK, &maskXFOO); lc.lcPktData |= maskXFOO;#if PACKETXFOO == PKEXT_RELATIVE lc.lcPktMode |= maskXFOO;#endif#endif WTOpen(hWnd, &lc, TRUE);------------------------------------------------------------------------------*/#ifdef __cplusplusextern "C" {#endif /* __cplusplus */#ifndef PACKETNAME /* if no packet name prefix */ #define __PFX(x) x #define __IFX(x,y) x ## y#else /* add prefixes and infixes to packet format names */ #define __PFX(x) __PFX2(PACKETNAME,x) #define __PFX2(p,x) __PFX3(p,x) #define __PFX3(p,x) p ## x #define __IFX(x,y) __IFX2(x,PACKETNAME,y) #define __IFX2(x,i,y) __IFX3(x,i,y) #define __IFX3(x,i,y) x ## i ## y#endif#define __SFX2(x,s) __SFX3(x,s)#define __SFX3(x,s) x ## s#define __TAG __IFX(tag,PACKET)#define __TYPES __PFX(PACKET), * __IFX(P,PACKET), NEAR * __IFX(NP,PACKET), \ FAR * __IFX(LP,PACKET)#define __DATA (__PFX(PACKETDATA))#define __MODE (__PFX(PACKETMODE))#define __EXT(x) __SFX2(__PFX(PACKET),x)typedef struct __TAG { #if (__DATA & PK_CONTEXT) HCTX pkContext; #endif #if (__DATA & PK_STATUS) UINT pkStatus; #endif #if (__DATA & PK_TIME) DWORD pkTime; #endif #if (__DATA & PK_CHANGED) WTPKT pkChanged; #endif #if (__DATA & PK_SERIAL_NUMBER) UINT pkSerialNumber; #endif #if (__DATA & PK_CURSOR) UINT pkCursor; #endif #if (__DATA & PK_BUTTONS) DWORD pkButtons; #endif #if (__DATA & PK_X) LONG pkX; #endif #if (__DATA & PK_Y) LONG pkY; #endif #if (__DATA & PK_Z) LONG pkZ; #endif #if (__DATA & PK_NORMAL_PRESSURE) #if (__MODE & PK_NORMAL_PRESSURE) /* relative */ int pkNormalPressure; #else /* absolute */ UINT pkNormalPressure; #endif #endif #if (__DATA & PK_TANGENT_PRESSURE) #if (__MODE & PK_TANGENT_PRESSURE) /* relative */ int pkTangentPressure; #else /* absolute */ UINT pkTangentPressure; #endif #endif #if (__DATA & PK_ORIENTATION) ORIENTATION pkOrientation; #endif #if (__DATA & PK_ROTATION) ROTATION pkRotation; /* 1.1 */ #endif#ifndef NOWTEXTENSIONS /* extensions begin here. */ #if (__EXT(FKEYS) == PKEXT_RELATIVE) || (__EXT(FKEYS) == PKEXT_ABSOLUTE) UINT pkFKeys; #endif #if (__EXT(TILT) == PKEXT_RELATIVE) || (__EXT(TILT) == PKEXT_ABSOLUTE) TILT pkTilt; #endif#endif} __TYPES ;#undef PACKETNAME#undef __TAG#undef __TAG2#undef __TYPES#undef __TYPES2#undef __DATA#undef __MODE#undef __PFX#undef __PFX2#undef __PFX3#undef __IFX#undef __IFX2#undef __IFX3#undef __SFX2#undef __SFX3#ifdef __cplusplus}#endif /* __cplusplus */