2014-08-10 15:58:11 -05:00
//-----------------------------------------------------------------------------
2018-01-28 10:47:28 -06:00
// COMPILE-TIME OPTIONS FOR DEAR IMGUI
2018-03-18 06:24:28 -05:00
// Runtime options (clipboard callbacks, enabling various features, etc.) can generally be set via the ImGuiIO structure.
// You can use ImGui::SetAllocatorFunctions() before calling ImGui::CreateContext() to rewire memory allocation functions.
2018-01-28 10:47:28 -06:00
//-----------------------------------------------------------------------------
2019-06-11 09:11:19 -05:00
// A) You may edit imconfig.h (and not overwrite it when updating Dear ImGui, or maintain a patch/branch with your modifications to imconfig.h)
2018-05-17 07:12:37 -05:00
// B) or add configuration directives in your own file and compile with #define IMGUI_USER_CONFIG "myfilename.h"
2019-06-11 09:11:19 -05:00
// If you do so you need to make sure that configuration settings are defined consistently _everywhere_ Dear ImGui is used, which include
// the imgui*.cpp files but also _any_ of your code that uses Dear ImGui. This is because some compile-time options have an affect on data structures.
2018-04-23 02:37:55 -05:00
// Defining those options in imconfig.h will ensure every compilation unit gets to see the same data structure layouts.
2018-04-25 15:16:16 -05:00
// Call IMGUI_CHECKVERSION() from your .cpp files to verify that the data structures your files are using are matching the ones imgui.cpp is using.
2014-08-10 15:58:11 -05:00
//-----------------------------------------------------------------------------
# pragma once
2014-08-14 08:31:13 -05:00
//---- Define assertion handler. Defaults to calling assert().
2014-08-19 06:09:13 -05:00
//#define IM_ASSERT(_EXPR) MyAssert(_EXPR)
2018-05-13 14:30:10 -05:00
//#define IM_ASSERT(_EXPR) ((void)(_EXPR)) // Disable asserts
2014-08-10 15:58:11 -05:00
2019-09-17 04:33:18 -05:00
//---- Define attributes of all API symbols declarations, e.g. for DLL under Windows
2019-06-12 09:15:08 -05:00
// Using dear imgui via a shared library is not recommended, because of function call overhead and because we don't guarantee backward nor forward ABI compatibility.
2015-02-25 17:10:17 -06:00
//#define IMGUI_API __declspec( dllexport )
//#define IMGUI_API __declspec( dllimport )
2018-05-13 13:02:47 -05:00
//---- Don't define obsolete functions/enums names. Consider enabling from time to time after updating to avoid using soon-to-be obsolete function/names.
2017-10-24 13:19:32 -05:00
//#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS
2017-12-24 11:16:22 -06:00
//---- Don't implement demo windows functionality (ShowDemoWindow()/ShowStyleEditor()/ShowUserGuide() methods will be empty)
2019-06-12 09:15:08 -05:00
// It is very strongly recommended to NOT disable the demo windows during development. Please read the comments in imgui_demo.cpp.
2017-12-24 11:16:22 -06:00
//#define IMGUI_DISABLE_DEMO_WINDOWS
2019-07-01 11:48:21 -05:00
//#define IMGUI_DISABLE_METRICS_WINDOW
2015-03-20 14:08:00 -05:00
2018-05-13 13:02:47 -05:00
//---- Don't implement some functions to reduce linkage requirements.
//#define IMGUI_DISABLE_WIN32_DEFAULT_CLIPBOARD_FUNCTIONS // [Win32] Don't implement default clipboard handler. Won't use and link with OpenClipboard/GetClipboardData/CloseClipboard etc.
//#define IMGUI_DISABLE_WIN32_DEFAULT_IME_FUNCTIONS // [Win32] Don't implement default IME handler. Won't use and link with ImmGetContext/ImmSetCompositionWindow.
2019-05-18 10:44:09 -05:00
//#define IMGUI_DISABLE_WIN32_FUNCTIONS // [Win32] Won't use and link with any Win32 function (clipboard, ime).
2019-11-19 13:48:11 -06:00
//#define IMGUI_ENABLE_OSX_DEFAULT_CLIPBOARD_FUNCTIONS // [OSX] Implement default OSX clipboard handler (need to link with '-framework ApplicationServices', this is why this is not the default).
2019-11-19 14:20:46 -06:00
//#define IMGUI_DISABLE_DEFAULT_FORMAT_FUNCTIONS // Don't implement ImFormatString/ImFormatStringV so you can implement them yourself (e.g. if you don't want to link with vsnprintf)
2019-11-19 13:48:11 -06:00
//#define IMGUI_DISABLE_DEFAULT_MATH_FUNCTIONS // Don't implement ImFabs/ImSqrt/ImPow/ImFmod/ImCos/ImSin/ImAcos/ImAtan2 so you can implement them yourself.
2019-11-19 14:14:44 -06:00
//#define IMGUI_DISABLE_DEFAULT_FILE_FUNCTIONS // Don't implement ImFileOpen/ImFileClose/ImFileRead/ImFileWrite so you can implement them yourself if you don't want to link with fopen/fclose/fread/fwrite. This will also disable the LogToTTY() function.
2018-07-12 04:08:24 -05:00
//#define IMGUI_DISABLE_DEFAULT_ALLOCATORS // Don't implement default allocators calling malloc()/free() to avoid linking with them. You will need to call ImGui::SetAllocatorFunctions().
2015-05-31 05:17:58 -05:00
2018-01-28 10:21:07 -06:00
//---- Include imgui_user.h at the end of imgui.h as a convenience
//#define IMGUI_INCLUDE_IMGUI_USER_H
2018-07-12 04:08:24 -05:00
//---- Pack colors to BGRA8 instead of RGBA8 (to avoid converting from one to another)
2016-08-05 04:04:05 -05:00
//#define IMGUI_USE_BGRA_PACKED_COLOR
2018-03-20 12:25:37 -05:00
//---- Avoid multiple STB libraries implementations, or redefine path/filenames to prioritize another version
// By default the embedded implementations are declared static and not available outside of imgui cpp files.
//#define IMGUI_STB_TRUETYPE_FILENAME "my_folder/stb_truetype.h"
//#define IMGUI_STB_RECT_PACK_FILENAME "my_folder/stb_rect_pack.h"
//#define IMGUI_DISABLE_STB_TRUETYPE_IMPLEMENTATION
//#define IMGUI_DISABLE_STB_RECT_PACK_IMPLEMENTATION
2014-12-05 17:09:43 -06:00
2018-07-26 05:55:40 -05:00
//---- Define constructor and implicit cast operators to convert back<>forth between your math types and ImVec2/ImVec4.
2018-01-28 10:21:07 -06:00
// This will be inlined as part of ImVec2 and ImVec4 class declarations.
2014-08-10 15:58:11 -05:00
/*
2014-08-19 06:09:13 -05:00
# define IM_VEC2_CLASS_EXTRA \
ImVec2 ( const MyVec2 & f ) { x = f . x ; y = f . y ; } \
operator MyVec2 ( ) const { return MyVec2 ( x , y ) ; }
2014-08-10 15:58:11 -05:00
2014-08-19 06:09:13 -05:00
# define IM_VEC4_CLASS_EXTRA \
ImVec4 ( const MyVec4 & f ) { x = f . x ; y = f . y ; z = f . z ; w = f . w ; } \
operator MyVec4 ( ) const { return MyVec4 ( x , y , z , w ) ; }
2014-08-10 15:58:11 -05:00
*/
2019-11-20 04:58:25 -06:00
//---- Use 32-bit vertex indices (default is 16-bit) is one way to allow large meshes with more than 64K vertices.
// Your renderer back-end will need to support it (most example renderer back-ends support both 16/32-bit indices).
// Another way to allow large meshes while keeping 16-bit indices is to handle ImDrawCmd::VtxOffset in your renderer.
2019-05-29 09:29:17 -05:00
// Read about ImGuiBackendFlags_RendererHasVtxOffset for details.
2017-04-26 12:12:46 -05:00
//#define ImDrawIdx unsigned int
2019-06-05 17:20:29 -05:00
//---- Override ImDrawCallback signature (will need to modify renderer back-ends accordingly)
//struct ImDrawList;
//struct ImDrawCmd;
//typedef void (*MyImDrawCallback)(const ImDrawList* draw_list, const ImDrawCmd* cmd, void* my_renderer_user_data);
//#define ImDrawCallback MyImDrawCallback
2019-12-08 09:12:44 -06:00
//---- Debug Tools: Macro to break in Debugger
// (use 'Metrics->Tools->Item Picker' to pick widgets with the mouse and break into them for easy debugging.)
2019-07-16 20:25:49 -05:00
//#define IM_DEBUG_BREAK IM_ASSERT(0)
//#define IM_DEBUG_BREAK __debugbreak()
2019-12-08 09:12:44 -06:00
//---- Debug Tools: Have the Item Picker break in the ItemAdd() function instead of ItemHoverable(),
// (which comes earlier in the code, will catch a few extra items, allow picking items other than Hovered one.)
2019-07-19 12:48:22 -05:00
// This adds a small runtime cost which is why it is not enabled by default.
//#define IMGUI_DEBUG_TOOL_ITEM_PICKER_EX
2019-07-16 20:25:49 -05:00
2019-12-08 09:12:44 -06:00
//---- Debug Tools: Enable slower asserts
//#define IMGUI_DEBUG_PARANOID
2015-12-24 09:19:50 -06:00
//---- Tip: You can add extra functions within the ImGui:: namespace, here or in your own headers files.
2014-08-10 15:58:11 -05:00
/*
namespace ImGui
{
2018-01-28 10:21:07 -06:00
void MyFunction ( const char * name , const MyMatrix44 & v ) ;
2014-10-26 10:08:28 -05:00
}
2014-08-10 15:58:11 -05:00
*/