Синтаксис
imgui.create(title?: string): ImGuiWindowАргументы
| Имя | Тип | Описание |
|---|---|---|
title? | string | Заголовок окна. Если этот параметр опущен, используется встроенный заголовок по умолчанию. Создание второго активного окна с тем же заголовком вызывает ошибку. |
Возвраты
| Имя | Тип | Описание |
|---|---|---|
window | ImGuiWindow | Дескриптор окна, используемый для добавления элементов управления и уничтожения окна. |
Описание
Создает окно ImGui и возвращает дескриптор его окна. Заголовки активных окон должны быть уникальными.
Вызывай с 1 параметрами: title. Таблица аргументов показывает обязательные значения и настройки поведения.
Возвращает window (ImGuiWindow). Используй таблицу возвращаемых значений, чтобы отличать успех, nil и обрабатываемые ошибки.
Пример
Создайте окно ImGui с текстом, интерактивными элементами управления и обратными вызовами изменений.
local window = imgui.create("Runtime settings")
window:Text("Controls")
window:Separator()
window:Checkbox("Enabled", true, function(enabled)
print("Enabled:", enabled)
end)
window:SliderFloat("Opacity", 0.8, 0, 1, function(value)
print("Opacity:", value)
end)
window:InputText("Label", "Real", function(text)
print("Label:", text)
end)
window:ColorPicker("Accent", 0.3, 0.6, 1, 1, function(red, green, blue, alpha)
print(red, green, blue, alpha)
end)
window:CollapsingHeader("Advanced", function(section)
section:Text("Advanced controls go here")
end)Типы
ImGuiWindow
Дескриптор, возвращаемый imgui.create. Методы создания элементов управления возвращают один и тот же дескриптор, поэтому вызовы можно объединять в цепочки.
Button (label: string, onClick: () -> ()) -> ImGuiWindow Добавляет кнопку и вызывает обратный вызов после щелчка.Checkbox (label: string, checked: boolean, onChange: (boolean) -> ()) -> ImGuiWindow Добавляет флажок, инициализированный в указанное состояние.CollapsingHeader (label: string, content: (ImGuiWindow) -> ()) -> ImGuiWindow Элементы управления группами, добавляемые обратным вызовом содержимого под сворачивающимся заголовком.ColorPicker (label: string, red: number?, green: number?, blue: number?, alpha: number?, onChange: (number, number, number, number) -> ()) -> ImGuiWindow Добавляет редактор RGBA; опущенные цветовые компоненты по умолчанию равны 1.0.InputText (label: string, text: string?, onChange: (string) -> ()) -> ImGuiWindow Добавляет однострочный текстовый ввод; опущенный начальный текст по умолчанию представляет собой пустую строку.SameLine () -> ImGuiWindow Размещает следующий элемент управления в той же строке.Separator () -> ImGuiWindow Добавляет горизонтальный разделитель.SliderFloat (label: string, value: number, minimum: number, maximum: number, onChange: (number) -> ()) -> ImGuiWindow Добавляет ползунок с плавающей запятой.SliderInt (label: string, value: integer, minimum: integer, maximum: integer, onChange: (number) -> ()) -> ImGuiWindow Добавляет целочисленный ползунок.Text (text: string) -> ImGuiWindow Добавляет неинтерактивный текст.destroy () -> () Удаляет окно и освобождает зарегистрированные обратные вызовы.