You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
563 lines
17 KiB
563 lines
17 KiB
///////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// Copyright (C) Microsoft Corporation. All Rights Reserved.
|
|
//
|
|
// File: d3dx8core.h
|
|
// Content: D3DX core types and functions
|
|
//
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "d3dx8.h"
|
|
|
|
#ifndef __D3DX8CORE_H__
|
|
#define __D3DX8CORE_H__
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ID3DXBuffer:
|
|
// ------------
|
|
// The buffer object is used by D3DX to return arbitrary size data.
|
|
//
|
|
// GetBufferPointer -
|
|
// Returns a pointer to the beginning of the buffer.
|
|
//
|
|
// GetBufferSize -
|
|
// Returns the size of the buffer, in bytes.
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef interface ID3DXBuffer ID3DXBuffer;
|
|
typedef interface ID3DXBuffer *LPD3DXBUFFER;
|
|
|
|
// {932E6A7E-C68E-45dd-A7BF-53D19C86DB1F}
|
|
DEFINE_GUID(IID_ID3DXBuffer,
|
|
0x932e6a7e, 0xc68e, 0x45dd, 0xa7, 0xbf, 0x53, 0xd1, 0x9c, 0x86, 0xdb, 0x1f);
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE ID3DXBuffer
|
|
|
|
DECLARE_INTERFACE_(ID3DXBuffer, IUnknown)
|
|
{
|
|
// IUnknown
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
|
|
|
// ID3DXBuffer
|
|
STDMETHOD_(LPVOID, GetBufferPointer)(THIS) PURE;
|
|
STDMETHOD_(DWORD, GetBufferSize)(THIS) PURE;
|
|
};
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ID3DXFont:
|
|
// ----------
|
|
// Font objects contain the textures and resources needed to render
|
|
// a specific font on a specific device.
|
|
//
|
|
// Begin -
|
|
// Prepartes device for drawing text. This is optional.. if DrawText
|
|
// is called outside of Begin/End, it will call Begin and End for you.
|
|
//
|
|
// DrawText -
|
|
// Draws formatted text on a D3D device. Some parameters are
|
|
// surprisingly similar to those of GDI's DrawText function. See GDI
|
|
// documentation for a detailed description of these parameters.
|
|
//
|
|
// End -
|
|
// Restores device state to how it was when Begin was called.
|
|
//
|
|
// OnLostDevice, OnResetDevice -
|
|
// Call OnLostDevice() on this object before calling Reset() on the
|
|
// device, so that this object can release any stateblocks and video
|
|
// memory resources. After Reset(), the call OnResetDevice().
|
|
//
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef interface ID3DXFont ID3DXFont;
|
|
typedef interface ID3DXFont *LPD3DXFONT;
|
|
|
|
|
|
// {2D501DF7-D253-4414-865F-A6D54A753138}
|
|
DEFINE_GUID( IID_ID3DXFont,
|
|
0x2d501df7, 0xd253, 0x4414, 0x86, 0x5f, 0xa6, 0xd5, 0x4a, 0x75, 0x31, 0x38);
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE ID3DXFont
|
|
|
|
DECLARE_INTERFACE_(ID3DXFont, IUnknown)
|
|
{
|
|
// IUnknown
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
|
|
|
// ID3DXFont
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
|
STDMETHOD(GetLogFont)(THIS_ LOGFONT* pLogFont) PURE;
|
|
|
|
STDMETHOD(Begin)(THIS) PURE;
|
|
STDMETHOD_(INT, DrawTextA)(THIS_ LPCSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
|
|
STDMETHOD_(INT, DrawTextW)(THIS_ LPCWSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
|
|
STDMETHOD(End)(THIS) PURE;
|
|
|
|
STDMETHOD(OnLostDevice)(THIS) PURE;
|
|
STDMETHOD(OnResetDevice)(THIS) PURE;
|
|
};
|
|
|
|
#ifndef DrawText
|
|
#ifdef UNICODE
|
|
#define DrawText DrawTextW
|
|
#else
|
|
#define DrawText DrawTextA
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
HRESULT WINAPI
|
|
D3DXCreateFont(
|
|
LPDIRECT3DDEVICE8 pDevice,
|
|
HFONT hFont,
|
|
LPD3DXFONT* ppFont);
|
|
|
|
|
|
HRESULT WINAPI
|
|
D3DXCreateFontIndirect(
|
|
LPDIRECT3DDEVICE8 pDevice,
|
|
CONST LOGFONT* pLogFont,
|
|
LPD3DXFONT* ppFont);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ID3DXSprite:
|
|
// ------------
|
|
// This object intends to provide an easy way to drawing sprites using D3D.
|
|
//
|
|
// Begin -
|
|
// Prepares device for drawing sprites
|
|
//
|
|
// Draw, DrawAffine, DrawTransform -
|
|
// Draws a sprite in screen-space. Before transformation, the sprite is
|
|
// the size of SrcRect, with its top-left corner at the origin (0,0).
|
|
// The color and alpha channels are modulated by Color.
|
|
//
|
|
// End -
|
|
// Restores device state to how it was when Begin was called.
|
|
//
|
|
// OnLostDevice, OnResetDevice -
|
|
// Call OnLostDevice() on this object before calling Reset() on the
|
|
// device, so that this object can release any stateblocks and video
|
|
// memory resources. After Reset(), the call OnResetDevice().
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef interface ID3DXSprite ID3DXSprite;
|
|
typedef interface ID3DXSprite *LPD3DXSPRITE;
|
|
|
|
|
|
// {E8691849-87B8-4929-9050-1B0542D5538C}
|
|
DEFINE_GUID( IID_ID3DXSprite,
|
|
0xe8691849, 0x87b8, 0x4929, 0x90, 0x50, 0x1b, 0x5, 0x42, 0xd5, 0x53, 0x8c);
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE ID3DXSprite
|
|
|
|
DECLARE_INTERFACE_(ID3DXSprite, IUnknown)
|
|
{
|
|
// IUnknown
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
|
|
|
// ID3DXSprite
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
|
|
|
STDMETHOD(Begin)(THIS) PURE;
|
|
|
|
STDMETHOD(Draw)(THIS_ LPDIRECT3DTEXTURE8 pSrcTexture,
|
|
CONST RECT* pSrcRect, CONST D3DXVECTOR2* pScaling,
|
|
CONST D3DXVECTOR2* pRotationCenter, FLOAT Rotation,
|
|
CONST D3DXVECTOR2* pTranslation, D3DCOLOR Color) PURE;
|
|
|
|
STDMETHOD(DrawTransform)(THIS_ LPDIRECT3DTEXTURE8 pSrcTexture,
|
|
CONST RECT* pSrcRect, CONST D3DXMATRIX* pTransform,
|
|
D3DCOLOR Color) PURE;
|
|
|
|
STDMETHOD(End)(THIS) PURE;
|
|
|
|
STDMETHOD(OnLostDevice)(THIS) PURE;
|
|
STDMETHOD(OnResetDevice)(THIS) PURE;
|
|
};
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
|
|
HRESULT WINAPI
|
|
D3DXCreateSprite(
|
|
LPDIRECT3DDEVICE8 pDevice,
|
|
LPD3DXSPRITE* ppSprite);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ID3DXRenderToSurface:
|
|
// ---------------------
|
|
// This object abstracts rendering to surfaces. These surfaces do not
|
|
// necessarily need to be render targets. If they are not, a compatible
|
|
// render target is used, and the result copied into surface at end scene.
|
|
//
|
|
// BeginScene, EndScene -
|
|
// Call BeginScene() and EndScene() at the beginning and ending of your
|
|
// scene. These calls will setup and restore render targets, viewports,
|
|
// etc..
|
|
//
|
|
// OnLostDevice, OnResetDevice -
|
|
// Call OnLostDevice() on this object before calling Reset() on the
|
|
// device, so that this object can release any stateblocks and video
|
|
// memory resources. After Reset(), the call OnResetDevice().
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef struct _D3DXRTS_DESC
|
|
{
|
|
UINT Width;
|
|
UINT Height;
|
|
D3DFORMAT Format;
|
|
BOOL DepthStencil;
|
|
D3DFORMAT DepthStencilFormat;
|
|
|
|
} D3DXRTS_DESC;
|
|
|
|
|
|
typedef interface ID3DXRenderToSurface ID3DXRenderToSurface;
|
|
typedef interface ID3DXRenderToSurface *LPD3DXRENDERTOSURFACE;
|
|
|
|
|
|
// {69CC587C-E40C-458d-B5D3-B029E18EB60A}
|
|
DEFINE_GUID( IID_ID3DXRenderToSurface,
|
|
0x69cc587c, 0xe40c, 0x458d, 0xb5, 0xd3, 0xb0, 0x29, 0xe1, 0x8e, 0xb6, 0xa);
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE ID3DXRenderToSurface
|
|
|
|
DECLARE_INTERFACE_(ID3DXRenderToSurface, IUnknown)
|
|
{
|
|
// IUnknown
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
|
|
|
// ID3DXRenderToSurface
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
|
STDMETHOD(GetDesc)(THIS_ D3DXRTS_DESC* pDesc) PURE;
|
|
|
|
STDMETHOD(BeginScene)(THIS_ LPDIRECT3DSURFACE8 pSurface, CONST D3DVIEWPORT8* pViewport) PURE;
|
|
STDMETHOD(EndScene)(THIS) PURE;
|
|
|
|
STDMETHOD(OnLostDevice)(THIS) PURE;
|
|
STDMETHOD(OnResetDevice)(THIS) PURE;
|
|
};
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
HRESULT WINAPI
|
|
D3DXCreateRenderToSurface(
|
|
LPDIRECT3DDEVICE8 pDevice,
|
|
UINT Width,
|
|
UINT Height,
|
|
D3DFORMAT Format,
|
|
BOOL DepthStencil,
|
|
D3DFORMAT DepthStencilFormat,
|
|
LPD3DXRENDERTOSURFACE* ppRenderToSurface);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// ID3DXRenderToEnvMap:
|
|
// --------------------
|
|
// This object abstracts rendering to environment maps. These surfaces
|
|
// do not necessarily need to be render targets. If they are not, a
|
|
// compatible render target is used, and the result copied into the
|
|
// environment map at end scene.
|
|
//
|
|
// BeginCube, BeginSphere, BeginHemisphere, BeginParabolic -
|
|
// This function initiates the rendering of the environment map. As
|
|
// parameters, you pass the textures in which will get filled in with
|
|
// the resulting environment map.
|
|
//
|
|
// Face -
|
|
// Call this function to initiate the drawing of each face. For each
|
|
// environment map, you will call this six times.. once for each face
|
|
// in D3DCUBEMAP_FACES.
|
|
//
|
|
// End -
|
|
// This will restore all render targets, and if needed compose all the
|
|
// rendered faces into the environment map surfaces.
|
|
//
|
|
// OnLostDevice, OnResetDevice -
|
|
// Call OnLostDevice() on this object before calling Reset() on the
|
|
// device, so that this object can release any stateblocks and video
|
|
// memory resources. After Reset(), the call OnResetDevice().
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
typedef struct _D3DXRTE_DESC
|
|
{
|
|
UINT Size;
|
|
D3DFORMAT Format;
|
|
BOOL DepthStencil;
|
|
D3DFORMAT DepthStencilFormat;
|
|
} D3DXRTE_DESC;
|
|
|
|
|
|
typedef interface ID3DXRenderToEnvMap ID3DXRenderToEnvMap;
|
|
typedef interface ID3DXRenderToEnvMap *LPD3DXRenderToEnvMap;
|
|
|
|
// {9F6779E5-60A9-4d8b-AEE4-32770F405DBA}
|
|
DEFINE_GUID( IID_ID3DXRenderToEnvMap,
|
|
0x9f6779e5, 0x60a9, 0x4d8b, 0xae, 0xe4, 0x32, 0x77, 0xf, 0x40, 0x5d, 0xba);
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE ID3DXRenderToEnvMap
|
|
|
|
DECLARE_INTERFACE_(ID3DXRenderToEnvMap, IUnknown)
|
|
{
|
|
// IUnknown
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
|
|
|
// ID3DXRenderToEnvMap
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
|
STDMETHOD(GetDesc)(THIS_ D3DXRTE_DESC* pDesc) PURE;
|
|
|
|
STDMETHOD(BeginCube)(THIS_
|
|
LPDIRECT3DCUBETEXTURE8 pCubeTex) PURE;
|
|
|
|
STDMETHOD(BeginSphere)(THIS_
|
|
LPDIRECT3DTEXTURE8 pTex) PURE;
|
|
|
|
STDMETHOD(BeginHemisphere)(THIS_
|
|
LPDIRECT3DTEXTURE8 pTexZPos,
|
|
LPDIRECT3DTEXTURE8 pTexZNeg) PURE;
|
|
|
|
STDMETHOD(BeginParabolic)(THIS_
|
|
LPDIRECT3DTEXTURE8 pTexZPos,
|
|
LPDIRECT3DTEXTURE8 pTexZNeg) PURE;
|
|
|
|
STDMETHOD(Face)(THIS_ D3DCUBEMAP_FACES Face) PURE;
|
|
STDMETHOD(End)(THIS) PURE;
|
|
|
|
STDMETHOD(OnLostDevice)(THIS) PURE;
|
|
STDMETHOD(OnResetDevice)(THIS) PURE;
|
|
};
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
HRESULT WINAPI
|
|
D3DXCreateRenderToEnvMap(
|
|
LPDIRECT3DDEVICE8 pDevice,
|
|
UINT Size,
|
|
D3DFORMAT Format,
|
|
BOOL DepthStencil,
|
|
D3DFORMAT DepthStencilFormat,
|
|
LPD3DXRenderToEnvMap* ppRenderToEnvMap);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// Shader assemblers:
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
//-------------------------------------------------------------------------
|
|
// D3DXASM flags:
|
|
// --------------
|
|
//
|
|
// D3DXASM_DEBUG
|
|
// Generate debug info.
|
|
//
|
|
// D3DXASM_SKIPVALIDATION
|
|
// Do not validate the generated code against known capabilities and
|
|
// constraints. This option is only recommended when assembling shaders
|
|
// you KNOW will work. (ie. have assembled before without this option.)
|
|
//-------------------------------------------------------------------------
|
|
|
|
#define D3DXASM_DEBUG (1 << 0)
|
|
#define D3DXASM_SKIPVALIDATION (1 << 1)
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
//-------------------------------------------------------------------------
|
|
// D3DXAssembleShader:
|
|
// -------------------
|
|
// Assembles an ascii description of a vertex or pixel shader into
|
|
// binary form.
|
|
//
|
|
// Parameters:
|
|
// pSrcFile
|
|
// Source file name
|
|
// hSrcModule
|
|
// Module handle. if NULL, current module will be used.
|
|
// pSrcResource
|
|
// Resource name in module
|
|
// pSrcData
|
|
// Pointer to source code
|
|
// SrcDataLen
|
|
// Size of source code, in bytes
|
|
// Flags
|
|
// D3DXASM_xxx flags
|
|
// ppConstants
|
|
// Returns an ID3DXBuffer object containing constant declarations.
|
|
// ppCompiledShader
|
|
// Returns an ID3DXBuffer object containing the object code.
|
|
// ppCompilationErrors
|
|
// Returns an ID3DXBuffer object containing ascii error messages
|
|
//-------------------------------------------------------------------------
|
|
|
|
HRESULT WINAPI
|
|
D3DXAssembleShaderFromFileA(
|
|
LPCSTR pSrcFile,
|
|
DWORD Flags,
|
|
LPD3DXBUFFER* ppConstants,
|
|
LPD3DXBUFFER* ppCompiledShader,
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
|
|
|
HRESULT WINAPI
|
|
D3DXAssembleShaderFromFileW(
|
|
LPCWSTR pSrcFile,
|
|
DWORD Flags,
|
|
LPD3DXBUFFER* ppConstants,
|
|
LPD3DXBUFFER* ppCompiledShader,
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
|
|
|
#ifdef UNICODE
|
|
#define D3DXAssembleShaderFromFile D3DXAssembleShaderFromFileW
|
|
#else
|
|
#define D3DXAssembleShaderFromFile D3DXAssembleShaderFromFileA
|
|
#endif
|
|
|
|
HRESULT WINAPI
|
|
D3DXAssembleShaderFromResourceA(
|
|
HMODULE hSrcModule,
|
|
LPCSTR pSrcResource,
|
|
DWORD Flags,
|
|
LPD3DXBUFFER* ppConstants,
|
|
LPD3DXBUFFER* ppCompiledShader,
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
|
|
|
HRESULT WINAPI
|
|
D3DXAssembleShaderFromResourceW(
|
|
HMODULE hSrcModule,
|
|
LPCWSTR pSrcResource,
|
|
DWORD Flags,
|
|
LPD3DXBUFFER* ppConstants,
|
|
LPD3DXBUFFER* ppCompiledShader,
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
|
|
|
#ifdef UNICODE
|
|
#define D3DXAssembleShaderFromResource D3DXAssembleShaderFromResourceW
|
|
#else
|
|
#define D3DXAssembleShaderFromResource D3DXAssembleShaderFromResourceA
|
|
#endif
|
|
|
|
HRESULT WINAPI
|
|
D3DXAssembleShader(
|
|
LPCVOID pSrcData,
|
|
UINT SrcDataLen,
|
|
DWORD Flags,
|
|
LPD3DXBUFFER* ppConstants,
|
|
LPD3DXBUFFER* ppCompiledShader,
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////
|
|
// Misc APIs:
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif //__cplusplus
|
|
|
|
//-------------------------------------------------------------------------
|
|
// D3DXGetErrorString:
|
|
// ------------------
|
|
// Returns the error string for given an hresult. Interprets all D3DX and
|
|
// D3D hresults.
|
|
//
|
|
// Parameters:
|
|
// hr
|
|
// The error code to be deciphered.
|
|
// pBuffer
|
|
// Pointer to the buffer to be filled in.
|
|
// BufferLen
|
|
// Count of characters in buffer. Any error message longer than this
|
|
// length will be truncated to fit.
|
|
//-------------------------------------------------------------------------
|
|
HRESULT WINAPI
|
|
D3DXGetErrorStringA(
|
|
HRESULT hr,
|
|
LPSTR pBuffer,
|
|
UINT BufferLen);
|
|
|
|
HRESULT WINAPI
|
|
D3DXGetErrorStringW(
|
|
HRESULT hr,
|
|
LPWSTR pBuffer,
|
|
UINT BufferLen);
|
|
|
|
#ifdef UNICODE
|
|
#define D3DXGetErrorString D3DXGetErrorStringW
|
|
#else
|
|
#define D3DXGetErrorString D3DXGetErrorStringA
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif //__cplusplus
|
|
|
|
#endif //__D3DX8CORE_H__
|