简介
ImGui 是一个用于C++的用户界面库,跨平台、无依赖,支持OpenGL、DirectX等多种渲染API,是一种即时UI(Immediate Mode User Interface)库,保留模式与即时模式的区别参考保留模式与即时模式。ImGui渲染非常快,但界面上有大量的数据集需要渲染可能会有一些问题,需要使用一些缓存技巧。缓存只是避免数据的更新逻辑耗时太久影响渲染,实际渲染过程不存在瓶颈。
本文最终实现的应用效果如下:
使用示例
ImGui有master、docking两个分支,链接如下:
- 主分支:https://github.com/ocornut/imgui/tree/master
- docking分支:https://github.com/ocornut/imgui/tree/docking
推荐使用docking分支(支持窗口停靠),本文也是使用的docking分支,先把项目下载下来。
下载示例
从github下载示例,打开examples文件夹下的项目,有很多示例可以选:
我的电脑只有example_glfw_opengl和example_win32_directx两个系列的示例能直接运行起来,example_win32_directx的界面不知道为什么看起来很糊,所以只能选择example_glfw_opengl3的示例来开始后续的内容。
main文件
example_glfw_opengl3项目的源文件如下:
其中,main文件有很多有用的注释和代码片段,下面主要介绍主题、字体部分内容。
设置ImGui风格
ImGui提供Dark、Light、Classic三种风格,示例中默认使用Dark:
// Setup Dear ImGui style
ImGui::StyleColorsDark();
//ImGui::StyleColorsLight();
// Classic在示例注释里面没有提及,但源码里面有对应的函数
//ImGui::StyleColorsClassic();
Dark风格:
Light风格:
Classic 风格:
自定义配色方案可参考上面设置风格的函数实现,里面的颜色种类太多,后面会单独写一篇界面美化的文章。
设置字体
ImGui默认字体说实话比较难看,我还是比较喜欢微软雅黑:
//设置微软雅黑字体,并指定字体大小
ImFont* font = io.Fonts->AddFontFromFileTTF
(
"C:/Windows/Fonts/msyh.ttc",
30,
nullptr,
//设置加载中文
io.Fonts->GetGlyphRangesChineseFull()
);
//必须判断一下字体有没有加载成功
IM_ASSERT(font != nullptr);
注意一下,一定要使用GetGlyphRangesChineseFull(),使用GetGlyphRangesChineseSimplifiedCommon()的话会有部分中文加载不出来。
上面加载字体有两个问题:固定文件路径、内存占用过高,后面会单独写一篇关于字体的文章。
主循环
main函数的主循环类似其它界面框架的消息循环,里面有一些示例代码需要删除,简化后的代码大致如下:
while (!glfwWindowShouldClose(window))
{
//一些注释...
glfwPollEvents();
// Start the Dear ImGui frame
ImGui_ImplOpenGL3_NewFrame();
ImGui_ImplGlfw_NewFrame();
ImGui::NewFrame();
/*
* 添加自己的代码,App的实现见下面的代码
*/
App::RenderUI();
// Rendering
ImGui::Render();
//一些代码和注释
glfwSwapBuffers(window);
}
每帧的UI渲染都在App::RenderUI()函数里面执行,具体实现参考下面的内容。
添加Application类
实际项目中不可能把所有UI代码放到Main函数里面,所以添加命名为Application的头文件和源文件用来存放UI代码。
同时,创建一个App的命名空间并在Application.h中引入imgui.h头文件,在源码中添加一些示例。
头文件内容如下:
#pragma once
#include "imgui.h"
namespace App
{
void RenderUI();
}
源码文件如下:
#include "Application.h"
#include <iostream>
#include <string>
namespace App
{
//选中结果
bool isShowDrag=false;
//字符串结果
std::string text="";
//拖拽值
float fValue = 0.5f;
void RenderUI()
{
//创建一个设置窗口
ImGui::Begin("设置拖拽按钮");
//按钮在单击时返回true(大多数小部件在编辑/激活时返回true)
if (ImGui::Button("按钮"))
{
//单击事件处理程序
}
//显示一些文本(也可以使用字符串格式)
ImGui::Text("这是一个中文字符串");
// 缓冲区用于存储文本输入值
char buffer[256] = "";
ImGui::InputText("输入框", buffer, sizeof(buffer));
//编码转换
std::string textU8 = buffer;
ImGui::Checkbox("显示拖拽", &isShowDrag);
if (isShowDrag)
{
float value = 10.0f;
ImGui::DragFloat(u8"值",&value);
}
//使用从0.0f到1.0f的滑块编辑1个浮动
ImGui::SliderFloat("float", &fValue, 0.0f, 1.0f);
ImGui::SameLine();
ImGui::Text("Value %f", fValue);
ImGui::End();
}
}
运行结果如下:
中文编码问题
在上述例子中,有一个关于中文字符串的问题需要注意。默认情况下,VS使用ANSI编码格式的字符串,因此ImGui会显示