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