1 /*==========================================================================;
2  *
3  *  Copyright (C) Microsoft Corporation.  All Rights Reserved.
4  *
5  *  File:       d3d8caps.h
6  *  Content:    Direct3D capabilities include file
7  *
8  ***************************************************************************/
9 
10 #ifndef _D3D8CAPS_H
11 #define _D3D8CAPS_H
12 
13 #ifndef DIRECT3D_VERSION
14 #define DIRECT3D_VERSION         0x0800
15 #endif  //DIRECT3D_VERSION
16 
17 // include this file content only if compiling for DX8 interfaces
18 #if(DIRECT3D_VERSION >= 0x0800)
19 
20 #if defined(_X86_) || defined(_IA64_)
21 #pragma pack(4)
22 #endif
23 
24 typedef struct _D3DCAPS8
25 {
26     /* Device Info */
27     D3DDEVTYPE  DeviceType;
28     UINT    AdapterOrdinal;
29 
30     /* Caps from DX7 Draw */
31     DWORD   Caps;
32     DWORD   Caps2;
33     DWORD   Caps3;
34     DWORD   PresentationIntervals;
35 
36     /* Cursor Caps */
37     DWORD   CursorCaps;
38 
39     /* 3D Device Caps */
40     DWORD   DevCaps;
41 
42     DWORD   PrimitiveMiscCaps;
43     DWORD   RasterCaps;
44     DWORD   ZCmpCaps;
45     DWORD   SrcBlendCaps;
46     DWORD   DestBlendCaps;
47     DWORD   AlphaCmpCaps;
48     DWORD   ShadeCaps;
49     DWORD   TextureCaps;
50     DWORD   TextureFilterCaps;          // D3DPTFILTERCAPS for IDirect3DTexture8's
51     DWORD   CubeTextureFilterCaps;      // D3DPTFILTERCAPS for IDirect3DCubeTexture8's
52     DWORD   VolumeTextureFilterCaps;    // D3DPTFILTERCAPS for IDirect3DVolumeTexture8's
53     DWORD   TextureAddressCaps;         // D3DPTADDRESSCAPS for IDirect3DTexture8's
54     DWORD   VolumeTextureAddressCaps;   // D3DPTADDRESSCAPS for IDirect3DVolumeTexture8's
55 
56     DWORD   LineCaps;                   // D3DLINECAPS
57 
58     DWORD   MaxTextureWidth, MaxTextureHeight;
59     DWORD   MaxVolumeExtent;
60 
61     DWORD   MaxTextureRepeat;
62     DWORD   MaxTextureAspectRatio;
63     DWORD   MaxAnisotropy;
64     float   MaxVertexW;
65 
66     float   GuardBandLeft;
67     float   GuardBandTop;
68     float   GuardBandRight;
69     float   GuardBandBottom;
70 
71     float   ExtentsAdjust;
72     DWORD   StencilCaps;
73 
74     DWORD   FVFCaps;
75     DWORD   TextureOpCaps;
76     DWORD   MaxTextureBlendStages;
77     DWORD   MaxSimultaneousTextures;
78 
79     DWORD   VertexProcessingCaps;
80     DWORD   MaxActiveLights;
81     DWORD   MaxUserClipPlanes;
82     DWORD   MaxVertexBlendMatrices;
83     DWORD   MaxVertexBlendMatrixIndex;
84 
85     float   MaxPointSize;
86 
87     DWORD   MaxPrimitiveCount;          // max number of primitives per DrawPrimitive call
88     DWORD   MaxVertexIndex;
89     DWORD   MaxStreams;
90     DWORD   MaxStreamStride;            // max stride for SetStreamSource
91 
92     DWORD   VertexShaderVersion;
93     DWORD   MaxVertexShaderConst;       // number of vertex shader constant registers
94 
95     DWORD   PixelShaderVersion;
96     float   MaxPixelShaderValue;        // max value of pixel shader arithmetic component
97 
98 } D3DCAPS8;
99 
100 //
101 // BIT DEFINES FOR D3DCAPS8 DWORD MEMBERS
102 //
103 
104 //
105 // Caps
106 //
107 #define D3DCAPS_READ_SCANLINE           0x00020000L
108 
109 //
110 // Caps2
111 //
112 #define D3DCAPS2_NO2DDURING3DSCENE      0x00000002L
113 #define D3DCAPS2_FULLSCREENGAMMA        0x00020000L
114 #define D3DCAPS2_CANRENDERWINDOWED      0x00080000L
115 #define D3DCAPS2_CANCALIBRATEGAMMA      0x00100000L
116 #define D3DCAPS2_RESERVED               0x02000000L
117 #define D3DCAPS2_CANMANAGERESOURCE      0x10000000L
118 #define D3DCAPS2_DYNAMICTEXTURES        0x20000000L
119 
120 //
121 // Caps3
122 //
123 #define D3DCAPS3_RESERVED               0x8000001fL
124 
125 // Indicates that the device can respect the ALPHABLENDENABLE render state
126 // when fullscreen while using the FLIP or DISCARD swap effect.
127 // COPY and COPYVSYNC swap effects work whether or not this flag is set.
128 #define D3DCAPS3_ALPHA_FULLSCREEN_FLIP_OR_DISCARD   0x00000020L
129 
130 //
131 // PresentationIntervals
132 //
133 #define D3DPRESENT_INTERVAL_DEFAULT     0x00000000L
134 #define D3DPRESENT_INTERVAL_ONE         0x00000001L
135 #define D3DPRESENT_INTERVAL_TWO         0x00000002L
136 #define D3DPRESENT_INTERVAL_THREE       0x00000004L
137 #define D3DPRESENT_INTERVAL_FOUR        0x00000008L
138 #define D3DPRESENT_INTERVAL_IMMEDIATE   0x80000000L
139 
140 //
141 // CursorCaps
142 //
143 // Driver supports HW color cursor in at least hi-res modes(height >=400)
144 #define D3DCURSORCAPS_COLOR             0x00000001L
145 // Driver supports HW cursor also in low-res modes(height < 400)
146 #define D3DCURSORCAPS_LOWRES            0x00000002L
147 
148 //
149 // DevCaps
150 //
151 #define D3DDEVCAPS_EXECUTESYSTEMMEMORY  0x00000010L /* Device can use execute buffers from system memory */
152 #define D3DDEVCAPS_EXECUTEVIDEOMEMORY   0x00000020L /* Device can use execute buffers from video memory */
153 #define D3DDEVCAPS_TLVERTEXSYSTEMMEMORY 0x00000040L /* Device can use TL buffers from system memory */
154 #define D3DDEVCAPS_TLVERTEXVIDEOMEMORY  0x00000080L /* Device can use TL buffers from video memory */
155 #define D3DDEVCAPS_TEXTURESYSTEMMEMORY  0x00000100L /* Device can texture from system memory */
156 #define D3DDEVCAPS_TEXTUREVIDEOMEMORY   0x00000200L /* Device can texture from device memory */
157 #define D3DDEVCAPS_DRAWPRIMTLVERTEX     0x00000400L /* Device can draw TLVERTEX primitives */
158 #define D3DDEVCAPS_CANRENDERAFTERFLIP   0x00000800L /* Device can render without waiting for flip to complete */
159 #define D3DDEVCAPS_TEXTURENONLOCALVIDMEM 0x00001000L /* Device can texture from nonlocal video memory */
160 #define D3DDEVCAPS_DRAWPRIMITIVES2      0x00002000L /* Device can support DrawPrimitives2 */
161 #define D3DDEVCAPS_SEPARATETEXTUREMEMORIES 0x00004000L /* Device is texturing from separate memory pools */
162 #define D3DDEVCAPS_DRAWPRIMITIVES2EX    0x00008000L /* Device can support Extended DrawPrimitives2 i.e. DX7 compliant driver*/
163 #define D3DDEVCAPS_HWTRANSFORMANDLIGHT  0x00010000L /* Device can support transformation and lighting in hardware and DRAWPRIMITIVES2EX must be also */
164 #define D3DDEVCAPS_CANBLTSYSTONONLOCAL  0x00020000L /* Device supports a Tex Blt from system memory to non-local vidmem */
165 #define D3DDEVCAPS_HWRASTERIZATION      0x00080000L /* Device has HW acceleration for rasterization */
166 #define D3DDEVCAPS_PUREDEVICE           0x00100000L /* Device supports D3DCREATE_PUREDEVICE */
167 #define D3DDEVCAPS_QUINTICRTPATCHES     0x00200000L /* Device supports quintic Beziers and BSplines */
168 #define D3DDEVCAPS_RTPATCHES            0x00400000L /* Device supports Rect and Tri patches */
169 #define D3DDEVCAPS_RTPATCHHANDLEZERO    0x00800000L /* Indicates that RT Patches may be drawn efficiently using handle 0 */
170 #define D3DDEVCAPS_NPATCHES             0x01000000L /* Device supports N-Patches */
171 
172 //
173 // PrimitiveMiscCaps
174 //
175 #define D3DPMISCCAPS_MASKZ              0x00000002L
176 #define D3DPMISCCAPS_LINEPATTERNREP     0x00000004L
177 #define D3DPMISCCAPS_CULLNONE           0x00000010L
178 #define D3DPMISCCAPS_CULLCW             0x00000020L
179 #define D3DPMISCCAPS_CULLCCW            0x00000040L
180 #define D3DPMISCCAPS_COLORWRITEENABLE   0x00000080L
181 #define D3DPMISCCAPS_CLIPPLANESCALEDPOINTS 0x00000100L /* Device correctly clips scaled points to clip planes */
182 #define D3DPMISCCAPS_CLIPTLVERTS        0x00000200L /* device will clip post-transformed vertex primitives */
183 #define D3DPMISCCAPS_TSSARGTEMP         0x00000400L /* device supports D3DTA_TEMP for temporary register */
184 #define D3DPMISCCAPS_BLENDOP            0x00000800L /* device supports D3DRS_BLENDOP */
185 #define D3DPMISCCAPS_NULLREFERENCE      0x00001000L /* Reference Device that doesnt render */
186 
187 //
188 // LineCaps
189 //
190 #define D3DLINECAPS_TEXTURE             0x00000001L
191 #define D3DLINECAPS_ZTEST               0x00000002L
192 #define D3DLINECAPS_BLEND               0x00000004L
193 #define D3DLINECAPS_ALPHACMP            0x00000008L
194 #define D3DLINECAPS_FOG                 0x00000010L
195 
196 //
197 // RasterCaps
198 //
199 #define D3DPRASTERCAPS_DITHER           0x00000001L
200 #define D3DPRASTERCAPS_PAT              0x00000008L
201 #define D3DPRASTERCAPS_ZTEST            0x00000010L
202 #define D3DPRASTERCAPS_FOGVERTEX        0x00000080L
203 #define D3DPRASTERCAPS_FOGTABLE         0x00000100L
204 #define D3DPRASTERCAPS_ANTIALIASEDGES   0x00001000L
205 #define D3DPRASTERCAPS_MIPMAPLODBIAS    0x00002000L
206 #define D3DPRASTERCAPS_ZBIAS            0x00004000L
207 #define D3DPRASTERCAPS_ZBUFFERLESSHSR   0x00008000L
208 #define D3DPRASTERCAPS_FOGRANGE         0x00010000L
209 #define D3DPRASTERCAPS_ANISOTROPY       0x00020000L
210 #define D3DPRASTERCAPS_WBUFFER          0x00040000L
211 #define D3DPRASTERCAPS_WFOG             0x00100000L
212 #define D3DPRASTERCAPS_ZFOG             0x00200000L
213 #define D3DPRASTERCAPS_COLORPERSPECTIVE 0x00400000L /* Device iterates colors perspective correct */
214 #define D3DPRASTERCAPS_STRETCHBLTMULTISAMPLE  0x00800000L
215 
216 //
217 // ZCmpCaps, AlphaCmpCaps
218 //
219 #define D3DPCMPCAPS_NEVER               0x00000001L
220 #define D3DPCMPCAPS_LESS                0x00000002L
221 #define D3DPCMPCAPS_EQUAL               0x00000004L
222 #define D3DPCMPCAPS_LESSEQUAL           0x00000008L
223 #define D3DPCMPCAPS_GREATER             0x00000010L
224 #define D3DPCMPCAPS_NOTEQUAL            0x00000020L
225 #define D3DPCMPCAPS_GREATEREQUAL        0x00000040L
226 #define D3DPCMPCAPS_ALWAYS              0x00000080L
227 
228 //
229 // SourceBlendCaps, DestBlendCaps
230 //
231 #define D3DPBLENDCAPS_ZERO              0x00000001L
232 #define D3DPBLENDCAPS_ONE               0x00000002L
233 #define D3DPBLENDCAPS_SRCCOLOR          0x00000004L
234 #define D3DPBLENDCAPS_INVSRCCOLOR       0x00000008L
235 #define D3DPBLENDCAPS_SRCALPHA          0x00000010L
236 #define D3DPBLENDCAPS_INVSRCALPHA       0x00000020L
237 #define D3DPBLENDCAPS_DESTALPHA         0x00000040L
238 #define D3DPBLENDCAPS_INVDESTALPHA      0x00000080L
239 #define D3DPBLENDCAPS_DESTCOLOR         0x00000100L
240 #define D3DPBLENDCAPS_INVDESTCOLOR      0x00000200L
241 #define D3DPBLENDCAPS_SRCALPHASAT       0x00000400L
242 #define D3DPBLENDCAPS_BOTHSRCALPHA      0x00000800L
243 #define D3DPBLENDCAPS_BOTHINVSRCALPHA   0x00001000L
244 
245 //
246 // ShadeCaps
247 //
248 #define D3DPSHADECAPS_COLORGOURAUDRGB       0x00000008L
249 #define D3DPSHADECAPS_SPECULARGOURAUDRGB    0x00000200L
250 #define D3DPSHADECAPS_ALPHAGOURAUDBLEND     0x00004000L
251 #define D3DPSHADECAPS_FOGGOURAUD            0x00080000L
252 
253 //
254 // TextureCaps
255 //
256 #define D3DPTEXTURECAPS_PERSPECTIVE         0x00000001L /* Perspective-correct texturing is supported */
257 #define D3DPTEXTURECAPS_POW2                0x00000002L /* Power-of-2 texture dimensions are required - applies to non-Cube/Volume textures only. */
258 #define D3DPTEXTURECAPS_ALPHA               0x00000004L /* Alpha in texture pixels is supported */
259 #define D3DPTEXTURECAPS_SQUAREONLY          0x00000020L /* Only square textures are supported */
260 #define D3DPTEXTURECAPS_TEXREPEATNOTSCALEDBYSIZE 0x00000040L /* Texture indices are not scaled by the texture size prior to interpolation */
261 #define D3DPTEXTURECAPS_ALPHAPALETTE        0x00000080L /* Device can draw alpha from texture palettes */
262 // Device can use non-POW2 textures if:
263 //  1) D3DTEXTURE_ADDRESS is set to CLAMP for this texture's stage
264 //  2) D3DRS_WRAP(N) is zero for this texture's coordinates
265 //  3) mip mapping is not enabled (use magnification filter only)
266 #define D3DPTEXTURECAPS_NONPOW2CONDITIONAL  0x00000100L
267 #define D3DPTEXTURECAPS_PROJECTED           0x00000400L /* Device can do D3DTTFF_PROJECTED */
268 #define D3DPTEXTURECAPS_CUBEMAP             0x00000800L /* Device can do cubemap textures */
269 #define D3DPTEXTURECAPS_VOLUMEMAP           0x00002000L /* Device can do volume textures */
270 #define D3DPTEXTURECAPS_MIPMAP              0x00004000L /* Device can do mipmapped textures */
271 #define D3DPTEXTURECAPS_MIPVOLUMEMAP        0x00008000L /* Device can do mipmapped volume textures */
272 #define D3DPTEXTURECAPS_MIPCUBEMAP          0x00010000L /* Device can do mipmapped cube maps */
273 #define D3DPTEXTURECAPS_CUBEMAP_POW2        0x00020000L /* Device requires that cubemaps be power-of-2 dimension */
274 #define D3DPTEXTURECAPS_VOLUMEMAP_POW2      0x00040000L /* Device requires that volume maps be power-of-2 dimension */
275 
276 //
277 // TextureFilterCaps
278 //
279 #define D3DPTFILTERCAPS_MINFPOINT           0x00000100L /* Min Filter */
280 #define D3DPTFILTERCAPS_MINFLINEAR          0x00000200L
281 #define D3DPTFILTERCAPS_MINFANISOTROPIC     0x00000400L
282 #define D3DPTFILTERCAPS_MIPFPOINT           0x00010000L /* Mip Filter */
283 #define D3DPTFILTERCAPS_MIPFLINEAR          0x00020000L
284 #define D3DPTFILTERCAPS_MAGFPOINT           0x01000000L /* Mag Filter */
285 #define D3DPTFILTERCAPS_MAGFLINEAR          0x02000000L
286 #define D3DPTFILTERCAPS_MAGFANISOTROPIC     0x04000000L
287 #define D3DPTFILTERCAPS_MAGFAFLATCUBIC      0x08000000L
288 #define D3DPTFILTERCAPS_MAGFGAUSSIANCUBIC   0x10000000L
289 
290 //
291 // TextureAddressCaps
292 //
293 #define D3DPTADDRESSCAPS_WRAP           0x00000001L
294 #define D3DPTADDRESSCAPS_MIRROR         0x00000002L
295 #define D3DPTADDRESSCAPS_CLAMP          0x00000004L
296 #define D3DPTADDRESSCAPS_BORDER         0x00000008L
297 #define D3DPTADDRESSCAPS_INDEPENDENTUV  0x00000010L
298 #define D3DPTADDRESSCAPS_MIRRORONCE     0x00000020L
299 
300 //
301 // StencilCaps
302 //
303 #define D3DSTENCILCAPS_KEEP             0x00000001L
304 #define D3DSTENCILCAPS_ZERO             0x00000002L
305 #define D3DSTENCILCAPS_REPLACE          0x00000004L
306 #define D3DSTENCILCAPS_INCRSAT          0x00000008L
307 #define D3DSTENCILCAPS_DECRSAT          0x00000010L
308 #define D3DSTENCILCAPS_INVERT           0x00000020L
309 #define D3DSTENCILCAPS_INCR             0x00000040L
310 #define D3DSTENCILCAPS_DECR             0x00000080L
311 
312 //
313 // TextureOpCaps
314 //
315 #define D3DTEXOPCAPS_DISABLE                    0x00000001L
316 #define D3DTEXOPCAPS_SELECTARG1                 0x00000002L
317 #define D3DTEXOPCAPS_SELECTARG2                 0x00000004L
318 #define D3DTEXOPCAPS_MODULATE                   0x00000008L
319 #define D3DTEXOPCAPS_MODULATE2X                 0x00000010L
320 #define D3DTEXOPCAPS_MODULATE4X                 0x00000020L
321 #define D3DTEXOPCAPS_ADD                        0x00000040L
322 #define D3DTEXOPCAPS_ADDSIGNED                  0x00000080L
323 #define D3DTEXOPCAPS_ADDSIGNED2X                0x00000100L
324 #define D3DTEXOPCAPS_SUBTRACT                   0x00000200L
325 #define D3DTEXOPCAPS_ADDSMOOTH                  0x00000400L
326 #define D3DTEXOPCAPS_BLENDDIFFUSEALPHA          0x00000800L
327 #define D3DTEXOPCAPS_BLENDTEXTUREALPHA          0x00001000L
328 #define D3DTEXOPCAPS_BLENDFACTORALPHA           0x00002000L
329 #define D3DTEXOPCAPS_BLENDTEXTUREALPHAPM        0x00004000L
330 #define D3DTEXOPCAPS_BLENDCURRENTALPHA          0x00008000L
331 #define D3DTEXOPCAPS_PREMODULATE                0x00010000L
332 #define D3DTEXOPCAPS_MODULATEALPHA_ADDCOLOR     0x00020000L
333 #define D3DTEXOPCAPS_MODULATECOLOR_ADDALPHA     0x00040000L
334 #define D3DTEXOPCAPS_MODULATEINVALPHA_ADDCOLOR  0x00080000L
335 #define D3DTEXOPCAPS_MODULATEINVCOLOR_ADDALPHA  0x00100000L
336 #define D3DTEXOPCAPS_BUMPENVMAP                 0x00200000L
337 #define D3DTEXOPCAPS_BUMPENVMAPLUMINANCE        0x00400000L
338 #define D3DTEXOPCAPS_DOTPRODUCT3                0x00800000L
339 #define D3DTEXOPCAPS_MULTIPLYADD                0x01000000L
340 #define D3DTEXOPCAPS_LERP                       0x02000000L
341 
342 //
343 // FVFCaps
344 //
345 #define D3DFVFCAPS_TEXCOORDCOUNTMASK    0x0000ffffL /* mask for texture coordinate count field */
346 #define D3DFVFCAPS_DONOTSTRIPELEMENTS   0x00080000L /* Device prefers that vertex elements not be stripped */
347 #define D3DFVFCAPS_PSIZE                0x00100000L /* Device can receive point size */
348 
349 //
350 // VertexProcessingCaps
351 //
352 #define D3DVTXPCAPS_TEXGEN              0x00000001L /* device can do texgen */
353 #define D3DVTXPCAPS_MATERIALSOURCE7     0x00000002L /* device can do DX7-level colormaterialsource ops */
354 #define D3DVTXPCAPS_DIRECTIONALLIGHTS   0x00000008L /* device can do directional lights */
355 #define D3DVTXPCAPS_POSITIONALLIGHTS    0x00000010L /* device can do positional lights (includes point and spot) */
356 #define D3DVTXPCAPS_LOCALVIEWER         0x00000020L /* device can do local viewer */
357 #define D3DVTXPCAPS_TWEENING            0x00000040L /* device can do vertex tweening */
358 #define D3DVTXPCAPS_NO_VSDT_UBYTE4      0x00000080L /* device does not support D3DVSDT_UBYTE4 */
359 
360 #pragma pack()
361 
362 #endif /* (DIRECT3D_VERSION >= 0x0800) */
363 #endif /* _D3D8CAPS_H_ */
364 
365