Гайд mimgui — Dear ImGui for MoonLoader

Добро пожаловать в гайд по mimgui.
mimgui — это новая графическая библиотека, написанная в результате устаревания предыдущей графической библиотеки Moon ImGui, использующей Dear ImGui v.1.52; использующая в своей основе свежий релиз Dear ImGui v.1.72. Новая библиотека включает в себя все основные возможности фреймворка, а API максимально приближен к оригинальному.

Содержание:


GitHub ImGui:
GitHub mimgui:

Скачать mimgui
Установка: переместить папку mimgui из архива в папку «*Корневая папка с игрой*/moonloader/lib»



Основная информация
В mimgui используется относительно последняя версия ImGui (1.72): на момент написания статьи последняя его версия — 1.79.
Изначально написание этой статьи планировалось после выхода предстоящей версии MoonLoader, в которой должен был быть менеджер зависимостей, и сама библиотека должна была поставляться с помощью функционала МЗ, однако её релиз был отложен на неопределенный срок. В качестве основы используется LuaJit ImGui , который, в свою очередь, в качестве основы использует cimgui.

mimgui разрабатывался с декабря 2018 года, однако, широкую популярность он получил только в июле-августе 2019 года, как раз
в период выхода первой beta-версии MoonLoader 027.

Примеры использования mimgui можно увидеть в самом репозитории, но несмотря на это, в этой теме также отдельно будут добавлены примеры использования.




Примеры использования
Давайте напишем примитивный скрипт с использованием mimgui.

Lua:
local imgui = require 'mimgui' -- Подключаем саму библиотеку

local newFrame = imgui.OnFrame( --[[Сама функция создания фрейма, их может быть сколько вашей душе угодно.
                                    Обратите внимание, что в mimgui рекомендуется создавать отдельный
                                    фрейм для каждого окна, однако это не является обязательным.]]
    function() return true end, -- Определяет, выполняется/отображается ли текущий фрейм.
    function(player)            --[[Сама область, в которой уже будем рисовать элементы.
                                    В функцию в качестве первой переменной передаются список функций
                                    для взаимодействия с локальным игроком и рядом нескольких возможностей.]]
        imgui.Begin("Main Window")  -- Создаём новое окно с заголовком 'Main Window'
        imgui.Text("Hello")         -- Добавляем туда текст 'Hello'
        imgui.End()                 -- Объявляем конец данного окна
    end
)

function main()
    wait(-1)
end

Результат:

Screenshot_1.png


Само собой, это не все возможности ImGui, поэтому немного преобразим наш скрипт: добавим размер, позицию по умолчанию и клавишу активации для показа окна.


Lua:
local imgui = require 'mimgui'
local vkeys = require 'vkeys'       --[[Библиотека со списком индексов клавиш и функциями для
                                        взаимодействия с ними.]]

local wm = require 'windows.message'    -- Список событий для окна игры

local new = imgui.new               --[[Создаём короткий псевдоним для функции,
                                        создающего буфера для различных функций ImGui]]
local renderWindow = new.bool(--[[true/false, по умолч. false]])
local sizeX, sizeY = getScreenResolution()

local newFrame = imgui.OnFrame(
    function() return renderWindow[0] end,
    function(player)
        imgui.SetNextWindowPos(imgui.ImVec2(sizeX / 2, sizeY / 2), imgui.Cond.FirstUseEver, imgui.ImVec2(0.5, 0.5)) -- Укажем положение окна по центру и выставим оффсет 0.5, чтобы рендер шёл от середины окна
        imgui.SetNextWindowSize(imgui.ImVec2(200, 150), imgui.Cond.FirstUseEver) -- Укажем размер
        imgui.Begin("Main Window", renderWindow)
        imgui.Text("Hello")
        imgui.Text(string.format("Current render mode: %s", renderWindow[0]))
        imgui.End()
    end
)

function main()
    addEventHandler('onWindowMessage', function(msg, wparam, lparam) -- Сама функция, в которой будем обрабатывать горячие клавиши. Обратите внимание, что данный способ является наиболее верным в плане оптимизации.
        if msg == wm.WM_KEYDOWN or msg == wm.WM_SYSKEYDOWN then -- Если клавиша нажата
            if wparam == vkeys.VK_X then -- И если это клавиша X
                renderWindow[0] = not renderWindow[0] -- Переключаем состояние рендера
            end
        end
    end)
    wait(-1)
end

Результат:
Screenshot_2.png


