¶ ImGui в контексте EyeAuras
ImGui — это на удивление мощная, но при этом простая и интуитивная библиотека для отрисовки разных вещей. Изначально автор создавал её для разработки UI в играх, но со временем область применения стала гораздо шире — список проектов, которые используют её, действительно впечатляет.
Но здесь мы говорим про автоматизацию, верно? Тогда чем ImGui полезен нам?
Ответ простой: ImGui — это самый простой и интуитивный способ собрать собственный UI. Освоить его даже проще, чем Blazor Windows.
¶ Установка
EyeAuras постепенно переходит на модульную систему на базе NuGet, чтобы пользователь мог подключать только те возможности, которые ему действительно нужны. Текущая функциональность стала слишком большой: захват изображений, анализ, эффекты, деревья поведения, эмуляция ввода, чтение памяти, обработка аудио, Blazor UI… и почти ни одно mini-app не использует даже половину этого набора.
Поэтому разные возможности выносятся в отдельные NuGet-пакеты, которые можно установить так же, как любые другие.
#r "nuget:EyeAuras.ImGuiSdk, 0.1.42"
using EyeAuras.ImGuiSdk; // required for registration methods
using ImGuiNET; // access to ImGui APIs
using System.Numerics; // for Vector2/Vector3 use with ImGui
AddNewExtension<ImGuiContainerExtensions>(); // registers IImGuiExperimentalApi and others
var osd = GetService<IImGuiExperimentalApi>() // creates the ImGui overlay
.AddTo(ExecutionAnchors); // ensures cleanup when script stops
¶ Hello, World
Чтобы начать работать с ImGui, нужно сделать всего 3 вещи:
- Подключить namespace
ImGuiNET - Получить
IImGuiApiчерезGetService - Вызвать
AddRenderer()и передать в него ваш метод отрисовки
На этом всё. EyeAuras сам создаст overlay и запустит render loop. Вам остаётся только поместить свою логику в метод, который передаётся в AddRenderer.
Примечание: ваш метод будет вызываться на каждом кадре, поэтому избегайте
sleepи любого долгого блокирующего кода.
#r "nuget:EyeAuras.ImGuiSdk, 0.1.42"
using EyeAuras.ImGuiSdk;
using ImGuiNET;
using System.Numerics;
AddNewExtension<ImGuiContainerExtensions>();
var osd = GetService<IImGuiExperimentalApi>()
.AddTo(ExecutionAnchors);
osd.AddRenderer(() =>
{
ImGui.ShowDemoWindow();
});
cancellationToken.WaitHandle.WaitOne(); // keep running until script is stopped
¶ Создаём переключатель
Теперь сделаем что-то своё. Demo window полезно для тестов, но в реальной работе от него мало пользы.
Как и в Blazor Windows, давайте создадим toggle.
¶ Что для этого нужно
- Создать overlay через
IImGuiApi - Передать метод отрисовки в
AddRenderer - Внутри render-метода нарисовать checkbox и текст
И это всё. Никакого отдельного управления состоянием, никаких sleep, никакой ручной обработки кликов — всё работает в immediate mode. Поначалу синтаксис может показаться непривычным, но ChatGPT очень хорошо знает ImGui, так что смело задавайте вопросы.
#r "nuget:EyeAuras.ImGuiSdk, 0.1.42"
using EyeAuras.ImGuiSdk;
using ImGuiNET;
using System.Numerics;
[Inject] IAuraTreeScriptingApi AuraTree { get; init; }
IHotkeyIsActiveTrigger Trigger => AuraTree.GetTriggerByPath<IHotkeyIsActiveTrigger>("./TargetAura");
AddNewExtension<ImGuiContainerExtensions>();
var osd = GetService<IImGuiExperimentalApi>()
.AddTo(ExecutionAnchors);
osd.AddRenderer(() =>
{
ImGui.Begin("My UI");
ImGui.Text("Control window flags and interaction behavior.");
var isActive = Trigger.TriggerValue ?? false;
if (ImGui.Checkbox("Is Active", ref isActive))
{
Trigger.TriggerValue = isActive;
}
ImGui.SameLine();
ImGui.TextDisabled("(Gets/Sets whether Trigger is active or not)");
ImGui.Separator();
if (Trigger.IsActive == true)
{
ImGui.TextColored(new Vector4(0f, 1f, 0f, 1f), "Trigger is currently ACTIVE");
}
else
{
ImGui.TextColored(new Vector4(1f, 0f, 0f, 1f), "Trigger is currently INACTIVE");
}
ImGui.End();
});
cancellationToken.WaitHandle.WaitOne();
¶ Что ещё можно делать с ImGui?
Помимо интерактивных окон, ImGui можно использовать и для OSD (On-Screen Display) — отрисовки overlay прямо поверх экрана. Причём можно рисовать как 2D, так и 3D объекты.
Вот пример — всё, что вы видите, включая UI и экранные overlay, отрисовано с помощью ImGui:
Если нужно, этот материал можно оформить как полноценную страницу документации или встроить в шаблоны скриптов EyeAuras.