简介面向希望掌握 Visual C 与 DirectX 结合开发自定义图形界面的学习者这份示例工程完整展示了如何摆脱传统窗口控件利用 Direct3D 绘制自定义按钮、列表、滑动条和消息框构建类似游戏内菜单的交互界面。压缩包共包含 79 个文件以 38 个头文件和 36 个源文件为主体同时带有两个图标文件以及项目文件、解决方案、资源脚本各一个整体大小约 121KB代码结构紧凑便于逐模块阅读。示例项目配合控件库覆盖 Direct3D 初始化、视口与投影设置、渲染循环、键盘输入处理、位图字体加载等常见流程从交换链与深度缓冲的底层配置到按钮、列表、滑动条的消息响应均有涉及还包含全局封装类可帮助理解 DirectX 渲染管线和 UI 消息分发机制。对于想研究游戏界面开发、自绘控件原理或 DirectX 应用架构的开发者而言这是一份值得参考的源码集合工程小而不杂是 DirectX UI 入门与二次开发的良好起点目前已有 328 人浏览学习。1. 在DirectX里硬画GUI这套UI库解决的真问题拿到这份“visual c基于DirectX开发制作的GUI用户界面.zip”里面既不是单纯的界面Demo也不是完整商业引擎而是一套用VC加DirectX从零手写的游戏UI库附带一个叫BattleTank的示例工程。凡是做DirectX全屏渲染的人一定经历过MFC原生的按钮贴在窗口句柄上跑到全屏模式下根本不显示普通对话框窗口也无法跟3D内容做半透明叠加。出路只有一条——把按钮、文本框、消息框都当成纹理画上显卡再用一套自建的消息机制处理鼠标命中。这套代码把这条路的骨架搭好了渲染层有CD3DGlobal、CD3DUtility、KeyControlUI核心层有CUICore、CUIWindow、CUIMessage、CUIDisktop控件层有CUIButton、CUIMessageBox、CUIPopupDlg、CUISlider、CUITextBox、CUIListBox甚至还有IME输入法对接和音频反馈模块。适合准备给DirectX工程配一套自绘界面的开发者也适合想学界面框架怎么组织的人。相比从零去写一个UI框架这份资源能给你省下大量前期设计的时间。2. 先看架构再动手从文件清单逆推它的三层设计拿到一个陌生的C工程我习惯先不打开代码而是把文件清单按前缀分组反向推它的架构。这份资源里的文件命名非常规整几乎是把目录结构都写在类名上了。分完组你就会发现它和CEGUI那类经典游戏UI框架的思路一致渲染层、消息核心层、控件层三者解耦得相当清晰。分组代表性文件职责渲染引擎层CD3DGlobal.cpp/h、CD3DUtility.cpp/h、KeyControl.cpp/h、CUIBaseBuffer、CUIBaseBitmap、CUIBaseFont、CUIBaseSound封装Direct3D设备、位图纹理、字体、输入收集UI核心层CUICore.cpp/h、CUIMessage.cpp/h、CUIBaseMessage.cpp/h、CUIWindow、CUIDisktop、CGUIGlobal控件容器、消息分发、全局上下文控件层CUIButton、CUIMessageBox、CUIPopupDlg、CUISlider、CUIListBox、CUITextBox、CUICursor、CUIPicture具体可交互元素辅助模块CUIBaseFilePathLoader、CUIBaseStringTableLoader、CUIBaseErrorLogRecorder、ime.cpp资源路径查找、字符串表、日志、输入法2.1 为什么游戏UI不能沿用MFC自绘控件的底层逻辑MFC控件本质上是独立的子窗口每个按钮都有一个HWND系统负责绘制和命中测试。这在普通桌面程序没问题但放到DirectX全屏渲染下就尴尬了全屏设备独占显示子窗口的GDI绘制内容根本到不了后缓冲就算强行用窗口模式把D3D画面合成到窗口里控件和3D场景也无法在同一个渲染流程里做透明混合。所以游戏UI选择把所有控件“画”到显卡上。一个按钮不再有窗口句柄它只是一块矩形区域加几张状态图片。鼠标点没点上通过矩形碰撞判断按钮画成什么颜色、按下时要不要换个贴图完全由代码在渲染循环里决定。这套代码里的CUIControl基类就是为这种方案服务的。2.2 CUIControl把状态、几何、命中测试收进基类CUIControl是整套控件体系的地基。它把每个控件最共性的东西抽出来自己在UI坐标系里的矩形区域、当前状态正常/悬停/按下/禁用、可见性、可用性、焦点标记。子类继承后只要补两个东西——Render()把自己画出来OnMessage()响应消息。这是典型的模板方法模式写新控件时改动面很小。// 控件公共基类所有自绘控件都从这里继承 class CUIControl { public: enum UI_STATE { UI_STATE_NORMAL 0, // 正常状态 UI_STATE_HOVER 1, // 鼠标悬停 UI_STATE_PRESS 2, // 鼠标按下 UI_STATE_DISABLED 3, // 禁用输入不响应 }; CUIControl() : m_state(UI_STATE_NORMAL), m_bVisible(TRUE), m_bEnable(TRUE), m_bFocus(FALSE) {} virtual ~CUIControl() {} virtual void Update(float dt) { } virtual void Render() 0; // 子类负责把自己画到纹理上 virtual int OnMessage(CUIBaseMessage* pMsg) { return 0; } void SetRect(RECT rc) { m_rcPos rc; } void SetState(UI_STATE s) { m_state s; } BOOL IsPointIn(const POINT pt) const { return PtInRect(m_rcPos, pt); } protected: RECT m_rcPos; // 控件在UI逻辑坐标系中的矩形 UI_STATE m_state; // 当前交互状态 BOOL m_bVisible; // 是否参与绘制 BOOL m_bEnable; // 是否参与消息分发 BOOL m_bFocus; // 是否持有键盘焦点 };这里有个细节值得注意IsPointIn()用PtInRect做矩形命中对按钮、文本框这类矩形控件足够。但如果你以后要加圆形按钮或不规则形状这里得换成子类可覆盖的虚函数。基类里把常见需求做掉特殊场景留给子类扩展这套代码的设计分寸就在这里。2.3 消息分发Windows消息到了D3D世界要二次翻译Win32程序里系统把鼠标消息按窗口句柄投递。自绘UI没有那么多窗口句柄所有控件共享一个宿主窗口所以需要一个中间层把Win32消息翻译成UI内部消息再沿控件树分发。这套代码里承担这个角色的是CUIDisktop加CUIMessageBox的组合宿主窗口的WndProc收到WM_MOUSEMOVE、WM_LBUTTONDOWN后先转成CUIBaseMessage交到顶层容器CUIDisktop由它从上往下逐级找命中控件。// CUIDisktop::DispatchMessage把输入消息沿控件树自顶向下分发 int CUIDisktop::DispatchMessage(CUIBaseMessage* pMsg) { // 倒序遍历子控件后加入的控件绘制在上层命中优先级也更高 for (int i m_arrChild.GetCount() - 1; i 0; i--) { CUIControl* pCtrl m_arrChild.GetAt(i); if (!pCtrl-IsPointIn(pMsg-m_pt)) continue; // 矩形没命中就跳过 if (!pCtrl-IsEnable()) continue; // 禁用控件不响应输入 int nRet pCtrl-OnMessage(pMsg); // 命中了交给控件自己处理 if (nRet ! 0) return nRet; // 非0表示事件被消费不再继续下传 } return 0; }分发顺序我特别提一句for是倒序遍历这对应“后创建的子控件显示在最上面”的绘制规则。比如弹窗覆盖在主界面之上弹窗肯定是在主界面之后加入子控件列表的倒序分发保证先让弹窗拿到鼠标事件符合视觉层级直觉。消息返回值用非0表示消费这样可防止点击弹窗上的按钮时事件穿透到下层的主界面按钮——这是自绘UI最容易出现的一类问题。3. 渲染底座Direct3D设备与2D位图管线怎么伺候UI自绘UI说到底是“把图片按坐标贴到后缓冲里”但真要把这件事做稳绕不开Direct3D设备管理、纹理生命周期、字体渲染三块。这套代码用CD3DGlobal包住设备CUIBitmapMgr管纹理CUIBaseFont管字体分工很清晰。3.1 CD3DGlobal创建设备时就要想清楚的事Direct3D设备是整个渲染的根。设备创建参数没设对后面所有绘制都是空中楼阁。看CD3DGlobal的初始化流程一眼就能判断作者写这套代码时对D3D9的设备行为很熟先创建D3D对象再读当前显示模式填呈现参数最后创建设备失败时从硬件顶点处理降级到软件模式。// 初始化Direct3D9设备全屏/窗口、后台缓冲、深度模板一次性配好 bool CD3DGlobal::CreateD3D(HWND hWnd, bool bFullscreen, int nWidth, int nHeight) { // 1. 创建D3D9对象D3D_SDK_VERSION用于校验头文件与d3d9.lib版本一致 m_pD3D Direct3DCreate9(D3D_SDK_VERSION); if (!m_pD3D) return false; // 2. 读取当前显示模式后台缓冲格式跟随桌面避免色彩转换 D3DDISPLAYMODE d3ddm; if (FAILED(m_pD3D-GetAdapterDisplayMode(D3DADAPTER_DEFAULT, d3ddm))) return false; // 3. 呈现参数窗口模式用桌面格式全屏模式必须写清楚宽高 D3DPRESENT_PARAMETERS d3dpp; ZeroMemory(d3dpp, sizeof(d3dpp)); d3dpp.Windowed !bFullscreen; d3dpp.BackBufferFormat d3ddm.Format; d3dpp.BackBufferWidth nWidth; d3dpp.BackBufferHeight nHeight; d3dpp.SwapEffect D3DSWAPEFFECT_DISCARD; d3dpp.EnableAutoDepthStencil TRUE; d3dpp.AutoDepthStencilFormat D3DFMT_D16; d3dpp.hDeviceWindow hWnd; // 4. 创建设备显卡支持时优先硬件顶点处理失败降级到软件 HRESULT hr m_pD3D-CreateDevice( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_HARDWARE_VERTEXPROCESSING | D3DCREATE_MULTITHREADED, d3dpp, m_pDevice); if (FAILED(hr)) { hr m_pD3D-CreateDevice( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING, d3dpp, m_pDevice); } return SUCCEEDED(hr); }几个参数值得展开说。D3DSWAPEFFECT_DISCARD在D3D9里是性能最好的交换方式代价是Present后后台缓冲内容不可靠所以每帧必须完整重绘全部UI——这正好符合自绘UI的渲染模型。D3DCREATE_MULTITHREADED让D3D对象可以在多个线程调用UI贴图加载如果放在异步线程里这个标志就是前提。D3DFMT_D16是16位深度缓冲纯2D界面其实用不到深度但保留它能在同一设备里混排3D场景BattleTank这种带游戏画面的程序就靠它实现UI和3D共存。3.2 CUIPicture与位图管理纹理加载决定显存命运UI上每个按钮、背景、图标本质上都是一张纹理。这套代码里CUIPicture负责“一张图的一生”从文件加载纹理、持有宽高、交给Sprite绘制。加载函数是UI系统里最容易泄漏显存的地方反复进出界面不释放纹理很快就能看到显存爆掉。// 从文件加载位图为纹理由CUIPicture持有绘制交给Sprite bool CUIPicture::LoadFromFile(const char* szFile, CD3DGlobal* pD3D) { // 1. 如果之前已加载过纹理先释放再加载避免显存泄漏 if (m_pTexture) { m_pTexture-Release(); m_pTexture NULL; } // 2. 按原始尺寸加载不参与缩放透明图建议用带Alpha通道的DDS HRESULT hr D3DXCreateTextureFromFileExA( pD3D-GetDevice(), szFile, D3DX_DEFAULT, D3DX_DEFAULT, // 宽高用默认值保持原始尺寸 1, 0, D3DFMT_UNKNOWN, D3DPOOL_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, m_pTexture); if (FAILED(hr)) return false; // 3. 记录纹理真实宽高布局代码要用它计算显示区域 D3DSURFACE_DESC desc; m_pTexture-GetLevelDesc(0, desc); m_nWidth desc.Width; m_nHeight desc.Height; return true; } // 绘制把纹理按目标矩形整体贴到屏幕color控制整体透明度 void CUIPicture::Render(int nX, int nY, D3DCOLOR color) { if (!m_pTexture) return; RECT rc { nX, nY, nX m_nWidth, nY m_nHeight }; m_pSprite-Draw(m_pTexture, NULL, NULL, rc, color); }这里的D3DPOOL_DEFAULT有个讲究纹理默认放在显存速度快但设备丢失时会被系统销毁必须在OnLostDevice里释放、OnResetDevice里重建。如果你为了省事改用D3DPOOL_MANAGEDD3D9会在设备重置后自动恢复纹理代价是系统内存和显存之间多一次拷贝。2D UI贴图尺寸小、数量多我一般还是选D3DPOOL_MANAGED省去纹理重建的代码但要注意D3DXCreateTextureFromFileExA的MipLevels我故意传1UI贴图不需要mipmap链多级纹理只会浪费显存。3.3 CUIBaseFont中文显示不是玄学是字符集问题DirectX本身不带字体引擎UI文字靠的是D3DX提供的D3DXCreateFontIndirect本质是把系统字体光栅化成纹理再绘制。这套代码里CUIBaseFont封装的就是这件事。初学的人经常踩同一个坑英文显示正常中文全变成方框。// 创建支持中文的D3DX字体UI文本绘制用它 HRESULT CUIBaseFont::CreateFont(CD3DGlobal* pD3D, int nHeight, const char* szFace) { D3DXFONT_DESC desc; ZeroMemory(desc, sizeof(desc)); desc.Height nHeight; // 字体的像素高度注意不是pt desc.Weight FW_NORMAL; // 常规字重标题栏可以单独加粗 desc.CharSet DEFAULT_CHARSET; // 想显示中文这里不能设成ANSI_CHARSET desc.OutputPrecision OUT_DEFAULT_PRECIS; desc.Quality DEFAULT_QUALITY; lstrcpynA(desc.FaceName, szFace ? szFace : Microsoft YaHei, LF_FACESIZE); return D3DXCreateFontIndirect(pD3D-GetDevice(), desc, m_pFont); }核心就在CharSet这个参数上。设成ANSI_CHARSET时字体光栅化只覆盖英文和西欧字符集中文再好的字体也画不出字形设成DEFAULT_CHARSET系统会根据FaceName自动选合适的中文字体。FaceName建议直接给“Microsoft YaHei”宋体在低分辨率下锯齿明显雅黑的hinting处理更适合UI呈现。还有一点字体纹理注意在设备丢失时走OnLostDevice/OnResetDevice和普通纹理一套逻辑处理即可否则字体对象会失效。4. 控件落地按钮、消息框、文本框的改法与挂接架构层搭完真正跟你业务打交道的是控件。这套代码里控件写得比较完整我挑三个最常见的讲清楚它们的交互逻辑改起来能直接对齐自己的需求。4.1 按钮三态切换加“按下后松开才算点击”按钮是UI交互的最小单元难不在画而在状态切换时机。常见做法是三态贴图正常一张、悬停一张、按下一张。代码里用同一张图片数组按下标取值交互逻辑集中在OnMessage里。点击不能按下就算要等鼠标在按钮区域内松开才触发回调防止用户按下去又移走导致误操作。// 按钮三态切换悬停、按下、松手判定一次写完 int CUIButton::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_MOUSEMOVE) { // 鼠标在按钮内显示悬停态移出恢复常态 SetState(IsPointIn(pMsg-m_pt) ? UI_STATE_HOVER : UI_STATE_NORMAL); } else if (pMsg-m_uMsg GUI_MSG_LBUTTONDOWN IsPointIn(pMsg-m_pt)) { SetState(UI_STATE_PRESS); m_bPressed TRUE; // 记录按下状态松手时要用 } else if (pMsg-m_uMsg GUI_MSG_LBUTTONUP) { // 在按钮内松开才算有效点击杜绝拖出区域误触发 if (m_bPressed IsPointIn(pMsg-m_pt)) { if (m_pfnCallback) m_pfnCallback(m_dwUserData); } m_bPressed FALSE; SetState(UI_STATE_NORMAL); } return 0; }按钮回调用函数指针加UserData的方式而不是直接调用具体业务函数这样控件层不用依赖上层逻辑。你可以把回调绑定到任意类的成员函数上m_dwUserData用来携带控件ID之类上下文。这个模式在C11之前的老VC工程里非常常见放到现在也可以顺手换成std::function接口更灵活。4.2 CUIPopupDlg模态弹窗在自绘UI里是个独立消息泵模态弹窗和普通控件最大的区别是它需要一个“阻塞”效果弹出来以后底层界面不能再响应点击。Win32的模态对话框靠内部消息循环实现自绘UI也遵循这个套路——CUIPopupDlg::DoModal里自己跑一个消息泵不断收集输入、分发给弹窗控件、渲染、Present直到用户关闭弹窗才退出。// 模态弹窗独立消息泵阻塞调用方直到窗口关闭 int CUIPopupDlg::DoModal(CD3DGlobal* pD3D) { m_bModal TRUE; Show(TRUE); CUIBaseMessage msg; while (m_bModal) { // 1. 收集本帧键盘鼠标输入转成UI内部消息 KeyControl::CollectInput(m_msgQueue); // 2. 弹窗及子控件逐个消费队列里的消息 while (m_msgQueue.Pop(msg)) { DispatchMessage(msg); } // 3. 渲染先画底层场景再画弹窗本身注意别重复渲染底层 GetCore()-RenderScene(); Render(); pD3D-Present(); } Show(FALSE); return m_nResult; }这段代码有几个设计点。KeyControl把系统输入抽象到m_msgQueue弹窗的消息泵能独立收集输入意味着弹窗运行期间主窗口的输入不会被消费掉。渲染阶段分两步先画场景再画弹窗保证弹窗浮在3D画面之上如果底层场景已经在主循环里渲染过了这里还再渲染一次就会出现透明区域闪烁。m_nResult是关闭弹窗时填写的返回值让调用方知道用户点了“确定”还是“取消”。4.3 文本框与滑块IME输入和值范围换算文本框的难点在于中文输入。DirectX不处理IME全靠ime.cpp里那套封装对接Windows输入法控件获得焦点时打开IME并预置组合字符串收到WM_CHAR时把组合结果送进来。滑块则是另一个典型交互——把鼠标位移按比例折算成数值。// 文本框焦点时打开IME字符消息逐字追加 int CUITextBox::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_SETFOCUS) { m_bFocus TRUE; Ime_SetOpenStatus(GetHostWindow(), TRUE); // 打开输入法 Ime_SetCompositionString(m_szText); // 把现有文本置入组合区 } else if (pMsg-m_uMsg GUI_MSG_CHAR) { // 退格删除最后一个字符普通字符直接追加 if (pMsg-m_wParam VK_BACK m_szText.GetLength() 0) { m_szText.Delete(m_szText.GetLength() - 1); } else { m_szText.AppendChar((TCHAR)pMsg-m_wParam); } if (m_pfnChange) m_pfnChange(this); } return 1; // 文本框消费所有字符消息防止穿透给下层控件 }// 滑块拖动时把X偏移按比例换算成[min,max]区间的值 int CUISlider::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_MOUSEMOVE m_bDrag) { int nTrackWidth m_rcPos.right - m_rcPos.left - m_nThumbWidth; int nOffset pMsg-m_pt.x - m_rcPos.left; // 夹紧到轨道两端避免滑块拖出边界 if (nOffset 0) nOffset 0; if (nOffset nTrackWidth) nOffset nTrackWidth; m_nValue m_nMin (m_nMax - m_nMin) * nOffset / nTrackWidth; if (m_pfnChange) m_pfnChange(this); } return 0; }文本框返回1消费消息是有意的字符消息如果不拦截按下的字母键还会继续传给底层按钮控件导致对话框里输着字背景按钮却在反复响应。滑块换算里的m_nThumbWidth容易被忽略——滑块的可见“把手”有自己的宽度可拖拽范围是轨道宽减去把手宽否则滑块拉到最右边时把手会越出边界。5. 避坑从别处移植这套UI最容易翻车的五个点这套UI库的代码质量在同类资源里算好的但毕竟是老VC工程直接把它加进新项目时编译和运行两头都会遇到坑。我把最常见的五个问题按“现象 → 原因 → 解决”列出来都是自己改过之后实测的记录。5.1 编译与链接字符集、预编译头、DirectX库现象一把源码拷进新工程所有中文注释和字符串全是乱码甚至直接报错C4819。原因原工程用的是多字节字符集还是Unicode跟你的工程属性不一致。源码里大量用到TCHAR它本身是条件编译宏编译器按工程字符集决定展开成char还是wchar_t。一旦两边字符集不一致字符串字面量的编码和解码就对不上。解决项目属性 → 配置属性 → 常规 → 字符集选“使用Unicode字符集”。源文件另存为UTF-8 with BOM保证VS的cl.exe能正确识别中文。顺手把警告C4819在项目属性里关掉这个警告只影响代码页不影响生成结果。现象二编译报错说stdafx.h: No such file or directory。原因这套工程依赖Visual C的预编译头机制。stdafx.cpp里#include stdafx.h并且“创建预编译头”其他.cpp统一“使用预编译头”。新工程默认设置不匹配编译器找不到生成好的.pch文件。解决新建一个空的Win32工程把预编译头打开再把源码文件整个加进去。具体设置是stdafx.cpp→ 预编译头 → 创建/Yc其余.cpp→ 预编译头 → 使用/Yu。不要手动关闭预编译头硬编这套代码的头文件依赖顺序已经按预编译头设计了。现象三链接报错LNK2019 unresolved external symbol D3DXCreateTextureFromFileExA。原因只加了Direct3D核心库漏了D3DX工具库。UI系统里的纹理加载、字体创建全在D3DX里没链库自然找不到符号。解决项目属性 → 链接器 → 输入 → 附加依赖项至少加d3d9.lib、d3dx9.lib、dxguid.lib、winmm.lib。Debug配置用d3dx9d.lib带d后缀的调试版Release用d3dx9.lib。如果机器上没有旧版D3DX运行库程序起来时还会提示找不到d3dx9_xx.dll这时候用directx修复工具把运行库补一份就行这套代码跑在XP到Win10都正常。5.2 运行期设备丢失、分辨率适配、混合顺序现象四游戏切到全屏再切回窗口所有按钮背景全变黑。原因Direct3D9在切换分辨率或失去焦点长时间不渲染时设备会进入“丢失”状态显存里的纹理被系统回收。代码继续Draw在丢失设备上不会报错但画面就是黑的。解决在渲染循环里检测D3DERR_DEVICELOST收到后调用CUIBaseFont::OnLostDevice()、CUIBitmapMgr::ReleaseAll()释放显存资源等到D3DERR_DEVICENOTRESET时再重建字体和纹理。最省事的做法是把所有图片路径存一张表设备重置后遍历重载。现象五分辨率从1280×720改成1920×1080按钮位置全部错乱。原因控件坐标是像素绝对值窗口变大了控件还在原来的像素位置没有跟着等比缩放。这在自绘UI里最容易被忽略因为窗口模式下拖动拉大窗口问题立刻暴露。解决引入逻辑分辨率。比如固定UI设计分辨率为1024×768所有控件的坐标都按这个坐标系排布渲染前算一次缩放比例scaleX screenWidth / 1024、scaleY screenHeight / 768把根容器整体缩放。鼠标坐标要在派发消息前做逆缩放不然命中检测全偏移。现象六UI画面有拖影或者半透明控件边缘闪白边。原因Present没开垂直同步渲染帧率超过显示器刷新率导致撕屏半透明控件绘制的混合顺序不对透明通道叠加出白边。解决呈现参数里设置PresentationInterval D3DPRESENT_INTERVAL_DEFAULT锁到刷新率。绘制顺序上不透明控件先画半透明控件按Z序从远到近画两个半透明控件相交时后画的会盖掉先画的Alpha这个顺序反了就会出现明显的视觉断层。6. 把BattleTank的UI壳换成你的逻辑移植挂接与性能验证资源里的BattleTank工程既是示例也是最好的改造起点。想让它跑你的业务逻辑最干净的做法是保留UI库和渲染底座不动只替换主循环里的输入来源和按钮回调。// 在主循环里把UI更新和渲染挂进你的渲染流程 while (TRUE) { // 1. 收集原始输入键盘鼠标统一进KeyControl KeyControl::Update(); // 2. 把输入转成CUIBaseMessage交给UI根容器分发 CUIBaseMessage msg; while (KeyControl::PopMessage(msg)) g_pCUIDisktop-DispatchMessage(msg); // 3. 先更新逻辑再更新UIUI控件的值跟着业务状态走 g_pGameLogic-Update(dt); g_pCUIDisktop-Update(dt); // 4. 渲染顺序固定3D场景在底层UI最后画 g_pGameLogic-Render(); g_pCUIDisktop-Render(); // 5. Present前检查设备状态丢失时走资源重建 HRESULT hr g_pD3DGlobal-Present(); if (hr D3DERR_DEVICELOST) g_pCUIDisktop-OnDeviceLost(); }这套流程里UI层的依赖被压到最低它不关心你的游戏逻辑只等消息来。所以你完全可以把BattleTank的名字换成自己的业务前缀KeyControl换成你自己的输入抽象层只要保证DispatchMessage能拿到CUIBaseMessage就行。移植完成后建议立刻做两件验证。第一用QueryPerformanceCounter包住CUIDisktop::Render()统计UI渲染耗时纯2D界面在1万控件以下应该压在1毫秒内超出就查是不是有控件重复加载纹理。第二临时把清屏颜色改成固定值比如D3DCOLOR_XRGB(255, 0, 255)如果能看到控件残影说明混合状态或Sprite的绘制状态在帧之间没复位。我从那以后每次接手自绘UI工程都强制先做这两步验证再开始改业务。这套UI库代码结构清晰、边界完整比很多商业引擎里打包好的UI系统更适合当作学习骨架。希望这份拆解帮你在 DirectX 自绘界面的路上少绕几个弯。本文还有配套的精品资源点击获取
简介面向希望掌握 Visual C 与 DirectX 结合开发自定义图形界面的学习者这份示例工程完整展示了如何摆脱传统窗口控件利用 Direct3D 绘制自定义按钮、列表、滑动条和消息框构建类似游戏内菜单的交互界面。压缩包共包含 79 个文件以 38 个头文件和 36 个源文件为主体同时带有两个图标文件以及项目文件、解决方案、资源脚本各一个整体大小约 121KB代码结构紧凑便于逐模块阅读。示例项目配合控件库覆盖 Direct3D 初始化、视口与投影设置、渲染循环、键盘输入处理、位图字体加载等常见流程从交换链与深度缓冲的底层配置到按钮、列表、滑动条的消息响应均有涉及还包含全局封装类可帮助理解 DirectX 渲染管线和 UI 消息分发机制。对于想研究游戏界面开发、自绘控件原理或 DirectX 应用架构的开发者而言这是一份值得参考的源码集合工程小而不杂是 DirectX UI 入门与二次开发的良好起点目前已有 328 人浏览学习。1. 在DirectX里硬画GUI这套UI库解决的真问题拿到这份“visual c基于DirectX开发制作的GUI用户界面.zip”里面既不是单纯的界面Demo也不是完整商业引擎而是一套用VC加DirectX从零手写的游戏UI库附带一个叫BattleTank的示例工程。凡是做DirectX全屏渲染的人一定经历过MFC原生的按钮贴在窗口句柄上跑到全屏模式下根本不显示普通对话框窗口也无法跟3D内容做半透明叠加。出路只有一条——把按钮、文本框、消息框都当成纹理画上显卡再用一套自建的消息机制处理鼠标命中。这套代码把这条路的骨架搭好了渲染层有CD3DGlobal、CD3DUtility、KeyControlUI核心层有CUICore、CUIWindow、CUIMessage、CUIDisktop控件层有CUIButton、CUIMessageBox、CUIPopupDlg、CUISlider、CUITextBox、CUIListBox甚至还有IME输入法对接和音频反馈模块。适合准备给DirectX工程配一套自绘界面的开发者也适合想学界面框架怎么组织的人。相比从零去写一个UI框架这份资源能给你省下大量前期设计的时间。2. 先看架构再动手从文件清单逆推它的三层设计拿到一个陌生的C工程我习惯先不打开代码而是把文件清单按前缀分组反向推它的架构。这份资源里的文件命名非常规整几乎是把目录结构都写在类名上了。分完组你就会发现它和CEGUI那类经典游戏UI框架的思路一致渲染层、消息核心层、控件层三者解耦得相当清晰。分组代表性文件职责渲染引擎层CD3DGlobal.cpp/h、CD3DUtility.cpp/h、KeyControl.cpp/h、CUIBaseBuffer、CUIBaseBitmap、CUIBaseFont、CUIBaseSound封装Direct3D设备、位图纹理、字体、输入收集UI核心层CUICore.cpp/h、CUIMessage.cpp/h、CUIBaseMessage.cpp/h、CUIWindow、CUIDisktop、CGUIGlobal控件容器、消息分发、全局上下文控件层CUIButton、CUIMessageBox、CUIPopupDlg、CUISlider、CUIListBox、CUITextBox、CUICursor、CUIPicture具体可交互元素辅助模块CUIBaseFilePathLoader、CUIBaseStringTableLoader、CUIBaseErrorLogRecorder、ime.cpp资源路径查找、字符串表、日志、输入法2.1 为什么游戏UI不能沿用MFC自绘控件的底层逻辑MFC控件本质上是独立的子窗口每个按钮都有一个HWND系统负责绘制和命中测试。这在普通桌面程序没问题但放到DirectX全屏渲染下就尴尬了全屏设备独占显示子窗口的GDI绘制内容根本到不了后缓冲就算强行用窗口模式把D3D画面合成到窗口里控件和3D场景也无法在同一个渲染流程里做透明混合。所以游戏UI选择把所有控件“画”到显卡上。一个按钮不再有窗口句柄它只是一块矩形区域加几张状态图片。鼠标点没点上通过矩形碰撞判断按钮画成什么颜色、按下时要不要换个贴图完全由代码在渲染循环里决定。这套代码里的CUIControl基类就是为这种方案服务的。2.2 CUIControl把状态、几何、命中测试收进基类CUIControl是整套控件体系的地基。它把每个控件最共性的东西抽出来自己在UI坐标系里的矩形区域、当前状态正常/悬停/按下/禁用、可见性、可用性、焦点标记。子类继承后只要补两个东西——Render()把自己画出来OnMessage()响应消息。这是典型的模板方法模式写新控件时改动面很小。// 控件公共基类所有自绘控件都从这里继承 class CUIControl { public: enum UI_STATE { UI_STATE_NORMAL 0, // 正常状态 UI_STATE_HOVER 1, // 鼠标悬停 UI_STATE_PRESS 2, // 鼠标按下 UI_STATE_DISABLED 3, // 禁用输入不响应 }; CUIControl() : m_state(UI_STATE_NORMAL), m_bVisible(TRUE), m_bEnable(TRUE), m_bFocus(FALSE) {} virtual ~CUIControl() {} virtual void Update(float dt) { } virtual void Render() 0; // 子类负责把自己画到纹理上 virtual int OnMessage(CUIBaseMessage* pMsg) { return 0; } void SetRect(RECT rc) { m_rcPos rc; } void SetState(UI_STATE s) { m_state s; } BOOL IsPointIn(const POINT pt) const { return PtInRect(m_rcPos, pt); } protected: RECT m_rcPos; // 控件在UI逻辑坐标系中的矩形 UI_STATE m_state; // 当前交互状态 BOOL m_bVisible; // 是否参与绘制 BOOL m_bEnable; // 是否参与消息分发 BOOL m_bFocus; // 是否持有键盘焦点 };这里有个细节值得注意IsPointIn()用PtInRect做矩形命中对按钮、文本框这类矩形控件足够。但如果你以后要加圆形按钮或不规则形状这里得换成子类可覆盖的虚函数。基类里把常见需求做掉特殊场景留给子类扩展这套代码的设计分寸就在这里。2.3 消息分发Windows消息到了D3D世界要二次翻译Win32程序里系统把鼠标消息按窗口句柄投递。自绘UI没有那么多窗口句柄所有控件共享一个宿主窗口所以需要一个中间层把Win32消息翻译成UI内部消息再沿控件树分发。这套代码里承担这个角色的是CUIDisktop加CUIMessageBox的组合宿主窗口的WndProc收到WM_MOUSEMOVE、WM_LBUTTONDOWN后先转成CUIBaseMessage交到顶层容器CUIDisktop由它从上往下逐级找命中控件。// CUIDisktop::DispatchMessage把输入消息沿控件树自顶向下分发 int CUIDisktop::DispatchMessage(CUIBaseMessage* pMsg) { // 倒序遍历子控件后加入的控件绘制在上层命中优先级也更高 for (int i m_arrChild.GetCount() - 1; i 0; i--) { CUIControl* pCtrl m_arrChild.GetAt(i); if (!pCtrl-IsPointIn(pMsg-m_pt)) continue; // 矩形没命中就跳过 if (!pCtrl-IsEnable()) continue; // 禁用控件不响应输入 int nRet pCtrl-OnMessage(pMsg); // 命中了交给控件自己处理 if (nRet ! 0) return nRet; // 非0表示事件被消费不再继续下传 } return 0; }分发顺序我特别提一句for是倒序遍历这对应“后创建的子控件显示在最上面”的绘制规则。比如弹窗覆盖在主界面之上弹窗肯定是在主界面之后加入子控件列表的倒序分发保证先让弹窗拿到鼠标事件符合视觉层级直觉。消息返回值用非0表示消费这样可防止点击弹窗上的按钮时事件穿透到下层的主界面按钮——这是自绘UI最容易出现的一类问题。3. 渲染底座Direct3D设备与2D位图管线怎么伺候UI自绘UI说到底是“把图片按坐标贴到后缓冲里”但真要把这件事做稳绕不开Direct3D设备管理、纹理生命周期、字体渲染三块。这套代码用CD3DGlobal包住设备CUIBitmapMgr管纹理CUIBaseFont管字体分工很清晰。3.1 CD3DGlobal创建设备时就要想清楚的事Direct3D设备是整个渲染的根。设备创建参数没设对后面所有绘制都是空中楼阁。看CD3DGlobal的初始化流程一眼就能判断作者写这套代码时对D3D9的设备行为很熟先创建D3D对象再读当前显示模式填呈现参数最后创建设备失败时从硬件顶点处理降级到软件模式。// 初始化Direct3D9设备全屏/窗口、后台缓冲、深度模板一次性配好 bool CD3DGlobal::CreateD3D(HWND hWnd, bool bFullscreen, int nWidth, int nHeight) { // 1. 创建D3D9对象D3D_SDK_VERSION用于校验头文件与d3d9.lib版本一致 m_pD3D Direct3DCreate9(D3D_SDK_VERSION); if (!m_pD3D) return false; // 2. 读取当前显示模式后台缓冲格式跟随桌面避免色彩转换 D3DDISPLAYMODE d3ddm; if (FAILED(m_pD3D-GetAdapterDisplayMode(D3DADAPTER_DEFAULT, d3ddm))) return false; // 3. 呈现参数窗口模式用桌面格式全屏模式必须写清楚宽高 D3DPRESENT_PARAMETERS d3dpp; ZeroMemory(d3dpp, sizeof(d3dpp)); d3dpp.Windowed !bFullscreen; d3dpp.BackBufferFormat d3ddm.Format; d3dpp.BackBufferWidth nWidth; d3dpp.BackBufferHeight nHeight; d3dpp.SwapEffect D3DSWAPEFFECT_DISCARD; d3dpp.EnableAutoDepthStencil TRUE; d3dpp.AutoDepthStencilFormat D3DFMT_D16; d3dpp.hDeviceWindow hWnd; // 4. 创建设备显卡支持时优先硬件顶点处理失败降级到软件 HRESULT hr m_pD3D-CreateDevice( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_HARDWARE_VERTEXPROCESSING | D3DCREATE_MULTITHREADED, d3dpp, m_pDevice); if (FAILED(hr)) { hr m_pD3D-CreateDevice( D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL, hWnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING, d3dpp, m_pDevice); } return SUCCEEDED(hr); }几个参数值得展开说。D3DSWAPEFFECT_DISCARD在D3D9里是性能最好的交换方式代价是Present后后台缓冲内容不可靠所以每帧必须完整重绘全部UI——这正好符合自绘UI的渲染模型。D3DCREATE_MULTITHREADED让D3D对象可以在多个线程调用UI贴图加载如果放在异步线程里这个标志就是前提。D3DFMT_D16是16位深度缓冲纯2D界面其实用不到深度但保留它能在同一设备里混排3D场景BattleTank这种带游戏画面的程序就靠它实现UI和3D共存。3.2 CUIPicture与位图管理纹理加载决定显存命运UI上每个按钮、背景、图标本质上都是一张纹理。这套代码里CUIPicture负责“一张图的一生”从文件加载纹理、持有宽高、交给Sprite绘制。加载函数是UI系统里最容易泄漏显存的地方反复进出界面不释放纹理很快就能看到显存爆掉。// 从文件加载位图为纹理由CUIPicture持有绘制交给Sprite bool CUIPicture::LoadFromFile(const char* szFile, CD3DGlobal* pD3D) { // 1. 如果之前已加载过纹理先释放再加载避免显存泄漏 if (m_pTexture) { m_pTexture-Release(); m_pTexture NULL; } // 2. 按原始尺寸加载不参与缩放透明图建议用带Alpha通道的DDS HRESULT hr D3DXCreateTextureFromFileExA( pD3D-GetDevice(), szFile, D3DX_DEFAULT, D3DX_DEFAULT, // 宽高用默认值保持原始尺寸 1, 0, D3DFMT_UNKNOWN, D3DPOOL_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, m_pTexture); if (FAILED(hr)) return false; // 3. 记录纹理真实宽高布局代码要用它计算显示区域 D3DSURFACE_DESC desc; m_pTexture-GetLevelDesc(0, desc); m_nWidth desc.Width; m_nHeight desc.Height; return true; } // 绘制把纹理按目标矩形整体贴到屏幕color控制整体透明度 void CUIPicture::Render(int nX, int nY, D3DCOLOR color) { if (!m_pTexture) return; RECT rc { nX, nY, nX m_nWidth, nY m_nHeight }; m_pSprite-Draw(m_pTexture, NULL, NULL, rc, color); }这里的D3DPOOL_DEFAULT有个讲究纹理默认放在显存速度快但设备丢失时会被系统销毁必须在OnLostDevice里释放、OnResetDevice里重建。如果你为了省事改用D3DPOOL_MANAGEDD3D9会在设备重置后自动恢复纹理代价是系统内存和显存之间多一次拷贝。2D UI贴图尺寸小、数量多我一般还是选D3DPOOL_MANAGED省去纹理重建的代码但要注意D3DXCreateTextureFromFileExA的MipLevels我故意传1UI贴图不需要mipmap链多级纹理只会浪费显存。3.3 CUIBaseFont中文显示不是玄学是字符集问题DirectX本身不带字体引擎UI文字靠的是D3DX提供的D3DXCreateFontIndirect本质是把系统字体光栅化成纹理再绘制。这套代码里CUIBaseFont封装的就是这件事。初学的人经常踩同一个坑英文显示正常中文全变成方框。// 创建支持中文的D3DX字体UI文本绘制用它 HRESULT CUIBaseFont::CreateFont(CD3DGlobal* pD3D, int nHeight, const char* szFace) { D3DXFONT_DESC desc; ZeroMemory(desc, sizeof(desc)); desc.Height nHeight; // 字体的像素高度注意不是pt desc.Weight FW_NORMAL; // 常规字重标题栏可以单独加粗 desc.CharSet DEFAULT_CHARSET; // 想显示中文这里不能设成ANSI_CHARSET desc.OutputPrecision OUT_DEFAULT_PRECIS; desc.Quality DEFAULT_QUALITY; lstrcpynA(desc.FaceName, szFace ? szFace : Microsoft YaHei, LF_FACESIZE); return D3DXCreateFontIndirect(pD3D-GetDevice(), desc, m_pFont); }核心就在CharSet这个参数上。设成ANSI_CHARSET时字体光栅化只覆盖英文和西欧字符集中文再好的字体也画不出字形设成DEFAULT_CHARSET系统会根据FaceName自动选合适的中文字体。FaceName建议直接给“Microsoft YaHei”宋体在低分辨率下锯齿明显雅黑的hinting处理更适合UI呈现。还有一点字体纹理注意在设备丢失时走OnLostDevice/OnResetDevice和普通纹理一套逻辑处理即可否则字体对象会失效。4. 控件落地按钮、消息框、文本框的改法与挂接架构层搭完真正跟你业务打交道的是控件。这套代码里控件写得比较完整我挑三个最常见的讲清楚它们的交互逻辑改起来能直接对齐自己的需求。4.1 按钮三态切换加“按下后松开才算点击”按钮是UI交互的最小单元难不在画而在状态切换时机。常见做法是三态贴图正常一张、悬停一张、按下一张。代码里用同一张图片数组按下标取值交互逻辑集中在OnMessage里。点击不能按下就算要等鼠标在按钮区域内松开才触发回调防止用户按下去又移走导致误操作。// 按钮三态切换悬停、按下、松手判定一次写完 int CUIButton::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_MOUSEMOVE) { // 鼠标在按钮内显示悬停态移出恢复常态 SetState(IsPointIn(pMsg-m_pt) ? UI_STATE_HOVER : UI_STATE_NORMAL); } else if (pMsg-m_uMsg GUI_MSG_LBUTTONDOWN IsPointIn(pMsg-m_pt)) { SetState(UI_STATE_PRESS); m_bPressed TRUE; // 记录按下状态松手时要用 } else if (pMsg-m_uMsg GUI_MSG_LBUTTONUP) { // 在按钮内松开才算有效点击杜绝拖出区域误触发 if (m_bPressed IsPointIn(pMsg-m_pt)) { if (m_pfnCallback) m_pfnCallback(m_dwUserData); } m_bPressed FALSE; SetState(UI_STATE_NORMAL); } return 0; }按钮回调用函数指针加UserData的方式而不是直接调用具体业务函数这样控件层不用依赖上层逻辑。你可以把回调绑定到任意类的成员函数上m_dwUserData用来携带控件ID之类上下文。这个模式在C11之前的老VC工程里非常常见放到现在也可以顺手换成std::function接口更灵活。4.2 CUIPopupDlg模态弹窗在自绘UI里是个独立消息泵模态弹窗和普通控件最大的区别是它需要一个“阻塞”效果弹出来以后底层界面不能再响应点击。Win32的模态对话框靠内部消息循环实现自绘UI也遵循这个套路——CUIPopupDlg::DoModal里自己跑一个消息泵不断收集输入、分发给弹窗控件、渲染、Present直到用户关闭弹窗才退出。// 模态弹窗独立消息泵阻塞调用方直到窗口关闭 int CUIPopupDlg::DoModal(CD3DGlobal* pD3D) { m_bModal TRUE; Show(TRUE); CUIBaseMessage msg; while (m_bModal) { // 1. 收集本帧键盘鼠标输入转成UI内部消息 KeyControl::CollectInput(m_msgQueue); // 2. 弹窗及子控件逐个消费队列里的消息 while (m_msgQueue.Pop(msg)) { DispatchMessage(msg); } // 3. 渲染先画底层场景再画弹窗本身注意别重复渲染底层 GetCore()-RenderScene(); Render(); pD3D-Present(); } Show(FALSE); return m_nResult; }这段代码有几个设计点。KeyControl把系统输入抽象到m_msgQueue弹窗的消息泵能独立收集输入意味着弹窗运行期间主窗口的输入不会被消费掉。渲染阶段分两步先画场景再画弹窗保证弹窗浮在3D画面之上如果底层场景已经在主循环里渲染过了这里还再渲染一次就会出现透明区域闪烁。m_nResult是关闭弹窗时填写的返回值让调用方知道用户点了“确定”还是“取消”。4.3 文本框与滑块IME输入和值范围换算文本框的难点在于中文输入。DirectX不处理IME全靠ime.cpp里那套封装对接Windows输入法控件获得焦点时打开IME并预置组合字符串收到WM_CHAR时把组合结果送进来。滑块则是另一个典型交互——把鼠标位移按比例折算成数值。// 文本框焦点时打开IME字符消息逐字追加 int CUITextBox::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_SETFOCUS) { m_bFocus TRUE; Ime_SetOpenStatus(GetHostWindow(), TRUE); // 打开输入法 Ime_SetCompositionString(m_szText); // 把现有文本置入组合区 } else if (pMsg-m_uMsg GUI_MSG_CHAR) { // 退格删除最后一个字符普通字符直接追加 if (pMsg-m_wParam VK_BACK m_szText.GetLength() 0) { m_szText.Delete(m_szText.GetLength() - 1); } else { m_szText.AppendChar((TCHAR)pMsg-m_wParam); } if (m_pfnChange) m_pfnChange(this); } return 1; // 文本框消费所有字符消息防止穿透给下层控件 }// 滑块拖动时把X偏移按比例换算成[min,max]区间的值 int CUISlider::OnMessage(CUIBaseMessage* pMsg) { if (pMsg-m_uMsg GUI_MSG_MOUSEMOVE m_bDrag) { int nTrackWidth m_rcPos.right - m_rcPos.left - m_nThumbWidth; int nOffset pMsg-m_pt.x - m_rcPos.left; // 夹紧到轨道两端避免滑块拖出边界 if (nOffset 0) nOffset 0; if (nOffset nTrackWidth) nOffset nTrackWidth; m_nValue m_nMin (m_nMax - m_nMin) * nOffset / nTrackWidth; if (m_pfnChange) m_pfnChange(this); } return 0; }文本框返回1消费消息是有意的字符消息如果不拦截按下的字母键还会继续传给底层按钮控件导致对话框里输着字背景按钮却在反复响应。滑块换算里的m_nThumbWidth容易被忽略——滑块的可见“把手”有自己的宽度可拖拽范围是轨道宽减去把手宽否则滑块拉到最右边时把手会越出边界。5. 避坑从别处移植这套UI最容易翻车的五个点这套UI库的代码质量在同类资源里算好的但毕竟是老VC工程直接把它加进新项目时编译和运行两头都会遇到坑。我把最常见的五个问题按“现象 → 原因 → 解决”列出来都是自己改过之后实测的记录。5.1 编译与链接字符集、预编译头、DirectX库现象一把源码拷进新工程所有中文注释和字符串全是乱码甚至直接报错C4819。原因原工程用的是多字节字符集还是Unicode跟你的工程属性不一致。源码里大量用到TCHAR它本身是条件编译宏编译器按工程字符集决定展开成char还是wchar_t。一旦两边字符集不一致字符串字面量的编码和解码就对不上。解决项目属性 → 配置属性 → 常规 → 字符集选“使用Unicode字符集”。源文件另存为UTF-8 with BOM保证VS的cl.exe能正确识别中文。顺手把警告C4819在项目属性里关掉这个警告只影响代码页不影响生成结果。现象二编译报错说stdafx.h: No such file or directory。原因这套工程依赖Visual C的预编译头机制。stdafx.cpp里#include stdafx.h并且“创建预编译头”其他.cpp统一“使用预编译头”。新工程默认设置不匹配编译器找不到生成好的.pch文件。解决新建一个空的Win32工程把预编译头打开再把源码文件整个加进去。具体设置是stdafx.cpp→ 预编译头 → 创建/Yc其余.cpp→ 预编译头 → 使用/Yu。不要手动关闭预编译头硬编这套代码的头文件依赖顺序已经按预编译头设计了。现象三链接报错LNK2019 unresolved external symbol D3DXCreateTextureFromFileExA。原因只加了Direct3D核心库漏了D3DX工具库。UI系统里的纹理加载、字体创建全在D3DX里没链库自然找不到符号。解决项目属性 → 链接器 → 输入 → 附加依赖项至少加d3d9.lib、d3dx9.lib、dxguid.lib、winmm.lib。Debug配置用d3dx9d.lib带d后缀的调试版Release用d3dx9.lib。如果机器上没有旧版D3DX运行库程序起来时还会提示找不到d3dx9_xx.dll这时候用directx修复工具把运行库补一份就行这套代码跑在XP到Win10都正常。5.2 运行期设备丢失、分辨率适配、混合顺序现象四游戏切到全屏再切回窗口所有按钮背景全变黑。原因Direct3D9在切换分辨率或失去焦点长时间不渲染时设备会进入“丢失”状态显存里的纹理被系统回收。代码继续Draw在丢失设备上不会报错但画面就是黑的。解决在渲染循环里检测D3DERR_DEVICELOST收到后调用CUIBaseFont::OnLostDevice()、CUIBitmapMgr::ReleaseAll()释放显存资源等到D3DERR_DEVICENOTRESET时再重建字体和纹理。最省事的做法是把所有图片路径存一张表设备重置后遍历重载。现象五分辨率从1280×720改成1920×1080按钮位置全部错乱。原因控件坐标是像素绝对值窗口变大了控件还在原来的像素位置没有跟着等比缩放。这在自绘UI里最容易被忽略因为窗口模式下拖动拉大窗口问题立刻暴露。解决引入逻辑分辨率。比如固定UI设计分辨率为1024×768所有控件的坐标都按这个坐标系排布渲染前算一次缩放比例scaleX screenWidth / 1024、scaleY screenHeight / 768把根容器整体缩放。鼠标坐标要在派发消息前做逆缩放不然命中检测全偏移。现象六UI画面有拖影或者半透明控件边缘闪白边。原因Present没开垂直同步渲染帧率超过显示器刷新率导致撕屏半透明控件绘制的混合顺序不对透明通道叠加出白边。解决呈现参数里设置PresentationInterval D3DPRESENT_INTERVAL_DEFAULT锁到刷新率。绘制顺序上不透明控件先画半透明控件按Z序从远到近画两个半透明控件相交时后画的会盖掉先画的Alpha这个顺序反了就会出现明显的视觉断层。6. 把BattleTank的UI壳换成你的逻辑移植挂接与性能验证资源里的BattleTank工程既是示例也是最好的改造起点。想让它跑你的业务逻辑最干净的做法是保留UI库和渲染底座不动只替换主循环里的输入来源和按钮回调。// 在主循环里把UI更新和渲染挂进你的渲染流程 while (TRUE) { // 1. 收集原始输入键盘鼠标统一进KeyControl KeyControl::Update(); // 2. 把输入转成CUIBaseMessage交给UI根容器分发 CUIBaseMessage msg; while (KeyControl::PopMessage(msg)) g_pCUIDisktop-DispatchMessage(msg); // 3. 先更新逻辑再更新UIUI控件的值跟着业务状态走 g_pGameLogic-Update(dt); g_pCUIDisktop-Update(dt); // 4. 渲染顺序固定3D场景在底层UI最后画 g_pGameLogic-Render(); g_pCUIDisktop-Render(); // 5. Present前检查设备状态丢失时走资源重建 HRESULT hr g_pD3DGlobal-Present(); if (hr D3DERR_DEVICELOST) g_pCUIDisktop-OnDeviceLost(); }这套流程里UI层的依赖被压到最低它不关心你的游戏逻辑只等消息来。所以你完全可以把BattleTank的名字换成自己的业务前缀KeyControl换成你自己的输入抽象层只要保证DispatchMessage能拿到CUIBaseMessage就行。移植完成后建议立刻做两件验证。第一用QueryPerformanceCounter包住CUIDisktop::Render()统计UI渲染耗时纯2D界面在1万控件以下应该压在1毫秒内超出就查是不是有控件重复加载纹理。第二临时把清屏颜色改成固定值比如D3DCOLOR_XRGB(255, 0, 255)如果能看到控件残影说明混合状态或Sprite的绘制状态在帧之间没复位。我从那以后每次接手自绘UI工程都强制先做这两步验证再开始改业务。这套UI库代码结构清晰、边界完整比很多商业引擎里打包好的UI系统更适合当作学习骨架。希望这份拆解帮你在 DirectX 自绘界面的路上少绕几个弯。本文还有配套的精品资源点击获取
