开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
RAVE.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：76k
源码类别：

多媒体编程

开发平台：

Visual C++

RAVE.h：源码内容
  1. /*
  2.      File:       RAVE.h
  3.  
  4.      Contains:   Interface for RAVE (Renderer Acceleration Virtual Engine)
  5.  
  6.      Version:    Technology: Quickdraw 3D 1.6
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1995-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __RAVE__
  18. #define __RAVE__
  20. #ifndef __CONDITIONALMACROS__
  21. #include "ConditionalMacros.h"
  22. #endif
  25. #if TARGET_OS_MAC
  26. #ifndef __MACTYPES__
  27. #include "MacTypes.h"
  28. #endif
  30. #ifndef __QUICKDRAW__
  31. #include "Quickdraw.h"
  32. #endif
  34. #ifndef __QDOFFSCREEN__
  35. #include "QDOffscreen.h"
  36. #endif
  39. #endif  /* TARGET_OS_MAC */
  41. #if TARGET_OS_WIN32
  42. #include "windows.h"
  43. #ifndef RAVE_NO_DIRECTDRAW
  44. #include "ddraw.h"
  45. #endif  /* !defined(RAVE_NO_DIRECTDRAW) */
  47. #endif  /* TARGET_OS_WIN32 */
  51. #if PRAGMA_ONCE
  52. #pragma once
  53. #endif
  55. #ifdef __cplusplus
  56. extern "C" {
  57. #endif
  59. #if PRAGMA_IMPORT
  60. #pragma import on
  61. #endif
  63. #if PRAGMA_STRUCT_ALIGN
  64.     #pragma options align=power
  65. #elif PRAGMA_STRUCT_PACKPUSH
  66.     #pragma pack(push, 2)
  67. #elif PRAGMA_STRUCT_PACK
  68.     #pragma pack(2)
  69. #endif
  71. #if PRAGMA_ENUM_ALWAYSINT
  72.     #if defined(__fourbyteints__) && !__fourbyteints__ 
  73.         #define __RAVE__RESTORE_TWOBYTEINTS
  74.         #pragma fourbyteints on
  75.     #endif
  76.     #pragma enumsalwaysint on
  77. #elif PRAGMA_ENUM_OPTIONS
  78.     #pragma option enum=int
  79. #elif PRAGMA_ENUM_PACK
  80.     #if __option(pack_enums)
  81.         #define __RAVE__RESTORE_PACKED_ENUMS
  82.         #pragma options(!pack_enums)
  83.     #endif
  84. #endif
  86. #define RAVE_OBSOLETE 0
  88. /******************************************************************************
  89.  *
  90.  * Platform macros.
  91.  * This sets kQAPlatform to one of kQAMacOS, kQAWin32, or kQAGeneric.
  92.  * kQAPlatform controls platform-specific compilation switches and types.
  93.  *
  94.  *****************************************************************************/
  96. #if !defined(kQAMacOS)
  97. #define  kQAMacOS        1           /* Target is MacOS                  */
  98. #endif
  100. #if !defined(kQAGeneric)
  101. #define kQAGeneric      2           /* Target is generic platform       */
  102. #endif
  104. #if !defined(kQAWin32)
  105. #define kQAWin32      3           /* Target is Win32                  */
  106. #endif
  108. #if defined(_WIN32) || defined(_WINDOWS)
  109.     #define kQAPlatform kQAWin32
  110. #elif !defined(kQAPlatform)
  111.    #define kQAPlatform kQAMacOS
  112. #endif
  115. /******************************************************************************
  116.  *
  117.  * Export Control
  118.  *
  119.  *****************************************************************************/
  120. #if defined(_MSC_VER)
  121.     /* Microsoft Visual C */
  122.    #if defined(WIN32_RAVEEXPORTING)    
  123.    /* define when building DLL */
  124.      #define RAVE_EXPORT     __declspec( dllexport )
  125.         #define RAVE_CALL
  126.       #define RAVE_CALLBACK
  127.   #else
  128.       #define RAVE_EXPORT     __declspec( dllimport )
  129.         #define RAVE_CALL       __cdecl
  130.         #define RAVE_CALLBACK   __cdecl
  131.     #endif 
  132.     /* WIN32_RAVEEXPORTING */
  133. #else
  134.     #define RAVE_EXPORT
  135.     #define RAVE_CALL
  136.   #define RAVE_CALLBACK
  137. #endif 
  138. /* _MSC_VER */
  140. /******************************************************************************
  141.  *
  142.  * Platform dependent datatypes: TQAImagePixelType, TQADevice, TQAClip, and TQARect.
  143.  *
  144.  *****************************************************************************/
  146. enum TQAImagePixelType {
  147.     kQAPixel_Alpha1             = 0,                            /* 1 bit/pixel alpha */
  148.     kQAPixel_RGB16              = 1,                            /* 16 bits/pixel, R=14:10, G=9:5, B=4:0 */
  149.     kQAPixel_ARGB16             = 2,                            /* 16 bits/pixel, A=15, R=14:10, G=9:5, B=4:0 */
  150.     kQAPixel_RGB32              = 3,                            /* 32 bits/pixel, R=23:16, G=15:8, B=7:0 */
  151.     kQAPixel_ARGB32             = 4,                            /* 32 bits/pixel, A=31:24, R=23:16, G=15:8, B=7:0 */
  152.     kQAPixel_CL4                = 5,                            /* 4 bit color look up table, always big endian, ie high 4 bits effect left pixel */
  153.     kQAPixel_CL8                = 6,                            /* 8 bit color look up table */
  154.     kQAPixel_RGB16_565          = 7,                            /* Win32 ONLY  16 bits/pixel, no alpha, R:5, G:6, B:5 */
  155.     kQAPixel_RGB24              = 8,                            /* Win32 ONLY  24 bits/pixel, no alpha, R:8, G:8, B:8 */
  156.     kQAPixel_RGB8_332           = 9,                            /* 8 bits/pixel, R=7:5, G = 4:2, B = 1:0 */
  157.     kQAPixel_ARGB16_4444        = 10,                           /* 16 bits/pixel, A=15:12, R=11:8, G=7:4, B=3:0 */
  158.     kQAPixel_ACL16_88           = 11,                           /* 16 bits/pixel, A=15:8, CL=7:0, 8 bit alpha + 8 bit color lookup */
  159.     kQAPixel_I8                 = 12,                           /* 8 bits/pixel, I=7:0, intensity map (grayscale) */
  160.     kQAPixel_AI16_88            = 13,                           /* 16 bits/pixel, A=15:8, I=7:0, intensity map (grayscale) */
  161.     kQAPixel_YUVS               = 14,                           /* 16 bits/pixel, QD's kYUVSPixelFormat (4:2:2, YUYV ordering, unsigned UV) */
  162.     kQAPixel_YUVU               = 15,                           /* 16 bits/pixel, QD's kYUVUPixelFormat (4:2:2, YUYV ordering, signed UV) */
  163.     kQAPixel_YVYU422            = 16,                           /* 16 bits/pixel, QD's kYVYU422PixelFormat (4:2:2, YVYU ordering, unsigned UV) */
  164.     kQAPixel_UYVY422            = 17                            /* 16 bits/pixel, QD's kUYVY422PixelFormat (4:2:2, UYVY ordering, unsigned UV) */
  165. };
  166. typedef enum TQAImagePixelType TQAImagePixelType;
  169. enum TQAColorTableType {
  170.     kQAColorTable_CL8_RGB32     = 0,                            /* 256 entry, 32 bit/pixel, R=23:16, G=15:8, B=7:0 */
  171.     kQAColorTable_CL4_RGB32     = 1                             /* 16 entry, 32 bit/pixel, R=23:16, G=15:8, B=7:0 */
  172. };
  173. typedef enum TQAColorTableType TQAColorTableType;
  175. /* Selects target device type */
  177. enum TQADeviceType {
  178.     kQADeviceMemory             = 0,                            /* Memory draw context */
  179.     kQADeviceGDevice            = 1,                            /* Macintosh GDevice draw context */
  180.     kQADeviceWin32DC            = 2,                            /* Win32 DC */
  181.     kQADeviceDDSurface          = 3                             /* Win32 DirectDraw Surface */
  182. };
  183. typedef enum TQADeviceType TQADeviceType;
  185. /* Generic memory pixmap device */
  187. struct TQADeviceMemory {
  188.     long                            rowBytes;                   /* Rowbytes */
  189.     TQAImagePixelType               pixelType;                  /* Depth, color space, etc. */
  190.     long                            width;                      /* Width in pixels */
  191.     long                            height;                     /* Height in pixels */
  192.     void *                          baseAddr;                   /* Base address of pixmap */
  193. };
  194. typedef struct TQADeviceMemory          TQADeviceMemory;
  195. /* Offscreen Device */
  197. struct TQADeviceOffscreen {
  198.     TQAImagePixelType               pixelType;                  /* Depth, color space, etc. */
  199. };
  200. typedef struct TQADeviceOffscreen       TQADeviceOffscreen;
  201. /* Selects target clip type */
  203. enum TQAClipType {
  204.     kQAClipRgn                  = 0,                            /* Macintosh clipRgn with serial number */
  205.     kQAClipWin32Rgn             = 1                             /* Win32 clip region */
  206. };
  207. typedef enum TQAClipType TQAClipType;
  210. struct TQARect {
  211.     long                            left;
  212.     long                            right;
  213.     long                            top;
  214.     long                            bottom;
  215. };
  216. typedef struct TQARect                  TQARect;
  217. #if TARGET_OS_MAC
  219. union TQAPlatformDevice {
  220.     TQADeviceMemory                 memoryDevice;
  221.     GDHandle                        gDevice;
  222. };
  223. typedef union TQAPlatformDevice         TQAPlatformDevice;
  225. union TQAPlatformClip {
  226.     RgnHandle                       clipRgn;
  227. };
  228. typedef union TQAPlatformClip           TQAPlatformClip;
  229. typedef CALLBACK_API( void , TQADrawNotificationProcPtr )(short left, short top, short right, short bottom, long refCon);
  231. typedef long                            TQADrawNotificationProcRefNum;
  232. /* used to unregister your proc */
  233. #elif TARGET_OS_WIN32
  235. #if !defined(RAVE_NO_DIRECTDRAW)
  237.  enum TQADirectDrawObjectSelector
  238.    {
  239.       kQADirectDrawObject     = 1,
  240.        kQADirectDrawObject2    = 2
  241.     };
  242.  typedef enum TQADirectDrawObjectSelector TQADirectDrawObjectSelector;
  244.  enum TQADirectDrawSurfaceSelector
  245.   {
  246.       kQADirectDrawSurface    = 1,
  247.        kQADirectDrawSurface2   = 2
  248.     };
  249.  typedef enum TQADirectDrawSurfaceSelector TQADirectDrawSurfaceSelector;
  251. #endif /* !RAVE_NO_DIRECTDRAW */
  253.  union TQAPlatformDevice
  254.     {
  255.       TQADeviceMemory         memoryDevice;
  256.       HDC                     hdc;
  257. #if !defined(RAVE_NO_DIRECTDRAW)
  258.       struct
  259.      {
  260.           TQADirectDrawObjectSelector     objectSelector;
  261.             union
  262.           {
  263.               LPDIRECTDRAW                lpDirectDraw;
  264.               LPDIRECTDRAW2               lpDirectDraw2;
  265.          };
  267.             TQADirectDrawSurfaceSelector    surfaceSelector;
  268.            union
  269.           {
  270.               LPDIRECTDRAWSURFACE         lpDirectDrawSurface;
  271.                LPDIRECTDRAWSURFACE2        lpDirectDrawSurface2;
  272.           };
  273.      };
  274. #endif /* RAVE_NO_DIRECTDRAW */
  275.  };
  276.  typedef union TQAPlatformDevice TQAPlatformDevice;
  277.  
  278.    union TQAPlatformClip
  279.   {
  280.       HRGN            clipRgn;
  281.    };
  282.  typedef union TQAPlatformClip TQAPlatformClip;
  284. #else
  285. /*
  286.      * Generic platform supports memory device only. TQARect is generic. TQAClip is ???.
  287.      */
  289. union TQAPlatformDevice {
  290.     TQADeviceMemory                 memoryDevice;
  291. };
  292. typedef union TQAPlatformDevice         TQAPlatformDevice;
  294. union TQAPlatformClip {
  295.     void *                          region;                     /* ??? */
  296. };
  297. typedef union TQAPlatformClip           TQAPlatformClip;
  298. #endif  /*  */
  301. struct TQADevice {
  302.     TQADeviceType                   deviceType;
  303.     TQAPlatformDevice               device;
  304. };
  305. typedef struct TQADevice                TQADevice;
  307. struct TQAClip {
  308.     TQAClipType                     clipType;
  309.     TQAPlatformClip                 clip;
  310. };
  311. typedef struct TQAClip                  TQAClip;
  312. /******************************************************************************
  313.  *
  314.  * Basic data types.
  315.  *
  316.  *****************************************************************************/
  318. /* Pointer to a drawing engine */
  319. typedef struct TQAEngine TQAEngine;
  320. /* Pointer to an allocated texture */
  321. typedef struct TQATexture TQATexture;
  322. /* Pointer to an allocated bitmap */
  323. typedef struct TQABitmap TQABitmap;
  324. /* Engine's private draw context pointer */
  325. typedef struct TQADrawPrivate TQADrawPrivate;
  326. /* An engine specific color table structure */
  327. typedef struct TQAColorTable TQAColorTable;
  328. /* A single triangle element for QADrawTriMesh */
  330. struct TQAIndexedTriangle {
  331.     unsigned long                   triangleFlags;              /* Triangle flags, see kQATriFlags_ */
  332.     unsigned long                   vertices[3];                /* Indices into a vertex array */
  333. };
  334. typedef struct TQAIndexedTriangle       TQAIndexedTriangle;
  335. /* An image for use as texture or bitmap */
  337. struct TQAImage {
  338.     long                            width;                      /* Width of pixmap */
  339.     long                            height;                     /* Height of pixmap */
  340.     long                            rowBytes;                   /* Rowbytes of pixmap */
  341.     void *                          pixmap;                     /* Pixmap */
  342. };
  343. typedef struct TQAImage                 TQAImage;
  344. /* a pixel buffer */
  346. typedef TQADeviceMemory                 TQAPixelBuffer;
  347. /* a zbuffer */
  349. struct TQAZBuffer {
  350.     long                            width;                      /* Width of pixmap */
  351.     long                            height;                     /* Height of pixmap */
  352.     long                            rowBytes;                   /* Rowbytes of pixmap */
  353.     void *                          zbuffer;                    /* pointer to the zbuffer data */
  354.     long                            zDepth;                     /* bit depth of zbuffer (16,24,32...) */
  355.     long                            isBigEndian;                /* true if zbuffer values are in big-endian format, false if little-endian */
  356. };
  357. typedef struct TQAZBuffer               TQAZBuffer;
  358. /* Standard error type */
  360. enum TQAError {
  361.     kQANoErr                    = 0,                            /* No error */
  362.     kQAError                    = 1,                            /* Generic error flag */
  363.     kQAOutOfMemory              = 2,                            /* Insufficient memory */
  364.     kQANotSupported             = 3,                            /* Requested feature is not supported */
  365.     kQAOutOfDate                = 4,                            /* A newer drawing engine was registered */
  366.     kQAParamErr                 = 5,                            /* Error in passed parameters */
  367.     kQAGestaltUnknown           = 6,                            /* Requested gestalt type isn't available */
  368.     kQADisplayModeUnsupported   = 7,                            /* Engine cannot render to the display in its current , */
  369.                                                                 /* mode, but could if it were in some other mode */
  370.     kQAOutOfVideoMemory         = 8                             /* There is not enough VRAM to support the desired context dimensions */
  371. };
  372. typedef enum TQAError TQAError;
  374. /* TQABoolean */
  376. typedef unsigned char                   TQABoolean;
  377. /************************************************************************************************
  378.  *
  379.  * Vertex data types.
  380.  *
  381.  ***********************************************************************************************/
  382. /*
  383.  * TQAVGouraud is used for Gouraud shading. Each vertex specifies position, color and Z.
  384.  *
  385.  * Alpha is always treated as indicating transparency. Drawing engines which don't
  386.  * support Z-sorted rendering use the back-to-front transparency blending functions
  387.  * shown below. (ARGBsrc are the source (new) values, ARGBdest are  the destination
  388.  * (previous) pixel values.)
  389.  *
  390.  *      Premultiplied                           Interpolated
  391.  *
  392.  *      A = 1 - (1 - Asrc) * (1 - Adest)        A = 1 - (1 - Asrc) * (1 - Adest) 
  393.  *      R = (1 - Asrc) * Rdest + Rsrc           R = (1 - Asrc) * Rdest + Asrc * Rsrc
  394.  *      G = (1 - Asrc) * Gdest + Gsrc           G = (1 - Asrc) * Gdest + Asrc * Gsrc
  395.  *      B = (1 - Asrc) * Bdest + Bsrc           B = (1 - Asrc) * Bdest + Asrc * Bsrc
  396.  *
  397.  * Note that the use of other blending modes to implement antialiasing is performed
  398.  * automatically by the drawing engine when the kQATag_Antialias variable !=
  399.  * kQAAntiAlias_Fast. The driving software should continue to use the alpha fields
  400.  * for transparency even when antialiasing is being used (the drawing engine will
  401.  * resolve the multiple blending requirements as best as it can).
  402.  *
  403.  * Drawing engines which perform front-to-back Z-sorted rendering should replace
  404.  * the blending function shown above with the equivalent front-to-back formula.
  405.  */
  407. struct TQAVGouraud {
  408.     float                           x;                          /* X pixel coordinate, 0.0 <= x < width */
  409.     float                           y;                          /* Y pixel coordinate, 0.0 <= y < height */
  410.     float                           z;                          /* Z coordinate, 0.0 <= z <= 1.0 */
  411.     float                           invW;                       /* 1 / w; required only when kQAPerspectiveZ_On is set */
  413.     float                           r;                          /* Red, 0.0 <= r <= 1.0 */
  414.     float                           g;                          /* Green, 0.0 <= g <= 1.0 */
  415.     float                           b;                          /* Blue, 0.0 <= b <= 1.0 */
  416.     float                           a;                          /* Alpha, 0.0 <= a <= 1.0, 1.0 is opaque */
  417. };
  418. typedef struct TQAVGouraud              TQAVGouraud;
  419. /*
  420.  * TQAVTexture is used for texture mapping. The texture mapping operation
  421.  * is controlled by the kQATag_TextureOp variable, which is a mask of
  422.  * kQATextureOp_None/Modulate/Highlight/Decal. Below is pseudo-code for the
  423.  * texture shading operation:
  424.  *
  425.  *      texPix = TextureLookup (uq/q, vq/q);
  426.  *      if (kQATextureOp_Decal)
  427.  *      {
  428.  *          texPix.r = texPix.a * texPix.r + (1 - texPix.a) * r;
  429.  *          texPix.g = texPix.a * texPix.g + (1 - texPix.a) * g;
  430.  *          texPix.b = texPix.a * texPix.b + (1 - texPix.a) * b;
  431.  *          texPix.a = a;
  432.  *      }
  433.  *      else
  434.  *      {
  435.  *          texPix.a = texPix.a * a;
  436.  *      }
  437.  *      if (kQATextureOp_Modulate)
  438.  *      {
  439.  *          texPix.r *= kd_r;       // Clamped to prevent overflow
  440.  *          texPix.g *= kd_g;       // Clamped to prevent overflow
  441.  *          texPix.b *= kd_b;       // Clamped to prevent overflow
  442.  *      }
  443.  *      if (kQATextureOp_Highlight)
  444.  *      {
  445.  *          texPix.r += ks_r;       // Clamped to prevent overflow
  446.  *          texPix.g += ks_g;       // Clamped to prevent overflow
  447.  *          texPix.b += ks_b;       // Clamped to prevent overflow
  448.  *      }
  449.  *
  450.  * After computation of texPix, transparency blending (as shown
  451.  * above for TQAVGouraud) is performed.
  452.  */
  454. struct TQAVTexture {
  455.     float                           x;                          /* X pixel coordinate, 0.0 <= x < width */
  456.     float                           y;                          /* Y pixel coordinate, 0.0 <= y < height */
  457.     float                           z;                          /* Z coordinate, 0.0 <= z <= 1.0 */
  458.     float                           invW;                       /* 1 / w (always required) */
  460.                                                                 /* rgb are used only when kQATextureOp_Decal is set. a is always required */
  462.     float                           r;                          /* Red, 0.0 <= r <= 1.0 */
  463.     float                           g;                          /* Green, 0.0 <= g <= 1.0 */
  464.     float                           b;                          /* Blue, 0.0 <= b <= 1.0 */
  465.     float                           a;                          /* Alpha, 0.0 <= a <= 1.0, 1.0 is opaque */
  467.                                                                 /* uOverW and vOverW are required by all modes */
  469.     float                           uOverW;                     /* u / w */
  470.     float                           vOverW;                     /* v / w */
  472.                                                                 /* kd_r/g/b are used only when kQATextureOp_Modulate is set */
  474.     float                           kd_r;                       /* Scale factor for texture red, 0.0 <= kd_r */
  475.     float                           kd_g;                       /* Scale factor for texture green, 0.0 <= kd_g */
  476.     float                           kd_b;                       /* Scale factor for texture blue, 0.0 <= kd_b */
  478.                                                                 /* ks_r/g/b are used only when kQATextureOp_Highlight is set */
  480.     float                           ks_r;                       /* Red specular highlight, 0.0 <= ks_r <= 1.0 */
  481.     float                           ks_g;                       /* Green specular highlight, 0.0 <= ks_g <= 1.0 */
  482.     float                           ks_b;                       /* Blue specular highlight, 0.0 <= ks_b <= 1.0 */
  483. };
  484. typedef struct TQAVTexture              TQAVTexture;
  485. /*
  486. *  TQAVMultiTexture allows you to specify the uv and invW values
  487. *  for secondary textures.  This data is submitted with the
  488. *  QASubmitMultiTextureParams() call.
  489. */
  491. struct TQAVMultiTexture {
  492.     float                           invW;
  493.     float                           uOverW;
  494.     float                           vOverW;
  495. };
  496. typedef struct TQAVMultiTexture         TQAVMultiTexture;
  498. /************************************************************************************************
  499.  *
  500.  * Constants used for the state variables.
  501.  *
  502.  ***********************************************************************************************/
  503. /*
  504.  * kQATag_xxx is used to select a state variable when calling QASetFloat(), QASetInt(),
  505.  * QAGetFloat() and QAGetInt(). The kQATag values are split into three separate enumerated
  506.  * types: TQATagInt, TQATagPtr and TQATagFloat. TQATagInt is used for the QASet/GetInt()
  507.  * functions, TQATagPtr is used for the QASet/GetPtr() functions, and TQATagFloat is used for 
  508.  * the QASet/GetFloat() functions. (This is so that a compiler that typechecks enums can flag
  509.  * a float/int tag mismatch during compile.)
  510.  *
  511.  * -=- All tag values must be unique even across all three types. -=-
  512.  *
  513.  * These variables are required by all drawing engines:
  514.  *      kQATag_ZFunction            (Int)   One of kQAZFunction_xxx
  515.  *      kQATag_ColorBG_a            (Float) Background color alpha
  516.  *      kQATag_ColorBG_r            (Float) Background color red
  517.  *      kQATag_ColorBG_g            (Float) Background color green
  518.  *      kQATag_ColorBG_b            (Float) Background color blue
  519.  *      kQATag_Width                (Float) Line and point width (pixels)
  520.  *      kQATag_ZMinOffset           (Float) Min offset to Z to guarantee visibility (Read only!)
  521.  *      kQATag_ZMinScale            (Float) Min scale to Z to guarantee visibility (Read only!)
  522.  
  523.  * These variables are used for optional features:
  524.  *      kQATag_Antialias            (Int)   One of kQAAntiAlias_xxx
  525.  *      kQATag_Blend                (Int)   One of kQABlend_xxx
  526.  *      kQATag_PerspectiveZ         (Int)   One of kQAPerspectiveZ_xxx
  527.  *      kQATag_TextureFilter        (Int)   One of kQATextureFilter_xxx
  528.  *      kQATag_TextureOp            (Int)   Mask of kQATextureOp_xxx
  529.  *      kQATag_Texture              (Ptr)   Pointer to current TQATexture
  530.  *      kQATag_CSGTag               (Int)   One of kQACSGTag_xxx
  531.  *      kQATag_CSGEquation          (Int)   32 bit CSG truth table
  532.  *      kQATag_FogMode              (Int)   One of kQAFogMode_xxxx
  533.  *      kQATag_FogColor_a           (Float) Fog color alpha
  534.  *      kQATag_FogColor_r           (Float) Fog color red
  535.  *      kQATag_FogColor_g           (Float) Fog color green
  536.  *      kQATag_FogColor_b           (Float) Fog color blue
  537.  *      kQATag_FogStart             (Float) Fog start
  538.  *      kQATag_FogEnd               (Float) Fog end
  539.  *      kQATag_FogDensity           (Float) Fog density
  540.  *      kQATag_FogMaxDepth          (Float) Maximun value for 1.0 / invW
  541.  *      kQATag_MipmapBias           (Float) The mipmap page bias factor
  542.  *      kQATag_ChannelMask          (Int) one of kQAChannelMask_xxx
  543.  *      kQATag_ZBufferMask          (Int) one of kQAZBufferMask_xxx
  544.  *      kQATag_ZSortedHint          (Int) 1 = depth sort transparent triangles, 0 = do not sort.
  545.  *      kQATag_Chromakey_r          (Float) chroma key red
  546.  *      kQATag_Chromakey_g          (Float) chroma key green
  547.  *      kQATag_Chromakey_b          (Float) chroma key blue
  548.  *      kQATag_ChromakeyEnable      (Int) 1 = enable chroma keying, 0 = disable chroma keying
  549.  *      kQATag_AlphaTestFunc        (Int) one of kQAAlphaTest_xxx
  550.  *      kQATag_AlphaTestRef         (Float) from 0 to 1
  551.  *      kQATag_DontSwap             (Int) 1 = dont swap buffers during QARenderEnd, 0 = do swap buffers during QARenderEnd.
  553.  *      kQATag_MultiTextureOp       (Int) One of kQAMultiTexture_xxx
  554.  *      kQATag_MultiTextureFilter   (Int) One of kQATextureFilter_xxx
  555.  *      kQATag_MultiTextureCurrent  (Int) which multitexture layer to use for all other multitexture funcs
  556.  *      kQATag_MultiTextureEnable   (Int) how many multitexture layers to use (0 = no multitexturing).
  557.  *      kQATag_MultiTextureWrapU    (Int)
  558.  *      kQATag_MultiTextureWrapV    (Int)
  559.  *      kQATag_MultiTextureMagFilter (Int)
  560.  *      kQATag_MultiTextureMinFilter (Int)
  561.  *      kQATag_MultiTextureBorder_a (Float)
  562.  *      kQATag_MultiTextureBorder_r (Float)
  563.  *      kQATag_MultiTextureBorder_g (Float)
  564.  *      kQATag_MultiTextureBorder_b (Float)
  565.  *      kQATag_MultiTextureMipmapBias (Float)
  566.  *      kQATag_MultiTextureFactor    (Float) used with kQAMultiTexture_Fixed to determine blending factor
  567.  *
  568.  * These variables are used for OpenGL(tm) support:
  569.  *      kQATagGL_DrawBuffer         (Int)   Mask of kQAGL_DrawBuffer_xxx
  570.  *      kQATagGL_TextureWrapU       (Int)   kQAGL_Clamp or kQAGL_Repeat
  571.  *      kQATagGL_TextureWrapV       (Int)   kQAGL_Clamp or kQAGL_Repeat
  572.  *      kQATagGL_TextureMagFilter   (Int)   kQAGL_Nearest or kQAGL_Linear
  573.  *      kQATagGL_TextureMinFilter   (Int)   kQAGL_Nearest, etc.
  574.  *      kQATagGL_ScissorXMin        (Int)   Minimum X value for scissor rectangle
  575.  *      kQATagGL_ScissorYMin        (Int)   Minimum Y value for scissor rectangle
  576.  *      kQATagGL_ScissorXMax        (Int)   Maximum X value for scissor rectangle
  577.  *      kQATagGL_ScissorYMax        (Int)   Maximum Y value for scissor rectangle
  578.  *      kQATagGL_BlendSrc           (Int)   Source blending operation
  579.  *      kQATagGL_BlendDst           (Int)   Destination blending operation
  580.  *      kQATagGL_LinePattern        (Int)   Line rasterization pattern
  581.  *      kQATagGL_AreaPattern0       (Int)   First of 32 area pattern registers
  582.  *      kQATagGL_AreaPattern31      (Int)   Last of 32 area pattern registers
  583.  *
  584.  *      kQATagGL_DepthBG            (Float) Background Z
  585.  *      kQATagGL_TextureBorder_a    (Float) Texture border color alpha
  586.  *      kQATagGL_TextureBorder_r    (Float) Texture border color red
  587.  *      kQATagGL_TextureBorder_g    (Float) Texture border color green
  588.  *      kQATagGL_TextureBorder_b    (Float) Texture border color blue
  589.  *
  590.  * Tags >= kQATag_EngineSpecific_Minimum may be assigned by the vendor for use as
  591.  * engine-specific variables. NOTE: These should be used only in exceptional circumstances,
  592.  * as functions performed by these variables won't be generally accessible. All other tag
  593.  * values are reserved.
  594.  *
  595.  *      kQATag_EngineSpecific_Minimum   Minimum tag value for drawing-engine specific variables
  596.  */
  598. enum TQATagInt {
  599.     kQATag_ZFunction            = 0,
  600.     kQATag_Antialias            = 8,
  601.     kQATag_Blend                = 9,
  602.     kQATag_PerspectiveZ         = 10,
  603.     kQATag_TextureFilter        = 11,
  604.     kQATag_TextureOp            = 12,
  605.     kQATag_CSGTag               = 14,
  606.     kQATag_CSGEquation          = 15,
  607.     kQATag_BufferComposite      = 16,
  608.     kQATag_FogMode              = 17,
  609.     kQATag_ChannelMask          = 27,
  610.     kQATag_ZBufferMask          = 28,
  611.     kQATag_ZSortedHint          = 29,
  612.     kQATag_ChromakeyEnable      = 30,
  613.     kQATag_AlphaTestFunc        = 31,
  614.     kQATag_DontSwap             = 32,
  615.     kQATag_MultiTextureEnable   = 33,
  616.     kQATag_MultiTextureCurrent  = 34,
  617.     kQATag_MultiTextureOp       = 35,
  618.     kQATag_MultiTextureFilter   = 36,
  619.     kQATag_MultiTextureWrapU    = 37,
  620.     kQATag_MultiTextureWrapV    = 38,
  621.     kQATag_MultiTextureMagFilter = 39,
  622.     kQATag_MultiTextureMinFilter = 40,
  623.     kQATag_BitmapFilter         = 54,                           /* filter to use while scaling bitmaps, one of kQAFilter_xxx */
  624.     kQATag_DrawContextFilter    = 55,                           /* filter to use while scaling draw contexts, one of kQAFilter_xxx */
  625.     kQATagGL_DrawBuffer         = 100,
  626.     kQATagGL_TextureWrapU       = 101,
  627.     kQATagGL_TextureWrapV       = 102,
  628.     kQATagGL_TextureMagFilter   = 103,
  629.     kQATagGL_TextureMinFilter   = 104,
  630.     kQATagGL_ScissorXMin        = 105,
  631.     kQATagGL_ScissorYMin        = 106,
  632.     kQATagGL_ScissorXMax        = 107,
  633.     kQATagGL_ScissorYMax        = 108,
  634.     kQATagGL_BlendSrc           = 109,
  635.     kQATagGL_BlendDst           = 110,
  636.     kQATagGL_LinePattern        = 111,
  637.     kQATagGL_AreaPattern0       = 117,                          /* ...kQATagGL_AreaPattern1-30 */
  638.     kQATagGL_AreaPattern31      = 148,
  639.     kQATagGL_LinePatternFactor  = 149,                          /* equivalent to GL_LINE_STIPPLE_REPEAT */
  640.     kQATag_EngineSpecific_Minimum = 1000
  641. };
  642. typedef enum TQATagInt TQATagInt;
  645. enum TQATagPtr {
  646.     kQATag_Texture              = 13,
  647.     kQATag_MultiTexture         = 26
  648. };
  649. typedef enum TQATagPtr TQATagPtr;
  652. enum TQATagFloat {
  653.     kQATag_ColorBG_a            = 1,
  654.     kQATag_ColorBG_r            = 2,
  655.     kQATag_ColorBG_g            = 3,
  656.     kQATag_ColorBG_b            = 4,
  657.     kQATag_Width                = 5,
  658.     kQATag_ZMinOffset           = 6,
  659.     kQATag_ZMinScale            = 7,
  660.     kQATag_FogColor_a           = 18,
  661.     kQATag_FogColor_r           = 19,
  662.     kQATag_FogColor_g           = 20,
  663.     kQATag_FogColor_b           = 21,
  664.     kQATag_FogStart             = 22,
  665.     kQATag_FogEnd               = 23,
  666.     kQATag_FogDensity           = 24,
  667.     kQATag_FogMaxDepth          = 25,
  668.     kQATag_MipmapBias           = 41,
  669.     kQATag_MultiTextureMipmapBias = 42,
  670.     kQATag_Chromakey_r          = 43,
  671.     kQATag_Chromakey_g          = 44,
  672.     kQATag_Chromakey_b          = 45,
  673.     kQATag_AlphaTestRef         = 46,
  674.     kQATag_MultiTextureBorder_a = 47,
  675.     kQATag_MultiTextureBorder_r = 48,
  676.     kQATag_MultiTextureBorder_g = 49,
  677.     kQATag_MultiTextureBorder_b = 50,
  678.     kQATag_MultiTextureFactor   = 51,
  679.     kQATag_BitmapScale_x        = 52,                           /* horizontal bitmap scale factor, default value is 1.0 */
  680.     kQATag_BitmapScale_y        = 53,                           /* vertical bitmap scale factor, default value is 1.0 */
  681.     kQATag_MultiTextureEnvColor_a = 56,
  682.     kQATag_MultiTextureEnvColor_r = 57,
  683.     kQATag_MultiTextureEnvColor_g = 58,
  684.     kQATag_MultiTextureEnvColor_b = 59,
  685.     kQATagGL_DepthBG            = 112,
  686.     kQATagGL_TextureBorder_a    = 113,
  687.     kQATagGL_TextureBorder_r    = 114,
  688.     kQATagGL_TextureBorder_g    = 115,
  689.     kQATagGL_TextureBorder_b    = 116,
  690.     kQATagGL_TextureEnvColor_a  = 150,
  691.     kQATagGL_TextureEnvColor_r  = 151,
  692.     kQATagGL_TextureEnvColor_g  = 152,
  693.     kQATagGL_TextureEnvColor_b  = 153
  694. };
  695. typedef enum TQATagFloat TQATagFloat;
  698. /* kQATag_ZFunction */
  699. enum {
  700.     kQAZFunction_None           = 0,                            /* Z is neither tested nor written (same as no Z buffer) */
  701.     kQAZFunction_LT             = 1,                            /* Znew < Zbuffer is visible */
  702.     kQAZFunction_EQ             = 2,                            /* Znew == Zbuffer is visible */
  703.     kQAZFunction_LE             = 3,                            /* Znew <= Zbuffer is visible */
  704.     kQAZFunction_GT             = 4,                            /* Znew > Zbuffer is visible */
  705.     kQAZFunction_NE             = 5,                            /* Znew != Zbuffer is visible */
  706.     kQAZFunction_GE             = 6,                            /* Znew >= Zbuffer is visible */
  707.     kQAZFunction_True           = 7,                            /* Znew is always visible */
  708.     kQAZFunction_False          = 8                             /* Znew is never visible */
  709. };
  711. /* kQATag_Width */
  712. #define kQAMaxWidth 128.0
  713. /* kQATag_Antialias */
  714. enum {
  715.     kQAAntiAlias_Off            = 0,
  716.     kQAAntiAlias_Fast           = 1,
  717.     kQAAntiAlias_Mid            = 2,
  718.     kQAAntiAlias_Best           = 3
  719. };
  721. /* kQATag_Blend */
  722. enum {
  723.     kQABlend_PreMultiply        = 0,
  724.     kQABlend_Interpolate        = 1,
  725.     kQABlend_OpenGL             = 2
  726. };
  728. /* kQATag_BufferComposite */
  729. enum {
  730.     kQABufferComposite_None     = 0,                            /* Default: New pixels overwrite initial buffer contents */
  731.     kQABufferComposite_PreMultiply = 1,                         /* New pixels are blended with initial buffer contents via PreMultiply */
  732.     kQABufferComposite_Interpolate = 2                          /* New pixels are blended with initial buffer contents via Interpolate */
  733. };
  735. /* kQATag_PerspectiveZ */
  736. enum {
  737.     kQAPerspectiveZ_Off         = 0,                            /* Use Z for hidden surface removal */
  738.     kQAPerspectiveZ_On          = 1                             /* Use InvW for hidden surface removal */
  739. };
  741. /* kQATag_TextureFilter */
  742. enum {
  743.                                                                 /* suggested meanings of these values */
  744.     kQATextureFilter_Fast       = 0,                            /* No filtering, pick nearest */
  745.     kQATextureFilter_Mid        = 1,                            /* Fastest method that does some filtering */
  746.     kQATextureFilter_Best       = 2                             /* Highest quality renderer can do */
  747. };
  749. /* filter tag values */
  750. enum {
  751.                                                                 /* suggested meanings of these values */
  752.     kQAFilter_Fast              = 0,                            /* No filtering, pick nearest */
  753.     kQAFilter_Mid               = 1,                            /* Fastest method that does some filtering */
  754.     kQAFilter_Best              = 2                             /* Highest quality renderer can do */
  755. };
  757. /* kQATag_TextureOp (mask of one or more) */
  758. enum {
  759.     kQATextureOp_None           = 0,                            /* Default texture mapping mode */
  760.     kQATextureOp_Modulate       = (1 << 0),                     /* Modulate texture color with kd_r/g/b */
  761.     kQATextureOp_Highlight      = (1 << 1),                     /* Add highlight value ks_r/g/b */
  762.     kQATextureOp_Decal          = (1 << 2),                     /* When texture alpha == 0, use rgb instead */
  763.     kQATextureOp_Shrink         = (1 << 3),                     /* This is a non-wrapping texture, so the ??? */
  764.     kQATextureOp_Blend          = (1 << 4)                      /* Same as GL_TEXTURE_ENV_MODE GL_BLEND */
  765. };
  767. /* kQATag_MultiTextureOp */
  768. enum {
  769.     kQAMultiTexture_Add         = 0,                            /* texels are added to form final pixel */
  770.     kQAMultiTexture_Modulate    = 1,                            /* texels are multiplied to form final pixel */
  771.     kQAMultiTexture_BlendAlpha  = 2,                            /* texels are blended according to 2nd texel's alpha */
  772.     kQAMultiTexture_Fixed       = 3                             /* texels are blended by a fixed factor via kQATag_MultiTextureFactor  */
  773. };
  775. /* kQATag_CSGTag */
  776. #define kQACSGTag_None 0xffffffffUL
  777. enum {
  778.     kQACSGTag_0                 = 0,                            /* Submitted tris have CSG ID 0 */
  779.     kQACSGTag_1                 = 1,                            /* Submitted tris have CSG ID 1 */
  780.     kQACSGTag_2                 = 2,                            /* Submitted tris have CSG ID 2 */
  781.     kQACSGTag_3                 = 3,                            /* Submitted tris have CSG ID 3 */
  782.     kQACSGTag_4                 = 4                             /* Submitted tris have CSG ID 4 */
  783. };
  785. /* kQATagGL_TextureWrapU/V */
  786. enum {
  787.     kQAGL_Repeat                = 0,
  788.     kQAGL_Clamp                 = 1
  789. };
  791. /* kQATagGL_BlendSrc */
  792. enum {
  793.     kQAGL_SourceBlend_XXX       = 0
  794. };
  796. /* kQATagGL_BlendDst */
  797. enum {
  798.     kQAGL_DestBlend_XXX         = 0
  799. };
  801. /* kQATagGL_DrawBuffer (mask of one or more) */
  802. enum {
  803.     kQAGL_DrawBuffer_None       = 0,
  804.     kQAGL_DrawBuffer_FrontLeft  = (1 << 0),
  805.     kQAGL_DrawBuffer_FrontRight = (1 << 1),
  806.     kQAGL_DrawBuffer_BackLeft   = (1 << 2),
  807.     kQAGL_DrawBuffer_BackRight  = (1 << 3),
  808.     kQAGL_DrawBuffer_Front      = (kQAGL_DrawBuffer_FrontLeft | kQAGL_DrawBuffer_FrontRight),
  809.     kQAGL_DrawBuffer_Back       = (kQAGL_DrawBuffer_BackLeft | kQAGL_DrawBuffer_BackRight)
  810. };
  812. /* kQATag_FogMode */
  813. enum {
  814.     kQAFogMode_None             = 0,                            /* no fog                     */
  815.     kQAFogMode_Alpha            = 1,                            /* fog value is alpha               */
  816.     kQAFogMode_Linear           = 2,                            /* fog = (end - z) / (end - start)         */
  817.     kQAFogMode_Exponential      = 3,                            /* fog = exp(-density * z)              */
  818.     kQAFogMode_ExponentialSquared = 4                           /* fog = exp(-density * z * density * z)  */
  819. };
  822. /* kQATag_ChannelMask */
  823. enum {
  824.     kQAChannelMask_r            = (1 << 0),
  825.     kQAChannelMask_g            = (1 << 1),
  826.     kQAChannelMask_b            = (1 << 2),
  827.     kQAChannelMask_a            = (1 << 3)
  828. };
  831. /* kQATag_ZBufferMask */
  832. enum {
  833.     kQAZBufferMask_Disable      = 0,
  834.     kQAZBufferMask_Enable       = 1
  835. };
  837. /* kQATag_AlphaTestFunc */
  838. enum {
  839.     kQAAlphaTest_None           = 0,
  840.     kQAAlphaTest_LT             = 1,
  841.     kQAAlphaTest_EQ             = 2,
  842.     kQAAlphaTest_LE             = 3,
  843.     kQAAlphaTest_GT             = 4,
  844.     kQAAlphaTest_NE             = 5,
  845.     kQAAlphaTest_GE             = 6,
  846.     kQAAlphaTest_True           = 7
  847. };
  850. /* flags for QAAccess__xxx */
  851. enum {
  852.     kQANoCopyNeeded             = (1 << 0)
  853. };
  856. /************************************************************************************************
  857.  *
  858.  * Constants used as function parameters.
  859.  *
  860.  ***********************************************************************************************/
  861. /*
  862.  * TQAVertexMode is a parameter to QADrawVGouraud() and QADrawVTexture() that specifies how
  863.  * to interpret and draw the vertex array.
  864.  */
  866. enum TQAVertexMode {
  867.     kQAVertexMode_Point         = 0,                            /* Draw nVertices points */
  868.     kQAVertexMode_Line          = 1,                            /* Draw nVertices/2 line segments */
  869.     kQAVertexMode_Polyline      = 2,                            /* Draw nVertices-1 connected line segments */
  870.     kQAVertexMode_Tri           = 3,                            /* Draw nVertices/3 triangles */
  871.     kQAVertexMode_Strip         = 4,                            /* Draw nVertices-2 triangles as a strip */
  872.     kQAVertexMode_Fan           = 5,                            /* Draw nVertices-2 triangles as a fan from v0 */
  873.     kQAVertexMode_NumModes      = 6
  874. };
  875. typedef enum TQAVertexMode TQAVertexMode;
  877. /*
  878.  * TQAGestaltSelector is a parameter to QAEngineGestalt(). It selects which gestalt
  879.  * parameter will be copied into 'response'.
  880.  */
  882. enum TQAGestaltSelector {
  883.     kQAGestalt_OptionalFeatures = 0,                            /* Mask of one or more kQAOptional_xxx */
  884.     kQAGestalt_FastFeatures     = 1,                            /* Mask of one or more kQAFast_xxx */
  885.     kQAGestalt_VendorID         = 2,                            /* Vendor ID */
  886.     kQAGestalt_EngineID         = 3,                            /* Engine ID */
  887.     kQAGestalt_Revision         = 4,                            /* Revision number of this engine */
  888.     kQAGestalt_ASCIINameLength  = 5,                            /* strlen (asciiName) */
  889.     kQAGestalt_ASCIIName        = 6,                            /* Causes strcpy (response, asciiName) */
  890.     kQAGestalt_TextureMemory    = 7,                            /* amount of texture RAM currently available */
  891.     kQAGestalt_FastTextureMemory = 8,                           /* amount of texture RAM currently available */
  892.     kQAGestalt_DrawContextPixelTypesAllowed = 9,                /* returns all the draw context pixel types supported by the RAVE engine */
  893.     kQAGestalt_DrawContextPixelTypesPreferred = 10,             /* returns all the draw context pixel types that are preferred by the RAVE engine. */
  894.     kQAGestalt_TexturePixelTypesAllowed = 11,                   /* returns all the texture pixel types that are supported by the RAVE engine */
  895.     kQAGestalt_TexturePixelTypesPreferred = 12,                 /* returns all the texture pixel types that are preferred by the RAVE engine.*/
  896.     kQAGestalt_BitmapPixelTypesAllowed = 13,                    /* returns all the bitmap pixel types that are supported by the RAVE engine. */
  897.     kQAGestalt_BitmapPixelTypesPreferred = 14,                  /* returns all the bitmap pixel types that are preferred by the RAVE engine. */
  898.     kQAGestalt_OptionalFeatures2 = 15,                          /* Mask of one or more kQAOptional2_xxx */
  899.     kQAGestalt_MultiTextureMax  = 16,                           /* max number of multi textures supported by this engine */
  900.     kQAGestalt_NumSelectors     = 17,
  901.     kQAGestalt_EngineSpecific_Minimum = 1000                    /* all gestalts here and above are for engine specific purposes */
  902. };
  903. typedef enum TQAGestaltSelector TQAGestaltSelector;
  905. /*
  906.  * TQAMethodSelector is a parameter to QASetNoticeMethod to select the notice method
  907.  */
  908. #if RAVE_OBSOLETE
  910. enum TQAMethodSelector {
  911.     kQAMethod_RenderCompletion  = 0,                            /* Called when rendering has completed and buffers swapped */
  912.     kQAMethod_DisplayModeChanged = 1,                           /* Called when a display mode has changed */
  913.     kQAMethod_ReloadTextures    = 2,                            /* Called when texture memory has been invalidated */
  914.     kQAMethod_BufferInitialize  = 3,                            /* Called when a buffer needs to be initialized */
  915.     kQAMethod_BufferComposite   = 4,                            /* Called when rendering is finished and its safe to composite */
  916.     kQAMethod_NumSelectors      = 5
  917. };
  918. typedef enum TQAMethodSelector TQAMethodSelector;
  920. #else
  922. enum TQAMethodSelector {
  923.     kQAMethod_RenderCompletion  = 0,                            /* Called when rendering has completed and buffers swapped */
  924.     kQAMethod_DisplayModeChanged = 1,                           /* Called when a display mode has changed */
  925.     kQAMethod_ReloadTextures    = 2,                            /* Called when texture memory has been invalidated */
  926.     kQAMethod_ImageBufferInitialize = 3,                        /* Called when a buffer needs to be initialized */
  927.     kQAMethod_ImageBuffer2DComposite = 4,                       /* Called when rendering is finished and its safe to composite */
  928.     kQAMethod_NumSelectors      = 5
  929. };
  930. typedef enum TQAMethodSelector TQAMethodSelector;
  932. #endif  /* RAVE_OBSOLETE */
  934. /*
  935.  * kQATriFlags_xxx are ORed together to generate the 'flags' parameter
  936.  * to QADrawTriGouraud() and QADrawTriTexture().
  937.  */
  938. enum {
  939.     kQATriFlags_None            = 0,                            /* No flags (triangle is front-facing or don't care) */
  940.     kQATriFlags_Backfacing      = (1 << 0)                      /* Triangle is back-facing */
  941. };
  943. /*
  944.  * kQATexture_xxx are ORed together to generate the 'flags' parameter to QATextureNew().
  945.  */
  946. enum {
  947.     kQATexture_None             = 0,                            /* No flags */
  948.     kQATexture_Lock             = (1 << 0),                     /* Don't swap this texture out */
  949.     kQATexture_Mipmap           = (1 << 1),                     /* This texture is mipmapped */
  950.     kQATexture_NoCompression    = (1 << 2),                     /* Do not compress this texture */
  951.     kQATexture_HighCompression  = (1 << 3),                     /* Compress texture, even if it takes a while */
  952.     kQATexture_NonRelocatable   = (1 << 4),                     /* Image buffer in VRAM should be non-relocatable */
  953.     kQATexture_NoCopy           = (1 << 5),                     /* Don't copy image to VRAM when creating it */
  954.     kQATexture_FlipOrigin       = (1 << 6),                     /* The image(s) is(are) in a bottom-up format. (The image(s) is(are) flipped vertically.) */
  955.     kQATexture_PriorityBits     = (1 << 31) | (1 << 30) | (1 << 29) | (1 << 28) /* Texture priority: 4 upper bits for 16 levels of priority */
  956. };
  958. /*
  959.  * kQABitmap_xxx are ORed together to generate the 'flags' parameter to QABitmapNew().
  960.  */
  961. enum {
  962.     kQABitmap_None              = 0,                            /* No flags */
  963.     kQABitmap_Lock              = (1 << 1),                     /* Don't swap this bitmap out */
  964.     kQABitmap_NoCompression     = (1 << 2),                     /* Do not compress this bitmap */
  965.     kQABitmap_HighCompression   = (1 << 3),                     /* Compress bitmap, even if it takes a while */
  966.     kQABitmap_NonRelocatable    = (1 << 4),                     /* Image buffer in VRAM should be non-relocatable */
  967.     kQABitmap_NoCopy            = (1 << 5),                     /* Don't copy image to VRAM when creating it */
  968.     kQABitmap_FlipOrigin        = (1 << 6),                     /* The image is in a bottom-up format. (The image is flipped vertically.) */
  969.     kQABitmap_PriorityBits      = (1 << 31) | (1 << 30) | (1 << 29) | (1 << 28) /* Bitmap priority: 4 upper bits for 16 levels of priority */
  970. };
  972. /*
  973.  * kQAContext_xxx are ORed together to generate the 'flags' parameter for QADrawContextNew().
  974.  */
  975. enum {
  976.     kQAContext_None             = 0,                            /* No flags */
  977.     kQAContext_NoZBuffer        = (1 << 0),                     /* No hidden surface removal */
  978.     kQAContext_DeepZ            = (1 << 1),                     /* Hidden surface precision >= 24 bits */
  979.     kQAContext_DoubleBuffer     = (1 << 2),                     /* Double buffered window */
  980.     kQAContext_Cache            = (1 << 3),                     /* This is a cache context */
  981.     kQAContext_NoDither         = (1 << 4),                     /* No dithering, straight color banding */
  982.     kQAContext_Scale            = (1 << 5),                     /* The draw context is to be scaled.  The front buffer is a different size than the back buffer. */
  983.     kQAContext_NonRelocatable   = (1 << 6),                     /* The back buffer and the z buffer must not move in memory */
  984.     kQAContext_EngineSpecific1  = (1 << 28),                    /* engine specific flag # 1 */
  985.     kQAContext_EngineSpecific2  = (1 << 29),                    /* engine specific flag # 2 */
  986.     kQAContext_EngineSpecific3  = (1 << 30),                    /* engine specific flag # 3 */
  987.     kQAContext_EngineSpecific4  = (1 << 31)                     /* engine specific flag # 4 */
  988. };
  990. /*
  991.  * kQAOptional_xxx are ORed together to generate the kQAGestalt_OptionalFeatures response
  992.  * from QAEngineGestalt().
  993.  */
  994. enum {
  995.     kQAOptional_None            = 0,                            /* No optional features */
  996.     kQAOptional_DeepZ           = (1 << 0),                     /* Hidden surface precision >= 24 bits */
  997.     kQAOptional_Texture         = (1 << 1),                     /* Texture mapping */
  998.     kQAOptional_TextureHQ       = (1 << 2),                     /* High quality texture (tri-linear mip or better) */
  999.     kQAOptional_TextureColor    = (1 << 3),                     /* Full color modulation and highlight of textures */
  1000.     kQAOptional_Blend           = (1 << 4),                     /* Transparency blending of RGB */
  1001.     kQAOptional_BlendAlpha      = (1 << 5),                     /* Transparency blending includes alpha channel */
  1002.     kQAOptional_Antialias       = (1 << 6),                     /* Antialiased rendering */
  1003.     kQAOptional_ZSorted         = (1 << 7),                     /* Z sorted rendering (for transparency, etc.) */
  1004.     kQAOptional_PerspectiveZ    = (1 << 8),                     /* Hidden surface removal using InvW instead of Z */
  1005.     kQAOptional_OpenGL          = (1 << 9),                     /* Extended rasterization features for OpenGL(tm) */
  1006.     kQAOptional_NoClear         = (1 << 10),                    /* This drawing engine doesn't clear before drawing */
  1007.     kQAOptional_CSG             = (1 << 11),                    /* kQATag_CSGxxx are implemented */
  1008.     kQAOptional_BoundToDevice   = (1 << 12),                    /* This engine is tightly bound to GDevice */
  1009.     kQAOptional_CL4             = (1 << 13),                    /* This engine suports kQAPixel_CL4 */
  1010.     kQAOptional_CL8             = (1 << 14),                    /* This engine suports kQAPixel_CL8 */
  1011.     kQAOptional_BufferComposite = (1 << 15),                    /* This engine can composite with initial buffer contents */
  1012.     kQAOptional_NoDither        = (1 << 16),                    /* This engine can draw with no dithering */
  1013.     kQAOptional_FogAlpha        = (1 << 17),                    /* This engine suports alpha based fog */
  1014.     kQAOptional_FogDepth        = (1 << 18),                    /* This engine suports depth based fog */
  1015.     kQAOptional_MultiTextures   = (1 << 19),                    /* This bit set if engine supports texture compositing */
  1016.     kQAOptional_MipmapBias      = (1 << 20),                    /* This bit is set if the engine supports mipmap selection bias */
  1017.     kQAOptional_ChannelMask     = (1 << 21),
  1018.     kQAOptional_ZBufferMask     = (1 << 22),
  1019.     kQAOptional_AlphaTest       = (1 << 23),                    /* this engine supports alpha testing */
  1020.     kQAOptional_AccessTexture   = (1 << 24),                    /* if engine supports access to texture */
  1021.     kQAOptional_AccessBitmap    = (1 << 25),                    /* if engine supports access to bitmaps */
  1022.     kQAOptional_AccessDrawBuffer = (1 << 26),                   /* if engine supports access to draw buffer */
  1023.     kQAOptional_AccessZBuffer   = (1 << 27),                    /* if engine supports access to zbuffer */
  1024.     kQAOptional_ClearDrawBuffer = (1 << 28),                    /* if engine supports QAClearDrawBuffer() */
  1025.     kQAOptional_ClearZBuffer    = (1 << 29),                    /* if engine supports QAClearZBuffer() */
  1026.     kQAOptional_OffscreenDrawContexts = (1 << 30)               /* if engine supports TQADeviceOffscreen */
  1027. };
  1029. /*
  1030.  * kQAOptional2_xxx are ORed together to generate the kQAGestalt_OptionalFeatures2 response
  1031.  * from QAEngineGestalt().
  1032.  */
  1033. enum {
  1034.     kQAOptional2_None           = 0,
  1035.     kQAOptional2_TextureDrawContexts = (1 << 1),                /* if engine supports QATextureNewFromDrawContext() */
  1036.     kQAOptional2_BitmapDrawContexts = (1 << 2),                 /* if engine supports QABitmapNewFromDrawContext() */
  1037.     kQAOptional2_Busy           = (1 << 3),                     /* if engine supports QABusy() */
  1038.     kQAOptional2_SwapBuffers    = (1 << 4),                     /* if engine supports QASwapBuffers() */
  1039.     kQAOptional2_Chromakey      = (1 << 5),                     /* if engine supports chromakeying via kQATag_Chromakey_xxx */
  1040.     kQAOptional2_NonRelocatable = (1 << 6),                     /* if engine supports nonrelocatable texture & bitmap image buffers in VRAM */
  1041.     kQAOptional2_NoCopy         = (1 << 7),                     /* if engine supports ability to not copy texture & bitmap image to VRAM */
  1042.     kQAOptional2_PriorityBits   = (1 << 8),                     /* if engine supports texture & bitmap priority levels */
  1043.     kQAOptional2_FlipOrigin     = (1 << 9),                     /* if engine supports textures & bitmaps that are vertically flipped */
  1044.     kQAOptional2_BitmapScale    = (1 << 10),                    /* if engine supports scaled bitmap drawing */
  1045.     kQAOptional2_DrawContextScale = (1 << 11),                  /* if engine supports scaled draw contexts */
  1046.     kQAOptional2_DrawContextNonRelocatable = (1 << 12)          /* if engine supports draw contexts with non relocatable buffers */
  1047. };
  1050. /*
  1051.  * kQAFast_xxx are ORed together to generate the kQAGestalt_FastFeatures response
  1052.  * from QAEngineGestalt().
  1053.  */
  1054. enum {
  1055.     kQAFast_None                = 0,                            /* No accelerated features */
  1056.     kQAFast_Line                = (1 << 0),                     /* Line drawing */
  1057.     kQAFast_Gouraud             = (1 << 1),                     /* Gouraud shaded triangles */
  1058.     kQAFast_Texture             = (1 << 2),                     /* Texture mapped triangles */
  1059.     kQAFast_TextureHQ           = (1 << 3),                     /* High quality texture (tri-linear mip or better) */
  1060.     kQAFast_Blend               = (1 << 4),                     /* Transparency blending */
  1061.     kQAFast_Antialiasing        = (1 << 5),                     /* Antialiased rendering */
  1062.     kQAFast_ZSorted             = (1 << 6),                     /* Z sorted rendering of non-opaque objects */
  1063.     kQAFast_CL4                 = (1 << 7),                     /* This engine accelerates kQAPixel_CL4 */
  1064.     kQAFast_CL8                 = (1 << 8),                     /* This engine accelerates kQAPixel_CL8 */
  1065.     kQAFast_FogAlpha            = (1 << 9),                     /* This engine accelerates alpha based fog */
  1066.     kQAFast_FogDepth            = (1 << 10),                    /* This engine accelerates depth based fog */
  1067.     kQAFast_MultiTextures       = (1 << 11),                    /* This engine accelerates texture compositing */
  1068.     kQAFast_BitmapScale         = (1 << 12),                    /* This engine accelerates scaled bitmap drawing */
  1069.     kQAFast_DrawContextScale    = (1 << 13)                     /* This engine accelerates scaled draw contexts */
  1070. };
  1074. /************************************************************************************************
  1075.  *
  1076.  * Macro definition for easily setting the texture priority bits in the flags field of
  1077.  * QATextureNew(), and QABitMapNew().
  1078.  *
  1079.  * The priority value must be a number between 0 and 15.  0 is top priority, and 15 is lowest
  1080.  * priority. Note that this is different than OpenGL which uses floats from 0.0 to 1.0 where
  1081.  * 1.0 is top priority. In RAVE, this system is more like texture ranking, thus 0 is top rank,
  1082.  * and 15 is the last ranking.
  1083.  *
  1084.  * Texture prioritization is mainly used for systems which support AGP memory.  This allows the
  1085.  * hardware driver to determine which textures to put into faster VRAM and which to put into
  1086.  * slower AGP RAM. If you dont care about texture priority, then you dont need to worry about
  1087.  * this macro or the priority bits since the default will always be top priority when all 4 bits
  1088.  * of this flag field are 0's.
  1089.  *
  1090.  * To upload a texture with high priority, do the following:
  1091.  *
  1092.  *         unsigned long flags = kQATexture_Mipmap;            // Initialize flags
  1093.  *
  1094.  *       flags |= QACalculatePriorityBits(0);                // Setting top priority (this actually does
  1095.  *                                                          // nothing since the bits are still 0000)
  1096.  *        QATextureNew(myEngine, flags, pixelType, image, &raveTexture);
  1097.  *
  1098.  *
  1099.  * To do a texture with a middle priority of 8, do the following:
  1100.  *
  1101.  *        unsigned long flags = kQATexture_HighCompression;   // Initialize flags
  1102.  *
  1103.  *       flags |= QACalculatePriorityBits(8);                // Setting middle priority
  1104.  *
  1105.  *        QATextureNew(myEngine, flags, pixelType, image, &raveTexture);
  1106.  *
  1107.  ***********************************************************************************************/
  1109. #define QACalculatePriorityBits(_priority)  (((unsigned long) (_priority)) << 28)
  1113. /************************************************************************************************
  1114.  *
  1115.  * Macro definitions for the drawing engine methods included in TQADrawContext. These
  1116.  * macros are the recommended means of accessing the engine's draw methods, e.g:
  1117.  *
  1118.  *      TQADrawContext  *drawContext;
  1119.  *        TQAVTexture     vertices[3];
  1120.  *
  1121.  *      drawContext = QADrawContextNew (rect, gdevice, engine, kQAContext_ZBuffer);
  1122.  *      ...
  1123.  *      QASetInt (drawContext, kQATag_ZFunction, kQAZFunction_LT);
  1124.  *       QADrawTriGouraud (drawContext, &vertices[0], &vertices[1], &vertices[2], kQATriFlags_None);
  1125.  *
  1126.  * Note that QARenderStart(), QARenderEnd(), QAFlush() and QASync() have real function
  1127.  * definitions instead of macros. This is because these functions can afford the extra
  1128.  * per-call overhead of a function layer (which makes application code a little smaller),
  1129.  * and to allow a cleaner implementation of handling NULL parameters to QARenderStart().
  1130.  *
  1131.  ***********************************************************************************************/
  1134. #define QASetFloat(drawContext,tag,newValue) 
  1135.         (drawContext)->setFloat (drawContext,tag,newValue)
  1137. #define QASetInt(drawContext,tag,newValue) 
  1138.        (drawContext)->setInt (drawContext,tag,newValue)
  1140. #define QASetPtr(drawContext,tag,newValue) 
  1141.      (drawContext)->setPtr (drawContext,tag,newValue)
  1143. #define QAGetFloat(drawContext,tag) 
  1144.         (drawContext)->getFloat (drawContext,tag)
  1146. #define QAGetInt(drawContext,tag) 
  1147.      (drawContext)->getInt (drawContext,tag)
  1149. #define QAGetPtr(drawContext,tag) 
  1150.        (drawContext)->getPtr (drawContext,tag)
  1152. #define QADrawPoint(drawContext,v) 
  1153.       (drawContext)->drawPoint (drawContext,v)
  1155. #define QADrawLine(drawContext,v0,v1) 
  1156.       (drawContext)->drawLine (drawContext,v0,v1)
  1158. #define QADrawTriGouraud(drawContext,v0,v1,v2,flags) 
  1159.         (drawContext)->drawTriGouraud (drawContext,v0,v1,v2,flags)
  1161. #define QADrawTriTexture(drawContext,v0,v1,v2,flags) 
  1162.      (drawContext)->drawTriTexture (drawContext,v0,v1,v2,flags)
  1164. #define QASubmitVerticesGouraud(drawContext,nVertices,vertices) 
  1165.       (drawContext)->submitVerticesGouraud(drawContext,nVertices,vertices)
  1166.        
  1167. #define QASubmitVerticesTexture(drawContext,nVertices,vertices) 
  1168.      (drawContext)->submitVerticesTexture(drawContext,nVertices,vertices)
  1169.        
  1170. #define QASubmitMultiTextureParams(drawContext,nParams,params) 
  1171.       (drawContext)->submitMultiTextureParams(drawContext,nParams,params)
  1174.         
  1175. #define QADrawTriMeshGouraud(drawContext,nTriangle,triangles) 
  1176.        (drawContext)->drawTriMeshGouraud (drawContext,nTriangle,triangles)
  1178. #define QADrawTriMeshTexture(drawContext,nTriangle,triangles) 
  1179.        (drawContext)->drawTriMeshTexture (drawContext,nTriangle,triangles)
  1181. #define QADrawVGouraud(drawContext,nVertices,vertexMode,vertices,flags) 
  1182.      (drawContext)->drawVGouraud (drawContext,nVertices,vertexMode,vertices,flags)
  1184. #define QADrawVTexture(drawContext,nVertices,vertexMode,vertices,flags) 
  1185.        (drawContext)->drawVTexture (drawContext,nVertices,vertexMode,vertices,flags)
  1187. #define QADrawBitmap(drawContext,v,bitmap) 
  1188.         (drawContext)->drawBitmap (drawContext,v,bitmap)
  1190. #define QARenderStart(drawContext,dirtyRect,initialContext) 
  1191.         (drawContext)->renderStart (drawContext,dirtyRect,initialContext)
  1193. #define QARenderEnd(drawContext,modifiedRect) 
  1194.      (drawContext)->renderEnd (drawContext,modifiedRect)
  1196. #define QARenderAbort(drawContext) 
  1197.       (drawContext)->renderAbort (drawContext)
  1199. #define QAFlush(drawContext) 
  1200.        (drawContext)->flush (drawContext)
  1202. #define QASync(drawContext) 
  1203.       (drawContext)->sync (drawContext)
  1205. #define QASetNoticeMethod(drawContext, method, completionCallBack, refCon) 
  1206.         (drawContext)->setNoticeMethod (drawContext, method, completionCallBack, refCon)
  1208. #define QAGetNoticeMethod(drawContext, method, completionCallBack, refCon) 
  1209.      (drawContext)->getNoticeMethod (drawContext, method, completionCallBack, refCon)
  1210.        
  1211. #define QAAccessDrawBuffer(drawContext, pixelBuffer) 
  1212.         (drawContext)->accessDrawBuffer(drawContext, pixelBuffer)
  1214. #define QAAccessDrawBufferEnd(drawContext, dirtyRect) 
  1215.      (drawContext)->accessDrawBufferEnd(drawContext, dirtyRect)
  1217. #define QAAccessZBuffer(drawContext, zBuffer) 
  1218.         (drawContext)->accessZBuffer(drawContext, zBuffer)
  1220. #define QAAccessZBufferEnd(drawContext, dirtyRect) 
  1221.        (drawContext)->accessZBufferEnd(drawContext, dirtyRect)
  1224.         
  1225. #define QAClearDrawBuffer(drawContext, rect, initialContext) 
  1226.         (drawContext)->clearDrawBuffer(drawContext, rect, initialContext)
  1228. #define QAClearZBuffer(drawContext, rect, initialContext) 
  1229.      (drawContext)->clearZBuffer(drawContext, rect, initialContext)
  1231. #define QATextureNewFromDrawContext(drawContext, flags, newTexture) 
  1232.       (drawContext)->textureFromContext(drawContext, flags, newTexture)
  1234. #define QABitmapNewFromDrawContext(drawContext, flags, newBitmap) 
  1235.      (drawContext)->bitmapFromContext(drawContext, flags, newBitmap)
  1237. #define QABusy(drawContext) 
  1238.      (drawContext)->busy(drawContext)
  1240. #define QASwapBuffers(drawContext, dirtyRect) 
  1241.       (drawContext)->swapBuffers(drawContext, dirtyRect)
  1247. /********************************************************************
  1248.  * TQAVersion sets the TQADrawContext 'version' field. It is set by
  1249.  * the manager to indicate the version of the TQADrawContext structure.
  1250.  *******************************************************************/
  1252. enum TQAVersion {
  1253.     kQAVersion_Prerelease       = 0,
  1254.     kQAVersion_1_0              = 1,
  1255.     kQAVersion_1_0_5            = 2,                            /* Added tri mesh functions, color tables */
  1256.     kQAVersion_1_5              = 3,                            /* Added call backs, texture compression, and new error return code */
  1257.     kQAVersion_1_6              = 4                             /* Added QAAccess_xxx, fog, _Options2, Clear_xxx, etc. */
  1258. };
  1259. typedef enum TQAVersion TQAVersion;
  1263. /***********************************************************************
  1264.  * TQADrawContext structure holds method pointers.
  1265.  * This is a forward refrence. The structure is defined later.
  1266.  **********************************************************************/
  1267. typedef struct TQADrawContext           TQADrawContext;
  1268. /************************************************************************************************
  1269.  *
  1270.  * Typedefs of draw method functions provided by the drawing engine. One function pointer
  1271.  * for each of these function types in stored in the TQADrawContext public data structure.
  1272.  *
  1273.  * These functions should be accessed through the QA<function>(context,...) macros,
  1274.  * defined above.
  1275.  *
  1276.  ***********************************************************************************************/
  1277. typedef CALLBACK_API_C( void , TQAStandardNoticeMethod )(const TQADrawContext *drawContext, void *refCon);
  1278. typedef CALLBACK_API_C( void , TQABufferNoticeMethod )(const TQADrawContext *drawContext, const TQADevice *buffer, const TQARect *dirtyRect, void *refCon);
  1280. union TQANoticeMethod {
  1281.     TQAStandardNoticeMethod         standardNoticeMethod;       /* Used for non-buffer related methods */
  1282.     TQABufferNoticeMethod           bufferNoticeMethod;         /* Used for buffer handling methods */
  1283. };
  1284. typedef union TQANoticeMethod           TQANoticeMethod;
  1285. typedef CALLBACK_API_C( void , TQASetFloat )(TQADrawContext *drawContext, TQATagFloat tag, float newValue);
  1286. typedef CALLBACK_API_C( void , TQASetInt )(TQADrawContext *drawContext, TQATagInt tag, unsigned long newValue);
  1287. typedef CALLBACK_API_C( void , TQASetPtr )(TQADrawContext *drawContext, TQATagPtr tag, const void *newValue);
  1288. typedef CALLBACK_API_C( float , TQAGetFloat )(const TQADrawContext *drawContext, TQATagFloat tag);
  1289. typedef CALLBACK_API_C( unsigned long , TQAGetInt )(const TQADrawContext *drawContext, TQATagInt tag);
  1290. typedef CALLBACK_API_C( void *, TQAGetPtr )(const TQADrawContext *drawContext, TQATagPtr tag);
  1291. typedef CALLBACK_API_C( void , TQADrawPoint )(const TQADrawContext *drawContext, const TQAVGouraud *v);
  1292. typedef CALLBACK_API_C( void , TQADrawLine )(const TQADrawContext *drawContext, const TQAVGouraud *v0, const TQAVGouraud *v1);
  1293. typedef CALLBACK_API_C( void , TQADrawTriGouraud )(const TQADrawContext *drawContext, const TQAVGouraud *v0, const TQAVGouraud *v1, const TQAVGouraud *v2, unsigned long flags);
  1294. typedef CALLBACK_API_C( void , TQADrawTriTexture )(const TQADrawContext *drawContext, const TQAVTexture *v0, const TQAVTexture *v1, const TQAVTexture *v2, unsigned long flags);
  1295. typedef CALLBACK_API_C( void , TQASubmitVerticesGouraud )(const TQADrawContext *drawContext, unsigned long nVertices, const TQAVGouraud *vertices);
  1296. typedef CALLBACK_API_C( void , TQASubmitVerticesTexture )(const TQADrawContext *drawContext, unsigned long nVertices, const TQAVTexture *vertices);
  1297. typedef CALLBACK_API_C( void , TQADrawTriMeshGouraud )(const TQADrawContext *drawContext, unsigned long nTriangles, const TQAIndexedTriangle *triangles);
  1298. typedef CALLBACK_API_C( void , TQADrawTriMeshTexture )(const TQADrawContext *drawContext, unsigned long nTriangles, const TQAIndexedTriangle *triangles);
  1299. typedef CALLBACK_API_C( void , TQADrawVGouraud )(const TQADrawContext *drawContext, unsigned long nVertices, TQAVertexMode vertexMode, const TQAVGouraud vertices[], const unsigned long flags[]);
  1300. typedef CALLBACK_API_C( void , TQADrawVTexture )(const TQADrawContext *drawContext, unsigned long nVertices, TQAVertexMode vertexMode, const TQAVTexture vertices[], const unsigned long flags[]);
  1301. typedef CALLBACK_API_C( void , TQADrawBitmap )(const TQADrawContext *drawContext, const TQAVGouraud *v, TQABitmap *bitmap);
  1302. typedef CALLBACK_API_C( void , TQARenderStart )(const TQADrawContext *drawContext, const TQARect *dirtyRect, const TQADrawContext *initialContext);
  1303. typedef CALLBACK_API_C( TQAError , TQARenderEnd )(const TQADrawContext *drawContext, const TQARect *modifiedRect);
  1304. typedef CALLBACK_API_C( TQAError , TQARenderAbort )(const TQADrawContext *drawContext);
  1305. typedef CALLBACK_API_C( TQAError , TQAFlush )(const TQADrawContext *drawContext);
  1306. typedef CALLBACK_API_C( TQAError , TQASync )(const TQADrawContext *drawContext);
  1307. typedef CALLBACK_API_C( TQAError , TQASetNoticeMethod )(const TQADrawContext *drawContext, TQAMethodSelector method, TQANoticeMethod completionCallBack, void *refCon);
  1308. typedef CALLBACK_API_C( TQAError , TQAGetNoticeMethod )(const TQADrawContext *drawContext, TQAMethodSelector method, TQANoticeMethod *completionCallBack, void **refCon);
  1309. typedef CALLBACK_API_C( void , TQASubmitMultiTextureParams )(const TQADrawContext *drawContext, unsigned long nParams, const TQAVMultiTexture *params);
  1310. typedef CALLBACK_API_C( TQAError , TQAAccessDrawBuffer )(const TQADrawContext *drawContext, TQAPixelBuffer *buffer);
  1311. typedef CALLBACK_API_C( TQAError , TQAAccessDrawBufferEnd )(const TQADrawContext *drawContext, const TQARect *dirtyRect);
  1312. typedef CALLBACK_API_C( TQAError , TQAAccessZBuffer )(const TQADrawContext *drawContext, TQAZBuffer *buffer);
  1313. typedef CALLBACK_API_C( TQAError , TQAAccessZBufferEnd )(const TQADrawContext *drawContext, const TQARect *dirtyRect);
  1314. typedef CALLBACK_API_C( TQAError , TQAClearDrawBuffer )(const TQADrawContext *drawContext, const TQARect *rect, const TQADrawContext *initialContext);
  1315. typedef CALLBACK_API_C( TQAError , TQAClearZBuffer )(const TQADrawContext *drawContext, const TQARect *rect, const TQADrawContext *initialContext);
  1316. typedef CALLBACK_API_C( TQAError , TQATextureNewFromDrawContext )(const TQADrawContext *drawContext, unsigned long flags, TQATexture **newTexture);
  1317. typedef CALLBACK_API_C( TQAError , TQABitmapNewFromDrawContext )(const TQADrawContext *drawContext, unsigned long flags, TQABitmap **newBitmap);
  1318. typedef CALLBACK_API_C( TQABoolean , TQABusy )(const TQADrawContext *drawContext);
  1319. typedef CALLBACK_API_C( TQAError , TQASwapBuffers )(const TQADrawContext *drawContext, const TQARect *dirtyRect);
  1320. /************************************************************************************************
  1321.  *
  1322.  * Public TQADrawContext structure. This contains function pointers for the chosen
  1323.  * drawing engine.
  1324.  *
  1325.  ***********************************************************************************************/
  1327. struct TQADrawContext {
  1328.     TQADrawPrivate *                drawPrivate;                /* Engine's private data for this context */
  1329.     TQAVersion                      version;                    /* Version number */
  1330.     TQASetFloat                     setFloat;                   /* Method: Set a float state variable */
  1331.     TQASetInt                       setInt;                     /* Method: Set an unsigned long state variable */
  1332.     TQASetPtr                       setPtr;                     /* Method: Set an unsigned long state variable */
  1333.     TQAGetFloat                     getFloat;                   /* Method: Get a float state variable */
  1334.     TQAGetInt                       getInt;                     /* Method: Get an unsigned long state variable */
  1335.     TQAGetPtr                       getPtr;                     /* Method: Get an pointer state variable */
  1336.     TQADrawPoint                    drawPoint;                  /* Method: Draw a point */
  1337.     TQADrawLine                     drawLine;                   /* Method: Draw a line */
  1338.     TQADrawTriGouraud               drawTriGouraud;             /* Method: Draw a Gouraud shaded triangle */
  1339.     TQADrawTriTexture               drawTriTexture;             /* Method: Draw a texture mapped triangle */
  1340.     TQADrawVGouraud                 drawVGouraud;               /* Method: Draw Gouraud vertices */
  1341.     TQADrawVTexture                 drawVTexture;               /* Method: Draw texture vertices */
  1342.     TQADrawBitmap                   drawBitmap;                 /* Method: Draw a bitmap */
  1343.     TQARenderStart                  renderStart;                /* Method: Initialize for rendering */
  1344.     TQARenderEnd                    renderEnd;                  /* Method: Complete rendering and display */
  1345.     TQARenderAbort                  renderAbort;                /* Method: Abort any outstanding rendering (blocking) */
  1346.     TQAFlush                        flush;                      /* Method: Start render of any queued commands (non-blocking) */
  1347.     TQASync                         sync;                       /* Method: Wait for completion of all rendering (blocking) */
  1348.     TQASubmitVerticesGouraud        submitVerticesGouraud;      /* Method: Submit Gouraud vertices for trimesh */
  1349.     TQASubmitVerticesTexture        submitVerticesTexture;      /* Method: Submit Texture vertices for trimesh */
  1350.     TQADrawTriMeshGouraud           drawTriMeshGouraud;         /* Method: Draw a Gouraud triangle mesh */
  1351.     TQADrawTriMeshTexture           drawTriMeshTexture;         /* Method: Draw a Texture triangle mesh */
  1352.     TQASetNoticeMethod              setNoticeMethod;            /* Method: Set a notice method */
  1353.     TQAGetNoticeMethod              getNoticeMethod;            /* Method: Get a notice method */
  1354.     TQASubmitMultiTextureParams     submitMultiTextureParams;   /* Method: Submit Secondary texture params */
  1355.     TQAAccessDrawBuffer             accessDrawBuffer;
  1356.     TQAAccessDrawBufferEnd          accessDrawBufferEnd;
  1357.     TQAAccessZBuffer                accessZBuffer;
  1358.     TQAAccessZBufferEnd             accessZBufferEnd;
  1359.     TQAClearDrawBuffer              clearDrawBuffer;
  1360.     TQAClearZBuffer                 clearZBuffer;
  1361.     TQATextureNewFromDrawContext    textureFromContext;
  1362.     TQABitmapNewFromDrawContext     bitmapFromContext;
  1363.     TQABusy                         busy;
  1364.     TQASwapBuffers                  swapBuffers;
  1365. };
  1367. /************************************************************************************************
  1368.  *
  1369.  * Acceleration manager function prototypes.
  1370.  *
  1371.  ***********************************************************************************************/
  1372. #if CALL_NOT_IN_CARBON
  1373. EXTERN_API_C( TQAError )
  1374. QADrawContextNew                (const TQADevice *      device,
  1375.                                  const TQARect *        rect,
  1376.                                  const TQAClip *        clip,
  1377.                                  const TQAEngine *      engine,
  1378.                                  unsigned long          flags,
  1379.                                  TQADrawContext **      newDrawContext);
  1381. EXTERN_API_C( void )
  1382. QADrawContextDelete             (TQADrawContext *       drawContext);
  1384. EXTERN_API_C( TQAError )
  1385. QAColorTableNew                 (const TQAEngine *      engine,
  1386.                                  TQAColorTableType      tableType,
  1387.                                  void *                 pixelData,
  1388.                                  long                   transparentIndexFlag,
  1389.                                  TQAColorTable **       newTable);
  1391. EXTERN_API_C( void )
  1392. QAColorTableDelete              (const TQAEngine *      engine,
  1393.                                  TQAColorTable *        colorTable);
  1395. EXTERN_API_C( TQAError )
  1396. QATextureNew                    (const TQAEngine *      engine,
  1397.                                  unsigned long          flags,
  1398.                                  TQAImagePixelType      pixelType,
  1399.                                  const TQAImage         images[],
  1400.                                  TQATexture **          newTexture);
  1402. EXTERN_API_C( TQAError )
  1403. QATextureDetach                 (const TQAEngine *      engine,
  1404.                                  TQATexture *           texture);
  1406. EXTERN_API_C( void )
  1407. QATextureDelete                 (const TQAEngine *      engine,
  1408.                                  TQATexture *           texture);
  1410. EXTERN_API_C( TQAError )
  1411. QATextureBindColorTable         (const TQAEngine *      engine,
  1412.                                  TQATexture *           texture,
  1413.                                  TQAColorTable *        colorTable);
  1415. EXTERN_API_C( TQAError )
  1416. QABitmapNew                     (const TQAEngine *      engine,
  1417.                                  unsigned long          flags,
  1418.                                  TQAImagePixelType      pixelType,
  1419.                                  const TQAImage *       image,
  1420.                                  TQABitmap **           newBitmap);
  1422. EXTERN_API_C( TQAError )
  1423. QABitmapDetach                  (const TQAEngine *      engine,
  1424.                                  TQABitmap *            bitmap);
  1426. EXTERN_API_C( void )
  1427. QABitmapDelete                  (const TQAEngine *      engine,
  1428.                                  TQABitmap *            bitmap);
  1430. EXTERN_API_C( TQAError )
  1431. QABitmapBindColorTable          (const TQAEngine *      engine,
  1432.                                  TQABitmap *            bitmap,
  1433.                                  TQAColorTable *        colorTable);
  1435. EXTERN_API_C( TQAEngine *)
  1436. QADeviceGetFirstEngine          (const TQADevice *      device);
  1438. EXTERN_API_C( TQAEngine *)
  1439. QADeviceGetNextEngine           (const TQADevice *      device,
  1440.                                  const TQAEngine *      currentEngine);
  1442. EXTERN_API_C( TQAError )
  1443. QAEngineCheckDevice             (const TQAEngine *      engine,
  1444.                                  const TQADevice *      device);
  1446. EXTERN_API_C( TQAError )
  1447. QAEngineGestalt                 (const TQAEngine *      engine,
  1448.                                  TQAGestaltSelector     selector,
  1449.                                  void *                 response);
  1451. EXTERN_API_C( TQAError )
  1452. QAEngineEnable                  (long                   vendorID,
  1453.                                  long                   engineID);
  1455. EXTERN_API_C( TQAError )
  1456. QAEngineDisable                 (long                   vendorID,
  1457.                                  long                   engineID);
  1460. EXTERN_API_C( TQAError )
  1461. QAAccessTexture                 (const TQAEngine *      engine,
  1462.                                  TQATexture *           texture,
  1463.                                  long                   mipmapLevel,
  1464.                                  long                   flags,
  1465.                                  TQAPixelBuffer *       buffer);
  1467. EXTERN_API_C( TQAError )
  1468. QAAccessTextureEnd              (const TQAEngine *      engine,
  1469.                                  TQATexture *           texture,
  1470.                                  const TQARect *        dirtyRect);
  1472. EXTERN_API_C( TQAError )
  1473. QAAccessBitmap                  (const TQAEngine *      engine,
  1474.                                  TQABitmap *            bitmap,
  1475.                                  long                   flags,
  1476.                                  TQAPixelBuffer *       buffer);
  1478. EXTERN_API_C( TQAError )
  1479. QAAccessBitmapEnd               (const TQAEngine *      engine,
  1480.                                  TQABitmap *            bitmap,
  1481.                                  const TQARect *        dirtyRect);
  1486. #endif  /* CALL_NOT_IN_CARBON */
  1488. #if TARGET_OS_MAC
  1489. #if CALL_NOT_IN_CARBON
  1490. EXTERN_API_C( TQAError )
  1491. QARegisterDrawNotificationProc  (Rect *                 globalRect,
  1492.                                  TQADrawNotificationProcPtr  proc,
  1493.                                  long                   refCon,
  1494.                                  TQADrawNotificationProcRefNum * refNum);
  1496. EXTERN_API_C( TQAError )
  1497. QAUnregisterDrawNotificationProc (TQADrawNotificationProcRefNum  refNum);
  1499. #endif  /* CALL_NOT_IN_CARBON */
  1501. #endif  /* TARGET_OS_MAC */
  1510. #if PRAGMA_ENUM_ALWAYSINT
  1511.     #pragma enumsalwaysint reset
  1512.     #ifdef __RAVE__RESTORE_TWOBYTEINTS
  1513.         #pragma fourbyteints off
  1514.     #endif
  1515. #elif PRAGMA_ENUM_OPTIONS
  1516.     #pragma option enum=reset
  1517. #elif defined(__RAVE__RESTORE_PACKED_ENUMS)
  1518.     #pragma options(pack_enums)
  1519. #endif
  1521. #if PRAGMA_STRUCT_ALIGN
  1522.     #pragma options align=reset
  1523. #elif PRAGMA_STRUCT_PACKPUSH
  1524.     #pragma pack(pop)
  1525. #elif PRAGMA_STRUCT_PACK
  1526.     #pragma pack()
  1527. #endif
  1529. #ifdef PRAGMA_IMPORT_OFF
  1530. #pragma import off
  1531. #elif PRAGMA_IMPORT
  1532. #pragma import reset
  1533. #endif
  1535. #ifdef __cplusplus
  1536. }
  1537. #endif
  1539. #endif /* __RAVE__ */