1 /*==========================================================================;
3 * Copyright (C) 1995-1997 Microsoft Corporation. All Rights Reserved.
6 * Content: Direct3D capabilities include file
8 ***************************************************************************/
14 * Pull in DirectDraw include file automatically:
20 /* Description of capabilities of transform */
22 typedef struct _D3DTRANSFORMCAPS {
25 } D3DTRANSFORMCAPS, *LPD3DTRANSFORMCAPS;
27 #define D3DTRANSFORMCAPS_CLIP 0x00000001L /* Will clip whilst transforming */
29 /* Description of capabilities of lighting */
31 typedef struct _D3DLIGHTINGCAPS {
33 DWORD dwCaps; /* Lighting caps */
34 DWORD dwLightingModel; /* Lighting model - RGB or mono */
35 DWORD dwNumLights; /* Number of lights that can be handled */
36 } D3DLIGHTINGCAPS, *LPD3DLIGHTINGCAPS;
38 #define D3DLIGHTINGMODEL_RGB 0x00000001L
39 #define D3DLIGHTINGMODEL_MONO 0x00000002L
41 #define D3DLIGHTCAPS_POINT 0x00000001L /* Point lights supported */
42 #define D3DLIGHTCAPS_SPOT 0x00000002L /* Spot lights supported */
43 #define D3DLIGHTCAPS_DIRECTIONAL 0x00000004L /* Directional lights supported */
44 #define D3DLIGHTCAPS_PARALLELPOINT 0x00000008L /* Parallel point lights supported */
46 /* Description of capabilities for each primitive type */
48 typedef struct _D3DPrimCaps {
50 DWORD dwMiscCaps; /* Capability flags */
54 DWORD dwDestBlendCaps;
58 DWORD dwTextureFilterCaps;
59 DWORD dwTextureBlendCaps;
60 DWORD dwTextureAddressCaps;
61 DWORD dwStippleWidth; /* maximum width and height of */
62 DWORD dwStippleHeight; /* of supported stipple (up to 32x32) */
63 } D3DPRIMCAPS, *LPD3DPRIMCAPS;
65 /* D3DPRIMCAPS dwMiscCaps */
67 #define D3DPMISCCAPS_MASKPLANES 0x00000001L
68 #define D3DPMISCCAPS_MASKZ 0x00000002L
69 #define D3DPMISCCAPS_LINEPATTERNREP 0x00000004L
70 #define D3DPMISCCAPS_CONFORMANT 0x00000008L
71 #define D3DPMISCCAPS_CULLNONE 0x00000010L
72 #define D3DPMISCCAPS_CULLCW 0x00000020L
73 #define D3DPMISCCAPS_CULLCCW 0x00000040L
75 /* D3DPRIMCAPS dwRasterCaps */
77 #define D3DPRASTERCAPS_DITHER 0x00000001L
78 #define D3DPRASTERCAPS_ROP2 0x00000002L
79 #define D3DPRASTERCAPS_XOR 0x00000004L
80 #define D3DPRASTERCAPS_PAT 0x00000008L
81 #define D3DPRASTERCAPS_ZTEST 0x00000010L
82 #define D3DPRASTERCAPS_SUBPIXEL 0x00000020L
83 #define D3DPRASTERCAPS_SUBPIXELX 0x00000040L
84 #define D3DPRASTERCAPS_FOGVERTEX 0x00000080L
85 #define D3DPRASTERCAPS_FOGTABLE 0x00000100L
86 #define D3DPRASTERCAPS_STIPPLE 0x00000200L
87 #define D3DPRASTERCAPS_ANTIALIASSORTDEPENDENT 0x00000400L
88 #define D3DPRASTERCAPS_ANTIALIASSORTINDEPENDENT 0x00000800L
89 #define D3DPRASTERCAPS_ANTIALIASEDGES 0x00001000L
90 #define D3DPRASTERCAPS_MIPMAPLODBIAS 0x00002000L
91 #define D3DPRASTERCAPS_ZBIAS 0x00004000L
92 #define D3DPRASTERCAPS_ZBUFFERLESSHSR 0x00008000L
93 #define D3DPRASTERCAPS_FOGRANGE 0x00010000L
94 #define D3DPRASTERCAPS_ANISOTROPY 0x00020000L
96 /* D3DPRIMCAPS dwZCmpCaps, dwAlphaCmpCaps */
98 #define D3DPCMPCAPS_NEVER 0x00000001L
99 #define D3DPCMPCAPS_LESS 0x00000002L
100 #define D3DPCMPCAPS_EQUAL 0x00000004L
101 #define D3DPCMPCAPS_LESSEQUAL 0x00000008L
102 #define D3DPCMPCAPS_GREATER 0x00000010L
103 #define D3DPCMPCAPS_NOTEQUAL 0x00000020L
104 #define D3DPCMPCAPS_GREATEREQUAL 0x00000040L
105 #define D3DPCMPCAPS_ALWAYS 0x00000080L
107 /* D3DPRIMCAPS dwSourceBlendCaps, dwDestBlendCaps */
109 #define D3DPBLENDCAPS_ZERO 0x00000001L
110 #define D3DPBLENDCAPS_ONE 0x00000002L
111 #define D3DPBLENDCAPS_SRCCOLOR 0x00000004L
112 #define D3DPBLENDCAPS_INVSRCCOLOR 0x00000008L
113 #define D3DPBLENDCAPS_SRCALPHA 0x00000010L
114 #define D3DPBLENDCAPS_INVSRCALPHA 0x00000020L
115 #define D3DPBLENDCAPS_DESTALPHA 0x00000040L
116 #define D3DPBLENDCAPS_INVDESTALPHA 0x00000080L
117 #define D3DPBLENDCAPS_DESTCOLOR 0x00000100L
118 #define D3DPBLENDCAPS_INVDESTCOLOR 0x00000200L
119 #define D3DPBLENDCAPS_SRCALPHASAT 0x00000400L
120 #define D3DPBLENDCAPS_BOTHSRCALPHA 0x00000800L
121 #define D3DPBLENDCAPS_BOTHINVSRCALPHA 0x00001000L
123 /* D3DPRIMCAPS dwShadeCaps */
125 #define D3DPSHADECAPS_COLORFLATMONO 0x00000001L
126 #define D3DPSHADECAPS_COLORFLATRGB 0x00000002L
127 #define D3DPSHADECAPS_COLORGOURAUDMONO 0x00000004L
128 #define D3DPSHADECAPS_COLORGOURAUDRGB 0x00000008L
129 #define D3DPSHADECAPS_COLORPHONGMONO 0x00000010L
130 #define D3DPSHADECAPS_COLORPHONGRGB 0x00000020L
132 #define D3DPSHADECAPS_SPECULARFLATMONO 0x00000040L
133 #define D3DPSHADECAPS_SPECULARFLATRGB 0x00000080L
134 #define D3DPSHADECAPS_SPECULARGOURAUDMONO 0x00000100L
135 #define D3DPSHADECAPS_SPECULARGOURAUDRGB 0x00000200L
136 #define D3DPSHADECAPS_SPECULARPHONGMONO 0x00000400L
137 #define D3DPSHADECAPS_SPECULARPHONGRGB 0x00000800L
139 #define D3DPSHADECAPS_ALPHAFLATBLEND 0x00001000L
140 #define D3DPSHADECAPS_ALPHAFLATSTIPPLED 0x00002000L
141 #define D3DPSHADECAPS_ALPHAGOURAUDBLEND 0x00004000L
142 #define D3DPSHADECAPS_ALPHAGOURAUDSTIPPLED 0x00008000L
143 #define D3DPSHADECAPS_ALPHAPHONGBLEND 0x00010000L
144 #define D3DPSHADECAPS_ALPHAPHONGSTIPPLED 0x00020000L
146 #define D3DPSHADECAPS_FOGFLAT 0x00040000L
147 #define D3DPSHADECAPS_FOGGOURAUD 0x00080000L
148 #define D3DPSHADECAPS_FOGPHONG 0x00100000L
150 /* D3DPRIMCAPS dwTextureCaps */
152 #define D3DPTEXTURECAPS_PERSPECTIVE 0x00000001L
153 #define D3DPTEXTURECAPS_POW2 0x00000002L
154 #define D3DPTEXTURECAPS_ALPHA 0x00000004L
155 #define D3DPTEXTURECAPS_TRANSPARENCY 0x00000008L
156 #define D3DPTEXTURECAPS_BORDER 0x00000010L
157 #define D3DPTEXTURECAPS_SQUAREONLY 0x00000020L
159 /* D3DPRIMCAPS dwTextureFilterCaps */
161 #define D3DPTFILTERCAPS_NEAREST 0x00000001L
162 #define D3DPTFILTERCAPS_LINEAR 0x00000002L
163 #define D3DPTFILTERCAPS_MIPNEAREST 0x00000004L
164 #define D3DPTFILTERCAPS_MIPLINEAR 0x00000008L
165 #define D3DPTFILTERCAPS_LINEARMIPNEAREST 0x00000010L
166 #define D3DPTFILTERCAPS_LINEARMIPLINEAR 0x00000020L
168 /* D3DPRIMCAPS dwTextureBlendCaps */
170 #define D3DPTBLENDCAPS_DECAL 0x00000001L
171 #define D3DPTBLENDCAPS_MODULATE 0x00000002L
172 #define D3DPTBLENDCAPS_DECALALPHA 0x00000004L
173 #define D3DPTBLENDCAPS_MODULATEALPHA 0x00000008L
174 #define D3DPTBLENDCAPS_DECALMASK 0x00000010L
175 #define D3DPTBLENDCAPS_MODULATEMASK 0x00000020L
176 #define D3DPTBLENDCAPS_COPY 0x00000040L
177 #define D3DPTBLENDCAPS_ADD 0x00000080L
179 /* D3DPRIMCAPS dwTextureAddressCaps */
180 #define D3DPTADDRESSCAPS_WRAP 0x00000001L
181 #define D3DPTADDRESSCAPS_MIRROR 0x00000002L
182 #define D3DPTADDRESSCAPS_CLAMP 0x00000004L
183 #define D3DPTADDRESSCAPS_BORDER 0x00000008L
184 #define D3DPTADDRESSCAPS_INDEPENDENTUV 0x00000010L
187 * Description for a device.
188 * This is used to describe a device that is to be created or to query
189 * the current device.
191 typedef struct _D3DDeviceDesc {
192 DWORD dwSize; /* Size of D3DDEVICEDESC structure */
193 DWORD dwFlags; /* Indicates which fields have valid data */
194 D3DCOLORMODEL dcmColorModel; /* Color model of device */
195 DWORD dwDevCaps; /* Capabilities of device */
196 D3DTRANSFORMCAPS dtcTransformCaps; /* Capabilities of transform */
197 BOOL bClipping; /* Device can do 3D clipping */
198 D3DLIGHTINGCAPS dlcLightingCaps; /* Capabilities of lighting */
199 D3DPRIMCAPS dpcLineCaps;
200 D3DPRIMCAPS dpcTriCaps;
201 DWORD dwDeviceRenderBitDepth; /* One of DDBB_8, 16, etc.. */
202 DWORD dwDeviceZBufferBitDepth;/* One of DDBD_16, 32, etc.. */
203 DWORD dwMaxBufferSize; /* Maximum execute buffer size */
204 DWORD dwMaxVertexCount; /* Maximum vertex count */
205 // *** New fields for DX5 *** //
207 // Width and height caps are 0 for legacy HALs.
208 DWORD dwMinTextureWidth, dwMinTextureHeight;
209 DWORD dwMaxTextureWidth, dwMaxTextureHeight;
210 DWORD dwMinStippleWidth, dwMaxStippleWidth;
211 DWORD dwMinStippleHeight, dwMaxStippleHeight;
212 } D3DDEVICEDESC, *LPD3DDEVICEDESC;
214 #define D3DDEVICEDESCSIZE (sizeof(D3DDEVICEDESC))
216 typedef HRESULT (FAR PASCAL * LPD3DENUMDEVICESCALLBACK)(LPGUID lpGuid, LPSTR lpDeviceDescription, LPSTR lpDeviceName, LPD3DDEVICEDESC, LPD3DDEVICEDESC, LPVOID);
218 /* D3DDEVICEDESC dwFlags indicating valid fields */
220 #define D3DDD_COLORMODEL 0x00000001L /* dcmColorModel is valid */
221 #define D3DDD_DEVCAPS 0x00000002L /* dwDevCaps is valid */
222 #define D3DDD_TRANSFORMCAPS 0x00000004L /* dtcTransformCaps is valid */
223 #define D3DDD_LIGHTINGCAPS 0x00000008L /* dlcLightingCaps is valid */
224 #define D3DDD_BCLIPPING 0x00000010L /* bClipping is valid */
225 #define D3DDD_LINECAPS 0x00000020L /* dpcLineCaps is valid */
226 #define D3DDD_TRICAPS 0x00000040L /* dpcTriCaps is valid */
227 #define D3DDD_DEVICERENDERBITDEPTH 0x00000080L /* dwDeviceRenderBitDepth is valid */
228 #define D3DDD_DEVICEZBUFFERBITDEPTH 0x00000100L /* dwDeviceZBufferBitDepth is valid */
229 #define D3DDD_MAXBUFFERSIZE 0x00000200L /* dwMaxBufferSize is valid */
230 #define D3DDD_MAXVERTEXCOUNT 0x00000400L /* dwMaxVertexCount is valid */
232 /* D3DDEVICEDESC dwDevCaps flags */
234 #define D3DDEVCAPS_FLOATTLVERTEX 0x00000001L /* Device accepts floating point */
235 /* for post-transform vertex data */
236 #define D3DDEVCAPS_SORTINCREASINGZ 0x00000002L /* Device needs data sorted for increasing Z*/
237 #define D3DDEVCAPS_SORTDECREASINGZ 0X00000004L /* Device needs data sorted for decreasing Z*/
238 #define D3DDEVCAPS_SORTEXACT 0x00000008L /* Device needs data sorted exactly */
240 #define D3DDEVCAPS_EXECUTESYSTEMMEMORY 0x00000010L /* Device can use execute buffers from system memory */
241 #define D3DDEVCAPS_EXECUTEVIDEOMEMORY 0x00000020L /* Device can use execute buffers from video memory */
242 #define D3DDEVCAPS_TLVERTEXSYSTEMMEMORY 0x00000040L /* Device can use TL buffers from system memory */
243 #define D3DDEVCAPS_TLVERTEXVIDEOMEMORY 0x00000080L /* Device can use TL buffers from video memory */
244 #define D3DDEVCAPS_TEXTURESYSTEMMEMORY 0x00000100L /* Device can texture from system memory */
245 #define D3DDEVCAPS_TEXTUREVIDEOMEMORY 0x00000200L /* Device can texture from device memory */
246 #define D3DDEVCAPS_DRAWPRIMTLVERTEX 0x00000400L /* Device can draw TLVERTEX primitives */
247 #define D3DDEVCAPS_CANRENDERAFTERFLIP 0x00000800L /* Device can render without waiting for flip to complete */
248 #define D3DDEVCAPS_TEXTURENONLOCALVIDMEM 0x00001000L /* Device can texture from nonlocal video memory */
250 #define D3DFDS_COLORMODEL 0x00000001L /* Match color model */
251 #define D3DFDS_GUID 0x00000002L /* Match guid */
252 #define D3DFDS_HARDWARE 0x00000004L /* Match hardware/software */
253 #define D3DFDS_TRIANGLES 0x00000008L /* Match in triCaps */
254 #define D3DFDS_LINES 0x00000010L /* Match in lineCaps */
255 #define D3DFDS_MISCCAPS 0x00000020L /* Match primCaps.dwMiscCaps */
256 #define D3DFDS_RASTERCAPS 0x00000040L /* Match primCaps.dwRasterCaps */
257 #define D3DFDS_ZCMPCAPS 0x00000080L /* Match primCaps.dwZCmpCaps */
258 #define D3DFDS_ALPHACMPCAPS 0x00000100L /* Match primCaps.dwAlphaCmpCaps */
259 #define D3DFDS_SRCBLENDCAPS 0x00000200L /* Match primCaps.dwSourceBlendCaps */
260 #define D3DFDS_DSTBLENDCAPS 0x00000400L /* Match primCaps.dwDestBlendCaps */
261 #define D3DFDS_SHADECAPS 0x00000800L /* Match primCaps.dwShadeCaps */
262 #define D3DFDS_TEXTURECAPS 0x00001000L /* Match primCaps.dwTextureCaps */
263 #define D3DFDS_TEXTUREFILTERCAPS 0x00002000L /* Match primCaps.dwTextureFilterCaps */
264 #define D3DFDS_TEXTUREBLENDCAPS 0x00004000L /* Match primCaps.dwTextureBlendCaps */
265 #define D3DFDS_TEXTUREADDRESSCAPS 0x00008000L /* Match primCaps.dwTextureBlendCaps */
268 * FindDevice arguments
270 typedef struct _D3DFINDDEVICESEARCH {
274 D3DCOLORMODEL dcmColorModel;
277 D3DPRIMCAPS dpcPrimCaps;
278 } D3DFINDDEVICESEARCH, *LPD3DFINDDEVICESEARCH;
280 typedef struct _D3DFINDDEVICERESULT {
282 GUID guid; /* guid which matched */
283 D3DDEVICEDESC ddHwDesc; /* hardware D3DDEVICEDESC */
284 D3DDEVICEDESC ddSwDesc; /* software D3DDEVICEDESC */
285 } D3DFINDDEVICERESULT, *LPD3DFINDDEVICERESULT;
289 * Description of execute buffer.
291 typedef struct _D3DExecuteBufferDesc {
292 DWORD dwSize; /* size of this structure */
293 DWORD dwFlags; /* flags indicating which fields are valid */
294 DWORD dwCaps; /* capabilities of execute buffer */
295 DWORD dwBufferSize; /* size of execute buffer data */
296 LPVOID lpData; /* pointer to actual data */
297 } D3DEXECUTEBUFFERDESC, *LPD3DEXECUTEBUFFERDESC;
299 /* D3DEXECUTEBUFFER dwFlags indicating valid fields */
301 #define D3DDEB_BUFSIZE 0x00000001l /* buffer size valid */
302 #define D3DDEB_CAPS 0x00000002l /* caps valid */
303 #define D3DDEB_LPDATA 0x00000004l /* lpData valid */
305 /* D3DEXECUTEBUFFER dwCaps */
307 #define D3DDEBCAPS_SYSTEMMEMORY 0x00000001l /* buffer in system memory */
308 #define D3DDEBCAPS_VIDEOMEMORY 0x00000002l /* buffer in device memory */
309 #define D3DDEBCAPS_MEM (D3DDEBCAPS_SYSTEMMEMORY|D3DDEBCAPS_VIDEOMEMORY)
313 #endif /* _D3DCAPS_H_ */