Platform SDK: DirectX

CONST_DDSURFACECAPS2FLAGS

The CONST_DDSURFACECAPS2FLAGS enumeration is used by the lCaps2 member of the DDSCAPS2 type to describe additional surface capabilities.

Enum CONST_DDSURFACECAPS2FLAGS
    DDSCAPS2_CUBEMAP             = 512
    DDSCAPS2_CUBEMAP_ALLFACES    = 65024
    DDSCAPS2_CUBEMAP_NEGATIVEX   = 2048
    DDSCAPS2_CUBEMAP_NEGATIVEY   = 8192
    DDSCAPS2_CUBEMAP_NEGATIVEZ   = 32768
    DDSCAPS2_CUBEMAP_POSITIVEX   = 1024
    DDSCAPS2_CUBEMAP_POSITIVEY   = 4096
    DDSCAPS2_CUBEMAP_POSITIVEZ   = 16384
    DDSCAPS2_D3DTEXTUREMANAGE    = 131072
    DDSCAPS2_HARDWAREDEINTERLACE = 2
    DDSCAPS2_HINTANTIALIASING    = 256
    DDSCAPS2_HINTDYNAMIC         = 4
    DDSCAPS2_HINTSTATIC          = 8
    DDSCAPS2_MIPMAPSUBLEVEL      = 65536
    DDSCAPS2_OPAQUE              = 128
    DDSCAPS2_STEREOSURFACELEFT   = 524288 
    DDSCAPS2_TEXTUREMANAGE       = 16
End Enum

Capability flags
DDSCAPS2_CUBEMAP: New for DirectX 7.0. This surface is a cubic environment map.
DDSCAPS2_CUBEMAP_ALLFACES: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create all six faces of a cubic environment map.
DDSCAPS2_CUBEMAP_NEGATIVEX: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the negative X face of a cubic environment map.
DDSCAPS2_CUBEMAP_NEGATIVEY: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the negative Y face of a cubic environment map.
DDSCAPS2_CUBEMAP_NEGATIVEZ: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the negative Z face of a cubic environment map.
DDSCAPS2_CUBEMAP_POSITIVEX: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the positive X face of a cubic environment map.
DDSCAPS2_CUBEMAP_POSITIVEY: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the positive Y face of a cubic environment map.
DDSCAPS2_CUBEMAP_POSITIVEZ: New for DirectX 7.0. This flag is used with the DDSCAPS2_CUBEMAP flag to create the positive Z face of a cubic environment map.
DDSCAPS2_D3DTEXTUREMANAGE: New for DirectX 7.0. The texture is always managed by Direct3D.
DDSCAPS2_HARDWAREDEINTERLACE: This surface receives data from a video port using the de-interlacing hardware. This allows the driver to allocate memory for any extra buffers that might be required. The DDSCAPS_VIDEOPORT and DDSCAPS_OVERLAY flags must also be set.
DDSCAPS2_HINTANTIALIASING: The application intends to use antialiasing. Only valid if DDSCAPS_3DDEVICE is also set.
DDSCAPS2_HINTDYNAMIC: Indicates to the driver that this surface is locked very frequently (for procedural textures, dynamic lightmaps, and so on). This flag can only be used for texture surfaces (the DDSCAPS_TEXTURE flag set in the lCaps2 member). This flag cannot be used with the DDSCAPS2_HINTSTATIC or DDSCAPS2_OPAQUE flags.
DDSCAPS2_HINTSTATIC: Indicates to the driver that this surface can be reordered or retiled on load. This operation does not change the size of the texture. It is relatively fast and symmetrical, since the application can lock these bits (although it degrades performance when doing so). This flag can be used only for texture surfaces (the DDSCAPS_TEXTURE flag set in the lCaps2 member). This flag cannot be used with the DDSCAPS2_HINTDYNAMIC or DDSCAPS2_OPAQUE flags.
DDSCAPS2_MIPMAPSUBLEVEL: New for DirectX 7.0. Enables easier use of GetAttachedSurface, rather than EnumAttachedSurfaces, for surface constructs such as cube maps in which there is more than one mipmap surface attached to the root surface. This should be set on all non-top-level surfaces in a mipmapped cubemap so that a call to GetAttachedSurface can distinguish between top-level faces and attached mipmap levels. This capabilities bit is ignored by CreateSurface.
DDSCAPS2_OPAQUE: Indicates to the driver that this surface will never be locked again. The driver is free to optimize this surface by retiling and compression. Such a surface cannot be locked or used in blit operations; attempts to lock or blit a surface with this capability fail. This flag can only be used for texture surfaces (DDSCAPS_TEXTURE flag set in the lCaps2 member). This flag cannot be used with the DDSCAPS2_HINTDYNAMIC or the DDSCAPS2_HINTSTATIC flag.
DDSCAPS2_STEREOSURFACELEFT: New for DirectX 7.0. This surface is part of a stereo flipping chain. When this flag is set during a DirectDraw7.CreateSurface call, a pair of stereo surfaces is created for each buffer in the primary flipping chain. You must create a complex flipping chain (with back-buffers). You cannot create a single set of stereo surfaces. The DirectDrawSurface7.Flip method requires that you have back-buffers (at least four surfaces are created).
In addition, when this flag is set in a DDSURFACEDESC2 type as the result of an DirectDraw7.GetDisplayModesEnum or DirectDraw7.GetDisplayMode call, it indicates support for stereo in that mode.
DDSCAPS2_TEXTUREMANAGE: The client would like this texture surface to be managed by the driver if the driver is capable; otherwise, it is managed by Direct3D Immediate Mode (new in DirectX 7.0). This flag can be used only for texture surfaces (DDSCAPS_TEXTURE flag set in the lCaps2 member). For more information, see Automatic Texture Management in the Direct3D Immediate Mode documentation. Do not use this flag if your application uses Direct3D Retained Mode. Instead, create textures in system memory, and allow Retained Mode to manage them.