/* * Copyright (C) 1991-1998 by LCS/Telegraphics * Copyright (C) 2002 Patrik Stridvall * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ #ifndef __WINE_PKTDEF_H #define __WINE_PKTDEF_H /*********************************************************************** * 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 /* defined(__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), \ * __IFX(NP,PACKET), * __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 } /* extern "C" */ #endif /* defined(__cplusplus) */ #endif /* defined(__WINE_PKTDEF_H */