ui/gl/gl_gl_api_implementation.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef UI_GL_GL_GL_API_IMPLEMENTATION_H_
   6 #define UI_GL_GL_GL_API_IMPLEMENTATION_H_
   7
   8 #include <vector>
   9
  10 #include "base/compiler_specific.h"
  11 #include "ui/gl/gl_bindings.h"
  12 #include "ui/gl/gl_export.h"
  13
  14 namespace base {
  15 class CommandLine;
  16 }
  17 namespace gpu {
  18 namespace gles2 {
  19 class GLES2Decoder;
  20 }
  21 }
  22 namespace gfx {
  23
  24 class GLContext;
  25 class GLSurface;
  26 struct GLVersionInfo;
  27
  28 void InitializeStaticGLBindingsGL();
  29 void InitializeDynamicGLBindingsGL(GLContext* context);
  30 void InitializeDebugGLBindingsGL();
  31 void InitializeNullDrawGLBindingsGL();
  32 // TODO(danakj): Remove this when all test suites are using null-draw.
  33 bool HasInitializedNullDrawGLBindingsGL();
  34 bool SetNullDrawGLBindingsEnabledGL(bool enabled);
  35 void ClearGLBindingsGL();
  36 void SetGLToRealGLApi();
  37 void SetGLApi(GLApi* api);
  38 void SetGLApiToNoContext();
  39 GLApi* GetCurrentGLApi();
  40 const GLVersionInfo* GetGLVersionInfo();
  41
  42 class GL_EXPORT GLApiBase : public GLApi {
  43  public:
  44   // Include the auto-generated part of this class. We split this because
  45   // it means we can easily edit the non-auto generated parts right here in
  46   // this file instead of having to edit some template or the code generator.
  47   #include "gl_bindings_api_autogen_gl.h"
  48
  49  protected:
  50   GLApiBase();
  51   ~GLApiBase() override;
  52   void InitializeBase(DriverGL* driver);
  53
  54   DriverGL* driver_;
  55 };
  56
  57 // Implemenents the GL API by calling directly into the driver.
  58 class GL_EXPORT RealGLApi : public GLApiBase {
  59  public:
  60   RealGLApi();
  61   ~RealGLApi() override;
  62   void Initialize(DriverGL* driver);
  63   void InitializeWithCommandLine(DriverGL* driver,
  64                                  base::CommandLine* command_line);
  65
  66   void glGetIntegervFn(GLenum pname, GLint* params) override;
  67   const GLubyte* glGetStringFn(GLenum name) override;
  68   const GLubyte* glGetStringiFn(GLenum name, GLuint index) override;
  69
  70   void InitializeFilteredExtensions();
  71
  72  private:
  73   void glFinishFn() override;
  74   void glFlushFn() override;
  75
  76   // Filtered GL_EXTENSIONS we return to glGetString(i) calls.
  77   std::vector<std::string> disabled_exts_;
  78   std::vector<std::string> filtered_exts_;
  79   std::string filtered_exts_str_;
  80
  81 #if DCHECK_IS_ON()
  82   bool filtered_exts_initialized_;
  83 #endif
  84 };
  85
  86 // Inserts a TRACE for every GL call.
  87 class TraceGLApi : public GLApi {
  88  public:
  89   TraceGLApi(GLApi* gl_api) : gl_api_(gl_api) { }
  90   ~TraceGLApi() override;
  91
  92   // Include the auto-generated part of this class. We split this because
  93   // it means we can easily edit the non-auto generated parts right here in
  94   // this file instead of having to edit some template or the code generator.
  95   #include "gl_bindings_api_autogen_gl.h"
  96
  97  private:
  98   GLApi* gl_api_;
  99 };
 100
 101 // Catches incorrect usage when GL calls are made without a current context.
 102 class NoContextGLApi : public GLApi {
 103  public:
 104   NoContextGLApi();
 105   ~NoContextGLApi() override;
 106
 107   // Include the auto-generated part of this class. We split this because
 108   // it means we can easily edit the non-auto generated parts right here in
 109   // this file instead of having to edit some template or the code generator.
 110   #include "gl_bindings_api_autogen_gl.h"
 111 };
 112
 113 // Implementents the GL API using co-operative state restoring.
 114 // Assumes there is only one real GL context and that multiple virtual contexts
 115 // are implemented above it. Restores the needed state from the current context.
 116 class VirtualGLApi : public GLApiBase {
 117  public:
 118   VirtualGLApi();
 119   ~VirtualGLApi() override;
 120   void Initialize(DriverGL* driver, GLContext* real_context);
 121
 122   // Sets the current virutal context.
 123   bool MakeCurrent(GLContext* virtual_context, GLSurface* surface);
 124
 125   void OnReleaseVirtuallyCurrent(GLContext* virtual_context);
 126
 127 private:
 128   // Overridden functions from GLApiBase
 129  const GLubyte* glGetStringFn(GLenum name) override;
 130  void glFinishFn() override;
 131  void glFlushFn() override;
 132
 133   // The real context we're running on.
 134   GLContext* real_context_;
 135
 136   // The current virtual context.
 137   GLContext* current_context_;
 138
 139   // The supported extensions being advertised for this virtual context.
 140   std::string extensions_;
 141 };
 142
 143 }  // namespace gfx
 144
 145 #endif  // UI_GL_GL_GL_API_IMPLEMENTATION_H_