|
124 | 124 | - You can apply arithmetic operators +,*,/ on numerical values. Use +- to subtract (because - would set a negative value!)
|
125 | 125 | - Controls are automatically adjusted for OSX to match standard OSX text editing operations.
|
126 | 126 | - General Keyboard controls: enable with ImGuiConfigFlags_NavEnableKeyboard.
|
127 |
| - - General Gamepad controls: enable with ImGuiConfigFlags_NavEnableGamepad. See suggested mappings in imgui.h ImGuiNavInput_ + download PNG/PSD at http://goo.gl/9LgVZW |
| 127 | + - General Gamepad controls: enable with ImGuiConfigFlags_NavEnableGamepad. See suggested mappings in imgui.h ImGuiNavInput_ + download PNG/PSD at http://dearimgui.org/controls_sheets |
128 | 128 |
|
129 | 129 |
|
130 | 130 | PROGRAMMER GUIDE
|
@@ -156,18 +156,20 @@ CODE
|
156 | 156 | HOW TO UPDATE TO A NEWER VERSION OF DEAR IMGUI
|
157 | 157 | ----------------------------------------------
|
158 | 158 | - Overwrite all the sources files except for imconfig.h (if you have made modification to your copy of imconfig.h)
|
159 |
| - - Or maintain your own branch where you have imconfig.h modified. |
| 159 | + - Or maintain your own branch where you have imconfig.h modified as a top-most commit which you can regularly rebase over master. |
| 160 | + - You can also use '#define IMGUI_USER_CONFIG "my_config_file.h" to redirect configuration to your own file. |
160 | 161 | - Read the "API BREAKING CHANGES" section (below). This is where we list occasional API breaking changes.
|
161 | 162 | If a function/type has been renamed / or marked obsolete, try to fix the name in your code before it is permanently removed
|
162 | 163 | from the public API. If you have a problem with a missing function/symbols, search for its name in the code, there will
|
163 | 164 | likely be a comment about it. Please report any issue to the GitHub page!
|
164 |
| - - Try to keep your copy of dear imgui reasonably up to date. |
| 165 | + - To find out usage of old API, you can add '#define IMGUI_DISABLE_OBSOLETE_FUNCTIONS' in your configuration file. |
| 166 | + - Try to keep your copy of Dear ImGui reasonably up to date. |
165 | 167 |
|
166 | 168 |
|
167 | 169 | GETTING STARTED WITH INTEGRATING DEAR IMGUI IN YOUR CODE/ENGINE
|
168 | 170 | ---------------------------------------------------------------
|
169 | 171 | - Run and study the examples and demo in imgui_demo.cpp to get acquainted with the library.
|
170 |
| - - In the majority of cases you should be able to use unmodified backends files available in the examples/ folder. |
| 172 | + - In the majority of cases you should be able to use unmodified backends files available in the backends/ folder. |
171 | 173 | - Add the Dear ImGui source files + selected backend source files to your projects or using your preferred build system.
|
172 | 174 | It is recommended you build and statically link the .cpp files as part of your project and NOT as shared library (DLL).
|
173 | 175 | - You can later customize the imconfig.h file to tweak some compile-time behavior, such as integrating Dear ImGui types with your own maths types.
|
|
348 | 350 | 0.0f= not held. 1.0f= fully held. Pass intermediate 0.0f..1.0f values for analog triggers/sticks.
|
349 | 351 | - We uses a simple >0.0f test for activation testing, and won't attempt to test for a dead-zone.
|
350 | 352 | Your code will probably need to transform your raw inputs (such as e.g. remapping your 0.2..0.9 raw input range to 0.0..1.0 imgui range, etc.).
|
351 |
| - - You can download PNG/PSD files depicting the gamepad controls for common controllers at: http://goo.gl/9LgVZW. |
| 353 | + - You can download PNG/PSD files depicting the gamepad controls for common controllers at: http://dearimgui.org/controls_sheets |
352 | 354 | - If you need to share inputs between your game and the imgui parts, the easiest approach is to go all-or-nothing, with a buttons combo
|
353 | 355 | to toggle the target. Please reach out if you think the game vs navigation input sharing could be improved.
|
354 | 356 | - Mouse:
|
|
0 commit comments