Но, ведь ничего не изменилось: размер тот же, положение то же самое: в левом верхнем углу, почему?
Дело в том, что mimgui умеет сохранять данные окон по их индексу. Индексы окон — это их заголовки, поэтому заголовки также следует делать уникальными.
Если вам необходимы одинаковые названия окон, то достаточно после названия окна добавить ##уникальное_значение, не беспокойтесь, он не будет виден. Обратите внимание, что это следует делать во всех случаях: InputText(Multiline), InputInt, Button и так далее; абсолютно во всех, иначе работать у вас будет только первая кнопка/инпут.

Хорошо, с индексом разобрались, возможно, вам понадобится убрать автоматическое запоминание, давайте выключим:


Lua:
local imgui = require 'mimgui'
local vkeys = require 'vkeys'

local wm = require 'windows.message'
local new = imgui.new

local renderWindow = new.bool()
local sizeX, sizeY = getScreenResolution()

imgui.OnInitialize(function()   --[[Функция, вызывающаяся один раз за период жизни скрипта.
                                    Обратите внимание, что пока никакое ImGui окно ни разу не показывалось,
                                    функция не вызовется и это может вызвать ошибки об отсутствии
                                    каких-либо переменных, если вы их здесь объявили.
                                    Поэтому, здесь следует просто изменять значения по умолчанию, например:
                                    цвет элементов, "сохранять ли настройки и в какой файл"
                                    Либо подгружать картинки, необходимые для показа окнам ImGui
                                    Если вы за пределами ImGui попытаетесь подгрузить картинку, вы поймаете ошибку.]]

    -- Выключаем сохранение. По умолчанию: moonloader/config/mimgui/%scriptfilename%.ini
    imgui.GetIO().IniFilename = nil
end)

local newFrame = imgui.OnFrame(
    function() return renderWindow[0] end,
    function(player)
        imgui.SetNextWindowPos(imgui.ImVec2(sizeX / 2, sizeY / 2), imgui.Cond.FirstUseEver, imgui.ImVec2(0.5, 0.5))
        imgui.SetNextWindowSize(imgui.ImVec2(200, 150), imgui.Cond.FirstUseEver)
        imgui.Begin("Main Window", renderWindow)
        imgui.Text("Hello")
        imgui.Text(string.format("Current render mode: %s", renderWindow[0]))
        imgui.End()
    end
)

function main()
    addEventHandler('onWindowMessage', function(msg, wparam, lparam)
        if msg == wm.WM_KEYDOWN or msg == wm.WM_SYSKEYDOWN then
            if wparam == vkeys.VK_X then
                renderWindow[0] = not renderWindow[0]
            end
        end
    end)
    wait(-1)
end

Теперь окно увеличилось, отображается по центру и его можно скрыть:
Screenshot_3.png


Давайте теперь напишем что-то на русском языке:
Lua:
local imgui = require 'mimgui'
local ffi = require 'ffi' -- Подключаем библиотеку ffi для использования возможностей Си (C)
local vkeys = require 'vkeys'

local wm = require 'windows.message'
local new, str, sizeof = imgui.new, ffi.string, ffi.sizeof

local renderWindow = new.bool()
local inputField = new.char[256 --[[Указываем размер]]](--[[Здесь можно указать какой-либо текст]])
local sizeX, sizeY = getScreenResolution()

imgui.OnInitialize(function()
    imgui.GetIO().IniFilename = nil
end)

local newFrame = imgui.OnFrame(
    function() return renderWindow[0] end,
    function(player)
        imgui.SetNextWindowPos(imgui.ImVec2(sizeX / 2, sizeY / 2), imgui.Cond.FirstUseEver, imgui.ImVec2(0.5, 0.5))
        imgui.SetNextWindowSize(imgui.ImVec2(200, 150), imgui.Cond.FirstUseEver)
        imgui.Begin("Main Window", renderWindow)
        imgui.Text("Hello")
        imgui.Text(string.format("Current render mode: %s", renderWindow[0]))
        if imgui.InputText("Привет", inputField, sizeof(inputField)) then
            -- Первое: уникальное название инпута, второе: само поле, третье: максимальная длина текста/размер инпута.
            print(str(inputField)) -- Читаем значение инпута через функцию str
        end
        if imgui.Button("Очистить поле") then
            imgui.StrCopy(inputField, '') -- Можно вписать какое-либо значение в инпут, при желании.
        end
        imgui.End()
    end
)

function main()
    addEventHandler('onWindowMessage', function(msg, wparam, lparam)
        if msg == wm.WM_KEYDOWN or msg == wm.WM_SYSKEYDOWN then
            if wparam == vkeys.VK_X then
                renderWindow[0] = not renderWindow[0]
            end
        end
    end)
    wait(-1)
end

Результат:
Screenshot_4.png


