imgui_impl_opengl3.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. // dear imgui: Renderer Backend for modern OpenGL with shaders / programmatic pipeline
  2. // - Desktop GL: 2.x 3.x 4.x
  3. // - Embedded GL: ES 2.0 (WebGL 1.0), ES 3.0 (WebGL 2.0)
  4. // This needs to be used along with a Platform Backend (e.g. GLFW, SDL, Win32, custom..)
  5. // Implemented features:
  6. // [X] Renderer: User texture binding. Use 'GLuint' OpenGL texture as texture identifier. Read the FAQ about ImTextureID/ImTextureRef!
  7. // [x] Renderer: Large meshes support (64k+ vertices) even with 16-bit indices (ImGuiBackendFlags_RendererHasVtxOffset) [Desktop OpenGL only!]
  8. // [X] Renderer: Texture updates support for dynamic font atlas (ImGuiBackendFlags_RendererHasTextures).
  9. // [X] Renderer: Multi-viewport support (multiple windows). Enable with 'io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable'.
  10. // About WebGL/ES:
  11. // - You need to '#define IMGUI_IMPL_OPENGL_ES2' or '#define IMGUI_IMPL_OPENGL_ES3' to use WebGL or OpenGL ES.
  12. // - This is done automatically on iOS, Android and Emscripten targets.
  13. // - For other targets, the define needs to be visible from the imgui_impl_opengl3.cpp compilation unit. If unsure, define globally or in imconfig.h.
  14. // You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
  15. // Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need.
  16. // Learn about Dear ImGui:
  17. // - FAQ https://dearimgui.com/faq
  18. // - Getting Started https://dearimgui.com/getting-started
  19. // - Documentation https://dearimgui.com/docs (same as your local docs/ folder).
  20. // - Introduction, links and more at the top of imgui.cpp
  21. // About GLSL version:
  22. // The 'glsl_version' initialization parameter should be nullptr (default) or a "#version XXX" string.
  23. // On computer platform the GLSL version default to "#version 130". On OpenGL ES 3 platform it defaults to "#version 300 es"
  24. // Only override if your GL version doesn't handle this GLSL version. See GLSL version table at the top of imgui_impl_opengl3.cpp.
  25. #pragma once
  26. #include "imgui.h" // IMGUI_IMPL_API
  27. #ifndef IMGUI_DISABLE
  28. // Follow "Getting Started" link and check examples/ folder to learn about using backends!
  29. IMGUI_IMPL_API bool ImGui_ImplOpenGL3_Init(const char* glsl_version = nullptr);
  30. IMGUI_IMPL_API void ImGui_ImplOpenGL3_Shutdown();
  31. IMGUI_IMPL_API void ImGui_ImplOpenGL3_NewFrame();
  32. IMGUI_IMPL_API void ImGui_ImplOpenGL3_RenderDrawData(ImDrawData* draw_data);
  33. // (Optional) Called by Init/NewFrame/Shutdown
  34. IMGUI_IMPL_API bool ImGui_ImplOpenGL3_CreateDeviceObjects();
  35. IMGUI_IMPL_API void ImGui_ImplOpenGL3_DestroyDeviceObjects();
  36. // (Advanced) Use e.g. if you need to precisely control the timing of texture updates (e.g. for staged rendering), by setting ImDrawData::Textures = NULL to handle this manually.
  37. IMGUI_IMPL_API void ImGui_ImplOpenGL3_UpdateTexture(ImTextureData* tex);
  38. // Configuration flags to add in your imconfig file:
  39. //#define IMGUI_IMPL_OPENGL_ES2 // Enable ES 2 (Auto-detected on Emscripten)
  40. //#define IMGUI_IMPL_OPENGL_ES3 // Enable ES 3 (Auto-detected on iOS/Android)
  41. // You can explicitly select GLES2 or GLES3 API by using one of the '#define IMGUI_IMPL_OPENGL_LOADER_XXX' in imconfig.h or compiler command-line.
  42. #if !defined(IMGUI_IMPL_OPENGL_ES2) \
  43. && !defined(IMGUI_IMPL_OPENGL_ES3)
  44. // Try to detect GLES on matching platforms
  45. #if defined(__APPLE__)
  46. #include <TargetConditionals.h>
  47. #endif
  48. #if (defined(__APPLE__) && (TARGET_OS_IOS || TARGET_OS_TV)) || (defined(__ANDROID__))
  49. #define IMGUI_IMPL_OPENGL_ES3 // iOS, Android -> GL ES 3, "#version 300 es"
  50. #elif defined(__EMSCRIPTEN__) || defined(__amigaos4__)
  51. #define IMGUI_IMPL_OPENGL_ES2 // Emscripten -> GL ES 2, "#version 100"
  52. #else
  53. // Otherwise imgui_impl_opengl3_loader.h will be used.
  54. #endif
  55. #endif
  56. #endif // #ifndef IMGUI_DISABLE