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 const GLVersionInfo* GetGLVersionInfo();
  40
  41 class GL_EXPORT GLApiBase : public GLApi {
  42  public:
  43   // Include the auto-generated part of this class. We split this because
  44   // it means we can easily edit the non-auto generated parts right here in
  45   // this file instead of having to edit some template or the code generator.
  46   #include "gl_bindings_api_autogen_gl.h"
  47
  48  protected:
  49   GLApiBase();
  50   ~GLApiBase() override;
  51   void InitializeBase(DriverGL* driver);
  52
  53   DriverGL* driver_;
  54 };
  55
  56 // Implemenents the GL API by calling directly into the driver.
  57 class GL_EXPORT RealGLApi : public GLApiBase {
  58  public:
  59   RealGLApi();
  60   ~RealGLApi() override;
  61   void Initialize(DriverGL* driver);
  62   void InitializeWithCommandLine(DriverGL* driver,
  63                                  base::CommandLine* command_line);
  64
  65   void InitializeWithContext();
  66
  67   void glGetIntegervFn(GLenum pname, GLint* params) override;
  68   const GLubyte* glGetStringFn(GLenum name) override;
  69   const GLubyte* glGetStringiFn(GLenum name, GLuint index) override;
  70
  71  private:
  72   void InitializeFilteredExtensions();
  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
  82 // Inserts a TRACE for every GL call.
  83 class TraceGLApi : public GLApi {
  84  public:
  85   TraceGLApi(GLApi* gl_api) : gl_api_(gl_api) { }
  86   ~TraceGLApi() override;
  87
  88   // Include the auto-generated part of this class. We split this because
  89   // it means we can easily edit the non-auto generated parts right here in
  90   // this file instead of having to edit some template or the code generator.
  91   #include "gl_bindings_api_autogen_gl.h"
  92
  93  private:
  94   GLApi* gl_api_;
  95 };
  96
  97 // Catches incorrect usage when GL calls are made without a current context.
  98 class NoContextGLApi : public GLApi {
  99  public:
 100   NoContextGLApi();
 101   ~NoContextGLApi() override;
 102
 103   // Include the auto-generated part of this class. We split this because
 104   // it means we can easily edit the non-auto generated parts right here in
 105   // this file instead of having to edit some template or the code generator.
 106   #include "gl_bindings_api_autogen_gl.h"
 107 };
 108
 109 // Implementents the GL API using co-operative state restoring.
 110 // Assumes there is only one real GL context and that multiple virtual contexts
 111 // are implemented above it. Restores the needed state from the current context.
 112 class VirtualGLApi : public GLApiBase {
 113  public:
 114   VirtualGLApi();
 115   ~VirtualGLApi() override;
 116   void Initialize(DriverGL* driver, GLContext* real_context);
 117
 118   // Sets the current virutal context.
 119   bool MakeCurrent(GLContext* virtual_context, GLSurface* surface);
 120
 121   void OnReleaseVirtuallyCurrent(GLContext* virtual_context);
 122
 123 private:
 124   // Overridden functions from GLApiBase
 125  const GLubyte* glGetStringFn(GLenum name) override;
 126  void glFinishFn() override;
 127  void glFlushFn() override;
 128
 129   // The real context we're running on.
 130   GLContext* real_context_;
 131
 132   // The current virtual context.
 133   GLContext* current_context_;
 134
 135   // The supported extensions being advertised for this virtual context.
 136   std::string extensions_;
 137 };
 138
 139 class GL_EXPORT ScopedSetGLToRealGLApi {
 140  public:
 141   ScopedSetGLToRealGLApi();
 142   ~ScopedSetGLToRealGLApi();
 143
 144  private:
 145   GLApi* old_gl_api_;
 146 };
 147
 148 }  // namespace gfx
 149
 150 #endif  // UI_GL_GL_GL_API_IMPLEMENTATION_H_