ImGuizmo 使用教程

ImGuizmo 使用教程

ImGuizmoImmediate mode 3D gizmo for scene editing and other controls based on Dear Imgui项目地址:https://gitcode.com/gh_mirrors/im/ImGuizmo

项目介绍

ImGuizmo 是一个基于 Dear ImGui 的即时模式 3D 操纵器库，用于场景编辑和其他控制。它允许用户通过简单的代码行来操作 4x4 浮点矩阵，支持旋转和位移操作。ImGuizmo 是一个小型库，仅依赖于 Dear ImGui，遵循即时模式（IM）哲学设计。

项目快速启动

安装

ImGuizmo 可以通过 vcpkg 安装，使用以下命令：

vcpkg install imguizmo

基本使用

以下是一个简单的示例，展示如何在项目中使用 ImGuizmo：

#include "imgui.h"
#include "ImGuizmo.h"

void Render() {
    ImGuiIO& io = ImGui::GetIO();
    ImGuizmo::SetRect(0, 0, io.DisplaySize.x, io.DisplaySize.y);

    float cameraView[16] = { 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1 };
    float cameraProjection[16];
    // 设置相机投影矩阵
    // ...

    float objectMatrix[16] = { 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1 };
    ImGuizmo::Manipulate(cameraView, cameraProjection, ImGuizmo::TRANSLATE, ImGuizmo::LOCAL, objectMatrix);

    // 应用变换后的 objectMatrix
    // ...
}

应用案例和最佳实践

场景编辑器

ImGuizmo 常用于游戏和模拟器的场景编辑器中，允许开发者实时调整对象的位置和方向。通过结合 Dear ImGui 的界面元素，可以创建一个功能强大的编辑环境。

模型查看器

在模型查看器中，ImGuizmo 可以用于实时查看和调整模型的姿态，这对于3D艺术家和游戏开发者来说非常有用。

典型生态项目

Dear ImGui

ImGuizmo 依赖于 Dear ImGui，这是一个非常流行的即时模式图形用户界面库，广泛用于游戏开发和其他高性能实时应用。

vcpkg

vcpkg 是微软开发的一个C++库管理工具，可以简化包括 ImGuizmo 在内的许多开源库的安装和集成过程。

通过以上内容，您可以快速了解和开始使用 ImGuizmo 项目，结合实际应用案例和相关生态项目，更好地发挥其功能。

ImGuizmoImmediate mode 3D gizmo for scene editing and other controls based on Dear Imgui项目地址:https://gitcode.com/gh_mirrors/im/ImGuizmo