#include <d3d9.h>
#include "d3d9_private.h"

Include dependency graph for format.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	D3DFORMAT_OP_DMAP 0x00020000L

#define	D3DFORMAT_OP_NOTEXCOORDWRAPNORMIP 0x01000000L

Functions
BOOL	IsBackBufferFormat (D3DFORMAT Format)

BOOL	IsExtendedFormat (D3DFORMAT Format)

BOOL	IsZBufferFormat (D3DFORMAT Format)

BOOL	IsMultiElementFormat (D3DFORMAT Format)

BOOL	IsSupportedFormatOp (LPD3D9_DRIVERCAPS pDriverCaps, D3DFORMAT DisplayFormat, DWORD FormatOp)

HRESULT	CheckDeviceType (LPD3D9_DRIVERCAPS pDriverCaps, D3DFORMAT DisplayFormat, D3DFORMAT BackBufferFormat, BOOL Windowed)

HRESULT	CheckDeviceFormat (LPD3D9_DRIVERCAPS pDriverCaps, D3DFORMAT AdapterFormat, DWORD Usage, D3DRESOURCETYPE RType, D3DFORMAT CheckFormat)

HRESULT	CheckDeviceFormatConversion (LPD3D9_DRIVERCAPS pDriverCaps, D3DFORMAT SourceFormat, D3DFORMAT TargetFormat)

HRESULT	CheckDepthStencilMatch (LPD3D9_DRIVERCAPS pDriverCaps, D3DFORMAT AdapterFormat, D3DFORMAT RenderTargetFormat, D3DFORMAT DepthStencilFormat)

Macro Definition Documentation

◆ D3DFORMAT_OP_DMAP

#define D3DFORMAT_OP_DMAP 0x00020000L

Definition at line 15 of file format.h.

◆ D3DFORMAT_OP_NOTEXCOORDWRAPNORMIP

#define D3DFORMAT_OP_NOTEXCOORDWRAPNORMIP 0x01000000L

Definition at line 19 of file format.h.

Function Documentation

◆ CheckDepthStencilMatch()

HRESULT CheckDepthStencilMatch	(	LPD3D9_DRIVERCAPS	pDriverCaps,
		D3DFORMAT	AdapterFormat,
		D3DFORMAT	RenderTargetFormat,
		D3DFORMAT	DepthStencilFormat
	)

Definition at line 539 of file format.c.

{
    const DWORD NumFormatOps = pDriverCaps->NumSupportedFormatOps;
    BOOL bRenderTargetAvailable = FALSE;
    BOOL bDepthStencilAvailable = FALSE;
    BOOL bForceSameDepthStencilBits = FALSE;
    DWORD FormatIndex;
 
    if (FALSE == IsSupportedFormatOp(pDriverCaps, AdapterFormat, D3DFORMAT_OP_DISPLAYMODE | D3DFORMAT_OP_3DACCELERATION))
    {
        return D3DERR_NOTAVAILABLE;
    }
 
    if (DepthStencilFormat != D3DFMT_D16_LOCKABLE &&
        DepthStencilFormat != D3DFMT_D32F_LOCKABLE)
    {
        if (TRUE == IsStencilFormat(DepthStencilFormat))
        {
            bForceSameDepthStencilBits = TRUE;
        }
    }
 
    if (FALSE == bForceSameDepthStencilBits &&
        (DepthStencilFormat == D3DFMT_D32 || DepthStencilFormat == D3DFMT_D24X8))
    {
        bForceSameDepthStencilBits = TRUE;
    }
 
    DepthStencilFormat = GetStencilFormat(pDriverCaps, DepthStencilFormat);
 
    /* Observe the multiple conditions */
    for (FormatIndex = 0; FormatIndex < NumFormatOps && (bRenderTargetAvailable == FALSE || bDepthStencilAvailable == FALSE); FormatIndex++)
    {
        const LPDDSURFACEDESC pSurfaceDesc = &pDriverCaps->pSupportedFormatOps[FormatIndex];
        const DWORD FourCC = pSurfaceDesc->ddpfPixelFormat.dwFourCC;
        const DWORD FormatOperations = pSurfaceDesc->ddpfPixelFormat.dwOperations;
 
        if (FALSE == bRenderTargetAvailable &&
            FourCC == RenderTargetFormat &&
            (FormatOperations & D3DFORMAT_OP_SAME_FORMAT_RENDERTARGET) != 0)
        {
            bRenderTargetAvailable = TRUE;
        }
 
        if (FALSE == bDepthStencilAvailable &&
            FourCC == DepthStencilFormat &&
            (FormatOperations & D3DFORMAT_OP_ZSTENCIL) != 0)
        {
            bDepthStencilAvailable = TRUE;
 
            if ((FormatOperations & D3DFORMAT_OP_ZSTENCIL_WITH_ARBITRARY_COLOR_DEPTH) != 0)
            {
                bForceSameDepthStencilBits = FALSE;
            }
        }
    }
 
    if (FALSE == bRenderTargetAvailable || FALSE == bDepthStencilAvailable)
    {
        return D3DERR_INVALIDCALL;
    }
 
    if (TRUE == bForceSameDepthStencilBits)
    {
        if (GetPixelStride(RenderTargetFormat) != GetPixelStride(DepthStencilFormat))
            return D3DERR_NOTAVAILABLE;
    }
 
    return D3D_OK;
}

