imgui-goodies 项目教程

1. 项目介绍

imgui-goodies 是一个为即时模式 GUI (imgui) 开发的工具和组件集合。该项目由 aoterodelaroza 开发，旨在为 critic2 GUI 提供额外的功能和便利的组件。目前，该项目包含以下主要内容：

• imgui_widgets.cpp: 包含一系列独立的小部件，如 SlidingBar、ButtonWithX、ResizeGripOther、LiftGrip 和 AttachTooltip 等。
• imgui_dock.cpp: 提供一个窗口停靠系统，支持三种类型的窗口：Docks、Containers 和 Root Containers。

2. 项目快速启动

2.1 克隆项目

首先，克隆 imgui-goodies 项目到本地：

git clone https://github.com/aoterodelaroza/imgui-goodies.git

2.2 编译项目

进入项目目录并使用提供的脚本编译项目：

cd imgui-goodies
./compile.sh

2.3 运行示例

编译完成后，可以在 examples 目录下找到并运行示例程序：

cd examples
./run_example.sh

3. 应用案例和最佳实践

3.1 使用 SlidingBar 小部件

SlidingBar 是一个可以被鼠标拖动的条形小部件。以下是一个简单的使用示例：

#include "imgui_widgets.h"

void ShowExample() {
    float value = 0.5f;
    ImGui::Begin("Example Window");
    ImGui::SlidingBar("My Sliding Bar", &value, 0.0f, 1.0f);
    ImGui::End();
}

3.2 使用 AttachTooltip 函数

AttachTooltip 提供了一个延迟显示的工具提示功能。以下是一个使用示例：

#include "imgui_widgets.h"

void ShowExample() {
    ImGui::Begin("Example Window");
    if (ImGui::Button("Hover me")) {
        // Do something
    }
    ImGui::AttachTooltip("This is a tooltip", 1.0f);
    ImGui::End();
}

4. 典型生态项目

4.1 imgui 主项目

imgui 是一个轻量级的、跨平台的即时模式图形用户界面库，支持 OpenGL3/2 后端。imgui-goodies 是基于 imgui 的扩展项目。

• 项目地址: https://github.com/ocornut/imgui

4.2 imgui-js

imgui-js 是一个基于 WebAssembly 的 ImGui 绑定库，专为 Web 开发者提供快速且灵活的图形用户界面构建工具。

• 项目地址: https://github.com/flyover/imgui-js

通过这些项目，开发者可以在不同的平台上快速构建高效且美观的图形用户界面。