mirror of
https://github.com/ocornut/imgui.git
synced 2024-12-13 21:19:02 +08:00
916 lines
57 KiB
C++
916 lines
57 KiB
C++
// dear imgui, v1.52 WIP
|
|
// (internals)
|
|
|
|
// You may use this file to debug, understand or extend ImGui features but we don't provide any guarantee of forward compatibility!
|
|
// Implement maths operators for ImVec2 (disabled by default to not collide with using IM_VEC2_CLASS_EXTRA along with your own math types+operators)
|
|
// #define IMGUI_DEFINE_MATH_OPERATORS
|
|
// Define IM_PLACEMENT_NEW() macro helper.
|
|
// #define IMGUI_DEFINE_PLACEMENT_NEW
|
|
|
|
#pragma once
|
|
|
|
#ifndef IMGUI_VERSION
|
|
#error Must include imgui.h before imgui_internal.h
|
|
#endif
|
|
|
|
#include <stdio.h> // FILE*
|
|
#include <math.h> // sqrtf, fabsf, fmodf, powf, floorf, ceilf, cosf, sinf
|
|
#include <limits.h> // INT_MIN, INT_MAX
|
|
|
|
#ifdef _MSC_VER
|
|
#pragma warning (push)
|
|
#pragma warning (disable: 4251) // class 'xxx' needs to have dll-interface to be used by clients of struct 'xxx' // when IMGUI_API is set to__declspec(dllexport)
|
|
#endif
|
|
|
|
#ifdef __clang__
|
|
#pragma clang diagnostic push
|
|
#pragma clang diagnostic ignored "-Wunused-function" // for stb_textedit.h
|
|
#pragma clang diagnostic ignored "-Wmissing-prototypes" // for stb_textedit.h
|
|
#pragma clang diagnostic ignored "-Wold-style-cast"
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Forward Declarations
|
|
//-----------------------------------------------------------------------------
|
|
|
|
struct ImRect;
|
|
struct ImGuiColMod;
|
|
struct ImGuiStyleMod;
|
|
struct ImGuiGroupData;
|
|
struct ImGuiSimpleColumns;
|
|
struct ImGuiDrawContext;
|
|
struct ImGuiTextEditState;
|
|
struct ImGuiIniData;
|
|
struct ImGuiMouseCursorData;
|
|
struct ImGuiPopupRef;
|
|
struct ImGuiWindow;
|
|
|
|
typedef int ImGuiLayoutType; // enum ImGuiLayoutType_
|
|
typedef int ImGuiButtonFlags; // enum ImGuiButtonFlags_
|
|
typedef int ImGuiTreeNodeFlags; // enum ImGuiTreeNodeFlags_
|
|
typedef int ImGuiSliderFlags; // enum ImGuiSliderFlags_
|
|
typedef int ImGuiItemFlags; // enum ImGuiItemFlags_
|
|
|
|
//-------------------------------------------------------------------------
|
|
// STB libraries
|
|
//-------------------------------------------------------------------------
|
|
|
|
namespace ImGuiStb
|
|
{
|
|
|
|
#undef STB_TEXTEDIT_STRING
|
|
#undef STB_TEXTEDIT_CHARTYPE
|
|
#define STB_TEXTEDIT_STRING ImGuiTextEditState
|
|
#define STB_TEXTEDIT_CHARTYPE ImWchar
|
|
#define STB_TEXTEDIT_GETWIDTH_NEWLINE -1.0f
|
|
#include "stb_textedit.h"
|
|
|
|
} // namespace ImGuiStb
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Context
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#ifndef GImGui
|
|
extern IMGUI_API ImGuiContext* GImGui; // Current implicit ImGui context pointer
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Helpers
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#define IM_ARRAYSIZE(_ARR) ((int)(sizeof(_ARR)/sizeof(*_ARR)))
|
|
#define IM_PI 3.14159265358979323846f
|
|
#define IM_OFFSETOF(_TYPE,_ELM) ((size_t)&(((_TYPE*)0)->_ELM))
|
|
|
|
// Helpers: UTF-8 <> wchar
|
|
IMGUI_API int ImTextStrToUtf8(char* buf, int buf_size, const ImWchar* in_text, const ImWchar* in_text_end); // return output UTF-8 bytes count
|
|
IMGUI_API int ImTextCharFromUtf8(unsigned int* out_char, const char* in_text, const char* in_text_end); // return input UTF-8 bytes count
|
|
IMGUI_API int ImTextStrFromUtf8(ImWchar* buf, int buf_size, const char* in_text, const char* in_text_end, const char** in_remaining = NULL); // return input UTF-8 bytes count
|
|
IMGUI_API int ImTextCountCharsFromUtf8(const char* in_text, const char* in_text_end); // return number of UTF-8 code-points (NOT bytes count)
|
|
IMGUI_API int ImTextCountUtf8BytesFromStr(const ImWchar* in_text, const ImWchar* in_text_end); // return number of bytes to express string as UTF-8 code-points
|
|
|
|
// Helpers: Misc
|
|
IMGUI_API ImU32 ImHash(const void* data, int data_size, ImU32 seed = 0); // Pass data_size==0 for zero-terminated strings
|
|
IMGUI_API void* ImFileLoadToMemory(const char* filename, const char* file_open_mode, int* out_file_size = NULL, int padding_bytes = 0);
|
|
IMGUI_API FILE* ImFileOpen(const char* filename, const char* file_open_mode);
|
|
static inline bool ImCharIsSpace(int c) { return c == ' ' || c == '\t' || c == 0x3000; }
|
|
static inline bool ImIsPowerOfTwo(int v) { return v != 0 && (v & (v - 1)) == 0; }
|
|
static inline int ImUpperPowerOfTwo(int v) { v--; v |= v >> 1; v |= v >> 2; v |= v >> 4; v |= v >> 8; v |= v >> 16; v++; return v; }
|
|
|
|
// Helpers: Geometry
|
|
IMGUI_API ImVec2 ImLineClosestPoint(const ImVec2& a, const ImVec2& b, const ImVec2& p);
|
|
IMGUI_API bool ImTriangleContainsPoint(const ImVec2& a, const ImVec2& b, const ImVec2& c, const ImVec2& p);
|
|
IMGUI_API ImVec2 ImTriangleClosestPoint(const ImVec2& a, const ImVec2& b, const ImVec2& c, const ImVec2& p);
|
|
IMGUI_API void ImTriangleBarycentricCoords(const ImVec2& a, const ImVec2& b, const ImVec2& c, const ImVec2& p, float& out_u, float& out_v, float& out_w);
|
|
|
|
// Helpers: String
|
|
IMGUI_API int ImStricmp(const char* str1, const char* str2);
|
|
IMGUI_API int ImStrnicmp(const char* str1, const char* str2, int count);
|
|
IMGUI_API char* ImStrdup(const char* str);
|
|
IMGUI_API int ImStrlenW(const ImWchar* str);
|
|
IMGUI_API const ImWchar*ImStrbolW(const ImWchar* buf_mid_line, const ImWchar* buf_begin); // Find beginning-of-line
|
|
IMGUI_API const char* ImStristr(const char* haystack, const char* haystack_end, const char* needle, const char* needle_end);
|
|
IMGUI_API int ImFormatString(char* buf, int buf_size, const char* fmt, ...) IM_FMTARGS(3);
|
|
IMGUI_API int ImFormatStringV(char* buf, int buf_size, const char* fmt, va_list args) IM_FMTLIST(3);
|
|
|
|
// Helpers: Math
|
|
// We are keeping those not leaking to the user by default, in the case the user has implicit cast operators between ImVec2 and its own types (when IM_VEC2_CLASS_EXTRA is defined)
|
|
#ifdef IMGUI_DEFINE_MATH_OPERATORS
|
|
static inline ImVec2 operator*(const ImVec2& lhs, const float rhs) { return ImVec2(lhs.x*rhs, lhs.y*rhs); }
|
|
static inline ImVec2 operator/(const ImVec2& lhs, const float rhs) { return ImVec2(lhs.x/rhs, lhs.y/rhs); }
|
|
static inline ImVec2 operator+(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(lhs.x+rhs.x, lhs.y+rhs.y); }
|
|
static inline ImVec2 operator-(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(lhs.x-rhs.x, lhs.y-rhs.y); }
|
|
static inline ImVec2 operator*(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(lhs.x*rhs.x, lhs.y*rhs.y); }
|
|
static inline ImVec2 operator/(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(lhs.x/rhs.x, lhs.y/rhs.y); }
|
|
static inline ImVec2& operator+=(ImVec2& lhs, const ImVec2& rhs) { lhs.x += rhs.x; lhs.y += rhs.y; return lhs; }
|
|
static inline ImVec2& operator-=(ImVec2& lhs, const ImVec2& rhs) { lhs.x -= rhs.x; lhs.y -= rhs.y; return lhs; }
|
|
static inline ImVec2& operator*=(ImVec2& lhs, const float rhs) { lhs.x *= rhs; lhs.y *= rhs; return lhs; }
|
|
static inline ImVec2& operator/=(ImVec2& lhs, const float rhs) { lhs.x /= rhs; lhs.y /= rhs; return lhs; }
|
|
static inline ImVec4 operator-(const ImVec4& lhs, const ImVec4& rhs) { return ImVec4(lhs.x-rhs.x, lhs.y-rhs.y, lhs.z-rhs.z, lhs.w-rhs.w); }
|
|
#endif
|
|
|
|
static inline int ImMin(int lhs, int rhs) { return lhs < rhs ? lhs : rhs; }
|
|
static inline int ImMax(int lhs, int rhs) { return lhs >= rhs ? lhs : rhs; }
|
|
static inline float ImMin(float lhs, float rhs) { return lhs < rhs ? lhs : rhs; }
|
|
static inline float ImMax(float lhs, float rhs) { return lhs >= rhs ? lhs : rhs; }
|
|
static inline ImVec2 ImMin(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(ImMin(lhs.x,rhs.x), ImMin(lhs.y,rhs.y)); }
|
|
static inline ImVec2 ImMax(const ImVec2& lhs, const ImVec2& rhs) { return ImVec2(ImMax(lhs.x,rhs.x), ImMax(lhs.y,rhs.y)); }
|
|
static inline int ImClamp(int v, int mn, int mx) { return (v < mn) ? mn : (v > mx) ? mx : v; }
|
|
static inline float ImClamp(float v, float mn, float mx) { return (v < mn) ? mn : (v > mx) ? mx : v; }
|
|
static inline ImVec2 ImClamp(const ImVec2& f, const ImVec2& mn, ImVec2 mx) { return ImVec2(ImClamp(f.x,mn.x,mx.x), ImClamp(f.y,mn.y,mx.y)); }
|
|
static inline float ImSaturate(float f) { return (f < 0.0f) ? 0.0f : (f > 1.0f) ? 1.0f : f; }
|
|
static inline void ImSwap(float& a, float& b) { float tmp = a; a = b; b = tmp; }
|
|
static inline int ImLerp(int a, int b, float t) { return (int)(a + (b - a) * t); }
|
|
static inline float ImLerp(float a, float b, float t) { return a + (b - a) * t; }
|
|
static inline ImVec2 ImLerp(const ImVec2& a, const ImVec2& b, float t) { return ImVec2(a.x + (b.x - a.x) * t, a.y + (b.y - a.y) * t); }
|
|
static inline ImVec2 ImLerp(const ImVec2& a, const ImVec2& b, const ImVec2& t) { return ImVec2(a.x + (b.x - a.x) * t.x, a.y + (b.y - a.y) * t.y); }
|
|
static inline float ImLengthSqr(const ImVec2& lhs) { return lhs.x*lhs.x + lhs.y*lhs.y; }
|
|
static inline float ImLengthSqr(const ImVec4& lhs) { return lhs.x*lhs.x + lhs.y*lhs.y + lhs.z*lhs.z + lhs.w*lhs.w; }
|
|
static inline float ImInvLength(const ImVec2& lhs, float fail_value) { float d = lhs.x*lhs.x + lhs.y*lhs.y; if (d > 0.0f) return 1.0f / sqrtf(d); return fail_value; }
|
|
static inline float ImFloor(float f) { return (float)(int)f; }
|
|
static inline ImVec2 ImFloor(const ImVec2& v) { return ImVec2((float)(int)v.x, (float)(int)v.y); }
|
|
static inline float ImDot(const ImVec2& a, const ImVec2& b) { return a.x * b.x + a.y * b.y; }
|
|
static inline ImVec2 ImRotate(const ImVec2& v, float cos_a, float sin_a) { return ImVec2(v.x * cos_a - v.y * sin_a, v.x * sin_a + v.y * cos_a); }
|
|
|
|
// We call C++ constructor on own allocated memory via the placement "new(ptr) Type()" syntax.
|
|
// Defining a custom placement new() with a dummy parameter allows us to bypass including <new> which on some platforms complains when user has disabled exceptions.
|
|
#ifdef IMGUI_DEFINE_PLACEMENT_NEW
|
|
struct ImPlacementNewDummy {};
|
|
inline void* operator new(size_t, ImPlacementNewDummy, void* ptr) { return ptr; }
|
|
inline void operator delete(void*, ImPlacementNewDummy, void*) {}
|
|
#define IM_PLACEMENT_NEW(_PTR) new(ImPlacementNewDummy(), _PTR)
|
|
#endif
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Types
|
|
//-----------------------------------------------------------------------------
|
|
|
|
enum ImGuiButtonFlags_
|
|
{
|
|
ImGuiButtonFlags_Repeat = 1 << 0, // hold to repeat
|
|
ImGuiButtonFlags_PressedOnClickRelease = 1 << 1, // (default) return pressed on click+release on same item (default if no PressedOn** flag is set)
|
|
ImGuiButtonFlags_PressedOnClick = 1 << 2, // return pressed on click (default requires click+release)
|
|
ImGuiButtonFlags_PressedOnRelease = 1 << 3, // return pressed on release (default requires click+release)
|
|
ImGuiButtonFlags_PressedOnDoubleClick = 1 << 4, // return pressed on double-click (default requires click+release)
|
|
ImGuiButtonFlags_FlattenChilds = 1 << 5, // allow interaction even if a child window is overlapping
|
|
ImGuiButtonFlags_DontClosePopups = 1 << 6, // disable automatically closing parent popup on press
|
|
ImGuiButtonFlags_Disabled = 1 << 7, // disable interaction
|
|
ImGuiButtonFlags_AlignTextBaseLine = 1 << 8, // vertically align button to match text baseline - ButtonEx() only
|
|
ImGuiButtonFlags_NoKeyModifiers = 1 << 9, // disable interaction if a key modifier is held
|
|
ImGuiButtonFlags_AllowOverlapMode = 1 << 10, // require previous frame HoveredId to either match id or be null before being usable
|
|
ImGuiButtonFlags_NoNavOverride = 1 << 11 // don't override navigation id when activated
|
|
};
|
|
|
|
enum ImGuiSliderFlags_
|
|
{
|
|
ImGuiSliderFlags_Vertical = 1 << 0
|
|
};
|
|
|
|
enum ImGuiColumnsFlags_
|
|
{
|
|
// Default: 0
|
|
ImGuiColumnsFlags_NoBorder = 1 << 0, // Disable column dividers
|
|
ImGuiColumnsFlags_NoResize = 1 << 1, // Disable resizing columns when clicking on the dividers
|
|
ImGuiColumnsFlags_NoPreserveWidths = 1 << 2, // Disable column width preservation when adjusting columns
|
|
ImGuiColumnsFlags_NoForceWithinWindow = 1 << 3 // Disable forcing columns to fit within window
|
|
};
|
|
|
|
enum ImGuiSelectableFlagsPrivate_
|
|
{
|
|
// NB: need to be in sync with last value of ImGuiSelectableFlags_
|
|
ImGuiSelectableFlags_Menu = 1 << 3,
|
|
ImGuiSelectableFlags_MenuItem = 1 << 4,
|
|
ImGuiSelectableFlags_Disabled = 1 << 5,
|
|
ImGuiSelectableFlags_DrawFillAvailWidth = 1 << 6
|
|
};
|
|
|
|
// FIXME: this is in development, not exposed/functional as a generic feature yet.
|
|
enum ImGuiLayoutType_
|
|
{
|
|
ImGuiLayoutType_Vertical,
|
|
ImGuiLayoutType_Horizontal
|
|
};
|
|
|
|
enum ImGuiPlotType
|
|
{
|
|
ImGuiPlotType_Lines,
|
|
ImGuiPlotType_Histogram
|
|
};
|
|
|
|
enum ImGuiDataType
|
|
{
|
|
ImGuiDataType_Int,
|
|
ImGuiDataType_Float,
|
|
ImGuiDataType_Float2,
|
|
};
|
|
|
|
enum ImGuiInputSource
|
|
{
|
|
ImGuiInputSource_None = 0,
|
|
ImGuiInputSource_Mouse,
|
|
ImGuiInputSource_Nav,
|
|
ImGuiInputSource_Count_,
|
|
};
|
|
|
|
enum ImGuiDir
|
|
{
|
|
ImGuiDir_None = -1,
|
|
ImGuiDir_Left = 0,
|
|
ImGuiDir_Right = 1,
|
|
ImGuiDir_Up = 2,
|
|
ImGuiDir_Down = 3,
|
|
};
|
|
|
|
enum ImGuiCorner
|
|
{
|
|
ImGuiCorner_TopLeft = 1 << 0, // 1
|
|
ImGuiCorner_TopRight = 1 << 1, // 2
|
|
ImGuiCorner_BotRight = 1 << 2, // 4
|
|
ImGuiCorner_BotLeft = 1 << 3, // 8
|
|
ImGuiCorner_All = 0x0F
|
|
};
|
|
|
|
// 2D axis aligned bounding-box
|
|
// NB: we can't rely on ImVec2 math operators being available here
|
|
struct IMGUI_API ImRect
|
|
{
|
|
ImVec2 Min; // Upper-left
|
|
ImVec2 Max; // Lower-right
|
|
|
|
ImRect() : Min(FLT_MAX,FLT_MAX), Max(-FLT_MAX,-FLT_MAX) {}
|
|
ImRect(const ImVec2& min, const ImVec2& max) : Min(min), Max(max) {}
|
|
ImRect(const ImVec4& v) : Min(v.x, v.y), Max(v.z, v.w) {}
|
|
ImRect(float x1, float y1, float x2, float y2) : Min(x1, y1), Max(x2, y2) {}
|
|
|
|
ImVec2 GetCenter() const { return ImVec2((Min.x+Max.x)*0.5f, (Min.y+Max.y)*0.5f); }
|
|
ImVec2 GetSize() const { return ImVec2(Max.x-Min.x, Max.y-Min.y); }
|
|
float GetWidth() const { return Max.x-Min.x; }
|
|
float GetHeight() const { return Max.y-Min.y; }
|
|
ImVec2 GetTL() const { return Min; } // Top-left
|
|
ImVec2 GetTR() const { return ImVec2(Max.x, Min.y); } // Top-right
|
|
ImVec2 GetBL() const { return ImVec2(Min.x, Max.y); } // Bottom-left
|
|
ImVec2 GetBR() const { return Max; } // Bottom-right
|
|
bool Contains(const ImVec2& p) const { return p.x >= Min.x && p.y >= Min.y && p.x < Max.x && p.y < Max.y; }
|
|
bool Contains(const ImRect& r) const { return r.Min.x >= Min.x && r.Min.y >= Min.y && r.Max.x < Max.x && r.Max.y < Max.y; }
|
|
bool Overlaps(const ImRect& r) const { return r.Min.y < Max.y && r.Max.y > Min.y && r.Min.x < Max.x && r.Max.x > Min.x; }
|
|
void Add(const ImVec2& rhs) { if (Min.x > rhs.x) Min.x = rhs.x; if (Min.y > rhs.y) Min.y = rhs.y; if (Max.x < rhs.x) Max.x = rhs.x; if (Max.y < rhs.y) Max.y = rhs.y; }
|
|
void Add(const ImRect& rhs) { if (Min.x > rhs.Min.x) Min.x = rhs.Min.x; if (Min.y > rhs.Min.y) Min.y = rhs.Min.y; if (Max.x < rhs.Max.x) Max.x = rhs.Max.x; if (Max.y < rhs.Max.y) Max.y = rhs.Max.y; }
|
|
void Expand(const float amount) { Min.x -= amount; Min.y -= amount; Max.x += amount; Max.y += amount; }
|
|
void Expand(const ImVec2& amount) { Min.x -= amount.x; Min.y -= amount.y; Max.x += amount.x; Max.y += amount.y; }
|
|
void Translate(const ImVec2& v) { Min.x += v.x; Min.y += v.y; Max.x += v.x; Max.y += v.y; }
|
|
void ClipWith(const ImRect& clip) { if (Min.x < clip.Min.x) Min.x = clip.Min.x; if (Min.y < clip.Min.y) Min.y = clip.Min.y; if (Max.x > clip.Max.x) Max.x = clip.Max.x; if (Max.y > clip.Max.y) Max.y = clip.Max.y; }
|
|
void Floor() { Min.x = (float)(int)Min.x; Min.y = (float)(int)Min.y; Max.x = (float)(int)Max.x; Max.y = (float)(int)Max.y; }
|
|
ImVec2 GetClosestPoint(ImVec2 p, bool on_edge) const
|
|
{
|
|
if (!on_edge && Contains(p))
|
|
return p;
|
|
if (p.x > Max.x) p.x = Max.x;
|
|
else if (p.x < Min.x) p.x = Min.x;
|
|
if (p.y > Max.y) p.y = Max.y;
|
|
else if (p.y < Min.y) p.y = Min.y;
|
|
return p;
|
|
}
|
|
};
|
|
|
|
// Stacked color modifier, backup of modified data so we can restore it
|
|
struct ImGuiColMod
|
|
{
|
|
ImGuiCol Col;
|
|
ImVec4 BackupValue;
|
|
};
|
|
|
|
// Stacked style modifier, backup of modified data so we can restore it. Data type inferred from the variable.
|
|
struct ImGuiStyleMod
|
|
{
|
|
ImGuiStyleVar VarIdx;
|
|
union { int BackupInt[2]; float BackupFloat[2]; };
|
|
ImGuiStyleMod(ImGuiStyleVar idx, int v) { VarIdx = idx; BackupInt[0] = v; }
|
|
ImGuiStyleMod(ImGuiStyleVar idx, float v) { VarIdx = idx; BackupFloat[0] = v; }
|
|
ImGuiStyleMod(ImGuiStyleVar idx, ImVec2 v) { VarIdx = idx; BackupFloat[0] = v.x; BackupFloat[1] = v.y; }
|
|
};
|
|
|
|
// Stacked data for BeginGroup()/EndGroup()
|
|
struct ImGuiGroupData
|
|
{
|
|
ImVec2 BackupCursorPos;
|
|
ImVec2 BackupCursorMaxPos;
|
|
float BackupIndentX;
|
|
float BackupGroupOffsetX;
|
|
float BackupCurrentLineHeight;
|
|
float BackupCurrentLineTextBaseOffset;
|
|
float BackupLogLinePosY;
|
|
bool BackupActiveIdIsAlive;
|
|
bool AdvanceCursor;
|
|
};
|
|
|
|
// Per column data for Columns()
|
|
struct ImGuiColumnData
|
|
{
|
|
float OffsetNorm; // Column start offset, normalized 0.0 (far left) -> 1.0 (far right)
|
|
ImRect ClipRect;
|
|
//float IndentX;
|
|
};
|
|
|
|
// Simple column measurement currently used for MenuItem() only. This is very short-sighted/throw-away code and NOT a generic helper.
|
|
struct IMGUI_API ImGuiSimpleColumns
|
|
{
|
|
int Count;
|
|
float Spacing;
|
|
float Width, NextWidth;
|
|
float Pos[8], NextWidths[8];
|
|
|
|
ImGuiSimpleColumns();
|
|
void Update(int count, float spacing, bool clear);
|
|
float DeclColumns(float w0, float w1, float w2);
|
|
float CalcExtraSpace(float avail_w);
|
|
};
|
|
|
|
// Internal state of the currently focused/edited text input box
|
|
struct IMGUI_API ImGuiTextEditState
|
|
{
|
|
ImGuiID Id; // widget id owning the text state
|
|
ImVector<ImWchar> Text; // edit buffer, we need to persist but can't guarantee the persistence of the user-provided buffer. so we copy into own buffer.
|
|
ImVector<char> InitialText; // backup of end-user buffer at the time of focus (in UTF-8, unaltered)
|
|
ImVector<char> TempTextBuffer;
|
|
int CurLenA, CurLenW; // we need to maintain our buffer length in both UTF-8 and wchar format.
|
|
int BufSizeA; // end-user buffer size
|
|
float ScrollX;
|
|
ImGuiStb::STB_TexteditState StbState;
|
|
float CursorAnim;
|
|
bool CursorFollow;
|
|
bool SelectedAllMouseLock;
|
|
|
|
ImGuiTextEditState() { memset(this, 0, sizeof(*this)); }
|
|
void CursorAnimReset() { CursorAnim = -0.30f; } // After a user-input the cursor stays on for a while without blinking
|
|
void CursorClamp() { StbState.cursor = ImMin(StbState.cursor, CurLenW); StbState.select_start = ImMin(StbState.select_start, CurLenW); StbState.select_end = ImMin(StbState.select_end, CurLenW); }
|
|
bool HasSelection() const { return StbState.select_start != StbState.select_end; }
|
|
void ClearSelection() { StbState.select_start = StbState.select_end = StbState.cursor; }
|
|
void SelectAll() { StbState.select_start = 0; StbState.select_end = CurLenW; StbState.cursor = StbState.select_end; StbState.has_preferred_x = false; }
|
|
void OnKeyPressed(int key);
|
|
};
|
|
|
|
// Data saved in imgui.ini file
|
|
struct ImGuiIniData
|
|
{
|
|
char* Name;
|
|
ImGuiID Id;
|
|
ImVec2 Pos;
|
|
ImVec2 Size;
|
|
bool Collapsed;
|
|
};
|
|
|
|
// Mouse cursor data (used when io.MouseDrawCursor is set)
|
|
struct ImGuiMouseCursorData
|
|
{
|
|
ImGuiMouseCursor Type;
|
|
ImVec2 HotOffset;
|
|
ImVec2 Size;
|
|
ImVec2 TexUvMin[2];
|
|
ImVec2 TexUvMax[2];
|
|
};
|
|
|
|
// Storage for current popup stack
|
|
struct ImGuiPopupRef
|
|
{
|
|
ImGuiID PopupId; // Set on OpenPopup()
|
|
ImGuiWindow* Window; // Resolved on BeginPopup() - may stay unresolved if user never calls OpenPopup()
|
|
ImGuiWindow* ParentWindow; // Set on OpenPopup()
|
|
ImGuiID ParentMenuSet; // Set on OpenPopup()
|
|
ImVec2 PopupPosOnOpen; // Preferred popup position (typically == MousePosOnOpen when using mouse)
|
|
ImVec2 MousePosOnOpen; // Copy of mouse position at the time of opening popup
|
|
|
|
ImGuiPopupRef(ImGuiID id, ImGuiWindow* parent_window, ImGuiID parent_menu_set, const ImVec2& popup_pos, const ImVec2& mouse_pos) { PopupId = id; Window = NULL; ParentWindow = parent_window; ParentMenuSet = parent_menu_set; PopupPosOnOpen = popup_pos; MousePosOnOpen = mouse_pos; }
|
|
};
|
|
|
|
// Main state for ImGui
|
|
struct ImGuiContext
|
|
{
|
|
bool Initialized;
|
|
ImGuiIO IO;
|
|
ImGuiStyle Style;
|
|
ImFont* Font; // (Shortcut) == FontStack.empty() ? IO.Font : FontStack.back()
|
|
float FontSize; // (Shortcut) == FontBaseSize * g.CurrentWindow->FontWindowScale == window->FontSize(). Text height for current window.
|
|
float FontBaseSize; // (Shortcut) == IO.FontGlobalScale * Font->Scale * Font->FontSize. Base text height.
|
|
ImVec2 FontTexUvWhitePixel; // (Shortcut) == Font->TexUvWhitePixel
|
|
|
|
float Time;
|
|
int FrameCount;
|
|
int FrameCountEnded;
|
|
int FrameCountRendered;
|
|
ImVector<ImGuiWindow*> Windows;
|
|
ImVector<ImGuiWindow*> WindowsSortBuffer;
|
|
ImVector<ImGuiWindow*> CurrentWindowStack;
|
|
ImGuiWindow* CurrentWindow; // Being drawn into
|
|
ImGuiWindow* HoveredWindow; // Will catch mouse inputs
|
|
ImGuiWindow* HoveredRootWindow; // Will catch mouse inputs (for focus/move only)
|
|
ImGuiID HoveredId; // Hovered widget
|
|
bool HoveredIdAllowOverlap;
|
|
ImGuiID HoveredIdPreviousFrame;
|
|
ImGuiID ActiveId; // Active widget
|
|
ImGuiID ActiveIdPreviousFrame;
|
|
bool ActiveIdIsAlive; // Active widget has been seen this frame
|
|
bool ActiveIdIsJustActivated; // Set at the time of activation for one frame
|
|
bool ActiveIdAllowOverlap; // Active widget allows another widget to steal active id (generally for overlapping widgets, but not always)
|
|
int ActiveIdAllowNavDirFlags; // Active widget allows using directional navigation (e.g. can activate a button and move away from it)
|
|
ImVec2 ActiveIdClickOffset; // Clicked offset from upper-left corner, if applicable (currently only set by ButtonBehavior)
|
|
ImGuiWindow* ActiveIdWindow;
|
|
ImGuiInputSource ActiveIdSource; // Activating with mouse or nav (gamepad/keyboard)
|
|
ImGuiWindow* MovedWindow; // Track the child window we clicked on to move a window (only apply to moving with mouse)
|
|
ImGuiID MovedWindowMoveId; // == MovedWindow->RootWindow->MoveId
|
|
ImVector<ImGuiIniData> Settings; // .ini Settings
|
|
float SettingsDirtyTimer; // Save .ini Settings on disk when time reaches zero
|
|
ImVector<ImGuiColMod> ColorModifiers; // Stack for PushStyleColor()/PopStyleColor()
|
|
ImVector<ImGuiStyleMod> StyleModifiers; // Stack for PushStyleVar()/PopStyleVar()
|
|
ImVector<ImFont*> FontStack; // Stack for PushFont()/PopFont()
|
|
ImVector<ImGuiPopupRef> OpenPopupStack; // Which popups are open (persistent)
|
|
ImVector<ImGuiPopupRef> CurrentPopupStack; // Which level of BeginPopup() we are in (reset every frame)
|
|
|
|
// Navigation data (for gamepad/keyboard)
|
|
ImGuiWindow* NavWindow; // Nav/focused window for navigation
|
|
ImGuiID NavId; // Nav/focused item for navigation
|
|
ImGuiID NavActivateId, NavInputId; // ~~ IsKeyPressedMap(ImGuiKey_NavActive) ? NavId : 0, etc. (to make widget code terser)
|
|
ImGuiID NavTabbedId; //
|
|
ImRect NavRefRectRel, NavScoringRectScreen;// Reference rectangle, in window space. Modified rectangle for directional navigation scoring, in screen space.
|
|
ImGuiWindow* NavWindowingTarget;
|
|
float NavWindowingDisplayAlpha;
|
|
bool NavWindowingToggleLayer;
|
|
int NavLayer; // Layer we are navigating on. For now the system is hard-coded for 0=main contents and 1=menu/title bar, may expose layers later.
|
|
int NavIdTabCounter; // == NavWindow->DC.FocusIdxTabCounter at time of NavId processing
|
|
bool NavIdIsAlive; // Nav widget has been seen this frame ~~ NavRefRectRel is valid
|
|
bool NavMousePosDirty;
|
|
bool NavDisableHighlight; // When user starts using mouse, we hide gamepad/keyboard highlight (nb: but they are still available, which is why NavDisableHighlight isn't always != NavDisableMouseHover)
|
|
bool NavDisableMouseHover; // When user starts using gamepad/keyboard, we hide mouse hovering highlight until mouse is touched again.
|
|
bool NavInitDefaultRequest; // Init request for appearing window to select first item
|
|
ImGuiID NavInitDefaultResultId;
|
|
ImRect NavInitDefaultResultRectRel;
|
|
bool NavInitDefaultResultExplicit; // Whether the result was explicitly requested with SetItemDefaultFocus()
|
|
bool NavMoveRequest; // Move request for this frame
|
|
bool NavMoveFromClampedRefRect; // Set by manual scrolling, if we scroll to a point where NavId isn't visible we reset navigation from visible items
|
|
ImGuiDir NavMoveDir; // West/East/North/South
|
|
ImGuiID NavMoveResultId; // Best move request candidate
|
|
float NavMoveResultDistBox; // Best move request candidate box distance to current NavId
|
|
float NavMoveResultDistCenter; // Best move request candidate center distance to current NavId
|
|
float NavMoveResultDistAxial;
|
|
ImRect NavMoveResultRectRel; // Best move request candidate bounding box in window relative space
|
|
|
|
// Storage for SetNexWindow** and SetNextTreeNode*** functions
|
|
ImVec2 SetNextWindowPosVal;
|
|
ImVec2 SetNextWindowSizeVal;
|
|
ImVec2 SetNextWindowContentSizeVal;
|
|
bool SetNextWindowCollapsedVal;
|
|
ImGuiCond SetNextWindowPosCond;
|
|
ImGuiCond SetNextWindowSizeCond;
|
|
ImGuiCond SetNextWindowContentSizeCond;
|
|
ImGuiCond SetNextWindowCollapsedCond;
|
|
ImRect SetNextWindowSizeConstraintRect; // Valid if 'SetNextWindowSizeConstraint' is true
|
|
ImGuiSizeConstraintCallback SetNextWindowSizeConstraintCallback;
|
|
void* SetNextWindowSizeConstraintCallbackUserData;
|
|
bool SetNextWindowSizeConstraint;
|
|
bool SetNextWindowFocus;
|
|
bool SetNextTreeNodeOpenVal;
|
|
ImGuiCond SetNextTreeNodeOpenCond;
|
|
|
|
// Render
|
|
ImDrawData RenderDrawData; // Main ImDrawData instance to pass render information to the user
|
|
ImVector<ImDrawList*> RenderDrawLists[3];
|
|
float ModalWindowDarkeningRatio;
|
|
ImDrawList OverlayDrawList; // Optional software render of mouse cursors, if io.MouseDrawCursor is set + a few debug overlays
|
|
ImGuiMouseCursor MouseCursor;
|
|
ImGuiMouseCursorData MouseCursorData[ImGuiMouseCursor_Count_];
|
|
|
|
// Widget state
|
|
ImGuiTextEditState InputTextState;
|
|
ImFont InputTextPasswordFont;
|
|
ImGuiID ScalarAsInputTextId; // Temporary text input when CTRL+clicking on a slider, etc.
|
|
ImGuiColorEditFlags ColorEditOptions; // Store user options for color edit widgets
|
|
ImVec4 ColorPickerRef;
|
|
float DragCurrentValue; // Currently dragged value, always float, not rounded by end-user precision settings
|
|
ImVec2 DragLastMouseDelta;
|
|
float DragSpeedDefaultRatio; // If speed == 0.0f, uses (max-min) * DragSpeedDefaultRatio
|
|
float DragSpeedScaleSlow;
|
|
float DragSpeedScaleFast;
|
|
ImVec2 ScrollbarClickDeltaToGrabCenter; // Distance between mouse and center of grab box, normalized in parent space. Use storage?
|
|
int TooltipOverrideCount;
|
|
ImVector<char> PrivateClipboard; // If no custom clipboard handler is defined
|
|
ImVec2 OsImePosRequest, OsImePosSet; // Cursor position request & last passed to the OS Input Method Editor
|
|
|
|
// Logging
|
|
bool LogEnabled;
|
|
FILE* LogFile; // If != NULL log to stdout/ file
|
|
ImGuiTextBuffer* LogClipboard; // Else log to clipboard. This is pointer so our GImGui static constructor doesn't call heap allocators.
|
|
int LogStartDepth;
|
|
int LogAutoExpandMaxDepth;
|
|
|
|
// Misc
|
|
float FramerateSecPerFrame[120]; // calculate estimate of framerate for user
|
|
int FramerateSecPerFrameIdx;
|
|
float FramerateSecPerFrameAccum;
|
|
int CaptureMouseNextFrame; // explicit capture via CaptureInputs() sets those flags
|
|
int CaptureKeyboardNextFrame;
|
|
char TempBuffer[1024*3+1]; // temporary text buffer
|
|
|
|
ImGuiContext()
|
|
{
|
|
Initialized = false;
|
|
Font = NULL;
|
|
FontSize = FontBaseSize = 0.0f;
|
|
FontTexUvWhitePixel = ImVec2(0.0f, 0.0f);
|
|
|
|
Time = 0.0f;
|
|
FrameCount = 0;
|
|
FrameCountEnded = FrameCountRendered = -1;
|
|
CurrentWindow = NULL;
|
|
HoveredWindow = NULL;
|
|
HoveredRootWindow = NULL;
|
|
HoveredId = 0;
|
|
HoveredIdAllowOverlap = false;
|
|
HoveredIdPreviousFrame = 0;
|
|
ActiveId = 0;
|
|
ActiveIdPreviousFrame = 0;
|
|
ActiveIdIsAlive = false;
|
|
ActiveIdIsJustActivated = false;
|
|
ActiveIdAllowOverlap = false;
|
|
ActiveIdClickOffset = ImVec2(-1,-1);
|
|
ActiveIdWindow = NULL;
|
|
ActiveIdSource = ImGuiInputSource_None;
|
|
MovedWindow = NULL;
|
|
MovedWindowMoveId = 0;
|
|
SettingsDirtyTimer = 0.0f;
|
|
|
|
NavWindow = NULL;
|
|
NavId = NavActivateId = NavInputId = NavTabbedId = 0;
|
|
NavRefRectRel = NavScoringRectScreen = ImRect();
|
|
NavWindowingTarget = NULL;
|
|
NavWindowingDisplayAlpha = 0.0f;
|
|
NavWindowingToggleLayer = false;
|
|
NavIdTabCounter = INT_MAX;
|
|
NavIdIsAlive = false;
|
|
NavMousePosDirty = false;
|
|
NavDisableHighlight = true;
|
|
NavDisableMouseHover = false;
|
|
NavInitDefaultRequest = false;
|
|
NavInitDefaultResultId = 0;
|
|
NavInitDefaultResultExplicit = false;
|
|
NavMoveRequest = false;
|
|
NavMoveDir = ImGuiDir_None;
|
|
NavMoveResultId = 0;
|
|
NavMoveResultDistBox = NavMoveResultDistCenter = NavMoveResultDistAxial = 0.0f;
|
|
|
|
SetNextWindowPosVal = ImVec2(0.0f, 0.0f);
|
|
SetNextWindowSizeVal = ImVec2(0.0f, 0.0f);
|
|
SetNextWindowCollapsedVal = false;
|
|
SetNextWindowPosCond = 0;
|
|
SetNextWindowSizeCond = 0;
|
|
SetNextWindowContentSizeCond = 0;
|
|
SetNextWindowCollapsedCond = 0;
|
|
SetNextWindowSizeConstraintRect = ImRect();
|
|
SetNextWindowSizeConstraintCallback = NULL;
|
|
SetNextWindowSizeConstraintCallbackUserData = NULL;
|
|
SetNextWindowSizeConstraint = false;
|
|
SetNextWindowFocus = false;
|
|
SetNextTreeNodeOpenVal = false;
|
|
SetNextTreeNodeOpenCond = 0;
|
|
|
|
ScalarAsInputTextId = 0;
|
|
ColorEditOptions = ImGuiColorEditFlags__OptionsDefault;
|
|
DragCurrentValue = 0.0f;
|
|
DragLastMouseDelta = ImVec2(0.0f, 0.0f);
|
|
DragSpeedDefaultRatio = 1.0f / 100.0f;
|
|
DragSpeedScaleSlow = 1.0f / 100.0f;
|
|
DragSpeedScaleFast = 10.0f;
|
|
ScrollbarClickDeltaToGrabCenter = ImVec2(0.0f, 0.0f);
|
|
TooltipOverrideCount = 0;
|
|
OsImePosRequest = OsImePosSet = ImVec2(-1.0f, -1.0f);
|
|
|
|
ModalWindowDarkeningRatio = 0.0f;
|
|
OverlayDrawList._OwnerName = "##Overlay"; // Give it a name for debugging
|
|
MouseCursor = ImGuiMouseCursor_Arrow;
|
|
memset(MouseCursorData, 0, sizeof(MouseCursorData));
|
|
|
|
LogEnabled = false;
|
|
LogFile = NULL;
|
|
LogClipboard = NULL;
|
|
LogStartDepth = 0;
|
|
LogAutoExpandMaxDepth = 2;
|
|
|
|
memset(FramerateSecPerFrame, 0, sizeof(FramerateSecPerFrame));
|
|
FramerateSecPerFrameIdx = 0;
|
|
FramerateSecPerFrameAccum = 0.0f;
|
|
CaptureMouseNextFrame = CaptureKeyboardNextFrame = -1;
|
|
memset(TempBuffer, 0, sizeof(TempBuffer));
|
|
}
|
|
};
|
|
|
|
// Transient per-window flags, reset at the beginning of the frame. For child window, inherited from parent on first Begin().
|
|
enum ImGuiItemFlags_
|
|
{
|
|
ImGuiItemFlags_AllowKeyboardFocus = 1 << 0, // [true]
|
|
ImGuiItemFlags_AllowNavDefaultFocus = 1 << 1, // [true]
|
|
ImGuiItemFlags_ButtonRepeat = 1 << 2, // [false] // Button() can be held will a repeat behavior
|
|
ImGuiItemFlags_SelectableDontClosePopup = 1 << 3, // [false] // MenuItem/Selectable() automatically closes owner Popup window
|
|
ImGuiItemFlags_Default_ = ImGuiItemFlags_AllowKeyboardFocus|ImGuiItemFlags_AllowNavDefaultFocus
|
|
};
|
|
|
|
// Transient per-window data, reset at the beginning of the frame
|
|
// FIXME: That's theory, in practice the delimitation between ImGuiWindow and ImGuiDrawContext is quite tenuous and could be reconsidered.
|
|
struct IMGUI_API ImGuiDrawContext
|
|
{
|
|
ImVec2 CursorPos;
|
|
ImVec2 CursorPosPrevLine;
|
|
ImVec2 CursorStartPos;
|
|
ImVec2 CursorMaxPos; // Implicitly calculate the size of our contents, always extending. Saved into window->SizeContents at the end of the frame
|
|
float CurrentLineHeight;
|
|
float CurrentLineTextBaseOffset;
|
|
float PrevLineHeight;
|
|
float PrevLineTextBaseOffset;
|
|
float LogLinePosY;
|
|
int TreeDepth;
|
|
ImGuiID LastItemId;
|
|
ImRect LastItemRect;
|
|
bool LastItemHoveredAndUsable; // Item rectangle is hovered, and its window is currently interactable with (not blocked by a popup preventing access to the window)
|
|
bool LastItemHoveredRect; // Item rectangle is hovered, but its window may or not be currently interactable with (might be blocked by a popup preventing access to the window)
|
|
bool NavHasScroll; // Set when scrolling can be used (ScrollMax > 0.0f)
|
|
int NavLayerCurrent; // Current layer, 0..31 (we currently only use 0..1)
|
|
int NavLayerActiveFlags, NavLayerActiveFlagsNext; // Which layer have been written to.
|
|
bool MenuBarAppending;
|
|
float MenuBarOffsetX;
|
|
ImVector<ImGuiWindow*> ChildWindows;
|
|
ImGuiStorage* StateStorage;
|
|
ImGuiLayoutType LayoutType;
|
|
|
|
// We store the current settings outside of the vectors to increase memory locality (reduce cache misses). The vectors are rarely modified. Also it allows us to not heap allocate for short-lived windows which are not using those settings.
|
|
ImGuiItemFlags ItemFlags; // == ItemFlagsStack.back() [empty == ImGuiItemFlags_Default]
|
|
float ItemWidth; // == ItemWidthStack.back(). 0.0: default, >0.0: width in pixels, <0.0: align xx pixels to the right of window
|
|
float TextWrapPos; // == TextWrapPosStack.back() [empty == -1.0f]
|
|
ImVector<ImGuiItemFlags>ItemFlagsStack;
|
|
ImVector<float> ItemWidthStack;
|
|
ImVector<float> TextWrapPosStack;
|
|
ImVector<ImGuiGroupData>GroupStack;
|
|
int StackSizesBackup[6]; // Store size of various stacks for asserting
|
|
|
|
float IndentX; // Indentation / start position from left of window (increased by TreePush/TreePop, etc.)
|
|
float GroupOffsetX;
|
|
float ColumnsOffsetX; // Offset to the current column (if ColumnsCurrent > 0). FIXME: This and the above should be a stack to allow use cases like Tree->Column->Tree. Need revamp columns API.
|
|
int ColumnsCurrent;
|
|
int ColumnsCount;
|
|
float ColumnsMinX;
|
|
float ColumnsMaxX;
|
|
float ColumnsStartPosY;
|
|
float ColumnsStartMaxPosX; // Backup of CursorMaxPos
|
|
float ColumnsCellMinY;
|
|
float ColumnsCellMaxY;
|
|
ImGuiColumnsFlags ColumnsFlags;
|
|
ImGuiID ColumnsSetId;
|
|
ImVector<ImGuiColumnData> ColumnsData;
|
|
|
|
ImGuiDrawContext()
|
|
{
|
|
CursorPos = CursorPosPrevLine = CursorStartPos = CursorMaxPos = ImVec2(0.0f, 0.0f);
|
|
CurrentLineHeight = PrevLineHeight = 0.0f;
|
|
CurrentLineTextBaseOffset = PrevLineTextBaseOffset = 0.0f;
|
|
LogLinePosY = -1.0f;
|
|
TreeDepth = 0;
|
|
LastItemId = 0;
|
|
LastItemRect = ImRect(0.0f,0.0f,0.0f,0.0f);
|
|
LastItemHoveredAndUsable = LastItemHoveredRect = false;
|
|
NavHasScroll = false;
|
|
NavLayerActiveFlags = NavLayerActiveFlagsNext = 0x00;
|
|
NavLayerCurrent = 0;
|
|
MenuBarAppending = false;
|
|
MenuBarOffsetX = 0.0f;
|
|
StateStorage = NULL;
|
|
LayoutType = ImGuiLayoutType_Vertical;
|
|
ItemWidth = 0.0f;
|
|
ItemFlags = ImGuiItemFlags_Default_;
|
|
TextWrapPos = -1.0f;
|
|
memset(StackSizesBackup, 0, sizeof(StackSizesBackup));
|
|
|
|
IndentX = 0.0f;
|
|
GroupOffsetX = 0.0f;
|
|
ColumnsOffsetX = 0.0f;
|
|
ColumnsCurrent = 0;
|
|
ColumnsCount = 1;
|
|
ColumnsMinX = ColumnsMaxX = 0.0f;
|
|
ColumnsStartPosY = 0.0f;
|
|
ColumnsStartMaxPosX = 0.0f;
|
|
ColumnsCellMinY = ColumnsCellMaxY = 0.0f;
|
|
ColumnsFlags = 0;
|
|
ColumnsSetId = 0;
|
|
}
|
|
};
|
|
|
|
// Windows data
|
|
struct IMGUI_API ImGuiWindow
|
|
{
|
|
char* Name;
|
|
ImGuiID ID; // == ImHash(Name)
|
|
ImGuiWindowFlags Flags; // See enum ImGuiWindowFlags_
|
|
int OrderWithinParent; // Order within immediate parent window, if we are a child window. Otherwise 0.
|
|
ImVec2 PosFloat;
|
|
ImVec2 Pos; // Position rounded-up to nearest pixel
|
|
ImVec2 Size; // Current size (==SizeFull or collapsed title bar size)
|
|
ImVec2 SizeFull; // Size when non collapsed
|
|
ImVec2 SizeContents; // Size of contents (== extents reach of the drawing cursor) from previous frame
|
|
ImVec2 SizeContentsExplicit; // Size of contents explicitly set by the user via SetNextWindowContentSize()
|
|
ImRect ContentsRegionRect; // Maximum visible content position in window coordinates. ~~ (SizeContentsExplicit ? SizeContentsExplicit : Size - ScrollbarSizes) - CursorStartPos, per axis
|
|
ImVec2 WindowPadding; // Window padding at the time of begin. We need to lock it, in particular manipulation of the ShowBorder would have an effect
|
|
ImGuiID MoveId; // == window->GetID("#MOVE")
|
|
ImGuiID ChildId; // Id of corresponding item in parent window (for child windows)
|
|
ImVec2 Scroll;
|
|
ImVec2 ScrollTarget; // target scroll position. stored as cursor position with scrolling canceled out, so the highest point is always 0.0f. (FLT_MAX for no change)
|
|
ImVec2 ScrollTargetCenterRatio; // 0.0f = scroll so that target position is at top, 0.5f = scroll so that target position is centered
|
|
bool ScrollbarX, ScrollbarY;
|
|
ImVec2 ScrollbarSizes;
|
|
float BorderSize;
|
|
bool Active; // Set to true on Begin()
|
|
bool WasActive;
|
|
bool Accessed; // Set to true when any widget access the current window
|
|
bool Collapsed; // Set when collapsing window to become only title-bar
|
|
bool CollapseToggleWanted;
|
|
bool SkipItems; // == Visible && !Collapsed
|
|
int BeginCount; // Number of Begin() during the current frame (generally 0 or 1, 1+ if appending via multiple Begin/End pairs)
|
|
ImGuiID PopupId; // ID in the popup stack when this window is used as a popup/menu (because we use generic Name/ID for recycling)
|
|
ImGuiID NavLastId; // Last known NavId for this window, for nav layer 0 only.
|
|
int AutoFitFramesX, AutoFitFramesY;
|
|
bool AutoFitOnlyGrows;
|
|
int AutoFitChildAxises;
|
|
int AutoPosLastDirection;
|
|
int HiddenFrames;
|
|
ImGuiCond SetWindowPosAllowFlags; // store condition flags for next SetWindowPos() call.
|
|
ImGuiCond SetWindowSizeAllowFlags; // store condition flags for next SetWindowSize() call.
|
|
ImGuiCond SetWindowCollapsedAllowFlags; // store condition flags for next SetWindowCollapsed() call.
|
|
bool SetWindowPosCenterWanted;
|
|
|
|
ImGuiDrawContext DC; // Temporary per-window data, reset at the beginning of the frame
|
|
ImVector<ImGuiID> IDStack; // ID stack. ID are hashes seeded with the value at the top of the stack
|
|
ImRect ClipRect; // = DrawList->clip_rect_stack.back(). Scissoring / clipping rectangle. x1, y1, x2, y2.
|
|
ImRect WindowRectClipped; // = WindowRect just after setup in Begin(). == window->Rect() for root window.
|
|
ImRect InnerRect;
|
|
int LastFrameActive;
|
|
float ItemWidthDefault;
|
|
ImGuiSimpleColumns MenuColumns; // Simplified columns storage for menu items
|
|
ImGuiStorage StateStorage;
|
|
float FontWindowScale; // Scale multiplier per-window
|
|
ImDrawList* DrawList;
|
|
ImGuiWindow* ParentWindow; // Immediate parent in the window stack *regardless* of whether this window is a child window or not)
|
|
ImGuiWindow* RootWindow; // Generally point to ourself. If we are a child window, this is pointing to the first non-child parent window.
|
|
ImGuiWindow* RootNonPopupWindow; // Generally point to ourself. Used to display TitleBgActive color and for selecting which window to use for NavWindowing
|
|
ImGuiWindow* RootNavWindow; // Generally point to ourself. If we are a child window with the ImGuiWindowFlags_NavFlattenedChild flag, point to parent. Used to display TitleBgActive color and for selecting which window to use for NavWindowing.
|
|
|
|
// Navigation / Focus
|
|
// FIXME-NAVIGATION: Merge all this with the new Nav system, at least the request variables should be moved to ImGuiContext
|
|
int FocusIdxAllCounter; // Start at -1 and increase as assigned via FocusItemRegister()
|
|
int FocusIdxTabCounter; // (same, but only count widgets which you can Tab through)
|
|
int FocusIdxAllRequestCurrent; // Item being requested for focus
|
|
int FocusIdxTabRequestCurrent; // Tab-able item being requested for focus
|
|
int FocusIdxAllRequestNext; // Item being requested for focus, for next update (relies on layout to be stable between the frame pressing TAB and the next frame)
|
|
int FocusIdxTabRequestNext; // "
|
|
|
|
public:
|
|
ImGuiWindow(const char* name);
|
|
~ImGuiWindow();
|
|
|
|
ImGuiID GetID(const char* str, const char* str_end = NULL);
|
|
ImGuiID GetID(const void* ptr);
|
|
ImGuiID GetIDNoKeepAlive(const char* str, const char* str_end = NULL);
|
|
|
|
ImRect Rect() const { return ImRect(Pos.x, Pos.y, Pos.x+Size.x, Pos.y+Size.y); }
|
|
float CalcFontSize() const { return GImGui->FontBaseSize * FontWindowScale; }
|
|
float TitleBarHeight() const { return (Flags & ImGuiWindowFlags_NoTitleBar) ? 0.0f : CalcFontSize() + GImGui->Style.FramePadding.y * 2.0f; }
|
|
ImRect TitleBarRect() const { return ImRect(Pos, ImVec2(Pos.x + SizeFull.x, Pos.y + TitleBarHeight())); }
|
|
float MenuBarHeight() const { return (Flags & ImGuiWindowFlags_MenuBar) ? CalcFontSize() + GImGui->Style.FramePadding.y * 2.0f : 0.0f; }
|
|
ImRect MenuBarRect() const { float y1 = Pos.y + TitleBarHeight(); return ImRect(Pos.x, y1, Pos.x + SizeFull.x, y1 + MenuBarHeight()); }
|
|
};
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Internal API
|
|
// No guarantee of forward compatibility here.
|
|
//-----------------------------------------------------------------------------
|
|
|
|
namespace ImGui
|
|
{
|
|
// We should always have a CurrentWindow in the stack (there is an implicit "Debug" window)
|
|
// If this ever crash because g.CurrentWindow is NULL it means that either
|
|
// - ImGui::NewFrame() has never been called, which is illegal.
|
|
// - You are calling ImGui functions after ImGui::Render() and before the next ImGui::NewFrame(), which is also illegal.
|
|
inline ImGuiWindow* GetCurrentWindowRead() { ImGuiContext& g = *GImGui; return g.CurrentWindow; }
|
|
inline ImGuiWindow* GetCurrentWindow() { ImGuiContext& g = *GImGui; g.CurrentWindow->Accessed = true; return g.CurrentWindow; }
|
|
IMGUI_API ImGuiWindow* GetParentWindow();
|
|
IMGUI_API ImGuiWindow* FindWindowByName(const char* name);
|
|
IMGUI_API void FocusWindow(ImGuiWindow* window);
|
|
|
|
IMGUI_API void Initialize();
|
|
IMGUI_API void EndFrame(); // Ends the ImGui frame. Automatically called by Render()! you most likely don't need to ever call that yourself directly. If you don't need to render you can call EndFrame() but you'll have wasted CPU already. If you don't need to render, don't create any windows instead!
|
|
|
|
IMGUI_API void SetActiveID(ImGuiID id, ImGuiWindow* window);
|
|
IMGUI_API void SetActiveIDNoNav(ImGuiID id, ImGuiWindow* window);
|
|
IMGUI_API void ClearActiveID();
|
|
IMGUI_API void SetHoveredID(ImGuiID id);
|
|
IMGUI_API void KeepAliveID(ImGuiID id);
|
|
|
|
IMGUI_API void ItemSize(const ImVec2& size, float text_offset_y = 0.0f);
|
|
IMGUI_API void ItemSize(const ImRect& bb, float text_offset_y = 0.0f);
|
|
IMGUI_API bool ItemAdd(const ImRect& bb, const ImGuiID* id, const ImRect* nav_bb = NULL);
|
|
IMGUI_API bool IsClippedEx(const ImRect& bb, const ImGuiID* id, bool clip_even_when_logged);
|
|
IMGUI_API bool IsHovered(const ImRect& bb, ImGuiID id, bool flatten_childs = false);
|
|
IMGUI_API bool FocusableItemRegister(ImGuiWindow* window, ImGuiID id, bool tab_stop = true); // Return true if focus is requested
|
|
IMGUI_API void FocusableItemUnregister(ImGuiWindow* window);
|
|
IMGUI_API ImVec2 CalcItemSize(ImVec2 size, float default_x, float default_y);
|
|
IMGUI_API float CalcWrapWidthForPos(const ImVec2& pos, float wrap_pos_x);
|
|
IMGUI_API void PushItemFlag(ImGuiItemFlags option, bool enabled);
|
|
IMGUI_API void PopItemFlag();
|
|
|
|
IMGUI_API void OpenPopupEx(ImGuiID id, bool reopen_existing);
|
|
IMGUI_API bool IsPopupOpen(ImGuiID id);
|
|
|
|
IMGUI_API int CalcTypematicPressedRepeatAmount(float t, float t_prev, float repeat_delay, float repeat_rate);
|
|
|
|
// New Columns API
|
|
IMGUI_API void BeginColumns(const char* id, int count, ImGuiColumnsFlags flags = 0); // setup number of columns. use an identifier to distinguish multiple column sets. close with EndColumns().
|
|
IMGUI_API void EndColumns(); // close columns
|
|
IMGUI_API void PushColumnClipRect(int column_index = -1);
|
|
|
|
// NB: All position are in absolute pixels coordinates (never using window coordinates internally)
|
|
// AVOID USING OUTSIDE OF IMGUI.CPP! NOT FOR PUBLIC CONSUMPTION. THOSE FUNCTIONS ARE A MESS. THEIR SIGNATURE AND BEHAVIOR WILL CHANGE, THEY NEED TO BE REFACTORED INTO SOMETHING DECENT.
|
|
IMGUI_API void RenderText(ImVec2 pos, const char* text, const char* text_end = NULL, bool hide_text_after_hash = true);
|
|
IMGUI_API void RenderTextWrapped(ImVec2 pos, const char* text, const char* text_end, float wrap_width);
|
|
IMGUI_API void RenderTextClipped(const ImVec2& pos_min, const ImVec2& pos_max, const char* text, const char* text_end, const ImVec2* text_size_if_known, const ImVec2& align = ImVec2(0,0), const ImRect* clip_rect = NULL);
|
|
IMGUI_API void RenderFrame(ImVec2 p_min, ImVec2 p_max, ImU32 fill_col, bool border = true, float rounding = 0.0f);
|
|
IMGUI_API void RenderFrameBorder(ImVec2 p_min, ImVec2 p_max, float rounding = 0.0f);
|
|
IMGUI_API void RenderColorRectWithAlphaCheckerboard(ImVec2 p_min, ImVec2 p_max, ImU32 fill_col, float grid_step, ImVec2 grid_off, float rounding = 0.0f, int rounding_corners_flags = ~0);
|
|
IMGUI_API void RenderCollapseTriangle(ImVec2 pos, bool is_open, float scale = 1.0f);
|
|
IMGUI_API void RenderBullet(ImVec2 pos);
|
|
IMGUI_API void RenderCheckMark(ImVec2 pos, ImU32 col);
|
|
IMGUI_API void RenderNavHighlight(const ImRect& bb, ImGuiID id); // Navigation highlight
|
|
IMGUI_API void RenderRectFilledRangeH(ImDrawList* draw_list, const ImRect& rect, ImU32 col, float x_start_norm, float x_end_norm, float rounding);
|
|
IMGUI_API const char* FindRenderedTextEnd(const char* text, const char* text_end = NULL); // Find the optional ## from which we stop displaying text.
|
|
|
|
IMGUI_API bool ButtonBehavior(const ImRect& bb, ImGuiID id, bool* out_hovered, bool* out_held, ImGuiButtonFlags flags = 0);
|
|
IMGUI_API bool ButtonEx(const char* label, const ImVec2& size_arg = ImVec2(0,0), ImGuiButtonFlags flags = 0);
|
|
IMGUI_API bool CloseButton(ImGuiID id, const ImVec2& pos, float radius);
|
|
|
|
IMGUI_API bool SliderBehavior(const ImRect& frame_bb, ImGuiID id, float* v, float v_min, float v_max, float power, int decimal_precision, ImGuiSliderFlags flags = 0);
|
|
IMGUI_API bool SliderFloatN(const char* label, float* v, int components, float v_min, float v_max, const char* display_format, float power);
|
|
IMGUI_API bool SliderIntN(const char* label, int* v, int components, int v_min, int v_max, const char* display_format);
|
|
|
|
IMGUI_API bool DragBehavior(const ImRect& frame_bb, ImGuiID id, float* v, float v_speed, float v_min, float v_max, int decimal_precision, float power);
|
|
IMGUI_API bool DragFloatN(const char* label, float* v, int components, float v_speed, float v_min, float v_max, const char* display_format, float power);
|
|
IMGUI_API bool DragIntN(const char* label, int* v, int components, float v_speed, int v_min, int v_max, const char* display_format);
|
|
|
|
IMGUI_API bool InputTextEx(const char* label, char* buf, int buf_size, const ImVec2& size_arg, ImGuiInputTextFlags flags, ImGuiTextEditCallback callback = NULL, void* user_data = NULL);
|
|
IMGUI_API bool InputFloatN(const char* label, float* v, int components, int decimal_precision, ImGuiInputTextFlags extra_flags);
|
|
IMGUI_API bool InputIntN(const char* label, int* v, int components, ImGuiInputTextFlags extra_flags);
|
|
IMGUI_API bool InputScalarEx(const char* label, ImGuiDataType data_type, void* data_ptr, void* step_ptr, void* step_fast_ptr, const char* scalar_format, ImGuiInputTextFlags extra_flags);
|
|
IMGUI_API bool InputScalarAsWidgetReplacement(const ImRect& aabb, const char* label, ImGuiDataType data_type, void* data_ptr, ImGuiID id, int decimal_precision);
|
|
|
|
IMGUI_API void ColorTooltip(const char* text, const float col[4], ImGuiColorEditFlags flags);
|
|
|
|
IMGUI_API bool TreeNodeBehavior(ImGuiID id, ImGuiTreeNodeFlags flags, const char* label, const char* label_end = NULL);
|
|
IMGUI_API bool TreeNodeBehaviorIsOpen(ImGuiID id, ImGuiTreeNodeFlags flags = 0); // Consume previous SetNextTreeNodeOpened() data, if any. May return true when logging
|
|
IMGUI_API void TreePushRawID(ImGuiID id);
|
|
|
|
IMGUI_API void PlotEx(ImGuiPlotType plot_type, const char* label, float (*values_getter)(void* data, int idx), void* data, int values_count, int values_offset, const char* overlay_text, float scale_min, float scale_max, ImVec2 graph_size);
|
|
|
|
IMGUI_API int ParseFormatPrecision(const char* fmt, int default_value);
|
|
IMGUI_API float RoundScalar(float value, int decimal_precision);
|
|
|
|
} // namespace ImGui
|
|
|
|
// ImFontAtlas internals
|
|
IMGUI_API bool ImFontAtlasBuildWithStbTruetype(ImFontAtlas* atlas);
|
|
IMGUI_API void ImFontAtlasBuildRegisterDefaultCustomRects(ImFontAtlas* atlas);
|
|
IMGUI_API void ImFontAtlasBuildSetupFont(ImFontAtlas* atlas, ImFont* font, ImFontConfig* font_config, float ascent, float descent);
|
|
IMGUI_API void ImFontAtlasBuildPackCustomRects(ImFontAtlas* atlas, void* spc);
|
|
IMGUI_API void ImFontAtlasBuildRenderDefaultTexData(ImFontAtlas* atlas);
|
|
IMGUI_API void ImFontAtlasBuildMultiplyCalcLookupTable(unsigned char out_table[256], float in_multiply_factor);
|
|
IMGUI_API void ImFontAtlasBuildMultiplyRectAlpha8(const unsigned char table[256], unsigned char* pixels, int x, int y, int w, int h, int stride);
|
|
|
|
#ifdef __clang__
|
|
#pragma clang diagnostic pop
|
|
#endif
|
|
|
|
#ifdef _MSC_VER
|
|
#pragma warning (pop)
|
|
#endif
|