imgui_impl_opengl3.cpp 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758
  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: Multi-viewport support. Enable with 'io.ConfigFlags |= ImGuiConfigFlags_ViewportsEnable'.
  8. // [x] Renderer: Desktop GL only: Support for large meshes (64k+ vertices) with 16-bit indices.
  9. // You can copy and use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
  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. // CHANGELOG
  13. // (minor and older changes stripped away, please see git history for details)
  14. // 2021-XX-XX: Platform: Added support for multiple windows via the ImGuiPlatformIO interface.
  15. // 2021-01-03: OpenGL: Backup, setup and restore GL_STENCIL_TEST state.
  16. // 2020-10-23: OpenGL: Backup, setup and restore GL_PRIMITIVE_RESTART state.
  17. // 2020-10-15: OpenGL: Use glGetString(GL_VERSION) instead of glGetIntegerv(GL_MAJOR_VERSION, ...) when the later returns zero (e.g. Desktop GL 2.x)
  18. // 2020-09-17: OpenGL: Fix to avoid compiling/calling glBindSampler() on ES or pre 3.3 context which have the defines set by a loader.
  19. // 2020-07-10: OpenGL: Added support for glad2 OpenGL loader.
  20. // 2020-05-08: OpenGL: Made default GLSL version 150 (instead of 130) on OSX.
  21. // 2020-04-21: OpenGL: Fixed handling of glClipControl(GL_UPPER_LEFT) by inverting projection matrix.
  22. // 2020-04-12: OpenGL: Fixed context version check mistakenly testing for 4.0+ instead of 3.2+ to enable ImGuiBackendFlags_RendererHasVtxOffset.
  23. // 2020-03-24: OpenGL: Added support for glbinding 2.x OpenGL loader.
  24. // 2020-01-07: OpenGL: Added support for glbinding 3.x OpenGL loader.
  25. // 2019-10-25: OpenGL: Using a combination of GL define and runtime GL version to decide whether to use glDrawElementsBaseVertex(). Fix building with pre-3.2 GL loaders.
  26. // 2019-09-22: OpenGL: Detect default GL loader using __has_include compiler facility.
  27. // 2019-09-16: OpenGL: Tweak initialization code to allow application calling ImGui_ImplOpenGL3_CreateFontsTexture() before the first NewFrame() call.
  28. // 2019-05-29: OpenGL: Desktop GL only: Added support for large mesh (64K+ vertices), enable ImGuiBackendFlags_RendererHasVtxOffset flag.
  29. // 2019-04-30: OpenGL: Added support for special ImDrawCallback_ResetRenderState callback to reset render state.
  30. // 2019-03-29: OpenGL: Not calling glBindBuffer more than necessary in the render loop.
  31. // 2019-03-15: OpenGL: Added a GL call + comments in ImGui_ImplOpenGL3_Init() to detect uninitialized GL function loaders early.
  32. // 2019-03-03: OpenGL: Fix support for ES 2.0 (WebGL 1.0).
  33. // 2019-02-20: OpenGL: Fix for OSX not supporting OpenGL 4.5, we don't try to read GL_CLIP_ORIGIN even if defined by the headers/loader.
  34. // 2019-02-11: OpenGL: Projecting clipping rectangles correctly using draw_data->FramebufferScale to allow multi-viewports for retina display.
  35. // 2019-02-01: OpenGL: Using GLSL 410 shaders for any version over 410 (e.g. 430, 450).
  36. // 2018-11-30: Misc: Setting up io.BackendRendererName so it can be displayed in the About Window.
  37. // 2018-11-13: OpenGL: Support for GL 4.5's glClipControl(GL_UPPER_LEFT) / GL_CLIP_ORIGIN.
  38. // 2018-08-29: OpenGL: Added support for more OpenGL loaders: glew and glad, with comments indicative that any loader can be used.
  39. // 2018-08-09: OpenGL: Default to OpenGL ES 3 on iOS and Android. GLSL version default to "#version 300 ES".
  40. // 2018-07-30: OpenGL: Support for GLSL 300 ES and 410 core. Fixes for Emscripten compilation.
  41. // 2018-07-10: OpenGL: Support for more GLSL versions (based on the GLSL version string). Added error output when shaders fail to compile/link.
  42. // 2018-06-08: Misc: Extracted imgui_impl_opengl3.cpp/.h away from the old combined GLFW/SDL+OpenGL3 examples.
  43. // 2018-06-08: OpenGL: Use draw_data->DisplayPos and draw_data->DisplaySize to setup projection matrix and clipping rectangle.
  44. // 2018-05-25: OpenGL: Removed unnecessary backup/restore of GL_ELEMENT_ARRAY_BUFFER_BINDING since this is part of the VAO state.
  45. // 2018-05-14: OpenGL: Making the call to glBindSampler() optional so 3.2 context won't fail if the function is a NULL pointer.
  46. // 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".
  47. // 2018-02-23: OpenGL: Create the VAO in the render function so the setup can more easily be used with multiple shared GL context.
  48. // 2018-02-16: Misc: Obsoleted the io.RenderDrawListsFn callback and exposed ImGui_ImplSdlGL3_RenderDrawData() in the .h file so you can call it yourself.
  49. // 2018-01-07: OpenGL: Changed GLSL shader version from 330 to 150.
  50. // 2017-09-01: OpenGL: Save and restore current bound sampler. Save and restore current polygon mode.
  51. // 2017-05-01: OpenGL: Fixed save and restore of current blend func state.
  52. // 2017-05-01: OpenGL: Fixed save and restore of current GL_ACTIVE_TEXTURE.
  53. // 2016-09-05: OpenGL: Fixed save and restore of current scissor rectangle.
  54. // 2016-07-29: OpenGL: Explicitly setting GL_UNPACK_ROW_LENGTH to reduce issues because SDL changes it. (#752)
  55. //----------------------------------------
  56. // OpenGL GLSL GLSL
  57. // version version string
  58. //----------------------------------------
  59. // 2.0 110 "#version 110"
  60. // 2.1 120 "#version 120"
  61. // 3.0 130 "#version 130"
  62. // 3.1 140 "#version 140"
  63. // 3.2 150 "#version 150"
  64. // 3.3 330 "#version 330 core"
  65. // 4.0 400 "#version 400 core"
  66. // 4.1 410 "#version 410 core"
  67. // 4.2 420 "#version 410 core"
  68. // 4.3 430 "#version 430 core"
  69. // ES 2.0 100 "#version 100" = WebGL 1.0
  70. // ES 3.0 300 "#version 300 es" = WebGL 2.0
  71. //----------------------------------------
  72. #if defined(_MSC_VER) && !defined(_CRT_SECURE_NO_WARNINGS)
  73. #define _CRT_SECURE_NO_WARNINGS
  74. #endif
  75. #include "imgui.h"
  76. #include "imgui_impl_opengl3.h"
  77. #include <stdio.h>
  78. #if defined(_MSC_VER) && _MSC_VER <= 1500 // MSVC 2008 or earlier
  79. #include <stddef.h> // intptr_t
  80. #else
  81. #include <stdint.h> // intptr_t
  82. #endif
  83. // GL includes
  84. #if defined(IMGUI_IMPL_OPENGL_ES2)
  85. #include <GLES2/gl2.h>
  86. #elif defined(IMGUI_IMPL_OPENGL_ES3)
  87. #if (defined(__APPLE__) && (TARGET_OS_IOS || TARGET_OS_TV))
  88. #include <OpenGLES/ES3/gl.h> // Use GL ES 3
  89. #else
  90. #include <GLES3/gl3.h> // Use GL ES 3
  91. #endif
  92. #else
  93. // About Desktop OpenGL function loaders:
  94. // Modern desktop OpenGL doesn't have a standard portable header file to load OpenGL function pointers.
  95. // Helper libraries are often used for this purpose! Here we are supporting a few common ones (gl3w, glew, glad).
  96. // You may use another loader/header of your choice (glext, glLoadGen, etc.), or chose to manually implement your own.
  97. #if defined(IMGUI_IMPL_OPENGL_LOADER_GL3W)
  98. #include <GL/gl3w.h> // Needs to be initialized with gl3wInit() in user's code
  99. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLEW)
  100. #include <GL/glew.h> // Needs to be initialized with glewInit() in user's code.
  101. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLAD)
  102. #include <glad/glad.h> // Needs to be initialized with gladLoadGL() in user's code.
  103. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLAD2)
  104. #include <glad/gl.h> // Needs to be initialized with gladLoadGL(...) or gladLoaderLoadGL() in user's code.
  105. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING2)
  106. #ifndef GLFW_INCLUDE_NONE
  107. #define GLFW_INCLUDE_NONE // GLFW including OpenGL headers causes ambiguity or multiple definition errors.
  108. #endif
  109. #include <glbinding/Binding.h> // Needs to be initialized with glbinding::Binding::initialize() in user's code.
  110. #include <glbinding/gl/gl.h>
  111. using namespace gl;
  112. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING3)
  113. #ifndef GLFW_INCLUDE_NONE
  114. #define GLFW_INCLUDE_NONE // GLFW including OpenGL headers causes ambiguity or multiple definition errors.
  115. #endif
  116. #include <glbinding/glbinding.h>// Needs to be initialized with glbinding::initialize() in user's code.
  117. #include <glbinding/gl/gl.h>
  118. using namespace gl;
  119. #else
  120. #include IMGUI_IMPL_OPENGL_LOADER_CUSTOM
  121. #endif
  122. #endif
  123. // Desktop GL 3.2+ has glDrawElementsBaseVertex() which GL ES and WebGL don't have.
  124. #if !defined(IMGUI_IMPL_OPENGL_ES2) && !defined(IMGUI_IMPL_OPENGL_ES3) && defined(GL_VERSION_3_2)
  125. #define IMGUI_IMPL_OPENGL_MAY_HAVE_VTX_OFFSET
  126. #endif
  127. // Desktop GL 3.3+ has glBindSampler()
  128. #if !defined(IMGUI_IMPL_OPENGL_ES2) && !defined(IMGUI_IMPL_OPENGL_ES3) && defined(GL_VERSION_3_3)
  129. #define IMGUI_IMPL_OPENGL_MAY_HAVE_BIND_SAMPLER
  130. #endif
  131. // Desktop GL 3.1+ has GL_PRIMITIVE_RESTART state
  132. #if !defined(IMGUI_IMPL_OPENGL_ES2) && !defined(IMGUI_IMPL_OPENGL_ES3) && defined(GL_VERSION_3_1)
  133. #define IMGUI_IMPL_OPENGL_MAY_HAVE_PRIMITIVE_RESTART
  134. #endif
  135. // OpenGL Data
  136. static GLuint g_GlVersion = 0; // Extracted at runtime using GL_MAJOR_VERSION, GL_MINOR_VERSION queries (e.g. 320 for GL 3.2)
  137. static char g_GlslVersionString[32] = ""; // Specified by user or detected based on compile time GL settings.
  138. static GLuint g_FontTexture = 0;
  139. static GLuint g_ShaderHandle = 0, g_VertHandle = 0, g_FragHandle = 0;
  140. static GLint g_AttribLocationTex = 0, g_AttribLocationProjMtx = 0; // Uniforms location
  141. static GLuint g_AttribLocationVtxPos = 0, g_AttribLocationVtxUV = 0, g_AttribLocationVtxColor = 0; // Vertex attributes location
  142. static unsigned int g_VboHandle = 0, g_ElementsHandle = 0;
  143. // Forward Declarations
  144. static void ImGui_ImplOpenGL3_InitPlatformInterface();
  145. static void ImGui_ImplOpenGL3_ShutdownPlatformInterface();
  146. // Functions
  147. bool ImGui_ImplOpenGL3_Init(const char* glsl_version)
  148. {
  149. // Query for GL version (e.g. 320 for GL 3.2)
  150. #if !defined(IMGUI_IMPL_OPENGL_ES2)
  151. GLint major = 0;
  152. GLint minor = 0;
  153. glGetIntegerv(GL_MAJOR_VERSION, &major);
  154. glGetIntegerv(GL_MINOR_VERSION, &minor);
  155. if (major == 0 && minor == 0)
  156. {
  157. // Query GL_VERSION in desktop GL 2.x, the string will start with "<major>.<minor>"
  158. const char* gl_version = (const char*)glGetString(GL_VERSION);
  159. sscanf(gl_version, "%d.%d", &major, &minor);
  160. }
  161. g_GlVersion = (GLuint)(major * 100 + minor * 10);
  162. #else
  163. g_GlVersion = 200; // GLES 2
  164. #endif
  165. // Setup backend capabilities flags
  166. ImGuiIO& io = ImGui::GetIO();
  167. io.BackendRendererName = "imgui_impl_opengl3";
  168. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_VTX_OFFSET
  169. if (g_GlVersion >= 320)
  170. io.BackendFlags |= ImGuiBackendFlags_RendererHasVtxOffset; // We can honor the ImDrawCmd::VtxOffset field, allowing for large meshes.
  171. #endif
  172. io.BackendFlags |= ImGuiBackendFlags_RendererHasViewports; // We can create multi-viewports on the Renderer side (optional)
  173. // Store GLSL version string so we can refer to it later in case we recreate shaders.
  174. // Note: GLSL version is NOT the same as GL version. Leave this to NULL if unsure.
  175. #if defined(IMGUI_IMPL_OPENGL_ES2)
  176. if (glsl_version == NULL)
  177. glsl_version = "#version 100";
  178. #elif defined(IMGUI_IMPL_OPENGL_ES3)
  179. if (glsl_version == NULL)
  180. glsl_version = "#version 300 es";
  181. #elif defined(__APPLE__)
  182. if (glsl_version == NULL)
  183. glsl_version = "#version 150";
  184. #else
  185. if (glsl_version == NULL)
  186. glsl_version = "#version 130";
  187. #endif
  188. IM_ASSERT((int)strlen(glsl_version) + 2 < IM_ARRAYSIZE(g_GlslVersionString));
  189. strcpy(g_GlslVersionString, glsl_version);
  190. strcat(g_GlslVersionString, "\n");
  191. // Debugging construct to make it easily visible in the IDE and debugger which GL loader has been selected.
  192. // The code actually never uses the 'gl_loader' variable! It is only here so you can read it!
  193. // If auto-detection fails or doesn't select the same GL loader file as used by your application,
  194. // you are likely to get a crash below.
  195. // You can explicitly select a loader by using '#define IMGUI_IMPL_OPENGL_LOADER_XXX' in imconfig.h or compiler command-line.
  196. const char* gl_loader = "Unknown";
  197. IM_UNUSED(gl_loader);
  198. #if defined(IMGUI_IMPL_OPENGL_LOADER_GL3W)
  199. gl_loader = "GL3W";
  200. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLEW)
  201. gl_loader = "GLEW";
  202. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLAD)
  203. gl_loader = "GLAD";
  204. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLAD2)
  205. gl_loader = "GLAD2";
  206. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING2)
  207. gl_loader = "glbinding2";
  208. #elif defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING3)
  209. gl_loader = "glbinding3";
  210. #elif defined(IMGUI_IMPL_OPENGL_LOADER_CUSTOM)
  211. gl_loader = "custom";
  212. #else
  213. gl_loader = "none";
  214. #endif
  215. // Make an arbitrary GL call (we don't actually need the result)
  216. // IF YOU GET A CRASH HERE: it probably means that you haven't initialized the OpenGL function loader used by this code.
  217. // Desktop OpenGL 3/4 need a function loader. See the IMGUI_IMPL_OPENGL_LOADER_xxx explanation above.
  218. GLint current_texture;
  219. glGetIntegerv(GL_TEXTURE_BINDING_2D, &current_texture);
  220. if (io.ConfigFlags & ImGuiConfigFlags_ViewportsEnable)
  221. ImGui_ImplOpenGL3_InitPlatformInterface();
  222. return true;
  223. }
  224. void ImGui_ImplOpenGL3_Shutdown()
  225. {
  226. ImGui_ImplOpenGL3_ShutdownPlatformInterface();
  227. ImGui_ImplOpenGL3_DestroyDeviceObjects();
  228. }
  229. void ImGui_ImplOpenGL3_NewFrame()
  230. {
  231. if (!g_ShaderHandle)
  232. ImGui_ImplOpenGL3_CreateDeviceObjects();
  233. }
  234. static void ImGui_ImplOpenGL3_SetupRenderState(ImDrawData* draw_data, int fb_width, int fb_height, GLuint vertex_array_object)
  235. {
  236. // Setup render state: alpha-blending enabled, no face culling, no depth testing, scissor enabled, polygon fill
  237. glEnable(GL_BLEND);
  238. glBlendEquation(GL_FUNC_ADD);
  239. glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
  240. glDisable(GL_CULL_FACE);
  241. glDisable(GL_DEPTH_TEST);
  242. glDisable(GL_STENCIL_TEST);
  243. glEnable(GL_SCISSOR_TEST);
  244. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_PRIMITIVE_RESTART
  245. if (g_GlVersion >= 310)
  246. glDisable(GL_PRIMITIVE_RESTART);
  247. #endif
  248. #ifdef GL_POLYGON_MODE
  249. glPolygonMode(GL_FRONT_AND_BACK, GL_FILL);
  250. #endif
  251. // Support for GL 4.5 rarely used glClipControl(GL_UPPER_LEFT)
  252. #if defined(GL_CLIP_ORIGIN) && !defined(__APPLE__)
  253. bool clip_origin_lower_left = true;
  254. GLenum current_clip_origin = 0; glGetIntegerv(GL_CLIP_ORIGIN, (GLint*)&current_clip_origin);
  255. if (current_clip_origin == GL_UPPER_LEFT)
  256. clip_origin_lower_left = false;
  257. #endif
  258. // Setup viewport, orthographic projection matrix
  259. // Our visible imgui space lies from draw_data->DisplayPos (top left) to draw_data->DisplayPos+data_data->DisplaySize (bottom right). DisplayPos is (0,0) for single viewport apps.
  260. glViewport(0, 0, (GLsizei)fb_width, (GLsizei)fb_height);
  261. float L = draw_data->DisplayPos.x;
  262. float R = draw_data->DisplayPos.x + draw_data->DisplaySize.x;
  263. float T = draw_data->DisplayPos.y;
  264. float B = draw_data->DisplayPos.y + draw_data->DisplaySize.y;
  265. #if defined(GL_CLIP_ORIGIN) && !defined(__APPLE__)
  266. if (!clip_origin_lower_left) { float tmp = T; T = B; B = tmp; } // Swap top and bottom if origin is upper left
  267. #endif
  268. const float ortho_projection[4][4] =
  269. {
  270. { 2.0f/(R-L), 0.0f, 0.0f, 0.0f },
  271. { 0.0f, 2.0f/(T-B), 0.0f, 0.0f },
  272. { 0.0f, 0.0f, -1.0f, 0.0f },
  273. { (R+L)/(L-R), (T+B)/(B-T), 0.0f, 1.0f },
  274. };
  275. glUseProgram(g_ShaderHandle);
  276. glUniform1i(g_AttribLocationTex, 0);
  277. glUniformMatrix4fv(g_AttribLocationProjMtx, 1, GL_FALSE, &ortho_projection[0][0]);
  278. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_BIND_SAMPLER
  279. if (g_GlVersion >= 330)
  280. glBindSampler(0, 0); // We use combined texture/sampler state. Applications using GL 3.3 may set that otherwise.
  281. #endif
  282. (void)vertex_array_object;
  283. #ifndef IMGUI_IMPL_OPENGL_ES2
  284. glBindVertexArray(vertex_array_object);
  285. #endif
  286. // Bind vertex/index buffers and setup attributes for ImDrawVert
  287. glBindBuffer(GL_ARRAY_BUFFER, g_VboHandle);
  288. glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, g_ElementsHandle);
  289. glEnableVertexAttribArray(g_AttribLocationVtxPos);
  290. glEnableVertexAttribArray(g_AttribLocationVtxUV);
  291. glEnableVertexAttribArray(g_AttribLocationVtxColor);
  292. glVertexAttribPointer(g_AttribLocationVtxPos, 2, GL_FLOAT, GL_FALSE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, pos));
  293. glVertexAttribPointer(g_AttribLocationVtxUV, 2, GL_FLOAT, GL_FALSE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, uv));
  294. glVertexAttribPointer(g_AttribLocationVtxColor, 4, GL_UNSIGNED_BYTE, GL_TRUE, sizeof(ImDrawVert), (GLvoid*)IM_OFFSETOF(ImDrawVert, col));
  295. }
  296. // OpenGL3 Render function.
  297. // Note that this implementation is little overcomplicated because we are saving/setting up/restoring every OpenGL state explicitly.
  298. // This is in order to be able to run within an OpenGL engine that doesn't do so.
  299. void ImGui_ImplOpenGL3_RenderDrawData(ImDrawData* draw_data)
  300. {
  301. // Avoid rendering when minimized, scale coordinates for retina displays (screen coordinates != framebuffer coordinates)
  302. int fb_width = (int)(draw_data->DisplaySize.x * draw_data->FramebufferScale.x);
  303. int fb_height = (int)(draw_data->DisplaySize.y * draw_data->FramebufferScale.y);
  304. if (fb_width <= 0 || fb_height <= 0)
  305. return;
  306. // Backup GL state
  307. GLenum last_active_texture; glGetIntegerv(GL_ACTIVE_TEXTURE, (GLint*)&last_active_texture);
  308. glActiveTexture(GL_TEXTURE0);
  309. GLuint last_program; glGetIntegerv(GL_CURRENT_PROGRAM, (GLint*)&last_program);
  310. GLuint last_texture; glGetIntegerv(GL_TEXTURE_BINDING_2D, (GLint*)&last_texture);
  311. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_BIND_SAMPLER
  312. GLuint last_sampler; if (g_GlVersion >= 330) { glGetIntegerv(GL_SAMPLER_BINDING, (GLint*)&last_sampler); } else { last_sampler = 0; }
  313. #endif
  314. GLuint last_array_buffer; glGetIntegerv(GL_ARRAY_BUFFER_BINDING, (GLint*)&last_array_buffer);
  315. #ifndef IMGUI_IMPL_OPENGL_ES2
  316. GLuint last_vertex_array_object; glGetIntegerv(GL_VERTEX_ARRAY_BINDING, (GLint*)&last_vertex_array_object);
  317. #endif
  318. #ifdef GL_POLYGON_MODE
  319. GLint last_polygon_mode[2]; glGetIntegerv(GL_POLYGON_MODE, last_polygon_mode);
  320. #endif
  321. GLint last_viewport[4]; glGetIntegerv(GL_VIEWPORT, last_viewport);
  322. GLint last_scissor_box[4]; glGetIntegerv(GL_SCISSOR_BOX, last_scissor_box);
  323. GLenum last_blend_src_rgb; glGetIntegerv(GL_BLEND_SRC_RGB, (GLint*)&last_blend_src_rgb);
  324. GLenum last_blend_dst_rgb; glGetIntegerv(GL_BLEND_DST_RGB, (GLint*)&last_blend_dst_rgb);
  325. GLenum last_blend_src_alpha; glGetIntegerv(GL_BLEND_SRC_ALPHA, (GLint*)&last_blend_src_alpha);
  326. GLenum last_blend_dst_alpha; glGetIntegerv(GL_BLEND_DST_ALPHA, (GLint*)&last_blend_dst_alpha);
  327. GLenum last_blend_equation_rgb; glGetIntegerv(GL_BLEND_EQUATION_RGB, (GLint*)&last_blend_equation_rgb);
  328. GLenum last_blend_equation_alpha; glGetIntegerv(GL_BLEND_EQUATION_ALPHA, (GLint*)&last_blend_equation_alpha);
  329. GLboolean last_enable_blend = glIsEnabled(GL_BLEND);
  330. GLboolean last_enable_cull_face = glIsEnabled(GL_CULL_FACE);
  331. GLboolean last_enable_depth_test = glIsEnabled(GL_DEPTH_TEST);
  332. GLboolean last_enable_stencil_test = glIsEnabled(GL_STENCIL_TEST);
  333. GLboolean last_enable_scissor_test = glIsEnabled(GL_SCISSOR_TEST);
  334. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_PRIMITIVE_RESTART
  335. GLboolean last_enable_primitive_restart = (g_GlVersion >= 310) ? glIsEnabled(GL_PRIMITIVE_RESTART) : GL_FALSE;
  336. #endif
  337. // Setup desired GL state
  338. // Recreate the VAO every time (this is to easily allow multiple GL contexts to be rendered to. VAO are not shared among GL contexts)
  339. // The renderer would actually work without any VAO bound, but then our VertexAttrib calls would overwrite the default one currently bound.
  340. GLuint vertex_array_object = 0;
  341. #ifndef IMGUI_IMPL_OPENGL_ES2
  342. glGenVertexArrays(1, &vertex_array_object);
  343. #endif
  344. ImGui_ImplOpenGL3_SetupRenderState(draw_data, fb_width, fb_height, vertex_array_object);
  345. // Will project scissor/clipping rectangles into framebuffer space
  346. ImVec2 clip_off = draw_data->DisplayPos; // (0,0) unless using multi-viewports
  347. ImVec2 clip_scale = draw_data->FramebufferScale; // (1,1) unless using retina display which are often (2,2)
  348. // Render command lists
  349. for (int n = 0; n < draw_data->CmdListsCount; n++)
  350. {
  351. const ImDrawList* cmd_list = draw_data->CmdLists[n];
  352. // Upload vertex/index buffers
  353. glBufferData(GL_ARRAY_BUFFER, (GLsizeiptr)cmd_list->VtxBuffer.Size * (int)sizeof(ImDrawVert), (const GLvoid*)cmd_list->VtxBuffer.Data, GL_STREAM_DRAW);
  354. glBufferData(GL_ELEMENT_ARRAY_BUFFER, (GLsizeiptr)cmd_list->IdxBuffer.Size * (int)sizeof(ImDrawIdx), (const GLvoid*)cmd_list->IdxBuffer.Data, GL_STREAM_DRAW);
  355. for (int cmd_i = 0; cmd_i < cmd_list->CmdBuffer.Size; cmd_i++)
  356. {
  357. const ImDrawCmd* pcmd = &cmd_list->CmdBuffer[cmd_i];
  358. if (pcmd->UserCallback != NULL)
  359. {
  360. // User callback, registered via ImDrawList::AddCallback()
  361. // (ImDrawCallback_ResetRenderState is a special callback value used by the user to request the renderer to reset render state.)
  362. if (pcmd->UserCallback == ImDrawCallback_ResetRenderState)
  363. ImGui_ImplOpenGL3_SetupRenderState(draw_data, fb_width, fb_height, vertex_array_object);
  364. else
  365. pcmd->UserCallback(cmd_list, pcmd);
  366. }
  367. else
  368. {
  369. // Project scissor/clipping rectangles into framebuffer space
  370. ImVec4 clip_rect;
  371. clip_rect.x = (pcmd->ClipRect.x - clip_off.x) * clip_scale.x;
  372. clip_rect.y = (pcmd->ClipRect.y - clip_off.y) * clip_scale.y;
  373. clip_rect.z = (pcmd->ClipRect.z - clip_off.x) * clip_scale.x;
  374. clip_rect.w = (pcmd->ClipRect.w - clip_off.y) * clip_scale.y;
  375. if (clip_rect.x < fb_width && clip_rect.y < fb_height && clip_rect.z >= 0.0f && clip_rect.w >= 0.0f)
  376. {
  377. // Apply scissor/clipping rectangle
  378. 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));
  379. // Bind texture, Draw
  380. glBindTexture(GL_TEXTURE_2D, (GLuint)(intptr_t)pcmd->TextureId);
  381. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_VTX_OFFSET
  382. if (g_GlVersion >= 320)
  383. glDrawElementsBaseVertex(GL_TRIANGLES, (GLsizei)pcmd->ElemCount, sizeof(ImDrawIdx) == 2 ? GL_UNSIGNED_SHORT : GL_UNSIGNED_INT, (void*)(intptr_t)(pcmd->IdxOffset * sizeof(ImDrawIdx)), (GLint)pcmd->VtxOffset);
  384. else
  385. #endif
  386. glDrawElements(GL_TRIANGLES, (GLsizei)pcmd->ElemCount, sizeof(ImDrawIdx) == 2 ? GL_UNSIGNED_SHORT : GL_UNSIGNED_INT, (void*)(intptr_t)(pcmd->IdxOffset * sizeof(ImDrawIdx)));
  387. }
  388. }
  389. }
  390. }
  391. // Destroy the temporary VAO
  392. #ifndef IMGUI_IMPL_OPENGL_ES2
  393. glDeleteVertexArrays(1, &vertex_array_object);
  394. #endif
  395. // Restore modified GL state
  396. glUseProgram(last_program);
  397. glBindTexture(GL_TEXTURE_2D, last_texture);
  398. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_BIND_SAMPLER
  399. if (g_GlVersion >= 330)
  400. glBindSampler(0, last_sampler);
  401. #endif
  402. glActiveTexture(last_active_texture);
  403. #ifndef IMGUI_IMPL_OPENGL_ES2
  404. glBindVertexArray(last_vertex_array_object);
  405. #endif
  406. glBindBuffer(GL_ARRAY_BUFFER, last_array_buffer);
  407. glBlendEquationSeparate(last_blend_equation_rgb, last_blend_equation_alpha);
  408. glBlendFuncSeparate(last_blend_src_rgb, last_blend_dst_rgb, last_blend_src_alpha, last_blend_dst_alpha);
  409. if (last_enable_blend) glEnable(GL_BLEND); else glDisable(GL_BLEND);
  410. if (last_enable_cull_face) glEnable(GL_CULL_FACE); else glDisable(GL_CULL_FACE);
  411. if (last_enable_depth_test) glEnable(GL_DEPTH_TEST); else glDisable(GL_DEPTH_TEST);
  412. if (last_enable_stencil_test) glEnable(GL_STENCIL_TEST); else glDisable(GL_STENCIL_TEST);
  413. if (last_enable_scissor_test) glEnable(GL_SCISSOR_TEST); else glDisable(GL_SCISSOR_TEST);
  414. #ifdef IMGUI_IMPL_OPENGL_MAY_HAVE_PRIMITIVE_RESTART
  415. if (g_GlVersion >= 310) { if (last_enable_primitive_restart) glEnable(GL_PRIMITIVE_RESTART); else glDisable(GL_PRIMITIVE_RESTART); }
  416. #endif
  417. #ifdef GL_POLYGON_MODE
  418. glPolygonMode(GL_FRONT_AND_BACK, (GLenum)last_polygon_mode[0]);
  419. #endif
  420. glViewport(last_viewport[0], last_viewport[1], (GLsizei)last_viewport[2], (GLsizei)last_viewport[3]);
  421. glScissor(last_scissor_box[0], last_scissor_box[1], (GLsizei)last_scissor_box[2], (GLsizei)last_scissor_box[3]);
  422. }
  423. bool ImGui_ImplOpenGL3_CreateFontsTexture()
  424. {
  425. // Build texture atlas
  426. ImGuiIO& io = ImGui::GetIO();
  427. unsigned char* pixels;
  428. int width, height;
  429. io.Fonts->GetTexDataAsRGBA32(&pixels, &width, &height); // Load as RGBA 32-bit (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.
  430. // Upload texture to graphics system
  431. GLint last_texture;
  432. glGetIntegerv(GL_TEXTURE_BINDING_2D, &last_texture);
  433. glGenTextures(1, &g_FontTexture);
  434. glBindTexture(GL_TEXTURE_2D, g_FontTexture);
  435. glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
  436. glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
  437. #ifdef GL_UNPACK_ROW_LENGTH
  438. glPixelStorei(GL_UNPACK_ROW_LENGTH, 0);
  439. #endif
  440. glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, pixels);
  441. // Store our identifier
  442. io.Fonts->TexID = (ImTextureID)(intptr_t)g_FontTexture;
  443. // Restore state
  444. glBindTexture(GL_TEXTURE_2D, last_texture);
  445. return true;
  446. }
  447. void ImGui_ImplOpenGL3_DestroyFontsTexture()
  448. {
  449. if (g_FontTexture)
  450. {
  451. ImGuiIO& io = ImGui::GetIO();
  452. glDeleteTextures(1, &g_FontTexture);
  453. io.Fonts->TexID = 0;
  454. g_FontTexture = 0;
  455. }
  456. }
  457. // If you get an error please report on github. You may try different GL context version or GLSL version. See GL<>GLSL version table at the top of this file.
  458. static bool CheckShader(GLuint handle, const char* desc)
  459. {
  460. GLint status = 0, log_length = 0;
  461. glGetShaderiv(handle, GL_COMPILE_STATUS, &status);
  462. glGetShaderiv(handle, GL_INFO_LOG_LENGTH, &log_length);
  463. if ((GLboolean)status == GL_FALSE)
  464. fprintf(stderr, "ERROR: ImGui_ImplOpenGL3_CreateDeviceObjects: failed to compile %s!\n", desc);
  465. if (log_length > 1)
  466. {
  467. ImVector<char> buf;
  468. buf.resize((int)(log_length + 1));
  469. glGetShaderInfoLog(handle, log_length, NULL, (GLchar*)buf.begin());
  470. fprintf(stderr, "%s\n", buf.begin());
  471. }
  472. return (GLboolean)status == GL_TRUE;
  473. }
  474. // If you get an error please report on GitHub. You may try different GL context version or GLSL version.
  475. static bool CheckProgram(GLuint handle, const char* desc)
  476. {
  477. GLint status = 0, log_length = 0;
  478. glGetProgramiv(handle, GL_LINK_STATUS, &status);
  479. glGetProgramiv(handle, GL_INFO_LOG_LENGTH, &log_length);
  480. if ((GLboolean)status == GL_FALSE)
  481. fprintf(stderr, "ERROR: ImGui_ImplOpenGL3_CreateDeviceObjects: failed to link %s! (with GLSL '%s')\n", desc, g_GlslVersionString);
  482. if (log_length > 1)
  483. {
  484. ImVector<char> buf;
  485. buf.resize((int)(log_length + 1));
  486. glGetProgramInfoLog(handle, log_length, NULL, (GLchar*)buf.begin());
  487. fprintf(stderr, "%s\n", buf.begin());
  488. }
  489. return (GLboolean)status == GL_TRUE;
  490. }
  491. bool ImGui_ImplOpenGL3_CreateDeviceObjects()
  492. {
  493. // Backup GL state
  494. GLint last_texture, last_array_buffer;
  495. glGetIntegerv(GL_TEXTURE_BINDING_2D, &last_texture);
  496. glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &last_array_buffer);
  497. #ifndef IMGUI_IMPL_OPENGL_ES2
  498. GLint last_vertex_array;
  499. glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &last_vertex_array);
  500. #endif
  501. // Parse GLSL version string
  502. int glsl_version = 130;
  503. sscanf(g_GlslVersionString, "#version %d", &glsl_version);
  504. const GLchar* vertex_shader_glsl_120 =
  505. "uniform mat4 ProjMtx;\n"
  506. "attribute vec2 Position;\n"
  507. "attribute vec2 UV;\n"
  508. "attribute vec4 Color;\n"
  509. "varying vec2 Frag_UV;\n"
  510. "varying vec4 Frag_Color;\n"
  511. "void main()\n"
  512. "{\n"
  513. " Frag_UV = UV;\n"
  514. " Frag_Color = Color;\n"
  515. " gl_Position = ProjMtx * vec4(Position.xy,0,1);\n"
  516. "}\n";
  517. const GLchar* vertex_shader_glsl_130 =
  518. "uniform mat4 ProjMtx;\n"
  519. "in vec2 Position;\n"
  520. "in vec2 UV;\n"
  521. "in vec4 Color;\n"
  522. "out vec2 Frag_UV;\n"
  523. "out vec4 Frag_Color;\n"
  524. "void main()\n"
  525. "{\n"
  526. " Frag_UV = UV;\n"
  527. " Frag_Color = Color;\n"
  528. " gl_Position = ProjMtx * vec4(Position.xy,0,1);\n"
  529. "}\n";
  530. const GLchar* vertex_shader_glsl_300_es =
  531. "precision mediump float;\n"
  532. "layout (location = 0) in vec2 Position;\n"
  533. "layout (location = 1) in vec2 UV;\n"
  534. "layout (location = 2) in vec4 Color;\n"
  535. "uniform mat4 ProjMtx;\n"
  536. "out vec2 Frag_UV;\n"
  537. "out vec4 Frag_Color;\n"
  538. "void main()\n"
  539. "{\n"
  540. " Frag_UV = UV;\n"
  541. " Frag_Color = Color;\n"
  542. " gl_Position = ProjMtx * vec4(Position.xy,0,1);\n"
  543. "}\n";
  544. const GLchar* vertex_shader_glsl_410_core =
  545. "layout (location = 0) in vec2 Position;\n"
  546. "layout (location = 1) in vec2 UV;\n"
  547. "layout (location = 2) in vec4 Color;\n"
  548. "uniform mat4 ProjMtx;\n"
  549. "out vec2 Frag_UV;\n"
  550. "out vec4 Frag_Color;\n"
  551. "void main()\n"
  552. "{\n"
  553. " Frag_UV = UV;\n"
  554. " Frag_Color = Color;\n"
  555. " gl_Position = ProjMtx * vec4(Position.xy,0,1);\n"
  556. "}\n";
  557. const GLchar* fragment_shader_glsl_120 =
  558. "#ifdef GL_ES\n"
  559. " precision mediump float;\n"
  560. "#endif\n"
  561. "uniform sampler2D Texture;\n"
  562. "varying vec2 Frag_UV;\n"
  563. "varying vec4 Frag_Color;\n"
  564. "void main()\n"
  565. "{\n"
  566. " gl_FragColor = Frag_Color * texture2D(Texture, Frag_UV.st);\n"
  567. "}\n";
  568. const GLchar* fragment_shader_glsl_130 =
  569. "uniform sampler2D Texture;\n"
  570. "in vec2 Frag_UV;\n"
  571. "in vec4 Frag_Color;\n"
  572. "out vec4 Out_Color;\n"
  573. "void main()\n"
  574. "{\n"
  575. " Out_Color = Frag_Color * texture(Texture, Frag_UV.st);\n"
  576. "}\n";
  577. const GLchar* fragment_shader_glsl_300_es =
  578. "precision mediump float;\n"
  579. "uniform sampler2D Texture;\n"
  580. "in vec2 Frag_UV;\n"
  581. "in vec4 Frag_Color;\n"
  582. "layout (location = 0) out vec4 Out_Color;\n"
  583. "void main()\n"
  584. "{\n"
  585. " Out_Color = Frag_Color * texture(Texture, Frag_UV.st);\n"
  586. "}\n";
  587. const GLchar* fragment_shader_glsl_410_core =
  588. "in vec2 Frag_UV;\n"
  589. "in vec4 Frag_Color;\n"
  590. "uniform sampler2D Texture;\n"
  591. "layout (location = 0) out vec4 Out_Color;\n"
  592. "void main()\n"
  593. "{\n"
  594. " Out_Color = Frag_Color * texture(Texture, Frag_UV.st);\n"
  595. "}\n";
  596. // Select shaders matching our GLSL versions
  597. const GLchar* vertex_shader = NULL;
  598. const GLchar* fragment_shader = NULL;
  599. if (glsl_version < 130)
  600. {
  601. vertex_shader = vertex_shader_glsl_120;
  602. fragment_shader = fragment_shader_glsl_120;
  603. }
  604. else if (glsl_version >= 410)
  605. {
  606. vertex_shader = vertex_shader_glsl_410_core;
  607. fragment_shader = fragment_shader_glsl_410_core;
  608. }
  609. else if (glsl_version == 300)
  610. {
  611. vertex_shader = vertex_shader_glsl_300_es;
  612. fragment_shader = fragment_shader_glsl_300_es;
  613. }
  614. else
  615. {
  616. vertex_shader = vertex_shader_glsl_130;
  617. fragment_shader = fragment_shader_glsl_130;
  618. }
  619. // Create shaders
  620. const GLchar* vertex_shader_with_version[2] = { g_GlslVersionString, vertex_shader };
  621. g_VertHandle = glCreateShader(GL_VERTEX_SHADER);
  622. glShaderSource(g_VertHandle, 2, vertex_shader_with_version, NULL);
  623. glCompileShader(g_VertHandle);
  624. CheckShader(g_VertHandle, "vertex shader");
  625. const GLchar* fragment_shader_with_version[2] = { g_GlslVersionString, fragment_shader };
  626. g_FragHandle = glCreateShader(GL_FRAGMENT_SHADER);
  627. glShaderSource(g_FragHandle, 2, fragment_shader_with_version, NULL);
  628. glCompileShader(g_FragHandle);
  629. CheckShader(g_FragHandle, "fragment shader");
  630. g_ShaderHandle = glCreateProgram();
  631. glAttachShader(g_ShaderHandle, g_VertHandle);
  632. glAttachShader(g_ShaderHandle, g_FragHandle);
  633. glLinkProgram(g_ShaderHandle);
  634. CheckProgram(g_ShaderHandle, "shader program");
  635. g_AttribLocationTex = glGetUniformLocation(g_ShaderHandle, "Texture");
  636. g_AttribLocationProjMtx = glGetUniformLocation(g_ShaderHandle, "ProjMtx");
  637. g_AttribLocationVtxPos = (GLuint)glGetAttribLocation(g_ShaderHandle, "Position");
  638. g_AttribLocationVtxUV = (GLuint)glGetAttribLocation(g_ShaderHandle, "UV");
  639. g_AttribLocationVtxColor = (GLuint)glGetAttribLocation(g_ShaderHandle, "Color");
  640. // Create buffers
  641. glGenBuffers(1, &g_VboHandle);
  642. glGenBuffers(1, &g_ElementsHandle);
  643. ImGui_ImplOpenGL3_CreateFontsTexture();
  644. // Restore modified GL state
  645. glBindTexture(GL_TEXTURE_2D, last_texture);
  646. glBindBuffer(GL_ARRAY_BUFFER, last_array_buffer);
  647. #ifndef IMGUI_IMPL_OPENGL_ES2
  648. glBindVertexArray(last_vertex_array);
  649. #endif
  650. return true;
  651. }
  652. void ImGui_ImplOpenGL3_DestroyDeviceObjects()
  653. {
  654. if (g_VboHandle) { glDeleteBuffers(1, &g_VboHandle); g_VboHandle = 0; }
  655. if (g_ElementsHandle) { glDeleteBuffers(1, &g_ElementsHandle); g_ElementsHandle = 0; }
  656. if (g_ShaderHandle && g_VertHandle) { glDetachShader(g_ShaderHandle, g_VertHandle); }
  657. if (g_ShaderHandle && g_FragHandle) { glDetachShader(g_ShaderHandle, g_FragHandle); }
  658. if (g_VertHandle) { glDeleteShader(g_VertHandle); g_VertHandle = 0; }
  659. if (g_FragHandle) { glDeleteShader(g_FragHandle); g_FragHandle = 0; }
  660. if (g_ShaderHandle) { glDeleteProgram(g_ShaderHandle); g_ShaderHandle = 0; }
  661. ImGui_ImplOpenGL3_DestroyFontsTexture();
  662. }
  663. //--------------------------------------------------------------------------------------------------------
  664. // MULTI-VIEWPORT / PLATFORM INTERFACE SUPPORT
  665. // This is an _advanced_ and _optional_ feature, allowing the backend to create and handle multiple viewports simultaneously.
  666. // 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..
  667. //--------------------------------------------------------------------------------------------------------
  668. static void ImGui_ImplOpenGL3_RenderWindow(ImGuiViewport* viewport, void*)
  669. {
  670. if (!(viewport->Flags & ImGuiViewportFlags_NoRendererClear))
  671. {
  672. ImVec4 clear_color = ImVec4(0.0f, 0.0f, 0.0f, 1.0f);
  673. glClearColor(clear_color.x, clear_color.y, clear_color.z, clear_color.w);
  674. glClear(GL_COLOR_BUFFER_BIT);
  675. }
  676. ImGui_ImplOpenGL3_RenderDrawData(viewport->DrawData);
  677. }
  678. static void ImGui_ImplOpenGL3_InitPlatformInterface()
  679. {
  680. ImGuiPlatformIO& platform_io = ImGui::GetPlatformIO();
  681. platform_io.Renderer_RenderWindow = ImGui_ImplOpenGL3_RenderWindow;
  682. }
  683. static void ImGui_ImplOpenGL3_ShutdownPlatformInterface()
  684. {
  685. ImGui::DestroyPlatformWindows();
  686. }