1 |
bearsoft |
1.1 |
///////////////////////////////////////////////////////////////////////////
|
2 |
|
|
//
|
3 |
|
|
// Copyright (C) 1999 Microsoft Corporation. All Rights Reserved.
|
4 |
|
|
//
|
5 |
|
|
// File: d3dx8effect.h
|
6 |
|
|
// Content: D3DX effect types and functions
|
7 |
|
|
//
|
8 |
|
|
///////////////////////////////////////////////////////////////////////////
|
9 |
|
|
|
10 |
|
|
#include "d3dx8.h"
|
11 |
|
|
|
12 |
|
|
#ifndef __D3DX8EFFECT_H__
|
13 |
|
|
#define __D3DX8EFFECT_H__
|
14 |
|
|
|
15 |
|
|
|
16 |
|
|
typedef enum _D3DXPARAMETERTYPE
|
17 |
|
|
{
|
18 |
|
|
D3DXPT_DWORD = 0,
|
19 |
|
|
D3DXPT_FLOAT = 1,
|
20 |
|
|
D3DXPT_VECTOR = 2,
|
21 |
|
|
D3DXPT_MATRIX = 3,
|
22 |
|
|
D3DXPT_TEXTURE = 4,
|
23 |
|
|
D3DXPT_VERTEXSHADER = 5,
|
24 |
|
|
D3DXPT_PIXELSHADER = 6,
|
25 |
|
|
D3DXPT_CONSTANT = 7,
|
26 |
|
|
D3DXPT_FORCE_DWORD = 0x7fffffff /* force 32-bit size enum */
|
27 |
|
|
|
28 |
|
|
} D3DXPARAMETERTYPE;
|
29 |
|
|
|
30 |
|
|
|
31 |
|
|
typedef struct _D3DXEFFECT_DESC
|
32 |
|
|
{
|
33 |
|
|
UINT Parameters;
|
34 |
|
|
UINT Techniques;
|
35 |
|
|
DWORD Usage;
|
36 |
|
|
|
37 |
|
|
} D3DXEFFECT_DESC;
|
38 |
|
|
|
39 |
|
|
|
40 |
|
|
typedef struct _D3DXPARAMETER_DESC
|
41 |
|
|
{
|
42 |
|
|
DWORD Name;
|
43 |
|
|
D3DXPARAMETERTYPE Type;
|
44 |
|
|
|
45 |
|
|
} D3DXPARAMETER_DESC;
|
46 |
|
|
|
47 |
|
|
|
48 |
|
|
typedef struct _D3DXTECHNIQUE_DESC
|
49 |
|
|
{
|
50 |
|
|
DWORD Name;
|
51 |
|
|
UINT Passes;
|
52 |
|
|
|
53 |
|
|
} D3DXTECHNIQUE_DESC;
|
54 |
|
|
|
55 |
|
|
|
56 |
|
|
typedef struct _D3DXPASS_DESC
|
57 |
|
|
{
|
58 |
|
|
DWORD Name;
|
59 |
|
|
|
60 |
|
|
} D3DXPASS_DESC;
|
61 |
|
|
|
62 |
|
|
|
63 |
|
|
typedef struct ID3DXEffect *LPD3DXEFFECT;
|
64 |
|
|
typedef struct ID3DXTechnique *LPD3DXTECHNIQUE;
|
65 |
|
|
|
66 |
|
|
|
67 |
|
|
|
68 |
|
|
|
69 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
70 |
|
|
// ID3DXTechnique ////////////////////////////////////////////////////////////
|
71 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
72 |
|
|
|
73 |
|
|
// {A00F378D-AF79-4917-907E-4D635EE63844}
|
74 |
|
|
DEFINE_GUID( IID_ID3DXTechnique,
|
75 |
|
|
0xa00f378d, 0xaf79, 0x4917, 0x90, 0x7e, 0x4d, 0x63, 0x5e, 0xe6, 0x38, 0x44);
|
76 |
|
|
|
77 |
|
|
|
78 |
|
|
DECLARE_INTERFACE_(ID3DXTechnique, IUnknown)
|
79 |
|
|
{
|
80 |
|
|
// IUnknown
|
81 |
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
82 |
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
83 |
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
84 |
|
|
|
85 |
|
|
// ID3DXTechnique
|
86 |
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
87 |
|
|
STDMETHOD(GetDesc)(THIS_ D3DXTECHNIQUE_DESC* pDesc) PURE;
|
88 |
|
|
STDMETHOD(GetPassDesc)(THIS_ UINT Index, D3DXPASS_DESC* pDesc) PURE;
|
89 |
|
|
|
90 |
|
|
STDMETHOD_(BOOL, IsParameterUsed)(THIS_ DWORD dwName) PURE;
|
91 |
|
|
|
92 |
|
|
STDMETHOD(Validate)(THIS) PURE;
|
93 |
|
|
STDMETHOD(Begin)(THIS_ UINT *pPasses) PURE;
|
94 |
|
|
STDMETHOD(Pass)(THIS_ UINT Index) PURE;
|
95 |
|
|
STDMETHOD(End)(THIS) PURE;
|
96 |
|
|
};
|
97 |
|
|
|
98 |
|
|
|
99 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
100 |
|
|
// ID3DXEffect ///////////////////////////////////////////////////////////////
|
101 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
102 |
|
|
|
103 |
|
|
|
104 |
|
|
// {281BBDD4-AEDF-4907-8650-E79CDFD45165}
|
105 |
|
|
DEFINE_GUID( IID_ID3DXEffect,
|
106 |
|
|
0x281bbdd4, 0xaedf, 0x4907, 0x86, 0x50, 0xe7, 0x9c, 0xdf, 0xd4, 0x51, 0x65);
|
107 |
|
|
|
108 |
|
|
|
109 |
|
|
DECLARE_INTERFACE_(ID3DXEffect, IUnknown)
|
110 |
|
|
{
|
111 |
|
|
// IUnknown
|
112 |
|
|
STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
|
113 |
|
|
STDMETHOD_(ULONG, AddRef)(THIS) PURE;
|
114 |
|
|
STDMETHOD_(ULONG, Release)(THIS) PURE;
|
115 |
|
|
|
116 |
|
|
// ID3DXEffect
|
117 |
|
|
STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE8* ppDevice) PURE;
|
118 |
|
|
STDMETHOD(GetDesc)(THIS_ D3DXEFFECT_DESC* pDesc) PURE;
|
119 |
|
|
|
120 |
|
|
STDMETHOD(GetParameterDesc)(THIS_ UINT Index, D3DXPARAMETER_DESC* pDesc) PURE;
|
121 |
|
|
STDMETHOD(GetTechniqueDesc)(THIS_ UINT Index, D3DXTECHNIQUE_DESC* pDesc) PURE;
|
122 |
|
|
|
123 |
|
|
STDMETHOD(SetDword)(THIS_ DWORD Name, DWORD dw) PURE;
|
124 |
|
|
STDMETHOD(GetDword)(THIS_ DWORD Name, DWORD* pdw) PURE;
|
125 |
|
|
STDMETHOD(SetFloat)(THIS_ DWORD Name, FLOAT f) PURE;
|
126 |
|
|
STDMETHOD(GetFloat)(THIS_ DWORD Name, FLOAT* pf) PURE;
|
127 |
|
|
STDMETHOD(SetVector)(THIS_ DWORD Name, D3DXVECTOR4* pVector) PURE;
|
128 |
|
|
STDMETHOD(GetVector)(THIS_ DWORD Name, D3DXVECTOR4* pVector) PURE;
|
129 |
|
|
STDMETHOD(SetMatrix)(THIS_ DWORD Name, D3DXMATRIX* pMatrix) PURE;
|
130 |
|
|
STDMETHOD(GetMatrix)(THIS_ DWORD Name, D3DXMATRIX* pMatrix) PURE;
|
131 |
|
|
STDMETHOD(SetTexture)(THIS_ DWORD Name, LPDIRECT3DBASETEXTURE8 pTexture) PURE;
|
132 |
|
|
STDMETHOD(GetTexture)(THIS_ DWORD Name, LPDIRECT3DBASETEXTURE8 *ppTexture) PURE;
|
133 |
|
|
STDMETHOD(SetVertexShader)(THIS_ DWORD Name, DWORD Handle) PURE;
|
134 |
|
|
STDMETHOD(GetVertexShader)(THIS_ DWORD Name, DWORD* pHandle) PURE;
|
135 |
|
|
STDMETHOD(SetPixelShader)(THIS_ DWORD Name, DWORD Handle) PURE;
|
136 |
|
|
STDMETHOD(GetPixelShader)(THIS_ DWORD Name, DWORD* pHandle) PURE;
|
137 |
|
|
|
138 |
|
|
STDMETHOD(GetTechnique)(THIS_ UINT Index, LPD3DXTECHNIQUE* ppTechnique) PURE;
|
139 |
|
|
STDMETHOD(CloneEffect)(THIS_ LPDIRECT3DDEVICE8 pDevice, DWORD Usage, LPD3DXEFFECT* ppEffect) PURE;
|
140 |
|
|
};
|
141 |
|
|
|
142 |
|
|
|
143 |
|
|
|
144 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
145 |
|
|
// APIs //////////////////////////////////////////////////////////////////////
|
146 |
|
|
//////////////////////////////////////////////////////////////////////////////
|
147 |
|
|
|
148 |
|
|
|
149 |
|
|
#ifdef __cplusplus
|
150 |
|
|
extern "C" {
|
151 |
|
|
#endif //__cplusplus
|
152 |
|
|
|
153 |
|
|
|
154 |
|
|
//----------------------------------------------------------------------------
|
155 |
|
|
// D3DXCompileEffect:
|
156 |
|
|
// ------------------
|
157 |
|
|
// Compiles an ascii effect description into a binary form usable by
|
158 |
|
|
// D3DXCreateEffect.
|
159 |
|
|
//
|
160 |
|
|
// Parameters:
|
161 |
|
|
// pSrcFile
|
162 |
|
|
// Name of the file containing the ascii effect description
|
163 |
|
|
// pSrcData
|
164 |
|
|
// Pointer to ascii effect description
|
165 |
|
|
// SrcDataSize
|
166 |
|
|
// Size of the effect description in bytes
|
167 |
|
|
// ppCompiledEffect
|
168 |
|
|
// Returns a buffer containing compiled effect.
|
169 |
|
|
// ppCompilationErrors
|
170 |
|
|
// Returns a buffer containing any error messages which occurred during
|
171 |
|
|
// compile. Or NULL if you do not care about the error messages.
|
172 |
|
|
//
|
173 |
|
|
//----------------------------------------------------------------------------
|
174 |
|
|
|
175 |
|
|
HRESULT WINAPI
|
176 |
|
|
D3DXCompileEffectFromFileA(
|
177 |
|
|
LPCSTR pSrcFile,
|
178 |
|
|
LPD3DXBUFFER* ppCompiledEffect,
|
179 |
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
180 |
|
|
|
181 |
|
|
HRESULT WINAPI
|
182 |
|
|
D3DXCompileEffectFromFileW(
|
183 |
|
|
LPCWSTR pSrcFile,
|
184 |
|
|
LPD3DXBUFFER* ppCompiledEffect,
|
185 |
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
186 |
|
|
|
187 |
|
|
#ifdef UNICODE
|
188 |
|
|
#define D3DXCompileEffectFromFile D3DXCompileEffectFromFileW
|
189 |
|
|
#else
|
190 |
|
|
#define D3DXCompileEffectFromFile D3DXCompileEffectFromFileA
|
191 |
|
|
#endif
|
192 |
|
|
|
193 |
|
|
|
194 |
|
|
HRESULT WINAPI
|
195 |
|
|
D3DXCompileEffect(
|
196 |
|
|
LPCVOID pSrcData,
|
197 |
|
|
UINT SrcDataSize,
|
198 |
|
|
LPD3DXBUFFER* ppCompiledEffect,
|
199 |
|
|
LPD3DXBUFFER* ppCompilationErrors);
|
200 |
|
|
|
201 |
|
|
|
202 |
|
|
|
203 |
|
|
//----------------------------------------------------------------------------
|
204 |
|
|
// D3DXCreateEffect:
|
205 |
|
|
// -----------------
|
206 |
|
|
// Creates an effect object, given compiled binary effect data
|
207 |
|
|
//
|
208 |
|
|
// Parameters:
|
209 |
|
|
// pDevice
|
210 |
|
|
// Pointer to the device to be used.
|
211 |
|
|
// pCompiledEffect
|
212 |
|
|
// Pointer to compiled effect data
|
213 |
|
|
// CompiledEffectSize
|
214 |
|
|
// Size of compiled effect data in bytes
|
215 |
|
|
// Usage
|
216 |
|
|
// Allows the specification of D3DUSAGE_SOFTWAREPROCESSING
|
217 |
|
|
// ppEffect
|
218 |
|
|
// Returns the created effect object
|
219 |
|
|
//----------------------------------------------------------------------------
|
220 |
|
|
|
221 |
|
|
|
222 |
|
|
HRESULT WINAPI
|
223 |
|
|
D3DXCreateEffect(
|
224 |
|
|
LPDIRECT3DDEVICE8 pDevice,
|
225 |
|
|
LPCVOID pCompiledEffect,
|
226 |
|
|
UINT CompiledEffectSize,
|
227 |
|
|
DWORD Usage,
|
228 |
|
|
LPD3DXEFFECT* ppEffect);
|
229 |
|
|
|
230 |
|
|
|
231 |
|
|
|
232 |
|
|
#ifdef __cplusplus
|
233 |
|
|
}
|
234 |
|
|
#endif //__cplusplus
|
235 |
|
|
|
236 |
|
|
#endif //__D3DX8EFFECT_H__
|