Pileus Git - ~andy/gtk/blob - gdk/win32/pktdef.h

   1 /* -------------------------------- pktdef.h -------------------------------- */
   2 /* Combined 16 & 32-bit version. */
   3
   4 /*------------------------------------------------------------------------------
   5 The text and information contained in this file may be freely used,
   6 copied, or distributed without compensation or licensing restrictions.
   7
   8 This file is copyright 1991-1998 by LCS/Telegraphics.
   9 ------------------------------------------------------------------------------*/
  10 /*------------------------------------------------------------------------------
  11
  12 How to use pktdef.h:
  13
  14 1. Include wintab.h
  15 2. if using just one packet format:
  16         a. Define PACKETDATA and PACKETMODE as or'ed combinations of WTPKT bits
  17            (use the PK_* identifiers).
  18         b. Include pktdef.h.
  19         c. The generated structure typedef will be called PACKET.  Use PACKETDATA
  20            and PACKETMODE to fill in the LOGCONTEXT structure.
  21 3. If using multiple packet formats, for each one:
  22         a. Define PACKETNAME. Its text value will be a prefix for this packet's
  23            parameters and names.
  24         b. Define <PACKETNAME>PACKETDATA and <PACKETNAME>PACKETMODE similar to
  25            2.a. above.
  26         c. Include pktdef.h.
  27         d. The generated structure typedef will be called
  28            <PACKETNAME>PACKET. Compare with 2.c. above and example #2 below.
  29 4. If using extension packet data, do the following additional steps
  30    for each extension:
  31         a. Before including pktdef.h, define <PACKETNAME>PACKET<EXTENSION>
  32            as either PKEXT_ABSOLUTE or PKEXT_RELATIVE.
  33         b. The generated structure typedef will contain a field for the
  34            extension data.
  35         c. Scan the WTI_EXTENSION categories to find the extension's
  36            packet mask bit.
  37         d. OR the packet mask bit with <PACKETNAME>PACKETDATA and use the
  38            result in the lcPktData field of the LOGCONTEXT structure.
  39         e. If <PACKETNAME>PACKET<EXTENSION> was PKEXT_RELATIVE, OR the
  40            packet mask bit with <PACKETNAME>PACKETMODE and use the result
  41            in the lcPktMode field of the LOGCONTEXT structure.
  42
  43
  44 Example #1.     -- single packet format
  45
  46 #include <wintab.h>
  47 #define PACKETDATA      PK_X | PK_Y | PK_BUTTONS        /@ x, y, buttons @/
  48 #define PACKETMODE      PK_BUTTONS                                      /@ buttons relative mode @/
  49 #include <pktdef.h>
  50 ...
  51         lc.lcPktData = PACKETDATA;
  52         lc.lcPktMode = PACKETMODE;
  53
  54 Example #2. -- multiple formats
  55
  56 #include <wintab.h>
  57 #define PACKETNAME              MOE
  58 #define MOEPACKETDATA   PK_X | PK_Y | PK_BUTTONS        /@ x, y, buttons @/
  59 #define MOEPACKETMODE   PK_BUTTONS                                      /@ buttons relative mode @/
  60 #include <pktdef.h>
  61 #define PACKETNAME              LARRY
  62 #define LARRYPACKETDATA PK_Y | PK_Z | PK_BUTTONS        /@ y, z, buttons @/
  63 #define LARRYPACKETMODE PK_BUTTONS                                      /@ buttons relative mode @/
  64 #include <pktdef.h>
  65 #define PACKETNAME              CURLY
  66 #define CURLYPACKETDATA PK_X | PK_Z | PK_BUTTONS        /@ x, z, buttons @/
  67 #define CURLYPACKETMODE PK_BUTTONS                                      /@ buttons relative mode @/
  68 #include <pktdef.h>
  69 ...
  70         lcMOE.lcPktData = MOEPACKETDATA;
  71         lcMOE.lcPktMode = MOEPACKETMODE;
  72 ...
  73         lcLARRY.lcPktData = LARRYPACKETDATA;
  74         lcLARRY.lcPktMode = LARRYPACKETMODE;
  75 ...
  76         lcCURLY.lcPktData = CURLYPACKETDATA;
  77         lcCURLY.lcPktMode = CURLYPACKETMODE;
  78
  79 Example #3. -- extension packet data "XFOO".
  80
  81 #include <wintab.h>
  82 #define PACKETDATA      PK_X | PK_Y | PK_BUTTONS        /@ x, y, buttons @/
  83 #define PACKETMODE      PK_BUTTONS                                      /@ buttons relative mode @/
  84 #define PACKETXFOO      PKEXT_ABSOLUTE                          /@ XFOO absolute mode @/
  85 #include <pktdef.h>
  86 ...
  87 UINT ScanExts(UINT wTag)
  88 {
  89         UINT i;
  90         UINT wScanTag;
  91
  92         /@ scan for wTag's info category. @/
  93         for (i = 0; WTInfo(WTI_EXTENSIONS + i, EXT_TAG, &wScanTag); i++) {
  94                  if (wTag == wScanTag) {
  95                         /@ return category offset from WTI_EXTENSIONS. @/
  96                         return i;
  97                 }
  98         }
  99         /@ return error code. @/
 100         return 0xFFFF;
 101 }
 102 ...
 103         lc.lcPktData = PACKETDATA;
 104         lc.lcPktMode = PACKETMODE;
 105 #ifdef PACKETXFOO
 106         categoryXFOO = ScanExts(WTX_XFOO);
 107         WTInfo(WTI_EXTENSIONS + categoryXFOO, EXT_MASK, &maskXFOO);
 108         lc.lcPktData |= maskXFOO;
 109 #if PACKETXFOO == PKEXT_RELATIVE
 110         lc.lcPktMode |= maskXFOO;
 111 #endif
 112 #endif
 113         WTOpen(hWnd, &lc, TRUE);
 114
 115
 116 ------------------------------------------------------------------------------*/
 117 #ifdef __cplusplus
 118 extern "C" {
 119 #endif  /* __cplusplus */
 120
 121 #ifndef PACKETNAME
 122         /* if no packet name prefix */
 123         #define __PFX(x)        x
 124         #define __IFX(x,y)      x ## y
 125 #else
 126         /* add prefixes and infixes to packet format names */
 127         #define __PFX(x)                __PFX2(PACKETNAME,x)
 128         #define __PFX2(p,x)             __PFX3(p,x)
 129         #define __PFX3(p,x)             p ## x
 130         #define __IFX(x,y)              __IFX2(x,PACKETNAME,y)
 131         #define __IFX2(x,i,y)   __IFX3(x,i,y)
 132         #define __IFX3(x,i,y)   x ## i ## y
 133 #endif
 134
 135 #define __SFX2(x,s)             __SFX3(x,s)
 136 #define __SFX3(x,s)             x ## s
 137
 138 #define __TAG   __IFX(tag,PACKET)
 139 #define __TYPES __PFX(PACKET), * __IFX(P,PACKET), NEAR * __IFX(NP,PACKET), \
 140                                         FAR * __IFX(LP,PACKET)
 141
 142 #define __DATA          (__PFX(PACKETDATA))
 143 #define __MODE          (__PFX(PACKETMODE))
 144 #define __EXT(x)        __SFX2(__PFX(PACKET),x)
 145
 146
 147 typedef struct __TAG {
 148         #if (__DATA & PK_CONTEXT)
 149                 HCTX                    pkContext;
 150         #endif
 151         #if (__DATA & PK_STATUS)
 152                 UINT                    pkStatus;
 153         #endif
 154         #if (__DATA & PK_TIME)
 155                 DWORD                   pkTime;
 156         #endif
 157         #if (__DATA & PK_CHANGED)
 158                 WTPKT                   pkChanged;
 159         #endif
 160         #if (__DATA & PK_SERIAL_NUMBER)
 161                 UINT                    pkSerialNumber;
 162         #endif
 163         #if (__DATA & PK_CURSOR)
 164                 UINT                    pkCursor;
 165         #endif
 166         #if (__DATA & PK_BUTTONS)
 167                 DWORD                   pkButtons;
 168         #endif
 169         #if (__DATA & PK_X)
 170                 LONG                    pkX;
 171         #endif
 172         #if (__DATA & PK_Y)
 173                 LONG                    pkY;
 174         #endif
 175         #if (__DATA & PK_Z)
 176                 LONG                    pkZ;
 177         #endif
 178         #if (__DATA & PK_NORMAL_PRESSURE)
 179                 #if (__MODE & PK_NORMAL_PRESSURE)
 180                         /* relative */
 181                         int                     pkNormalPressure;
 182                 #else
 183                         /* absolute */
 184                         UINT            pkNormalPressure;
 185                 #endif
 186         #endif
 187         #if (__DATA & PK_TANGENT_PRESSURE)
 188                 #if (__MODE & PK_TANGENT_PRESSURE)
 189                         /* relative */
 190                         int                     pkTangentPressure;
 191                 #else
 192                         /* absolute */
 193                         UINT            pkTangentPressure;
 194                 #endif
 195         #endif
 196         #if (__DATA & PK_ORIENTATION)
 197                 ORIENTATION             pkOrientation;
 198         #endif
 199         #if (__DATA & PK_ROTATION)
 200                 ROTATION                pkRotation; /* 1.1 */
 201         #endif
 202
 203 #ifndef NOWTEXTENSIONS
 204         /* extensions begin here. */
 205         #if (__EXT(FKEYS) == PKEXT_RELATIVE) || (__EXT(FKEYS) == PKEXT_ABSOLUTE)
 206                 UINT                    pkFKeys;
 207         #endif
 208         #if (__EXT(TILT) == PKEXT_RELATIVE) || (__EXT(TILT) == PKEXT_ABSOLUTE)
 209                 TILT                    pkTilt;
 210         #endif
 211 #endif
 212
 213 } __TYPES ;
 214
 215 #undef PACKETNAME
 216 #undef __TAG
 217 #undef __TAG2
 218 #undef __TYPES
 219 #undef __TYPES2
 220 #undef __DATA
 221 #undef __MODE
 222 #undef __PFX
 223 #undef __PFX2
 224 #undef __PFX3
 225 #undef __IFX
 226 #undef __IFX2
 227 #undef __IFX3
 228 #undef __SFX2
 229 #undef __SFX3
 230
 231 #ifdef __cplusplus
 232 }
 233 #endif  /* __cplusplus */