| 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 |