/* ** ** Include file for the Warp3D API ** $VER: Warp3D.h 1.0 (20.05.98) ** ** ** This file is part of the Warp3D Project. ** Warp3D is copyrighted ** (C) 1998 Sam Jordan, Hans-Jörg Frieden, Thomas Frieden ** All rights reserved ** ** See the documentation for conditions. ** */ #ifndef _WARP3D_WARP3D_H #define _WARP3D_WARP3D_H #include #include #include #include #include #include #include typedef short W3D_Bool; typedef float W3D_Float; typedef double W3D_Double; #ifndef W3D_TRUE #define W3D_TRUE 1 #endif #ifndef W3D_FALSE #define W3D_FALSE 0 #endif /* GNUC WarpUp aligns longword fields to longword boundry so that a single longword-aligned W3D_Bool causes a following int to be aligned on a four-byte boundry. This construct avoids this. */ #if defined(__GNUC__) && defined(WARPUP) #define ATTRIB_PACKED __attribute__ ((packed)) #else #define ATTRIB_PACKED #endif typedef struct { W3D_Float r,g,b,a; /* RGBA values in range [0..1] */ } W3D_Color; typedef struct { W3D_Float r,g,b; /* RGB values in range [0..1] */ } W3D_ColorRGB; typedef struct { W3D_Float x,y; /* window coordinates */ W3D_Double z; /* z koordinate. Double precision for 32bit zbuffers */ W3D_Float w; /* w koordinate. */ W3D_Float u,v,tex3d; /* u/v koordinates, and an additional for 3d textures */ W3D_Color color; /* vertex color */ W3D_ColorRGB spec; /* specular lighting color */ W3D_Float l; /* Lambda value for Mipmapping. Private right now */ } W3D_Vertex; typedef struct { struct Node link; /* linkage, used by Warp3D itself */ W3D_Bool resident; /* TRUE, if texture is on card */ W3D_Bool mipmap; /* TRUE, if mipmaps are supported */ W3D_Bool dirty; /* TRUE, if texture image was changed */ W3D_Bool matchfmt; /* TRUE, if srcfmt = destfmt */ W3D_Bool reserved1; W3D_Bool reserved2; ULONG mipmapmask ATTRIB_PACKED; /* which mipmaps have to be generated */ void* texsource ATTRIB_PACKED; /* texture source image */ void* mipmaps[16] ATTRIB_PACKED; /* mipmap images */ int texfmtsrc ATTRIB_PACKED; /* texture format (from W3D_ATO_FORMAT) */ ULONG* palette ATTRIB_PACKED; /* texture palette for chunky textures */ void* texdata ATTRIB_PACKED; /* texture data converted */ void* texdest ATTRIB_PACKED; /* texture location on card */ int texdestsize ATTRIB_PACKED; /* size of VRAM allocation */ int texwidth ATTRIB_PACKED; /* texture width in pixels */ int texwidthexp ATTRIB_PACKED; /* texture width exponent */ int texheight ATTRIB_PACKED; /* texture width in pixels */ int texheightexp ATTRIB_PACKED; /* texture width exponent */ int bytesperpix ATTRIB_PACKED; /* bytes per pixel */ int bytesperrow ATTRIB_PACKED; /* bytes per row */ void* driver ATTRIB_PACKED; /* insert driver specific data here */ #if 0 /* These fields have been removed from V2 driver */ ULONG texfmt; /* texture format (HW-specific) */ ULONG minfilter; /* minification filter state (HW-specific) */ ULONG magfilter; /* magnification filter state (HW-specific) */ ULONG texenvmode; /* texture environment mode (HW-specific) */ W3D_Float texenvcolor[4]; /* texture environment color (HW-specific) */ ULONG wrapmode_s; /* texture wrapping mode (HW-specific) */ ULONG wrapmode_t; /* texture wrapping mode (HW-specific) */ W3D_Float bordercolor[4]; /* clamp border color (HW-specific) */ #endif } W3D_Texture; typedef struct { W3D_Vertex v1; /* vertex */ W3D_Texture *tex; /* texture */ W3D_Float pointsize; /* point diameter */ } W3D_Point; typedef struct { W3D_Vertex v1,v2; /* vertices for line drawing */ W3D_Texture *tex; /* texture */ W3D_Float linewidth; /* line width */ W3D_Bool st_enable; /* stippling enable */ unsigned short st_pattern; /* stippling pattern */ int st_factor; /* stippling factor */ } W3D_Line; typedef struct { /* V2 only */ int vertexcount; /* Number of vertices */ W3D_Vertex *v; /* An array of at least two vertices */ W3D_Texture *tex; /* texture */ W3D_Float linewidth; /* line width */ W3D_Bool st_enable; /* stippling enable */ unsigned short st_pattern; /* stippling pattern */ int st_factor; /* stippling factor */ } W3D_Lines; typedef struct { W3D_Vertex v1,v2,v3; /* three vertices for triangle drawing */ W3D_Texture *tex; /* texture */ unsigned char* st_pattern; /* stippling pattern */ } W3D_Triangle; typedef struct { W3D_Vertex *v1, *v2, *v3; /* Three vertex POINTERS */ W3D_Texture *tex; /* see above */ unsigned char* st_pattern; /* See above */ } W3D_TriangleV; typedef struct { int vertexcount; /* number of vertices */ W3D_Vertex *v; /* an array of at least 3 vertices */ W3D_Texture *tex; /* texture */ unsigned char* st_pattern; /* stippling pattern */ } W3D_Triangles; typedef struct { int vertexcount; /* number of vertices */ W3D_Vertex **v; /* Pointer to an array of pointers ! */ W3D_Texture *tex; /* Texture */ unsigned char* st_pattern; /* Stippling pattern */ } W3D_TrianglesV; typedef struct { W3D_Float fog_start; /* start of fogging zone */ W3D_Float fog_end; /* end of fogging area */ W3D_Float fog_density; /* fog density for exp. fogging */ W3D_ColorRGB fog_color; /* fog color */ } W3D_Fog; typedef struct { int left; /* left offset of clipping area */ int top; /* top offset of clipping area */ int width; /* width of clipping area */ int height; /* height of clipping area */ } W3D_Scissor; typedef struct { short type; /* Type of this entry */ short length; /* Length of the entry, including this struct */ ULONG state; /* State longword */ } W3D_QHead; typedef struct { UBYTE *data; /* Pointer to data area */ ULONG size; /* Size of the data block */ UBYTE *current; /* Current insertion position */ } W3D_Queue; #define QEMPTY(x) ( (x)->data == (x)->current ) /* The context structure is private, and should not be accessed in any way by Warp3D applications, with the following exceptions: The following fields are READ-ONLY: format, bprow, width, height, depth, drawmem */ typedef struct { void* driver; /* insert driver specific data here */ void* gfxdriver; /* usable by the GFXdriver */ int drivertype; /* driver type (3DHW / CPU) */ void* regbase; /* register base */ void* vmembase; /* video memory base */ void* zbuffer; /* Pointer to the Z buffer */ void* stencilbuffer; /* Pointer to the stencil buffer */ ULONG state; /* hardware state (see below) */ struct BitMap* drawregion; /* destination bitmap */ ULONG supportedfmt; /* bitmask with all supported dest fmt */ ULONG format; /* bitmap format (see below) */ int yoffset; /* Y-Offset (for ScrollVPort-Multibuf.) */ int bprow; /* bytes per row */ int width; /* bitmap width */ int height; /* bitmap height */ int depth; /* bitmap depth */ W3D_Bool chunky; /* TRUE, if palettized screen mode */ W3D_Bool destalpha; /* TRUE, if dest alpha channel available */ W3D_Bool zbufferalloc; /* TRUE, is Z buffer is allocated */ W3D_Bool stbufferalloc; /* TRUE, is stencil buffer is allocated */ W3D_Bool HWlocked; /* TRUE, if 3D HW was locked */ W3D_Bool w3dbitmap; /* TRUE, if drawregion points to a W3D_Bitmap */ W3D_Bool reserved2; W3D_Bool reserved3; struct MinList restex; /* A list of all resident textures, used for LRU implementation */ struct MinList tex; /* A list of all textures which are not on card */ int maxtexwidth; /* -HJF- replaced these for possible */ int maxtexheight; /* support of non-square textures */ int maxtexwidthp; /* -HJF- For hardware that has different */ int maxtexheightp; /* constaints in perspective mode */ W3D_Scissor scissor; /* scissor region */ W3D_Fog fog; /* fogging parameters */ ULONG envsupmask; /* Mask of supported envmodes */ #if 0 /* These fields have been removed from the V2 driver */ ULONG fogmode; /* fog mode */ ULONG zcmpmode; /* Z compare mode */ ULONG alphamode; /* alpha test mode */ ULONG alpharef; /* alpha test reference value */ ULONG blendsrc; /* blending source function */ ULONG blenddest; /* blending destination function */ ULONG logicop; /* logical operation */ W3D_Bool mask_red; /* color mask for red component */ W3D_Bool mask_green; /* color mask for greed component */ W3D_Bool mask_blue; /* color mask for blue component */ W3D_Bool mask_alpha; /* color mask for alpha component */ ULONG mask_index; /* index mask value */ ULONG stencil_func; /* stencil function */ ULONG stencil_sfail; /* stencil operation for sfail */ ULONG stencil_dpfail; /* stencil operation for dpfail */ ULONG stencil_dppass; /* stencil operation dppass */ ULONG stencil_ref; /* stencil reference value */ ULONG stencil_mask; /* stencil mask value */ #endif W3D_Queue* queue; /* queue to buffer drawings */ void * drawmem; /* base address for drawing operations */ ULONG globaltexenvmode; /* Global texture environment mode */ W3D_Float globaltexenvcolor[4]; /* global texture env color */ #if 0 /* These fields have been removed from the V2 driver */ ULONG texenvmode; /* texture environment mode (HW-specific) */ W3D_Float texenvcolor[4]; /* texture environment color (HW-specific) */ W3D_Color currentcolor; /* Color for single-color operations */ ULONG currentpen; /* Pen for single-pen operations */ #endif struct Library *DriverBase; /* Library base of the active driver */ ULONG EnableMask; /* Mask for enable-able states */ ULONG DisableMask; /* Mask for disable-able states */ ULONG CurrentChip; /* Chip constant */ ULONG DriverVersion; /* Internal driver version */ } W3D_Context; typedef struct { int bprow; /* Bytes per row */ int width; /* Width */ int height; /* Height */ ULONG format; /* Destination color format */ void *dest; /* Pointer to destination */ } W3D_Bitmap; typedef struct { /* V2 only */ ULONG ChipID; /* One of W3D_CHIP_??? below */ ULONG formats; /* Bitmask of supported formats */ char* name; /* Name of the chip/driver */ W3D_Bool swdriver; /* W3D_TRUE -> CPU-Driver */ } W3D_Driver; /* W3D_ScreenMode structure */ typedef struct { ULONG ModeID; /* ModeID for OpenScreen */ ULONG Width, Height; /* Width and Height for visible screen */ ULONG Depth; /* Pixel Depth */ char DisplayName[DISPLAYNAMELEN]; /* readable name of this display mode */ W3D_Driver * Driver ATTRIB_PACKED; /* Matching driver for this mode */ void *Next ATTRIB_PACKED; /* Next W3D_ScreenMode in list */ } W3D_ScreenMode; /* Tags for W3D_CreateContext */ #define W3D_CC_TAGS (TAG_USER+0x200000) #define W3D_CC_BITMAP (W3D_CC_TAGS+0) /* destination bitmap */ #define W3D_CC_YOFFSET (W3D_CC_TAGS+1) /* y-Offset */ #define W3D_CC_DRIVERTYPE (W3D_CC_TAGS+2) /* see below */ #define W3D_CC_W3DBM (W3D_CC_TAGS+3) /* Use W3D_Bitmap instead of struct BitMap */ #define W3D_CC_INDIRECT (W3D_CC_TAGS+4) /* Indirect drawing */ #define W3D_CC_GLOBALTEXENV (W3D_CC_TAGS+5) /* SetTexEnv is global */ #define W3D_CC_DOUBLEHEIGHT (W3D_CC_TAGS+6) /* Drawing area has double height */ #define W3D_CC_FAST (W3D_CC_TAGS+7) /* Allow Warp3D to modify passed Triangle/Lines/Points */ #define W3D_CC_MODEID (W3D_CC_TAGS+8) /* Specify modeID to use */ /* driver types. These are used as flags for W3D_CreateContext and as bitmask for W3D_CheckDriver. It is also used by W3DHW_GetDriverInfo and in the element 'drivertype' in the context structure */ #define W3D_DRIVER_UNAVAILABLE (1<<0) /* driver unavailable */ #define W3D_DRIVER_BEST (1<<1) /* use best mode */ #define W3D_DRIVER_3DHW (1<<2) /* use 3D-HW */ #define W3D_DRIVER_CPU (1<<3) /* use CPU */ /* Chip constants returned e.g. by W3D_GetDrivers. These can be used to identify the chip that is active/available. You may not, however, make any assumtions about the capabilities of the driver based on this constant, since some features might be emulated. Strictly for informational/internal uses. */ #define W3D_CHIP_UNKNOWN 1 #define W3D_CHIP_VIRGE 2 #define W3D_CHIP_PERMEDIA2 3 #define W3D_CHIP_VOODOO1 4 #if 0 /* Removed from V2. Will vanish soon */ #define W3D_CHIP_Z2BUS (1l<<16) #define W3D_CHIP_Z3BUS (1l<<17) #define W3D_GETCHIP(x) ((x)&0xffff) #define W3D_GETBUS(x) ((x)&0xffff0000) #endif /* Tags for W3D_AllocTexObj */ #define W3D_ATO_TAGS (TAG_USER+0x201000) #define W3D_ATO_IMAGE (W3D_ATO_TAGS+0) /* texture image */ #define W3D_ATO_FORMAT (W3D_ATO_TAGS+1) /* source format */ #define W3D_ATO_WIDTH (W3D_ATO_TAGS+2) /* border width */ #define W3D_ATO_HEIGHT (W3D_ATO_TAGS+3) /* border height */ #define W3D_ATO_MIPMAP (W3D_ATO_TAGS+4) /* mipmap mask */ #define W3D_ATO_PALETTE (W3D_ATO_TAGS+5) /* texture palette */ #define W3D_ATO_MIPMAPPTRS (W3D_ATO_TAGS+6) /* array of user-supplied mipmaps */ /* possible values for W3D_ATO_FORMAT and W3D_GetTexFmtInfo */ /* a = alpha, r = red, g = green, b = blue, l = luminance, i = intensity*/ #define W3D_CHUNKY 1 /* palettized */ #define W3D_A1R5G5B5 2 /* a rrrrr ggggg bbbbb */ #define W3D_R5G6B5 3 /* rrrrr gggggg bbbbb */ #define W3D_R8G8B8 4 /* rrrrrrrr gggggggg bbbbbbbb */ #define W3D_A4R4G4B4 5 /* aaaa rrrr gggg bbbb */ #define W3D_A8R8G8B8 6 /* aaaaaaaa rrrrrrrr gggggggg bbbbbbbb */ #define W3D_A8 7 /* aaaaaaaa */ #define W3D_L8 8 /* llllllll */ #define W3D_L8A8 9 /* llllllll aaaaaaaa */ #define W3D_I8 10 /* iiiiiiii */ #define W3D_R8G8B8A8 11 /* rrrrrrrr gggggggg bbbbbbbb aaaaaaaa */ /* return values of W3D_GetTexFmtInfo (bitmask) */ #define W3D_TEXFMT_SUPPORTED (1<<0) /* format is supported, although it may be converted */ #define W3D_TEXFMT_FAST (1<<16) /* format directly supported by 3D HW */ #define W3D_TEXFMT_CLUTFAST (1<<17) /* format is directly supported on LUT8 screens */ #define W3D_TEXFMT_ARGBFAST (1<<18) /* format is directly supported on 16/24 bit screens */ #define W3D_TEXFMT_UNSUPPORTED (1<<1) /* this format is unsupported, and can't be simulated */ /* bitmap format flags used by CPU drivers */ #define W3D_FMT_CLUT (1<<0) /* chunky */ #define W3D_FMT_R5G5B5 (1<<1) /* 0 rrrrr ggggg bbbbb */ #define W3D_FMT_B5G5R5 (1<<2) /* 0 bbbbb ggggg rrrrr */ #define W3D_FMT_R5G5B5PC (1<<3) /* ggg bbbbb 0 rrrrr gg */ #define W3D_FMT_B5G5R5PC (1<<4) /* ggg rrrrr 0 bbbbb gg */ #define W3D_FMT_R5G6B5 (1<<5) /* rrrrr gggggg bbbbb */ #define W3D_FMT_B5G6R5 (1<<6) /* bbbbb gggggg rrrrr */ #define W3D_FMT_R5G6B5PC (1<<7) /* ggg bbbbb rrrrr ggg */ #define W3D_FMT_B5G6R5PC (1<<8) /* ggg rrrrr bbbbb ggg */ #define W3D_FMT_R8G8B8 (1<<9) /* rrrrrrrr gggggggg bbbbbbbb */ #define W3D_FMT_B8G8R8 (1<<10) /* bbbbbbbb gggggggg rrrrrrrr */ #define W3D_FMT_A8R8G8B8 (1<<11) /* aaaaaaaa rrrrrrrr gggggggg bbbbbbbb */ #define W3D_FMT_A8B8G8R8 (1<<12) /* aaaaaaaa bbbbbbbb gggggggg rrrrrrrr */ #define W3D_FMT_R8G8B8A8 (1<<13) /* rrrrrrrr gggggggg bbbbbbbb aaaaaaaa */ #define W3D_FMT_B8G8R8A8 (1<<14) /* bbbbbbbb gggggggg rrrrrrrr aaaaaaaa */ /* possible mode values for W3D_SetState/W3D_GetState and for 'state' in the context structure */ #define W3D_AUTOTEXMANAGEMENT (1<<1) /* automatic texture management */ #define W3D_SYNCHRON (1<<2) /* wait, until HW is idle */ #define W3D_INDIRECT (1<<3) /* drawing is queued until flushed */ #define W3D_GLOBALTEXENV (1<<4) /* SetTexEnv is global */ #define W3D_DOUBLEHEIGHT (1<<5) /* Drawing area is double height */ #define W3D_FAST (1<<6) /* Allow Warp3D to modify passed Triangles/Points/Lines */ #define W3D_AUTOCLIP (1<<7) /* clip to screen region */ #define W3D_TEXMAPPING (1<<8) /* texmapping state */ #define W3D_PERSPECTIVE (1<<9) /* perspective correction state */ #define W3D_GOURAUD (1<<10) /* gouraud/flat shading */ #define W3D_ZBUFFER (1<<11) /* Z-Buffer state */ #define W3D_ZBUFFERUPDATE (1<<12) /* Z-Buffer update state */ #define W3D_BLENDING (1<<13) /* Alpha blending state */ #define W3D_FOGGING (1<<14) /* Fogging state */ #define W3D_ANTI_POINT (1<<15) /* Point antialiasing state */ #define W3D_ANTI_LINE (1<<16) /* Line antialiasing state */ #define W3D_ANTI_POLYGON (1<<17) /* Polygon antialiasing state */ #define W3D_ANTI_FULLSCREEN (1<<18) /* Fullscreen antialiasing state */ #define W3D_DITHERING (1<<19) /* dithering state */ #define W3D_LOGICOP (1<<20) /* logic operations */ #define W3D_STENCILBUFFER (1<<21) /* stencil buffer/stencil test */ #define W3D_ALPHATEST (1<<22) /* alpha test */ #define W3D_SPECULAR (1<<23) /* Specular lighting */ #define W3D_TEXMAPPING3D (1<<24) /* 3d textures */ #define W3D_SCISSOR (1<<25) /* Scissor test enable */ #define W3D_CHROMATEST (1<<26) /* Chroma test enable */ /* action/result values for W3D_SetState/W3D_GetState */ #define W3D_ENABLE 1 /* enable mode */ #define W3D_ENABLED 1 /* mode is enabled */ #define W3D_DISABLE 2 /* disable mode */ #define W3D_DISABLED 2 /* mode is disabled */ /* mode parameters for W3D_Query */ #define W3D_Q_DRAW_POINT 1 /* point drawing */ #define W3D_Q_DRAW_LINE 2 /* line drawing */ #define W3D_Q_DRAW_TRIANGLE 3 /* triangle drawing */ #define W3D_Q_DRAW_POINT_X 4 /* points with size != 1 supported */ #define W3D_Q_DRAW_LINE_X 5 /* lines with width != 1 supported */ #define W3D_Q_DRAW_LINE_ST 6 /* line stippling supported */ #define W3D_Q_DRAW_POLY_ST 7 /* polygon stippling supported */ #define W3D_Q_DRAW_POINT_FX 8 /* point drawing supports special fx */ #define W3D_Q_DRAW_LINE_FX 9 /* line drawing supports speical fx */ /* Note: more of these below */ #define W3D_Q_TEXMAPPING 11 /* texmapping in general */ #define W3D_Q_MIPMAPPING 12 /* mipmapping */ #define W3D_Q_BILINEARFILTER 13 /* bilinear filter */ #define W3D_Q_MMFILTER 14 /* mipmap filter */ #define W3D_Q_LINEAR_REPEAT 15 /* W3D_REPEAT for linear texmapping */ #define W3D_Q_LINEAR_CLAMP 16 /* W3D_CLAMP for linear texmapping */ #define W3D_Q_PERSPECTIVE 17 /* perspective correction */ #define W3D_Q_PERSP_REPEAT 18 /* W3D_REPEAT for persp. texmapping */ #define W3D_Q_PERSP_CLAMP 19 /* W3D_CLAMP for persp. texmapping */ #define W3D_Q_ENV_REPLACE 20 /* texenv REPLACE */ #define W3D_Q_ENV_DECAL 21 /* texenv DECAL */ #define W3D_Q_ENV_MODULATE 22 /* texenv MODULATE */ #define W3D_Q_ENV_BLEND 23 /* texenv BLEND */ #define W3D_Q_WRAP_ASYM 24 /* texture wrapping asymetric in s and t direction */ #define W3D_Q_SPECULAR 25 /* Specular hiliting */ #define W3D_Q_BLEND_DECAL_FOG 26 /* driver supports alpha blending and decal with fog */ #define W3D_Q_TEXMAPPING3D 27 /* driver supports 3-dimensional (volumetric) textures */ #define W3D_Q_CHROMATEST 28 /* driver supports chroma test */ #define W3D_Q_FLATSHADING 31 /* flat shading */ #define W3D_Q_GOURAUDSHADING 32 /* gouraud shading */ #define W3D_Q_ZBUFFER 41 /* Z buffer in general */ #define W3D_Q_ZBUFFERUPDATE 42 /* Z buffer update */ #define W3D_Q_ZCOMPAREMODES 43 /* Z buffer compare modes */ #define W3D_Q_ALPHATEST 51 /* alpha test in general */ #define W3D_Q_ALPHATESTMODES 52 /* alpha test modes */ #define W3D_Q_BLENDING 61 /* alpha blending */ #define W3D_Q_SRCFACTORS 62 /* source factors */ #define W3D_Q_DESTFACTORS 63 /* destination factors */ #define W3D_Q_ONE_ONE 64 /* W3D_ONE / W3D_ONE supported */ #define W3D_Q_FOGGING 71 /* fogging in general */ #define W3D_Q_LINEAR 72 /* linear fogging */ #define W3D_Q_EXPONENTIAL 73 /* exponential fogging */ #define W3D_Q_S_EXPONENTIAL 74 /* square exponential fogging */ #define W3D_Q_INTERPOLATED 75 /* interpolated fog */ #define W3D_Q_ANTIALIASING 81 /* antialiasing in general */ #define W3D_Q_ANTI_POINT 82 /* point antialiasing */ #define W3D_Q_ANTI_LINE 83 /* line antialiasing */ #define W3D_Q_ANTI_POLYGON 84 /* polygon antialiasing */ #define W3D_Q_ANTI_FULLSCREEN 85 /* full screen antialiasing */ #define W3D_Q_DITHERING 91 /* dithering */ #define W3D_Q_PALETTECONV 92 /* driver can use per-texture palettes on 8bit screens */ #define W3D_Q_SCISSOR 101 /* scissor test */ #define W3D_Q_MAXTEXWIDTH 111 /* max. texture border width */ #define W3D_Q_MAXTEXHEIGHT 112 /* max. texture border height */ #define W3D_Q_MAXTEXWIDTH_P 113 /* max. texture border width */ #define W3D_Q_MAXTEXHEIGHT_P 114 /* max. texture border height */ #define W3D_Q_RECTTEXTURES 115 /* rectangular texture supported */ #define W3D_Q_LOGICOP 121 /* logical operation */ #define W3D_Q_MASKING 131 /* color/index masking */ #define W3D_Q_STENCILBUFFER 141 /* stencil buffer in general */ #define W3D_Q_STENCIL_MASK 142 /* mask value */ #define W3D_Q_STENCIL_FUNC 143 /* stencil functions */ #define W3D_Q_STENCIL_SFAIL 144 /* stencil operation SFAIL */ #define W3D_Q_STENCIL_DPFAIL 145 /* stencil operation DPFAIL */ #define W3D_Q_STENCIL_DPPASS 146 /* stencil operation DPPASS */ #define W3D_Q_STENCIL_WRMASK 147 /* stencil buffer supports write masking */ #define W3D_Q_DRAW_POINT_TEX 160 /* point drawing supports textures */ #define W3D_Q_DRAW_LINE_TEX 161 /* line drawing supports textures */ /* results of W3D_Query (if a result-set is expected) */ #define W3D_FULLY_SUPPORTED 3 /* completely supported */ #define W3D_PARTIALLY_SUPPORTED 4 /* partially supported */ #define W3D_NOT_SUPPORTED 5 /* not supported */ /* blending modes used for alpha blending (the comment shows for which function [source or destination] the mode can be used) */ #define W3D_ZERO 1 /* source + dest */ #define W3D_ONE 2 /* source + dest */ #define W3D_SRC_COLOR 3 /* dest only */ #define W3D_DST_COLOR 4 /* source only */ #define W3D_ONE_MINUS_SRC_COLOR 5 /* dest only */ #define W3D_ONE_MINUS_DST_COLOR 6 /* source only */ #define W3D_SRC_ALPHA 7 /* source + dest */ #define W3D_ONE_MINUS_SRC_ALPHA 8 /* source + dest */ #define W3D_DST_ALPHA 9 /* source + dest */ #define W3D_ONE_MINUS_DST_ALPHA 10 /* source + dest */ #define W3D_SRC_ALPHA_SATURATE 11 /* source only */ #define W3D_CONSTANT_COLOR 12 #define W3D_ONE_MINUS_CONSTANT_COLOR 13 #define W3D_CONSTANT_ALPHA 14 #define W3D_ONE_MINUS_CONSTANT_ALPHA 15 /* texture filter. Only W3D_NEAREST and W3D_LINEAR can be used for magnification filters! */ #define W3D_NEAREST 1 /* no mipmapping, no filtering */ #define W3D_LINEAR 2 /* no mipmapping, bilinear filtering */ #define W3D_NEAREST_MIP_NEAREST 3 /* mipmapping, no filtering */ #define W3D_NEAREST_MIP_LINEAR 4 /* mipmapping, bilinear filtering */ #define W3D_LINEAR_MIP_NEAREST 5 /* filtered mipmapping, no filtering */ #define W3D_LINEAR_MIP_LINEAR 6 /* mipmapping, trilinear filtering */ /* fog modes */ #define W3D_FOG_LINEAR 1 /* linear fogging */ #define W3D_FOG_EXP 2 /* exponential fogging */ #define W3D_FOG_EXP_2 3 /* square exponential fogging */ #define W3D_FOG_INTERPOLATED 4 /* interpolated fogging */ /* texture environment parameters */ #define W3D_REPLACE 1 /* unlit texturing */ #define W3D_DECAL 2 /* RGB: same as W3D_REPLACE RGBA: use alpha to blend texture with primitive (lit-texturing) */ #define W3D_MODULATE 3 /* lit-texturing by modulation */ #define W3D_BLEND 4 /* blend with environment color */ /* texture wrapping parameters */ #define W3D_REPEAT 1 /* texture is repeated */ #define W3D_CLAMP 2 /* texture is clamped */ /* alpha test compare modes */ #define W3D_A_NEVER 1 /* discard incoming pixel */ #define W3D_A_LESS 2 /* draw, if value < refvalue */ #define W3D_A_GEQUAL 3 /* draw, if value >= refvalue */ #define W3D_A_LEQUAL 4 /* draw, if value <= refvalue */ #define W3D_A_GREATER 5 /* draw, if value > refvalue */ #define W3D_A_NOTEQUAL 6 /* draw, if value != refvalue */ #define W3D_A_EQUAL 7 /* draw, if value == refvalue */ #define W3D_A_ALWAYS 8 /* always draw */ /* Z buffer compare modes */ #define W3D_Z_NEVER 1 /* discard incoming pixel */ #define W3D_Z_LESS 2 /* draw, if value < Z(Z_Buffer) */ #define W3D_Z_GEQUAL 3 /* draw, if value >= Z(Z_Buffer) */ #define W3D_Z_LEQUAL 4 /* draw, if value <= Z(Z_Buffer) */ #define W3D_Z_GREATER 5 /* draw, if value > Z(Z_Buffer) */ #define W3D_Z_NOTEQUAL 6 /* draw, if value != Z(Z_Buffer) */ #define W3D_Z_EQUAL 7 /* draw, if value == Z(Z_Buffer) */ #define W3D_Z_ALWAYS 8 /* always draw */ /* logical operation modes */ #define W3D_LO_CLEAR 1 /* dest = 0 */ #define W3D_LO_AND 2 /* dest = source & dest */ #define W3D_LO_AND_REVERSE 3 /* dest = source & !dest */ #define W3D_LO_COPY 4 /* dest = source */ #define W3D_LO_AND_INVERTED 5 /* dest = !source & dest */ #define W3D_LO_NOOP 6 /* dest = dest */ #define W3D_LO_XOR 7 /* dest = source ^ dest */ #define W3D_LO_OR 8 /* dest = source | dest */ #define W3D_LO_NOR 9 /* dest = !(source | dest) */ #define W3D_LO_EQUIV 10 /* dest = !(source ^ dest) */ #define W3D_LO_INVERT 11 /* dest = !dest */ #define W3D_LO_OR_REVERSE 12 /* dest = source | !dest */ #define W3D_LO_COPY_INVERTED 13 /* dest = !source */ #define W3D_LO_OR_INVERTED 14 /* dest = !source | dest */ #define W3D_LO_NAND 15 /* dest = !(source & dest) */ #define W3D_LO_SET 16 /* dest = 1 */ /* stencil test functions */ #define W3D_ST_NEVER 1 /* don't draw pixel */ #define W3D_ST_ALWAYS 2 /* draw always */ #define W3D_ST_LESS 3 /* draw, if refvalue < ST */ #define W3D_ST_LEQUAL 4 /* draw, if refvalue <= ST */ #define W3D_ST_EQUAL 5 /* draw, if refvalue == ST */ #define W3D_ST_GEQUAL 6 /* draw, if refvalue >= ST */ #define W3D_ST_GREATER 7 /* draw, if refvalue > ST */ #define W3D_ST_NOTEQUAL 8 /* draw, if refvalue != ST */ /* stencil test operations */ #define W3D_ST_KEEP 1 /* keep stencil buffer value */ #define W3D_ST_ZERO 2 /* clear stencil buffer value */ #define W3D_ST_REPLACE 3 /* replace by reference value */ #define W3D_ST_INCR 4 /* increment */ #define W3D_ST_DECR 5 /* decrement */ #define W3D_ST_INVERT 6 /* invert bitwise */ /* chroma test modes */ #define W3D_CHROMATEST_NONE 1 /* No chroma test */ #define W3D_CHROMATEST_INCLUSIVE 2 /* texels in the range pass the test */ #define W3D_CHROMATEST_EXCLUSIVE 3 /* texels in the range are rejected */ /* error/status values */ #define W3D_SUCCESS 0 /* success */ #define W3D_BUSY -1 /* graphics hardware is busy */ #define W3D_ILLEGALINPUT -2 /* failure, illegal input */ #define W3D_NOMEMORY -3 /* no memory available */ #define W3D_NODRIVER -4 /* no hardware driver available */ #define W3D_NOTEXTURE -5 /* texture is missing */ #define W3D_TEXNOTRESIDENT -6 /* texture not resident */ #define W3D_NOMIPMAPS -7 /* mipmaps are not supported by this texture object */ #define W3D_NOGFXMEM -8 /* no graphics memory available */ #define W3D_NOTVISIBLE -9 /* drawing area not visible/ bitmap swapped out */ #define W3D_UNSUPPORTEDFILTER -10 /* unsupported filter */ #define W3D_UNSUPPORTEDTEXENV -11 /* unsupported filter */ #define W3D_UNSUPPORTEDWRAPMODE -12 /* unsupported wrap mode */ #define W3D_UNSUPPORTEDZCMP -13 /* unsupported Z compare mode */ #define W3D_UNSUPPORTEDATEST -14 /* unsupported alpha test */ #define W3D_UNSUPPORTEDBLEND -15 /* unsupported blending function */ #define W3D_UNSUPPORTEDFOG -16 /* unsupported fog mode */ #define W3D_UNSUPPORTEDSTATE -17 /* can't enable/disable state */ #define W3D_UNSUPPORTEDFMT -18 /* unsupported bitmap format */ #define W3D_UNSUPPORTEDTEXSIZE -19 /* unsupported texture border size */ #define W3D_UNSUPPORTEDLOGICOP -20 /* unsupported logical operation */ #define W3D_UNSUPPORTEDSTTEST -21 /* unsupported stencil test */ #define W3D_ILLEGALBITMAP -22 /* illegal bitmap */ #define W3D_NOZBUFFER -23 /* Z buffer is missing/unavailable */ #define W3D_NOPALETTE -24 /* Palette missing for chunky textures */ #define W3D_MASKNOTSUPPORTED -25 /* color/index masking not supported */ #define W3D_NOSTENCILBUFFER -26 /* Stencil buffer is missing/unavailable */ #define W3D_QUEUEFAILED -27 /* The request can not be queued */ #define W3D_UNSUPPORTEDTEXFMT -28 /* Texformat unsupported */ #define W3D_WARNING -29 /* Parital success */ #define W3D_UNSUPPORTED -30 /* Requested feature is unsupported */ /* Hints */ #define W3D_H_TEXMAPPING 1 /* Quality of general texture mapping */ #define W3D_H_MIPMAPPING 2 /* Quality of mipmapping */ #define W3D_H_BILINEARFILTER 3 /* Quality of bilinear filtering */ #define W3D_H_MMFILTER 4 /* Quality of depth filter */ #define W3D_H_PERSPECTIVE 5 /* Quality of perspective correction */ #define W3D_H_BLENDING 6 /* Quality of alpha blending */ #define W3D_H_FOGGING 7 /* Quality of fogging */ #define W3D_H_ANTIALIASING 8 /* Quality of antialiasing */ #define W3D_H_DITHERING 9 /* Quality of dithering */ #define W3D_H_ZBUFFER 10 /* Quality of zbuffering */ #define W3D_H_POINTDRAW 11 /* Quality parameters */ #define W3D_H_FAST 1 /* Low quality, fast rendering */ #define W3D_H_AVERAGE 2 /* Medium quality and speed */ #define W3D_H_NICE 3 /* Best quality, low speed */ /* ScreenMode Requester TagItems */ #define W3D_SMR_TAGS (TAG_USER+0x202000) #define W3D_SMR_DRIVER (W3D_SMR_TAGS+0) /* Driver to filter */ #define W3D_SMR_DESTFMT (W3D_SMR_TAGS+1) /* Dest Format to filter */ #define W3D_SMR_TYPE (W3D_SMR_TAGS+2) /* Type to filter */ #define W3D_SMR_SIZEFILTER (W3D_SMR_TAGS+3) /* Also filter size */ #define W3D_SMR_MODEMASK (W3D_SMR_TAGS+4) /* AND-Mask for modes */ /* BestModeID tag items */ #define W3D_BMI_TAGS (TAG_USER+0x203000) #define W3D_BMI_DRIVER (W3D_BMI_TAGS+0) #define W3D_BMI_WIDTH (W3D_BMI_TAGS+1) #define W3D_BMI_HEIGHT (W3D_BMI_TAGS+2) #define W3D_BMI_DEPTH (W3D_BMI_TAGS+3) #endif