Syntax
imgui.create(title?: string): ImGuiWindowArgumente
| Name | Typ | Beschreibung |
|---|---|---|
title? | string | Fenstertitel. Wenn es weggelassen wird, wird der integrierte Standardtitel verwendet. Das Erstellen eines zweiten aktiven Fensters mit demselben Titel führt zu einem Fehler. |
Rückgaben
| Name | Typ | Beschreibung |
|---|---|---|
window | ImGuiWindow | Fensterhandle, das zum Anhängen von Steuerelementen und zum Zerstören des Fensters verwendet wird. |
Beschreibung
Erstellt ein ImGui-Fenster und gibt sein Fensterhandle zurück. Aktive Fenstertitel müssen eindeutig sein.
Rufe es mit 1 Parameter(n) auf: title. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.
Es gibt window (ImGuiWindow) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.
Beispiel
Erstellen Sie ein ImGui-Fenster mit Text, interaktiven Steuerelementen und Änderungsrückrufen.
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)Typen
ImGuiWindow
Von imgui.create zurückgegebener Handle. Methoden zur Steuerungserstellung geben dasselbe Handle zurück, sodass Aufrufe verkettet werden können.
Button (label: string, onClick: () -> ()) -> ImGuiWindow Fügt eine Schaltfläche hinzu und ruft den Rückruf nach einem Klick auf.Checkbox (label: string, checked: boolean, onChange: (boolean) -> ()) -> ImGuiWindow Fügt ein initialisiertes Kontrollkästchen an den bereitgestellten Status an.CollapsingHeader (label: string, content: (ImGuiWindow) -> ()) -> ImGuiWindow Gruppiert Steuerelemente, die durch den Inhaltsrückruf unter einem zusammenklappbaren Header angehängt werden.ColorPicker (label: string, red: number?, green: number?, blue: number?, alpha: number?, onChange: (number, number, number, number) -> ()) -> ImGuiWindow Fügt einen RGBA-Editor hinzu; Ausgelassene Farbkomponenten sind standardmäßig auf 1,0 eingestellt.InputText (label: string, text: string?, onChange: (string) -> ()) -> ImGuiWindow Fügt eine einzeilige Texteingabe hinzu; Der weggelassene Anfangstext ist standardmäßig eine leere Zeichenfolge.SameLine () -> ImGuiWindow Platziert das nächste Steuerelement in derselben Zeile.Separator () -> ImGuiWindow Fügt ein horizontales Trennzeichen hinzu.SliderFloat (label: string, value: number, minimum: number, maximum: number, onChange: (number) -> ()) -> ImGuiWindow Fügt einen Gleitkomma-Schieberegler hinzu.SliderInt (label: string, value: integer, minimum: integer, maximum: integer, onChange: (number) -> ()) -> ImGuiWindow Fügt einen ganzzahligen Schieberegler hinzu.Text (text: string) -> ImGuiWindow Fügt nicht interaktiven Text hinzu.destroy () -> () Entfernt das Fenster und gibt seine registrierten Rückrufe frei.