| Index: include/gpu/gl/SkGLContext.h
|
| diff --git a/include/gpu/gl/SkGLContext.h b/include/gpu/gl/SkGLContext.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..fe41a606ef19923d246f31eab3269f63b0973c27
|
| --- /dev/null
|
| +++ b/include/gpu/gl/SkGLContext.h
|
| @@ -0,0 +1,145 @@
|
| +
|
| +/*
|
| + * Copyright 2013 Google Inc.
|
| + *
|
| + * Use of this source code is governed by a BSD-style license that can be
|
| + * found in the LICENSE file.
|
| + */
|
| +#ifndef SkGLContext_DEFINED
|
| +#define SkGLContext_DEFINED
|
| +
|
| +#include "GrGLInterface.h"
|
| +#include "../private/SkGpuFenceSync.h"
|
| +
|
| +/**
|
| + * Create an offscreen opengl context with an RGBA8 / 8bit stencil FBO.
|
| + * Provides a GrGLInterface struct of function pointers for the context.
|
| + * This class is intended for Skia's testing needs and not for general
|
| + * use.
|
| + */
|
| +class SK_API SkGLContext : public SkNoncopyable {
|
| +public:
|
| + virtual ~SkGLContext();
|
| +
|
| + bool isValid() const { return NULL != gl(); }
|
| +
|
| + const GrGLInterface* gl() const { return fGL.get(); }
|
| +
|
| + bool fenceSyncSupport() const { return fFenceSync != nullptr; }
|
| +
|
| + bool getMaxGpuFrameLag(int* maxFrameLag) const {
|
| + if (!fFenceSync) {
|
| + return false;
|
| + }
|
| + *maxFrameLag = kMaxFrameLag;
|
| + return true;
|
| + }
|
| +
|
| + void makeCurrent() const;
|
| +
|
| + /** Used for testing EGLImage integration. Take a GL_TEXTURE_2D and wraps it in an EGL Image */
|
| + virtual GrEGLImage texture2DToEGLImage(GrGLuint /*texID*/) const { return 0; }
|
| + virtual void destroyEGLImage(GrEGLImage) const {}
|
| +
|
| + /** Used for testing GL_TEXTURE_RECTANGLE integration. */
|
| + GrGLint createTextureRectangle(int width, int height, GrGLenum internalFormat,
|
| + GrGLenum externalFormat, GrGLenum externalType,
|
| + GrGLvoid* data);
|
| +
|
| + /**
|
| + * Used for testing EGLImage integration. Takes a EGLImage and wraps it in a
|
| + * GL_TEXTURE_EXTERNAL_OES.
|
| + */
|
| + virtual GrGLuint eglImageToExternalTexture(GrEGLImage) const { return 0; }
|
| +
|
| + void swapBuffers();
|
| +
|
| + /**
|
| + * The only purpose of this function it to provide a means of scheduling
|
| + * work on the GPU (since all of the subclasses create primary buffers for
|
| + * testing that are small and not meant to be rendered to the screen).
|
| + *
|
| + * If the platform supports fence sync (OpenGL 3.2+ or EGL_KHR_fence_sync),
|
| + * this will not swap any buffers, but rather emulate triple buffer
|
| + * synchronization using fences.
|
| + *
|
| + * Otherwise it will call the platform SwapBuffers method. This may or may
|
| + * not perform some sort of synchronization, depending on whether the
|
| + * drawing surface provided by the platform is double buffered.
|
| + */
|
| + void waitOnSyncOrSwap();
|
| +
|
| + /**
|
| + * This notifies the context that we are deliberately testing abandoning
|
| + * the context. It is useful for debugging contexts that would otherwise
|
| + * test that GPU resources are properly deleted. It also allows a debugging
|
| + * context to test that further GL calls are not made by Skia GPU code.
|
| + */
|
| + void testAbandon();
|
| +
|
| + /**
|
| + * Creates a new GL context of the same type and makes the returned context current
|
| + * (if not null).
|
| + */
|
| + virtual SkGLContext* createNew() const { return nullptr; }
|
| +
|
| + class GLFenceSync; // SkGpuFenceSync implementation that uses the OpenGL functionality.
|
| +
|
| + /*
|
| + * returns the fencesync object owned by this SkGLContext
|
| + */
|
| + SkGpuFenceSync* fenceSync() { return fFenceSync.get(); }
|
| +
|
| +protected:
|
| + SkGLContext();
|
| +
|
| + /*
|
| + * Methods that sublcasses must call from their constructors and destructors.
|
| + */
|
| + void init(const GrGLInterface*, SkGpuFenceSync* = NULL);
|
| + void teardown();
|
| +
|
| + /*
|
| + * Operations that have a platform-dependent implementation.
|
| + */
|
| + virtual void onPlatformMakeCurrent() const = 0;
|
| + virtual void onPlatformSwapBuffers() const = 0;
|
| + virtual GrGLFuncPtr onPlatformGetProcAddress(const char*) const = 0;
|
| +
|
| +private:
|
| + enum { kMaxFrameLag = 3 };
|
| +
|
| + SkAutoTDelete<SkGpuFenceSync> fFenceSync;
|
| + SkPlatformGpuFence fFrameFences[kMaxFrameLag - 1];
|
| + int fCurrentFenceIdx;
|
| +
|
| + /** Subclass provides the gl interface object if construction was
|
| + * successful. */
|
| + SkAutoTUnref<const GrGLInterface> fGL;
|
| +
|
| + friend class GLFenceSync; // For onPlatformGetProcAddress.
|
| +};
|
| +
|
| +/** Creates platform-dependent GL context object. The shareContext parameter is in an optional
|
| + * context with which to share display lists. This should be a pointer to an SkGLContext created
|
| + * with SkCreatePlatformGLContext. NULL indicates that no sharing is to take place. Returns a valid
|
| + * gl context object or NULL if such can not be created.
|
| + * Note: If Skia embedder needs a custom GL context that sets up the GL interface, this function
|
| + * should be implemented by the embedder. Otherwise, the default implementation for the platform
|
| + * should be compiled in the library.
|
| + */
|
| +SK_API SkGLContext* SkCreatePlatformGLContext(GrGLStandard forcedGpuAPI,
|
| + SkGLContext* shareContext = nullptr);
|
| +
|
| +/**
|
| + * Helper macros for using the GL context through the GrGLInterface. Example:
|
| + * SK_GL(glCtx, GenTextures(1, &texID));
|
| + */
|
| +#define SK_GL(ctx, X) (ctx).gl()->fFunctions.f ## X; \
|
| + SkASSERT(0 == (ctx).gl()->fFunctions.fGetError())
|
| +#define SK_GL_RET(ctx, RET, X) (RET) = (ctx).gl()->fFunctions.f ## X; \
|
| + SkASSERT(0 == (ctx).gl()->fFunctions.fGetError())
|
| +#define SK_GL_NOERRCHECK(ctx, X) (ctx).gl()->fFunctions.f ## X
|
| +#define SK_GL_RET_NOERRCHECK(ctx, RET, X) (RET) = (ctx).gl()->fFunctions.f ## X
|
| +
|
| +#endif
|
|
|