|
|
/* -------------------------------- 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.h 2. 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 __cplusplus
extern "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 */
|