include/gpu/gl/GrGLInterface.h - platform/external/skia - Git at Google


            
            /*

            
             * Copyright 2011 Google Inc.

            
             *

            
             * Use of this source code is governed by a BSD-style license that can be

            
             * found in the LICENSE file.

            
             */


            #ifndef GrGLInterface_DEFINED

            
            #define GrGLInterface_DEFINED


            #include "include/core/SkRefCnt.h"

            
            #include "include/gpu/gl/GrGLExtensions.h"

            
            #include "include/gpu/gl/GrGLFunctions.h"


            ////////////////////////////////////////////////////////////////////////////////


            typedef void(*GrGLFuncPtr)();

            
            struct GrGLInterface;


            /**

            
             * Rather than depend on platform-specific GL headers and libraries, we require

            
             * the client to provide a struct of GL function pointers. This struct can be

            
             * specified per-GrContext as a parameter to GrContext::MakeGL. If no interface is

            
             * passed to MakeGL then a default GL interface is created using GrGLMakeNativeInterface().

            
             * If this returns nullptr then GrContext::MakeGL() will fail.

            
             *

            
             * The implementation of GrGLMakeNativeInterface is platform-specific. Several

            
             * implementations have been provided (for GLX, WGL, EGL, etc), along with an

            
             * implementation that simply returns nullptr. Clients should select the most

            
             * appropriate one to build.

            
             */

            
            SK_API sk_sp<const GrGLInterface> GrGLMakeNativeInterface();


            /**

            
             * GrContext uses the following interface to make all calls into OpenGL. When a

            
             * GrContext is created it is given a GrGLInterface. The interface's function

            
             * pointers must be valid for the OpenGL context associated with the GrContext.

            
             * On some platforms, such as Windows, function pointers for OpenGL extensions

            
             * may vary between OpenGL contexts. So the caller must be careful to use a

            
             * GrGLInterface initialized for the correct context. All functions that should

            
             * be available based on the OpenGL's version and extension string must be

            
             * non-NULL or GrContext creation will fail. This can be tested with the

            
             * validate() method when the OpenGL context has been made current.

            
             */

            
            struct SK_API GrGLInterface : public SkRefCnt {

            
            private:

            
                using INHERITED = SkRefCnt;


            #if GR_GL_CHECK_ERROR

            
                // This is here to avoid having our debug code that checks for a GL error after most GL calls

            
                // accidentally swallow an OOM that should be reported.

            
                mutable bool fOOMed = false;

            
                bool fSuppressErrorLogging = false;

            
            #endif


            public:

            
                GrGLInterface();


                // Validates that the GrGLInterface supports its advertised standard. This means the necessary

            
                // function pointers have been initialized for both the GL version and any advertised

            
                // extensions.

            
                bool validate() const;


            #if GR_GL_CHECK_ERROR

            
                GrGLenum checkError(const char* location, const char* call) const;

            
                bool checkAndResetOOMed() const;

            
                void suppressErrorLogging();

            
            #endif


            #if defined(GR_TEST_UTILS)

            
                GrGLInterface(const GrGLInterface& that)

            
                        : fStandard(that.fStandard)

            
                        , fExtensions(that.fExtensions)

            
                        , fFunctions(that.fFunctions) {}

            
            #endif


                // Indicates the type of GL implementation

            
                union {

            
                    GrGLStandard fStandard;

            
                    GrGLStandard fBindingsExported; // Legacy name, will be remove when Chromium is updated.

            
                };


                GrGLExtensions fExtensions;


                bool hasExtension(const char ext[]) const { return fExtensions.has(ext); }


                /**

            
                 * The function pointers are in a struct so that we can have a compiler generated assignment

            
                 * operator.

            
                 */

            
                struct Functions {

            
                    GrGLFunction<GrGLActiveTextureFn> fActiveTexture;

            
                    GrGLFunction<GrGLAttachShaderFn> fAttachShader;

            
                    GrGLFunction<GrGLBeginQueryFn> fBeginQuery;

            
                    GrGLFunction<GrGLBindAttribLocationFn> fBindAttribLocation;

            
                    GrGLFunction<GrGLBindBufferFn> fBindBuffer;

            
                    GrGLFunction<GrGLBindFragDataLocationFn> fBindFragDataLocation;

            
                    GrGLFunction<GrGLBindFragDataLocationIndexedFn> fBindFragDataLocationIndexed;

            
                    GrGLFunction<GrGLBindFramebufferFn> fBindFramebuffer;

            
                    GrGLFunction<GrGLBindRenderbufferFn> fBindRenderbuffer;

            
                    GrGLFunction<GrGLBindSamplerFn> fBindSampler;

            
                    GrGLFunction<GrGLBindTextureFn> fBindTexture;

            
                    GrGLFunction<GrGLBindVertexArrayFn> fBindVertexArray;

            
                    GrGLFunction<GrGLBlendBarrierFn> fBlendBarrier;

            
                    GrGLFunction<GrGLBlendColorFn> fBlendColor;

            
                    GrGLFunction<GrGLBlendEquationFn> fBlendEquation;

            
                    GrGLFunction<GrGLBlendFuncFn> fBlendFunc;

            
                    GrGLFunction<GrGLBlitFramebufferFn> fBlitFramebuffer;

            
                    GrGLFunction<GrGLBufferDataFn> fBufferData;

            
                    GrGLFunction<GrGLBufferSubDataFn> fBufferSubData;

            
                    GrGLFunction<GrGLCheckFramebufferStatusFn> fCheckFramebufferStatus;

            
                    GrGLFunction<GrGLClearFn> fClear;

            
                    GrGLFunction<GrGLClearColorFn> fClearColor;

            
                    GrGLFunction<GrGLClearStencilFn> fClearStencil;

            
                    GrGLFunction<GrGLClearTexImageFn> fClearTexImage;

            
                    GrGLFunction<GrGLClearTexSubImageFn> fClearTexSubImage;

            
                    GrGLFunction<GrGLColorMaskFn> fColorMask;

            
                    GrGLFunction<GrGLCompileShaderFn> fCompileShader;

            
                    GrGLFunction<GrGLCompressedTexImage2DFn> fCompressedTexImage2D;

            
                    GrGLFunction<GrGLCompressedTexSubImage2DFn> fCompressedTexSubImage2D;

            
                    GrGLFunction<GrGLCopyBufferSubDataFn> fCopyBufferSubData;

            
                    GrGLFunction<GrGLCopyTexSubImage2DFn> fCopyTexSubImage2D;

            
                    GrGLFunction<GrGLCreateProgramFn> fCreateProgram;

            
                    GrGLFunction<GrGLCreateShaderFn> fCreateShader;

            
                    GrGLFunction<GrGLCullFaceFn> fCullFace;

            
                    GrGLFunction<GrGLDeleteBuffersFn> fDeleteBuffers;

            
                    GrGLFunction<GrGLDeleteFencesFn> fDeleteFences;

            
                    GrGLFunction<GrGLDeleteFramebuffersFn> fDeleteFramebuffers;

            
                    GrGLFunction<GrGLDeleteProgramFn> fDeleteProgram;

            
                    GrGLFunction<GrGLDeleteQueriesFn> fDeleteQueries;

            
                    GrGLFunction<GrGLDeleteRenderbuffersFn> fDeleteRenderbuffers;

            
                    GrGLFunction<GrGLDeleteSamplersFn> fDeleteSamplers;

            
                    GrGLFunction<GrGLDeleteShaderFn> fDeleteShader;

            
                    GrGLFunction<GrGLDeleteTexturesFn> fDeleteTextures;

            
                    GrGLFunction<GrGLDeleteVertexArraysFn> fDeleteVertexArrays;

            
                    GrGLFunction<GrGLDepthMaskFn> fDepthMask;

            
                    GrGLFunction<GrGLDisableFn> fDisable;

            
                    GrGLFunction<GrGLDisableVertexAttribArrayFn> fDisableVertexAttribArray;

            
                    GrGLFunction<GrGLDrawArraysFn> fDrawArrays;

            
                    GrGLFunction<GrGLDrawArraysIndirectFn> fDrawArraysIndirect;

            
                    GrGLFunction<GrGLDrawArraysInstancedFn> fDrawArraysInstanced;

            
                    GrGLFunction<GrGLDrawBufferFn> fDrawBuffer;

            
                    GrGLFunction<GrGLDrawBuffersFn> fDrawBuffers;

            
                    GrGLFunction<GrGLDrawElementsFn> fDrawElements;

            
                    GrGLFunction<GrGLDrawElementsIndirectFn> fDrawElementsIndirect;

            
                    GrGLFunction<GrGLDrawElementsInstancedFn> fDrawElementsInstanced;

            
                    GrGLFunction<GrGLDrawRangeElementsFn> fDrawRangeElements;

            
                    GrGLFunction<GrGLEnableFn> fEnable;

            
                    GrGLFunction<GrGLEnableVertexAttribArrayFn> fEnableVertexAttribArray;

            
                    GrGLFunction<GrGLEndQueryFn> fEndQuery;

            
                    GrGLFunction<GrGLFinishFn> fFinish;

            
                    GrGLFunction<GrGLFinishFenceFn> fFinishFence;

            
                    GrGLFunction<GrGLFlushFn> fFlush;

            
                    GrGLFunction<GrGLFlushMappedBufferRangeFn> fFlushMappedBufferRange;

            
                    GrGLFunction<GrGLFramebufferRenderbufferFn> fFramebufferRenderbuffer;

            
                    GrGLFunction<GrGLFramebufferTexture2DFn> fFramebufferTexture2D;

            
                    GrGLFunction<GrGLFramebufferTexture2DMultisampleFn> fFramebufferTexture2DMultisample;

            
                    GrGLFunction<GrGLFrontFaceFn> fFrontFace;

            
                    GrGLFunction<GrGLGenBuffersFn> fGenBuffers;

            
                    GrGLFunction<GrGLGenFencesFn> fGenFences;

            
                    GrGLFunction<GrGLGenFramebuffersFn> fGenFramebuffers;

            
                    GrGLFunction<GrGLGenerateMipmapFn> fGenerateMipmap;

            
                    GrGLFunction<GrGLGenQueriesFn> fGenQueries;

            
                    GrGLFunction<GrGLGenRenderbuffersFn> fGenRenderbuffers;

            
                    GrGLFunction<GrGLGenSamplersFn> fGenSamplers;

            
                    GrGLFunction<GrGLGenTexturesFn> fGenTextures;

            
                    GrGLFunction<GrGLGenVertexArraysFn> fGenVertexArrays;

            
                    GrGLFunction<GrGLGetBufferParameterivFn> fGetBufferParameteriv;

            
                    GrGLFunction<GrGLGetErrorFn> fGetError;

            
                    GrGLFunction<GrGLGetFramebufferAttachmentParameterivFn> fGetFramebufferAttachmentParameteriv;

            
                    GrGLFunction<GrGLGetFloatvFn> fGetFloatv;

            
                    GrGLFunction<GrGLGetIntegervFn> fGetIntegerv;

            
                    GrGLFunction<GrGLGetMultisamplefvFn> fGetMultisamplefv;

            
                    GrGLFunction<GrGLGetProgramBinaryFn> fGetProgramBinary;

            
                    GrGLFunction<GrGLGetProgramInfoLogFn> fGetProgramInfoLog;

            
                    GrGLFunction<GrGLGetProgramivFn> fGetProgramiv;

            
                    GrGLFunction<GrGLGetQueryObjecti64vFn> fGetQueryObjecti64v;

            
                    GrGLFunction<GrGLGetQueryObjectivFn> fGetQueryObjectiv;

            
                    GrGLFunction<GrGLGetQueryObjectui64vFn> fGetQueryObjectui64v;

            
                    GrGLFunction<GrGLGetQueryObjectuivFn> fGetQueryObjectuiv;

            
                    GrGLFunction<GrGLGetQueryivFn> fGetQueryiv;

            
                    GrGLFunction<GrGLGetRenderbufferParameterivFn> fGetRenderbufferParameteriv;

            
                    GrGLFunction<GrGLGetShaderInfoLogFn> fGetShaderInfoLog;

            
                    GrGLFunction<GrGLGetShaderivFn> fGetShaderiv;

            
                    GrGLFunction<GrGLGetShaderPrecisionFormatFn> fGetShaderPrecisionFormat;

            
                    GrGLFunction<GrGLGetStringFn> fGetString;

            
                    GrGLFunction<GrGLGetStringiFn> fGetStringi;

            
                    GrGLFunction<GrGLGetTexLevelParameterivFn> fGetTexLevelParameteriv;

            
                    GrGLFunction<GrGLGetUniformLocationFn> fGetUniformLocation;

            
                    GrGLFunction<GrGLInsertEventMarkerFn> fInsertEventMarker;

            
                    GrGLFunction<GrGLInvalidateBufferDataFn> fInvalidateBufferData;

            
                    GrGLFunction<GrGLInvalidateBufferSubDataFn> fInvalidateBufferSubData;

            
                    GrGLFunction<GrGLInvalidateFramebufferFn> fInvalidateFramebuffer;

            
                    GrGLFunction<GrGLInvalidateSubFramebufferFn> fInvalidateSubFramebuffer;

            
                    GrGLFunction<GrGLInvalidateTexImageFn> fInvalidateTexImage;

            
                    GrGLFunction<GrGLInvalidateTexSubImageFn> fInvalidateTexSubImage;

            
                    GrGLFunction<GrGLIsTextureFn> fIsTexture;

            
                    GrGLFunction<GrGLLineWidthFn> fLineWidth;

            
                    GrGLFunction<GrGLLinkProgramFn> fLinkProgram;

            
                    GrGLFunction<GrGLProgramBinaryFn> fProgramBinary;

            
                    GrGLFunction<GrGLProgramParameteriFn> fProgramParameteri;

            
                    GrGLFunction<GrGLMapBufferFn> fMapBuffer;

            
                    GrGLFunction<GrGLMapBufferRangeFn> fMapBufferRange;

            
                    GrGLFunction<GrGLMapBufferSubDataFn> fMapBufferSubData;

            
                    GrGLFunction<GrGLMapTexSubImage2DFn> fMapTexSubImage2D;

            
                    GrGLFunction<GrGLMemoryBarrierFn> fMemoryBarrier;

            
                    GrGLFunction<GrGLDrawArraysInstancedBaseInstanceFn> fDrawArraysInstancedBaseInstance;

            
                    GrGLFunction<GrGLDrawElementsInstancedBaseVertexBaseInstanceFn> fDrawElementsInstancedBaseVertexBaseInstance;

            
                    GrGLFunction<GrGLMultiDrawArraysIndirectFn> fMultiDrawArraysIndirect;

            
                    GrGLFunction<GrGLMultiDrawElementsIndirectFn> fMultiDrawElementsIndirect;

            
                    GrGLFunction<GrGLMultiDrawArraysInstancedBaseInstanceFn> fMultiDrawArraysInstancedBaseInstance;

            
                    GrGLFunction<GrGLMultiDrawElementsInstancedBaseVertexBaseInstanceFn> fMultiDrawElementsInstancedBaseVertexBaseInstance;

            
                    GrGLFunction<GrGLPatchParameteriFn> fPatchParameteri;

            
                    GrGLFunction<GrGLPixelStoreiFn> fPixelStorei;

            
                    GrGLFunction<GrGLPolygonModeFn> fPolygonMode;

            
                    GrGLFunction<GrGLPopGroupMarkerFn> fPopGroupMarker;

            
                    GrGLFunction<GrGLPushGroupMarkerFn> fPushGroupMarker;

            
                    GrGLFunction<GrGLQueryCounterFn> fQueryCounter;

            
                    GrGLFunction<GrGLReadBufferFn> fReadBuffer;

            
                    GrGLFunction<GrGLReadPixelsFn> fReadPixels;

            
                    GrGLFunction<GrGLRenderbufferStorageFn> fRenderbufferStorage;


                    //  On OpenGL ES there are multiple incompatible extensions that add support for MSAA

            
                    //  and ES3 adds MSAA support to the standard. On an ES3 driver we may still use the

            
                    //  older extensions for performance reasons or due to ES3 driver bugs. We want the function

            
                    //  that creates the GrGLInterface to provide all available functions and internally

            
                    //  we will select among them. They all have a method called glRenderbufferStorageMultisample*.

            
                    //  So we have separate function pointers for GL_IMG/EXT_multisampled_to_texture,

            
                    //  GL_CHROMIUM/ANGLE_framebuffer_multisample/ES3, and GL_APPLE_framebuffer_multisample

            
                    //  variations.

            
                    //

            
                    //  If a driver supports multiple GL_ARB_framebuffer_multisample-style extensions then we will

            
                    //  assume the function pointers for the standard (or equivalent GL_ARB) version have

            
                    //  been preferred over GL_EXT, GL_CHROMIUM, or GL_ANGLE variations that have reduced

            
                    //  functionality.


                    //  GL_EXT_multisampled_render_to_texture (preferred) or GL_IMG_multisampled_render_to_texture

            
                    GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisampleES2EXT;

            
                    //  GL_APPLE_framebuffer_multisample

            
                    GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisampleES2APPLE;


                    //  This is used to store the pointer for GL_ARB/EXT/ANGLE/CHROMIUM_framebuffer_multisample or

            
                    //  the standard function in ES3+ or GL 3.0+.

            
                    GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisample;


                    // Pointer to BindUniformLocationCHROMIUM from the GL_CHROMIUM_bind_uniform_location extension.

            
                    GrGLFunction<GrGLBindUniformLocationFn> fBindUniformLocation;


                    GrGLFunction<GrGLResolveMultisampleFramebufferFn> fResolveMultisampleFramebuffer;

            
                    GrGLFunction<GrGLSamplerParameterfFn> fSamplerParameterf;

            
                    GrGLFunction<GrGLSamplerParameteriFn> fSamplerParameteri;

            
                    GrGLFunction<GrGLSamplerParameterivFn> fSamplerParameteriv;

            
                    GrGLFunction<GrGLScissorFn> fScissor;

            
                    GrGLFunction<GrGLSetFenceFn> fSetFence;

            
                    GrGLFunction<GrGLShaderSourceFn> fShaderSource;

            
                    GrGLFunction<GrGLStencilFuncFn> fStencilFunc;

            
                    GrGLFunction<GrGLStencilFuncSeparateFn> fStencilFuncSeparate;

            
                    GrGLFunction<GrGLStencilMaskFn> fStencilMask;

            
                    GrGLFunction<GrGLStencilMaskSeparateFn> fStencilMaskSeparate;

            
                    GrGLFunction<GrGLStencilOpFn> fStencilOp;

            
                    GrGLFunction<GrGLStencilOpSeparateFn> fStencilOpSeparate;

            
                    GrGLFunction<GrGLTestFenceFn> fTestFence;

            
                    GrGLFunction<GrGLTexBufferFn> fTexBuffer;

            
                    GrGLFunction<GrGLTexBufferRangeFn> fTexBufferRange;

            
                    GrGLFunction<GrGLTexImage2DFn> fTexImage2D;

            
                    GrGLFunction<GrGLTexParameterfFn> fTexParameterf;

            
                    GrGLFunction<GrGLTexParameterfvFn> fTexParameterfv;

            
                    GrGLFunction<GrGLTexParameteriFn> fTexParameteri;

            
                    GrGLFunction<GrGLTexParameterivFn> fTexParameteriv;

            
                    GrGLFunction<GrGLTexSubImage2DFn> fTexSubImage2D;

            
                    GrGLFunction<GrGLTexStorage2DFn> fTexStorage2D;

            
                    GrGLFunction<GrGLTextureBarrierFn> fTextureBarrier;

            
                    GrGLFunction<GrGLDiscardFramebufferFn> fDiscardFramebuffer;

            
                    GrGLFunction<GrGLUniform1fFn> fUniform1f;

            
                    GrGLFunction<GrGLUniform1iFn> fUniform1i;

            
                    GrGLFunction<GrGLUniform1fvFn> fUniform1fv;

            
                    GrGLFunction<GrGLUniform1ivFn> fUniform1iv;

            
                    GrGLFunction<GrGLUniform2fFn> fUniform2f;

            
                    GrGLFunction<GrGLUniform2iFn> fUniform2i;

            
                    GrGLFunction<GrGLUniform2fvFn> fUniform2fv;

            
                    GrGLFunction<GrGLUniform2ivFn> fUniform2iv;

            
                    GrGLFunction<GrGLUniform3fFn> fUniform3f;

            
                    GrGLFunction<GrGLUniform3iFn> fUniform3i;

            
                    GrGLFunction<GrGLUniform3fvFn> fUniform3fv;

            
                    GrGLFunction<GrGLUniform3ivFn> fUniform3iv;

            
                    GrGLFunction<GrGLUniform4fFn> fUniform4f;

            
                    GrGLFunction<GrGLUniform4iFn> fUniform4i;

            
                    GrGLFunction<GrGLUniform4fvFn> fUniform4fv;

            
                    GrGLFunction<GrGLUniform4ivFn> fUniform4iv;

            
                    GrGLFunction<GrGLUniformMatrix2fvFn> fUniformMatrix2fv;

            
                    GrGLFunction<GrGLUniformMatrix3fvFn> fUniformMatrix3fv;

            
                    GrGLFunction<GrGLUniformMatrix4fvFn> fUniformMatrix4fv;

            
                    GrGLFunction<GrGLUnmapBufferFn> fUnmapBuffer;

            
                    GrGLFunction<GrGLUnmapBufferSubDataFn> fUnmapBufferSubData;

            
                    GrGLFunction<GrGLUnmapTexSubImage2DFn> fUnmapTexSubImage2D;

            
                    GrGLFunction<GrGLUseProgramFn> fUseProgram;

            
                    GrGLFunction<GrGLVertexAttrib1fFn> fVertexAttrib1f;

            
                    GrGLFunction<GrGLVertexAttrib2fvFn> fVertexAttrib2fv;

            
                    GrGLFunction<GrGLVertexAttrib3fvFn> fVertexAttrib3fv;

            
                    GrGLFunction<GrGLVertexAttrib4fvFn> fVertexAttrib4fv;

            
                    GrGLFunction<GrGLVertexAttribDivisorFn> fVertexAttribDivisor;

            
                    GrGLFunction<GrGLVertexAttribIPointerFn> fVertexAttribIPointer;

            
                    GrGLFunction<GrGLVertexAttribPointerFn> fVertexAttribPointer;

            
                    GrGLFunction<GrGLViewportFn> fViewport;


                    /* ARB_sync */

            
                    GrGLFunction<GrGLFenceSyncFn> fFenceSync;

            
                    GrGLFunction<GrGLIsSyncFn> fIsSync;

            
                    GrGLFunction<GrGLClientWaitSyncFn> fClientWaitSync;

            
                    GrGLFunction<GrGLWaitSyncFn> fWaitSync;

            
                    GrGLFunction<GrGLDeleteSyncFn> fDeleteSync;


                    /* ARB_internalforamt_query */

            
                    GrGLFunction<GrGLGetInternalformativFn> fGetInternalformativ;


                    /* KHR_debug */

            
                    GrGLFunction<GrGLDebugMessageControlFn> fDebugMessageControl;

            
                    GrGLFunction<GrGLDebugMessageInsertFn> fDebugMessageInsert;

            
                    GrGLFunction<GrGLDebugMessageCallbackFn> fDebugMessageCallback;

            
                    GrGLFunction<GrGLGetDebugMessageLogFn> fGetDebugMessageLog;

            
                    GrGLFunction<GrGLPushDebugGroupFn> fPushDebugGroup;

            
                    GrGLFunction<GrGLPopDebugGroupFn> fPopDebugGroup;

            
                    GrGLFunction<GrGLObjectLabelFn> fObjectLabel;


                    /* EXT_window_rectangles */

            
                    GrGLFunction<GrGLWindowRectanglesFn> fWindowRectangles;


                    /* GL_QCOM_tiled_rendering */

            
                    GrGLFunction<GrGLStartTilingFn> fStartTiling;

            
                    GrGLFunction<GrGLEndTilingFn> fEndTiling;

            
                } fFunctions;


            #if defined(GR_TEST_UTILS)

            
                // This exists for internal testing.

            
                virtual void abandon() const;

            
            #endif

            
            };


            #endif
	/*
	* Copyright 2011 Google Inc.
	*
	* Use of this source code is governed by a BSD-style license that can be
	* found in the LICENSE file.
	*/

	#ifndef GrGLInterface_DEFINED
	#define GrGLInterface_DEFINED

	#include "include/core/SkRefCnt.h"
	#include "include/gpu/gl/GrGLExtensions.h"
	#include "include/gpu/gl/GrGLFunctions.h"

	////////////////////////////////////////////////////////////////////////////////

	typedef void(*GrGLFuncPtr)();
	struct GrGLInterface;


	/**
	* Rather than depend on platform-specific GL headers and libraries, we require
	* the client to provide a struct of GL function pointers. This struct can be
	* specified per-GrContext as a parameter to GrContext::MakeGL. If no interface is
	* passed to MakeGL then a default GL interface is created using GrGLMakeNativeInterface().
	* If this returns nullptr then GrContext::MakeGL() will fail.
	*
	* The implementation of GrGLMakeNativeInterface is platform-specific. Several
	* implementations have been provided (for GLX, WGL, EGL, etc), along with an
	* implementation that simply returns nullptr. Clients should select the most
	* appropriate one to build.
	*/
	SK_API sk_sp<const GrGLInterface> GrGLMakeNativeInterface();

	/**
	* GrContext uses the following interface to make all calls into OpenGL. When a
	* GrContext is created it is given a GrGLInterface. The interface's function
	* pointers must be valid for the OpenGL context associated with the GrContext.
	* On some platforms, such as Windows, function pointers for OpenGL extensions
	* may vary between OpenGL contexts. So the caller must be careful to use a
	* GrGLInterface initialized for the correct context. All functions that should
	* be available based on the OpenGL's version and extension string must be
	* non-NULL or GrContext creation will fail. This can be tested with the
	* validate() method when the OpenGL context has been made current.
	*/
	struct SK_API GrGLInterface : public SkRefCnt {
	private:
	using INHERITED = SkRefCnt;

	#if GR_GL_CHECK_ERROR
	// This is here to avoid having our debug code that checks for a GL error after most GL calls
	// accidentally swallow an OOM that should be reported.
	mutable bool fOOMed = false;
	bool fSuppressErrorLogging = false;
	#endif

	public:
	GrGLInterface();

	// Validates that the GrGLInterface supports its advertised standard. This means the necessary
	// function pointers have been initialized for both the GL version and any advertised
	// extensions.
	bool validate() const;

	#if GR_GL_CHECK_ERROR
	GrGLenum checkError(const char* location, const char* call) const;
	bool checkAndResetOOMed() const;
	void suppressErrorLogging();
	#endif

	#if defined(GR_TEST_UTILS)
	GrGLInterface(const GrGLInterface& that)
	: fStandard(that.fStandard)
	, fExtensions(that.fExtensions)
	, fFunctions(that.fFunctions) {}
	#endif

	// Indicates the type of GL implementation
	union {
	GrGLStandard fStandard;
	GrGLStandard fBindingsExported; // Legacy name, will be remove when Chromium is updated.
	};

	GrGLExtensions fExtensions;

	bool hasExtension(const char ext[]) const { return fExtensions.has(ext); }

	/**
	* The function pointers are in a struct so that we can have a compiler generated assignment
	* operator.
	*/
	struct Functions {
	GrGLFunction<GrGLActiveTextureFn> fActiveTexture;
	GrGLFunction<GrGLAttachShaderFn> fAttachShader;
	GrGLFunction<GrGLBeginQueryFn> fBeginQuery;
	GrGLFunction<GrGLBindAttribLocationFn> fBindAttribLocation;
	GrGLFunction<GrGLBindBufferFn> fBindBuffer;
	GrGLFunction<GrGLBindFragDataLocationFn> fBindFragDataLocation;
	GrGLFunction<GrGLBindFragDataLocationIndexedFn> fBindFragDataLocationIndexed;
	GrGLFunction<GrGLBindFramebufferFn> fBindFramebuffer;
	GrGLFunction<GrGLBindRenderbufferFn> fBindRenderbuffer;
	GrGLFunction<GrGLBindSamplerFn> fBindSampler;
	GrGLFunction<GrGLBindTextureFn> fBindTexture;
	GrGLFunction<GrGLBindVertexArrayFn> fBindVertexArray;
	GrGLFunction<GrGLBlendBarrierFn> fBlendBarrier;
	GrGLFunction<GrGLBlendColorFn> fBlendColor;
	GrGLFunction<GrGLBlendEquationFn> fBlendEquation;
	GrGLFunction<GrGLBlendFuncFn> fBlendFunc;
	GrGLFunction<GrGLBlitFramebufferFn> fBlitFramebuffer;
	GrGLFunction<GrGLBufferDataFn> fBufferData;
	GrGLFunction<GrGLBufferSubDataFn> fBufferSubData;
	GrGLFunction<GrGLCheckFramebufferStatusFn> fCheckFramebufferStatus;
	GrGLFunction<GrGLClearFn> fClear;
	GrGLFunction<GrGLClearColorFn> fClearColor;
	GrGLFunction<GrGLClearStencilFn> fClearStencil;
	GrGLFunction<GrGLClearTexImageFn> fClearTexImage;
	GrGLFunction<GrGLClearTexSubImageFn> fClearTexSubImage;
	GrGLFunction<GrGLColorMaskFn> fColorMask;
	GrGLFunction<GrGLCompileShaderFn> fCompileShader;
	GrGLFunction<GrGLCompressedTexImage2DFn> fCompressedTexImage2D;
	GrGLFunction<GrGLCompressedTexSubImage2DFn> fCompressedTexSubImage2D;
	GrGLFunction<GrGLCopyBufferSubDataFn> fCopyBufferSubData;
	GrGLFunction<GrGLCopyTexSubImage2DFn> fCopyTexSubImage2D;
	GrGLFunction<GrGLCreateProgramFn> fCreateProgram;
	GrGLFunction<GrGLCreateShaderFn> fCreateShader;
	GrGLFunction<GrGLCullFaceFn> fCullFace;
	GrGLFunction<GrGLDeleteBuffersFn> fDeleteBuffers;
	GrGLFunction<GrGLDeleteFencesFn> fDeleteFences;
	GrGLFunction<GrGLDeleteFramebuffersFn> fDeleteFramebuffers;
	GrGLFunction<GrGLDeleteProgramFn> fDeleteProgram;
	GrGLFunction<GrGLDeleteQueriesFn> fDeleteQueries;
	GrGLFunction<GrGLDeleteRenderbuffersFn> fDeleteRenderbuffers;
	GrGLFunction<GrGLDeleteSamplersFn> fDeleteSamplers;
	GrGLFunction<GrGLDeleteShaderFn> fDeleteShader;
	GrGLFunction<GrGLDeleteTexturesFn> fDeleteTextures;
	GrGLFunction<GrGLDeleteVertexArraysFn> fDeleteVertexArrays;
	GrGLFunction<GrGLDepthMaskFn> fDepthMask;
	GrGLFunction<GrGLDisableFn> fDisable;
	GrGLFunction<GrGLDisableVertexAttribArrayFn> fDisableVertexAttribArray;
	GrGLFunction<GrGLDrawArraysFn> fDrawArrays;
	GrGLFunction<GrGLDrawArraysIndirectFn> fDrawArraysIndirect;
	GrGLFunction<GrGLDrawArraysInstancedFn> fDrawArraysInstanced;
	GrGLFunction<GrGLDrawBufferFn> fDrawBuffer;
	GrGLFunction<GrGLDrawBuffersFn> fDrawBuffers;
	GrGLFunction<GrGLDrawElementsFn> fDrawElements;
	GrGLFunction<GrGLDrawElementsIndirectFn> fDrawElementsIndirect;
	GrGLFunction<GrGLDrawElementsInstancedFn> fDrawElementsInstanced;
	GrGLFunction<GrGLDrawRangeElementsFn> fDrawRangeElements;
	GrGLFunction<GrGLEnableFn> fEnable;
	GrGLFunction<GrGLEnableVertexAttribArrayFn> fEnableVertexAttribArray;
	GrGLFunction<GrGLEndQueryFn> fEndQuery;
	GrGLFunction<GrGLFinishFn> fFinish;
	GrGLFunction<GrGLFinishFenceFn> fFinishFence;
	GrGLFunction<GrGLFlushFn> fFlush;
	GrGLFunction<GrGLFlushMappedBufferRangeFn> fFlushMappedBufferRange;
	GrGLFunction<GrGLFramebufferRenderbufferFn> fFramebufferRenderbuffer;
	GrGLFunction<GrGLFramebufferTexture2DFn> fFramebufferTexture2D;
	GrGLFunction<GrGLFramebufferTexture2DMultisampleFn> fFramebufferTexture2DMultisample;
	GrGLFunction<GrGLFrontFaceFn> fFrontFace;
	GrGLFunction<GrGLGenBuffersFn> fGenBuffers;
	GrGLFunction<GrGLGenFencesFn> fGenFences;
	GrGLFunction<GrGLGenFramebuffersFn> fGenFramebuffers;
	GrGLFunction<GrGLGenerateMipmapFn> fGenerateMipmap;
	GrGLFunction<GrGLGenQueriesFn> fGenQueries;
	GrGLFunction<GrGLGenRenderbuffersFn> fGenRenderbuffers;
	GrGLFunction<GrGLGenSamplersFn> fGenSamplers;
	GrGLFunction<GrGLGenTexturesFn> fGenTextures;
	GrGLFunction<GrGLGenVertexArraysFn> fGenVertexArrays;
	GrGLFunction<GrGLGetBufferParameterivFn> fGetBufferParameteriv;
	GrGLFunction<GrGLGetErrorFn> fGetError;
	GrGLFunction<GrGLGetFramebufferAttachmentParameterivFn> fGetFramebufferAttachmentParameteriv;
	GrGLFunction<GrGLGetFloatvFn> fGetFloatv;
	GrGLFunction<GrGLGetIntegervFn> fGetIntegerv;
	GrGLFunction<GrGLGetMultisamplefvFn> fGetMultisamplefv;
	GrGLFunction<GrGLGetProgramBinaryFn> fGetProgramBinary;
	GrGLFunction<GrGLGetProgramInfoLogFn> fGetProgramInfoLog;
	GrGLFunction<GrGLGetProgramivFn> fGetProgramiv;
	GrGLFunction<GrGLGetQueryObjecti64vFn> fGetQueryObjecti64v;
	GrGLFunction<GrGLGetQueryObjectivFn> fGetQueryObjectiv;
	GrGLFunction<GrGLGetQueryObjectui64vFn> fGetQueryObjectui64v;
	GrGLFunction<GrGLGetQueryObjectuivFn> fGetQueryObjectuiv;
	GrGLFunction<GrGLGetQueryivFn> fGetQueryiv;
	GrGLFunction<GrGLGetRenderbufferParameterivFn> fGetRenderbufferParameteriv;
	GrGLFunction<GrGLGetShaderInfoLogFn> fGetShaderInfoLog;
	GrGLFunction<GrGLGetShaderivFn> fGetShaderiv;
	GrGLFunction<GrGLGetShaderPrecisionFormatFn> fGetShaderPrecisionFormat;
	GrGLFunction<GrGLGetStringFn> fGetString;
	GrGLFunction<GrGLGetStringiFn> fGetStringi;
	GrGLFunction<GrGLGetTexLevelParameterivFn> fGetTexLevelParameteriv;
	GrGLFunction<GrGLGetUniformLocationFn> fGetUniformLocation;
	GrGLFunction<GrGLInsertEventMarkerFn> fInsertEventMarker;
	GrGLFunction<GrGLInvalidateBufferDataFn> fInvalidateBufferData;
	GrGLFunction<GrGLInvalidateBufferSubDataFn> fInvalidateBufferSubData;
	GrGLFunction<GrGLInvalidateFramebufferFn> fInvalidateFramebuffer;
	GrGLFunction<GrGLInvalidateSubFramebufferFn> fInvalidateSubFramebuffer;
	GrGLFunction<GrGLInvalidateTexImageFn> fInvalidateTexImage;
	GrGLFunction<GrGLInvalidateTexSubImageFn> fInvalidateTexSubImage;
	GrGLFunction<GrGLIsTextureFn> fIsTexture;
	GrGLFunction<GrGLLineWidthFn> fLineWidth;
	GrGLFunction<GrGLLinkProgramFn> fLinkProgram;
	GrGLFunction<GrGLProgramBinaryFn> fProgramBinary;
	GrGLFunction<GrGLProgramParameteriFn> fProgramParameteri;
	GrGLFunction<GrGLMapBufferFn> fMapBuffer;
	GrGLFunction<GrGLMapBufferRangeFn> fMapBufferRange;
	GrGLFunction<GrGLMapBufferSubDataFn> fMapBufferSubData;
	GrGLFunction<GrGLMapTexSubImage2DFn> fMapTexSubImage2D;
	GrGLFunction<GrGLMemoryBarrierFn> fMemoryBarrier;
	GrGLFunction<GrGLDrawArraysInstancedBaseInstanceFn> fDrawArraysInstancedBaseInstance;
	GrGLFunction<GrGLDrawElementsInstancedBaseVertexBaseInstanceFn> fDrawElementsInstancedBaseVertexBaseInstance;
	GrGLFunction<GrGLMultiDrawArraysIndirectFn> fMultiDrawArraysIndirect;
	GrGLFunction<GrGLMultiDrawElementsIndirectFn> fMultiDrawElementsIndirect;
	GrGLFunction<GrGLMultiDrawArraysInstancedBaseInstanceFn> fMultiDrawArraysInstancedBaseInstance;
	GrGLFunction<GrGLMultiDrawElementsInstancedBaseVertexBaseInstanceFn> fMultiDrawElementsInstancedBaseVertexBaseInstance;
	GrGLFunction<GrGLPatchParameteriFn> fPatchParameteri;
	GrGLFunction<GrGLPixelStoreiFn> fPixelStorei;
	GrGLFunction<GrGLPolygonModeFn> fPolygonMode;
	GrGLFunction<GrGLPopGroupMarkerFn> fPopGroupMarker;
	GrGLFunction<GrGLPushGroupMarkerFn> fPushGroupMarker;
	GrGLFunction<GrGLQueryCounterFn> fQueryCounter;
	GrGLFunction<GrGLReadBufferFn> fReadBuffer;
	GrGLFunction<GrGLReadPixelsFn> fReadPixels;
	GrGLFunction<GrGLRenderbufferStorageFn> fRenderbufferStorage;

	// On OpenGL ES there are multiple incompatible extensions that add support for MSAA
	// and ES3 adds MSAA support to the standard. On an ES3 driver we may still use the
	// older extensions for performance reasons or due to ES3 driver bugs. We want the function
	// that creates the GrGLInterface to provide all available functions and internally
	// we will select among them. They all have a method called glRenderbufferStorageMultisample*.
	// So we have separate function pointers for GL_IMG/EXT_multisampled_to_texture,
	// GL_CHROMIUM/ANGLE_framebuffer_multisample/ES3, and GL_APPLE_framebuffer_multisample
	// variations.
	//
	// If a driver supports multiple GL_ARB_framebuffer_multisample-style extensions then we will
	// assume the function pointers for the standard (or equivalent GL_ARB) version have
	// been preferred over GL_EXT, GL_CHROMIUM, or GL_ANGLE variations that have reduced
	// functionality.

	// GL_EXT_multisampled_render_to_texture (preferred) or GL_IMG_multisampled_render_to_texture
	GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisampleES2EXT;
	// GL_APPLE_framebuffer_multisample
	GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisampleES2APPLE;

	// This is used to store the pointer for GL_ARB/EXT/ANGLE/CHROMIUM_framebuffer_multisample or
	// the standard function in ES3+ or GL 3.0+.
	GrGLFunction<GrGLRenderbufferStorageMultisampleFn> fRenderbufferStorageMultisample;

	// Pointer to BindUniformLocationCHROMIUM from the GL_CHROMIUM_bind_uniform_location extension.
	GrGLFunction<GrGLBindUniformLocationFn> fBindUniformLocation;

	GrGLFunction<GrGLResolveMultisampleFramebufferFn> fResolveMultisampleFramebuffer;
	GrGLFunction<GrGLSamplerParameterfFn> fSamplerParameterf;
	GrGLFunction<GrGLSamplerParameteriFn> fSamplerParameteri;
	GrGLFunction<GrGLSamplerParameterivFn> fSamplerParameteriv;
	GrGLFunction<GrGLScissorFn> fScissor;
	GrGLFunction<GrGLSetFenceFn> fSetFence;
	GrGLFunction<GrGLShaderSourceFn> fShaderSource;
	GrGLFunction<GrGLStencilFuncFn> fStencilFunc;
	GrGLFunction<GrGLStencilFuncSeparateFn> fStencilFuncSeparate;
	GrGLFunction<GrGLStencilMaskFn> fStencilMask;
	GrGLFunction<GrGLStencilMaskSeparateFn> fStencilMaskSeparate;
	GrGLFunction<GrGLStencilOpFn> fStencilOp;
	GrGLFunction<GrGLStencilOpSeparateFn> fStencilOpSeparate;
	GrGLFunction<GrGLTestFenceFn> fTestFence;
	GrGLFunction<GrGLTexBufferFn> fTexBuffer;
	GrGLFunction<GrGLTexBufferRangeFn> fTexBufferRange;
	GrGLFunction<GrGLTexImage2DFn> fTexImage2D;
	GrGLFunction<GrGLTexParameterfFn> fTexParameterf;
	GrGLFunction<GrGLTexParameterfvFn> fTexParameterfv;
	GrGLFunction<GrGLTexParameteriFn> fTexParameteri;
	GrGLFunction<GrGLTexParameterivFn> fTexParameteriv;
	GrGLFunction<GrGLTexSubImage2DFn> fTexSubImage2D;
	GrGLFunction<GrGLTexStorage2DFn> fTexStorage2D;
	GrGLFunction<GrGLTextureBarrierFn> fTextureBarrier;
	GrGLFunction<GrGLDiscardFramebufferFn> fDiscardFramebuffer;
	GrGLFunction<GrGLUniform1fFn> fUniform1f;
	GrGLFunction<GrGLUniform1iFn> fUniform1i;
	GrGLFunction<GrGLUniform1fvFn> fUniform1fv;
	GrGLFunction<GrGLUniform1ivFn> fUniform1iv;
	GrGLFunction<GrGLUniform2fFn> fUniform2f;
	GrGLFunction<GrGLUniform2iFn> fUniform2i;
	GrGLFunction<GrGLUniform2fvFn> fUniform2fv;
	GrGLFunction<GrGLUniform2ivFn> fUniform2iv;
	GrGLFunction<GrGLUniform3fFn> fUniform3f;
	GrGLFunction<GrGLUniform3iFn> fUniform3i;
	GrGLFunction<GrGLUniform3fvFn> fUniform3fv;
	GrGLFunction<GrGLUniform3ivFn> fUniform3iv;
	GrGLFunction<GrGLUniform4fFn> fUniform4f;
	GrGLFunction<GrGLUniform4iFn> fUniform4i;
	GrGLFunction<GrGLUniform4fvFn> fUniform4fv;
	GrGLFunction<GrGLUniform4ivFn> fUniform4iv;
	GrGLFunction<GrGLUniformMatrix2fvFn> fUniformMatrix2fv;
	GrGLFunction<GrGLUniformMatrix3fvFn> fUniformMatrix3fv;
	GrGLFunction<GrGLUniformMatrix4fvFn> fUniformMatrix4fv;
	GrGLFunction<GrGLUnmapBufferFn> fUnmapBuffer;
	GrGLFunction<GrGLUnmapBufferSubDataFn> fUnmapBufferSubData;
	GrGLFunction<GrGLUnmapTexSubImage2DFn> fUnmapTexSubImage2D;
	GrGLFunction<GrGLUseProgramFn> fUseProgram;
	GrGLFunction<GrGLVertexAttrib1fFn> fVertexAttrib1f;
	GrGLFunction<GrGLVertexAttrib2fvFn> fVertexAttrib2fv;
	GrGLFunction<GrGLVertexAttrib3fvFn> fVertexAttrib3fv;
	GrGLFunction<GrGLVertexAttrib4fvFn> fVertexAttrib4fv;
	GrGLFunction<GrGLVertexAttribDivisorFn> fVertexAttribDivisor;
	GrGLFunction<GrGLVertexAttribIPointerFn> fVertexAttribIPointer;
	GrGLFunction<GrGLVertexAttribPointerFn> fVertexAttribPointer;
	GrGLFunction<GrGLViewportFn> fViewport;

	/* ARB_sync */
	GrGLFunction<GrGLFenceSyncFn> fFenceSync;
	GrGLFunction<GrGLIsSyncFn> fIsSync;
	GrGLFunction<GrGLClientWaitSyncFn> fClientWaitSync;
	GrGLFunction<GrGLWaitSyncFn> fWaitSync;
	GrGLFunction<GrGLDeleteSyncFn> fDeleteSync;

	/* ARB_internalforamt_query */
	GrGLFunction<GrGLGetInternalformativFn> fGetInternalformativ;

	/* KHR_debug */
	GrGLFunction<GrGLDebugMessageControlFn> fDebugMessageControl;
	GrGLFunction<GrGLDebugMessageInsertFn> fDebugMessageInsert;
	GrGLFunction<GrGLDebugMessageCallbackFn> fDebugMessageCallback;
	GrGLFunction<GrGLGetDebugMessageLogFn> fGetDebugMessageLog;
	GrGLFunction<GrGLPushDebugGroupFn> fPushDebugGroup;
	GrGLFunction<GrGLPopDebugGroupFn> fPopDebugGroup;
	GrGLFunction<GrGLObjectLabelFn> fObjectLabel;

	/* EXT_window_rectangles */
	GrGLFunction<GrGLWindowRectanglesFn> fWindowRectangles;

	/* GL_QCOM_tiled_rendering */
	GrGLFunction<GrGLStartTilingFn> fStartTiling;
	GrGLFunction<GrGLEndTilingFn> fEndTiling;
	} fFunctions;

	#if defined(GR_TEST_UTILS)
	// This exists for internal testing.
	virtual void abandon() const;
	#endif
	};

	#endif