2017-12-28 22:17:35 +08:00
// dear imgui, v1.54 WIP
2015-12-25 02:56:47 +08:00
// (internals)
2015-07-22 07:00:28 +08:00
2015-12-25 02:56:47 +08:00
// You may use this file to debug, understand or extend ImGui features but we don't provide any guarantee of forward compatibility!
2017-11-07 20:11:45 +08:00
// Set:
2015-07-31 12:49:10 +08:00
// #define IMGUI_DEFINE_MATH_OPERATORS
2017-11-07 20:11:45 +08:00
// To implement maths operators for ImVec2 (disabled by default to not collide with using IM_VEC2_CLASS_EXTRA along with your own math types+operators)
2015-07-22 07:00:28 +08:00
# pragma once
2015-08-11 00:26:39 +08:00
# ifndef IMGUI_VERSION
# error Must include imgui.h before imgui_internal.h
# endif
2015-07-22 07:00:28 +08:00
# include <stdio.h> // FILE*
2016-05-31 06:00:44 +08:00
# include <math.h> // sqrtf, fabsf, fmodf, powf, floorf, ceilf, cosf, sinf
2016-07-20 06:02:59 +08:00
# include <limits.h> // INT_MIN, INT_MAX
2015-07-22 07:00:28 +08:00
2015-09-22 06:53:51 +08:00
# 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
2016-05-30 01:14:19 +08:00
# 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
2015-07-22 07:00:28 +08:00
//-----------------------------------------------------------------------------
// Forward Declarations
//-----------------------------------------------------------------------------
struct ImRect ;
struct ImGuiColMod ;
struct ImGuiStyleMod ;
struct ImGuiGroupData ;
2018-01-03 21:35:11 +08:00
struct ImGuiMenuColumns ;
2015-07-22 07:00:28 +08:00
struct ImGuiDrawContext ;
struct ImGuiTextEditState ;
struct ImGuiPopupRef ;
struct ImGuiWindow ;
2017-11-29 02:20:50 +08:00
struct ImGuiWindowSettings ;
2015-07-22 07:00:28 +08:00
2017-10-27 21:31:44 +08:00
typedef int ImGuiLayoutType ; // enum: horizontal or vertical // enum ImGuiLayoutType_
typedef int ImGuiButtonFlags ; // flags: for ButtonEx(), ButtonBehavior() // enum ImGuiButtonFlags_
typedef int ImGuiItemFlags ; // flags: for PushItemFlag() // enum ImGuiItemFlags_
2017-10-27 22:42:06 +08:00
typedef int ImGuiNavHighlightFlags ; // flags: for RenderNavHighlight() // enum ImGuiNavHighlightFlags_
2018-01-24 23:37:20 +08:00
typedef int ImGuiNavDirSourceFlags ; // flags: for GetNavInputAmount2d() // enum ImGuiNavDirSourceFlags_
2017-10-27 21:31:44 +08:00
typedef int ImGuiSeparatorFlags ; // flags: for Separator() - internal // enum ImGuiSeparatorFlags_
typedef int ImGuiSliderFlags ; // flags: for SliderBehavior() // enum ImGuiSliderFlags_
2015-07-22 07:00:28 +08:00
//-------------------------------------------------------------------------
2015-07-31 12:49:10 +08:00
// STB libraries
2015-07-22 07:00:28 +08:00
//-------------------------------------------------------------------------
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
//-----------------------------------------------------------------------------
2016-11-13 00:08:31 +08:00
# ifndef GImGui
extern IMGUI_API ImGuiContext * GImGui ; // Current implicit ImGui context pointer
# endif
2015-07-22 07:00:28 +08:00
//-----------------------------------------------------------------------------
// Helpers
//-----------------------------------------------------------------------------
2017-12-30 00:18:31 +08:00
# define IM_PI 3.14159265358979323846f
2015-07-22 07:00:28 +08:00
// Helpers: UTF-8 <> wchar
2015-09-10 17:22:17 +08:00
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
2015-07-22 07:00:28 +08:00
// Helpers: Misc
2015-09-10 17:22:17 +08:00
IMGUI_API ImU32 ImHash ( const void * data , int data_size , ImU32 seed = 0 ) ; // Pass data_size==0 for zero-terminated strings
2017-01-14 20:47:16 +08:00
IMGUI_API void * ImFileLoadToMemory ( const char * filename , const char * file_open_mode , int * out_file_size = NULL , int padding_bytes = 0 ) ;
2017-07-31 21:11:41 +08:00
IMGUI_API FILE * ImFileOpen ( const char * filename , const char * file_open_mode ) ;
2015-09-10 17:22:17 +08:00
static inline bool ImCharIsSpace ( int c ) { return c = = ' ' | | c = = ' \t ' | | c = = 0x3000 ; }
2016-02-22 06:23:30 +08:00
static inline bool ImIsPowerOfTwo ( int v ) { return v ! = 0 & & ( v & ( v - 1 ) ) = = 0 ; }
2015-09-10 17:22:17 +08:00
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 ; }
2015-07-22 07:00:28 +08:00
2017-07-31 21:11:41 +08:00
// 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 ) ;
2015-07-22 07:00:28 +08:00
// Helpers: String
2015-09-10 17:22:17 +08:00
IMGUI_API int ImStricmp ( const char * str1 , const char * str2 ) ;
2017-12-21 20:43:09 +08:00
IMGUI_API int ImStrnicmp ( const char * str1 , const char * str2 , size_t count ) ;
IMGUI_API void ImStrncpy ( char * dst , const char * src , size_t count ) ;
2015-09-10 17:22:17 +08:00
IMGUI_API char * ImStrdup ( const char * str ) ;
2017-11-28 06:55:42 +08:00
IMGUI_API char * ImStrchrRange ( const char * str_begin , const char * str_end , char c ) ;
2015-09-10 17:22:17 +08:00
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 ) ;
2017-12-21 20:43:09 +08:00
IMGUI_API int ImFormatString ( char * buf , size_t buf_size , const char * fmt , . . . ) IM_FMTARGS ( 3 ) ;
IMGUI_API int ImFormatStringV ( char * buf , size_t buf_size , const char * fmt , va_list args ) IM_FMTLIST ( 3 ) ;
2015-07-22 07:00:28 +08:00
// 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 ; }
2017-10-27 19:19:31 +08:00
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 ) ; }
2015-11-11 07:06:37 +08:00
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 ) ; }
2017-10-27 19:19:31 +08:00
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 ) ; }
2015-07-22 07:00:28 +08:00
# 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 ; }
2018-01-09 06:59:12 +08:00
static inline ImVec2 ImMin ( const ImVec2 & lhs , const ImVec2 & rhs ) { return ImVec2 ( lhs . x < rhs . x ? lhs . x : rhs . x , lhs . y < rhs . y ? lhs . y : rhs . y ) ; }
static inline ImVec2 ImMax ( const ImVec2 & lhs , const ImVec2 & rhs ) { return ImVec2 ( lhs . x > = rhs . x ? lhs . x : rhs . x , lhs . y > = rhs . y ? lhs . y : rhs . y ) ; }
2015-07-22 07:00:28 +08:00
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 ; }
2017-10-18 05:18:20 +08:00
static inline void ImSwap ( int & a , int & b ) { int tmp = a ; a = b ; b = tmp ; }
2017-08-28 19:27:12 +08:00
static inline void ImSwap ( float & a , float & b ) { float tmp = a ; a = b ; b = tmp ; }
2017-07-26 22:20:43 +08:00
static inline int ImLerp ( int a , int b , float t ) { return ( int ) ( a + ( b - a ) * t ) ; }
2015-07-22 07:00:28 +08:00
static inline float ImLerp ( float a , float b , float t ) { return a + ( b - a ) * t ; }
2017-07-31 18:56:51 +08:00
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 ) ; }
2015-07-22 07:00:28 +08:00
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 ) ; }
2017-10-20 05:29:27 +08:00
static inline ImVec4 ImLerp ( const ImVec4 & a , const ImVec4 & b , float t ) { return ImVec4 ( a . x + ( b . x - a . x ) * t , a . y + ( b . y - a . y ) * t , a . z + ( b . z - a . z ) * t , a . w + ( b . w - a . w ) * t ) ; }
2015-07-22 07:00:28 +08:00
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 ; }
2016-05-01 00:55:23 +08:00
static inline float ImFloor ( float f ) { return ( float ) ( int ) f ; }
2017-07-31 18:56:51 +08:00
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 ) ; }
2017-10-20 01:29:59 +08:00
static inline float ImLinearSweep ( float current , float target , float speed ) { if ( current < target ) return ImMin ( current + speed , target ) ; if ( current > target ) return ImMax ( current - speed , target ) ; return current ; }
2017-11-20 04:00:38 +08:00
static inline ImVec2 ImMul ( const ImVec2 & lhs , const ImVec2 & rhs ) { return ImVec2 ( lhs . x * rhs . x , lhs . y * rhs . y ) ; }
2015-07-22 07:00:28 +08:00
2016-01-26 05:26:53 +08:00
// 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.
2017-12-23 23:24:33 +08:00
struct ImNewPlacementDummy { } ;
inline void * operator new ( size_t , ImNewPlacementDummy , void * ptr ) { return ptr ; }
inline void operator delete ( void * , ImNewPlacementDummy , void * ) { } // This is only required so we can use the symetrical new()
2017-12-24 06:10:26 +08:00
# define IM_PLACEMENT_NEW(_PTR) new(ImNewPlacementDummy(), _PTR)
# define IM_NEW(_TYPE) new(ImNewPlacementDummy(), ImGui::MemAlloc(sizeof(_TYPE))) _TYPE
template < typename T > void IM_DELETE ( T * & p ) { if ( p ) { p - > ~ T ( ) ; ImGui : : MemFree ( p ) ; p = NULL ; } }
2016-01-26 05:26:53 +08:00
2015-07-22 07:00:28 +08:00
//-----------------------------------------------------------------------------
2015-07-31 12:49:10 +08:00
// Types
2015-07-22 07:00:28 +08:00
//-----------------------------------------------------------------------------
enum ImGuiButtonFlags_
{
2016-03-03 07:30:08 +08:00
ImGuiButtonFlags_Repeat = 1 < < 0 , // hold to repeat
2017-09-29 01:35:10 +08:00
ImGuiButtonFlags_PressedOnClickRelease = 1 < < 1 , // return true on click + release on same item [DEFAULT if no PressedOn* flag is set]
ImGuiButtonFlags_PressedOnClick = 1 < < 2 , // return true on click (default requires click+release)
ImGuiButtonFlags_PressedOnRelease = 1 < < 3 , // return true on release (default requires click+release)
ImGuiButtonFlags_PressedOnDoubleClick = 1 < < 4 , // return true on double-click (default requires click+release)
2017-12-12 05:39:10 +08:00
ImGuiButtonFlags_FlattenChildren = 1 < < 5 , // allow interactions even if a child window is overlapping
2017-12-13 06:41:20 +08:00
ImGuiButtonFlags_AllowItemOverlap = 1 < < 6 , // require previous frame HoveredId to either match id or be null before being usable, use along with SetItemAllowOverlap()
2017-12-12 05:39:10 +08:00
ImGuiButtonFlags_DontClosePopups = 1 < < 7 , // disable automatically closing parent popup on press // [UNUSED]
ImGuiButtonFlags_Disabled = 1 < < 8 , // disable interactions
2017-12-12 21:58:53 +08:00
ImGuiButtonFlags_AlignTextBaseLine = 1 < < 9 , // vertically align button to match text baseline - ButtonEx() only // FIXME: Should be removed and handled by SmallButton(), not possible currently because of DC.CursorPosPrevLine
2017-12-12 05:39:10 +08:00
ImGuiButtonFlags_NoKeyModifiers = 1 < < 10 , // disable interaction if a key modifier is held
2017-10-18 19:09:28 +08:00
ImGuiButtonFlags_NoHoldingActiveID = 1 < < 11 , // don't set ActiveId while holding the mouse (ImGuiButtonFlags_PressedOnClick only)
2017-12-13 03:44:12 +08:00
ImGuiButtonFlags_PressedOnDragDropHold = 1 < < 12 , // press when held into while we are drag and dropping another item (used by e.g. tree nodes, collapsing headers)
ImGuiButtonFlags_NoNavFocus = 1 < < 13 // don't override navigation focus when activated
2015-08-30 01:13:30 +08:00
} ;
2015-10-30 18:43:23 +08:00
enum ImGuiSliderFlags_
{
2015-12-26 21:59:07 +08:00
ImGuiSliderFlags_Vertical = 1 < < 0
2015-10-30 18:43:23 +08:00
} ;
2017-08-20 18:44:48 +08:00
enum ImGuiColumnsFlags_
{
// Default: 0
ImGuiColumnsFlags_NoBorder = 1 < < 0 , // Disable column dividers
2017-08-20 19:32:18 +08:00
ImGuiColumnsFlags_NoResize = 1 < < 1 , // Disable resizing columns when clicking on the dividers
ImGuiColumnsFlags_NoPreserveWidths = 1 < < 2 , // Disable column width preservation when adjusting columns
2017-11-17 00:34:34 +08:00
ImGuiColumnsFlags_NoForceWithinWindow = 1 < < 3 , // Disable forcing columns to fit within window
2017-12-14 02:21:21 +08:00
ImGuiColumnsFlags_GrowParentContentsSize = 1 < < 4 // (WIP) Restore pre-1.51 behavior of extending the parent window contents size but _without affecting the columns width at all_. Will eventually remove.
2017-08-20 18:44:48 +08:00
} ;
2015-07-22 07:00:28 +08:00
enum ImGuiSelectableFlagsPrivate_
{
// NB: need to be in sync with last value of ImGuiSelectableFlags_
2017-10-05 01:45:35 +08:00
ImGuiSelectableFlags_Menu = 1 < < 3 , // -> PressedOnClick
ImGuiSelectableFlags_MenuItem = 1 < < 4 , // -> PressedOnRelease
2016-02-01 05:08:35 +08:00
ImGuiSelectableFlags_Disabled = 1 < < 5 ,
ImGuiSelectableFlags_DrawFillAvailWidth = 1 < < 6
2015-07-22 07:00:28 +08:00
} ;
2017-09-26 21:43:48 +08:00
enum ImGuiSeparatorFlags_
{
ImGuiSeparatorFlags_Horizontal = 1 < < 0 , // Axis default to current layout type, so generally Horizontal unless e.g. in a menu bar
ImGuiSeparatorFlags_Vertical = 1 < < 1
} ;
2015-07-22 07:00:28 +08:00
// FIXME: this is in development, not exposed/functional as a generic feature yet.
enum ImGuiLayoutType_
{
ImGuiLayoutType_Vertical ,
ImGuiLayoutType_Horizontal
} ;
2017-11-21 02:39:27 +08:00
enum ImGuiAxis
{
ImGuiAxis_None = - 1 ,
ImGuiAxis_X = 0 ,
2017-12-23 21:07:03 +08:00
ImGuiAxis_Y = 1
2017-11-21 02:39:27 +08:00
} ;
2015-08-02 11:57:24 +08:00
enum ImGuiPlotType
{
ImGuiPlotType_Lines ,
ImGuiPlotType_Histogram
} ;
2015-08-06 06:57:31 +08:00
enum ImGuiDataType
{
ImGuiDataType_Int ,
2016-09-25 17:06:14 +08:00
ImGuiDataType_Float ,
2017-09-14 11:35:30 +08:00
ImGuiDataType_Float2
2015-08-06 06:57:31 +08:00
} ;
2016-07-20 06:02:59 +08:00
enum ImGuiInputSource
{
ImGuiInputSource_None = 0 ,
ImGuiInputSource_Mouse ,
ImGuiInputSource_Nav ,
2016-08-21 18:44:59 +08:00
ImGuiInputSource_Count_ ,
2016-07-20 06:02:59 +08:00
} ;
2018-01-24 23:37:20 +08:00
// FIXME-NAV: Clarify/expose various repeat delay/rate
enum ImGuiInputReadMode
{
ImGuiInputReadMode_Down ,
ImGuiInputReadMode_Pressed ,
ImGuiInputReadMode_Released ,
ImGuiInputReadMode_Repeat ,
ImGuiInputReadMode_RepeatSlow ,
ImGuiInputReadMode_RepeatFast
} ;
2017-07-30 16:15:52 +08:00
enum ImGuiDir
2016-07-20 06:02:59 +08:00
{
2017-07-30 16:15:52 +08:00
ImGuiDir_None = - 1 ,
ImGuiDir_Left = 0 ,
ImGuiDir_Right = 1 ,
ImGuiDir_Up = 2 ,
2017-12-07 20:26:56 +08:00
ImGuiDir_Down = 3 ,
ImGuiDir_Count_
2016-07-20 06:02:59 +08:00
} ;
2017-10-04 04:54:19 +08:00
enum ImGuiNavHighlightFlags_
{
ImGuiNavHighlightFlags_TypeDefault = 1 < < 0 ,
ImGuiNavHighlightFlags_TypeThin = 1 < < 1 ,
2017-10-12 01:05:36 +08:00
ImGuiNavHighlightFlags_AlwaysDraw = 1 < < 2
2017-10-04 04:54:19 +08:00
} ;
2018-01-24 23:37:20 +08:00
enum ImGuiNavDirSourceFlags_
{
ImGuiNavDirSourceFlags_Key = 1 < < 0 ,
ImGuiNavDirSourceFlags_PadLStick = 1 < < 1 ,
ImGuiNavDirSourceFlags_PadRStick = 1 < < 2
} ;
2015-07-22 07:00:28 +08:00
// 2D axis aligned bounding-box
2015-08-06 00:00:05 +08:00
// NB: we can't rely on ImVec2 math operators being available here
2015-09-10 17:22:17 +08:00
struct IMGUI_API ImRect
2015-07-22 07:00:28 +08:00
{
2015-11-30 06:01:26 +08:00
ImVec2 Min ; // Upper-left
ImVec2 Max ; // Lower-right
2015-07-22 07:00:28 +08:00
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 ) { }
2017-12-30 01:28:04 +08:00
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 & p ) { if ( Min . x > p . x ) Min . x = p . x ; if ( Min . y > p . y ) Min . y = p . y ; if ( Max . x < p . x ) Max . x = p . x ; if ( Max . y < p . y ) Max . y = p . y ; }
void Add ( const ImRect & r ) { if ( Min . x > r . Min . x ) Min . x = r . Min . x ; if ( Min . y > r . Min . y ) Min . y = r . Min . y ; if ( Max . x < r . Max . x ) Max . x = r . Max . x ; if ( Max . y < r . Max . y ) Max . y = r . 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 ; }
2018-01-09 06:59:51 +08:00
void ClipWith ( const ImRect & r ) { Min = ImMax ( Min , r . Min ) ; Max = ImMin ( Max , r . Max ) ; } // Simple version, may lead to an inverted rectangle, which is fine for Contains/Overlaps test but not for display.
void ClipWithFull ( const ImRect & r ) { Min = ImClamp ( Min , r . Min , r . Max ) ; Max = ImClamp ( Max , r . Min , r . Max ) ; } // Full version, ensure both points are fully clipped.
2017-12-30 01:28:04 +08:00
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 ; }
void FixInverted ( ) { if ( Min . x > Max . x ) ImSwap ( Min . x , Max . x ) ; if ( Min . y > Max . y ) ImSwap ( Min . y , Max . y ) ; }
bool IsFinite ( ) const { return Min . x ! = FLT_MAX ; }
2015-07-22 07:00:28 +08:00
} ;
// Stacked color modifier, backup of modified data so we can restore it
struct ImGuiColMod
{
2015-11-30 06:01:26 +08:00
ImGuiCol Col ;
2016-09-25 17:06:14 +08:00
ImVec4 BackupValue ;
2015-07-22 07:00:28 +08:00
} ;
2016-09-25 17:06:14 +08:00
// Stacked style modifier, backup of modified data so we can restore it. Data type inferred from the variable.
2015-07-22 07:00:28 +08:00
struct ImGuiStyleMod
{
2016-09-25 17:06:14 +08:00
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 ; }
2015-07-22 07:00:28 +08:00
} ;
2015-07-31 13:48:59 +08:00
// Stacked data for BeginGroup()/EndGroup()
2015-07-22 07:00:28 +08:00
struct ImGuiGroupData
{
2015-11-30 06:01:26 +08:00
ImVec2 BackupCursorPos ;
ImVec2 BackupCursorMaxPos ;
float BackupIndentX ;
2016-09-13 15:18:17 +08:00
float BackupGroupOffsetX ;
2015-11-30 06:01:26 +08:00
float BackupCurrentLineHeight ;
float BackupCurrentLineTextBaseOffset ;
float BackupLogLinePosY ;
2016-09-25 20:18:10 +08:00
bool BackupActiveIdIsAlive ;
2015-11-30 06:01:26 +08:00
bool AdvanceCursor ;
2015-07-22 07:00:28 +08:00
} ;
2016-05-08 01:54:27 +08:00
// Simple column measurement currently used for MenuItem() only. This is very short-sighted/throw-away code and NOT a generic helper.
2018-01-03 21:35:11 +08:00
struct IMGUI_API ImGuiMenuColumns
2015-07-22 07:00:28 +08:00
{
2015-11-30 06:01:26 +08:00
int Count ;
float Spacing ;
float Width , NextWidth ;
2018-01-03 21:35:11 +08:00
float Pos [ 4 ] , NextWidths [ 4 ] ;
2015-07-22 07:00:28 +08:00
2018-01-03 21:35:11 +08:00
ImGuiMenuColumns ( ) ;
2016-05-08 01:54:27 +08:00
void Update ( int count , float spacing , bool clear ) ;
float DeclColumns ( float w0 , float w1 , float w2 ) ;
float CalcExtraSpace ( float avail_w ) ;
2015-07-22 07:00:28 +08:00
} ;
// Internal state of the currently focused/edited text input box
2015-09-10 17:22:17 +08:00
struct IMGUI_API ImGuiTextEditState
2015-07-22 07:00:28 +08:00
{
2015-10-18 22:50:46 +08:00
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)
2015-07-22 07:00:28 +08:00
ImVector < char > TempTextBuffer ;
2015-10-18 22:50:46 +08:00
int CurLenA , CurLenW ; // we need to maintain our buffer length in both UTF-8 and wchar format.
int BufSizeA ; // end-user buffer size
2015-07-22 07:00:28 +08:00
float ScrollX ;
ImGuiStb : : STB_TexteditState StbState ;
float CursorAnim ;
bool CursorFollow ;
bool SelectedAllMouseLock ;
2015-10-18 22:50:46 +08:00
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 ; }
2018-01-17 19:15:24 +08:00
void SelectAll ( ) { StbState . select_start = 0 ; StbState . cursor = StbState . select_end = CurLenW ; StbState . has_preferred_x = false ; }
2015-07-22 07:00:28 +08:00
void OnKeyPressed ( int key ) ;
} ;
// Data saved in imgui.ini file
2017-11-29 02:20:50 +08:00
struct ImGuiWindowSettings
2015-07-22 07:00:28 +08:00
{
2015-11-30 06:01:26 +08:00
char * Name ;
2016-06-13 04:27:15 +08:00
ImGuiID Id ;
2015-11-30 06:01:26 +08:00
ImVec2 Pos ;
ImVec2 Size ;
bool Collapsed ;
2017-11-28 07:32:25 +08:00
2017-11-29 02:20:50 +08:00
ImGuiWindowSettings ( ) { Name = NULL ; Id = 0 ; Pos = Size = ImVec2 ( 0 , 0 ) ; Collapsed = false ; }
2015-07-22 07:00:28 +08:00
} ;
2017-11-28 06:55:42 +08:00
struct ImGuiSettingsHandler
{
const char * TypeName ; // Short description stored in .ini file. Disallowed characters: '[' ']'
ImGuiID TypeHash ; // == ImHash(TypeName, 0, 0)
2017-12-16 03:59:00 +08:00
void * ( * ReadOpenFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , const char * name ) ;
void ( * ReadLineFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , void * entry , const char * line ) ;
void ( * WriteAllFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , ImGuiTextBuffer * out_buf ) ;
void * UserData ;
ImGuiSettingsHandler ( ) { memset ( this , 0 , sizeof ( * this ) ) ; }
2015-07-22 07:00:28 +08:00
} ;
// Storage for current popup stack
struct ImGuiPopupRef
{
2017-12-14 02:21:21 +08:00
ImGuiID PopupId ; // Set on OpenPopup()
ImGuiWindow * Window ; // Resolved on BeginPopup() - may stay unresolved if user never calls OpenPopup()
ImGuiWindow * ParentWindow ; // Set on OpenPopup()
2018-01-07 23:15:54 +08:00
int OpenFrameCount ; // Set on OpenPopup()
2018-01-07 23:11:25 +08:00
ImGuiID OpenParentId ; // Set on OpenPopup(), we need this to differenciate multiple menu sets from each others (e.g. inside menu bar vs loose menu items)
ImVec2 OpenPopupPos ; // Set on OpenPopup(), preferred popup position (typically == OpenMousePos when using mouse)
ImVec2 OpenMousePos ; // Set on OpenPopup(), copy of mouse position at the time of opening popup
2015-07-22 07:00:28 +08:00
} ;
2017-12-14 01:37:58 +08:00
struct ImGuiColumnData
{
2017-12-14 04:51:23 +08:00
float OffsetNorm ; // Column start offset, normalized 0.0 (far left) -> 1.0 (far right)
float OffsetNormBeforeResize ;
2017-12-15 22:44:27 +08:00
ImGuiColumnsFlags Flags ; // Not exposed
2017-12-14 02:21:21 +08:00
ImRect ClipRect ;
2017-12-14 02:07:09 +08:00
2017-12-15 22:44:27 +08:00
ImGuiColumnData ( ) { OffsetNorm = OffsetNormBeforeResize = 0.0f ; Flags = 0 ; }
2017-12-14 01:37:58 +08:00
} ;
struct ImGuiColumnsSet
{
2017-12-14 01:42:06 +08:00
ImGuiID ID ;
ImGuiColumnsFlags Flags ;
2017-12-14 02:26:04 +08:00
bool IsFirstFrame ;
bool IsBeingResized ;
2017-12-14 01:42:06 +08:00
int Current ;
int Count ;
float MinX , MaxX ;
float StartPosY ;
float StartMaxPosX ; // Backup of CursorMaxPos
float CellMinY , CellMaxY ;
ImVector < ImGuiColumnData > Columns ;
2017-12-14 01:37:58 +08:00
ImGuiColumnsSet ( ) { Clear ( ) ; }
void Clear ( )
{
2017-12-14 01:42:06 +08:00
ID = 0 ;
Flags = 0 ;
2017-12-14 02:26:04 +08:00
IsFirstFrame = false ;
IsBeingResized = false ;
2017-12-14 01:42:06 +08:00
Current = 0 ;
Count = 1 ;
MinX = MaxX = 0.0f ;
StartPosY = 0.0f ;
StartMaxPosX = 0.0f ;
CellMinY = CellMaxY = 0.0f ;
Columns . clear ( ) ;
2017-12-14 01:37:58 +08:00
}
} ;
2018-01-16 00:29:18 +08:00
struct IMGUI_API ImDrawListSharedData
2017-12-22 01:50:27 +08:00
{
ImVec2 TexUvWhitePixel ; // UV of white pixel in the atlas
ImFont * Font ; // Current/default font (optional, for simplified AddText overload)
float FontSize ; // Current/default font size (optional, for simplified AddText overload)
float CurveTessellationTol ;
ImVec4 ClipRectFullscreen ; // Value for PushClipRectFullscreen()
// Const data
// FIXME: Bake rounded corners fill/borders in atlas
ImVec2 CircleVtx12 [ 12 ] ;
ImDrawListSharedData ( ) ;
} ;
2018-01-16 00:48:07 +08:00
struct ImDrawDataBuilder
{
2018-01-16 01:00:13 +08:00
ImVector < ImDrawList * > Layers [ 2 ] ; // Global layers for: regular, tooltip
2018-01-16 00:48:07 +08:00
void Clear ( ) { for ( int n = 0 ; n < IM_ARRAYSIZE ( Layers ) ; n + + ) Layers [ n ] . resize ( 0 ) ; }
void ClearFreeMemory ( ) { for ( int n = 0 ; n < IM_ARRAYSIZE ( Layers ) ; n + + ) Layers [ n ] . clear ( ) ; }
IMGUI_API void FlattenIntoSingleLayer ( ) ;
} ;
2018-01-03 19:12:41 +08:00
// Storage for SetNexWindow** functions
struct ImGuiNextWindowData
{
ImGuiCond PosCond ;
ImGuiCond SizeCond ;
ImGuiCond ContentSizeCond ;
ImGuiCond CollapsedCond ;
2018-01-03 19:22:02 +08:00
ImGuiCond SizeConstraintCond ;
ImGuiCond FocusCond ;
2018-01-24 02:13:49 +08:00
ImGuiCond BgAlphaCond ;
2018-01-03 19:12:41 +08:00
ImVec2 PosVal ;
ImVec2 PosPivotVal ;
ImVec2 SizeVal ;
ImVec2 ContentSizeVal ;
bool CollapsedVal ;
ImRect SizeConstraintRect ; // Valid if 'SetNextWindowSizeConstraint' is true
2018-01-03 19:31:56 +08:00
ImGuiSizeCallback SizeCallback ;
void * SizeCallbackUserData ;
2018-01-24 02:13:49 +08:00
float BgAlphaVal ;
2018-01-03 19:12:41 +08:00
ImGuiNextWindowData ( )
{
2018-01-24 02:13:49 +08:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = 0 ;
2018-01-03 19:12:41 +08:00
PosVal = PosPivotVal = SizeVal = ImVec2 ( 0.0f , 0.0f ) ;
ContentSizeVal = ImVec2 ( 0.0f , 0.0f ) ;
CollapsedVal = false ;
SizeConstraintRect = ImRect ( ) ;
2018-01-03 19:31:56 +08:00
SizeCallback = NULL ;
SizeCallbackUserData = NULL ;
2018-01-24 02:13:49 +08:00
BgAlphaVal = FLT_MAX ;
2018-01-03 19:12:41 +08:00
}
2018-01-03 19:28:16 +08:00
void Clear ( )
{
2018-01-24 02:13:49 +08:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = 0 ;
2018-01-03 19:28:16 +08:00
}
2018-01-03 19:12:41 +08:00
} ;
2015-07-22 07:00:28 +08:00
// Main state for ImGui
2016-05-08 01:55:51 +08:00
struct ImGuiContext
2015-07-22 07:00:28 +08:00
{
bool Initialized ;
ImGuiIO IO ;
ImGuiStyle Style ;
ImFont * Font ; // (Shortcut) == FontStack.empty() ? IO.Font : FontStack.back()
2016-07-18 19:03:47 +08:00
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.
2017-12-22 01:50:27 +08:00
ImDrawListSharedData DrawListSharedData ;
2015-07-22 07:00:28 +08:00
float Time ;
int FrameCount ;
2015-09-17 06:48:42 +08:00
int FrameCountEnded ;
2015-07-22 07:00:28 +08:00
int FrameCountRendered ;
ImVector < ImGuiWindow * > Windows ;
ImVector < ImGuiWindow * > WindowsSortBuffer ;
ImVector < ImGuiWindow * > CurrentWindowStack ;
2017-11-07 20:59:55 +08:00
ImGuiStorage WindowsById ;
2017-12-13 06:36:25 +08:00
int WindowsActiveCount ;
2016-07-18 19:03:47 +08:00
ImGuiWindow * CurrentWindow ; // Being drawn into
2015-07-22 07:00:28 +08:00
ImGuiWindow * HoveredWindow ; // Will catch mouse inputs
ImGuiWindow * HoveredRootWindow ; // Will catch mouse inputs (for focus/move only)
ImGuiID HoveredId ; // Hovered widget
2015-12-04 05:30:17 +08:00
bool HoveredIdAllowOverlap ;
2015-07-22 07:00:28 +08:00
ImGuiID HoveredIdPreviousFrame ;
2017-10-30 06:46:32 +08:00
float HoveredIdTimer ;
2015-07-22 07:00:28 +08:00
ImGuiID ActiveId ; // Active widget
ImGuiID ActiveIdPreviousFrame ;
2017-10-30 06:46:32 +08:00
float ActiveIdTimer ;
2016-07-17 20:26:01 +08:00
bool ActiveIdIsAlive ; // Active widget has been seen this frame
2015-07-22 07:00:28 +08:00
bool ActiveIdIsJustActivated ; // Set at the time of activation for one frame
2016-07-18 19:03:47 +08:00
bool ActiveIdAllowOverlap ; // Active widget allows another widget to steal active id (generally for overlapping widgets, but not always)
2016-07-30 20:31:34 +08:00
int ActiveIdAllowNavDirFlags ; // Active widget allows using directional navigation (e.g. can activate a button and move away from it)
2016-05-22 02:50:15 +08:00
ImVec2 ActiveIdClickOffset ; // Clicked offset from upper-left corner, if applicable (currently only set by ButtonBehavior)
2015-07-22 07:00:28 +08:00
ImGuiWindow * ActiveIdWindow ;
2016-07-20 06:02:59 +08:00
ImGuiInputSource ActiveIdSource ; // Activating with mouse or nav (gamepad/keyboard)
2018-01-14 21:13:54 +08:00
ImGuiWindow * MovingWindow ; // Track the window we clicked on (in order to preserve focus). The actually window that is moved is generally MovingWindow->RootWindow.
2015-07-22 07:00:28 +08:00
ImVector < ImGuiColMod > ColorModifiers ; // Stack for PushStyleColor()/PopStyleColor()
ImVector < ImGuiStyleMod > StyleModifiers ; // Stack for PushStyleVar()/PopStyleVar()
ImVector < ImFont * > FontStack ; // Stack for PushFont()/PopFont()
2016-05-02 18:32:16 +08:00
ImVector < ImGuiPopupRef > OpenPopupStack ; // Which popups are open (persistent)
2015-07-22 07:00:28 +08:00
ImVector < ImGuiPopupRef > CurrentPopupStack ; // Which level of BeginPopup() we are in (reset every frame)
2018-01-03 19:28:16 +08:00
ImGuiNextWindowData NextWindowData ; // Storage for SetNextWindow** functions
2018-01-03 19:12:41 +08:00
bool NextTreeNodeOpenVal ; // Storage for SetNextTreeNode** functions
ImGuiCond NextTreeNodeOpenCond ;
2015-07-22 07:00:28 +08:00
2016-07-20 06:02:59 +08:00
// Navigation data (for gamepad/keyboard)
2017-10-23 18:38:39 +08:00
ImGuiWindow * NavWindow ; // Focused window for navigation. Could be called 'FocusWindow'
2017-10-14 04:33:06 +08:00
ImGuiID NavId ; // Focused item for navigation
ImGuiID NavActivateId ; // ~~ IsNavInputPressed(ImGuiNavInput_PadActivate) ? NavId : 0, also set when calling ActivateItem()
ImGuiID NavActivateDownId ; // ~~ IsNavInputPressed(ImGuiNavInput_PadActivate) ? NavId : 0
ImGuiID NavInputId ; // ~~ IsNavInputPressed(ImGuiNavInput_PadInput) ? NavId : 0
2017-10-04 02:22:38 +08:00
ImGuiID NavJustTabbedId ; // Just tabbed to this id.
2017-10-06 12:25:20 +08:00
ImGuiID NavNextActivateId ; // Set by ActivateItem(), queued until next frame
2017-10-14 04:33:06 +08:00
ImGuiID NavJustMovedToId ; // Just navigated to this id (result of a successfully MoveRequest)
2017-09-30 01:26:03 +08:00
ImRect NavScoringRectScreen ; // Rectangle used for scoring, in screen space. Based of window->DC.NavRefRectRel[], modified for directional navigation scoring.
2018-01-16 02:09:40 +08:00
ImGuiWindow * NavWindowingTarget ; // When selecting a window (holding Menu+FocusPrev/Next, or equivalent of CTRL-TAB) this window is temporarily displayed front-most.
2016-07-24 20:56:14 +08:00
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.
2016-07-20 06:02:59 +08:00
int NavIdTabCounter ; // == NavWindow->DC.FocusIdxTabCounter at time of NavId processing
bool NavIdIsAlive ; // Nav widget has been seen this frame ~~ NavRefRectRel is valid
bool NavMousePosDirty ;
2016-08-21 05:27:25 +08:00
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.
2017-10-07 06:54:29 +08:00
bool NavAnyRequest ; // ~~ NavMoveRequest || NavInitRequest
bool NavInitRequest ; // Init request for appearing window to select first item
ImGuiID NavInitResultId ;
ImRect NavInitResultRectRel ;
bool NavInitResultExplicit ; // Whether the result was explicitly requested with SetItemDefaultFocus()
2016-07-30 23:18:34 +08:00
bool NavMoveFromClampedRefRect ; // Set by manual scrolling, if we scroll to a point where NavId isn't visible we reset navigation from visible items
2017-09-30 05:36:41 +08:00
bool NavMoveRequest ; // Move request for this frame
2017-10-06 01:29:17 +08:00
int NavMoveRequestForwardStep ; // 0: no forward, 1: forward request, 2: forward result (this is used to navigate sibling parent menus from a child menu)
ImGuiDir NavMoveDir ; // Direction of the move request (left/right/up/down)
ImGuiDir NavMoveDirLast ; // Direction of the previous move request
2016-07-24 18:46:25 +08:00
ImGuiID NavMoveResultId ; // Best move request candidate
2017-10-04 04:25:40 +08:00
ImGuiID NavMoveResultParentId ; //
2016-07-24 18:46:25 +08:00
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
2016-07-20 06:02:59 +08:00
2015-07-22 07:00:28 +08:00
// Render
2018-01-16 00:25:11 +08:00
ImDrawData DrawData ; // Main ImDrawData instance to pass render information to the user
2018-01-16 00:48:07 +08:00
ImDrawDataBuilder DrawDataBuilder ;
2015-07-22 07:00:28 +08:00
float ModalWindowDarkeningRatio ;
ImDrawList OverlayDrawList ; // Optional software render of mouse cursors, if io.MouseDrawCursor is set + a few debug overlays
ImGuiMouseCursor MouseCursor ;
2017-10-30 04:15:02 +08:00
// Drag and Drop
bool DragDropActive ;
ImGuiDragDropFlags DragDropSourceFlags ;
int DragDropMouseButton ;
ImGuiPayload DragDropPayload ;
2017-11-10 20:13:28 +08:00
ImRect DragDropTargetRect ;
ImGuiID DragDropTargetId ;
2017-11-08 22:47:52 +08:00
float DragDropAcceptIdCurrRectSurface ;
2017-11-07 03:02:56 +08:00
ImGuiID DragDropAcceptIdCurr ; // Target item id (set at the time of accepting the payload)
ImGuiID DragDropAcceptIdPrev ; // Target item id from previous frame (we need to store this to allow for overlapping drag and drop targets)
int DragDropAcceptFrameCount ; // Last time a target expressed a desire to accept the source
2017-10-30 04:15:02 +08:00
ImVector < unsigned char > DragDropPayloadBufHeap ; // We don't expose the ImVector<> directly
unsigned char DragDropPayloadBufLocal [ 8 ] ;
2015-07-22 07:00:28 +08:00
// Widget state
ImGuiTextEditState InputTextState ;
2015-11-20 06:09:59 +08:00
ImFont InputTextPasswordFont ;
2015-07-22 07:00:28 +08:00
ImGuiID ScalarAsInputTextId ; // Temporary text input when CTRL+clicking on a slider, etc.
2017-08-08 15:54:20 +08:00
ImGuiColorEditFlags ColorEditOptions ; // Store user options for color edit widgets
2017-07-29 15:54:45 +08:00
ImVec4 ColorPickerRef ;
2015-08-06 00:00:05 +08:00
float DragCurrentValue ; // Currently dragged value, always float, not rounded by end-user precision settings
2015-07-22 07:00:28 +08:00
ImVec2 DragLastMouseDelta ;
2015-08-06 00:00:05 +08:00
float DragSpeedDefaultRatio ; // If speed == 0.0f, uses (max-min) * DragSpeedDefaultRatio
2015-07-22 07:00:28 +08:00
float DragSpeedScaleSlow ;
float DragSpeedScaleFast ;
2016-05-08 00:10:32 +08:00
ImVec2 ScrollbarClickDeltaToGrabCenter ; // Distance between mouse and center of grab box, normalized in parent space. Use storage?
2017-07-21 02:21:48 +08:00
int TooltipOverrideCount ;
2016-07-30 16:02:46 +08:00
ImVector < char > PrivateClipboard ; // If no custom clipboard handler is defined
2015-11-29 22:15:07 +08:00
ImVec2 OsImePosRequest , OsImePosSet ; // Cursor position request & last passed to the OS Input Method Editor
2015-07-22 07:00:28 +08:00
2017-11-28 06:55:42 +08:00
// Settings
float SettingsDirtyTimer ; // Save .ini Settings on disk when time reaches zero
2017-11-29 02:20:50 +08:00
ImVector < ImGuiWindowSettings > SettingsWindows ; // .ini settings for ImGuiWindow
2017-11-28 06:55:42 +08:00
ImVector < ImGuiSettingsHandler > SettingsHandlers ; // List of .ini settings handlers
2015-07-22 07:00:28 +08:00
// Logging
bool LogEnabled ;
2015-08-24 19:50:18 +08:00
FILE * LogFile ; // If != NULL log to stdout/ file
2015-08-06 00:00:05 +08:00
ImGuiTextBuffer * LogClipboard ; // Else log to clipboard. This is pointer so our GImGui static constructor doesn't call heap allocators.
2015-07-22 07:00:28 +08:00
int LogStartDepth ;
int LogAutoExpandMaxDepth ;
// Misc
float FramerateSecPerFrame [ 120 ] ; // calculate estimate of framerate for user
int FramerateSecPerFrameIdx ;
float FramerateSecPerFrameAccum ;
2017-09-06 23:20:54 +08:00
int WantCaptureMouseNextFrame ; // explicit capture via CaptureInputs() sets those flags
int WantCaptureKeyboardNextFrame ;
2017-09-06 23:25:36 +08:00
int WantTextInputNextFrame ;
2015-07-22 07:00:28 +08:00
char TempBuffer [ 1024 * 3 + 1 ] ; // temporary text buffer
2017-12-22 01:50:27 +08:00
ImGuiContext ( ) : OverlayDrawList ( NULL )
2015-07-22 07:00:28 +08:00
{
Initialized = false ;
Font = NULL ;
FontSize = FontBaseSize = 0.0f ;
Time = 0.0f ;
FrameCount = 0 ;
2015-09-17 06:48:42 +08:00
FrameCountEnded = FrameCountRendered = - 1 ;
2017-12-13 06:36:25 +08:00
WindowsActiveCount = 0 ;
2015-07-22 07:00:28 +08:00
CurrentWindow = NULL ;
HoveredWindow = NULL ;
HoveredRootWindow = NULL ;
HoveredId = 0 ;
2015-12-04 05:30:17 +08:00
HoveredIdAllowOverlap = false ;
2015-07-22 07:00:28 +08:00
HoveredIdPreviousFrame = 0 ;
2017-10-30 06:46:32 +08:00
HoveredIdTimer = 0.0f ;
2015-07-22 07:00:28 +08:00
ActiveId = 0 ;
ActiveIdPreviousFrame = 0 ;
2017-10-30 06:46:32 +08:00
ActiveIdTimer = 0.0f ;
2015-07-22 07:00:28 +08:00
ActiveIdIsAlive = false ;
ActiveIdIsJustActivated = false ;
2015-12-04 05:30:17 +08:00
ActiveIdAllowOverlap = false ;
2017-10-06 07:39:59 +08:00
ActiveIdAllowNavDirFlags = 0 ;
2016-05-22 02:50:15 +08:00
ActiveIdClickOffset = ImVec2 ( - 1 , - 1 ) ;
2015-07-22 07:00:28 +08:00
ActiveIdWindow = NULL ;
2016-07-20 06:02:59 +08:00
ActiveIdSource = ImGuiInputSource_None ;
2017-10-27 18:01:52 +08:00
MovingWindow = NULL ;
2018-01-03 19:12:41 +08:00
NextTreeNodeOpenVal = false ;
NextTreeNodeOpenCond = 0 ;
2015-07-22 07:00:28 +08:00
2016-07-31 19:38:57 +08:00
NavWindow = NULL ;
2017-10-06 11:35:47 +08:00
NavId = NavActivateId = NavActivateDownId = NavInputId = 0 ;
2017-10-14 04:33:06 +08:00
NavJustTabbedId = NavJustMovedToId = NavNextActivateId = 0 ;
2017-09-30 01:26:03 +08:00
NavScoringRectScreen = ImRect ( ) ;
2016-07-20 06:02:59 +08:00
NavWindowingTarget = NULL ;
2016-07-24 20:56:14 +08:00
NavWindowingDisplayAlpha = 0.0f ;
NavWindowingToggleLayer = false ;
2017-10-06 07:39:59 +08:00
NavLayer = 0 ;
2016-07-20 06:02:59 +08:00
NavIdTabCounter = INT_MAX ;
NavIdIsAlive = false ;
NavMousePosDirty = false ;
NavDisableHighlight = true ;
NavDisableMouseHover = false ;
2017-10-07 06:14:28 +08:00
NavAnyRequest = false ;
2017-10-07 06:54:29 +08:00
NavInitRequest = false ;
NavInitResultId = 0 ;
NavInitResultExplicit = false ;
2017-09-30 04:56:51 +08:00
NavMoveFromClampedRefRect = false ;
2016-07-20 06:02:59 +08:00
NavMoveRequest = false ;
2017-09-30 05:36:41 +08:00
NavMoveRequestForwardStep = 0 ;
2017-09-29 05:48:30 +08:00
NavMoveDir = NavMoveDirLast = ImGuiDir_None ;
2016-07-24 18:46:25 +08:00
NavMoveResultId = 0 ;
2017-10-04 04:25:40 +08:00
NavMoveResultParentId = 0 ;
2016-07-24 18:46:25 +08:00
NavMoveResultDistBox = NavMoveResultDistCenter = NavMoveResultDistAxial = 0.0f ;
2016-07-20 06:02:59 +08:00
2018-01-13 02:11:11 +08:00
ModalWindowDarkeningRatio = 0.0f ;
OverlayDrawList . _Data = & DrawListSharedData ;
OverlayDrawList . _OwnerName = " ##Overlay " ; // Give it a name for debugging
MouseCursor = ImGuiMouseCursor_Arrow ;
2017-10-30 04:15:02 +08:00
DragDropActive = false ;
DragDropSourceFlags = 0 ;
DragDropMouseButton = - 1 ;
2017-11-10 20:13:28 +08:00
DragDropTargetId = 0 ;
2018-01-13 02:11:11 +08:00
DragDropAcceptIdCurrRectSurface = 0.0f ;
2017-11-07 03:02:56 +08:00
DragDropAcceptIdPrev = DragDropAcceptIdCurr = 0 ;
DragDropAcceptFrameCount = - 1 ;
2017-10-30 04:37:14 +08:00
memset ( DragDropPayloadBufLocal , 0 , sizeof ( DragDropPayloadBufLocal ) ) ;
2017-10-30 04:15:02 +08:00
2015-07-22 07:00:28 +08:00
ScalarAsInputTextId = 0 ;
2017-08-08 15:54:20 +08:00
ColorEditOptions = ImGuiColorEditFlags__OptionsDefault ;
2015-07-22 07:00:28 +08:00
DragCurrentValue = 0.0f ;
DragLastMouseDelta = ImVec2 ( 0.0f , 0.0f ) ;
2016-06-25 23:03:49 +08:00
DragSpeedDefaultRatio = 1.0f / 100.0f ;
2016-07-16 16:46:51 +08:00
DragSpeedScaleSlow = 1.0f / 100.0f ;
2015-07-22 07:00:28 +08:00
DragSpeedScaleFast = 10.0f ;
2015-08-30 23:37:56 +08:00
ScrollbarClickDeltaToGrabCenter = ImVec2 ( 0.0f , 0.0f ) ;
2017-07-21 02:21:48 +08:00
TooltipOverrideCount = 0 ;
2015-11-29 22:15:07 +08:00
OsImePosRequest = OsImePosSet = ImVec2 ( - 1.0f , - 1.0f ) ;
2015-07-22 07:00:28 +08:00
2017-11-28 06:55:42 +08:00
SettingsDirtyTimer = 0.0f ;
2015-07-22 07:00:28 +08:00
LogEnabled = false ;
LogFile = NULL ;
LogClipboard = NULL ;
LogStartDepth = 0 ;
LogAutoExpandMaxDepth = 2 ;
memset ( FramerateSecPerFrame , 0 , sizeof ( FramerateSecPerFrame ) ) ;
FramerateSecPerFrameIdx = 0 ;
FramerateSecPerFrameAccum = 0.0f ;
2017-09-06 23:25:36 +08:00
WantCaptureMouseNextFrame = WantCaptureKeyboardNextFrame = WantTextInputNextFrame = - 1 ;
2015-12-30 18:45:13 +08:00
memset ( TempBuffer , 0 , sizeof ( TempBuffer ) ) ;
2015-07-22 07:00:28 +08:00
}
} ;
2016-08-08 02:05:24 +08:00
// Transient per-window flags, reset at the beginning of the frame. For child window, inherited from parent on first Begin().
enum ImGuiItemFlags_
{
2017-09-07 02:36:36 +08:00
ImGuiItemFlags_AllowKeyboardFocus = 1 < < 0 , // true
ImGuiItemFlags_ButtonRepeat = 1 < < 1 , // false // Button() will return true multiple times based on io.KeyRepeatDelay and io.KeyRepeatRate settings.
2017-10-25 15:28:54 +08:00
ImGuiItemFlags_Disabled = 1 < < 2 , // false // FIXME-WIP: Disable interactions but doesn't affect visuals. Should be: grey out and disable interactions with widgets that affect data + view widgets (WIP)
2017-09-29 01:58:01 +08:00
ImGuiItemFlags_NoNav = 1 < < 3 , // false
ImGuiItemFlags_NoNavDefaultFocus = 1 < < 4 , // false
ImGuiItemFlags_SelectableDontClosePopup = 1 < < 5 , // false // MenuItem/Selectable() automatically closes current Popup window
2017-09-29 01:18:41 +08:00
ImGuiItemFlags_Default_ = ImGuiItemFlags_AllowKeyboardFocus
2016-08-08 02:05:24 +08:00
} ;
2015-07-22 07:00:28 +08:00
// 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.
2015-09-22 06:53:51 +08:00
struct IMGUI_API ImGuiDrawContext
2015-07-22 07:00:28 +08:00
{
ImVec2 CursorPos ;
ImVec2 CursorPosPrevLine ;
ImVec2 CursorStartPos ;
2017-12-11 00:36:30 +08:00
ImVec2 CursorMaxPos ; // Used to implicitly calculate the size of our contents, always growing during the frame. Turned into window->SizeContents at the beginning of next frame
2015-07-22 07:00:28 +08:00
float CurrentLineHeight ;
float CurrentLineTextBaseOffset ;
float PrevLineHeight ;
float PrevLineTextBaseOffset ;
float LogLinePosY ;
int TreeDepth ;
2016-06-13 04:27:15 +08:00
ImGuiID LastItemId ;
2015-07-22 07:00:28 +08:00
ImRect LastItemRect ;
2017-09-28 21:43:26 +08:00
bool LastItemRectHoveredRect ;
2017-09-30 05:36:41 +08:00
bool NavHasScroll ; // Set when scrolling can be used (ScrollMax > 0.0f)
int NavLayerCurrent ; // Current layer, 0..31 (we currently only use 0..1)
2017-10-07 05:51:15 +08:00
int NavLayerCurrentMask ; // = (1 << NavLayerCurrent) used by ItemAdd prior to clipping.
2017-09-30 04:57:44 +08:00
int NavLayerActiveMask ; // Which layer have been written to (result from previous frame)
int NavLayerActiveMaskNext ; // Which layer have been written to (buffer for current frame)
bool MenuBarAppending ; // FIXME: Remove this
2015-07-22 07:00:28 +08:00
float MenuBarOffsetX ;
ImVector < ImGuiWindow * > ChildWindows ;
ImGuiStorage * StateStorage ;
ImGuiLayoutType LayoutType ;
2017-09-30 05:36:41 +08:00
ImGuiLayoutType ParentLayoutType ; // Layout type of parent window at the time of Begin()
2015-07-22 07:00:28 +08:00
// 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.
2016-08-08 02:05:24 +08:00
ImGuiItemFlags ItemFlags ; // == ItemFlagsStack.back() [empty == ImGuiItemFlags_Default]
2015-07-22 07:00:28 +08:00
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]
2016-08-08 02:05:24 +08:00
ImVector < ImGuiItemFlags > ItemFlagsStack ;
2015-07-22 07:00:28 +08:00
ImVector < float > ItemWidthStack ;
ImVector < float > TextWrapPosStack ;
ImVector < ImGuiGroupData > GroupStack ;
int StackSizesBackup [ 6 ] ; // Store size of various stacks for asserting
2015-11-27 06:43:21 +08:00
float IndentX ; // Indentation / start position from left of window (increased by TreePush/TreePop, etc.)
2016-07-31 05:41:44 +08:00
float GroupOffsetX ;
2015-07-22 07:00:28 +08:00
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.
2017-12-14 02:21:21 +08:00
ImGuiColumnsSet * ColumnsSet ; // Current columns set
2015-07-22 07:00:28 +08:00
ImGuiDrawContext ( )
{
CursorPos = CursorPosPrevLine = CursorStartPos = CursorMaxPos = ImVec2 ( 0.0f , 0.0f ) ;
CurrentLineHeight = PrevLineHeight = 0.0f ;
CurrentLineTextBaseOffset = PrevLineTextBaseOffset = 0.0f ;
LogLinePosY = - 1.0f ;
TreeDepth = 0 ;
2016-06-13 04:27:15 +08:00
LastItemId = 0 ;
2017-09-28 21:43:26 +08:00
LastItemRect = ImRect ( ) ;
LastItemRectHoveredRect = false ;
2016-07-24 20:56:14 +08:00
NavHasScroll = false ;
2017-09-29 01:41:30 +08:00
NavLayerActiveMask = NavLayerActiveMaskNext = 0x00 ;
2016-07-24 20:56:14 +08:00
NavLayerCurrent = 0 ;
2017-10-07 05:51:15 +08:00
NavLayerCurrentMask = 1 < < 0 ;
2015-07-22 07:00:28 +08:00
MenuBarAppending = false ;
MenuBarOffsetX = 0.0f ;
StateStorage = NULL ;
2017-09-30 05:36:41 +08:00
LayoutType = ParentLayoutType = ImGuiLayoutType_Vertical ;
2015-07-22 07:00:28 +08:00
ItemWidth = 0.0f ;
2016-08-08 02:05:24 +08:00
ItemFlags = ImGuiItemFlags_Default_ ;
2015-07-22 07:00:28 +08:00
TextWrapPos = - 1.0f ;
memset ( StackSizesBackup , 0 , sizeof ( StackSizesBackup ) ) ;
2015-11-27 06:43:21 +08:00
IndentX = 0.0f ;
2016-11-13 04:17:30 +08:00
GroupOffsetX = 0.0f ;
2015-07-22 07:00:28 +08:00
ColumnsOffsetX = 0.0f ;
2017-12-14 01:37:58 +08:00
ColumnsSet = NULL ;
2015-07-22 07:00:28 +08:00
}
} ;
2015-07-31 13:48:59 +08:00
// Windows data
2015-09-10 17:22:17 +08:00
struct IMGUI_API ImGuiWindow
2015-07-22 07:00:28 +08:00
{
char * Name ;
2016-04-20 00:31:40 +08:00
ImGuiID ID ; // == ImHash(Name)
ImGuiWindowFlags Flags ; // See enum ImGuiWindowFlags_
2015-07-22 07:00:28 +08:00
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
2017-12-06 22:13:23 +08:00
ImVec2 SizeFullAtLastBegin ; // Copy of SizeFull at the end of Begin. This is the reference value we'll use on the next frame to decide if we need scrollbars.
2017-12-11 00:36:30 +08:00
ImVec2 SizeContents ; // Size of contents (== extents reach of the drawing cursor) from previous frame. Include decoration, window title, border, menu, etc.
2015-08-30 23:37:56 +08:00
ImVec2 SizeContentsExplicit ; // Size of contents explicitly set by the user via SetNextWindowContentSize()
2016-05-29 23:50:23 +08:00
ImRect ContentsRegionRect ; // Maximum visible content position in window coordinates. ~~ (SizeContentsExplicit ? SizeContentsExplicit : Size - ScrollbarSizes) - CursorStartPos, per axis
2017-11-19 02:02:02 +08:00
ImVec2 WindowPadding ; // Window padding at the time of begin.
float WindowRounding ; // Window rounding at the time of begin.
float WindowBorderSize ; // Window border size at the time of begin.
2016-06-13 04:27:15 +08:00
ImGuiID MoveId ; // == window->GetID("#MOVE")
2017-08-22 19:26:21 +08:00
ImGuiID ChildId ; // Id of corresponding item in parent window (for child windows)
2015-08-30 22:08:13 +08:00
ImVec2 Scroll ;
2015-08-31 01:33:38 +08:00
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
2015-08-30 23:37:56 +08:00
bool ScrollbarX , ScrollbarY ;
2016-01-24 19:00:37 +08:00
ImVec2 ScrollbarSizes ;
2018-01-04 03:45:06 +08:00
bool Active ; // Set to true on Begin(), unless Collapsed
2015-07-22 07:00:28 +08:00
bool WasActive ;
2017-11-19 07:07:38 +08:00
bool WriteAccessed ; // Set to true when any widget access the current window
2015-07-22 07:00:28 +08:00
bool Collapsed ; // Set when collapsing window to become only title-bar
2016-07-30 16:56:52 +08:00
bool CollapseToggleWanted ;
2017-09-02 03:55:59 +08:00
bool SkipItems ; // Set when items can safely be all clipped (e.g. window not visible or collapsed)
bool Appearing ; // Set during the frame where the window is appearing (or re-appearing)
2017-11-14 06:25:13 +08:00
bool CloseButton ; // Set when the window has a close button (p_open != NULL)
2017-12-13 06:36:25 +08:00
int BeginOrderWithinParent ; // Order within immediate parent window, if we are a child window. Otherwise 0.
int BeginOrderWithinContext ; // Order within entire imgui context. This is mostly used for debugging submission order related issues.
2015-07-22 07:00:28 +08:00
int BeginCount ; // Number of Begin() during the current frame (generally 0 or 1, 1+ if appending via multiple Begin/End pairs)
2016-06-13 04:27:15 +08:00
ImGuiID PopupId ; // ID in the popup stack when this window is used as a popup/menu (because we use generic Name/ID for recycling)
2015-07-22 07:00:28 +08:00
int AutoFitFramesX , AutoFitFramesY ;
bool AutoFitOnlyGrows ;
2016-07-31 19:05:13 +08:00
int AutoFitChildAxises ;
2017-12-07 20:26:56 +08:00
ImGuiDir AutoPosLastDirection ;
2015-07-22 07:00:28 +08:00
int HiddenFrames ;
2017-08-11 13:36:28 +08:00
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.
2017-09-26 00:25:43 +08:00
ImVec2 SetWindowPosVal ; // store window position when using a non-zero Pivot (position set needs to be processed when we know the window size)
ImVec2 SetWindowPosPivot ; // store window pivot for positioning. ImVec2(0,0) when positioning from top-left corner; ImVec2(0.5f,0.5f) for centering; ImVec2(1,1) for bottom right.
2015-07-22 07:00:28 +08:00
2017-09-30 01:26:03 +08:00
ImGuiID NavLastIds [ 2 ] ; // Last known NavId for this window, per layer (0/1)
2018-01-25 02:57:39 +08:00
ImRect NavRectRel [ 2 ] ; // Reference rectangle, in window relative space
2017-09-29 23:58:25 +08:00
2015-07-22 07:00:28 +08:00
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
2015-08-06 22:23:05 +08:00
ImRect ClipRect ; // = DrawList->clip_rect_stack.back(). Scissoring / clipping rectangle. x1, y1, x2, y2.
2016-05-06 17:31:32 +08:00
ImRect WindowRectClipped ; // = WindowRect just after setup in Begin(). == window->Rect() for root window.
2016-07-20 06:02:59 +08:00
ImRect InnerRect ;
2015-10-18 23:57:10 +08:00
int LastFrameActive ;
2015-07-22 07:00:28 +08:00
float ItemWidthDefault ;
2018-01-03 21:35:11 +08:00
ImGuiMenuColumns MenuColumns ; // Simplified columns storage for menu items
2015-07-22 07:00:28 +08:00
ImGuiStorage StateStorage ;
2017-12-14 02:21:21 +08:00
ImVector < ImGuiColumnsSet > ColumnsStorage ;
2015-07-22 07:00:28 +08:00
float FontWindowScale ; // Scale multiplier per-window
ImDrawList * DrawList ;
2017-12-13 01:45:57 +08:00
ImGuiWindow * ParentWindow ; // If we are a child _or_ popup window, this is pointing to our parent. Otherwise NULL.
2016-07-31 18:55:23 +08:00
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.
2015-07-22 07:00:28 +08:00
2016-06-25 23:03:49 +08:00
// Navigation / Focus
2018-01-13 02:13:15 +08:00
// FIXME-NAV: Merge all this with the new Nav system, at least the request variables should be moved to ImGuiContext
2015-07-22 07:00:28 +08:00
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 :
2017-12-22 01:50:27 +08:00
ImGuiWindow ( ImGuiContext * context , const char * name ) ;
2015-07-22 07:00:28 +08:00
~ ImGuiWindow ( ) ;
ImGuiID GetID ( const char * str , const char * str_end = NULL ) ;
ImGuiID GetID ( const void * ptr ) ;
2016-07-13 07:18:59 +08:00
ImGuiID GetIDNoKeepAlive ( const char * str , const char * str_end = NULL ) ;
2017-10-30 06:10:44 +08:00
ImGuiID GetIDFromRectangle ( const ImRect & r_abs ) ;
2015-07-22 07:00:28 +08:00
2017-11-22 19:26:50 +08:00
// We don't use g.FontSize because the window may be != g.CurrentWidow.
2015-07-22 07:00:28 +08:00
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 ( ) ) ; }
} ;
2015-08-02 11:57:24 +08:00
2017-10-19 01:51:32 +08:00
// Backup and restore just enough data to be able to use IsItemHovered() on item A after another B in the same window has overwritten the data.
struct ImGuiItemHoveredDataBackup
{
ImGuiID LastItemId ;
ImRect LastItemRect ;
bool LastItemRectHoveredRect ;
2017-12-13 06:36:25 +08:00
ImGuiItemHoveredDataBackup ( ) { Backup ( ) ; }
void Backup ( ) { ImGuiWindow * window = GImGui - > CurrentWindow ; LastItemId = window - > DC . LastItemId ; LastItemRect = window - > DC . LastItemRect ; LastItemRectHoveredRect = window - > DC . LastItemRectHoveredRect ; }
void Restore ( ) const { ImGuiWindow * window = GImGui - > CurrentWindow ; window - > DC . LastItemId = LastItemId ; window - > DC . LastItemRect = LastItemRect ; window - > DC . LastItemRectHoveredRect = LastItemRectHoveredRect ; }
2017-10-19 01:51:32 +08:00
} ;
2015-08-02 11:57:24 +08:00
//-----------------------------------------------------------------------------
// Internal API
// No guarantee of forward compatibility here.
//-----------------------------------------------------------------------------
namespace ImGui
{
2015-09-17 06:48:42 +08:00
// 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.
2016-05-08 01:55:51 +08:00
inline ImGuiWindow * GetCurrentWindowRead ( ) { ImGuiContext & g = * GImGui ; return g . CurrentWindow ; }
2017-11-19 07:07:38 +08:00
inline ImGuiWindow * GetCurrentWindow ( ) { ImGuiContext & g = * GImGui ; g . CurrentWindow - > WriteAccessed = true ; return g . CurrentWindow ; }
2016-02-21 00:37:36 +08:00
IMGUI_API ImGuiWindow * FindWindowByName ( const char * name ) ;
2015-08-06 22:11:33 +08:00
IMGUI_API void FocusWindow ( ImGuiWindow * window ) ;
2017-11-16 20:11:16 +08:00
IMGUI_API void BringWindowToFront ( ImGuiWindow * window ) ;
IMGUI_API void BringWindowToBack ( ImGuiWindow * window ) ;
2017-12-12 06:16:27 +08:00
IMGUI_API bool IsWindowChildOf ( ImGuiWindow * window , ImGuiWindow * potential_parent ) ;
2015-08-06 22:11:33 +08:00
2017-08-26 16:35:39 +08:00
IMGUI_API void Initialize ( ) ;
2016-04-03 06:47:41 +08:00
2017-11-29 03:03:10 +08:00
IMGUI_API void MarkIniSettingsDirty ( ) ;
2017-12-16 03:59:00 +08:00
IMGUI_API ImGuiSettingsHandler * FindSettingsHandler ( const char * type_name ) ;
2017-11-29 03:03:10 +08:00
IMGUI_API ImGuiWindowSettings * FindWindowSettings ( ImGuiID id ) ;
2017-11-28 07:32:25 +08:00
2015-08-06 22:11:33 +08:00
IMGUI_API void SetActiveID ( ImGuiID id , ImGuiWindow * window ) ;
2017-10-13 22:48:14 +08:00
IMGUI_API ImGuiID GetActiveID ( ) ;
2017-10-13 19:23:21 +08:00
IMGUI_API void SetFocusID ( ImGuiID id , ImGuiWindow * window ) ;
2017-08-21 00:03:37 +08:00
IMGUI_API void ClearActiveID ( ) ;
2015-10-07 01:27:24 +08:00
IMGUI_API void SetHoveredID ( ImGuiID id ) ;
2017-10-13 22:48:14 +08:00
IMGUI_API ImGuiID GetHoveredID ( ) ;
2015-08-06 22:11:33 +08:00
IMGUI_API void KeepAliveID ( ImGuiID id ) ;
2015-08-02 11:57:24 +08:00
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 ) ;
2017-10-07 05:27:29 +08:00
IMGUI_API bool ItemAdd ( const ImRect & bb , ImGuiID id , const ImRect * nav_bb = NULL ) ;
2017-09-28 06:21:47 +08:00
IMGUI_API bool ItemHoverable ( const ImRect & bb , ImGuiID id ) ;
2017-10-07 05:23:18 +08:00
IMGUI_API bool IsClippedEx ( const ImRect & bb , ImGuiID id , bool clip_even_when_logged ) ;
2016-07-20 06:02:59 +08:00
IMGUI_API bool FocusableItemRegister ( ImGuiWindow * window , ImGuiID id , bool tab_stop = true ) ; // Return true if focus is requested
2015-08-02 11:57:24 +08:00
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 ) ;
2017-09-26 04:45:10 +08:00
IMGUI_API void PushMultiItemsWidths ( int components , float width_full = 0.0f ) ;
2016-08-08 02:05:24 +08:00
IMGUI_API void PushItemFlag ( ImGuiItemFlags option , bool enabled ) ;
IMGUI_API void PopItemFlag ( ) ;
2015-08-02 11:57:24 +08:00
2018-01-13 03:07:01 +08:00
IMGUI_API void SetCurrentFont ( ImFont * font ) ;
2018-01-07 23:20:02 +08:00
IMGUI_API void OpenPopupEx ( ImGuiID id ) ;
2017-09-25 18:52:06 +08:00
IMGUI_API void ClosePopup ( ImGuiID id ) ;
2017-08-16 13:42:41 +08:00
IMGUI_API bool IsPopupOpen ( ImGuiID id ) ;
2017-09-25 18:52:06 +08:00
IMGUI_API bool BeginPopupEx ( ImGuiID id , ImGuiWindowFlags extra_flags ) ;
2017-10-27 22:21:12 +08:00
IMGUI_API void BeginTooltipEx ( ImGuiWindowFlags extra_flags , bool override_previous_tooltip = true ) ;
2015-12-21 06:39:47 +08:00
2017-11-24 23:50:11 +08:00
IMGUI_API void NavInitWindow ( ImGuiWindow * window , bool force_reinit ) ;
2018-01-13 02:28:37 +08:00
IMGUI_API void ActivateItem ( ImGuiID id ) ; // Remotely activate a button, checkbox, tree node etc. given its unique ID. activation is queued and processed on the next frame when the item is encountered again.
2017-11-24 23:50:11 +08:00
2018-01-24 23:37:20 +08:00
IMGUI_API float GetNavInputAmount ( ImGuiNavInput n , ImGuiInputReadMode mode ) ;
IMGUI_API ImVec2 GetNavInputAmount2d ( ImGuiNavDirSourceFlags dir_sources , ImGuiInputReadMode mode , float slow_factor = 0.0f , float fast_factor = 0.0f ) ;
2016-08-04 05:23:04 +08:00
IMGUI_API int CalcTypematicPressedRepeatAmount ( float t , float t_prev , float repeat_delay , float repeat_rate ) ;
2016-07-20 06:02:59 +08:00
2017-10-13 19:29:42 +08:00
IMGUI_API void Scrollbar ( ImGuiLayoutType direction ) ;
2017-09-28 22:41:01 +08:00
IMGUI_API void VerticalSeparator ( ) ; // Vertical separator, for menu bars (use current line height). not exposed because it is misleading what it doesn't have an effect on regular layout.
2017-11-21 02:39:27 +08:00
IMGUI_API bool SplitterBehavior ( ImGuiID id , const ImRect & bb , ImGuiAxis axis , float * size1 , float * size2 , float min_size1 , float min_size2 , float hover_extend = 0.0f ) ;
2017-09-28 22:41:01 +08:00
2017-11-10 20:13:28 +08:00
IMGUI_API bool BeginDragDropTargetCustom ( const ImRect & bb , ImGuiID id ) ;
2017-12-13 06:37:27 +08:00
IMGUI_API void ClearDragDrop ( ) ;
IMGUI_API bool IsDragDropPayloadBeingAccepted ( ) ;
2017-11-10 20:13:28 +08:00
2017-09-02 04:10:13 +08:00
// FIXME-WIP: New Columns API
2017-12-14 01:37:58 +08:00
IMGUI_API void BeginColumns ( const char * str_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
2017-08-20 23:09:43 +08:00
IMGUI_API void PushColumnClipRect ( int column_index = - 1 ) ;
2017-08-20 18:44:48 +08:00
2017-07-30 16:16:06 +08:00
// 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.
2015-08-02 11:57:24 +08:00
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 ) ;
2016-09-25 18:53:13 +08:00
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 ) ;
2015-08-02 11:57:24 +08:00
IMGUI_API void RenderFrame ( ImVec2 p_min , ImVec2 p_max , ImU32 fill_col , bool border = true , float rounding = 0.0f ) ;
2017-07-22 19:37:13 +08:00
IMGUI_API void RenderFrameBorder ( ImVec2 p_min , ImVec2 p_max , float rounding = 0.0f ) ;
2017-07-27 16:26:32 +08:00
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 ) ;
2017-10-19 05:46:16 +08:00
IMGUI_API void RenderTriangle ( ImVec2 pos , ImGuiDir dir , float scale = 1.0f ) ;
2016-05-02 02:19:28 +08:00
IMGUI_API void RenderBullet ( ImVec2 pos ) ;
2017-10-18 19:06:49 +08:00
IMGUI_API void RenderCheckMark ( ImVec2 pos , ImU32 col , float sz ) ;
2017-10-04 04:54:19 +08:00
IMGUI_API void RenderNavHighlight ( const ImRect & bb , ImGuiID id , ImGuiNavHighlightFlags flags = ImGuiNavHighlightFlags_TypeDefault ) ; // Navigation highlight
2017-08-29 15:22:30 +08:00
IMGUI_API void RenderRectFilledRangeH ( ImDrawList * draw_list , const ImRect & rect , ImU32 col , float x_start_norm , float x_end_norm , float rounding ) ;
2016-03-22 03:40:02 +08:00
IMGUI_API const char * FindRenderedTextEnd ( const char * text , const char * text_end = NULL ) ; // Find the optional ## from which we stop displaying text.
2015-08-02 11:57:24 +08:00
2015-10-30 18:36:51 +08:00
IMGUI_API bool ButtonBehavior ( const ImRect & bb , ImGuiID id , bool * out_hovered , bool * out_held , ImGuiButtonFlags flags = 0 ) ;
2015-08-02 11:57:24 +08:00
IMGUI_API bool ButtonEx ( const char * label , const ImVec2 & size_arg = ImVec2 ( 0 , 0 ) , ImGuiButtonFlags flags = 0 ) ;
2016-04-21 15:55:02 +08:00
IMGUI_API bool CloseButton ( ImGuiID id , const ImVec2 & pos , float radius ) ;
2017-11-11 23:58:43 +08:00
IMGUI_API bool ArrowButton ( ImGuiID id , ImGuiDir dir , ImVec2 padding , ImGuiButtonFlags flags = 0 ) ;
2015-08-02 11:57:24 +08:00
2015-10-30 18:43:23 +08:00
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 ) ;
2015-08-02 11:57:24 +08:00
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 ) ;
2015-08-06 06:57:31 +08:00
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 ) ;
2015-08-02 11:57:24 +08:00
2017-09-27 17:39:13 +08:00
IMGUI_API void ColorTooltip ( const char * text , const float * col , ImGuiColorEditFlags flags ) ;
IMGUI_API void ColorEditOptionsPopup ( const float * col , ImGuiColorEditFlags flags ) ;
2017-07-22 18:01:16 +08:00
2016-05-01 20:34:55 +08:00
IMGUI_API bool TreeNodeBehavior ( ImGuiID id , ImGuiTreeNodeFlags flags , const char * label , const char * label_end = NULL ) ;
2016-05-02 18:32:16 +08:00
IMGUI_API bool TreeNodeBehaviorIsOpen ( ImGuiID id , ImGuiTreeNodeFlags flags = 0 ) ; // Consume previous SetNextTreeNodeOpened() data, if any. May return true when logging
2016-05-01 20:34:55 +08:00
IMGUI_API void TreePushRawID ( ImGuiID id ) ;
2015-08-30 01:13:30 +08:00
2015-08-02 11:57:24 +08:00
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 ) ;
2017-10-20 01:33:03 +08:00
// Shade functions
IMGUI_API void ShadeVertsLinearColorGradientKeepAlpha ( ImDrawVert * vert_start , ImDrawVert * vert_end , ImVec2 gradient_p0 , ImVec2 gradient_p1 , ImU32 col0 , ImU32 col1 ) ;
IMGUI_API void ShadeVertsLinearAlphaGradientForLeftToRightText ( ImDrawVert * vert_start , ImDrawVert * vert_end , float gradient_p0_x , float gradient_p1_x ) ;
2017-11-20 04:00:38 +08:00
IMGUI_API void ShadeVertsLinearUV ( ImDrawVert * vert_start , ImDrawVert * vert_end , const ImVec2 & a , const ImVec2 & b , const ImVec2 & uv_a , const ImVec2 & uv_b , bool clamp ) ;
2017-10-20 01:33:03 +08:00
2016-05-30 01:14:19 +08:00
} // namespace ImGui
2017-08-17 21:13:14 +08:00
// ImFontAtlas internals
2017-08-17 21:19:54 +08:00
IMGUI_API bool ImFontAtlasBuildWithStbTruetype ( ImFontAtlas * atlas ) ;
2017-08-17 20:44:44 +08:00
IMGUI_API void ImFontAtlasBuildRegisterDefaultCustomRects ( ImFontAtlas * atlas ) ;
2017-08-17 21:13:14 +08:00
IMGUI_API void ImFontAtlasBuildSetupFont ( ImFontAtlas * atlas , ImFont * font , ImFontConfig * font_config , float ascent , float descent ) ;
2017-08-17 20:44:44 +08:00
IMGUI_API void ImFontAtlasBuildPackCustomRects ( ImFontAtlas * atlas , void * spc ) ;
2017-09-27 01:26:16 +08:00
IMGUI_API void ImFontAtlasBuildFinish ( ImFontAtlas * atlas ) ;
2017-08-26 14:11:56 +08:00
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 ) ;
2017-08-17 20:44:44 +08:00
2016-05-30 01:14:19 +08:00
# ifdef __clang__
# pragma clang diagnostic pop
# endif
2015-08-02 11:57:24 +08:00
2015-09-22 06:53:51 +08:00
# ifdef _MSC_VER
# pragma warning (pop)
# endif