source: opengl-game/IMGUI/imgui_impl_opengl3.h@ 670c09a

feature/imgui-sdl
Last change on this file since 670c09a was e66fd66, checked in by Dmitry Portnoy <dportnoy@…>, 4 years ago

In OpenGLReference, change all enums to enum classes and update IMGUI to the latest version

  • Property mode set to 100644
File size: 4.2 KB
Line 
1// dear imgui: Renderer 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 Binding (e.g. GLFW, SDL, Win32, custom..)
5
6// Implemented features:
7// [X] Renderer: User texture binding. Use 'GLuint' OpenGL texture identifier as void*/ImTextureID. Read the FAQ about ImTextureID!
8// [x] Renderer: Desktop GL only: Support for large meshes (64k+ vertices) with 16-bit indices.
9
10// You can copy and use unmodified imgui_impl_* files in your project. See main.cpp for an example of using this.
11// If you are new to dear imgui, read examples/README.txt and read the documentation at the top of imgui.cpp.
12// https://github.com/ocornut/imgui
13
14// About Desktop OpenGL function loaders:
15// Modern Desktop OpenGL doesn't have a standard portable header file to load OpenGL function pointers.
16// Helper libraries are often used for this purpose! Here we are supporting a few common ones (gl3w, glew, glad).
17// You may use another loader/header of your choice (glext, glLoadGen, etc.), or chose to manually implement your own.
18
19// About GLSL version:
20// The 'glsl_version' initialization parameter should be NULL (default) or a "#version XXX" string.
21// On computer platform the GLSL version default to "#version 130". On OpenGL ES 3 platform it defaults to "#version 300 es"
22// Only override if your GL version doesn't handle this GLSL version. See GLSL version table at the top of imgui_impl_opengl3.cpp.
23
24#pragma once
25#include "imgui.h" // IMGUI_IMPL_API
26
27// Backend API
28IMGUI_IMPL_API bool ImGui_ImplOpenGL3_Init(const char* glsl_version = NULL);
29IMGUI_IMPL_API void ImGui_ImplOpenGL3_Shutdown();
30IMGUI_IMPL_API void ImGui_ImplOpenGL3_NewFrame();
31IMGUI_IMPL_API void ImGui_ImplOpenGL3_RenderDrawData(ImDrawData* draw_data);
32
33// (Optional) Called by Init/NewFrame/Shutdown
34IMGUI_IMPL_API bool ImGui_ImplOpenGL3_CreateFontsTexture();
35IMGUI_IMPL_API void ImGui_ImplOpenGL3_DestroyFontsTexture();
36IMGUI_IMPL_API bool ImGui_ImplOpenGL3_CreateDeviceObjects();
37IMGUI_IMPL_API void ImGui_ImplOpenGL3_DestroyDeviceObjects();
38
39// Specific OpenGL ES versions
40//#define IMGUI_IMPL_OPENGL_ES2 // Auto-detected on Emscripten
41//#define IMGUI_IMPL_OPENGL_ES3 // Auto-detected on iOS/Android
42
43// Attempt to auto-detect the default Desktop GL loader based on available header files.
44// If auto-detection fails or doesn't select the same GL loader file as used by your application,
45// you are likely to get a crash in ImGui_ImplOpenGL3_Init().
46// You can explicitly select a loader by using one of the '#define IMGUI_IMPL_OPENGL_LOADER_XXX' in imconfig.h or compiler command-line.
47#if !defined(IMGUI_IMPL_OPENGL_ES2) \
48 && !defined(IMGUI_IMPL_OPENGL_ES3) \
49 && !defined(IMGUI_IMPL_OPENGL_LOADER_GL3W) \
50 && !defined(IMGUI_IMPL_OPENGL_LOADER_GLEW) \
51 && !defined(IMGUI_IMPL_OPENGL_LOADER_GLAD) \
52 && !defined(IMGUI_IMPL_OPENGL_LOADER_GLAD2) \
53 && !defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING2) \
54 && !defined(IMGUI_IMPL_OPENGL_LOADER_GLBINDING3) \
55 && !defined(IMGUI_IMPL_OPENGL_LOADER_CUSTOM)
56
57// Try to detect GLES on matching platforms
58#if defined(__APPLE__)
59#include "TargetConditionals.h"
60#endif
61#if (defined(__APPLE__) && (TARGET_OS_IOS || TARGET_OS_TV)) || (defined(__ANDROID__))
62#define IMGUI_IMPL_OPENGL_ES3 // iOS, Android -> GL ES 3, "#version 300 es"
63#elif defined(__EMSCRIPTEN__)
64#define IMGUI_IMPL_OPENGL_ES2 // Emscripten -> GL ES 2, "#version 100"
65
66// Otherwise try to detect supported Desktop OpenGL loaders..
67#elif defined(__has_include)
68#if __has_include(<GL/glew.h>)
69 #define IMGUI_IMPL_OPENGL_LOADER_GLEW
70#elif __has_include(<glad/glad.h>)
71 #define IMGUI_IMPL_OPENGL_LOADER_GLAD
72#elif __has_include(<glad/gl.h>)
73 #define IMGUI_IMPL_OPENGL_LOADER_GLAD2
74#elif __has_include(<GL/gl3w.h>)
75 #define IMGUI_IMPL_OPENGL_LOADER_GL3W
76#elif __has_include(<glbinding/glbinding.h>)
77 #define IMGUI_IMPL_OPENGL_LOADER_GLBINDING3
78#elif __has_include(<glbinding/Binding.h>)
79 #define IMGUI_IMPL_OPENGL_LOADER_GLBINDING2
80#else
81 #error "Cannot detect OpenGL loader!"
82#endif
83#else
84 #define IMGUI_IMPL_OPENGL_LOADER_GL3W // Default to GL3W embedded in our repository
85#endif
86
87#endif
Note: See TracBrowser for help on using the repository browser.