Мы видим здесь каракули и вопросительные знаки, почему это происходит?

Работа с другими языками на примере русского
В MoonLoader 025 были добавлены библиотеки lua-iconv и encoding, они призваны помочь в работе с разными кодировками текста.
Следующий пример показывает, как использовать текст на русском в ImGui:
Скрипт должен быть сохранён в кодировке Windows-1251 (конкретно для данного примера)
Если в вашем скрипте имеется огромный код с использованием ImGui и мало взаимодействия с функциями MoonLoader'a либо SAMPFUNCS'a, то вы при желании можете сохранить ваш скрипт в UTF-8 и вам не придётся проделывать все эти операции.


Lua:
local imgui = require 'mimgui'
local ffi = require 'ffi'
local vkeys = require 'vkeys'
local encoding = require 'encoding' --[[Подключаем библиотеку для чтения/записи данных с кодировкой,
                                        отличающейся от кодировки нашего скрипта.]]

encoding.default = 'CP1251'         --[[Указываем кодировку по умолчанию. Обратите внимание,
                                        что она должна совпадать с кодировкой вашего скрипта.]]
local u8 = encoding.UTF8            -- И создаём короткий псевдоним для кодировщика UTF-8

local wm = require 'windows.message'
local new, str, sizeof = imgui.new, ffi.string, ffi.sizeof

local renderWindow, freezePlayer, removeCursor = new.bool(), new.bool(), new.bool()
local inputField = new.char[256](--[[Здесь также следует кодировать информацию!]])
local sizeX, sizeY = getScreenResolution()

imgui.OnInitialize(function()
    imgui.GetIO().IniFilename = nil
end)

local newFrame = imgui.OnFrame(
    function() return renderWindow[0] end,
    function(player)
        imgui.SetNextWindowPos(imgui.ImVec2(sizeX / 2, sizeY / 2), imgui.Cond.FirstUseEver, imgui.ImVec2(0.5, 0.5))
        imgui.SetNextWindowSize(imgui.ImVec2(220, 200), imgui.Cond.FirstUseEver)
        imgui.Begin("Main Window", renderWindow)
        imgui.Text("Hello")
        imgui.Text(string.format("Current render mode: %s", renderWindow[0]))
        if imgui.InputText(u8"Привет", inputField, sizeof(inputField)) then
            -- Кодируем название инпута
            print(u8:decode(str(inputField))) -- Декодируем в Windows-1251
        end
        if imgui.Button(u8"Очистить поле") then -- Кодируем название кнопки
            imgui.StrCopy(inputField, '')
        end
        if imgui.Checkbox(u8'Заморозить игрока', freezePlayer) then -- Кодируем название кнопки
            player.LockPlayer = freezePlayer[0]
        end
        if imgui.Checkbox(u8'Скрыть курсор', removeCursor) then -- Кодируем название кнопки
            player.HideCursor = removeCursor[0]
        end
        if player.HideCursor then
            imgui.Text(u8'Курсор скрыт') -- Кодируем выводимый текст
        end
        imgui.End()
    end
)

function main()
    addEventHandler('onWindowMessage', function(msg, wparam, lparam)
        if msg == wm.WM_KEYDOWN or msg == wm.WM_SYSKEYDOWN then
            if wparam == vkeys.VK_X then
                renderWindow[0] = not renderWindow[0]
            end
        end
    end)
    wait(-1)
end

Результат:
Screenshot_5.png


В примерах не было затронуто наличие "префрейма" (BeforeFrame), применение его и остальных возможностей вы можете увидеть в репозитории по ссылке:




Главные различия между ImGui C++ API и mimgui Lua API

