|
@@ -2,13 +2,13 @@
|
|
|
// (main code and documentation)
|
|
|
|
|
|
// Help:
|
|
|
-// - Read FAQ at http://dearimgui.org/faq
|
|
|
+// - Read FAQ at http://dearimgui.com/faq
|
|
|
// - Newcomers, read 'Programmer guide' below for notes on how to setup Dear ImGui in your codebase.
|
|
|
// - Call and read ImGui::ShowDemoWindow() in imgui_demo.cpp. All applications in examples/ are doing that.
|
|
|
// Read imgui.cpp for details, links and comments.
|
|
|
|
|
|
// Resources:
|
|
|
-// - FAQ http://dearimgui.org/faq
|
|
|
+// - FAQ http://dearimgui.com/faq
|
|
|
// - Homepage & latest https://github.com/ocornut/imgui
|
|
|
// - Releases & changelog https://github.com/ocornut/imgui/releases
|
|
|
// - Gallery https://github.com/ocornut/imgui/issues/5886 (please post your screenshots/video there!)
|
|
@@ -48,7 +48,7 @@ DOCUMENTATION
|
|
|
- HOW A SIMPLE RENDERING FUNCTION MAY LOOK LIKE
|
|
|
- API BREAKING CHANGES (read me when you update!)
|
|
|
- FREQUENTLY ASKED QUESTIONS (FAQ)
|
|
|
- - Read all answers online: https://www.dearimgui.org/faq, or in docs/FAQ.md (with a Markdown viewer)
|
|
|
+ - Read all answers online: https://www.dearimgui.com/faq, or in docs/FAQ.md (with a Markdown viewer)
|
|
|
|
|
|
CODE
|
|
|
(search for "[SECTION]" in the code to find them)
|
|
@@ -159,7 +159,7 @@ CODE
|
|
|
- GAMEPAD CONTROLS
|
|
|
- Enable with 'io.ConfigFlags |= ImGuiConfigFlags_NavEnableGamepad'.
|
|
|
- Particularly useful to use Dear ImGui on a console system (e.g. PlayStation, Switch, Xbox) without a mouse!
|
|
|
- - Download controller mapping PNG/PSD at http://dearimgui.org/controls_sheets
|
|
|
+ - Download controller mapping PNG/PSD at http://dearimgui.com/controls_sheets
|
|
|
- Backend support: backend needs to:
|
|
|
- Set 'io.BackendFlags |= ImGuiBackendFlags_HasGamepad' + call io.AddKeyEvent/AddKeyAnalogEvent() with ImGuiKey_Gamepad_XXX keys.
|
|
|
- For analog values (0.0f to 1.0f), backend is responsible to handling a dead-zone and rescaling inputs accordingly.
|
|
@@ -783,7 +783,7 @@ CODE
|
|
|
================================
|
|
|
|
|
|
Read all answers online:
|
|
|
- https://www.dearimgui.org/faq or https://github.com/ocornut/imgui/blob/master/docs/FAQ.md (same url)
|
|
|
+ https://www.dearimgui.com/faq or https://github.com/ocornut/imgui/blob/master/docs/FAQ.md (same url)
|
|
|
Read all answers locally (with a text editor or ideally a Markdown viewer):
|
|
|
docs/FAQ.md
|
|
|
Some answers are copied down here to facilitate searching in code.
|
|
@@ -807,7 +807,7 @@ CODE
|
|
|
Q: What is this library called?
|
|
|
Q: Which version should I get?
|
|
|
>> This library is called "Dear ImGui", please don't call it "ImGui" :)
|
|
|
- >> See https://www.dearimgui.org/faq for details.
|
|
|
+ >> See https://www.dearimgui.com/faq for details.
|
|
|
|
|
|
Q&A: Integration
|
|
|
================
|
|
@@ -817,14 +817,14 @@ CODE
|
|
|
|
|
|
Q: How can I tell whether to dispatch mouse/keyboard to Dear ImGui or my application?
|
|
|
A: You should read the 'io.WantCaptureMouse', 'io.WantCaptureKeyboard' and 'io.WantTextInput' flags!
|
|
|
- >> See https://www.dearimgui.org/faq for a fully detailed answer. You really want to read this.
|
|
|
+ >> See https://www.dearimgui.com/faq for a fully detailed answer. You really want to read this.
|
|
|
|
|
|
Q. How can I enable keyboard controls?
|
|
|
Q: How can I use this without a mouse, without a keyboard or without a screen? (gamepad, input share, remote display)
|
|
|
Q: I integrated Dear ImGui in my engine and little squares are showing instead of text...
|
|
|
Q: I integrated Dear ImGui in my engine and some elements are clipping or disappearing when I move windows around...
|
|
|
Q: I integrated Dear ImGui in my engine and some elements are displaying outside their expected windows boundaries...
|
|
|
- >> See https://www.dearimgui.org/faq
|
|
|
+ >> See https://www.dearimgui.com/faq
|
|
|
|
|
|
Q&A: Usage
|
|
|
----------
|
|
@@ -838,7 +838,7 @@ CODE
|
|
|
Q: How can I use my own math types instead of ImVec2/ImVec4?
|
|
|
Q: How can I interact with standard C++ types (such as std::string and std::vector)?
|
|
|
Q: How can I display custom shapes? (using low-level ImDrawList API)
|
|
|
- >> See https://www.dearimgui.org/faq
|
|
|
+ >> See https://www.dearimgui.com/faq
|
|
|
|
|
|
Q&A: Fonts, Text
|
|
|
================
|
|
@@ -848,7 +848,7 @@ CODE
|
|
|
Q: How can I easily use icons in my application?
|
|
|
Q: How can I load multiple fonts?
|
|
|
Q: How can I display and input non-Latin characters such as Chinese, Japanese, Korean, Cyrillic?
|
|
|
- >> See https://www.dearimgui.org/faq and https://github.com/ocornut/imgui/edit/master/docs/FONTS.md
|
|
|
+ >> See https://www.dearimgui.com/faq and https://github.com/ocornut/imgui/edit/master/docs/FONTS.md
|
|
|
|
|
|
Q&A: Concerns
|
|
|
=============
|
|
@@ -857,7 +857,7 @@ CODE
|
|
|
Q: Can you create elaborate/serious tools with Dear ImGui?
|
|
|
Q: Can you reskin the look of Dear ImGui?
|
|
|
Q: Why using C++ (as opposed to C)?
|
|
|
- >> See https://www.dearimgui.org/faq
|
|
|
+ >> See https://www.dearimgui.com/faq
|
|
|
|
|
|
Q&A: Community
|
|
|
==============
|
|
@@ -9308,7 +9308,7 @@ bool ImGui::ItemAdd(const ImRect& bb, ImGuiID id, const ImRect* nav_bb_arg, ImGu
|
|
|
|
|
|
// [DEBUG] People keep stumbling on this problem and using "" as identifier in the root of a window instead of "##something".
|
|
|
// Empty identifier are valid and useful in a small amount of cases, but 99.9% of the time you want to use "##something".
|
|
|
- // READ THE FAQ: https://dearimgui.org/faq
|
|
|
+ // READ THE FAQ: https://dearimgui.com/faq
|
|
|
IM_ASSERT(id != window->ID && "Cannot have an empty ID at the root of a window. If you need an empty label, use ## and read the FAQ about how the ID Stack works!");
|
|
|
}
|
|
|
g.NextItemData.Flags = ImGuiNextItemDataFlags_None;
|