imgui_impl_opengl3.h 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  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 identifier as void*/ImTextureID. Read the FAQ about ImTextureID!
  7. // [x] Renderer: Desktop GL only: Support for large meshes (64k+ vertices) with 16-bit indices.
  8. // You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
  9. // Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need.
  10. // If you are new to Dear ImGui, read documentation from the docs/ folder + read the top of imgui.cpp.
  11. // Read online: https://github.com/ocornut/imgui/tree/master/docs
  12. // About GLSL version:
  13. // The 'glsl_version' initialization parameter should be NULL (default) or a "#version XXX" string.
  14. // On computer platform the GLSL version default to "#version 130". On OpenGL ES 3 platform it defaults to "#version 300 es"
  15. // Only override if your GL version doesn't handle this GLSL version. See GLSL version table at the top of imgui_impl_opengl3.cpp.
  16. #pragma once
  17. #include "imgui.h" // IMGUI_IMPL_API
  18. // Backend API
  19. IMGUI_IMPL_API bool ImGui_ImplOpenGL3_Init(const char* glsl_version = NULL);
  20. IMGUI_IMPL_API void ImGui_ImplOpenGL3_Shutdown();
  21. IMGUI_IMPL_API void ImGui_ImplOpenGL3_NewFrame();
  22. IMGUI_IMPL_API void ImGui_ImplOpenGL3_RenderDrawData(ImDrawData* draw_data);
  23. // (Optional) Called by Init/NewFrame/Shutdown
  24. IMGUI_IMPL_API bool ImGui_ImplOpenGL3_CreateFontsTexture();
  25. IMGUI_IMPL_API void ImGui_ImplOpenGL3_DestroyFontsTexture();
  26. IMGUI_IMPL_API bool ImGui_ImplOpenGL3_CreateDeviceObjects();
  27. IMGUI_IMPL_API void ImGui_ImplOpenGL3_DestroyDeviceObjects();
  28. // Specific OpenGL ES versions
  29. //#define IMGUI_IMPL_OPENGL_ES2 // Auto-detected on Emscripten
  30. //#define IMGUI_IMPL_OPENGL_ES3 // Auto-detected on iOS/Android
  31. // 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.
  32. #if !defined(IMGUI_IMPL_OPENGL_ES2) \
  33. && !defined(IMGUI_IMPL_OPENGL_ES3)
  34. // Try to detect GLES on matching platforms
  35. #if defined(__APPLE__)
  36. #include <TargetConditionals.h>
  37. #endif
  38. #if (defined(__APPLE__) && (TARGET_OS_IOS || TARGET_OS_TV)) || (defined(__ANDROID__))
  39. #define IMGUI_IMPL_OPENGL_ES3 // iOS, Android -> GL ES 3, "#version 300 es"
  40. #elif defined(__EMSCRIPTEN__)
  41. #define IMGUI_IMPL_OPENGL_ES2 // Emscripten -> GL ES 2, "#version 100"
  42. #else
  43. // Otherwise imgui_impl_opengl3_loader.h will be used.
  44. #endif
  45. #endif