OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef UI_GL_GL_IMPLEMENTATION_H_ | 5 #ifndef UI_GL_GL_IMPLEMENTATION_H_ |
6 #define UI_GL_GL_IMPLEMENTATION_H_ | 6 #define UI_GL_GL_IMPLEMENTATION_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 #include <vector> | 9 #include <vector> |
10 | 10 |
(...skipping 28 matching lines...) Expand all Loading... |
39 | 39 |
40 GL_EXPORT void GetAllowedGLImplementations( | 40 GL_EXPORT void GetAllowedGLImplementations( |
41 std::vector<GLImplementation>* impls); | 41 std::vector<GLImplementation>* impls); |
42 | 42 |
43 #if defined(OS_WIN) | 43 #if defined(OS_WIN) |
44 typedef void* (WINAPI *GLGetProcAddressProc)(const char* name); | 44 typedef void* (WINAPI *GLGetProcAddressProc)(const char* name); |
45 #else | 45 #else |
46 typedef void* (*GLGetProcAddressProc)(const char* name); | 46 typedef void* (*GLGetProcAddressProc)(const char* name); |
47 #endif | 47 #endif |
48 | 48 |
49 // Initialize a particular GL implementation. | |
50 GL_EXPORT bool InitializeStaticGLBindings(GLImplementation implementation); | |
51 | |
52 // Initialize function bindings that depend on the context for a GL | 49 // Initialize function bindings that depend on the context for a GL |
53 // implementation. | 50 // implementation. |
54 GL_EXPORT bool InitializeDynamicGLBindings(GLImplementation implementation, | 51 GL_EXPORT bool InitializeDynamicGLBindings(GLImplementation implementation, |
55 GLContext* context); | 52 GLContext* context); |
56 | 53 |
57 // Initialize Debug logging wrappers for GL bindings. | |
58 GL_EXPORT void InitializeDebugGLBindings(); | |
59 | |
60 // Initialize stub methods for drawing operations in the GL bindings. The | 54 // Initialize stub methods for drawing operations in the GL bindings. The |
61 // null draw bindings default to enabled, so that draw operations do nothing. | 55 // null draw bindings default to enabled, so that draw operations do nothing. |
62 GL_EXPORT void InitializeNullDrawGLBindings(); | 56 GL_EXPORT void InitializeNullDrawGLBindings(); |
63 | 57 |
64 // TODO(danakj): Remove this when all test suites are using null-draw. | 58 // TODO(danakj): Remove this when all test suites are using null-draw. |
65 GL_EXPORT bool HasInitializedNullDrawGLBindings(); | 59 GL_EXPORT bool HasInitializedNullDrawGLBindings(); |
66 | 60 |
67 // Filter a list of disabled_extensions from GL style space-separated | 61 // Filter a list of disabled_extensions from GL style space-separated |
68 // extension_list, returning a space separated list of filtered extensions, in | 62 // extension_list, returning a space separated list of filtered extensions, in |
69 // the same order as the input. | 63 // the same order as the input. |
70 GL_EXPORT std::string FilterGLExtensionList( | 64 GL_EXPORT std::string FilterGLExtensionList( |
71 const char* extension_list, | 65 const char* extension_list, |
72 const std::vector<std::string>& disabled_extensions); | 66 const std::vector<std::string>& disabled_extensions); |
73 | 67 |
74 // Once initialized, instantiating this turns the stub methods for drawing | 68 // Once initialized, instantiating this turns the stub methods for drawing |
75 // operations off allowing drawing will occur while the object is alive. | 69 // operations off allowing drawing will occur while the object is alive. |
76 class GL_EXPORT DisableNullDrawGLBindings { | 70 class GL_EXPORT DisableNullDrawGLBindings { |
77 public: | 71 public: |
78 DisableNullDrawGLBindings(); | 72 DisableNullDrawGLBindings(); |
79 ~DisableNullDrawGLBindings(); | 73 ~DisableNullDrawGLBindings(); |
80 | 74 |
81 private: | 75 private: |
82 bool initial_enabled_; | 76 bool initial_enabled_; |
83 }; | 77 }; |
84 | 78 |
85 GL_EXPORT void ClearGLBindings(); | |
86 | |
87 // Set the current GL implementation. | 79 // Set the current GL implementation. |
88 GL_EXPORT void SetGLImplementation(GLImplementation implementation); | 80 GL_EXPORT void SetGLImplementation(GLImplementation implementation); |
89 | 81 |
90 // Get the current GL implementation. | 82 // Get the current GL implementation. |
91 GL_EXPORT GLImplementation GetGLImplementation(); | 83 GL_EXPORT GLImplementation GetGLImplementation(); |
92 | 84 |
93 // Does the underlying GL support all features from Desktop GL 2.0 that were | 85 // Does the underlying GL support all features from Desktop GL 2.0 that were |
94 // removed from the ES 2.0 spec without requiring specific extension strings. | 86 // removed from the ES 2.0 spec without requiring specific extension strings. |
95 GL_EXPORT bool HasDesktopGLFeatures(); | 87 GL_EXPORT bool HasDesktopGLFeatures(); |
96 | 88 |
97 // Get the GL implementation with a given name. | 89 // Get the GL implementation with a given name. |
98 GL_EXPORT GLImplementation GetNamedGLImplementation(const std::string& name); | 90 GL_EXPORT GLImplementation GetNamedGLImplementation(const std::string& name); |
99 | 91 |
100 // Get the name of a GL implementation. | 92 // Get the name of a GL implementation. |
101 GL_EXPORT const char* GetGLImplementationName(GLImplementation implementation); | 93 GL_EXPORT const char* GetGLImplementationName(GLImplementation implementation); |
102 | 94 |
103 // Add a native library to those searched for GL entry points. | 95 // Add a native library to those searched for GL entry points. |
104 void AddGLNativeLibrary(base::NativeLibrary library); | 96 GL_EXPORT void AddGLNativeLibrary(base::NativeLibrary library); |
105 | 97 |
106 // Unloads all native libraries. | 98 // Unloads all native libraries. |
107 void UnloadGLNativeLibraries(); | 99 GL_EXPORT void UnloadGLNativeLibraries(); |
108 | 100 |
109 // Set an additional function that will be called to find GL entry points. | 101 // Set an additional function that will be called to find GL entry points. |
110 // Exported so that tests may set the function used in the mock implementation. | 102 // Exported so that tests may set the function used in the mock implementation. |
111 GL_EXPORT void SetGLGetProcAddressProc(GLGetProcAddressProc proc); | 103 GL_EXPORT void SetGLGetProcAddressProc(GLGetProcAddressProc proc); |
112 | 104 |
113 // Find an entry point in the current GL implementation. Note that the function | 105 // Find an entry point in the current GL implementation. Note that the function |
114 // may return a non-null pointer to something else than the GL function if an | 106 // may return a non-null pointer to something else than the GL function if an |
115 // unsupported function is queried. Spec-compliant eglGetProcAddress and | 107 // unsupported function is queried. Spec-compliant eglGetProcAddress and |
116 // glxGetProcAddress are allowed to return garbage for unsupported functions, | 108 // glxGetProcAddress are allowed to return garbage for unsupported functions, |
117 // and when querying functions from the EGL library supplied by Android, it may | 109 // and when querying functions from the EGL library supplied by Android, it may |
118 // return a function that prints a log message about the function being | 110 // return a function that prints a log message about the function being |
119 // unsupported. | 111 // unsupported. |
120 void* GetGLProcAddress(const char* name); | 112 GL_EXPORT void* GetGLProcAddress(const char* name); |
121 | 113 |
122 // Return information about the GL window system binding implementation (e.g., | 114 // Return information about the GL window system binding implementation (e.g., |
123 // EGL, GLX, WGL). Returns true if the information was retrieved successfully. | 115 // EGL, GLX, WGL). Returns true if the information was retrieved successfully. |
124 GL_EXPORT bool GetGLWindowSystemBindingInfo(GLWindowSystemBindingInfo* info); | 116 GL_EXPORT bool GetGLWindowSystemBindingInfo(GLWindowSystemBindingInfo* info); |
125 | 117 |
126 // Helper for fetching the OpenGL extensions from the current context. | 118 // Helper for fetching the OpenGL extensions from the current context. |
127 // This helper abstracts over differences between the desktop OpenGL | 119 // This helper abstracts over differences between the desktop OpenGL |
128 // core profile, and OpenGL ES and the compatibility profile. It's | 120 // core profile, and OpenGL ES and the compatibility profile. It's |
129 // intended for users of the bindings, not the implementation of the | 121 // intended for users of the bindings, not the implementation of the |
130 // bindings themselves. This is a relatively expensive call, so | 122 // bindings themselves. This is a relatively expensive call, so |
131 // callers should cache the result. | 123 // callers should cache the result. |
132 GL_EXPORT std::string GetGLExtensionsFromCurrentContext(); | 124 GL_EXPORT std::string GetGLExtensionsFromCurrentContext(); |
133 | 125 |
134 // Helper for the GL bindings implementation to understand whether | 126 // Helper for the GL bindings implementation to understand whether |
135 // glGetString(GL_EXTENSIONS) or glGetStringi(GL_EXTENSIONS, i) will | 127 // glGetString(GL_EXTENSIONS) or glGetStringi(GL_EXTENSIONS, i) will |
136 // be used in the function above. | 128 // be used in the function above. |
137 GL_EXPORT bool WillUseGLGetStringForExtensions(); | 129 GL_EXPORT bool WillUseGLGetStringForExtensions(); |
138 | 130 |
139 // Helpers to load a library and log error on failure. | 131 // Helpers to load a library and log error on failure. |
140 base::NativeLibrary LoadLibraryAndPrintError( | 132 GL_EXPORT base::NativeLibrary LoadLibraryAndPrintError( |
141 const base::FilePath::CharType* filename); | 133 const base::FilePath::CharType* filename); |
142 base::NativeLibrary LoadLibraryAndPrintError(const base::FilePath& filename); | 134 GL_EXPORT base::NativeLibrary LoadLibraryAndPrintError( |
| 135 const base::FilePath& filename); |
143 | 136 |
144 } // namespace gl | 137 } // namespace gl |
145 | 138 |
146 #endif // UI_GL_GL_IMPLEMENTATION_H_ | 139 #endif // UI_GL_GL_IMPLEMENTATION_H_ |
OLD | NEW |