第一个D3D代码

      这是我写的第一个D3D代码了，也是我这么多年，注释最多的代码了，虽然90%的代码是摘抄自 DirectX SDK。但是为了搞懂并牢记这些东西，我往返于MSDN和Google之间，可以说费了九牛二虎之力。同时推荐一下yanjun_1982的DirectX 9.0 入门手册（http://blog.youkuaiyun.com/yanjun_1982/archive/2005/09/17/482588.aspx），虽然是最后关头才搜到的东西，但是算是帮助我最大的文章了。

 

// 这就不用多说了，包含一个文件,用<>表示文件在VC++环境设置的路径中；用''表示提供了文件的完整路径。 #include <d3d9.h> // 编译器指令，禁止编号为 4996 的警告信息。此指令只针对当前 CPP 文件起作用。 // // 在查阅了 MSDN 并使用 Google 查询后得知了 4996 号警告信息的详细内容。 // MSDN介绍： //“function”: 被声明为否决的。意思是使用了一个已经被新版本否决的函数。 // Google出的资料： // 因为 VC2005 中认为CRT中的一组函数如果使用不当，可能会产生诸如内存泄露、缓冲区溢出、非法访问等安全问题。这些函数如：strcpy、strcat等。 // 对于这些问题，VC2005 建议使用这些函数的更高级的安全版本，即在这些函数名后面加了一个_s的函数。 // 这些安全版本函数使用起来更有效，也便于识别，如：strcpy_s,calloc_s等。 // // 个人估计在 strsafe.h 文件中有对strcpy之类函数的使用，所以在包含其的时候关闭了警告提示，但是在之后重新恢复了警告提示。 #pragma warning( disable : 4996 ) #include <strsafe.h> #pragma warning( default : 4996 ) // 定义两个全局变量 // LPDIRECT3D9 // 等同于 IDirect3D9接口， 表示一个 D3D 的设备。 LPDIRECT3D9 g_pD3D = NULL; // Used to create the D3DDevice LPDIRECT3DDEVICE9 g_pd3dDevice = NULL; // Our rendering device //----------------------------------------------------------------------------- // Name: InitD3D() // Desc: Initializes Direct3D //----------------------------------------------------------------------------- // 初始化 D3D。 // 参数 hWnd,窗体的句柄 HRESULT InitD3D( HWND hWnd ) { // 创建一个基于DirectX9的 D3D 设备。如果失败，直接返回 E_FAIL。 if( NULL == ( g_pD3D = Direct3DCreate9( D3D_SDK_VERSION ) ) ) return E_FAIL; /// 初始化用于创建 D3D 设备的结构体。 // 参数名 类型 中文意思 // BackBufferWidth UINT 全屏幕式后备缓冲的宽度 // BackBufferHeight UINT 全屏幕式后备缓冲的高度 // BackBufferFormat D3DFORMAT 后备缓冲的格式 // BackBufferCount UINT 后备缓冲数目 // MultiSampleType D3DMULTISAMPLE_TYPE 全屏抗锯齿类型 // MultiSampleQuality DWORD 全屏抗锯齿质量等级 // SwapEffect D3DSWAPEFFECT 交换缓冲类型 // hDeviceWindow HWND 设备窗口句柄 // Windowed BOOL 全屏或窗口 // EnableAutoDepthStencil BOOL 激活深度缓冲 // AutoDepthStencilFormat D3DFORMAT 深度缓冲格式 // Flags DWORD 没搞清楚 // 通常为0 或D3DPRESENTFLAG_LOCKABLE_BACKBUFFER。 // 不太清楚是用来做什么的，看字面好像是一个能否锁定后备缓冲区的标记。 // D3DPRESENTFLAG_DISCARD_DEPTHSTENCIL 丢弃模板缓冲区 // FullScreen_RefreshRateInHz UINT 显示器刷新率 // PresentationInterval UINT 图像最大刷新速度 D3DPRESENT_PARAMETERS d3dpp; ZeroMemory( &d3dpp, sizeof( d3dpp ) ); d3dpp.Windowed = TRUE; // 设置为窗体模式 d3dpp.SwapEffect = D3DSWAPEFFECT_DISCARD; // 设置缓冲交换类型 d3dpp.BackBufferFormat = D3DFMT_UNKNOWN; // 设置背景缓冲的格式 // 创建一个D3D设备。 // 字段值 参数名 中文意思 // D3DADAPTER_DEFAULT Adapter 指示使用哪一块儿显卡来创建 D3D 设备 // D3DDEVTYPE_HAL DeviceType 指明指定的显卡的类型，一般为D3DEVTYPE_HAL // hWnd hFocusWindow 要渲染的窗体的句 // D3DCREATE_SOFTWARE_VERTEXPROCESSING BehaviorFlags 处理定点的方式 // &d3dpp pPresentationParmeters 刚刚创建的结构体, // &g_pd3dDevice ppReturnedDeviceInterface 用于记录返回 D3D 设备的指针。 if( FAILED( g_pD3D->CreateDevice(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING,&d3dpp, &g_pd3dDevice))) { return E_FAIL; } // 没有出现意外，返回成功。 return S_OK; } // 清除所有的 D3D 信息。 VOID Cleanup() { // 清除 D3D 设备。 if( g_pd3dDevice != NULL ) g_pd3dDevice->Release(); // 清除 D3D 主接口。 if( g_pD3D != NULL ) g_pD3D->Release(); } // 使用 D3D 进行一次绘制。 VOID Render() { // 判断 D3D 界面是否有效。 if( NULL == g_pd3dDevice ) return; // 清屏操作。 // 字段值 参数名 中文意思 // 0 Count 设置要清空的矩形数目，如果要清空整个窗口，则设为0. 全屏幕式后备缓冲的宽度 // NULL pRects 一个 D3DRECT 结构体的数组。配合 Count 字段，可以清除屏幕的某一部分。 // D3DCLEAR_TARGET Flags 一组标记，指定要清除的缓冲区，分别为 // D3DCLEAR_STENCIL: 清除模板缓冲区 // D3DCLEAR_TARGET: 清除目标缓冲区（通常为后备缓冲区） // D3DCLEAR_ZBUFFER: 清除深度缓冲区。 // D3DCOLOR_XRGB(0,0,255) Color 目标区域的颜色。 // 1.0f float 设置 Z 缓冲的初始值。 // 0 Stencil 设置范本缓冲的初始值,它的取值范围是0到2的n次方减1。其中n是范本缓冲的深度。 g_pd3dDevice->Clear( 0, NULL, D3DCLEAR_TARGET, D3DCOLOR_XRGB( 0, 0, 255 ), 1.0f, 0 ); // 开始背景绘制 if( SUCCEEDED( g_pd3dDevice->BeginScene() ) ) { // 这里可以加入自己写的绘制程序。 // 结束绘制。 g_pd3dDevice->EndScene(); } // 将缓冲区内的图形信息显示到窗口中。 g_pd3dDevice->Present( NULL, NULL, NULL, NULL ); } //----------------------------------------------------------------------------- // Name: MsgProc() // Desc: The window's message handler //----------------------------------------------------------------------------- // 自定义的消息处理程序。 // 参数 hWnd,窗体的句柄 // 参数 msg,窗体消息的编号。 // 参数 wParam,lpCmdLine,命令行参数 // 参数 nShowCmd,窗口显示方式的值。 LRESULT WINAPI MsgProc( HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam ) { // 不同于以前我的代码习惯，直接在 switch 的分支中使用了 return 返回结果。 switch( msg ) { case WM_DESTROY: // 窗体被销毁的消息。 // 清除所有 D3D 的资源。 Cleanup(); // 发送一个 WM_QUIT 消息，这个消息用来结束主程序中的 while 循环。 PostQuitMessage( 0 ); return 0; case WM_PAINT: // 窗体重绘的消息。 // 进行基于 D3D 的绘制工作。 Render(); // 使绘制生效，不再重复进入 WM_PAINT 。 ValidateRect( hWnd, NULL ); return 0; } // 返回值使用默认消息处理程序的处理结果。 return DefWindowProc( hWnd, msg, wParam, lParam ); } // 程序入口，名字是 wWinMain 而不是 WinMain 的原因是字符集使用了 Unicode 字符集。 // 参数 hInstance,应用程序实例的句柄 // 参数 hPrevInstance,当前实例的前一个实例的句柄。据介绍此参数在Windows 系统中总是为 NULL. // 参数 lpCmdLine,命令行参数 // 参数 nShowCmd,窗口显示方式的值。 INT WINAPI wWinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPWSTR lpCmdLine,int nShowCmd) { // 注册窗体类(Windows Class) // 字段值 参数名 中文意思 // sizeof(WNDCLASSEX) cbSize 尺寸, // CS_CLASSDC style 类型; // MsgProc lpfnWndProc 窗体消息处理程序; // 0L cbClsExtra 窗体类扩展数据区长度; // 0L cbWndExtra 窗体扩展数据区长度, // GetModuleHandle(NULL) hInstance 窗体类实例的句柄。 // NULL hIcon 窗体图标 // NULL hCursor 窗体鼠标指针 // NULL hbrBackground 背景刷子 // NULL lpszMenuName 菜单在资源文件中的名字 // L"My Windows Class" lpszClassName 窗体类的名称 // NULL hIconSm 窗体的小图标-NT4.0以后添加的新字段。 WNDCLASSEX wc= { sizeof(WNDCLASSEX),CS_CLASSDC,MsgProc,0L,0L, GetModuleHandle(NULL),NULL,NULL,NULL,NULL, L"My Windows Class",NULL }; // 参数值 参数名 中文意思 // &wc WNDCLASSEX * 用于注册的描述了窗体类信息的结构体的指针。 RegisterClassEx(&wc); // 创建应用程序的主窗口 // 参数值 参数名 中文意思 // L"My Windows Class" lpClassName 窗体所属窗体类的名称. // L"第一个D3D窗口" lpWindowName 窗体的名称-其实应该说是窗体的标题。 // WS_OVERLAPPEDWINDOW dwStyle 窗体的类型 // 100,100 x,y 窗体显示的起始位置 // 300,300 nWidth,nHeight 窗体的尺寸 // NULL hWndParent 窗体所属父窗体的句柄 // NULL hMenu 窗体主菜单的句柄 // wc.hInstance hInstance 窗体所属应用程序实例的句柄 // NULL lpParam 一个指针,作为参数传递给窗口的 WM_CREATE 消息。 HWND hWnd = CreateWindowW(L"My Windows Class",L"第一个D3D窗口", WS_OVERLAPPEDWINDOW,100,100,300,300, NULL,NULL,wc.hInstance,NULL); // 初始化 D3D 环境 // SUCCEEDED 一个宏，判断返回值是否为 S_OK。也就是 0L if ( SUCCEEDED(InitD3D(hWnd))) { // 显示窗口 // 参数值 参数名 中文意思 // hWnd hWnd 要显示窗体的句柄 // SW_SHOWDEFAULT nCmdShow 窗体显示形式的常量定义，常见的有 SW_SHOWDEFAULT/SW_HIDE/SW_NORMAL 等 ShowWindow( hWnd, SW_SHOWDEFAULT ); // 更新窗体的显示 // 参数值 参数名 中文意思 // hWnd hWnd 要更新显示内容的窗体。 // 注：介绍中，UpdateWindow 函数通过向窗体发送 WM_PAINT 消息来更新窗体的客户区。 UpdateWindow( hWnd ); // 处理消息循环 - 我承认，这个工作以前还没有自己写代码处理过。 // MSG 记录窗体消息的结构体， // GetMessage 从消息队列中取出一个消息。如果是 WM_QUIT 消息返回 0；其他消息返回 非0；出现错误返回 -1. // 参数值 参数名 中文意思 // &msg lpMsg 存放取出的消息的指针。 // NULL hWnd 要获取消息的窗体的句柄，如果为NULL表示所有窗口的消息。 // 0 wMsgFilterMin 试图获取的消息的最小编号。小于这个值的消息不取。 // 0 wMsgFilterMax 试图获取的消息的最大编号，大于这个值的消息不取。 // // TranslateMessage 将消息中的虚拟按键信息转换为字符信息。应该是按下键盘后按键信息不适合使用，所以需要转换吧。 // 参数值 参数名 中文意思 // &msg lpMsg 存放消息内容的指针。 // DispatchMessage 将消息交给窗体的消息处理程序进行处理。这个应该是个干实事儿的了。 // 参数值 参数名 中文意思 // &msg lpMsg 存放消息内容的指针。 MSG msg; while( GetMessage( &msg, NULL, 0, 0 ) ) { TranslateMessage( &msg ); DispatchMessage( &msg ); } } // 注销开始注册的窗体类。 // 参数值 参数名 中文意思 // L"My Windows Class" lpClassName 窗体所属窗体类的名称. // hInstance hInstance 窗体窗体类的实例句柄。 // 注：开始写的时候，因为一知半解，参数 lpClassName，使用了与注册时不同的名称，但是没有报错提示，程序也正常运行。 // 对此有一些不够理解。先放放吧，以后要弄清楚。 UnregisterClass( L"My Windows Class", wc.hInstance ); // 搞定了，程序执行完毕，返回 0 就OK了。 // 这里说明下:在 C++ 中，0 是 FLASE，1 是 TRUE.但是程序往往返回 0 作为成功调用。有点迷惑 return 0; }