2018-04-09 20:02:32 +08:00
// dear imgui, v1.61 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_
2018-02-06 20:34:41 +08:00
typedef int ImGuiItemStatusFlags ; // flags: storage for DC.LastItemXXX // enum ImGuiItemStatusFlags_
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
2018-03-01 04:45:02 +08:00
# ifdef _WIN32
# define IM_NEWLINE "\r\n" // Play it nice with Windows users (2018: Notepad _still_ doesn't display files properly when they use Unix-style carriage returns)
# else
# define IM_NEWLINE "\n"
# endif
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 ) ;
2018-04-07 16:38:01 +08:00
static inline bool ImCharIsSpace ( unsigned 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 ) ;
2018-04-04 02:55:30 +08:00
IMGUI_API const 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
//-----------------------------------------------------------------------------
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
} ;
2018-02-06 20:34:41 +08:00
// Storage for LastItem data
enum ImGuiItemStatusFlags_
{
2018-02-06 20:46:14 +08:00
ImGuiItemStatusFlags_HoveredRect = 1 < < 0 ,
ImGuiItemStatusFlags_HasDisplayRect = 1 < < 1
2018-02-06 20:34:41 +08:00
} ;
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 ,
2018-03-23 01:58:40 +08:00
ImGuiDataType_Double ,
ImGuiDataType_COUNT
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 ,
2018-01-26 02:34:08 +08:00
ImGuiInputSource_NavKeyboard , // Only used occasionally for storage, not tested/handled by most code
ImGuiInputSource_NavGamepad , // "
2018-03-23 01:58:40 +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-10-04 04:54:19 +08:00
enum ImGuiNavHighlightFlags_
{
ImGuiNavHighlightFlags_TypeDefault = 1 < < 0 ,
ImGuiNavHighlightFlags_TypeThin = 1 < < 1 ,
2018-02-02 05:25:25 +08:00
ImGuiNavHighlightFlags_AlwaysDraw = 1 < < 2 ,
ImGuiNavHighlightFlags_NoRounding = 1 < < 3
2017-10-04 04:54:19 +08:00
} ;
2018-01-24 23:37:20 +08:00
enum ImGuiNavDirSourceFlags_
{
2018-01-26 02:34:08 +08:00
ImGuiNavDirSourceFlags_Keyboard = 1 < < 0 ,
ImGuiNavDirSourceFlags_PadDPad = 1 < < 1 ,
ImGuiNavDirSourceFlags_PadLStick = 1 < < 2
2018-01-24 23:37:20 +08:00
} ;
2018-01-30 00:35:36 +08:00
enum ImGuiNavForward
{
ImGuiNavForward_None ,
2018-01-30 01:12:32 +08:00
ImGuiNavForward_ForwardQueued ,
ImGuiNavForward_ForwardActive
2018-01-30 00:35:36 +08:00
} ;
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
2018-01-25 21:24:57 +08:00
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 ; }
2017-12-30 01:28:04 +08:00
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 ; }
2018-02-28 06:07:45 +08:00
void Translate ( const ImVec2 & d ) { Min . x + = d . x ; Min . y + = d . y ; Max . x + = d . x ; Max . y + = d . y ; }
void Translate ( float dx , float dy ) { Min . x + = dx ; Min . y + = dy ; Max . x + = dx ; Max . y + = dy ; }
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 ) ; }
2018-02-05 01:30:37 +08:00
bool IsInverted ( ) const { return Min . x > Max . x | | Min . y > Max . y ; }
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 ;
2018-04-21 03:29:16 +08:00
ImVec2 Pos ; // NB: Settings position are stored RELATIVE to the viewport! Whereas runtime ones are absolute positions.
2015-11-30 06:01:26 +08:00
ImVec2 Size ;
2018-04-21 03:29:16 +08:00
ImVec2 ViewportPos ;
2018-02-28 06:07:45 +08:00
ImGuiID ViewportId ;
2015-11-30 06:01:26 +08:00
bool Collapsed ;
2017-11-28 07:32:25 +08:00
2018-04-21 03:29:16 +08:00
ImGuiWindowSettings ( ) { Name = NULL ; Id = ViewportId = 0 ; Pos = Size = ViewportPos = 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)
2018-02-28 05:32:45 +08:00
void * ( * ReadOpenFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , const char * name ) ; // Read: Called when entering into a new ini entry e.g. "[Window][Name]"
void ( * ReadCloseFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , void * entry ) ; // Read: Called when closing an existing entry, so code can validate overall data. [Optional]
void ( * ReadLineFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , void * entry , const char * line ) ; // Read: Called for every line of text within an ini entry
void ( * WriteAllFn ) ( ImGuiContext * ctx , ImGuiSettingsHandler * handler , ImGuiTextBuffer * out_buf ) ; // Write: Output every entries into 'out_buf'
2017-12-16 03:59:00 +08:00
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 ;
2018-03-12 18:03:27 +08:00
float LineMinY , LineMaxY ;
float StartPosY ; // Copy of CursorPos
float StartMaxPosX ; // Copy of CursorMaxPos
2017-12-14 01:42:06 +08:00
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 ;
2018-03-12 18:03:27 +08:00
LineMinY = LineMaxY = 0.0f ;
2017-12-14 01:42:06 +08:00
StartPosY = 0.0f ;
StartMaxPosX = 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 ( ) ; }
2018-03-15 00:50:11 +08:00
int GetDrawListCount ( ) const { int count = 0 ; for ( int n = 0 ; n < IM_ARRAYSIZE ( Layers ) ; n + + ) count + = Layers [ n ] . Size ; return count ; }
2018-01-16 00:48:07 +08:00
IMGUI_API void FlattenIntoSingleLayer ( ) ;
} ;
2018-03-19 01:44:57 +08:00
enum ImGuiViewportFlagsPrivate_
2018-02-28 06:07:45 +08:00
{
2018-03-19 01:44:57 +08:00
ImGuiViewportFlags_CanHostOtherWindows = 1 < < 10 , // Normal viewports are associated to a single window. The main viewport can host multiple windows.
2018-02-28 06:07:45 +08:00
} ;
2018-03-19 01:44:57 +08:00
// ImGuiViewport Private/Internals fields (cardinal sin: we are using inheritance!)
struct ImGuiViewportP : public ImGuiViewport
2018-02-28 06:07:45 +08:00
{
int Idx ;
2018-03-19 01:44:57 +08:00
int LastFrameActive ; // Last frame number this viewport was activated by a window
int LastFrameAsRefViewport ; // Last frame number this viewport was io.MouseViewportRef
2018-04-11 19:04:29 +08:00
int LastFrameOverlayDrawList ;
2018-03-09 03:10:40 +08:00
ImGuiID LastNameHash ;
2018-04-21 03:29:16 +08:00
ImVec2 LastPos ;
2018-04-05 23:06:23 +08:00
float Alpha ; // Window opacity (when dragging dockable windows/viewports we make them transparent)
float LastAlpha ;
2018-04-25 16:54:38 +08:00
int PlatformMonitor ;
2018-03-09 03:10:40 +08:00
ImGuiWindow * Window ;
2018-03-23 05:09:42 +08:00
ImDrawList * OverlayDrawList ; // For convenience, a draw list we can render to that's always rendered last (we use it to draw software mouse cursor when io.MouseDrawCursor is set)
2018-03-19 01:44:57 +08:00
ImDrawData DrawDataP ;
2018-02-28 06:07:45 +08:00
ImDrawDataBuilder DrawDataBuilder ;
2018-03-15 17:54:27 +08:00
ImVec2 RendererLastSize ;
2018-02-28 06:07:45 +08:00
2018-04-25 16:54:38 +08:00
ImGuiViewportP ( ) { Idx = 1 ; LastFrameActive = LastFrameAsRefViewport = LastFrameOverlayDrawList = - 1 ; LastNameHash = 0 ; Alpha = LastAlpha = 1.0f ; PlatformMonitor = - 1 ; Window = NULL ; OverlayDrawList = NULL ; RendererLastSize = ImVec2 ( - 1.0f , - 1.0f ) ; }
2018-04-11 19:04:29 +08:00
~ ImGuiViewportP ( ) { if ( OverlayDrawList ) IM_DELETE ( OverlayDrawList ) ; }
2018-03-19 01:44:57 +08:00
ImRect GetRect ( ) const { return ImRect ( Pos . x , Pos . y , Pos . x + Size . x , Pos . y + Size . y ) ; }
2018-04-16 23:14:10 +08:00
ImVec2 GetCenter ( ) const { return ImVec2 ( Pos . x + Size . x * 0.5f , Pos . y + Size . y * 0.5f ) ; }
2018-02-28 06:07:45 +08:00
} ;
2018-01-30 01:28:46 +08:00
struct ImGuiNavMoveResult
{
ImGuiID ID ; // Best candidate
ImGuiID ParentID ; // Best candidate window->IDStack.back() - to compare context
ImGuiWindow * Window ; // Best candidate window
float DistBox ; // Best candidate box distance to current NavId
float DistCenter ; // Best candidate center distance to current NavId
2018-01-30 05:15:55 +08:00
float DistAxial ;
2018-01-30 01:28:46 +08:00
ImRect RectRel ; // Best candidate bounding box in window relative space
2018-01-30 06:06:55 +08:00
ImGuiNavMoveResult ( ) { Clear ( ) ; }
void Clear ( ) { ID = ParentID = 0 ; Window = NULL ; DistBox = DistCenter = DistAxial = FLT_MAX ; RectRel = ImRect ( ) ; }
2018-01-30 01:28:46 +08:00
} ;
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-02-28 06:07:45 +08:00
ImGuiCond ViewportCond ;
2018-01-03 19:12:41 +08:00
ImVec2 PosVal ;
ImVec2 PosPivotVal ;
ImVec2 SizeVal ;
ImVec2 ContentSizeVal ;
bool CollapsedVal ;
2018-02-28 05:38:10 +08:00
ImRect SizeConstraintRect ;
2018-01-03 19:31:56 +08:00
ImGuiSizeCallback SizeCallback ;
void * SizeCallbackUserData ;
2018-01-24 02:13:49 +08:00
float BgAlphaVal ;
2018-02-28 06:07:45 +08:00
ImGuiID ViewportId ;
2018-04-18 21:38:04 +08:00
ImVec2 MenuBarOffsetMinVal ; // This is not exposed publicly, so we don't clear it.
2018-01-03 19:12:41 +08:00
ImGuiNextWindowData ( )
{
2018-02-28 06:07:45 +08:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = ViewportCond = 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-02-28 06:07:45 +08:00
ViewportId = 0 ;
2018-04-18 21:38:04 +08:00
MenuBarOffsetMinVal = ImVec2 ( 0.0f , 0.0f ) ;
2018-01-03 19:12:41 +08:00
}
2018-01-03 19:28:16 +08:00
void Clear ( )
{
2018-02-28 06:07:45 +08:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = ViewportCond = 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 ;
Reorganized context handling to be more explicit,
- YOU NOW NEED TO CALL ImGui::CreateContext() AT THE BEGINNING OF YOUR APP, AND CALL ImGui::DestroyContext() AT THE END.
- removed Shutdown() function, as DestroyContext() serve this purpose.
- you may pass a ImFontAtlas* pointer to CreateContext() to share a font atlas between contexts. Otherwhise CreateContext() will create its own font atlas instance.
- removed allocator parameters from CreateContext(), they are now setup with SetAllocatorFunctions(), and shared by all contexts.
- removed the default global context and font atlas instance, which were confusing for users of DLL reloading and users of multiple contexts
(#1565, #586, #992, #1007, #1558)
2018-01-22 02:58:32 +08:00
bool FontAtlasOwnedByContext ; // Io.Fonts-> is owned by the ImGuiContext and will be destructed along with it.
2015-07-22 07:00:28 +08:00
ImGuiIO IO ;
2018-03-19 01:44:57 +08:00
ImGuiPlatformIO PlatformIO ;
2015-07-22 07:00:28 +08:00
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 ;
2018-03-19 01:44:57 +08:00
int FrameCountPlatformEnded ;
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
2018-02-28 06:07:45 +08:00
// Viewports
2018-04-16 23:14:10 +08:00
ImVector < ImGuiViewportP * > Viewports ; // Active viewports (always 1+, and generally 1 unless multi-viewports are enabled). Each viewports hold their copy of ImDrawData.
2018-03-23 05:09:42 +08:00
ImGuiViewportP * CurrentViewport ; // We track changes of viewport (happening in Begin) so we can call Platform_OnChangedViewport()
2018-04-16 23:14:10 +08:00
ImGuiViewportP * MouseRefViewport ;
ImGuiViewportP * MouseRefPrevViewport ;
ImGuiViewportP * MouseHoveredLastViewport ; // Last viewport that was hovered by mouse (even if we are not hovering any viewport any more)
2018-04-13 01:56:14 +08:00
ImGuiID MouseClickedPosViewportId [ 5 ] ; // For rarely used fields we only compare to, store viewport ID only so we don't have to clean dangling pointers
2018-02-28 06:07:45 +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
2018-02-07 02:23:12 +08:00
ImGuiID NavActivateId ; // ~~ (g.ActiveId == 0) && IsNavInputPressed(ImGuiNavInput_Activate) ? NavId : 0, also set when calling ActivateItem()
ImGuiID NavActivateDownId ; // ~~ IsNavInputDown(ImGuiNavInput_Activate) ? NavId : 0
ImGuiID NavActivatePressedId ; // ~~ IsNavInputPressed(ImGuiNavInput_Activate) ? NavId : 0
ImGuiID NavInputId ; // ~~ IsNavInputPressed(ImGuiNavInput_Input) ? NavId : 0
2017-10-04 02:22:38 +08:00
ImGuiID NavJustTabbedId ; // Just tabbed to this id.
2017-10-14 04:33:06 +08:00
ImGuiID NavJustMovedToId ; // Just navigated to this id (result of a successfully MoveRequest)
2018-03-19 19:13:22 +08:00
ImGuiID NavNextActivateId ; // Set by ActivateItem(), queued until next frame
ImGuiInputSource NavInputSource ; // Keyboard or Gamepad mode?
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-02-06 00:02:30 +08:00
int NavScoringCount ; // Metrics for debugging
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.
2018-01-26 02:03:47 +08:00
float NavWindowingHighlightTimer ;
float NavWindowingHighlightAlpha ;
2016-07-24 20:56:14 +08:00
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
2018-03-21 03:12:34 +08:00
bool NavMousePosDirty ; // When set we will update mouse position if (io.ConfigFlags & ImGuiConfigFlags_NavEnableSetMousePos) if set (NB: this not enabled by default)
2018-03-01 01:51:40 +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)
2016-08-21 05:27:25 +08:00
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
2018-02-06 06:53:40 +08:00
bool NavInitRequestFromMove ;
2017-10-07 06:54:29 +08:00
ImGuiID NavInitResultId ;
ImRect NavInitResultRectRel ;
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
2018-01-30 01:12:32 +08:00
ImGuiNavForward NavMoveRequestForward ; // None / ForwardQueued / ForwardActive (this is used to navigate sibling parent menus from a child menu)
2018-02-06 20:16:44 +08:00
ImGuiDir NavMoveDir , NavMoveDirLast ; // Direction of the move request (left/right/up/down), direction of the previous move request
2018-01-30 06:06:55 +08:00
ImGuiNavMoveResult NavMoveResultLocal ; // Best move request candidate within NavWindow
ImGuiNavMoveResult NavMoveResultOther ; // Best move request candidate within NavWindow's flattened hierarchy (when using the NavFlattened flag)
2016-07-20 06:02:59 +08:00
2015-07-22 07:00:28 +08:00
// Render
float ModalWindowDarkeningRatio ;
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
2018-03-08 17:42:51 +08:00
unsigned char DragDropPayloadBufLocal [ 8 ] ; // Local buffer for small payloads
2017-10-30 04:15:02 +08:00
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
2018-04-24 18:40:38 +08:00
// Platform support
ImVec2 PlatformImePos , PlatformImeLastPos ; // Cursor position request & last passed to the OS Input Method Editor
ImGuiViewport * PlatformImePosViewport ;
2015-07-22 07:00:28 +08:00
2017-11-28 06:55:42 +08:00
// Settings
2018-02-19 06:25:48 +08:00
bool SettingsLoaded ;
2017-11-28 06:55:42 +08:00
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
2018-04-16 23:14:10 +08:00
float FramerateSecPerFrame [ 120 ] ; // Calculate estimate of framerate for user over the last 2 seconds.
2015-07-22 07:00:28 +08:00
int FramerateSecPerFrameIdx ;
float FramerateSecPerFrameAccum ;
2018-04-16 23:14:10 +08:00
int WantCaptureMouseNextFrame ; // Explicit capture via CaptureKeyboardFromApp()/CaptureMouseFromApp() sets those flags
2017-09-06 23:20:54 +08:00
int WantCaptureKeyboardNextFrame ;
2017-09-06 23:25:36 +08:00
int WantTextInputNextFrame ;
2018-04-16 23:14:10 +08:00
char TempBuffer [ 1024 * 3 + 1 ] ; // Temporary text buffer
2015-07-22 07:00:28 +08:00
2018-03-23 05:09:42 +08:00
ImGuiContext ( ImFontAtlas * shared_font_atlas )
2015-07-22 07:00:28 +08:00
{
Initialized = false ;
Font = NULL ;
FontSize = FontBaseSize = 0.0f ;
Reorganized context handling to be more explicit,
- YOU NOW NEED TO CALL ImGui::CreateContext() AT THE BEGINNING OF YOUR APP, AND CALL ImGui::DestroyContext() AT THE END.
- removed Shutdown() function, as DestroyContext() serve this purpose.
- you may pass a ImFontAtlas* pointer to CreateContext() to share a font atlas between contexts. Otherwhise CreateContext() will create its own font atlas instance.
- removed allocator parameters from CreateContext(), they are now setup with SetAllocatorFunctions(), and shared by all contexts.
- removed the default global context and font atlas instance, which were confusing for users of DLL reloading and users of multiple contexts
(#1565, #586, #992, #1007, #1558)
2018-01-22 02:58:32 +08:00
FontAtlasOwnedByContext = shared_font_atlas ? false : true ;
IO . Fonts = shared_font_atlas ? shared_font_atlas : IM_NEW ( ImFontAtlas ) ( ) ;
2015-07-22 07:00:28 +08:00
Time = 0.0f ;
FrameCount = 0 ;
2018-03-19 01:44:57 +08:00
FrameCountEnded = FrameCountPlatformEnded = 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
2018-03-06 05:31:12 +08:00
CurrentViewport = NULL ;
2018-04-16 23:14:10 +08:00
MouseRefViewport = NULL ;
MouseRefPrevViewport = MouseHoveredLastViewport = NULL ;
2018-04-13 01:56:14 +08:00
memset ( MouseClickedPosViewportId , 0 , sizeof ( MouseClickedPosViewportId ) ) ;
2018-02-28 06:07:45 +08:00
2016-07-31 19:38:57 +08:00
NavWindow = NULL ;
2018-02-06 02:07:26 +08:00
NavId = NavActivateId = NavActivateDownId = NavActivatePressedId = NavInputId = 0 ;
2017-10-14 04:33:06 +08:00
NavJustTabbedId = NavJustMovedToId = NavNextActivateId = 0 ;
2018-03-19 19:13:22 +08:00
NavInputSource = ImGuiInputSource_None ;
2017-09-30 01:26:03 +08:00
NavScoringRectScreen = ImRect ( ) ;
2018-02-06 00:02:30 +08:00
NavScoringCount = 0 ;
2016-07-20 06:02:59 +08:00
NavWindowingTarget = NULL ;
2018-01-26 02:03:47 +08:00
NavWindowingHighlightTimer = NavWindowingHighlightAlpha = 0.0f ;
2016-07-24 20:56:14 +08:00
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 ;
2018-02-06 06:53:40 +08:00
NavInitRequestFromMove = false ;
2017-10-07 06:54:29 +08:00
NavInitResultId = 0 ;
2017-09-30 04:56:51 +08:00
NavMoveFromClampedRefRect = false ;
2016-07-20 06:02:59 +08:00
NavMoveRequest = false ;
2018-01-30 00:35:36 +08:00
NavMoveRequestForward = ImGuiNavForward_None ;
2017-09-29 05:48:30 +08:00
NavMoveDir = NavMoveDirLast = ImGuiDir_None ;
2016-07-20 06:02:59 +08:00
2018-01-13 02:11:11 +08:00
ModalWindowDarkeningRatio = 0.0f ;
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 ;
2018-04-24 18:40:38 +08:00
PlatformImePos = PlatformImeLastPos = ImVec2 ( FLT_MAX , FLT_MAX ) ;
PlatformImePosViewport = 0 ;
2015-07-22 07:00:28 +08:00
2018-02-19 06:25:48 +08:00
SettingsLoaded = false ;
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().
2018-02-06 20:34:41 +08:00
// This is going to be exposed in imgui.h when stabilized enough.
2016-08-08 02:05:24 +08:00
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 ;
2018-02-25 20:45:47 +08:00
ImU32 TreeDepthMayJumpToParentOnPop ; // Store a copy of !g.NavIdIsAlive for TreeDepth 0..31
2016-06-13 04:27:15 +08:00
ImGuiID LastItemId ;
2018-02-06 20:34:41 +08:00
ImGuiItemStatusFlags LastItemStatusFlags ;
ImRect LastItemRect ; // Interaction rect
2018-02-06 20:46:14 +08:00
ImRect LastItemDisplayRect ; // End-user display rect (only valid if LastItemStatusFlags & ImGuiItemStatusFlags_HasDisplayRect)
2018-02-02 05:28:58 +08:00
bool NavHideHighlightOneFrame ;
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
2018-04-18 21:38:04 +08:00
ImVec2 MenuBarOffset ; // MenuBarOffset.x is sort of equivalent of a per-layer CursorPos.x, saved/restored as we switch to the menu bar. The only situation when MenuBarOffset.y is > 0 if when (SafeAreaPadding.y > FramePadding.y), often used on TVs.
2015-07-22 07:00:28 +08:00
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 ;
2018-02-25 20:45:47 +08:00
TreeDepthMayJumpToParentOnPop = 0x00 ;
2016-06-13 04:27:15 +08:00
LastItemId = 0 ;
2018-02-06 20:34:41 +08:00
LastItemStatusFlags = 0 ;
2018-02-06 20:46:14 +08:00
LastItemRect = LastItemDisplayRect = ImRect ( ) ;
2018-02-02 05:28:58 +08:00
NavHideHighlightOneFrame = 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 ;
2018-04-18 18:46:15 +08:00
MenuBarOffset = ImVec2 ( 0.0f , 0.0f ) ;
2015-07-22 07:00:28 +08:00
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)
2018-02-28 06:07:45 +08:00
ImGuiWindowFlags Flags , FlagsPreviousFrame ; // See enum ImGuiWindowFlags_
2018-03-19 01:44:57 +08:00
ImGuiViewportP * Viewport ; // Always set in Begin(), only inactive windows may have a NULL value here
2018-04-21 03:29:16 +08:00
ImGuiID ViewportId ; // We backup the viewport id (since the viewport may disappear or never be created if the window is inactive)
ImVec2 ViewportPos ; // We backup the viewport position (since the viewport may disappear or never be created if the window is inactive)
int ViewportAllowPlatformMonitorExtend ; // Reset to -1 every frame (index is guaranteed to be valid between NewFrame..EndFrame), only used in the Appearing frame of a tooltip/popup to enforce clamping to a given monitor
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
2016-01-24 19:00:37 +08:00
ImVec2 ScrollbarSizes ;
2018-04-16 16:47:33 +08:00
bool ScrollbarX , ScrollbarY ;
bool ViewportOwned ;
2018-04-19 19:12:02 +08:00
bool ViewportTryMerge ; // Request attempt to merge into a host viewport and destroy our owned viewport
bool ViewportTrySplit ; // Request attempt to split out of a host viewport and create our owned viewport
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 ;
2018-02-28 05:38:10 +08:00
ImGuiCond SetWindowPosAllowFlags ; // store accepted condition flags for SetNextWindowPos() use.
ImGuiCond SetWindowSizeAllowFlags ; // store accepted condition flags for SetNextWindowSize() use.
ImGuiCond SetWindowCollapsedAllowFlags ; // store accepted condition flags for SetNextWindowCollapsed() use.
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
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.
2018-03-05 00:44:17 +08:00
ImRect InnerRect , InnerClipRect ;
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 ;
2018-03-10 02:08:47 +08:00
float FontWindowScale ; // User scale multiplier per-window
float FontDpiScale ;
2018-04-11 18:43:38 +08:00
ImDrawList * DrawList ; // == &DrawListInst (for backward compatibility reason with code using imgui_internal.h we keep this a pointer)
ImDrawList DrawListInst ;
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.
2018-02-09 06:11:51 +08:00
ImGuiWindow * RootWindow ; // Point to ourself or first ancestor that is not a child window.
ImGuiWindow * RootWindowForTitleBarHighlight ; // Point to ourself or first ancestor which will display TitleBgActive color when this window is active.
ImGuiWindow * RootWindowForTabbing ; // Point to ourself or first ancestor which can be CTRL-Tabbed into.
ImGuiWindow * RootWindowForNav ; // Point to ourself or first ancestor which doesn't have the NavFlattened flag.
2018-01-30 05:15:55 +08:00
2018-02-01 07:50:42 +08:00
ImGuiWindow * NavLastChildNavWindow ; // When going to the menu bar, we remember the child window we came from. (This could probably be made implicit if we kept g.Windows sorted by last focused including child window.)
2018-01-30 05:15:55 +08:00
ImGuiID NavLastIds [ 2 ] ; // Last known NavId for this window, per layer (0/1)
ImRect NavRectRel [ 2 ] ; // Reference rectangle, in window relative space
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 ) ; }
2018-03-10 02:08:47 +08:00
float CalcFontSize ( ) const { return GImGui - > FontBaseSize * FontWindowScale * FontDpiScale ; }
2015-07-22 07:00:28 +08:00
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 ( ) ) ) ; }
2018-04-18 18:46:15 +08:00
float MenuBarHeight ( ) const { return ( Flags & ImGuiWindowFlags_MenuBar ) ? DC . MenuBarOffset . y + CalcFontSize ( ) + GImGui - > Style . FramePadding . y * 2.0f : 0.0f ; }
2015-07-22 07:00:28 +08:00
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
{
2018-02-06 20:34:41 +08:00
ImGuiID LastItemId ;
2018-02-06 20:46:14 +08:00
ImGuiItemStatusFlags LastItemStatusFlags ;
2018-02-06 20:34:41 +08:00
ImRect LastItemRect ;
2018-02-06 20:46:14 +08:00
ImRect LastItemDisplayRect ;
2017-10-19 01:51:32 +08:00
2017-12-13 06:36:25 +08:00
ImGuiItemHoveredDataBackup ( ) { Backup ( ) ; }
2018-02-06 20:46:14 +08:00
void Backup ( ) { ImGuiWindow * window = GImGui - > CurrentWindow ; LastItemId = window - > DC . LastItemId ; LastItemStatusFlags = window - > DC . LastItemStatusFlags ; LastItemRect = window - > DC . LastItemRect ; LastItemDisplayRect = window - > DC . LastItemDisplayRect ; }
void Restore ( ) const { ImGuiWindow * window = GImGui - > CurrentWindow ; window - > DC . LastItemId = LastItemId ; window - > DC . LastItemStatusFlags = LastItemStatusFlags ; window - > DC . LastItemRect = LastItemRect ; window - > DC . LastItemDisplayRect = LastItemDisplayRect ; }
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 ) ;
2018-03-09 22:37:16 +08:00
IMGUI_API void FocusWindow ( ImGuiWindow * window ) ; // FIXME: Rename to SetWindowFocus()
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 ) ;
2018-02-01 21:56:56 +08:00
IMGUI_API bool IsWindowNavFocusable ( ImGuiWindow * window ) ;
2015-08-06 22:11:33 +08:00
Reorganized context handling to be more explicit,
- YOU NOW NEED TO CALL ImGui::CreateContext() AT THE BEGINNING OF YOUR APP, AND CALL ImGui::DestroyContext() AT THE END.
- removed Shutdown() function, as DestroyContext() serve this purpose.
- you may pass a ImFontAtlas* pointer to CreateContext() to share a font atlas between contexts. Otherwhise CreateContext() will create its own font atlas instance.
- removed allocator parameters from CreateContext(), they are now setup with SetAllocatorFunctions(), and shared by all contexts.
- removed the default global context and font atlas instance, which were confusing for users of DLL reloading and users of multiple contexts
(#1565, #586, #992, #1007, #1558)
2018-01-22 02:58:32 +08:00
IMGUI_API void Initialize ( ImGuiContext * context ) ;
2018-02-07 03:20:34 +08:00
IMGUI_API void Shutdown ( ImGuiContext * context ) ; // Since 1.60 this is a _private_ function. You can call DestroyContext() to destroy the context created by CreateContext().
2016-04-03 06:47:41 +08:00
2018-04-07 01:29:00 +08:00
IMGUI_API void NewFrameUpdateHoveredWindowAndCaptureFlags ( ) ;
2018-02-28 06:07:45 +08:00
// Viewports
2018-03-19 01:44:57 +08:00
IMGUI_API ImGuiViewportP * FindViewportByID ( ImGuiID id ) ;
2018-02-28 06:07:45 +08:00
IMGUI_API void SetNextWindowViewport ( ImGuiID id ) ;
2018-03-19 01:44:57 +08:00
IMGUI_API void ScaleWindowsInViewport ( ImGuiViewportP * viewport , float scale ) ;
2018-02-28 06:07:45 +08:00
IMGUI_API void ShowViewportThumbnails ( ) ;
2018-03-19 01:44:57 +08:00
// Settings
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-04-11 19:04:29 +08:00
IMGUI_API ImDrawList * GetOverlayDrawList ( ImGuiViewportP * viewport ) ;
inline ImDrawList * GetOverlayDrawList ( ImGuiWindow * window ) { return GetOverlayDrawList ( window - > Viewport ) ; }
2018-01-13 03:07:01 +08:00
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 ) ;
2018-02-02 01:31:41 +08:00
IMGUI_API void ClosePopupsOverWindow ( ImGuiWindow * ref_window ) ;
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 ) ;
2018-04-10 21:04:36 +08:00
IMGUI_API ImGuiWindow * GetFrontMostPopupModal ( ) ;
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-02-22 22:39:49 +08:00
IMGUI_API void NavMoveRequestCancel ( ) ;
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 ) ;
2018-03-04 02:08:22 +08:00
IMGUI_API void RenderArrow ( 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 ) ;
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 ) ;
2018-04-07 00:43:31 +08:00
// Shade functions (write over already created vertices)
2017-10-20 01:33:03 +08:00
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