kguimanager.h

Go to the documentation of this file.

 
#ifndef KGUIMANAGER_H
#define KGUIMANAGER_H
 
#include "kexport.h"
 
#include "kdatatype.h"
#include "krenderer.h"
#include "kwindow.h"
 
#include <SDL3/SDL.h>
 
#include "imgui.h"
#include "imgui_internal.h"
#include "backends/imgui_impl_sdl3.h"
#include "backends/imgui_impl_opengl3.h"
 
namespace kemena
{
    class KEMENA3D_API kGuiManager
    {
    public:
        kGuiManager();

        virtual ~kGuiManager();

        void init(kRenderer *newRenderer);

        void processEvent(kSystemEvent event);

        void loadDefaultFontFromResource(kString resourceName);

        void canvasStart();

        void canvasEnd();
 
        // ---- Window ----

        void windowStart(kString title, bool *open = nullptr, ImGuiWindowFlags flags = 0);

        void windowEnd();

        kVec2 getWindowSize();

        kVec2 getWindowPos();

        void setNextWindowSize(kVec2 size, ImGuiCond cond = 0);

        void setNextWindowPos(kVec2 pos, ImGuiCond cond = 0, kVec2 pivot = kVec2(0, 0));

        void setNextWindowContentSize(kVec2 size);

        void setNextWindowCollapsed(bool collapsed, ImGuiCond cond = 0);

        void setNextWindowFocus();

        void setNextWindowBgAlpha(float alpha);

        bool isWindowFocused(ImGuiFocusedFlags flags = 0);

        bool isWindowHovered(ImGuiHoveredFlags flags = 0);

        kVec2 getWindowContentRegionMin();

        kVec2 getWindowContentRegionMax();

        kVec2 getMainViewportCenter();
 
        // ---- Child Window ----

        bool childStart(kString id, kVec2 size = kVec2(0, 0), ImGuiChildFlags childFlags = 0, ImGuiWindowFlags windowFlags = 0);

        void childEnd();
 
        // ---- Dockspace ----

        void dockSpaceStart(kString name);

        void dockSpaceEnd();
 
        // ---- Menu ----

        bool menuBar();
        void menuBarEnd();

        bool menu(kString text);
        void menuEnd();

        bool menuItem(kString text, kString shortcut = "", bool selected = false, bool enabled = true);

        bool menuItem(kString text, kString shortcut, bool *selected, bool enabled = true);
 
        // ---- Layout ----

        void groupStart();
        void groupEnd();

        void beginDisabled(bool disabled = true);

        void endDisabled();

        void sameLine(float offsetFromStartX = 0.0f, float spacing = -1.0f);

        void spacing();
        void separator();

        void separatorText(kString text);

        void newLine();

        void indent(float indentW = 0.0f);

        void unindent(float indentW = 0.0f);

        void dummy(kVec2 size);

        void setCursorPos(kVec2 pos);

        void setCursorPosX(float x);
        void setCursorPosY(float y);

        kVec2 getCursorPos();
        float getCursorPosX();
        float getCursorPosY();
        kVec2 getCursorScreenPos();

        void setCursorScreenPos(kVec2 pos);

        kVec2 getContentRegionAvail();

        void setNextItemWidth(float itemWidth);

        void pushItemWidth(float itemWidth);
        void popItemWidth();
        float calcItemWidth();

        void pushTextWrapPos(float wrapLocalPosX = 0.0f);
        void popTextWrapPos();

        float getFrameHeight();

        float getFrameHeightWithSpacing();
 
        // ---- ID Stack ----

        void pushId(kString id);
        void pushId(int id);
        void pushId(const void *ptr);
        void popId();
 
        // ---- Style ----

        void pushStyleColor(ImGuiCol idx, kVec4 color);

        void pushStyleColor(ImGuiCol idx, ImU32 color);

        void popStyleColor(int count = 1);

        void pushStyleVar(ImGuiStyleVar idx, float val);

        void pushStyleVar(ImGuiStyleVar idx, kVec2 val);