ОписаниеВ C++ ImGuiВ Lua mimgui
Все функции из пространства имён ImGui, как и все типы, и все перечисления находятся в таблице, возвращаемой модулем​
ImGui::Text("text");
ImVec2(0.1f, 2.3f);
imgui.Text("text")
imgui.ImVec2(0.1, 2.3)
Названия перечислений (enum) и их значений лишились префиксов и символа "_" в концеImGuiWindowFlags_NoTitleBar | ImGuiWindowFlags_NoResizeimgui.WindowFlags.NoTitleBar + imgui.WindowFlags.NoResize
Значения базовых типов, которые в ImGui записываются по указателю, должны быть использованы через ffistatic bool win = false;
ImGui::Begin("window", &win);
win = false;
local win = imgui.new.bool(false)
imgui.Begin("window", win)
win[0] = false
Использование функций InputText и InputTextMultilinechar buf[256];
ImGui::InputText('input', buf, IM_ARRAYSIZE(buf))
local buf = imgui.new.char[256]()
imgui.InputText('input', buf, ffi.sizeof(buf))
Динамические массивы в виде массива указателей следует объявлять через fficonst char* items[] = {"1", "2", "3"};
ImGui::ListBox("list", &lb_cur, items, 3)
local itemsList = {"1", "2", "3"}
local current = imgui.new.int(0)
local items = imgui.new['const char*'][#itemsList](itemsList)
imgui.ListBoxStr_arr("list", current, items, #itemsList)


Главные различия между MoonImGui и mimgui
Для взаимодействия с ImGui теперь используется встроенная в LuaJIT библиотека ffi, а не самописные функции. Поэтому, получается так, что когда мы пишем код, мы "пишем код" на С++. Поэтому, добавленные в MoonImGui типы: ImBool, ImBuffer, ImInt, ImFloat, ImCallback не требуются, и им на замену пришли встроенные и не встроенные в Си типы:

ТипИспользование в MoonImGuiИспользование в mimgui
Bool​
local bool = imgui.ImBool(true/false)​
local bool = imgui.new.bool(true/false)​
Int​
local int = imgui.ImInt(5)​
local int = imgui.new.int(5)​
Char​
local buffer = imgui.ImBuffer(128, "hello")​
local buffer = imgui.new.char[128]("hello")​
Float​
local float = imgui.ImFloat(5.12)​
local float = imgui.new.float(5.12)​
Callback​
local test = function(data) print("hey") return 0 end
local callback = imgui.ImCallback(test)​
local test = function(data) print("hey") return 0 end
local callback = ffi.cast('int (*)(ImGuiInputTextCallbackData* data)', test)​

Следует отметить, что получение исходных значений так же подверглось изменению. Если раньше исходное значение можно было получить через ключ v (buffer.v; int.v), то в mimgui они получаются с помощью нулевого индекса (int[0]; float[0]; bool[0]), а для типа Char значение необходимо получать через ffi.string (ffi.string(buffer)). Не нужно бояться внесёнными в API изменениям, они очень легко осваиваются и для ежедневного кодинга не нужно вникать в их работу.




Отличительные способности mimgui Lua
В разработке
 
Последнее редактирование модератором:

#Northn

Pears Project — уже запущен!
Автор темы
Всефорумный модератор
2,656
2,541
Насколько тяжело будет обновить mimgui до любой из версий с новым api tables?

LuaJIT-ImGui сейчас уже на 1.82, вроде проблем быть не должно.

Сам я ещё не разбирался, пока болею ничего не соображаю, но может кто-то уже успел попробовать и обжечься на каком-то сложном моменте, хотелось бы знать.
Фип говорил что разраб луаджит имгуи начал копать не в ту сторону и что-то сломал/не понравилась реализация фипу
 
  • Вау
Реакции: qrlk

FYP

Известный
Администратор
1,764
5,923
Насколько тяжело будет обновить mimgui до любой из версий с новым api tables?

LuaJIT-ImGui сейчас уже на 1.82, вроде проблем быть не должно.

Сам я ещё не разбирался, пока болею ничего не соображаю, но может кто-то уже успел попробовать и обжечься на каком-то сложном моменте, хотелось бы знать.
для этого требуется написать другой генератор ffi-биндингов для cimgui, т.к. luajit-imgui после обнов оказался непригодным для использования в качестве основы. это не тяжело, но работы хватает и есть некоторые нюансы.
 

Oreshka23

Известный
341
165
GTA_SA_MP_2021-07-05_23-41-17.gif

Чёт TextFilter не очень с кириллицей дружит, а жаль... Придётся обычным InputText
1625499863486.png

1625499884565.png

1625499900381.png
1625499863486.png

1625499962752.png

1625499981573.png

Lua:
imgui_window = {
    filter = imgui.ImGuiTextFilter()
}
imgui.OnFrame(
    function() return imgui_window.bEnable[0] end,
    function(player)
        imgui_window.filter:Draw("", 385)
        for _, v in ipairs(edit_history) do
            if imgui_window.filter:PassFilter(u8(v)) then
                imgui.Text(u8(v))
                if imgui.IsItemClicked() then
                    if sampGetCurrentDialogId() == admenu.dialog and sampIsDialogActive() then
                        sampSetCurrentDialogEditboxText(v)
                    end
                end
            end
        end
        imgui.End()
    end
).HideCursor = true
Что делать?
 
Последнее редактирование:

Oreshka23

Известный
341
165
В механике поиска переводи в один регистр букв, к примеру, в нижний, всего содержимого буффера, где ищется, и где вводишь, и не будет проблем.
прикол в том что это ImguiTextFilter. С латиницей он нормально работает, а с кириллицей уже проблемы.
 

qrlk

Известный
Друг
411
928
прикол в том что это ImguiTextFilter. С латиницей он нормально работает, а с кириллицей уже проблемы.
Возми эти функции и используй их:
Lua:
if imgui_window.filter:PassFilter(u8(string.rlower(v))) or imgui_window.filter:PassFilter(u8(string.rupper(v))) or imgui_window.filter:PassFilter(u8(v)) then
Не круто, но в большинстве случаев пользователю хватит.
 
  • Нравится
Реакции: Oreshka23

Dark_Knight

Me, me and me.
Друг
4,085
2,114
Скажу по своему опыту. ImguiTextFilter прекрасно дружит с кириллицей, но если ты юзаешь ту кодировку с которой хорошо дружит Imgui сам по себе. Если мне не изменяет память, то он дружит с юникодом. Говорю исключительно за плюсы.
 
  • Нравится
Реакции: Oreshka23

#Kai-

Известный
705
293
как получать hex из
Lua:
imgui.ColorEdit4()

Почему он может вывести hex:
Lua:
imgui.ColorEditFlags.DisplayHex
но как получать hex, а не %RGBA
 

#Kai-

Известный
705
293
Огромное спасибо за помощь! Сегодня только руки дошли сесть и попотеть... xD

Кому надо:
Lua:
imgui.ColorEdit4(u8"хуй", test.float)
local color = imgui.ColorConvertFloat4ToU32(imgui.ImVec4(test.float[0],test.float[1],test.float[2],test.float[3]))
sampAddChatMessage(bit.tohex(color), -1)
Это правда не совсем hex
Первые 2 значения прозрачность идет
 

#Northn

Pears Project — уже запущен!
Автор темы
Всефорумный модератор
2,656
2,541
Огромное спасибо за помощь! Сегодня только руки дошли сесть и попотеть... xD

Кому надо:
Lua:
imgui.ColorEdit4(u8"хуй", test.float)
local color = imgui.ColorConvertFloat4ToU32(imgui.ImVec4(test.float[0],test.float[1],test.float[2],test.float[3]))
sampAddChatMessage(bit.tohex(color), -1)
Это правда не совсем hex
Первые 2 значения прозрачность идет
Это правда AABBGGRR, вот тебе RRGGBB
Lua:
imgui.ColorEdit4(u8"хуй", test.float)
local color = imgui.ColorConvertFloat4ToU32(imgui.ImVec4(test.float[3],test.float[2],test.float[1],0))
sampAddChatMessage(bit.tohex(color), -1)
 
  • Bug
Реакции: #Kai-

#Kai-

Известный
705
293
Это правда AABBGGRR, вот тебе RRGGBB
Lua:
imgui.ColorEdit4(u8"хуй", test.float)
local color = imgui.ColorConvertFloat4ToU32(imgui.ImVec4(test.float[3],test.float[2],test.float[1],0))
sampAddChatMessage(bit.tohex(color), -1)
Спасибо, но не правильно, я просто скинул и пошел спать, самое главное конвертировать из float в букафки, а там hex вытащить не проблема.

Lua:
local color = imgui.ColorConvertFloat4ToU32(imgui.ImVec4(test.float[2],test.float[1],test.float[0],0.0))
sampAddChatMessage(bit.tohex(color), -1)
 
D

deleted-user-422095

Гость
Lua:
    text = {'Text1', 'Text2', 'Text3'}
    for q, w in ipairs(text) do
        imgui.Text(w)
        imgui.SameLine()
        if imgui.IsItemClicked() then
            imgui.LogToClipboard()
            imgui.LogText(w)
            imgui.LogFinish()
        end   
    end
Почему копируется с переносом строки? gsub не помогает
 

Cosmo

Известный
Друг
656
2,744
Lua:
    text = {'Text1', 'Text2', 'Text3'}
    for q, w in ipairs(text) do
        imgui.Text(w)
        imgui.SameLine()
        if imgui.IsItemClicked() then
            imgui.LogToClipboard()
            imgui.LogText(w)
            imgui.LogFinish()
        end
    end
Почему копируется с переносом строки? gsub не помогает
Потому что данное семейство функций предназначено для создания лога (например на протяжении всего жизненного цикла программы), а не для простой копирки информации в буфер обмена.
Для твоей задачи подойдёт встроенный в мун setClipboardText()
 
D

deleted-user-422095

Гость
Для твоей задачи подойдёт встроенный в мун setClipboardText()
Зависимо от раскладки, декодинг не помогает(
Если на англ раскладке то будут каракули(даже копирование из консоли сф при англ раскладке копирует каракули)