Home | History | Annotate | Download | only in Direct3D
      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