ImGuiAl 使用教程

1. 项目介绍

ImGuiAl 是一个专为 ImGui 设计的扩展库，旨在增强应用或游戏的交互性和用户体验。它提供了一系列独特而实用的小部件，包括日志记录器、额外字体、消息框、可禁用的按钮以及用于数据可视化的火花线图。项目还附带了一个可hack的控制台示例，直观展示了这些小部件的实际效果。

2. 项目快速启动

2.1 环境准备

确保你已经安装了以下工具和库：

• CMake
• Git
• C++ 编译器（如 GCC 或 MSVC）

2.2 下载项目

使用 Git 克隆项目到本地：

git clone https://github.com/leiradel/ImGuiAl.git
cd ImGuiAl

2.3 构建项目

使用 CMake 生成构建文件并编译项目：

mkdir build
cd build
cmake ..
make

2.4 运行示例

编译完成后，运行示例程序：

./ImGuiAl_Example

2.5 集成到现有项目

将 ImGuiAl 集成到现有项目中，只需将相关代码引入项目，并确保链接了 ImGui 库。以下是一个简单的集成示例：

#include "ImGuiAl.h"

int main() {
    // 初始化 ImGui
    ImGui::CreateContext();
    ImGuiIO& io = ImGui::GetIO();

    // 初始化 ImGuiAl
    ImGuiAl::Logger logger;

    // 主循环
    while (true) {
        ImGui::NewFrame();

        // 使用 ImGuiAl 的日志记录器
        logger.AddLog("Hello, ImGuiAl!");
        logger.Draw("Log");

        ImGui::Render();
    }

    return 0;
}

3. 应用案例和最佳实践

3.1 游戏开发

在游戏开发中，可以使用 ImGuiAl 的消息框（MsgBox）来显示错误信息或提示玩家。例如：

ImGuiAl::MsgBox msgBox;
msgBox.Show("Error", "An error occurred!", ImGuiAl::MsgBoxIcon::Error);

3.2 数据科学应用

在数据科学应用中，ImGuiAl 的火花线图（Sparkline）可以帮助快速呈现复杂的数据变化趋势。例如：

ImGuiAl::Sparkline sparkline;
sparkline.AddPoint(1.0f);
sparkline.AddPoint(2.0f);
sparkline.Draw("Data Trend");

3.3 实时数据监控

在实时数据监控应用中，可以使用 ImGuiAl 的日志记录器（Log）来记录和显示实时数据。例如：

ImGuiAl::Logger logger;
logger.AddLog("Temperature: %.2f°C", temperature);
logger.Draw("Real-time Data");

4. 典型生态项目

4.1 Dear ImGui Bundle

Dear ImGui Bundle 是一个集成了多个 ImGui 扩展库的项目，包括 ImGuiAl。通过使用 Dear ImGui Bundle，开发者可以更方便地集成和使用 ImGuiAl 以及其他相关库。

4.2 HelloImGui

HelloImGui 是一个基于 ImGui 的框架，提供了对 ImGuiAl 的支持。开发者可以通过 HelloImGui 快速构建复杂的 ImGui 应用，并利用 ImGuiAl 增强用户体验。

4.3 ImGui Builder

ImGui Builder 是一个图形化界面编辑器，允许开发者通过直观的拖放操作创建和编辑 GUI 元素。虽然 ImGui Builder 本身不直接集成 ImGuiAl，但开发者可以通过 ImGui Builder 生成的代码轻松集成 ImGuiAl 的小部件。

通过以上教程，你应该能够快速上手并集成 ImGuiAl 到你的项目中。希望 ImGuiAl 能够帮助你提升应用或游戏的用户体验！