Referenced by DECLARE_INTERFACE_(), and IDirect3D9Impl_CheckDepthStencilMatch().

◆ CheckDeviceFormat()

HRESULT CheckDeviceFormat	(	LPD3D9_DRIVERCAPS	pDriverCaps,
		D3DFORMAT	AdapterFormat,
		DWORD	Usage,
		D3DRESOURCETYPE	RType,
		D3DFORMAT	CheckFormat
	)

Definition at line 326 of file format.c.

{
    const DWORD NumFormatOps = pDriverCaps->NumSupportedFormatOps;
    DWORD NonCompatibleOperations = 0, MustSupportOperations = 0;
    BOOL bSupportedWithAutogen = FALSE;
    DWORD FormatOpIndex;
 
    if (FALSE == IsSupportedFormatOp(pDriverCaps, AdapterFormat, D3DFORMAT_OP_DISPLAYMODE | D3DFORMAT_OP_3DACCELERATION))
    {
        return D3DERR_NOTAVAILABLE;
    }
 
    /* Check for driver auto generated mip map support if requested */
    if ((Usage & (D3DUSAGE_AUTOGENMIPMAP)) != 0)
    {
        switch (RType)
        {
        case D3DRTYPE_TEXTURE:
            if ((pDriverCaps->DriverCaps9.TextureCaps & D3DPTEXTURECAPS_MIPMAP) == 0)
                return D3DERR_NOTAVAILABLE;
 
            break;
 
        case D3DRTYPE_VOLUME:
        case D3DRTYPE_VOLUMETEXTURE:
            if ((pDriverCaps->DriverCaps9.TextureCaps & D3DPTEXTURECAPS_MIPVOLUMEMAP) == 0)
                return D3DERR_NOTAVAILABLE;
 
            break;
 
        case D3DRTYPE_CUBETEXTURE:
            if ((pDriverCaps->DriverCaps9.TextureCaps & D3DPTEXTURECAPS_MIPCUBEMAP) == 0)
                return D3DERR_NOTAVAILABLE;
 
            break;
 
        default:
            /* Do nothing */
            break;
        }
 
        MustSupportOperations |= D3DFORMAT_OP_AUTOGENMIPMAP;
    }
 
    /* Translate from RType and Usage parameters to FormatOps */
    switch (RType)
    {
    case D3DRTYPE_TEXTURE:
        MustSupportOperations |= D3DFORMAT_OP_TEXTURE;
        break;
 
    case D3DRTYPE_VOLUME:
    case D3DRTYPE_VOLUMETEXTURE:
        MustSupportOperations |= D3DFORMAT_OP_VOLUMETEXTURE;
        break;
 
    case D3DRTYPE_CUBETEXTURE:
        MustSupportOperations |= D3DFORMAT_OP_CUBETEXTURE;
        break;
 
    default:
        /* Do nothing */
        break;
    }
 
    if (Usage == 0 && RType == D3DRTYPE_SURFACE)
    {
        MustSupportOperations |= D3DFORMAT_OP_OFFSCREENPLAIN;
    }
 
    if ((Usage & D3DUSAGE_DEPTHSTENCIL) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_ZSTENCIL;
    }
 
    if ((Usage & D3DUSAGE_DMAP) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_DMAP;
    }
 
    if ((Usage & D3DUSAGE_QUERY_LEGACYBUMPMAP) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_BUMPMAP;
    }
 
    if ((Usage & D3DUSAGE_QUERY_SRGBREAD) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_SRGBREAD;
    }
 
    if ((Usage & D3DUSAGE_QUERY_SRGBWRITE) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_SRGBWRITE;
    }
 
    if ((Usage & D3DUSAGE_QUERY_VERTEXTEXTURE) != 0)
    {
        MustSupportOperations |= D3DFORMAT_OP_VERTEXTEXTURE;
    }
 
    CheckFormat = GetStencilFormat(pDriverCaps, CheckFormat);
 
    if ((Usage & D3DUSAGE_RENDERTARGET) != 0)
    {
        if (AdapterFormat == CheckFormat)
        {
            MustSupportOperations |= D3DFORMAT_OP_SAME_FORMAT_RENDERTARGET;
        }
        else
        {
            D3DFORMAT NonAlphaAdapterFormat;
            D3DFORMAT NonAlphaCheckFormat;
 
            NonAlphaAdapterFormat = RemoveAlphaChannel(AdapterFormat);
            NonAlphaCheckFormat = RemoveAlphaChannel(CheckFormat);
 
            if (NonAlphaAdapterFormat == NonAlphaCheckFormat &&
                NonAlphaCheckFormat != D3DFMT_UNKNOWN)
            {
                MustSupportOperations |= D3DFORMAT_OP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET;
            }
            else
            {
                MustSupportOperations |= D3DFORMAT_OP_OFFSCREEN_RENDERTARGET;
            }
        }
    }
 
    if ((Usage & D3DUSAGE_QUERY_FILTER) != 0)
    {
        NonCompatibleOperations |= D3DFORMAT_OP_OFFSCREENPLAIN;
    }
 
    if ((Usage & D3DUSAGE_QUERY_POSTPIXELSHADER_BLENDING) != 0)
    {
        NonCompatibleOperations |= D3DFORMAT_OP_NOALPHABLEND;
    }
 
    if ((Usage & D3DUSAGE_QUERY_WRAPANDMIP) != 0)
    {
        NonCompatibleOperations |= D3DFORMAT_OP_NOTEXCOORDWRAPNORMIP;
    }
 
    for (FormatOpIndex = 0; FormatOpIndex < NumFormatOps; FormatOpIndex++)
    {
        DWORD dwOperations;
        LPDDSURFACEDESC pSurfaceDesc = &pDriverCaps->pSupportedFormatOps[FormatOpIndex];
 
        if (pSurfaceDesc->ddpfPixelFormat.dwFourCC != CheckFormat)
            continue;
 
        dwOperations = pSurfaceDesc->ddpfPixelFormat.dwOperations;
 
        if ((dwOperations & NonCompatibleOperations) != 0)
            continue;
 
        if ((dwOperations & MustSupportOperations) == MustSupportOperations)
            return D3D_OK;
 
        if (((dwOperations & MustSupportOperations) | D3DFORMAT_OP_AUTOGENMIPMAP) == MustSupportOperations)
            bSupportedWithAutogen = TRUE;
    }
 
    if (TRUE == bSupportedWithAutogen)
        return D3DOK_NOAUTOGEN;
 
    return D3DERR_NOTAVAILABLE;
}

