1 //-----------------------------------------------------------------------------
4 // Desc: Helper functions and typing shortcuts for Direct3D programming.
7 // Copyright (C) 1997 Microsoft Corporation. All rights reserved
8 //-----------------------------------------------------------------------------
17 //-----------------------------------------------------------------------------
18 // Typing shortcuts for deleting and freeing objects.
19 //-----------------------------------------------------------------------------
20 #define SAFE_DELETE(p) { if(p) { delete (p); (p)=NULL; } }
21 #define SAFE_RELEASE(p) { if(p) { (p)->Release(); (p)=NULL; } }
26 //-----------------------------------------------------------------------------
27 // Short cut functions for creating and using DX structures
28 //-----------------------------------------------------------------------------
29 VOID D3DUtil_InitDeviceDesc( D3DDEVICEDESC& ddDevDesc );
30 VOID D3DUtil_InitSurfaceDesc( DDSURFACEDESC2& ddsd, DWORD dwFlags=0,
32 VOID D3DUtil_InitViewport( D3DVIEWPORT2& vdViewData, DWORD dwWidth=0,
34 VOID D3DUtil_InitMaterial( D3DMATERIAL& mdMtrlData, FLOAT r=0.0f, FLOAT g=0.0f,
36 VOID D3DUtil_InitLight( D3DLIGHT& ldLightData, D3DLIGHTTYPE ltType,
37 FLOAT x=0.0f, FLOAT y=0.0f, FLOAT z=0.0f );
42 //-----------------------------------------------------------------------------
43 // Miscellaneous helper functions
44 //-----------------------------------------------------------------------------
45 LPDIRECTDRAW4 D3DUtil_GetDirectDrawFromDevice( LPDIRECT3DDEVICE3 pd3dDevice );
46 DWORD D3DUtil_GetDeviceMemoryType( LPDIRECT3DDEVICE3 pd3dDevice );
47 DWORD D3DUtil_GetDisplayDepth( LPDIRECTDRAW4 pDD4=NULL );
52 //-----------------------------------------------------------------------------
53 // D3D Matrix functions. For performance reasons, some functions are inline.
54 //-----------------------------------------------------------------------------
55 HRESULT D3DUtil_SetViewMatrix( D3DMATRIX& mat, D3DVECTOR& vFrom,
56 D3DVECTOR& vAt, D3DVECTOR& vUp );
57 HRESULT D3DUtil_SetProjectionMatrix( D3DMATRIX& mat, FLOAT fFOV = 1.570795f,
59 FLOAT fNearPlane = 1.0f,
60 FLOAT fFarPlane = 1000.0f );
62 inline VOID D3DUtil_SetIdentityMatrix( D3DMATRIX& m )
64 m._12 = m._13 = m._14 = m._21 = m._23 = m._24 = 0.0f;
65 m._31 = m._32 = m._34 = m._41 = m._42 = m._43 = 0.0f;
66 m._11 = m._22 = m._33 = m._44 = 1.0f;
69 inline VOID D3DUtil_SetTranslateMatrix( D3DMATRIX& m, FLOAT tx, FLOAT ty,
71 { D3DUtil_SetIdentityMatrix( m ); m._41 = tx; m._42 = ty; m._43 = tz; }
73 inline VOID D3DUtil_SetTranslateMatrix( D3DMATRIX& m, D3DVECTOR& v )
74 { D3DUtil_SetTranslateMatrix( m, v.x, v.y, v.z ); }
76 inline VOID D3DUtil_SetScaleMatrix( D3DMATRIX& m, FLOAT sx, FLOAT sy,
78 { D3DUtil_SetIdentityMatrix( m ); m._11 = sx; m._22 = sy; m._33 = sz; }
80 inline VOID SetScaleMatrix( D3DMATRIX& m, D3DVECTOR& v )
81 { D3DUtil_SetScaleMatrix( m, v.x, v.y, v.z ); }
83 VOID D3DUtil_SetRotateXMatrix( D3DMATRIX& mat, FLOAT fRads );
84 VOID D3DUtil_SetRotateYMatrix( D3DMATRIX& mat, FLOAT fRads );
85 VOID D3DUtil_SetRotateZMatrix( D3DMATRIX& mat, FLOAT fRads );
86 VOID D3DUtil_SetRotationMatrix( D3DMATRIX& mat, D3DVECTOR& vDir,
92 //-----------------------------------------------------------------------------
93 // Debug printing support
94 //-----------------------------------------------------------------------------
96 HRESULT _DbgOut( TCHAR*, DWORD, HRESULT, TCHAR* );
98 #if defined(DEBUG) | defined(_DEBUG)
99 #define DEBUG_MSG(str) _DbgOut( __FILE__, (DWORD)__LINE__, 0, str )
100 #define DEBUG_ERR(hr,str) _DbgOut( __FILE__, (DWORD)__LINE__, hr, str )
102 #define DEBUG_MSG(str) (0L)
103 #define DEBUG_ERR(hr,str) (hr)