|
28 | 28 |
|
29 | 29 | //---- Don't define obsolete functions/enums/behaviors. Consider enabling from time to time after updating to avoid using soon-to-be obsolete function/names. |
30 | 30 | //#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS |
| 31 | +//#define IMGUI_DISABLE_OBSOLETE_KEYIO // 1.87: disable legacy io.KeyMap[]+io.KeysDown[] in favor io.AddKeyEvent(). This will be folded into IMGUI_DISABLE_OBSOLETE_FUNCTIONS in a few versions. |
31 | 32 |
|
32 | | -//---- Disable all of Dear ImGui or don't implement standard windows. |
33 | | -// It is very strongly recommended to NOT disable the demo windows during development. Please read comments in imgui_demo.cpp. |
| 33 | +//---- Disable all of Dear ImGui or don't implement standard windows/tools. |
| 34 | +// It is very strongly recommended to NOT disable the demo windows and debug tool during development. They are extremely useful in day to day work. Please read comments in imgui_demo.cpp. |
34 | 35 | //#define IMGUI_DISABLE // Disable everything: all headers and source files will be empty. |
35 | | -//#define IMGUI_DISABLE_DEMO_WINDOWS // Disable demo windows: ShowDemoWindow()/ShowStyleEditor() will be empty. Not recommended. |
36 | | -//#define IMGUI_DISABLE_METRICS_WINDOW // Disable metrics/debugger window: ShowMetricsWindow() will be empty. |
| 36 | +//#define IMGUI_DISABLE_DEMO_WINDOWS // Disable demo windows: ShowDemoWindow()/ShowStyleEditor() will be empty. |
| 37 | +//#define IMGUI_DISABLE_DEBUG_TOOLS // Disable metrics/debugger and other debug tools: ShowMetricsWindow(), ShowDebugLogWindow() and ShowStackToolWindow() will be empty (this was called IMGUI_DISABLE_METRICS_WINDOW before 1.88). |
37 | 38 |
|
38 | 39 | //---- Don't implement some functions to reduce linkage requirements. |
39 | 40 | //#define IMGUI_DISABLE_WIN32_DEFAULT_CLIPBOARD_FUNCTIONS // [Win32] Don't implement default clipboard handler. Won't use and link with OpenClipboard/GetClipboardData/CloseClipboard etc. (user32.lib/.a, kernel32.lib/.a) |
40 | | -//#define IMGUI_DISABLE_WIN32_DEFAULT_IME_FUNCTIONS // [Win32] Don't implement default IME handler. Won't use and link with ImmGetContext/ImmSetCompositionWindow. (imm32.lib/.a) |
| 41 | +//#define IMGUI_ENABLE_WIN32_DEFAULT_IME_FUNCTIONS // [Win32] [Default with Visual Studio] Implement default IME handler (require imm32.lib/.a, auto-link for Visual Studio, -limm32 on command-line for MinGW) |
| 42 | +//#define IMGUI_DISABLE_WIN32_DEFAULT_IME_FUNCTIONS // [Win32] [Default with non-Visual Studio compilers] Don't implement default IME handler (won't require imm32.lib/.a) |
41 | 43 | //#define IMGUI_DISABLE_WIN32_FUNCTIONS // [Win32] Won't use and link with any Win32 function (clipboard, ime). |
42 | 44 | //#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). |
43 | 45 | //#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) |
44 | 46 | //#define IMGUI_DISABLE_DEFAULT_MATH_FUNCTIONS // Don't implement ImFabs/ImSqrt/ImPow/ImFmod/ImCos/ImSin/ImAcos/ImAtan2 so you can implement them yourself. |
45 | | -//#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. |
| 47 | +//#define IMGUI_DISABLE_FILE_FUNCTIONS // Don't implement ImFileOpen/ImFileClose/ImFileRead/ImFileWrite and ImFileHandle at all (replace them with dummies) |
| 48 | +//#define IMGUI_DISABLE_DEFAULT_FILE_FUNCTIONS // Don't implement ImFileOpen/ImFileClose/ImFileRead/ImFileWrite and ImFileHandle 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. |
46 | 49 | //#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(). |
| 50 | +//#define IMGUI_DISABLE_SSE // Disable use of SSE intrinsics even if available |
47 | 51 |
|
48 | 52 | //---- Include imgui_user.h at the end of imgui.h as a convenience |
49 | 53 | //#define IMGUI_INCLUDE_IMGUI_USER_H |
|
58 | 62 | // By default the embedded implementations are declared static and not available outside of Dear ImGui sources files. |
59 | 63 | //#define IMGUI_STB_TRUETYPE_FILENAME "my_folder/stb_truetype.h" |
60 | 64 | //#define IMGUI_STB_RECT_PACK_FILENAME "my_folder/stb_rect_pack.h" |
| 65 | +//#define IMGUI_STB_SPRINTF_FILENAME "my_folder/stb_sprintf.h" // only used if enabled |
61 | 66 | //#define IMGUI_DISABLE_STB_TRUETYPE_IMPLEMENTATION |
62 | 67 | //#define IMGUI_DISABLE_STB_RECT_PACK_IMPLEMENTATION |
63 | 68 |
|
64 | | -//---- Use stb_printf's faster implementation of vsnprintf instead of the one from libc (unless IMGUI_DISABLE_DEFAULT_FORMAT_FUNCTIONS is defined) |
65 | | -// Requires 'stb_sprintf.h' to be available in the include path. Compatibility checks of arguments and formats done by clang and GCC will be disabled in order to support the extra formats provided by STB sprintf. |
66 | | -// #define IMGUI_USE_STB_SPRINTF |
| 69 | +//---- Use stb_sprintf.h for a faster implementation of vsnprintf instead of the one from libc (unless IMGUI_DISABLE_DEFAULT_FORMAT_FUNCTIONS is defined) |
| 70 | +// Compatibility checks of arguments and formats done by clang and GCC will be disabled in order to support the extra formats provided by stb_sprintf.h. |
| 71 | +//#define IMGUI_USE_STB_SPRINTF |
67 | 72 |
|
68 | 73 | //---- Use FreeType to build and rasterize the font atlas (instead of stb_truetype which is embedded by default in Dear ImGui) |
69 | 74 | // Requires FreeType headers to be available in the include path. Requires program to be compiled with 'misc/freetype/imgui_freetype.cpp' (in this repository) + the FreeType library (not provided). |
70 | | -// On Windows you may use vcpkg with 'vcpkg install freetype' + 'vcpkg integrate install'. |
| 75 | +// On Windows you may use vcpkg with 'vcpkg install freetype --triplet=x64-windows' + 'vcpkg integrate install'. |
71 | 76 | //#define IMGUI_ENABLE_FREETYPE |
72 | 77 |
|
73 | 78 | //---- Use stb_truetype to build and rasterize the font atlas (default) |
|
77 | 82 | //---- Define constructor and implicit cast operators to convert back<>forth between your math types and ImVec2/ImVec4. |
78 | 83 | // This will be inlined as part of ImVec2 and ImVec4 class declarations. |
79 | 84 | /* |
80 | | -#define IM_VEC2_CLASS_EXTRA \ |
81 | | - ImVec2(const MyVec2& f) { x = f.x; y = f.y; } \ |
| 85 | +#define IM_VEC2_CLASS_EXTRA \ |
| 86 | + constexpr ImVec2(const MyVec2& f) : x(f.x), y(f.y) {} \ |
82 | 87 | operator MyVec2() const { return MyVec2(x,y); } |
83 | 88 |
|
84 | | -#define IM_VEC4_CLASS_EXTRA \ |
85 | | - ImVec4(const MyVec4& f) { x = f.x; y = f.y; z = f.z; w = f.w; } \ |
| 89 | +#define IM_VEC4_CLASS_EXTRA \ |
| 90 | + constexpr ImVec4(const MyVec4& f) : x(f.x), y(f.y), z(f.z), w(f.w) {} \ |
86 | 91 | operator MyVec4() const { return MyVec4(x,y,z,w); } |
87 | 92 | */ |
88 | 93 |
|
|
103 | 108 | //#define IM_DEBUG_BREAK IM_ASSERT(0) |
104 | 109 | //#define IM_DEBUG_BREAK __debugbreak() |
105 | 110 |
|
106 | | -//---- Debug Tools: Have the Item Picker break in the ItemAdd() function instead of ItemHoverable(), |
107 | | -// (which comes earlier in the code, will catch a few extra items, allow picking items other than Hovered one.) |
108 | | -// This adds a small runtime cost which is why it is not enabled by default. |
109 | | -//#define IMGUI_DEBUG_TOOL_ITEM_PICKER_EX |
110 | | - |
111 | 111 | //---- Debug Tools: Enable slower asserts |
112 | 112 | //#define IMGUI_DEBUG_PARANOID |
113 | 113 |
|
|
0 commit comments