d3dx8core.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:17k
- ///////////////////////////////////////////////////////////////////////////
- //
- // 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__