2017-12-28 14:17:35 +00:00
// dear imgui, v1.54 WIP
2015-12-24 18:56:47 +00:00
// (internals)
2015-07-21 23:00:28 +00:00
2015-12-24 18:56:47 +00: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 12:11:45 +00:00
// Set:
2015-07-31 04:49:10 +00:00
// #define IMGUI_DEFINE_MATH_OPERATORS
2017-11-07 12:11:45 +00: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-21 23:00:28 +00:00
# pragma once
2015-08-10 16:26:39 +00:00
# ifndef IMGUI_VERSION
# error Must include imgui.h before imgui_internal.h
# endif
2015-07-21 23:00:28 +00:00
# include <stdio.h> // FILE*
2016-05-30 22:00:44 +00:00
# include <math.h> // sqrtf, fabsf, fmodf, powf, floorf, ceilf, cosf, sinf
2015-07-21 23:00:28 +00:00
2015-09-21 22:53:51 +00: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-29 17:14:19 +00: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-21 23:00:28 +00:00
//-----------------------------------------------------------------------------
// Forward Declarations
//-----------------------------------------------------------------------------
struct ImRect ;
struct ImGuiColMod ;
struct ImGuiStyleMod ;
struct ImGuiGroupData ;
2018-01-03 13:35:11 +00:00
struct ImGuiMenuColumns ;
2015-07-21 23:00:28 +00:00
struct ImGuiDrawContext ;
struct ImGuiTextEditState ;
struct ImGuiPopupRef ;
struct ImGuiWindow ;
2017-11-28 18:20:50 +00:00
struct ImGuiWindowSettings ;
2015-07-21 23:00:28 +00:00
2017-10-27 13:31:44 +00: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 12:34:41 +00:00
typedef int ImGuiItemStatusFlags ; // flags: storage for DC.LastItemXXX // enum ImGuiItemStatusFlags_
2017-10-27 13:31:44 +00:00
typedef int ImGuiSeparatorFlags ; // flags: for Separator() - internal // enum ImGuiSeparatorFlags_
typedef int ImGuiSliderFlags ; // flags: for SliderBehavior() // enum ImGuiSliderFlags_
2015-07-21 23:00:28 +00:00
//-------------------------------------------------------------------------
2015-07-31 04:49:10 +00:00
// STB libraries
2015-07-21 23:00:28 +00: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-12 16:08:31 +00:00
# ifndef GImGui
extern IMGUI_API ImGuiContext * GImGui ; // Current implicit ImGui context pointer
# endif
2015-07-21 23:00:28 +00:00
//-----------------------------------------------------------------------------
// Helpers
//-----------------------------------------------------------------------------
2017-12-29 16:18:31 +00:00
# define IM_PI 3.14159265358979323846f
2015-07-21 23:00:28 +00:00
// Helpers: UTF-8 <> wchar
2015-09-10 09:22:17 +00: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-21 23:00:28 +00:00
// Helpers: Misc
2015-09-10 09:22:17 +00: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 12:47:16 +00: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 13:11:41 +00:00
IMGUI_API FILE * ImFileOpen ( const char * filename , const char * file_open_mode ) ;
2015-09-10 09:22:17 +00:00
static inline bool ImCharIsSpace ( int c ) { return c = = ' ' | | c = = ' \t ' | | c = = 0x3000 ; }
2016-02-21 22:23:30 +00:00
static inline bool ImIsPowerOfTwo ( int v ) { return v ! = 0 & & ( v & ( v - 1 ) ) = = 0 ; }
2015-09-10 09:22:17 +00: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-21 23:00:28 +00:00
2017-07-31 13:11:41 +00: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-21 23:00:28 +00:00
// Helpers: String
2015-09-10 09:22:17 +00:00
IMGUI_API int ImStricmp ( const char * str1 , const char * str2 ) ;
2017-12-21 12:43:09 +00: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 09:22:17 +00:00
IMGUI_API char * ImStrdup ( const char * str ) ;
2017-11-27 22:55:42 +00:00
IMGUI_API char * ImStrchrRange ( const char * str_begin , const char * str_end , char c ) ;
2015-09-10 09:22:17 +00: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 12:43:09 +00: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-21 23:00:28 +00: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 11:19:31 +00: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-10 23:06:37 +00: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 11:19:31 +00: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-21 23:00:28 +00: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-08 22:59:12 +00: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-21 23:00:28 +00: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-17 21:18:20 +00:00
static inline void ImSwap ( int & a , int & b ) { int tmp = a ; a = b ; b = tmp ; }
2017-08-28 11:27:12 +00:00
static inline void ImSwap ( float & a , float & b ) { float tmp = a ; a = b ; b = tmp ; }
2017-07-26 14:20:43 +00:00
static inline int ImLerp ( int a , int b , float t ) { return ( int ) ( a + ( b - a ) * t ) ; }
2015-07-21 23:00:28 +00:00
static inline float ImLerp ( float a , float b , float t ) { return a + ( b - a ) * t ; }
2017-07-31 10:56:51 +00: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-21 23:00:28 +00: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-19 21:29:27 +00: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-21 23:00:28 +00: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-04-30 16:55:23 +00:00
static inline float ImFloor ( float f ) { return ( float ) ( int ) f ; }
2017-07-31 10:56:51 +00: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-19 17:29:59 +00: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-19 20:00:38 +00:00
static inline ImVec2 ImMul ( const ImVec2 & lhs , const ImVec2 & rhs ) { return ImVec2 ( lhs . x * rhs . x , lhs . y * rhs . y ) ; }
2015-07-21 23:00:28 +00:00
2016-01-25 21:26:53 +00: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 15:24:33 +00: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-23 22:10:26 +00: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-25 21:26:53 +00:00
2015-07-21 23:00:28 +00:00
//-----------------------------------------------------------------------------
2015-07-31 04:49:10 +00:00
// Types
2015-07-21 23:00:28 +00:00
//-----------------------------------------------------------------------------
enum ImGuiButtonFlags_
{
2016-03-02 23:30:08 +00:00
ImGuiButtonFlags_Repeat = 1 < < 0 , // hold to repeat
2017-09-28 17:35:10 +00: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-11 21:39:10 +00:00
ImGuiButtonFlags_FlattenChildren = 1 < < 5 , // allow interactions even if a child window is overlapping
ImGuiButtonFlags_AllowItemOverlap = 1 < < 6 , // require previous frame HoveredId to either match id or be null before being usable, use along with SetItemAllowOverlap()
ImGuiButtonFlags_DontClosePopups = 1 < < 7 , // disable automatically closing parent popup on press // [UNUSED]
ImGuiButtonFlags_Disabled = 1 < < 8 , // disable interactions
2017-12-12 22:36:25 +00: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-11 21:39:10 +00:00
ImGuiButtonFlags_NoKeyModifiers = 1 < < 10 , // disable interaction if a key modifier is held
2017-10-29 23:03:04 +00:00
ImGuiButtonFlags_NoHoldingActiveID = 1 < < 11 , // don't set ActiveId while holding the mouse (ImGuiButtonFlags_PressedOnClick only)
2017-11-01 16:24:17 +00: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)
2015-08-29 17:13:30 +00:00
} ;
2015-10-30 10:43:23 +00:00
enum ImGuiSliderFlags_
{
2015-12-26 13:59:07 +00:00
ImGuiSliderFlags_Vertical = 1 < < 0
2015-10-30 10:43:23 +00:00
} ;
2017-08-20 10:44:48 +00:00
enum ImGuiColumnsFlags_
{
// Default: 0
ImGuiColumnsFlags_NoBorder = 1 < < 0 , // Disable column dividers
2017-08-20 11:32:18 +00: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-16 16:34:34 +00:00
ImGuiColumnsFlags_NoForceWithinWindow = 1 < < 3 , // Disable forcing columns to fit within window
2017-12-13 18:21:21 +00: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 10:44:48 +00:00
} ;
2015-07-21 23:00:28 +00:00
enum ImGuiSelectableFlagsPrivate_
{
// NB: need to be in sync with last value of ImGuiSelectableFlags_
2017-12-12 22:36:25 +00:00
ImGuiSelectableFlags_Menu = 1 < < 3 , // -> PressedOnClick
ImGuiSelectableFlags_MenuItem = 1 < < 4 , // -> PressedOnRelease
2016-01-31 21:08:35 +00:00
ImGuiSelectableFlags_Disabled = 1 < < 5 ,
ImGuiSelectableFlags_DrawFillAvailWidth = 1 < < 6
2015-07-21 23:00:28 +00:00
} ;
2017-09-26 13:43:48 +00: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 12:34:41 +00:00
// Storage for LastItem data
enum ImGuiItemStatusFlags_
{
2018-02-06 12:46:14 +00:00
ImGuiItemStatusFlags_HoveredRect = 1 < < 0 ,
ImGuiItemStatusFlags_HasDisplayRect = 1 < < 1
2018-02-06 12:34:41 +00:00
} ;
2015-07-21 23:00:28 +00:00
// FIXME: this is in development, not exposed/functional as a generic feature yet.
enum ImGuiLayoutType_
{
ImGuiLayoutType_Vertical ,
ImGuiLayoutType_Horizontal
} ;
2017-11-20 18:39:27 +00:00
enum ImGuiAxis
{
ImGuiAxis_None = - 1 ,
ImGuiAxis_X = 0 ,
2017-12-23 13:07:03 +00:00
ImGuiAxis_Y = 1
2017-11-20 18:39:27 +00:00
} ;
2015-08-02 03:57:24 +00:00
enum ImGuiPlotType
{
ImGuiPlotType_Lines ,
ImGuiPlotType_Histogram
} ;
2015-08-05 22:57:31 +00:00
enum ImGuiDataType
{
ImGuiDataType_Int ,
2016-09-25 09:06:14 +00:00
ImGuiDataType_Float ,
2017-09-14 03:35:30 +00:00
ImGuiDataType_Float2
2015-08-05 22:57:31 +00:00
} ;
2017-07-30 08:15:52 +00:00
enum ImGuiDir
{
ImGuiDir_None = - 1 ,
ImGuiDir_Left = 0 ,
ImGuiDir_Right = 1 ,
ImGuiDir_Up = 2 ,
2017-12-07 12:26:56 +00:00
ImGuiDir_Down = 3 ,
ImGuiDir_Count_
2017-07-30 08:15:52 +00:00
} ;
2015-07-21 23:00:28 +00:00
// 2D axis aligned bounding-box
2015-08-05 16:00:05 +00:00
// NB: we can't rely on ImVec2 math operators being available here
2015-09-10 09:22:17 +00:00
struct IMGUI_API ImRect
2015-07-21 23:00:28 +00:00
{
2015-11-29 22:01:26 +00:00
ImVec2 Min ; // Upper-left
ImVec2 Max ; // Lower-right
2015-07-21 23:00:28 +00: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-29 17:28:04 +00: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 13:24:57 +00: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-29 17:28:04 +00: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 ; }
void Translate ( const ImVec2 & v ) { Min . x + = v . x ; Min . y + = v . y ; Max . x + = v . x ; Max . y + = v . y ; }
2018-01-08 22:59:51 +00: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-29 17:28:04 +00: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 13:51:28 +00:00
bool IsInverted ( ) const { return Min . x > Max . x | | Min . y > Max . y ; }
2017-12-29 17:28:04 +00:00
bool IsFinite ( ) const { return Min . x ! = FLT_MAX ; }
2015-07-21 23:00:28 +00:00
} ;
// Stacked color modifier, backup of modified data so we can restore it
struct ImGuiColMod
{
2015-11-29 22:01:26 +00:00
ImGuiCol Col ;
2016-09-25 09:06:14 +00:00
ImVec4 BackupValue ;
2015-07-21 23:00:28 +00:00
} ;
2016-09-25 09:06:14 +00:00
// Stacked style modifier, backup of modified data so we can restore it. Data type inferred from the variable.
2015-07-21 23:00:28 +00:00
struct ImGuiStyleMod
{
2016-09-25 09:06:14 +00: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-21 23:00:28 +00:00
} ;
2015-07-31 05:48:59 +00:00
// Stacked data for BeginGroup()/EndGroup()
2015-07-21 23:00:28 +00:00
struct ImGuiGroupData
{
2015-11-29 22:01:26 +00:00
ImVec2 BackupCursorPos ;
ImVec2 BackupCursorMaxPos ;
float BackupIndentX ;
2016-09-13 07:18:17 +00:00
float BackupGroupOffsetX ;
2015-11-29 22:01:26 +00:00
float BackupCurrentLineHeight ;
float BackupCurrentLineTextBaseOffset ;
float BackupLogLinePosY ;
2016-09-25 12:18:10 +00:00
bool BackupActiveIdIsAlive ;
2015-11-29 22:01:26 +00:00
bool AdvanceCursor ;
2015-07-21 23:00:28 +00:00
} ;
2016-05-07 17:54:27 +00: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 13:35:11 +00:00
struct IMGUI_API ImGuiMenuColumns
2015-07-21 23:00:28 +00:00
{
2015-11-29 22:01:26 +00:00
int Count ;
float Spacing ;
float Width , NextWidth ;
2018-01-03 13:35:11 +00:00
float Pos [ 4 ] , NextWidths [ 4 ] ;
2015-07-21 23:00:28 +00:00
2018-01-03 13:35:11 +00:00
ImGuiMenuColumns ( ) ;
2016-05-07 17:54:27 +00:00
void Update ( int count , float spacing , bool clear ) ;
float DeclColumns ( float w0 , float w1 , float w2 ) ;
float CalcExtraSpace ( float avail_w ) ;
2015-07-21 23:00:28 +00:00
} ;
// Internal state of the currently focused/edited text input box
2015-09-10 09:22:17 +00:00
struct IMGUI_API ImGuiTextEditState
2015-07-21 23:00:28 +00:00
{
2015-10-18 14:50:46 +00: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-21 23:00:28 +00:00
ImVector < char > TempTextBuffer ;
2015-10-18 14:50:46 +00: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-21 23:00:28 +00:00
float ScrollX ;
ImGuiStb : : STB_TexteditState StbState ;
float CursorAnim ;
bool CursorFollow ;
bool SelectedAllMouseLock ;
2015-10-18 14:50:46 +00: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 11:15:24 +00:00
void SelectAll ( ) { StbState . select_start = 0 ; StbState . cursor = StbState . select_end = CurLenW ; StbState . has_preferred_x = false ; }
2015-07-21 23:00:28 +00:00
void OnKeyPressed ( int key ) ;
} ;
// Data saved in imgui.ini file
2017-11-28 18:20:50 +00:00
struct ImGuiWindowSettings
2015-07-21 23:00:28 +00:00
{
2015-11-29 22:01:26 +00:00
char * Name ;
2016-06-12 20:27:15 +00:00
ImGuiID Id ;
2015-11-29 22:01:26 +00:00
ImVec2 Pos ;
ImVec2 Size ;
bool Collapsed ;
2017-11-27 23:32:25 +00:00
2017-11-28 18:20:50 +00:00
ImGuiWindowSettings ( ) { Name = NULL ; Id = 0 ; Pos = Size = ImVec2 ( 0 , 0 ) ; Collapsed = false ; }
2015-07-21 23:00:28 +00:00
} ;
2017-11-27 22:55:42 +00:00
struct ImGuiSettingsHandler
{
const char * TypeName ; // Short description stored in .ini file. Disallowed characters: '[' ']'
ImGuiID TypeHash ; // == ImHash(TypeName, 0, 0)
2017-12-15 19:59:00 +00: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 ) ) ; }
2017-11-27 22:55:42 +00:00
} ;
2015-07-21 23:00:28 +00:00
// Storage for current popup stack
struct ImGuiPopupRef
{
2017-12-13 18:21:21 +00: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 15:15:54 +00:00
int OpenFrameCount ; // Set on OpenPopup()
2018-01-07 15:11:25 +00: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-21 23:00:28 +00:00
} ;
2017-12-13 17:37:58 +00:00
struct ImGuiColumnData
{
2017-12-13 20:51:23 +00:00
float OffsetNorm ; // Column start offset, normalized 0.0 (far left) -> 1.0 (far right)
float OffsetNormBeforeResize ;
2017-12-15 14:44:27 +00:00
ImGuiColumnsFlags Flags ; // Not exposed
2017-12-13 18:21:21 +00:00
ImRect ClipRect ;
2017-12-13 18:07:09 +00:00
2017-12-15 14:44:27 +00:00
ImGuiColumnData ( ) { OffsetNorm = OffsetNormBeforeResize = 0.0f ; Flags = 0 ; }
2017-12-13 17:37:58 +00:00
} ;
struct ImGuiColumnsSet
{
2017-12-13 17:42:06 +00:00
ImGuiID ID ;
ImGuiColumnsFlags Flags ;
2017-12-13 18:26:04 +00:00
bool IsFirstFrame ;
bool IsBeingResized ;
2017-12-13 17:42:06 +00:00
int Current ;
int Count ;
float MinX , MaxX ;
float StartPosY ;
float StartMaxPosX ; // Backup of CursorMaxPos
float CellMinY , CellMaxY ;
ImVector < ImGuiColumnData > Columns ;
2017-12-13 17:37:58 +00:00
ImGuiColumnsSet ( ) { Clear ( ) ; }
void Clear ( )
{
2017-12-13 17:42:06 +00:00
ID = 0 ;
Flags = 0 ;
2017-12-13 18:26:04 +00:00
IsFirstFrame = false ;
IsBeingResized = false ;
2017-12-13 17:42:06 +00:00
Current = 0 ;
Count = 1 ;
MinX = MaxX = 0.0f ;
StartPosY = 0.0f ;
StartMaxPosX = 0.0f ;
CellMinY = CellMaxY = 0.0f ;
Columns . clear ( ) ;
2017-12-13 17:37:58 +00:00
}
} ;
2018-01-15 16:29:18 +00:00
struct IMGUI_API ImDrawListSharedData
2017-12-21 17:50:27 +00: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-15 16:48:07 +00:00
struct ImDrawDataBuilder
{
2018-01-15 17:00:13 +00:00
ImVector < ImDrawList * > Layers [ 2 ] ; // Global layers for: regular, tooltip
2018-01-15 16:48:07 +00: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 11:12:41 +00:00
// Storage for SetNexWindow** functions
struct ImGuiNextWindowData
{
ImGuiCond PosCond ;
ImGuiCond SizeCond ;
ImGuiCond ContentSizeCond ;
ImGuiCond CollapsedCond ;
2018-01-03 11:22:02 +00:00
ImGuiCond SizeConstraintCond ;
ImGuiCond FocusCond ;
2018-01-23 18:13:49 +00:00
ImGuiCond BgAlphaCond ;
2018-01-03 11:12:41 +00:00
ImVec2 PosVal ;
ImVec2 PosPivotVal ;
ImVec2 SizeVal ;
ImVec2 ContentSizeVal ;
bool CollapsedVal ;
ImRect SizeConstraintRect ; // Valid if 'SetNextWindowSizeConstraint' is true
2018-01-03 11:31:56 +00:00
ImGuiSizeCallback SizeCallback ;
void * SizeCallbackUserData ;
2018-01-23 18:13:49 +00:00
float BgAlphaVal ;
2018-01-03 11:12:41 +00:00
ImGuiNextWindowData ( )
{
2018-01-23 18:13:49 +00:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = 0 ;
2018-01-03 11:12:41 +00:00
PosVal = PosPivotVal = SizeVal = ImVec2 ( 0.0f , 0.0f ) ;
ContentSizeVal = ImVec2 ( 0.0f , 0.0f ) ;
CollapsedVal = false ;
SizeConstraintRect = ImRect ( ) ;
2018-01-03 11:31:56 +00:00
SizeCallback = NULL ;
SizeCallbackUserData = NULL ;
2018-01-23 18:13:49 +00:00
BgAlphaVal = FLT_MAX ;
2018-01-03 11:12:41 +00:00
}
2018-01-03 11:28:16 +00:00
void Clear ( )
{
2018-01-23 18:13:49 +00:00
PosCond = SizeCond = ContentSizeCond = CollapsedCond = SizeConstraintCond = FocusCond = BgAlphaCond = 0 ;
2018-01-03 11:28:16 +00:00
}
2018-01-03 11:12:41 +00:00
} ;
2015-07-21 23:00:28 +00:00
// Main state for ImGui
2016-05-07 17:55:51 +00:00
struct ImGuiContext
2015-07-21 23:00:28 +00:00
{
bool Initialized ;
ImGuiIO IO ;
ImGuiStyle Style ;
ImFont * Font ; // (Shortcut) == FontStack.empty() ? IO.Font : FontStack.back()
2017-08-22 10:13:10 +00: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-21 17:50:27 +00:00
ImDrawListSharedData DrawListSharedData ;
2015-07-21 23:00:28 +00:00
float Time ;
int FrameCount ;
2015-09-16 22:48:42 +00:00
int FrameCountEnded ;
2015-07-21 23:00:28 +00:00
int FrameCountRendered ;
ImVector < ImGuiWindow * > Windows ;
ImVector < ImGuiWindow * > WindowsSortBuffer ;
ImVector < ImGuiWindow * > CurrentWindowStack ;
2017-11-07 12:59:55 +00:00
ImGuiStorage WindowsById ;
2017-12-12 22:36:25 +00:00
int WindowsActiveCount ;
2017-08-22 10:13:10 +00:00
ImGuiWindow * CurrentWindow ; // Being drawn into
2017-08-22 11:51:12 +00:00
ImGuiWindow * NavWindow ; // Nav/focused window for navigation
2015-07-21 23:00:28 +00:00
ImGuiWindow * HoveredWindow ; // Will catch mouse inputs
ImGuiWindow * HoveredRootWindow ; // Will catch mouse inputs (for focus/move only)
ImGuiID HoveredId ; // Hovered widget
2015-12-03 21:30:17 +00:00
bool HoveredIdAllowOverlap ;
2015-07-21 23:00:28 +00:00
ImGuiID HoveredIdPreviousFrame ;
2017-10-29 22:46:32 +00:00
float HoveredIdTimer ;
2015-07-21 23:00:28 +00:00
ImGuiID ActiveId ; // Active widget
ImGuiID ActiveIdPreviousFrame ;
2017-10-29 22:46:32 +00:00
float ActiveIdTimer ;
2017-08-22 10:13:10 +00:00
bool ActiveIdIsAlive ; // Active widget has been seen this frame
2015-07-21 23:00:28 +00:00
bool ActiveIdIsJustActivated ; // Set at the time of activation for one frame
2017-08-22 10:13:10 +00:00
bool ActiveIdAllowOverlap ; // Active widget allows another widget to steal active id (generally for overlapping widgets, but not always)
2016-05-21 18:50:15 +00:00
ImVec2 ActiveIdClickOffset ; // Clicked offset from upper-left corner, if applicable (currently only set by ButtonBehavior)
2015-07-21 23:00:28 +00:00
ImGuiWindow * ActiveIdWindow ;
2018-01-14 13:13:54 +00: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-21 23:00:28 +00: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 10:32:16 +00:00
ImVector < ImGuiPopupRef > OpenPopupStack ; // Which popups are open (persistent)
2015-07-21 23:00:28 +00:00
ImVector < ImGuiPopupRef > CurrentPopupStack ; // Which level of BeginPopup() we are in (reset every frame)
2018-01-03 11:28:16 +00:00
ImGuiNextWindowData NextWindowData ; // Storage for SetNextWindow** functions
2018-01-03 11:12:41 +00:00
bool NextTreeNodeOpenVal ; // Storage for SetNextTreeNode** functions
ImGuiCond NextTreeNodeOpenCond ;
2015-07-21 23:00:28 +00:00
// Render
2018-01-15 16:25:11 +00:00
ImDrawData DrawData ; // Main ImDrawData instance to pass render information to the user
2018-01-15 16:48:07 +00:00
ImDrawDataBuilder DrawDataBuilder ;
2015-07-21 23:00:28 +00:00
float ModalWindowDarkeningRatio ;
ImDrawList OverlayDrawList ; // Optional software render of mouse cursors, if io.MouseDrawCursor is set + a few debug overlays
ImGuiMouseCursor MouseCursor ;
2017-10-29 20:15:02 +00:00
// Drag and Drop
bool DragDropActive ;
ImGuiDragDropFlags DragDropSourceFlags ;
int DragDropMouseButton ;
ImGuiPayload DragDropPayload ;
2017-11-10 12:13:28 +00:00
ImRect DragDropTargetRect ;
ImGuiID DragDropTargetId ;
2017-11-08 14:47:52 +00:00
float DragDropAcceptIdCurrRectSurface ;
2017-11-06 19:02:56 +00: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-29 20:15:02 +00:00
ImVector < unsigned char > DragDropPayloadBufHeap ; // We don't expose the ImVector<> directly
unsigned char DragDropPayloadBufLocal [ 8 ] ;
2015-07-21 23:00:28 +00:00
// Widget state
ImGuiTextEditState InputTextState ;
2015-11-19 22:09:59 +00:00
ImFont InputTextPasswordFont ;
2015-07-21 23:00:28 +00:00
ImGuiID ScalarAsInputTextId ; // Temporary text input when CTRL+clicking on a slider, etc.
2017-08-08 07:54:20 +00:00
ImGuiColorEditFlags ColorEditOptions ; // Store user options for color edit widgets
2017-07-29 07:54:45 +00:00
ImVec4 ColorPickerRef ;
2015-08-05 16:00:05 +00:00
float DragCurrentValue ; // Currently dragged value, always float, not rounded by end-user precision settings
2015-07-21 23:00:28 +00:00
ImVec2 DragLastMouseDelta ;
2015-08-05 16:00:05 +00:00
float DragSpeedDefaultRatio ; // If speed == 0.0f, uses (max-min) * DragSpeedDefaultRatio
2015-07-21 23:00:28 +00:00
float DragSpeedScaleSlow ;
float DragSpeedScaleFast ;
2016-05-07 16:10:32 +00:00
ImVec2 ScrollbarClickDeltaToGrabCenter ; // Distance between mouse and center of grab box, normalized in parent space. Use storage?
2017-07-20 18:21:48 +00:00
int TooltipOverrideCount ;
2016-07-30 08:02:46 +00:00
ImVector < char > PrivateClipboard ; // If no custom clipboard handler is defined
2015-11-29 14:15:07 +00:00
ImVec2 OsImePosRequest , OsImePosSet ; // Cursor position request & last passed to the OS Input Method Editor
2015-07-21 23:00:28 +00:00
2017-11-27 22:55:42 +00:00
// Settings
float SettingsDirtyTimer ; // Save .ini Settings on disk when time reaches zero
2017-11-28 18:20:50 +00:00
ImVector < ImGuiWindowSettings > SettingsWindows ; // .ini settings for ImGuiWindow
2017-11-27 22:55:42 +00:00
ImVector < ImGuiSettingsHandler > SettingsHandlers ; // List of .ini settings handlers
2015-07-21 23:00:28 +00:00
// Logging
bool LogEnabled ;
2015-08-24 11:50:18 +00:00
FILE * LogFile ; // If != NULL log to stdout/ file
2015-08-05 16:00:05 +00:00
ImGuiTextBuffer * LogClipboard ; // Else log to clipboard. This is pointer so our GImGui static constructor doesn't call heap allocators.
2015-07-21 23:00:28 +00:00
int LogStartDepth ;
int LogAutoExpandMaxDepth ;
// Misc
float FramerateSecPerFrame [ 120 ] ; // calculate estimate of framerate for user
int FramerateSecPerFrameIdx ;
float FramerateSecPerFrameAccum ;
2017-09-06 15:20:54 +00:00
int WantCaptureMouseNextFrame ; // explicit capture via CaptureInputs() sets those flags
int WantCaptureKeyboardNextFrame ;
2017-09-06 15:25:36 +00:00
int WantTextInputNextFrame ;
2015-07-21 23:00:28 +00:00
char TempBuffer [ 1024 * 3 + 1 ] ; // temporary text buffer
2017-12-21 17:50:27 +00:00
ImGuiContext ( ) : OverlayDrawList ( NULL )
2015-07-21 23:00:28 +00:00
{
Initialized = false ;
Font = NULL ;
FontSize = FontBaseSize = 0.0f ;
Time = 0.0f ;
FrameCount = 0 ;
2015-09-16 22:48:42 +00:00
FrameCountEnded = FrameCountRendered = - 1 ;
2017-12-12 22:36:25 +00:00
WindowsActiveCount = 0 ;
2015-07-21 23:00:28 +00:00
CurrentWindow = NULL ;
2017-08-22 11:51:12 +00:00
NavWindow = NULL ;
2015-07-21 23:00:28 +00:00
HoveredWindow = NULL ;
HoveredRootWindow = NULL ;
HoveredId = 0 ;
2015-12-03 21:30:17 +00:00
HoveredIdAllowOverlap = false ;
2015-07-21 23:00:28 +00:00
HoveredIdPreviousFrame = 0 ;
2017-10-29 22:46:32 +00:00
HoveredIdTimer = 0.0f ;
2015-07-21 23:00:28 +00:00
ActiveId = 0 ;
ActiveIdPreviousFrame = 0 ;
2017-10-29 22:46:32 +00:00
ActiveIdTimer = 0.0f ;
2015-07-21 23:00:28 +00:00
ActiveIdIsAlive = false ;
ActiveIdIsJustActivated = false ;
2015-12-03 21:30:17 +00:00
ActiveIdAllowOverlap = false ;
2016-05-21 18:50:15 +00:00
ActiveIdClickOffset = ImVec2 ( - 1 , - 1 ) ;
2015-07-21 23:00:28 +00:00
ActiveIdWindow = NULL ;
2017-10-27 10:01:52 +00:00
MovingWindow = NULL ;
2018-01-03 11:12:41 +00:00
NextTreeNodeOpenVal = false ;
NextTreeNodeOpenCond = 0 ;
2015-07-21 23:00:28 +00:00
2018-01-12 18:11:11 +00:00
ModalWindowDarkeningRatio = 0.0f ;
OverlayDrawList . _Data = & DrawListSharedData ;
OverlayDrawList . _OwnerName = " ##Overlay " ; // Give it a name for debugging
MouseCursor = ImGuiMouseCursor_Arrow ;
2017-10-29 20:15:02 +00:00
DragDropActive = false ;
DragDropSourceFlags = 0 ;
DragDropMouseButton = - 1 ;
2017-11-10 12:13:28 +00:00
DragDropTargetId = 0 ;
2018-01-12 18:11:11 +00:00
DragDropAcceptIdCurrRectSurface = 0.0f ;
2017-11-06 19:02:56 +00:00
DragDropAcceptIdPrev = DragDropAcceptIdCurr = 0 ;
DragDropAcceptFrameCount = - 1 ;
2017-10-29 20:37:14 +00:00
memset ( DragDropPayloadBufLocal , 0 , sizeof ( DragDropPayloadBufLocal ) ) ;
2017-10-29 20:15:02 +00:00
2015-07-21 23:00:28 +00:00
ScalarAsInputTextId = 0 ;
2017-08-08 07:54:20 +00:00
ColorEditOptions = ImGuiColorEditFlags__OptionsDefault ;
2015-07-21 23:00:28 +00:00
DragCurrentValue = 0.0f ;
DragLastMouseDelta = ImVec2 ( 0.0f , 0.0f ) ;
2016-06-25 15:03:49 +00:00
DragSpeedDefaultRatio = 1.0f / 100.0f ;
2017-08-29 08:05:12 +00:00
DragSpeedScaleSlow = 1.0f / 100.0f ;
2015-07-21 23:00:28 +00:00
DragSpeedScaleFast = 10.0f ;
2015-08-30 15:37:56 +00:00
ScrollbarClickDeltaToGrabCenter = ImVec2 ( 0.0f , 0.0f ) ;
2017-07-20 18:21:48 +00:00
TooltipOverrideCount = 0 ;
2015-11-29 14:15:07 +00:00
OsImePosRequest = OsImePosSet = ImVec2 ( - 1.0f , - 1.0f ) ;
2015-07-21 23:00:28 +00:00
2017-11-27 22:55:42 +00:00
SettingsDirtyTimer = 0.0f ;
2015-07-21 23:00:28 +00:00
LogEnabled = false ;
LogFile = NULL ;
LogClipboard = NULL ;
LogStartDepth = 0 ;
LogAutoExpandMaxDepth = 2 ;
memset ( FramerateSecPerFrame , 0 , sizeof ( FramerateSecPerFrame ) ) ;
FramerateSecPerFrameIdx = 0 ;
FramerateSecPerFrameAccum = 0.0f ;
2017-09-06 15:25:36 +00:00
WantCaptureMouseNextFrame = WantCaptureKeyboardNextFrame = WantTextInputNextFrame = - 1 ;
2015-12-30 10:45:13 +00:00
memset ( TempBuffer , 0 , sizeof ( TempBuffer ) ) ;
2015-07-21 23:00:28 +00:00
}
} ;
2017-09-06 18:28:36 +00:00
// Transient per-window flags, reset at the beginning of the frame. For child window, inherited from parent on first Begin().
2018-02-06 12:34:41 +00:00
// This is going to be exposed in imgui.h when stabilized enough.
2017-09-06 18:28:36 +00:00
enum ImGuiItemFlags_
{
2017-09-06 18:36:36 +00: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 07:28:54 +00: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)
//ImGuiItemFlags_NoNav = 1 << 3, // false
//ImGuiItemFlags_NoNavDefaultFocus = 1 << 4, // false
ImGuiItemFlags_SelectableDontClosePopup = 1 < < 5 , // false // MenuItem/Selectable() automatically closes current Popup window
2017-09-28 15:02:28 +00:00
ImGuiItemFlags_Default_ = ImGuiItemFlags_AllowKeyboardFocus
2017-09-06 18:28:36 +00:00
} ;
2015-07-21 23:00:28 +00: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-21 22:53:51 +00:00
struct IMGUI_API ImGuiDrawContext
2015-07-21 23:00:28 +00:00
{
ImVec2 CursorPos ;
ImVec2 CursorPosPrevLine ;
ImVec2 CursorStartPos ;
2017-12-10 16:36:30 +00: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-21 23:00:28 +00:00
float CurrentLineHeight ;
float CurrentLineTextBaseOffset ;
float PrevLineHeight ;
float PrevLineTextBaseOffset ;
float LogLinePosY ;
int TreeDepth ;
2016-06-12 20:27:15 +00:00
ImGuiID LastItemId ;
2018-02-06 12:34:41 +00:00
ImGuiItemStatusFlags LastItemStatusFlags ;
ImRect LastItemRect ; // Interaction rect
2018-02-06 12:46:14 +00:00
ImRect LastItemDisplayRect ; // End-user display rect (only valid if LastItemStatusFlags & ImGuiItemStatusFlags_HasDisplayRect)
2015-07-21 23:00:28 +00:00
bool MenuBarAppending ;
float MenuBarOffsetX ;
ImVector < ImGuiWindow * > ChildWindows ;
ImGuiStorage * StateStorage ;
ImGuiLayoutType LayoutType ;
// We store the current settings outside of the vectors to increase memory locality (reduce cache misses). The vectors are rarely modified. Also it allows us to not heap allocate for short-lived windows which are not using those settings.
2017-09-06 18:28:36 +00:00
ImGuiItemFlags ItemFlags ; // == ItemFlagsStack.back() [empty == ImGuiItemFlags_Default]
2015-07-21 23:00:28 +00: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]
2017-09-06 18:28:36 +00:00
ImVector < ImGuiItemFlags > ItemFlagsStack ;
2015-07-21 23:00:28 +00:00
ImVector < float > ItemWidthStack ;
ImVector < float > TextWrapPosStack ;
ImVector < ImGuiGroupData > GroupStack ;
int StackSizesBackup [ 6 ] ; // Store size of various stacks for asserting
2015-11-26 22:43:21 +00:00
float IndentX ; // Indentation / start position from left of window (increased by TreePush/TreePop, etc.)
2016-07-30 21:41:44 +00:00
float GroupOffsetX ;
2015-07-21 23:00:28 +00: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-13 18:21:21 +00:00
ImGuiColumnsSet * ColumnsSet ; // Current columns set
2015-07-21 23:00:28 +00: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-12 20:27:15 +00:00
LastItemId = 0 ;
2018-02-06 12:34:41 +00:00
LastItemStatusFlags = 0 ;
2018-02-06 12:46:14 +00:00
LastItemRect = LastItemDisplayRect = ImRect ( ) ;
2015-07-21 23:00:28 +00:00
MenuBarAppending = false ;
MenuBarOffsetX = 0.0f ;
StateStorage = NULL ;
LayoutType = ImGuiLayoutType_Vertical ;
ItemWidth = 0.0f ;
2017-09-06 18:28:36 +00:00
ItemFlags = ImGuiItemFlags_Default_ ;
2015-07-21 23:00:28 +00:00
TextWrapPos = - 1.0f ;
memset ( StackSizesBackup , 0 , sizeof ( StackSizesBackup ) ) ;
2015-11-26 22:43:21 +00:00
IndentX = 0.0f ;
2016-11-12 20:17:30 +00:00
GroupOffsetX = 0.0f ;
2015-07-21 23:00:28 +00:00
ColumnsOffsetX = 0.0f ;
2017-12-13 17:37:58 +00:00
ColumnsSet = NULL ;
2015-07-21 23:00:28 +00:00
}
} ;
2015-07-31 05:48:59 +00:00
// Windows data
2015-09-10 09:22:17 +00:00
struct IMGUI_API ImGuiWindow
2015-07-21 23:00:28 +00:00
{
char * Name ;
2016-04-19 16:31:40 +00:00
ImGuiID ID ; // == ImHash(Name)
ImGuiWindowFlags Flags ; // See enum ImGuiWindowFlags_
2015-07-21 23:00:28 +00: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 14:13:23 +00: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-10 16:36:30 +00: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 15:37:56 +00:00
ImVec2 SizeContentsExplicit ; // Size of contents explicitly set by the user via SetNextWindowContentSize()
2016-05-29 15:50:23 +00:00
ImRect ContentsRegionRect ; // Maximum visible content position in window coordinates. ~~ (SizeContentsExplicit ? SizeContentsExplicit : Size - ScrollbarSizes) - CursorStartPos, per axis
2017-11-18 18:02:02 +00: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-12 20:27:15 +00:00
ImGuiID MoveId ; // == window->GetID("#MOVE")
2015-08-30 14:08:13 +00:00
ImVec2 Scroll ;
2015-08-30 17:33:38 +00: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 15:37:56 +00:00
bool ScrollbarX , ScrollbarY ;
2016-01-24 11:00:37 +00:00
ImVec2 ScrollbarSizes ;
2018-01-03 19:45:06 +00:00
bool Active ; // Set to true on Begin(), unless Collapsed
2015-07-21 23:00:28 +00:00
bool WasActive ;
2017-11-18 23:07:38 +00:00
bool WriteAccessed ; // Set to true when any widget access the current window
2015-07-21 23:00:28 +00:00
bool Collapsed ; // Set when collapsing window to become only title-bar
2017-09-01 19:55:59 +00: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-13 22:25:13 +00:00
bool CloseButton ; // Set when the window has a close button (p_open != NULL)
2017-12-12 22:36:25 +00: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-21 23:00:28 +00:00
int BeginCount ; // Number of Begin() during the current frame (generally 0 or 1, 1+ if appending via multiple Begin/End pairs)
2016-06-12 20:27:15 +00: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-21 23:00:28 +00:00
int AutoFitFramesX , AutoFitFramesY ;
bool AutoFitOnlyGrows ;
2016-07-31 11:05:13 +00:00
int AutoFitChildAxises ;
2017-12-07 12:26:56 +00:00
ImGuiDir AutoPosLastDirection ;
2015-07-21 23:00:28 +00:00
int HiddenFrames ;
2017-08-11 05:36:28 +00: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-25 16:25:43 +00: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-21 23:00:28 +00: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 14:23:05 +00:00
ImRect ClipRect ; // = DrawList->clip_rect_stack.back(). Scissoring / clipping rectangle. x1, y1, x2, y2.
2016-05-06 09:31:32 +00:00
ImRect WindowRectClipped ; // = WindowRect just after setup in Begin(). == window->Rect() for root window.
2017-10-27 13:52:45 +00:00
ImRect InnerRect ;
2015-10-18 15:57:10 +00:00
int LastFrameActive ;
2015-07-21 23:00:28 +00:00
float ItemWidthDefault ;
2018-01-03 13:35:11 +00:00
ImGuiMenuColumns MenuColumns ; // Simplified columns storage for menu items
2015-07-21 23:00:28 +00:00
ImGuiStorage StateStorage ;
2017-12-13 18:21:21 +00:00
ImVector < ImGuiColumnsSet > ColumnsStorage ;
2015-07-21 23:00:28 +00:00
float FontWindowScale ; // Scale multiplier per-window
ImDrawList * DrawList ;
2017-12-12 17:45:57 +00:00
ImGuiWindow * ParentWindow ; // If we are a child _or_ popup window, this is pointing to our parent. Otherwise NULL.
2017-08-29 08:05:12 +00: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
2016-06-25 15:03:49 +00:00
// Navigation / Focus
2015-07-21 23:00:28 +00: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-21 17:50:27 +00:00
ImGuiWindow ( ImGuiContext * context , const char * name ) ;
2015-07-21 23:00:28 +00:00
~ ImGuiWindow ( ) ;
ImGuiID GetID ( const char * str , const char * str_end = NULL ) ;
ImGuiID GetID ( const void * ptr ) ;
2016-07-12 23:18:59 +00:00
ImGuiID GetIDNoKeepAlive ( const char * str , const char * str_end = NULL ) ;
2017-10-29 22:10:44 +00:00
ImGuiID GetIDFromRectangle ( const ImRect & r_abs ) ;
2015-07-21 23:00:28 +00:00
2017-11-22 11:26:50 +00:00
// We don't use g.FontSize because the window may be != g.CurrentWidow.
2015-07-21 23:00:28 +00: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 03:57:24 +00:00
2017-10-18 17:51:32 +00: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 12:34:41 +00:00
ImGuiID LastItemId ;
2018-02-06 12:46:14 +00:00
ImGuiItemStatusFlags LastItemStatusFlags ;
2018-02-06 12:34:41 +00:00
ImRect LastItemRect ;
2018-02-06 12:46:14 +00:00
ImRect LastItemDisplayRect ;
2017-10-18 17:51:32 +00:00
2017-12-12 22:36:25 +00:00
ImGuiItemHoveredDataBackup ( ) { Backup ( ) ; }
2018-02-06 12:46:14 +00: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-18 17:51:32 +00:00
} ;
2015-08-02 03:57:24 +00:00
//-----------------------------------------------------------------------------
// Internal API
// No guarantee of forward compatibility here.
//-----------------------------------------------------------------------------
namespace ImGui
{
2015-09-16 22:48:42 +00: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-07 17:55:51 +00:00
inline ImGuiWindow * GetCurrentWindowRead ( ) { ImGuiContext & g = * GImGui ; return g . CurrentWindow ; }
2017-11-18 23:07:38 +00:00
inline ImGuiWindow * GetCurrentWindow ( ) { ImGuiContext & g = * GImGui ; g . CurrentWindow - > WriteAccessed = true ; return g . CurrentWindow ; }
2016-02-20 16:37:36 +00:00
IMGUI_API ImGuiWindow * FindWindowByName ( const char * name ) ;
2015-08-06 14:11:33 +00:00
IMGUI_API void FocusWindow ( ImGuiWindow * window ) ;
2017-11-16 12:11:16 +00:00
IMGUI_API void BringWindowToFront ( ImGuiWindow * window ) ;
IMGUI_API void BringWindowToBack ( ImGuiWindow * window ) ;
2017-12-11 22:16:27 +00:00
IMGUI_API bool IsWindowChildOf ( ImGuiWindow * window , ImGuiWindow * potential_parent ) ;
2015-08-06 14:11:33 +00:00
2017-08-26 08:35:39 +00:00
IMGUI_API void Initialize ( ) ;
2016-04-02 22:47:41 +00:00
2017-11-28 19:03:10 +00:00
IMGUI_API void MarkIniSettingsDirty ( ) ;
2017-12-15 19:59:00 +00:00
IMGUI_API ImGuiSettingsHandler * FindSettingsHandler ( const char * type_name ) ;
2017-11-28 19:03:10 +00:00
IMGUI_API ImGuiWindowSettings * FindWindowSettings ( ImGuiID id ) ;
2017-11-27 23:32:25 +00:00
2015-08-06 14:11:33 +00:00
IMGUI_API void SetActiveID ( ImGuiID id , ImGuiWindow * window ) ;
2017-08-20 16:03:37 +00:00
IMGUI_API void ClearActiveID ( ) ;
2015-10-06 17:27:24 +00:00
IMGUI_API void SetHoveredID ( ImGuiID id ) ;
2018-01-12 18:53:27 +00:00
IMGUI_API ImGuiID GetHoveredID ( ) ;
2015-08-06 14:11:33 +00:00
IMGUI_API void KeepAliveID ( ImGuiID id ) ;
2015-08-02 03:57:24 +00: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-06 21:23:18 +00:00
IMGUI_API bool ItemAdd ( const ImRect & bb , ImGuiID id ) ;
2017-09-27 22:21:47 +00:00
IMGUI_API bool ItemHoverable ( const ImRect & bb , ImGuiID id ) ;
2017-10-06 21:23:18 +00:00
IMGUI_API bool IsClippedEx ( const ImRect & bb , ImGuiID id , bool clip_even_when_logged ) ;
2017-08-29 09:27:19 +00:00
IMGUI_API bool FocusableItemRegister ( ImGuiWindow * window , ImGuiID id , bool tab_stop = true ) ; // Return true if focus is requested
2015-08-02 03:57:24 +00: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-25 20:45:10 +00:00
IMGUI_API void PushMultiItemsWidths ( int components , float width_full = 0.0f ) ;
2017-09-06 18:28:36 +00:00
IMGUI_API void PushItemFlag ( ImGuiItemFlags option , bool enabled ) ;
IMGUI_API void PopItemFlag ( ) ;
2015-08-02 03:57:24 +00:00
2018-01-12 19:07:01 +00:00
IMGUI_API void SetCurrentFont ( ImFont * font ) ;
2018-01-07 15:20:02 +00:00
IMGUI_API void OpenPopupEx ( ImGuiID id ) ;
2017-09-25 10:52:06 +00:00
IMGUI_API void ClosePopup ( ImGuiID id ) ;
2018-02-01 17:31:41 +00:00
IMGUI_API void ClosePopupsOverWindow ( ImGuiWindow * ref_window ) ;
2017-08-16 05:42:41 +00:00
IMGUI_API bool IsPopupOpen ( ImGuiID id ) ;
2017-09-25 10:52:06 +00:00
IMGUI_API bool BeginPopupEx ( ImGuiID id , ImGuiWindowFlags extra_flags ) ;
2017-10-27 14:21:12 +00:00
IMGUI_API void BeginTooltipEx ( ImGuiWindowFlags extra_flags , bool override_previous_tooltip = true ) ;
2015-12-20 22:39:47 +00:00
2017-08-29 08:13:17 +00:00
IMGUI_API int CalcTypematicPressedRepeatAmount ( float t , float t_prev , float repeat_delay , float repeat_rate ) ;
2017-10-13 11:29:42 +00:00
IMGUI_API void Scrollbar ( ImGuiLayoutType direction ) ;
2017-09-28 14:41:01 +00: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-20 18:39:27 +00: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 14:41:01 +00:00
2017-11-10 12:13:28 +00:00
IMGUI_API bool BeginDragDropTargetCustom ( const ImRect & bb , ImGuiID id ) ;
2017-12-12 22:37:27 +00:00
IMGUI_API void ClearDragDrop ( ) ;
IMGUI_API bool IsDragDropPayloadBeingAccepted ( ) ;
2017-11-10 12:13:28 +00:00
2017-09-01 20:10:13 +00:00
// FIXME-WIP: New Columns API
2017-12-13 17:37:58 +00: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 15:09:43 +00:00
IMGUI_API void PushColumnClipRect ( int column_index = - 1 ) ;
2017-08-20 10:44:48 +00:00
2017-07-30 08:16:06 +00: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 03:57:24 +00: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 10:53:13 +00: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 03:57:24 +00:00
IMGUI_API void RenderFrame ( ImVec2 p_min , ImVec2 p_max , ImU32 fill_col , bool border = true , float rounding = 0.0f ) ;
2017-07-22 11:37:13 +00:00
IMGUI_API void RenderFrameBorder ( ImVec2 p_min , ImVec2 p_max , float rounding = 0.0f ) ;
2017-07-27 08:26:32 +00: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-18 21:46:16 +00:00
IMGUI_API void RenderTriangle ( ImVec2 pos , ImGuiDir dir , float scale = 1.0f ) ;
2016-05-01 18:19:28 +00:00
IMGUI_API void RenderBullet ( ImVec2 pos ) ;
2017-10-18 11:06:49 +00:00
IMGUI_API void RenderCheckMark ( ImVec2 pos , ImU32 col , float sz ) ;
2017-08-29 07:22:30 +00: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-21 19:40:02 +00: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 03:57:24 +00:00
2015-10-30 10:36:51 +00:00
IMGUI_API bool ButtonBehavior ( const ImRect & bb , ImGuiID id , bool * out_hovered , bool * out_held , ImGuiButtonFlags flags = 0 ) ;
2015-08-02 03:57:24 +00:00
IMGUI_API bool ButtonEx ( const char * label , const ImVec2 & size_arg = ImVec2 ( 0 , 0 ) , ImGuiButtonFlags flags = 0 ) ;
2016-04-21 07:55:02 +00:00
IMGUI_API bool CloseButton ( ImGuiID id , const ImVec2 & pos , float radius ) ;
2017-11-11 15:58:43 +00:00
IMGUI_API bool ArrowButton ( ImGuiID id , ImGuiDir dir , ImVec2 padding , ImGuiButtonFlags flags = 0 ) ;
2015-08-02 03:57:24 +00:00
2015-10-30 10:43:23 +00: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 03:57:24 +00: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-05 22:57:31 +00: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 03:57:24 +00:00
2017-09-27 09:39:13 +00: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 10:01:16 +00:00
2016-05-01 12:34:55 +00:00
IMGUI_API bool TreeNodeBehavior ( ImGuiID id , ImGuiTreeNodeFlags flags , const char * label , const char * label_end = NULL ) ;
2016-05-02 10:32:16 +00:00
IMGUI_API bool TreeNodeBehaviorIsOpen ( ImGuiID id , ImGuiTreeNodeFlags flags = 0 ) ; // Consume previous SetNextTreeNodeOpened() data, if any. May return true when logging
2016-05-01 12:34:55 +00:00
IMGUI_API void TreePushRawID ( ImGuiID id ) ;
2015-08-29 17:13:30 +00:00
2015-08-02 03:57:24 +00: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-19 17:33:03 +00: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-19 20:00:38 +00: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-19 17:33:03 +00:00
2016-05-29 17:14:19 +00:00
} // namespace ImGui
2017-08-17 13:13:14 +00:00
// ImFontAtlas internals
2017-08-17 13:19:54 +00:00
IMGUI_API bool ImFontAtlasBuildWithStbTruetype ( ImFontAtlas * atlas ) ;
2017-08-17 12:44:44 +00:00
IMGUI_API void ImFontAtlasBuildRegisterDefaultCustomRects ( ImFontAtlas * atlas ) ;
2017-08-17 13:13:14 +00:00
IMGUI_API void ImFontAtlasBuildSetupFont ( ImFontAtlas * atlas , ImFont * font , ImFontConfig * font_config , float ascent , float descent ) ;
2017-08-17 12:44:44 +00:00
IMGUI_API void ImFontAtlasBuildPackCustomRects ( ImFontAtlas * atlas , void * spc ) ;
2017-09-26 17:26:16 +00:00
IMGUI_API void ImFontAtlasBuildFinish ( ImFontAtlas * atlas ) ;
2017-08-26 06:11:56 +00: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 12:44:44 +00:00
2016-05-29 17:14:19 +00:00
# ifdef __clang__
# pragma clang diagnostic pop
# endif
2015-08-02 03:57:24 +00:00
2015-09-21 22:53:51 +00:00
# ifdef _MSC_VER
# pragma warning (pop)
# endif