ImGui通知系统 - 使用指南

孔旭澜Renata

于 2024-08-15 09:55:15 发布

阅读量268

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00073/article/details/141212297

版权

ImGui通知系统 - 使用指南

imgui-notifyA (very) simple notification wrapper for Dear ImGui项目地址:https://gitcode.com/gh_mirrors/im/imgui-notify

一、项目介绍

ImGui通知系统是一个非常简洁的通知栏插件，适用于Dear ImGui库。它提供了基本的功能来创建不同类型的桌面级通知，包括成功、警告、错误等常见类型。此工具的目标是简化在基于Dear ImGui的应用中集成通知功能的过程。

主要特性

头部文件: 无依赖项，只需包含一个头文件即可。
图标支持: 集成了Font Awesome 5图标库以增强视觉效果。
多行文本: 支持多行文本显示，最多可适应视口宽度的三分之一。

许可证

该项目遵循MIT许可证协议，允许广泛的再分发和使用自由度。

二、项目快速启动

环境准备

确保你的开发环境包含了以下组件:

一份Dear ImGui的副本。
Font Awesome 5图标库（非必需但推荐）。
一种字体，不使用默认的，如Tahoma或类似。

安装与初始化

将imgui_notify.h头文件添加到你的项目中。
加载并配置自定义字体；如果使用AddFontFromMemoryTTF从内存加载字体会更安全，需传递一个ImFontConfig结构体设置FontDataOwnedByAtlas = false。

示例代码

// 初始化
#include "imgui_notify.h"
#include "path_to_your_font_file.h"

ImGuiIO& io = ImGui::GetIO();
ImFontConfig font_config;
font_config.FontDataOwnedByAtlas = false;
io.Fonts->AddFontFromMemoryTTF((void*)your_font_data_here, font_size, &font_config);
// 调用后的初始化函数
ImGui::MergeIconsWithLatestFont(); // 必须调用，尤其是在加载每种新字体之后。

使用示例

// 创建通知实例
ImGuiToast success_notification(ImGuiToastType::Success, 3000); // 成功类型，持续时间3秒
success_notification.setTitle("操作完成");
success_notification.setContent("您的请求已被处理。");

// 插入并渲染通知
ImGui::InsertNotification(success_notification);
ImGui::RenderNotifications();