Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add FAQ entry: "How can I make an ImGui window fill the entire viewport?" #3789

Closed
wants to merge 2 commits into from
Closed

Add FAQ entry: "How can I make an ImGui window fill the entire viewport?" #3789

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1805848
Add FAQ entry: How can I make an ImGui window fill the entire viewport?
PossiblyAShrub Feb 4, 2021
2944805
Fix typos, fix code style, and simplify answer.
PossiblyAShrub Feb 4, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions docs/FAQ.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ or view this file with any Markdown viewer.
| [How can I use my own math types instead of ImVec2/ImVec4?](#q-how-can-i-use-my-own-math-types-instead-of-imvec2imvec4) |
| [How can I interact with standard C++ types (such as std::string and std::vector)?](#q-how-can-i-interact-with-standard-c-types-such-as-stdstring-and-stdvector) |
| [How can I display custom shapes? (using low-level ImDrawList API)](#q-how-can-i-display-custom-shapes-using-low-level-imdrawlist-api) |
| [How can I make an ImGui window fill the entire viewport (platform window)?](#q-how-can-i-make-an-imgui-window-fill-the-entire-viewport) |
| **Q&A: Fonts, Text** |
| [How should I handle DPI in my application?](#q-how-should-i-handle-dpi-in-my-application) |
| [How can I load a different font than the default?](#q-how-can-i-load-a-different-font-than-the-default) |
Expand Down Expand Up @@ -455,9 +456,27 @@ ImGui::End();
- You can also create your own empty window and draw inside it. Call Begin() with the NoBackground | NoDecoration | NoSavedSettings | NoInputs flags (The `ImGuiWindowFlags_NoDecoration` flag itself is a shortcut for NoTitleBar | NoResize | NoScrollbar | NoCollapse). Then you can retrieve the ImDrawList* via GetWindowDrawList() and draw to it in any way you like.
- You can create your own ImDrawList instance. You'll need to initialize them with `ImGui::GetDrawListSharedData()`, or create your own instancing ImDrawListSharedData, and then call your renderer function with your own ImDrawList or ImDrawData data.

##### [Return to Index](#index)
### Q: How can I make an ImGui window fill the entire viewport?

---
This can be achieved by setting the ImGui window position and size to match the viewport window. So right before calling `ImGui::Begin`, do the following:

**If you're on the `master` branch:**

```cpp
ImGuiIO& io = ImGui::GetIO();
ImGui::SetNextWindowPos(ImVec2(0, 0));
ImGui::SetNextWindowSize(io.DisplaySize);
```

**If you're on the `docking` branch:***

```cpp
const ImGuiViewport* viewport = ImGui::GetMainViewport();
ImGui::SetNextWindowPos(viewport->Pos);
ImGui::SetNextWindowSize(viewport->Size);
```

##### [Return to Index](#index)

# Q&A: Fonts, Text

Expand Down