        void popStyleVar(int count = 1);

        void pushFont(ImFont *font);
        void popFont();

        float getFontSize();
 
        // ---- Text ----

        void text(kString text);

        void textColored(kVec4 color, kString text);

        void textDisabled(kString text);

        void alignTextToFramePadding();
        void textWrapped(kString text);

        void labelText(kString label, kString text);

        void bulletText(kString text);
        void bullet();

        kVec2 calcTextSize(kString text, bool hideTextAfterDoubleHash = false, float wrapWidth = -1.0f);
 
        // ---- Buttons ----

        bool button(kString text, kIvec2 size = kIvec2(0, 0));

        bool smallButton(kString text);

        bool invisibleButton(kString id, kVec2 size, ImGuiButtonFlags flags = 0);

        bool arrowButton(kString id, ImGuiDir dir);

        bool radioButton(kString label, bool active);

        bool radioButton(kString label, int *v, int vButton);
 
        // ---- Checkbox ----

        bool checkbox(kString text, bool *output);

        bool checkboxFlags(kString label, int *flags, int flagsValue);

        bool checkboxFlags(kString label, unsigned int *flags, unsigned int flagsValue);
 
        // ---- Input Text ----

        bool inputText(kString label, kString &value, size_t maxLength = 256, ImGuiInputTextFlags flags = 0);

        bool inputTextMultiline(kString label, kString &value, size_t maxLength = 1024, kVec2 size = kVec2(0, 0), ImGuiInputTextFlags flags = 0);

        bool inputTextWithHint(kString label, kString hint, kString &value, size_t maxLength = 256, ImGuiInputTextFlags flags = 0);
 
        // ---- Input Scalar ----

        bool inputFloat(kString label, float *v, float step = 0.0f, float stepFast = 0.0f, kString format = "%.3f", ImGuiInputTextFlags flags = 0);
        bool inputFloat2(kString label, float v[2], kString format = "%.3f", ImGuiInputTextFlags flags = 0);
        bool inputFloat3(kString label, float v[3], kString format = "%.3f", ImGuiInputTextFlags flags = 0);
        bool inputFloat4(kString label, float v[4], kString format = "%.3f", ImGuiInputTextFlags flags = 0);
        bool inputInt(kString label, int *v, int step = 1, int stepFast = 100, ImGuiInputTextFlags flags = 0);
        bool inputInt2(kString label, int v[2], ImGuiInputTextFlags flags = 0);
        bool inputInt3(kString label, int v[3], ImGuiInputTextFlags flags = 0);
        bool inputInt4(kString label, int v[4], ImGuiInputTextFlags flags = 0);
        bool inputDouble(kString label, double *v, double step = 0.0, double stepFast = 0.0, kString format = "%.6f", ImGuiInputTextFlags flags = 0);
 
        // ---- Drag ----