Referenced by DECLARE_INTERFACE_(), and IDirect3D9Impl_CheckDeviceFormat().

◆ CheckDeviceFormatConversion()

HRESULT CheckDeviceFormatConversion	(	LPD3D9_DRIVERCAPS	pDriverCaps,
		D3DFORMAT	SourceFormat,
		D3DFORMAT	TargetFormat
	)

Definition at line 495 of file format.c.

{
    D3DFORMAT NonAlphaSourceFormat;
    D3DFORMAT NonAlphaTargetFormat;
 
    NonAlphaSourceFormat = RemoveAlphaChannel(SourceFormat);
    NonAlphaTargetFormat = RemoveAlphaChannel(TargetFormat);
 
    if (NonAlphaSourceFormat == NonAlphaTargetFormat)
    {
        return D3D_OK;
    }
 
    if (FALSE == IsFourCCFormat(SourceFormat))
    {
        switch (SourceFormat)
        {
        case D3DFMT_A8R8G8B8:
        case D3DFMT_X8R8G8B8:
        case D3DFMT_R5G6B5:
        case D3DFMT_X1R5G5B5:
        case D3DFMT_A1R5G5B5:
        case D3DFMT_A2R10G10B10:
            /* Do nothing, valid SourceFormat */
            break;
 
        default:
            return D3DERR_NOTAVAILABLE;
        }
    }
    else if (pDriverCaps->DriverCaps9.DevCaps2 == 0)
    {
        return D3D_OK;
    }
 
    if (FALSE == IsSupportedFormatOp(pDriverCaps, SourceFormat, D3DFORMAT_OP_CONVERT_TO_ARGB) ||
        FALSE == IsSupportedFormatOp(pDriverCaps, TargetFormat, D3DFORMAT_MEMBEROFGROUP_ARGB))
    {
        return D3DERR_NOTAVAILABLE;
    }
 
    return D3D_OK;
}

Referenced by DECLARE_INTERFACE_(), and IDirect3D9Impl_CheckDeviceFormatConversion().

◆ CheckDeviceType()

