| 1 | // dear imgui: Platform Backend for GLUT/FreeGLUT |
| 2 | // This needs to be used along with a Renderer (e.g. OpenGL2) |
| 3 | |
| 4 | // !!! GLUT/FreeGLUT IS OBSOLETE PREHISTORIC SOFTWARE. Using GLUT is not recommended unless you really miss the 90's. !!! |
| 5 | // !!! If someone or something is teaching you GLUT today, you are being abused. Please show some resistance. !!! |
| 6 | // !!! Nowadays, prefer using GLFW or SDL instead! |
| 7 | |
| 8 | // Implemented features: |
| 9 | // [X] Platform: Partial keyboard support. Since 1.87 we are using the io.AddKeyEvent() function. Pass ImGuiKey values to all key functions e.g. ImGui::IsKeyPressed(ImGuiKey_Space). [Legacy GLUT values are obsolete since 1.87 and not supported since 1.91.5] |
| 10 | // Missing features or Issues: |
| 11 | // [ ] Platform: GLUT is unable to distinguish e.g. Backspace from CTRL+H or TAB from CTRL+I |
| 12 | // [ ] Platform: Missing horizontal mouse wheel support. |
| 13 | // [ ] Platform: Missing mouse cursor shape/visibility support. |
| 14 | // [ ] Platform: Missing clipboard support (not supported by Glut). |
| 15 | // [ ] Platform: Missing gamepad support. |
| 16 | // [ ] Platform: Missing multi-viewport support (multiple windows). |
| 17 | |
| 18 | // You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this. |
| 19 | // Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need. |
| 20 | // Learn about Dear ImGui: |
| 21 | // - FAQ https://dearimgui.com/faq |
| 22 | // - Getting Started https://dearimgui.com/getting-started |
| 23 | // - Documentation https://dearimgui.com/docs (same as your local docs/ folder). |
| 24 | // - Introduction, links and more at the top of imgui.cpp |
| 25 | |
| 26 | #pragma once |
| 27 | #ifndef IMGUI_DISABLE |
| 28 | #include "imgui.h" // IMGUI_IMPL_API |
| 29 | |
| 30 | // Follow "Getting Started" link and check examples/ folder to learn about using backends! |
| 31 | IMGUI_IMPL_API bool ImGui_ImplGLUT_Init(); |
| 32 | IMGUI_IMPL_API void ImGui_ImplGLUT_InstallFuncs(); |
| 33 | IMGUI_IMPL_API void ImGui_ImplGLUT_Shutdown(); |
| 34 | IMGUI_IMPL_API void ImGui_ImplGLUT_NewFrame(); |
| 35 | |
| 36 | // You can call ImGui_ImplGLUT_InstallFuncs() to get all those functions installed automatically, |
| 37 | // or call them yourself from your own GLUT handlers. We are using the same weird names as GLUT for consistency.. |
| 38 | //------------------------------------ GLUT name ---------------------------------------------- Decent Name --------- |
| 39 | IMGUI_IMPL_API void ImGui_ImplGLUT_ReshapeFunc(int w, int h); // ~ ResizeFunc |
| 40 | IMGUI_IMPL_API void ImGui_ImplGLUT_MotionFunc(int x, int y); // ~ MouseMoveFunc |
| 41 | IMGUI_IMPL_API void ImGui_ImplGLUT_MouseFunc(int button, int state, int x, int y); // ~ MouseButtonFunc |
| 42 | IMGUI_IMPL_API void ImGui_ImplGLUT_MouseWheelFunc(int button, int dir, int x, int y); // ~ MouseWheelFunc |
| 43 | IMGUI_IMPL_API void ImGui_ImplGLUT_KeyboardFunc(unsigned char c, int x, int y); // ~ CharPressedFunc |
| 44 | IMGUI_IMPL_API void ImGui_ImplGLUT_KeyboardUpFunc(unsigned char c, int x, int y); // ~ CharReleasedFunc |
| 45 | IMGUI_IMPL_API void ImGui_ImplGLUT_SpecialFunc(int key, int x, int y); // ~ KeyPressedFunc |
| 46 | IMGUI_IMPL_API void ImGui_ImplGLUT_SpecialUpFunc(int key, int x, int y); // ~ KeyReleasedFunc |
| 47 | |
| 48 | #endif // #ifndef IMGUI_DISABLE |