        bool dragFloat(kString label, float *v, float speed = 1.0f, float min = 0.0f, float max = 0.0f, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool dragFloat2(kString label, float v[2], float speed = 1.0f, float min = 0.0f, float max = 0.0f, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool dragFloat3(kString label, float v[3], float speed = 1.0f, float min = 0.0f, float max = 0.0f, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool dragFloat4(kString label, float v[4], float speed = 1.0f, float min = 0.0f, float max = 0.0f, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool dragInt(kString label, int *v, float speed = 1.0f, int min = 0, int max = 0, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool dragInt2(kString label, int v[2], float speed = 1.0f, int min = 0, int max = 0, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool dragInt3(kString label, int v[3], float speed = 1.0f, int min = 0, int max = 0, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool dragInt4(kString label, int v[4], float speed = 1.0f, int min = 0, int max = 0, kString format = "%d", ImGuiSliderFlags flags = 0);

        bool dragFloatRange2(kString label, float *vCurrentMin, float *vCurrentMax, float speed = 1.0f, float min = 0.0f, float max = 0.0f, kString format = "%.3f", kString formatMax = "", ImGuiSliderFlags flags = 0);

        bool dragIntRange2(kString label, int *vCurrentMin, int *vCurrentMax, float speed = 1.0f, int min = 0, int max = 0, kString format = "%d", kString formatMax = "", ImGuiSliderFlags flags = 0);
 
        // ---- Slider ----

        bool sliderFloat(kString label, float *v, float min, float max, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool sliderFloat2(kString label, float v[2], float min, float max, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool sliderFloat3(kString label, float v[3], float min, float max, kString format = "%.3f", ImGuiSliderFlags flags = 0);
        bool sliderFloat4(kString label, float v[4], float min, float max, kString format = "%.3f", ImGuiSliderFlags flags = 0);

        bool sliderAngle(kString label, float *vRad, float vDegreesMin = -360.0f, float vDegreesMax = 360.0f, kString format = "%.0f deg", ImGuiSliderFlags flags = 0);

        bool sliderInt(kString label, int *v, int min, int max, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool sliderInt2(kString label, int v[2], int min, int max, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool sliderInt3(kString label, int v[3], int min, int max, kString format = "%d", ImGuiSliderFlags flags = 0);
        bool sliderInt4(kString label, int v[4], int min, int max, kString format = "%d", ImGuiSliderFlags flags = 0);
 
        // ---- Color ----

        bool colorEdit3(kString label, float col[3], ImGuiColorEditFlags flags = 0);
        bool colorEdit4(kString label, float col[4], ImGuiColorEditFlags flags = 0);
        bool colorPicker3(kString label, float col[3], ImGuiColorEditFlags flags = 0);
        bool colorPicker4(kString label, float col[4], ImGuiColorEditFlags flags = 0);

        bool colorButton(kString descId, kVec4 col, ImGuiColorEditFlags flags = 0, kVec2 size = kVec2(0, 0));

        void setColorEditOptions(ImGuiColorEditFlags flags);
 
        // ---- Combo / List / Selectable ----

        bool combo(kString label, int *currentItem, std::vector<kString> items, int popupMaxHeightInItems = -1);

        bool listBox(kString label, int *currentItem, std::vector<kString> items, int heightInItems = -1);

        bool selectable(kString label, bool selected = false, ImGuiSelectableFlags flags = 0, kVec2 size = kVec2(0, 0));

        bool selectable(kString label, bool *pSelected, ImGuiSelectableFlags flags = 0, kVec2 size = kVec2(0, 0));
 
        // ---- Tree / Collapsing ----

        bool treeStart(kString label);

        bool treeStartEx(kString id, kString label = "", ImGuiTreeNodeFlags flags = 0);

        void treeEnd();
        void treePop();

        bool collapsingHeader(kString label, ImGuiTreeNodeFlags flags = 0);

        bool collapsingHeader(kString label, bool *visible, ImGuiTreeNodeFlags flags = 0);

        void setNextItemOpen(bool isOpen, ImGuiCond cond = 0);
 
        // ---- Image ----

        void image(GLuint textureId, kVec2 size, kVec2 uv0 = kVec2(0, 0), kVec2 uv1 = kVec2(1, 1));

        bool imageButton(kString id, GLuint textureId, kVec2 size, kVec2 uv0 = kVec2(0, 0), kVec2 uv1 = kVec2(1, 1), kVec4 tint = kVec4(1, 1, 1, 1));
 
        // ---- Progress ----

        void progressBar(float fraction, kVec2 size = kVec2(-FLT_MIN, 0), kString overlay = "");
 
        // ---- Tooltip ----

        void setItemTooltip(kString text);

        void beginTooltip();
        void endTooltip();
 
        // ---- Popup ----

        void openPopup(kString id, ImGuiPopupFlags flags = 0);

        bool popupStart(kString id, ImGuiWindowFlags flags = 0);

        void popupEnd();

        bool popupModal(kString name, bool *open = nullptr, ImGuiWindowFlags flags = 0);

        bool popupContextItemStart(kString id = "", ImGuiPopupFlags flags = ImGuiPopupFlags_MouseButtonRight);

        bool popupContextWindowStart(kString id = "", ImGuiPopupFlags flags = ImGuiPopupFlags_MouseButtonRight);

        bool isPopupOpen(kString id, ImGuiPopupFlags flags = 0);

        void closeCurrentPopup();
 
        // ---- Tab Bar ----

        bool tabBarStart(kString id, ImGuiTabBarFlags flags = 0);
        void tabBarEnd();

        bool tabItemStart(kString label, bool *open = nullptr, ImGuiTabItemFlags flags = 0);
        void tabItemEnd();

        void setTabItemClosed(kString tabOrDockedWindowLabel);
 
        // ---- Tables ----

        bool tableStart(kString id, int columns, ImGuiTableFlags flags = 0, kVec2 outerSize = kVec2(0, 0), float innerWidth = 0.0f);
        void tableEnd();

        bool tableNextColumn();

        bool tableSetColumnIndex(int columnN);

        void tableNextRow(ImGuiTableRowFlags rowFlags = 0, float minRowHeight = 0.0f);

        void tableSetupColumn(kString label, ImGuiTableColumnFlags flags = 0, float initWidthOrWeight = 0.0f);

        void tableSetupScrollFreeze(int cols, int rows);

        void tableHeadersRow();

        void tableHeader(kString label);
 
        // ---- Columns ----

        void columnsStart(int count = 1, kString id = "", bool borders = true);

        void columnsEnd();

        void nextColumn();

        float getColumnWidth(int columnIndex = -1);
 
        // ---- Scroll ----

        float getScrollX();
        float getScrollY();
        void setScrollX(float scrollX);
        void setScrollY(float scrollY);
        float getScrollMaxX();
        float getScrollMaxY();
        void setScrollHereX(float centerXRatio = 0.5f);
        void setScrollHereY(float centerYRatio = 0.5f);
 
        // ---- Item Queries ----

        bool isItemHovered(ImGuiHoveredFlags flags = 0);
        bool isItemActive();
        bool isItemFocused();
        bool isItemClicked(ImGuiMouseButton mouseButton = 0);
        bool isItemVisible();
        bool isItemEdited();
        bool isItemActivated();
        bool isItemDeactivated();
        bool isItemDeactivatedAfterEdit();
        bool isItemToggledOpen();
        bool isAnyItemHovered();
        bool isAnyItemActive();
        bool isAnyItemFocused();
        kVec2 getItemRectMin();
        kVec2 getItemRectMax();
        kVec2 getItemRectSize();

        void setNextItemAllowOverlap();
 
        // ---- Mouse ----

        bool isMouseDown(ImGuiMouseButton button);
        bool isMouseClicked(ImGuiMouseButton button, bool repeat = false);
        bool isMouseReleased(ImGuiMouseButton button);
        bool isMouseDoubleClicked(ImGuiMouseButton button);
        bool isMouseHoveringRect(kVec2 rMin, kVec2 rMax, bool clip = true);
        kVec2 getMousePos();
        kVec2 getMouseDelta();
        float getMouseWheel();
 
        // ---- Keyboard ----

        bool isKeyShift();

        bool isKeyCtrl();

        bool getWantTextInput();

        float getDeltaTime();
 
        // ---- Draw ----

        void drawListAddImage(GLuint textureId, kVec2 pMin, kVec2 pMax, kVec2 uvMin = kVec2(0, 0), kVec2 uvMax = kVec2(1, 1), kVec4 tint = kVec4(1, 1, 1, 1));

        float getTextLineHeight();

        void textUnformatted(kString text);
 
        // ---- Utility ----

        void setClipboardText(kString text);

        void saveIniSettingsToDisk(kString filename);

        void loadIniSettingsFromDisk(kString filename);

        void loadIniSettingsFromMemory(const char *data, size_t size);

        void addSettingsHandler(ImGuiSettingsHandler handler);

        void destroy();
 
    protected:
    private:
        float      mainScale; 
        kRenderer *renderer;  
    };
}
 
#endif // KGUIMANAGER_H