HRESULT CheckDeviceType	(	LPD3D9_DRIVERCAPS	pDriverCaps,
		D3DFORMAT	DisplayFormat,
		D3DFORMAT	BackBufferFormat,
		BOOL	Windowed
	)

Definition at line 224 of file format.c.

{
    if (FALSE == IsSupportedFormatOp(pDriverCaps, DisplayFormat, D3DFORMAT_OP_DISPLAYMODE | D3DFORMAT_OP_3DACCELERATION))
    {
        return D3DERR_NOTAVAILABLE;
    }
 
    if (DisplayFormat != BackBufferFormat)
    {
        D3DFORMAT AdjustedDisplayFormat = DisplayFormat;
 
        if (DisplayFormat == D3DFMT_X8R8G8B8)
        {
            DisplayFormat = D3DFMT_A8R8G8B8;
        }
        else if (DisplayFormat == D3DFMT_X1R5G5B5)
        {
            DisplayFormat = D3DFMT_A1R5G5B5;
        }
 
        if (AdjustedDisplayFormat == BackBufferFormat)
        {
            if (FALSE == IsSupportedFormatOp(pDriverCaps, AdjustedDisplayFormat, D3DFORMAT_OP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET))
            {
                return D3DERR_NOTAVAILABLE;
            }
 
            return D3D_OK;
        }
        else if (FALSE == Windowed)
        {
            return D3DERR_NOTAVAILABLE;
        }
 
        if (FALSE == IsSupportedFormatOp(pDriverCaps, BackBufferFormat, D3DFORMAT_OP_OFFSCREEN_RENDERTARGET) ||
            FALSE == IsSupportedFormatOp(pDriverCaps, BackBufferFormat, D3DFORMAT_OP_CONVERT_TO_ARGB) ||
            FALSE == IsSupportedFormatOp(pDriverCaps, BackBufferFormat, D3DFORMAT_MEMBEROFGROUP_ARGB))
        {
            return D3DERR_NOTAVAILABLE;
        }
    }
    else
    {
        if (FALSE == IsSupportedFormatOp(pDriverCaps, DisplayFormat, D3DFORMAT_OP_SAME_FORMAT_RENDERTARGET))
        {
            return D3DERR_NOTAVAILABLE;
        }
    }
 
    return D3D_OK;
}

Referenced by DECLARE_INTERFACE_(), and IDirect3D9Impl_CheckDeviceType().

◆ IsBackBufferFormat()

BOOL IsBackBufferFormat ( D3DFORMAT Format )

Definition at line 14 of file format.c.

{
    return ((Format >= D3DFMT_A8R8G8B8) && (Format < D3DFMT_A1R5G5B5)) ||
            (IsExtendedFormat(Format));
}

Referenced by IDirect3D9Impl_CheckDeviceType().

◆ IsExtendedFormat()

BOOL IsExtendedFormat ( D3DFORMAT Format )

Definition at line 20 of file format.c.

{
    return (Format == D3DFMT_A2R10G10B10);
}

Referenced by IDirect3D9Impl_CheckDeviceType(), and IsBackBufferFormat().

◆ IsMultiElementFormat()

BOOL IsMultiElementFormat ( D3DFORMAT Format )

Definition at line 32 of file format.c.

{
    return (Format == D3DFMT_MULTI2_ARGB8);
}

Referenced by IDirect3D9Impl_CheckDeviceFormat().

◆ IsSupportedFormatOp()

BOOL IsSupportedFormatOp	(	LPD3D9_DRIVERCAPS	pDriverCaps,
		D3DFORMAT	DisplayFormat,
		DWORD	FormatOp
	)

Definition at line 206 of file format.c.

{
    const DWORD NumFormatOps = pDriverCaps->NumSupportedFormatOps;
    DWORD FormatOpIndex;
 
    for (FormatOpIndex = 0; FormatOpIndex < NumFormatOps; FormatOpIndex++)
    {
        const LPDDSURFACEDESC pSurfaceDesc = &pDriverCaps->pSupportedFormatOps[FormatOpIndex];
        if (pSurfaceDesc->ddpfPixelFormat.dwFourCC == DisplayFormat &&
            (pSurfaceDesc->ddpfPixelFormat.dwOperations & FormatOp) == FormatOp)
        {
            return TRUE;
        }
    }
 
    return FALSE;
}

Referenced by CheckDepthStencilMatch(), CheckDeviceFormat(), CheckDeviceFormatConversion(), CheckDeviceType(), and GetStencilFormat().

◆ IsZBufferFormat()

BOOL IsZBufferFormat ( D3DFORMAT Format )

Definition at line 25 of file format.c.

{
    UNIMPLEMENTED
 
    return TRUE;
}