home *** CD-ROM | disk | FTP | other *** search
/ Isometric Game Programming with DirectX 7.0 / Isometric Game Programming.iso / directx / dxf / samples / multimedia / common / include / d3dutil.h < prev    next >
Encoding:
C/C++ Source or Header  |  2000-11-04  |  9.9 KB  |  254 lines
  1. //-----------------------------------------------------------------------------
  2. // File: D3DUtil.h
  3. //
  4. // Desc: Helper functions and typing shortcuts for Direct3D programming.
  5. //
  6. // Copyright (c) 1997-2000 Microsoft Corporation. All rights reserved
  7. //-----------------------------------------------------------------------------
  8. #ifndef D3DUTIL_H
  9. #define D3DUTIL_H
  10. #include <D3D8.h>
  11. #include <D3DX8Math.h>
  12.  
  13.  
  14.  
  15.  
  16. //-----------------------------------------------------------------------------
  17. // Name: D3DUtil_InitMaterial()
  18. // Desc: Initializes a D3DMATERIAL8 structure, setting the diffuse and ambient
  19. //       colors. It does not set emissive or specular colors.
  20. //-----------------------------------------------------------------------------
  21. VOID D3DUtil_InitMaterial( D3DMATERIAL8& mtrl, FLOAT r=0.0f, FLOAT g=0.0f,
  22.                                                FLOAT b=0.0f, FLOAT a=1.0f );
  23.  
  24.  
  25.  
  26.  
  27. //-----------------------------------------------------------------------------
  28. // Name: D3DUtil_InitLight()
  29. // Desc: Initializes a D3DLIGHT structure, setting the light position. The
  30. //       diffuse color is set to white, specular and ambient left as black.
  31. //-----------------------------------------------------------------------------
  32. VOID D3DUtil_InitLight( D3DLIGHT8& light, D3DLIGHTTYPE ltType,
  33.                         FLOAT x=0.0f, FLOAT y=0.0f, FLOAT z=0.0f );
  34.  
  35.  
  36.  
  37.  
  38. //-----------------------------------------------------------------------------
  39. // Name: D3DUtil_CreateTexture()
  40. // Desc: Helper function to create a texture. It checks the root path first,
  41. //       then tries the DXSDK media path (as specified in the system registry).
  42. //-----------------------------------------------------------------------------
  43. HRESULT D3DUtil_CreateTexture( LPDIRECT3DDEVICE8 pd3dDevice, TCHAR* strTexture,
  44.                                LPDIRECT3DTEXTURE8* ppTexture,
  45.                                D3DFORMAT d3dFormat = D3DFMT_UNKNOWN );
  46.  
  47.  
  48.  
  49.  
  50. //-----------------------------------------------------------------------------
  51. // Name: D3DUtil_SetColorKey()
  52. // Desc: Changes all texels matching the colorkey to transparent, black.
  53. //-----------------------------------------------------------------------------
  54. HRESULT D3DUtil_SetColorKey( LPDIRECT3DTEXTURE8 pTexture, DWORD dwColorKey );
  55.  
  56.  
  57.  
  58.  
  59. //-----------------------------------------------------------------------------
  60. // Name: D3DUtil_CreateVertexShader()
  61. // Desc: Assembles and creates a file-based vertex shader
  62. //-----------------------------------------------------------------------------
  63. HRESULT D3DUtil_CreateVertexShader( LPDIRECT3DDEVICE8 pd3dDevice, 
  64.                                     TCHAR* strFilename, DWORD* pdwVertexDecl,
  65.                                     DWORD* pdwVertexShader );
  66.  
  67.                                     
  68.                                     
  69.                                     
  70. //-----------------------------------------------------------------------------
  71. // Name: D3DUtil_GetCubeMapViewMatrix()
  72. // Desc: Returns a view matrix for rendering to a face of a cubemap.
  73. //-----------------------------------------------------------------------------
  74. D3DXMATRIX D3DUtil_GetCubeMapViewMatrix( DWORD dwFace );
  75.  
  76.  
  77.  
  78.  
  79. //-----------------------------------------------------------------------------
  80. // Name: D3DUtil_GetRotationFromCursor()
  81. // Desc: Returns a quaternion for the rotation implied by the window's cursor
  82. //       position.
  83. //-----------------------------------------------------------------------------
  84. D3DXQUATERNION D3DUtil_GetRotationFromCursor( HWND hWnd,
  85.                                               FLOAT fTrackBallRadius=1.0f );
  86.  
  87.  
  88.  
  89.  
  90. //-----------------------------------------------------------------------------
  91. // Name: D3DUtil_SetDeviceCursor
  92. // Desc: Builds and sets a cursor for the D3D device based on hCursor.
  93. //-----------------------------------------------------------------------------
  94. HRESULT D3DUtil_SetDeviceCursor( LPDIRECT3DDEVICE8 pd3dDevice, HCURSOR hCursor );
  95.  
  96.  
  97.  
  98.  
  99. //-----------------------------------------------------------------------------
  100. // Name: class CD3DArcBall
  101. // Desc:
  102. //-----------------------------------------------------------------------------
  103. class CD3DArcBall
  104. {
  105.     INT            m_iWidth;   // ArcBall's window width
  106.     INT            m_iHeight;  // ArcBall's window height
  107.     FLOAT          m_fRadius;  // ArcBall's radius in screen coords
  108.     FLOAT          m_fRadius2; // ArcBall's radius in screen coords
  109.  
  110.     D3DXQUATERNION m_qDown;               // Quaternion before button down
  111.     D3DXQUATERNION m_qNow;                // Composite quaternion for current drag
  112.     D3DXMATRIX     m_matRotation;         // Matrix for arcball's orientation
  113.     D3DXMATRIX     m_matRotationDelta;    // Matrix for arcball's orientation
  114.     D3DXMATRIX     m_matTranslation;      // Matrix for arcball's position
  115.     D3DXMATRIX     m_matTranslationDelta; // Matrix for arcball's position
  116.     BOOL           m_bDrag;               // Whether user is dragging arcball
  117.  
  118.     D3DXVECTOR3 ScreenToVector( int sx, int sy );
  119.  
  120. public:
  121.     LRESULT     HandleMouseMessages( HWND, UINT, WPARAM, LPARAM );
  122.  
  123.     D3DXMATRIX* GetRotationMatrix()         { return &m_matRotation; }
  124.     D3DXMATRIX* GetRotationDeltaMatrix()    { return &m_matRotationDelta; }
  125.     D3DXMATRIX* GetTranslationMatrix()      { return &m_matTranslation; }
  126.     D3DXMATRIX* GetTranslationDeltaMatrix() { return &m_matTranslationDelta; }
  127.     BOOL        IsBeingDragged()            { return m_bDrag; }
  128.  
  129.     VOID        SetRadius( FLOAT fRadius );
  130.     VOID        SetWindow( INT w, INT h, FLOAT r=0.9 );
  131.  
  132.     CD3DArcBall();
  133. };
  134.  
  135.  
  136.  
  137.  
  138. //-----------------------------------------------------------------------------
  139. // Name: class CD3DCamera
  140. // Desc:
  141. //-----------------------------------------------------------------------------
  142. class CD3DCamera
  143. {
  144.     D3DXVECTOR3 m_vEyePt;       // Attributes for view matrix
  145.     D3DXVECTOR3 m_vLookatPt;
  146.     D3DXVECTOR3 m_vUpVec;
  147.  
  148.     D3DXVECTOR3 m_vView;
  149.     D3DXVECTOR3 m_vCross;
  150.  
  151.     D3DXMATRIX  m_matView;
  152.     D3DXMATRIX  m_matBillboard; // Special matrix for billboarding effects
  153.  
  154.     FLOAT       m_fFOV;         // Attributes for projection matrix
  155.     FLOAT       m_fAspect;
  156.     FLOAT       m_fNearPlane;
  157.     FLOAT       m_fFarPlane;
  158.     D3DXMATRIX  m_matProj;
  159.  
  160. public:
  161.     // Access functions
  162.     D3DXVECTOR3 GetEyePt()           { return m_vEyePt; }
  163.     D3DXVECTOR3 GetLookatPt()        { return m_vLookatPt; }
  164.     D3DXVECTOR3 GetUpVec()           { return m_vUpVec; }
  165.     D3DXVECTOR3 GetViewDir()         { return m_vView; }
  166.     D3DXVECTOR3 GetCross()           { return m_vCross; }
  167.  
  168.     D3DXMATRIX  GetViewMatrix()      { return m_matView; }
  169.     D3DXMATRIX  GetBillboardMatrix() { return m_matBillboard; }
  170.     D3DXMATRIX  GetProjMatrix()      { return m_matProj; }
  171.  
  172.     VOID SetViewParams( D3DXVECTOR3 &vEyePt, D3DXVECTOR3& vLookatPt,
  173.                         D3DXVECTOR3& vUpVec );
  174.     VOID SetProjParams( FLOAT fFOV, FLOAT fAspect, FLOAT fNearPlane,
  175.                         FLOAT fFarPlane );
  176.  
  177.     CD3DCamera();
  178. };
  179.  
  180. //-----------------------------------------------------------------------------
  181. // Helper macros for pixel shader instructions
  182. //-----------------------------------------------------------------------------
  183.  
  184. // Parameter writemasks
  185. #define D3DPSP_WRITEMASK_B   D3DSP_WRITEMASK_0
  186. #define D3DPSP_WRITEMASK_G   D3DSP_WRITEMASK_1
  187. #define D3DPSP_WRITEMASK_R   D3DSP_WRITEMASK_2
  188. #define D3DPSP_WRITEMASK_A   D3DSP_WRITEMASK_3
  189. #define D3DPSP_WRITEMASK_C   (D3DPSP_WRITEMASK_B|D3DPSP_WRITEMASK_G|D3DPSP_WRITEMASK_R)
  190. #define D3DPSP_WRITEMASK_ALL (D3DSP_WRITEMASK_0|D3DSP_WRITEMASK_1|D3DSP_WRITEMASK_2|D3DSP_WRITEMASK_3)
  191. #define D3DPSP_WRITEMASK_10  (D3DSP_WRITEMASK_0|D3DSP_WRITEMASK_1)
  192. #define D3DPSP_WRITEMASK_32  (D3DSP_WRITEMASK_2|D3DSP_WRITEMASK_3)
  193.  
  194. // Source and destination parameter token
  195. #define D3DPS_REGNUM_MASK(_Num)   ( (1L<<31) | ((_Num)&D3DSP_REGNUM_MASK) )
  196. #define D3DPS_DST(_Num)           ( D3DPS_REGNUM_MASK(_Num) | D3DSPR_TEMP | D3DPSP_WRITEMASK_ALL )
  197. #define D3DPS_SRC_TEMP(_Num)      ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_TEMP )
  198. #define D3DPS_SRC_INPUT(_Num)     ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_INPUT )
  199. #define D3DPS_SRC_CONST(_Num)     ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_CONST )
  200. #define D3DPS_SRC_TEXTURE(_Num)   ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_TEXTURE )
  201. #define D3DVS_SRC_ADDR(_Num)      ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_ADDR )
  202. #define D3DVS_SRC_RASTOUT(_Num)   ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_RASTOUT )
  203. #define D3DVS_SRC_ATTROUT(_Num)   ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_ATTROUT )
  204. #define D3DVS_SRC_TEXCRDOUT(_Num) ( D3DPS_REGNUM_MASK(_Num) | D3DSP_NOSWIZZLE | D3DSPR_TEXCRDOUT )
  205.  
  206. // Temp destination registers
  207. #define D3DS_DR0   D3DPS_DST(0)
  208. #define D3DS_DR1   D3DPS_DST(1)
  209. #define D3DS_DR2   D3DPS_DST(2)
  210. #define D3DS_DR3   D3DPS_DST(3)
  211. #define D3DS_DR4   D3DPS_DST(4)
  212. #define D3DS_DR5   D3DPS_DST(5)
  213. #define D3DS_DR6   D3DPS_DST(6)
  214. #define D3DS_DR7   D3DPS_DST(7)
  215.  
  216. // Temp source registers
  217. #define D3DS_SR0   D3DPS_SRC_TEMP(0)
  218. #define D3DS_SR1   D3DPS_SRC_TEMP(1)
  219. #define D3DS_SR2   D3DPS_SRC_TEMP(2)
  220. #define D3DS_SR3   D3DPS_SRC_TEMP(3)
  221. #define D3DS_SR4   D3DPS_SRC_TEMP(4)
  222. #define D3DS_SR5   D3DPS_SRC_TEMP(5)
  223. #define D3DS_SR6   D3DPS_SRC_TEMP(6)
  224. #define D3DS_SR7   D3DPS_SRC_TEMP(7)
  225.  
  226. // Texture parameters
  227. #define D3DS_T0   D3DPS_SRC_TEXTURE(0)
  228. #define D3DS_T1   D3DPS_SRC_TEXTURE(1)
  229. #define D3DS_T2   D3DPS_SRC_TEXTURE(2)
  230. #define D3DS_T3   D3DPS_SRC_TEXTURE(3)
  231. #define D3DS_T4   D3DPS_SRC_TEXTURE(4)
  232. #define D3DS_T5   D3DPS_SRC_TEXTURE(5)
  233. #define D3DS_T6   D3DPS_SRC_TEXTURE(6)
  234. #define D3DS_T7   D3DPS_SRC_TEXTURE(7)
  235.  
  236. // Constant (factor) source parameters
  237. #define D3DS_C0     D3DPS_SRC_CONST(0)
  238. #define D3DS_C1     D3DPS_SRC_CONST(1)
  239. #define D3DS_C2     D3DPS_SRC_CONST(2)
  240. #define D3DS_C3     D3DPS_SRC_CONST(3)
  241. #define D3DS_C4     D3DPS_SRC_CONST(4)
  242. #define D3DS_C5     D3DPS_SRC_CONST(5)
  243. #define D3DS_C6     D3DPS_SRC_CONST(6)
  244. #define D3DS_C7     D3DPS_SRC_CONST(7)
  245.  
  246. // Iterated source parameters (0==Diffuse, 1==specular)
  247. #define D3DS_V0     D3DPS_SRC_INPUT(0)
  248. #define D3DS_V1     D3DPS_SRC_INPUT(1)
  249.  
  250.  
  251.  
  252.  
  253. #endif // D3DUTIL_H
  254.