imgui_impl_opengl3.cpp 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358
  1. // ImGui Renderer for: OpenGL3 (modern OpenGL with shaders / programmatic pipeline)
  2. // This needs to be used along with a Platform Binding (e.g. GLFW, SDL, Win32, custom..)
  3. // (Note: We are using GL3W as a helper library to access OpenGL functions since there is no standard header to access modern OpenGL functions easily. Alternatives are GLEW, Glad, etc..)
  4. // Implemented features:
  5. // [X] User texture binding. Use 'GLUint' OpenGL texture identifier as void*/ImTextureID. Read the FAQ about ImTextureID in imgui.cpp.
  6. // [X] Multi-viewport rendering (when ImGuiConfigFlags_ViewportsEnable is enabled).
  7. // CHANGELOG
  8. // (minor and older changes stripped away, please see git history for details)
  9. // 2018-XX-XX: Platform: Added support for multiple windows via the ImGuiPlatformIO interface.
  10. // 2018-XX-XX: OpenGL: Offset projection matrix and clipping rectangle by draw_data->DisplayPos (which will be non-zero for multi-viewport applications).
  11. // 2018-05-25: OpenGL: Removed unnecessary backup/restore of GL_ELEMENT_ARRAY_BUFFER_BINDING since this is part of the VAO state.
  12. // 2018-05-14: OpenGL: Making the call to glBindSampler() optional so 3.2 context won't fail if the function is a NULL pointer.
  13. // 2018-03-06: OpenGL: Added const char* glsl_version parameter to ImGui_ImplOpenGL3_Init() so user can override the GLSL version e.g. "#version 150".
  14. // 2018-02-23: OpenGL: Create the VAO in the render function so the setup can more easily be used with multiple shared GL context.
  15. // 2018-02-16: Misc: Obsoleted the io.RenderDrawListsFn callback and exposed ImGui_ImplSdlGL3_RenderDrawData() in the .h file so you can call it yourself.
  16. // 2018-01-07: OpenGL: Changed GLSL shader version from 330 to 150.
  17. // 2017-09-01: OpenGL: Save and restore current bound sampler. Save and restore current polygon mode.
  18. // 2017-05-01: OpenGL: Fixed save and restore of current blend func state.
  19. // 2017-05-01: OpenGL: Fixed save and restore of current GL_ACTIVE_TEXTURE.
  20. // 2016-09-05: OpenGL: Fixed save and restore of current scissor rectangle.
  21. // 2016-07-29: OpenGL: Explicitly setting GL_UNPACK_ROW_LENGTH to reduce issues because SDL changes it. (#752)
  22. #if defined(_MSC_VER) && !defined(_CRT_SECURE_NO_WARNINGS)
  23. #define _CRT_SECURE_NO_WARNINGS
  24. #endif
  25. #include "imgui.h"
  26. #include "imgui_impl_opengl3.h"
  27. #include <GL/gl3w.h> // This example is using gl3w to access OpenGL functions (because it is small). You may use glew/glad/glLoadGen/etc. whatever already works for you.
  28. // OpenGL Data
  29. static char g_GlslVersion[32] = "#version 150";
  30. static GLuint g_FontTexture = 0;
  31. static int g_ShaderHandle = 0, g_VertHandle = 0, g_FragHandle = 0;
  32. static int g_AttribLocationTex = 0, g_AttribLocationProjMtx = 0;
  33. static int g_AttribLocationPosition = 0, g_AttribLocationUV = 0, g_AttribLocationColor = 0;
  34. static unsigned int g_VboHandle = 0, g_ElementsHandle = 0;
  35. // Forward Declarations
  36. static void ImGui_ImplOpenGL3_InitPlatformInterface();
  37. static void ImGui_ImplOpenGL3_ShutdownPlatformInterface();
  38. // Functions
  39. bool ImGui_ImplOpenGL3_Init(const char* glsl_version)
  40. {
  41. // Store GLSL version string so we can refer to it later in case we recreate shaders. Note: GLSL version is NOT the same as GL version. Leave this to NULL if unsure.
  42. if (glsl_version == NULL)
  43. glsl_version = "#version 150";
  44. IM_ASSERT((int)strlen(glsl_version) + 2 < IM_ARRAYSIZE(g_GlslVersion));
  45. strcpy(g_GlslVersion, glsl_version);
  46. strcat(g_GlslVersion, "\n");
  47. // Setup back-end capabilities flags
  48. ImGuiIO& io = ImGui::GetIO();
  49. io.BackendFlags |= ImGuiBackendFlags_RendererHasViewports; // We can create multi-viewports on the Renderer side (optional)
  50. if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable)
  51. ImGui_ImplOpenGL3_InitPlatformInterface();
  52. return true;
  53. }
  54. void ImGui_ImplOpenGL3_Shutdown()
  55. {
  56. ImGui_ImplOpenGL3_ShutdownPlatformInterface();
  57. ImGui_ImplOpenGL3_DestroyDeviceObjects();
  58. }
  59. void ImGui_ImplOpenGL3_NewFrame()
  60. {
  61. if (!g_FontTexture)
  62. ImGui_ImplOpenGL3_CreateDeviceObjects();
  63. }
  64. // OpenGL3 Render function.
  65. // (this used to be set in io.RenderDrawListsFn and called by ImGui::Render(), but you can now call this directly from your main loop)
  66. // Note that this implementation is little overcomplicated because we are saving/setting up/restoring every OpenGL state explicitly, in order to be able to run within any OpenGL engine that doesn't do so.
  67. void ImGui_ImplOpenGL3_RenderDrawData(ImDrawData* draw_data)
  68. {
  69. // Avoid rendering when minimized, scale coordinates for retina displays (screen coordinates != framebuffer coordinates)
  70. ImGuiIO& io = ImGui::GetIO();
  71. int fb_width = (int)(draw_data->DisplaySize.x * io.DisplayFramebufferScale.x);
  72. int fb_height = (int)(draw_data->DisplaySize.y * io.DisplayFramebufferScale.y);
  73. if (fb_width <= 0 || fb_height <= 0)
  74. return;
  75. draw_data->ScaleClipRects(io.DisplayFramebufferScale);
  76. // Backup GL state
  77. GLenum last_active_texture; glGetIntegerv(GL_ACTIVE_TEXTURE, (GLint*)&last_active_texture);
  78. glActiveTexture(GL_TEXTURE0);
  79. GLint last_program; glGetIntegerv(GL_CURRENT_PROGRAM, &last_program);
  80. GLint last_texture; glGetIntegerv(GL_TEXTURE_BINDING_2D, &last_texture);
  81. GLint last_sampler; glGetIntegerv(GL_SAMPLER_BINDING, &last_sampler);
  82. GLint last_array_buffer; glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &last_array_buffer);
  83. GLint last_vertex_array; glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &last_vertex_array);
  84. GLint last_polygon_mode[2]; glGetIntegerv(GL_POLYGON_MODE, last_polygon_mode);
  85. GLint last_viewport[4]; glGetIntegerv(GL_VIEWPORT, last_viewport);
  86. GLint last_scissor_box[4]; glGetIntegerv(GL_SCISSOR_BOX, last_scissor_box);
  87. GLenum last_blend_src_rgb; glGetIntegerv(GL_BLEND_SRC_RGB, (GLint*)&last_blend_src_rgb);
  88. GLenum last_blend_dst_rgb; glGetIntegerv(GL_BLEND_DST_RGB, (GLint*)&last_blend_dst_rgb);
  89. GLenum last_blend_src_alpha; glGetIntegerv(GL_BLEND_SRC_ALPHA, (GLint*)&last_blend_src_alpha);
  90. GLenum last_blend_dst_alpha; glGetIntegerv(GL_BLEND_DST_ALPHA, (GLint*)&last_blend_dst_alpha);
  91. GLenum last_blend_equation_rgb; glGetIntegerv(GL_BLEND_EQUATION_RGB, (GLint*)&last_blend_equation_rgb);
  92. GLenum last_blend_equation_alpha; glGetIntegerv(GL_BLEND_EQUATION_ALPHA, (GLint*)&last_blend_equation_alpha);
  93. GLboolean last_enable_blend = glIsEnabled(GL_BLEND);
  94. GLboolean last_enable_cull_face = glIsEnabled(GL_CULL_FACE);
  95. GLboolean last_enable_depth_test = glIsEnabled(GL_DEPTH_TEST);
  96. GLboolean last_enable_scissor_test = glIsEnabled(GL_SCISSOR_TEST);
  97. // Setup render state: alpha-blending enabled, no face culling, no depth testing, scissor enabled, polygon fill
  98. glEnable(GL_BLEND);
  99. glBlendEquation(GL_FUNC_ADD);
  100. glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
  101. glDisable(GL_CULL_FACE);
  102. glDisable(GL_DEPTH_TEST);
  103. glEnable(GL_SCISSOR_TEST);
  104. glPolygonMode(GL_FRONT_AND_BACK, GL_FILL);
  105. // Setup viewport, orthographic projection matrix
  106. // Our visible imgui space lies from draw_data->DisplayPps (top left) to draw_data->DisplayPos+data_data->DisplaySize (bottom right). DisplayMin is typically (0,0) for single viewport apps.
  107. glViewport(0, 0, (GLsizei)fb_width, (GLsizei)fb_height);
  108. float L = draw_data->DisplayPos.x;
  109. float R = draw_data->DisplayPos.x + draw_data->DisplaySize.x;
  110. float T = draw_data->DisplayPos.y;
  111. float B = draw_data->DisplayPos.y + draw_data->DisplaySize.y;
  112. const float ortho_projection[4][4] =
  113. {
  114. { 2.0f/(R-L), 0.0f, 0.0f, 0.0f },
  115. { 0.0f, 2.0f/(T-B), 0.0f, 0.0f },
  116. { 0.0f, 0.0f, -1.0f, 0.0f },
  117. { (R+L)/(L-R), (T+B)/(B-T), 0.0f, 1.0f },
  118. };
  119. glUseProgram(g_ShaderHandle);
  120. glUniform1i(g_AttribLocationTex, 0);
  121. glUniformMatrix4fv(g_AttribLocationProjMtx, 1, GL_FALSE, &ortho_projection[0][0]);
  122. if (glBindSampler) glBindSampler(0, 0); // We use combined texture/sampler state. Applications using GL 3.3 may set that otherwise.
  123. // Recreate the VAO every time
  124. // (This is to easily allow multiple GL contexts. VAO are not shared among GL contexts, and we don't track creation/deletion of windows so we don't have an obvious key to use to cache them.)
  125. GLuint vao_handle = 0;
  126. glGenVertexArrays(1, &vao_handle);
  127. glBindVertexArray(vao_handle);
  128. glBindBuffer(GL_ARRAY_BUFFER, g_VboHandle);
  129. glEnableVertexAttribArray(g_AttribLocationPosition);
  130. glEnableVertexAttribArray(g_AttribLocationUV);
  131. glEnableVertexAttribArray(g_AttribLocationColor);
  132. glVertexAttribPointer(g_AttribLocationPosition, 2, GL_FLOAT, GL_FALSE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, pos));
  133. glVertexAttribPointer(g_AttribLocationUV, 2, GL_FLOAT, GL_FALSE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, uv));
  134. glVertexAttribPointer(g_AttribLocationColor, 4, GL_UNSIGNED_BYTE, GL_TRUE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, col));
  135. // Draw
  136. ImVec2 display_pos = draw_data->DisplayPos;
  137. for (int n = 0; n < draw_data->CmdListsCount; n++)
  138. {
  139. const ImDrawList* cmd_list = draw_data->CmdLists[n];
  140. const ImDrawIdx* idx_buffer_offset = 0;
  141. glBindBuffer(GL_ARRAY_BUFFER, g_VboHandle);
  142. glBufferData(GL_ARRAY_BUFFER, (GLsizeiptr)cmd_list->VtxBuffer.Size * sizeof(ImDrawVert), (const GLvoid*)cmd_list->VtxBuffer.Data, GL_STREAM_DRAW);
  143. glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, g_ElementsHandle);
  144. glBufferData(GL_ELEMENT_ARRAY_BUFFER, (GLsizeiptr)cmd_list->IdxBuffer.Size * sizeof(ImDrawIdx), (const GLvoid*)cmd_list->IdxBuffer.Data, GL_STREAM_DRAW);
  145. for (int cmd_i = 0; cmd_i < cmd_list->CmdBuffer.Size; cmd_i++)
  146. {
  147. const ImDrawCmd* pcmd = &cmd_list->CmdBuffer[cmd_i];
  148. if (pcmd->UserCallback)
  149. {
  150. // User callback (registered via ImDrawList::AddCallback)
  151. pcmd->UserCallback(cmd_list, pcmd);
  152. }
  153. else
  154. {
  155. ImVec4 clip_rect = ImVec4(pcmd->ClipRect.x - display_pos.x, pcmd->ClipRect.y - display_pos.y, pcmd->ClipRect.z - display_pos.x, pcmd->ClipRect.w - display_pos.y);
  156. if (clip_rect.x < fb_width && clip_rect.y < fb_height && clip_rect.z >= 0.0f && clip_rect.w >= 0.0f)
  157. {
  158. // Apply scissor/clipping rectangle
  159. glScissor((int)clip_rect.x, (int)(fb_height - clip_rect.w), (int)(clip_rect.z - clip_rect.x), (int)(clip_rect.w - clip_rect.y));
  160. // Bind texture, Draw
  161. glBindTexture(GL_TEXTURE_2D, (GLuint)(intptr_t)pcmd->TextureId);
  162. glDrawElements(GL_TRIANGLES, (GLsizei)pcmd->ElemCount, sizeof(ImDrawIdx) == 2 ? GL_UNSIGNED_SHORT : GL_UNSIGNED_INT, idx_buffer_offset);
  163. }
  164. }
  165. idx_buffer_offset += pcmd->ElemCount;
  166. }
  167. }
  168. glDeleteVertexArrays(1, &vao_handle);
  169. // Restore modified GL state
  170. glUseProgram(last_program);
  171. glBindTexture(GL_TEXTURE_2D, last_texture);
  172. if (glBindSampler) glBindSampler(0, last_sampler);
  173. glActiveTexture(last_active_texture);
  174. glBindVertexArray(last_vertex_array);
  175. glBindBuffer(GL_ARRAY_BUFFER, last_array_buffer);
  176. glBlendEquationSeparate(last_blend_equation_rgb, last_blend_equation_alpha);
  177. glBlendFuncSeparate(last_blend_src_rgb, last_blend_dst_rgb, last_blend_src_alpha, last_blend_dst_alpha);
  178. if (last_enable_blend) glEnable(GL_BLEND); else glDisable(GL_BLEND);
  179. if (last_enable_cull_face) glEnable(GL_CULL_FACE); else glDisable(GL_CULL_FACE);
  180. if (last_enable_depth_test) glEnable(GL_DEPTH_TEST); else glDisable(GL_DEPTH_TEST);
  181. if (last_enable_scissor_test) glEnable(GL_SCISSOR_TEST); else glDisable(GL_SCISSOR_TEST);
  182. glPolygonMode(GL_FRONT_AND_BACK, (GLenum)last_polygon_mode[0]);
  183. glViewport(last_viewport[0], last_viewport[1], (GLsizei)last_viewport[2], (GLsizei)last_viewport[3]);
  184. glScissor(last_scissor_box[0], last_scissor_box[1], (GLsizei)last_scissor_box[2], (GLsizei)last_scissor_box[3]);
  185. }
  186. bool ImGui_ImplOpenGL3_CreateFontsTexture()
  187. {
  188. // Build texture atlas
  189. ImGuiIO& io = ImGui::GetIO();
  190. unsigned char* pixels;
  191. int width, height;
  192. io.Fonts->GetTexDataAsRGBA32(&pixels, &width, &height); // Load as RGBA 32-bits (75% of the memory is wasted, but default font is so small) because it is more likely to be compatible with user's existing shaders. If your ImTextureId represent a higher-level concept than just a GL texture id, consider calling GetTexDataAsAlpha8() instead to save on GPU memory.
  193. // Upload texture to graphics system
  194. GLint last_texture;
  195. glGetIntegerv(GL_TEXTURE_BINDING_2D, &last_texture);
  196. glGenTextures(1, &g_FontTexture);
  197. glBindTexture(GL_TEXTURE_2D, g_FontTexture);
  198. glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
  199. glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
  200. glPixelStorei(GL_UNPACK_ROW_LENGTH, 0);
  201. glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, pixels);
  202. // Store our identifier
  203. io.Fonts->TexID = (void *)(intptr_t)g_FontTexture;
  204. // Restore state
  205. glBindTexture(GL_TEXTURE_2D, last_texture);
  206. return true;
  207. }
  208. void ImGui_ImplOpenGL3_DestroyFontsTexture()
  209. {
  210. if (g_FontTexture)
  211. {
  212. ImGuiIO& io = ImGui::GetIO();
  213. glDeleteTextures(1, &g_FontTexture);
  214. io.Fonts->TexID = 0;
  215. g_FontTexture = 0;
  216. }
  217. }
  218. bool ImGui_ImplOpenGL3_CreateDeviceObjects()
  219. {
  220. // Backup GL state
  221. GLint last_texture, last_array_buffer, last_vertex_array;
  222. glGetIntegerv(GL_TEXTURE_BINDING_2D, &last_texture);
  223. glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &last_array_buffer);
  224. glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &last_vertex_array);
  225. // Create shaders
  226. const GLchar *vertex_shader =
  227. "uniform mat4 ProjMtx;\n"
  228. "in vec2 Position;\n"
  229. "in vec2 UV;\n"
  230. "in vec4 Color;\n"
  231. "out vec2 Frag_UV;\n"
  232. "out vec4 Frag_Color;\n"
  233. "void main()\n"
  234. "{\n"
  235. " Frag_UV = UV;\n"
  236. " Frag_Color = Color;\n"
  237. " gl_Position = ProjMtx * vec4(Position.xy,0,1);\n"
  238. "}\n";
  239. const GLchar* fragment_shader =
  240. "uniform sampler2D Texture;\n"
  241. "in vec2 Frag_UV;\n"
  242. "in vec4 Frag_Color;\n"
  243. "out vec4 Out_Color;\n"
  244. "void main()\n"
  245. "{\n"
  246. " Out_Color = Frag_Color * texture( Texture, Frag_UV.st);\n"
  247. "}\n";
  248. const GLchar* vertex_shader_with_version[2] = { g_GlslVersion, vertex_shader };
  249. const GLchar* fragment_shader_with_version[2] = { g_GlslVersion, fragment_shader };
  250. g_ShaderHandle = glCreateProgram();
  251. g_VertHandle = glCreateShader(GL_VERTEX_SHADER);
  252. g_FragHandle = glCreateShader(GL_FRAGMENT_SHADER);
  253. glShaderSource(g_VertHandle, 2, vertex_shader_with_version, NULL);
  254. glShaderSource(g_FragHandle, 2, fragment_shader_with_version, NULL);
  255. glCompileShader(g_VertHandle);
  256. glCompileShader(g_FragHandle);
  257. glAttachShader(g_ShaderHandle, g_VertHandle);
  258. glAttachShader(g_ShaderHandle, g_FragHandle);
  259. glLinkProgram(g_ShaderHandle);
  260. g_AttribLocationTex = glGetUniformLocation(g_ShaderHandle, "Texture");
  261. g_AttribLocationProjMtx = glGetUniformLocation(g_ShaderHandle, "ProjMtx");
  262. g_AttribLocationPosition = glGetAttribLocation(g_ShaderHandle, "Position");
  263. g_AttribLocationUV = glGetAttribLocation(g_ShaderHandle, "UV");
  264. g_AttribLocationColor = glGetAttribLocation(g_ShaderHandle, "Color");
  265. glGenBuffers(1, &g_VboHandle);
  266. glGenBuffers(1, &g_ElementsHandle);
  267. ImGui_ImplOpenGL3_CreateFontsTexture();
  268. // Restore modified GL state
  269. glBindTexture(GL_TEXTURE_2D, last_texture);
  270. glBindBuffer(GL_ARRAY_BUFFER, last_array_buffer);
  271. glBindVertexArray(last_vertex_array);
  272. return true;
  273. }
  274. void ImGui_ImplOpenGL3_DestroyDeviceObjects()
  275. {
  276. if (g_VboHandle) glDeleteBuffers(1, &g_VboHandle);
  277. if (g_ElementsHandle) glDeleteBuffers(1, &g_ElementsHandle);
  278. g_VboHandle = g_ElementsHandle = 0;
  279. if (g_ShaderHandle && g_VertHandle) glDetachShader(g_ShaderHandle, g_VertHandle);
  280. if (g_VertHandle) glDeleteShader(g_VertHandle);
  281. g_VertHandle = 0;
  282. if (g_ShaderHandle && g_FragHandle) glDetachShader(g_ShaderHandle, g_FragHandle);
  283. if (g_FragHandle) glDeleteShader(g_FragHandle);
  284. g_FragHandle = 0;
  285. if (g_ShaderHandle) glDeleteProgram(g_ShaderHandle);
  286. g_ShaderHandle = 0;
  287. ImGui_ImplOpenGL3_DestroyFontsTexture();
  288. }
  289. //--------------------------------------------------------------------------------------------------------
  290. // MULTI-VIEWPORT / PLATFORM INTERFACE SUPPORT
  291. // This is an _advanced_ and _optional_ feature, allowing the back-end to create and handle multiple viewports simultaneously.
  292. // If you are new to dear imgui or creating a new binding for dear imgui, it is recommended that you completely ignore this section first..
  293. //--------------------------------------------------------------------------------------------------------
  294. static void ImGui_ImplOpenGL3_RenderWindow(ImGuiViewport* viewport, void*)
  295. {
  296. if (!(viewport->Flags & ImGuiViewportFlags_NoRendererClear))
  297. {
  298. ImVec4 clear_color = ImVec4(0.0f, 0.0f, 0.0f, 1.0f);
  299. glClearColor(clear_color.x, clear_color.y, clear_color.z, clear_color.w);
  300. glClear(GL_COLOR_BUFFER_BIT);
  301. }
  302. ImGui_ImplOpenGL3_RenderDrawData(viewport->DrawData);
  303. }
  304. static void ImGui_ImplOpenGL3_InitPlatformInterface()
  305. {
  306. ImGuiPlatformIO& platform_io = ImGui::GetPlatformIO();
  307. platform_io.Renderer_RenderWindow = ImGui_ImplOpenGL3_RenderWindow;
  308. }
  309. static void ImGui_ImplOpenGL3_ShutdownPlatformInterface()
  310. {
  311. ImGui::DestroyPlatformWindows();
  312. }