OLD | NEW |
(Empty) | |
| 1 |
| 2 /* |
| 3 * Copyright 2013 Google Inc. |
| 4 * |
| 5 * Use of this source code is governed by a BSD-style license that can be |
| 6 * found in the LICENSE file. |
| 7 */ |
| 8 #ifndef SkGLContext_DEFINED |
| 9 #define SkGLContext_DEFINED |
| 10 |
| 11 #include "GrGLInterface.h" |
| 12 #include "../private/SkGpuFenceSync.h" |
| 13 |
| 14 /** |
| 15 * Create an offscreen opengl context with an RGBA8 / 8bit stencil FBO. |
| 16 * Provides a GrGLInterface struct of function pointers for the context. |
| 17 * This class is intended for Skia's testing needs and not for general |
| 18 * use. |
| 19 */ |
| 20 class SK_API SkGLContext : public SkNoncopyable { |
| 21 public: |
| 22 virtual ~SkGLContext(); |
| 23 |
| 24 bool isValid() const { return NULL != gl(); } |
| 25 |
| 26 const GrGLInterface* gl() const { return fGL.get(); } |
| 27 |
| 28 bool fenceSyncSupport() const { return fFenceSync != nullptr; } |
| 29 |
| 30 bool getMaxGpuFrameLag(int* maxFrameLag) const { |
| 31 if (!fFenceSync) { |
| 32 return false; |
| 33 } |
| 34 *maxFrameLag = kMaxFrameLag; |
| 35 return true; |
| 36 } |
| 37 |
| 38 void makeCurrent() const; |
| 39 |
| 40 /** Used for testing EGLImage integration. Take a GL_TEXTURE_2D and wraps it
in an EGL Image */ |
| 41 virtual GrEGLImage texture2DToEGLImage(GrGLuint /*texID*/) const { return 0;
} |
| 42 virtual void destroyEGLImage(GrEGLImage) const {} |
| 43 |
| 44 /** Used for testing GL_TEXTURE_RECTANGLE integration. */ |
| 45 GrGLint createTextureRectangle(int width, int height, GrGLenum internalForma
t, |
| 46 GrGLenum externalFormat, GrGLenum externalTyp
e, |
| 47 GrGLvoid* data); |
| 48 |
| 49 /** |
| 50 * Used for testing EGLImage integration. Takes a EGLImage and wraps it in a |
| 51 * GL_TEXTURE_EXTERNAL_OES. |
| 52 */ |
| 53 virtual GrGLuint eglImageToExternalTexture(GrEGLImage) const { return 0; } |
| 54 |
| 55 void swapBuffers(); |
| 56 |
| 57 /** |
| 58 * The only purpose of this function it to provide a means of scheduling |
| 59 * work on the GPU (since all of the subclasses create primary buffers for |
| 60 * testing that are small and not meant to be rendered to the screen). |
| 61 * |
| 62 * If the platform supports fence sync (OpenGL 3.2+ or EGL_KHR_fence_sync), |
| 63 * this will not swap any buffers, but rather emulate triple buffer |
| 64 * synchronization using fences. |
| 65 * |
| 66 * Otherwise it will call the platform SwapBuffers method. This may or may |
| 67 * not perform some sort of synchronization, depending on whether the |
| 68 * drawing surface provided by the platform is double buffered. |
| 69 */ |
| 70 void waitOnSyncOrSwap(); |
| 71 |
| 72 /** |
| 73 * This notifies the context that we are deliberately testing abandoning |
| 74 * the context. It is useful for debugging contexts that would otherwise |
| 75 * test that GPU resources are properly deleted. It also allows a debugging |
| 76 * context to test that further GL calls are not made by Skia GPU code. |
| 77 */ |
| 78 void testAbandon(); |
| 79 |
| 80 /** |
| 81 * Creates a new GL context of the same type and makes the returned context
current |
| 82 * (if not null). |
| 83 */ |
| 84 virtual SkGLContext* createNew() const { return nullptr; } |
| 85 |
| 86 class GLFenceSync; // SkGpuFenceSync implementation that uses the OpenGL fu
nctionality. |
| 87 |
| 88 /* |
| 89 * returns the fencesync object owned by this SkGLContext |
| 90 */ |
| 91 SkGpuFenceSync* fenceSync() { return fFenceSync.get(); } |
| 92 |
| 93 protected: |
| 94 SkGLContext(); |
| 95 |
| 96 /* |
| 97 * Methods that sublcasses must call from their constructors and destructors
. |
| 98 */ |
| 99 void init(const GrGLInterface*, SkGpuFenceSync* = NULL); |
| 100 void teardown(); |
| 101 |
| 102 /* |
| 103 * Operations that have a platform-dependent implementation. |
| 104 */ |
| 105 virtual void onPlatformMakeCurrent() const = 0; |
| 106 virtual void onPlatformSwapBuffers() const = 0; |
| 107 virtual GrGLFuncPtr onPlatformGetProcAddress(const char*) const = 0; |
| 108 |
| 109 private: |
| 110 enum { kMaxFrameLag = 3 }; |
| 111 |
| 112 SkAutoTDelete<SkGpuFenceSync> fFenceSync; |
| 113 SkPlatformGpuFence fFrameFences[kMaxFrameLag - 1]; |
| 114 int fCurrentFenceIdx; |
| 115 |
| 116 /** Subclass provides the gl interface object if construction was |
| 117 * successful. */ |
| 118 SkAutoTUnref<const GrGLInterface> fGL; |
| 119 |
| 120 friend class GLFenceSync; // For onPlatformGetProcAddress. |
| 121 }; |
| 122 |
| 123 /** Creates platform-dependent GL context object. The shareContext parameter is
in an optional |
| 124 * context with which to share display lists. This should be a pointer to an SkG
LContext created |
| 125 * with SkCreatePlatformGLContext. NULL indicates that no sharing is to take pl
ace. Returns a valid |
| 126 * gl context object or NULL if such can not be created. |
| 127 * Note: If Skia embedder needs a custom GL context that sets up the GL interfac
e, this function |
| 128 * should be implemented by the embedder. Otherwise, the default implementation
for the platform |
| 129 * should be compiled in the library. |
| 130 */ |
| 131 SK_API SkGLContext* SkCreatePlatformGLContext(GrGLStandard forcedGpuAPI, |
| 132 SkGLContext* shareContext = nullpt
r); |
| 133 |
| 134 /** |
| 135 * Helper macros for using the GL context through the GrGLInterface. Example: |
| 136 * SK_GL(glCtx, GenTextures(1, &texID)); |
| 137 */ |
| 138 #define SK_GL(ctx, X) (ctx).gl()->fFunctions.f ## X; \ |
| 139 SkASSERT(0 == (ctx).gl()->fFunctions.fGetError()) |
| 140 #define SK_GL_RET(ctx, RET, X) (RET) = (ctx).gl()->fFunctions.f ## X; \ |
| 141 SkASSERT(0 == (ctx).gl()->fFunctions.fGetError()) |
| 142 #define SK_GL_NOERRCHECK(ctx, X) (ctx).gl()->fFunctions.f ## X |
| 143 #define SK_GL_RET_NOERRCHECK(ctx, RET, X) (RET) = (ctx).gl()->fFunctions.f ## X |
| 144 |
| 145 #endif |
OLD | NEW |