基于DirectX11+ImGui的Win32桌面程序开发
一、常见图形界面框架(DirectUI、GUI)
1.题外话,纯属扯O
举两个常用的开发框架,MFC和Qt Widget里面每个控件都是Window,这是和DirectUI最大的区别。下面简单梳理下这个DirectUI与GUI之前错综复杂的爱恨情仇:
① 在侏罗纪时期,传统的Handle式GUI框架,是由操作系统内核(win32k.sys)直接提供的接口(GDI),采用消息驱动的机制。窗口在Windows 操作系统中可以分为两种类型:一般窗口(Top-level Window)和子窗口(Child Window)。每一个窗口都会有一个系统全局标识符,也就是所谓的窗口句柄,由系统管理,每个窗口都会有独立的操作流程,用于处理消息的消息队列,循环处理系统发过来的窗口消息,例如当鼠标点击一个按钮的时候,操作系统会捕获鼠标消息,发送给对应窗口,通知窗口依据对应操作做出相对应的改变,重新绘制外观,发送一个按钮被点击的事件,也就是到了此时,用户才介入这个过程,进行按钮被点击之后的业务处理,窗口之间经过消息传递,然后经过一系列接口调用,最终反馈给用户呈现,窗口最终归属还是系统资源,用户层面无法窥探内部细节,仅仅是通过提供的接口进行调用操作,主打陪伴。
② 随着第四次科技革命的崛起,某岛核泄漏事件的发展,人们不再满足于单纯的功能界面,一群追求高颜值、高性能、高DIY的用户呐喊 "Please help me",微软推出了DirectUI框架,采用DirectUI开发的应用程序,简单总结来说,就是除了顶级父窗口由操作系统负责,其余所有窗口全部由自己绘制,自己处理消息事件,窗口仅仅相当于一个容器,界面上的元素都属于一个逻辑区域,你问我什么是DirectUI?系统管得了的我要管,系统管不了的我也要管,先绘后渲,随心所欲,这就是DirectUI思想。
二、ImGui基本情况
1.什么是ImGui?
① ImGUI又称为Dear ImGui,它是一个跨平台、无第三方依赖的C++轻量级跨平台图形界面库,在项目中,可以直接引用ImGUI的源码,也可以编译成lib、dll等, ImGUI常使用DirectX或者OpenGL进行界面渲染,优点:性能高,快,实现简单等。缺点:布局有点复杂、字体支持不友好,不能动态加载等.
② 初步总结上面的话,可以大概理解为性能很好,入门简单,精通很难.需要非常熟悉DirectX或者OpenGL.但基础已经可以满足大多数人的需求了.
闲聊:谈谈ImGui与DirectUI之间,有部分相同点,比如依赖DirectX渲染绘制等,但不同点也很明显,ImGui 并不直接依赖于特定的操作系统或图形API,而是通过底层的图形渲染接口来绘制图形。这意味着 ImGui 可以在多个平台(如Windows、Linux、Mac等)和多个图形API(如DirectX、OpenGL、Vulkan等)上使用。在IMGUI中,用户界面每帧都是从代码中绘制的,而不是通过构建和维护UI元素的树形结构。这种即时模式的方法提供了更直接、更灵活的控制权,尤其适用于需要频繁更新和自定义的应用程序。
2.DirectX又是什么东西?
① DirectX 是微软公司开发的一套多媒体编程接口,用于在 Windows 平台上实现硬件加速的图形和音频功能。DirectX 提供了多个组件,其中包括了 Direct2D、Direct3D、DirectSound、DirectInput 等。它们分别用于2D图形渲染、3D图形渲染、音频处理和输入设备管理等领域。... 官话我也就不重复描述了,并非三言两语解释清除,详细了解的可以深度学习这个。
三、简单程序开发
1.开发前的小准备
① 下载 docking imgui 地址: https://github.com/ocornut/imgui/tree/docking
② 使用Visual Studio X创建一个空项目,打开解决方案根目录,创建文件夹,ImGui,Directx,如图所示
③ 打开下载的ImGui-docking压缩包,拷贝根目录如图所示文件,到刚才项目创建的文件夹"ImGui"下;
④ 拷贝***\imgui-docking\backends文件夹下的如图所示文件,至项目根目录文件夹Directx下;
(1
(2
⑤ 拷贝完成后,现有文件夹下文件如下图所示:
2.开始开发,撸起来.
① 创建main.cpp文件,创建基础测试代码,下面代码已经经过初步修改,修改范围:
(1.初始化屏蔽控制台,添加#pragma comment( linker, "/subsystem:windows /entry:mainCRTStartup" )
(2屏蔽Win32窗口,修改::ShowWindow(hwnd, SW_HIDE);
(3.分离绘制,修改,io.ConfigViewportsNoAutoMerge = true;
(4.关闭垂直同步,g_pSwapChain->Present(0, 0);
(5.增加ImGui对汉字的支持,添加 io.Fonts->AddFontFromFileTTF("C:/Windows/Fonts/SimHei.ttf", 14.0f, NULL, io.Fonts->GetGlyphRangesChineseFull());由于ImGui不支持动态加载,由此会引发内存异常的大....
下面代码里面包含了一些常见组件的使用,官方里面也有例子,具体还需要参照Demo程序慢慢学习.
1 #include "imgui.h" 2 #include "imgui_impl_win32.h" 3 #include "imgui_impl_dx11.h" 4 #include <d3d11.h> 5 #include <tchar.h> 6 #include <random> 7 #include <ctime> 8 #include <iostream> 9 using namespace std; 10 11 #pragma comment( linker, "/subsystem:windows /entry:mainCRTStartup" )//屏蔽控制台显示,编译后生效. 12 13 // Data 14 static ID3D11Device* g_pd3dDevice = nullptr; 15 static ID3D11DeviceContext* g_pd3dDeviceContext = nullptr; 16 static IDXGISwapChain* g_pSwapChain = nullptr; 17 static UINT g_ResizeWidth = 0, g_ResizeHeight = 0; 18 static ID3D11RenderTargetView* g_mainRenderTargetView = nullptr; 19 20 // 助手函数的声明 21 bool CreateDeviceD3D(HWND hWnd); 22 void CleanupDeviceD3D(); 23 void CreateRenderTarget(); 24 void CleanupRenderTarget(); 25 LRESULT WINAPI WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam); 26 27 std::string string_to_utf8(const std::string& str) 28 { 29 int nwLen = MultiByteToWideChar(CP_ACP, 0, str.c_str(), -1, NULL, 0); 30 wchar_t* pwBuf = new wchar_t[nwLen + 1]; 31 memset(pwBuf, 0, nwLen * 2 + 2); 32 MultiByteToWideChar(CP_ACP, 0, str.c_str(), str.length(), pwBuf, nwLen); 33 34 int nLen = WideCharToMultiByte(CP_UTF8, 0, pwBuf, -1, NULL, NULL, NULL, NULL); 35 char* pBuf = new char[nLen + 1]; 36 memset(pBuf, 0, nLen + 1); 37 WideCharToMultiByte(CP_UTF8, 0, pwBuf, nwLen, pBuf, nLen, NULL, NULL); 38 39 std::string ret = pBuf; 40 delete[]pwBuf; 41 delete[]pBuf; 42 43 return ret; 44 } 45 46 int main(int, char**) 47 { 48 // 创建应用程序窗口 49 //ImGui_ImplWin32_EnableDpiAwareness(); 50 WNDCLASSEXW wc = { sizeof(wc), CS_CLASSDC, WndProc, 0L, 0L, GetModuleHandle(nullptr), nullptr, nullptr, nullptr, nullptr, L"demo", nullptr }; 51 ::RegisterClassExW(&wc); 52 HWND hwnd = ::CreateWindowW(wc.lpszClassName, L"demo", WS_OVERLAPPEDWINDOW, 100, 100, 1280, 800, nullptr, nullptr, wc.hInstance, nullptr); 53 54 // 初始化 Direct3D 55 if (!CreateDeviceD3D(hwnd)) 56 { 57 CleanupDeviceD3D(); 58 ::UnregisterClassW(wc.lpszClassName, wc.hInstance); 59 return 1; 60 } 61 62 // 设置窗口显示模式 63 ::ShowWindow(hwnd, SW_HIDE); 64 ::UpdateWindow(hwnd); 65 66 // 设置ImGui上下文 67 IMGUI_CHECKVERSION(); 68 ImGui::CreateContext(); 69 ImGuiIO& io = ImGui::GetIO(); (void)io; 70 //取消生成ini文件 71 io.IniFilename = NULL; 72 io.ConfigFlags |= ImGuiConfigFlags_NavEnableKeyboard; // 启用键盘控制 73 io.ConfigFlags |= ImGuiConfigFlags_NavEnableGamepad; // 启用游戏板控制 74 io.ConfigFlags |= ImGuiConfigFlags_DockingEnable; // 启用停靠 75 io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable; // 启用多视口/平台窗口 76 io.ConfigViewportsNoAutoMerge = true; 77 //io.ConfigViewportsNoTaskBarIcon = true; 78 //io.ConfigViewportsNoDefaultParent = true; 79 //io.ConfigDockingAlwaysTabBar = true; 80 //io.ConfigDockingTransparentPayload = true; 81 //io.ConfigFlags |= ImGuiConfigFlags_DpiEnableScaleFonts; // FIXME-DPI:实验。这目前没有按预期工作。不要使用用户内应用程序! 82 //io.ConfigFlags |= ImGuiConfigFlags_DpiEnableScaleViewports; // FIXME-DPI:实验。 83 84 // 设置ImGui风格 85 ImGui::StyleColorsLight(); 86 87 // 启用视口后,我们调整WindowRounding/WindowBg,使平台窗口看起来与常规窗口相同。 88 89 ImGuiStyle& style = ImGui::GetStyle(); 90 if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable) 91 { 92 style.WindowMinSize = ImVec2(700, 180); 93 94 style.WindowRounding = 10.0f; 95 style.Colors[ImGuiCol_WindowBg].w = 1.0f; 96 97 style.WindowBorderSize = 1.0f; 98 style.FrameBorderSize = 1.0f; 99 style.PopupBorderSize = 1.0f; 100 101 style.WindowPadding = ImVec2(8.0f, 8.0f); 102 style.FramePadding = ImVec2(4.0f, 8.0f); 103 style.PopupBorderSize = 1.0f; 104 105 } 106 107 // 设置平台/渲染器后端 108 ImGui_ImplWin32_Init(hwnd); 109 ImGui_ImplDX11_Init(g_pd3dDevice, g_pd3dDeviceContext); 110 111 //加载字体 112 //-如果没有加载字体,imgui将使用默认字体。您还可以加载多种字体,并使用ImGui::PushFont()/PopFont 选择它们 113 //-AddFontFromFileTTF()将返回ImFont*,因此如果需要在多个字体中选择字体,则可以存储它。 114 //-如果无法加载文件,则函数将返回一个nullptr。请处理应用程序中的这些错误(例如,使用断言,或显示错误并退出)。 115 //-当调用ImFontAtlas::Build()/GetTexDataAsXXXXX()时,字体将以给定的大小光栅化(w/过采样)并存储到纹理中,下面的ImGui_ImplXXXX_NewFrame将调用该纹理。 116 //-在您的imconfig文件中使用“#define IMGUI_ABLE_FREETYPE”可以使用FREETYPE进行更高质量的字体渲染。 117 //-有关更多说明和详细信息,请阅读“docs/FONTS.md”。 118 //-请记住,在C/C++中,如果要在字符串文字中包含反斜杠,则需要写一个双反斜杠\\ 119 io.Fonts->AddFontFromFileTTF("C:/Windows/Fonts/SimHei.ttf", 14.0f, NULL, io.Fonts->GetGlyphRangesChineseFull());//支持汉字,单目前Ingui不支持动态,所以在调试模式下启动会变慢,改字体也会占用大量内存. 120 121 // 窗口设置 122 bool show_main_windows = true; 123 bool WindowShouldClose = false; 124 125 ImGui::SetNextWindowSize(ImVec2(700, 180), ImGuiCond_Appearing); 126 127 // 创建计时器变量 128 auto startTime = std::chrono::steady_clock::now(); 129 while (!WindowShouldClose) 130 { 131 //轮询和处理消息(输入、窗口大小调整等) 132 //请参阅下面的WndProc()函数,了解如何将事件调度到Win32后端。 133 MSG msg; 134 while (::PeekMessage(&msg, nullptr, 0U, 0U, PM_REMOVE)) 135 { 136 ::TranslateMessage(&msg); 137 ::DispatchMessage(&msg); 138 if (msg.message == WM_QUIT) 139 WindowShouldClose = true; 140 } 141 if (WindowShouldClose) 142 break; 143 144 //处理窗口大小调整(我们不直接在WM_SIZE处理程序中调整大小) 145 if (g_ResizeWidth != 0 && g_ResizeHeight != 0) 146 { 147 CleanupRenderTarget(); 148 g_pSwapChain->ResizeBuffers(0, g_ResizeWidth, g_ResizeHeight, DXGI_FORMAT_UNKNOWN, 0); 149 g_ResizeWidth = g_ResizeHeight = 0; 150 CreateRenderTarget(); 151 } 152 153 // 启动ImGui框架 154 ImGui_ImplDX11_NewFrame(); 155 ImGui_ImplWin32_NewFrame(); 156 ImGui::NewFrame(); 157 158 if (show_main_windows) 159 { 160 ImGui::Begin(u8"测试基础客户端", &show_main_windows); 161 std::random_device rd; 162 std::mt19937 gen(rd()); 163 std::uniform_real_distribution<float> dis(0.0f, 1.0f); 164 ImVec4 randomColor(dis(gen), dis(gen), dis(gen), 1.0f); 165 ImGui::TextWrapped(u8"****"); 166 ImGui::SameLine(); 167 ImGui::PushStyleColor(ImGuiCol_Text, randomColor); 168 ImGui::SetCursorPosX((ImGui::GetCursorPosX() + ImGui::GetColumnWidth() - ImGui::CalcTextSize(u8"模拟客户端(特效)").x) / 2); 169 ImGui::TextWrapped(u8"模拟客户端(特效)"); 170 ImGui::PopStyleColor(); 171 ImGui::SameLine(); 172 ImGui::SetCursorPosX(ImGui::GetCursorPosX() + ImGui::GetColumnWidth() - ImGui::CalcTextSize(u8"****").x); 173 ImGui::TextWrapped(u8"****"); 174 ImGui::SeparatorText(u8"画一条分界线"); 175 176 ImGui::Text(""); 177 178 randomColor.x = 1.0f; 179 randomColor.y = 0.0f; 180 randomColor.z = 1.0f; 181 ImGui::PushStyleColor(ImGuiCol_Text, randomColor); 182 if (GetDriverState()) 183 { 184 ImGui::SetCursorPosX((ImGui::GetCursorPosX() + ImGui::GetColumnWidth() - ImGui::CalcTextSize(u8"换个颜色").x) / 2); 185 ImGui::TextWrapped(u8"换个颜色"); 186 } 187 else 188 { 189 ImGui::SetCursorPosX((ImGui::GetCursorPosX() + ImGui::GetColumnWidth() - ImGui::CalcTextSize(u8"再换个颜色·").x) / 2); 190 ImGui::TextWrapped(u8"再换个颜色·"); 191 } 192 ImGui::PopStyleColor(); 193 ImGui::SeparatorText(u8""); 194 195 // 计算运行时间 196 auto currentTime = std::chrono::steady_clock::now(); 197 std::chrono::duration<float> elapsedTime = currentTime - startTime; 198 float runtime = elapsedTime.count(); 199 200 // 获取当前时间 201 std::time_t now = std::time(nullptr); 202 std::tm* current_time = std::localtime(&now); 203 static char time_string[64] = { 0 }; 204 std::strftime(time_string, sizeof(time_string), "%Y-%m-%d %H:%M:%S", current_time); 205 206 ImGui::TextColored(ImVec4(0.45f, 0.0f, 1.0f, 1.0f), u8"当前时间:%s,软件已运行: %.2f秒.", time_string, runtime); 207 ImGui::End(); 208 } 209 else 210 { 211 WindowShouldClose = TRUE; 212 } 213 214 // 渲染页面 215 ImGui::Render(); 216 ImGui_ImplDX11_RenderDrawData(ImGui::GetDrawData()); 217 218 // 更新和渲染其他平台窗口 219 if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable) 220 { 221 ImGui::UpdatePlatformWindows(); 222 ImGui::RenderPlatformWindowsDefault(); 223 } 224 225 //g_pSwapChain->Present(1, 0); // 与vsync一起演示 226 g_pSwapChain->Present(0, 0); // 存在但不带vsync 227 } 228 229 230 ImGui_ImplDX11_Shutdown(); 231 ImGui_ImplWin32_Shutdown(); 232 ImGui::DestroyContext(); 233 234 CleanupDeviceD3D(); 235 ::DestroyWindow(hwnd); 236 ::UnregisterClassW(wc.lpszClassName, wc.hInstance); 237 238 return 0; 239 } 240 241 // 帮助函数 242 bool CreateDeviceD3D(HWND hWnd) 243 { 244 // 设置交换链 245 DXGI_SWAP_CHAIN_DESC sd; 246 ZeroMemory(&sd, sizeof(sd)); 247 sd.BufferCount = 2; 248 sd.BufferDesc.Width = 0; 249 sd.BufferDesc.Height = 0; 250 sd.BufferDesc.Format = DXGI_FORMAT_R8G8B8A8_UNORM; 251 sd.BufferDesc.RefreshRate.Numerator = 60; 252 sd.BufferDesc.RefreshRate.Denominator = 1; 253 sd.Flags = DXGI_SWAP_CHAIN_FLAG_ALLOW_MODE_SWITCH; 254 sd.BufferUsage = DXGI_USAGE_RENDER_TARGET_OUTPUT; 255 sd.OutputWindow = hWnd; 256 sd.SampleDesc.Count = 1; 257 sd.SampleDesc.Quality = 0; 258 sd.Windowed = TRUE; 259 sd.SwapEffect = DXGI_SWAP_EFFECT_DISCARD; 260 261 UINT createDeviceFlags = 0; 262 //createDeviceFlags |= D3D11_CREATE_DEVICE_DEBUG; 263 D3D_FEATURE_LEVEL featureLevel; 264 const D3D_FEATURE_LEVEL featureLevelArray[2] = { D3D_FEATURE_LEVEL_11_0, D3D_FEATURE_LEVEL_10_0, }; 265 HRESULT res = D3D11CreateDeviceAndSwapChain(nullptr, D3D_DRIVER_TYPE_HARDWARE, nullptr, createDeviceFlags, featureLevelArray, 2, D3D11_SDK_VERSION, &sd, &g_pSwapChain, &g_pd3dDevice, &featureLevel, &g_pd3dDeviceContext); 266 if (res == DXGI_ERROR_UNSUPPORTED) // 如果硬件不可用,请尝试高性能的WARP软件驱动程序。 267 res = D3D11CreateDeviceAndSwapChain(nullptr, D3D_DRIVER_TYPE_WARP, nullptr, createDeviceFlags, featureLevelArray, 2, D3D11_SDK_VERSION, &sd, &g_pSwapChain, &g_pd3dDevice, &featureLevel, &g_pd3dDeviceContext); 268 if (res != S_OK) 269 return false; 270 271 CreateRenderTarget(); 272 return true; 273 } 274 275 void CleanupDeviceD3D() 276 { 277 CleanupRenderTarget(); 278 if (g_pSwapChain) { g_pSwapChain->Release(); g_pSwapChain = nullptr; } 279 if (g_pd3dDeviceContext) { g_pd3dDeviceContext->Release(); g_pd3dDeviceContext = nullptr; } 280 if (g_pd3dDevice) { g_pd3dDevice->Release(); g_pd3dDevice = nullptr; } 281 } 282 283 void CreateRenderTarget() 284 { 285 ID3D11Texture2D* pBackBuffer; 286 g_pSwapChain->GetBuffer(0, IID_PPV_ARGS(&pBackBuffer)); 287 g_pd3dDevice->CreateRenderTargetView(pBackBuffer, nullptr, &g_mainRenderTargetView); 288 pBackBuffer->Release(); 289 } 290 291 void CleanupRenderTarget() 292 { 293 if (g_mainRenderTargetView) { g_mainRenderTargetView->Release(); g_mainRenderTargetView = nullptr; } 294 } 295 296 #ifndef WM_DPICHANGED 297 #define WM_DPICHANGED 0x02E0 // From Windows SDK 8.1+ headers 298 #endif 299 300 // 从imgui_impl_win32.cpp转发声明消息处理程序 301 extern IMGUI_IMPL_API LRESULT ImGui_ImplWin32_WndProcHandler(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam); 302 303 //Win32消息处理程序 304 //你可以阅读io.WantCaptureMouse,io.WantCaptureKeyboard标志来判断imgui是否想使用你的输入。 305 //-当io.WantCaptureMouse为true时,不要将鼠标输入数据发送到主应用程序,也不要清除/覆盖鼠标数据的副本。 306 //-当io.WantCaptureKeyboard为true时,不要将键盘输入数据发送到主应用程序,也不要清除/覆盖键盘数据的副本。 307 //通常情况下,您可能总是将所有输入传递给imgui,并根据这两个标志对应用程序隐藏它们。 308 LRESULT WINAPI WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) 309 { 310 if (ImGui_ImplWin32_WndProcHandler(hWnd, msg, wParam, lParam)) 311 return true; 312 313 switch (msg) 314 { 315 case WM_SIZE: 316 if (wParam == SIZE_MINIMIZED) 317 return 0; 318 g_ResizeWidth = (UINT)LOWORD(lParam); // 调整队列大小 319 g_ResizeHeight = (UINT)HIWORD(lParam); 320 return 0; 321 case WM_SYSCOMMAND: 322 if ((wParam & 0xfff0) == SC_KEYMENU) // 禁用ALT应用程序菜单 323 return 0; 324 break; 325 case WM_DESTROY: 326 ::PostQuitMessage(0); 327 return 0; 328 case WM_DPICHANGED: 329 if (ImGui::GetIO().ConfigFlags & ImGuiConfigFlags_DpiEnableScaleViewports) 330 { 331 //const int dpi = HIWORD(wParam); 332 //printf("WM_DPICHANGED to %d (%.0f%%)\n", dpi, (float)dpi / 96.0f * 100.0f); 333 const RECT* suggested_rect = (RECT*)lParam; 334 ::SetWindowPos(hWnd, nullptr, suggested_rect->left, suggested_rect->top, suggested_rect->right - suggested_rect->left, suggested_rect->bottom - suggested_rect->top, SWP_NOZORDER | SWP_NOACTIVATE); 335 } 336 break; 337 } 338 return ::DefWindowProcW(hWnd, msg, wParam, lParam); 339 }
② 补齐环境引用,VS右键项目属性:
(1.C++\常规\附加包含目录 添加 .\Imgui;.\Directx;
(2.链接器\输入\依赖性 添加 d3d11.lib;d3dcompiler.lib;dxgi.lib;
3.开发完跑跑试试
① 编译运行,附上效果图(自己改改文字即可实现.):