1dcf506a1a
Review URL: http://codereview.appspot.com/5376094/ git-svn-id: http://skia.googlecode.com/svn/trunk@2678 2bbb7eff-a529-9590-31e7-b0007b416f81
244 lines
9.0 KiB
C
244 lines
9.0 KiB
C
|
|
/*
|
|
* 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 GrGLConfig_DEFINED
|
|
#define GrGLConfig_DEFINED
|
|
|
|
#include "GrTypes.h"
|
|
#include "GrGLDefines.h"
|
|
|
|
/**
|
|
* Optional GL config file.
|
|
*/
|
|
#ifdef GR_GL_CUSTOM_SETUP_HEADER
|
|
#include GR_GL_CUSTOM_SETUP_HEADER
|
|
#endif
|
|
|
|
#if !defined(GR_GL_FUNCTION_TYPE)
|
|
#define GR_GL_FUNCTION_TYPE
|
|
#endif
|
|
|
|
/**
|
|
* The following are optional defines that can be enabled at the compiler
|
|
* command line, in a IDE project, in a GrUserConfig.h file, or in a GL custom
|
|
* file (if one is in use). If a GR_GL_CUSTOM_SETUP_HEADER is used they can
|
|
* also be placed there.
|
|
*
|
|
* GR_GL_LOG_CALLS: if 1 Gr can print every GL call using GrPrintf. Defaults to
|
|
* 0. Logging can be enabled and disabled at runtime using a debugger via to
|
|
* global gLogCallsGL. The initial value of gLogCallsGL is controlled by
|
|
* GR_GL_LOG_CALLS_START.
|
|
*
|
|
* GR_GL_LOG_CALLS_START: controls the initial value of gLogCallsGL when
|
|
* GR_GL_LOG_CALLS is 1. Defaults to 0.
|
|
*
|
|
* GR_GL_CHECK_ERROR: if enabled Gr can do a glGetError() after every GL call.
|
|
* Defaults to 1 if GR_DEBUG is set, otherwise 0. When GR_GL_CHECK_ERROR is 1
|
|
* this can be toggled in a debugger using the gCheckErrorGL global. The initial
|
|
* value of gCheckErrorGL is controlled by by GR_GL_CHECK_ERROR_START.
|
|
*
|
|
* GR_GL_CHECK_ERROR_START: controls the initial value of gCheckErrorGL
|
|
* when GR_GL_CHECK_ERROR is 1. Defaults to 1.
|
|
*
|
|
* GR_GL_NO_CONSTANT_ATTRIBUTES: if this evaluates to true then the GL backend
|
|
* will use uniforms instead of attributes in all cases when there is not
|
|
* per-vertex data. This is important when the underlying GL implementation
|
|
* doesn't actually support immediate style attribute values (e.g. when
|
|
* the GL stream is converted to DX as in ANGLE on Chrome). Defaults to 0.
|
|
*
|
|
* GR_GL_ATTRIBUTE_MATRICES: If changing uniforms is very expensive it may be
|
|
* faster to use vertex attributes for matrices (set via glVertexAttrib3fv).
|
|
* Setting this build flag enables this behavior. GR_GL_NO_CONSTANT_ATTRIBUTES
|
|
* must not be set since this uses constant attributes for the matrices.
|
|
* Defaults to 0.
|
|
*
|
|
* GR_GL_USE_BUFFER_DATA_NULL_HINT: When specifing new data for a vertex/index
|
|
* buffer that replaces old data Ganesh can give a hint to the driver that the
|
|
* previous data will not be used in future draws like this:
|
|
* glBufferData(GL_..._BUFFER, size, NULL, usage); //<--hint, NULL means
|
|
* glBufferSubData(GL_..._BUFFER, 0, lessThanSize, data) // old data can't be
|
|
* // used again.
|
|
* However, this can be an unoptimization on some platforms, esp. Chrome.
|
|
* Chrome's cmd buffer will create a new allocation and memset the whole thing
|
|
* to zero (for security reasons). Defaults to 1 (enabled).
|
|
*
|
|
* GR_GL_PER_GL_FUNC_CALLBACK: When set to 1 the GrGLInterface object provides
|
|
* a function pointer that is called just before every gl function. The ptr must
|
|
* be valid (i.e. there is no NULL check). However, by default the callback will
|
|
* be set to a function that does nothing. The signature of the function is:
|
|
* void function(const GrGLInterface*)
|
|
* It is not extern "C".
|
|
* The GrGLInterface field fCallback specifies the function ptr and there is an
|
|
* additional field fCallbackData of type intptr_t for client data.
|
|
*
|
|
* GR_GL_RGBA_8888_READBACK_SLOW: Set this to 1 if it is known that performing
|
|
* glReadPixels with format=GL_RGBA, type=GL_UNISIGNED_BYTE is significantly
|
|
* slower than format=GL_BGRA, type=GL_UNISIGNED_BYTE.
|
|
*/
|
|
|
|
#if !defined(GR_GL_LOG_CALLS)
|
|
#define GR_GL_LOG_CALLS GR_DEBUG
|
|
#endif
|
|
|
|
#if !defined(GR_GL_LOG_CALLS_START)
|
|
#define GR_GL_LOG_CALLS_START 0
|
|
#endif
|
|
|
|
#if !defined(GR_GL_CHECK_ERROR)
|
|
#define GR_GL_CHECK_ERROR GR_DEBUG
|
|
#endif
|
|
|
|
#if !defined(GR_GL_CHECK_ERROR_START)
|
|
#define GR_GL_CHECK_ERROR_START 1
|
|
#endif
|
|
|
|
#if !defined(GR_GL_NO_CONSTANT_ATTRIBUTES)
|
|
#define GR_GL_NO_CONSTANT_ATTRIBUTES 0
|
|
#endif
|
|
|
|
#if !defined(GR_GL_ATTRIBUTE_MATRICES)
|
|
#define GR_GL_ATTRIBUTE_MATRICES 0
|
|
#endif
|
|
|
|
#if !defined(GR_GL_USE_BUFFER_DATA_NULL_HINT)
|
|
#define GR_GL_USE_BUFFER_DATA_NULL_HINT 1
|
|
#endif
|
|
|
|
#if !defined(GR_GL_PER_GL_FUNC_CALLBACK)
|
|
#define GR_GL_PER_GL_FUNC_CALLBACK 0
|
|
#endif
|
|
|
|
#if !defined(GR_GL_RGBA_8888_READBACK_SLOW)
|
|
#define GR_GL_RGBA_8888_READBACK_SLOW 0
|
|
#endif
|
|
|
|
#if(GR_GL_NO_CONSTANT_ATTRIBUTES) && (GR_GL_ATTRIBUTE_MATRICES)
|
|
#error "Cannot combine GR_GL_NO_CONSTANT_ATTRIBUTES and GR_GL_ATTRIBUTE_MATRICES"
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#if GR_SCALAR_IS_FIXED
|
|
#define GrGLType GL_FIXED
|
|
#elif GR_SCALAR_IS_FLOAT
|
|
#define GrGLType GR_GL_FLOAT
|
|
#else
|
|
#error "unknown GR_SCALAR type"
|
|
#endif
|
|
|
|
#if GR_TEXT_SCALAR_IS_USHORT
|
|
#define GrGLTextType GR_GL_UNSIGNED_SHORT
|
|
#define GR_GL_TEXT_TEXTURE_NORMALIZED 1
|
|
#elif GR_TEXT_SCALAR_IS_FLOAT
|
|
#define GrGLTextType GR_GL_FLOAT
|
|
#define GR_GL_TEXT_TEXTURE_NORMALIZED 0
|
|
#elif GR_TEXT_SCALAR_IS_FIXED
|
|
#define GrGLTextType GR_GL_FIXED
|
|
#define GR_GL_TEXT_TEXTURE_NORMALIZED 0
|
|
#else
|
|
#error "unknown GR_TEXT_SCALAR type"
|
|
#endif
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
struct GrGLInterface;
|
|
|
|
extern void GrGLCheckErr(const GrGLInterface* gl,
|
|
const char* location,
|
|
const char* call);
|
|
|
|
extern void GrGLClearErr(const GrGLInterface* gl);
|
|
|
|
#if GR_GL_CHECK_ERROR
|
|
extern bool gCheckErrorGL;
|
|
#define GR_GL_CHECK_ERROR_IMPL(IFACE, X) \
|
|
if (gCheckErrorGL) \
|
|
GrGLCheckErr(IFACE, GR_FILE_AND_LINE_STR, #X)
|
|
#else
|
|
#define GR_GL_CHECK_ERROR_IMPL(IFACE, X)
|
|
#endif
|
|
|
|
#if GR_GL_LOG_CALLS
|
|
extern bool gLogCallsGL;
|
|
#define GR_GL_LOG_CALLS_IMPL(X) \
|
|
if (gLogCallsGL) \
|
|
GrPrintf(GR_FILE_AND_LINE_STR "GL: " #X "\n")
|
|
#else
|
|
#define GR_GL_LOG_CALLS_IMPL(X)
|
|
#endif
|
|
|
|
#if GR_GL_PER_GL_FUNC_CALLBACK
|
|
#define GR_GL_CALLBACK_IMPL(IFACE) (IFACE)->fCallback(IFACE)
|
|
#else
|
|
#define GR_GL_CALLBACK_IMPL(IFACE)
|
|
#endif
|
|
|
|
#define GR_GL_CALL(IFACE, X) \
|
|
do { \
|
|
GR_GL_CALL_NOERRCHECK(IFACE, X); \
|
|
GR_GL_CHECK_ERROR_IMPL(IFACE, X); \
|
|
} while (false)
|
|
|
|
#define GR_GL_CALL_NOERRCHECK(IFACE, X) \
|
|
do { \
|
|
GR_GL_CALLBACK_IMPL(IFACE); \
|
|
(IFACE)->f##X; \
|
|
GR_GL_LOG_CALLS_IMPL(X); \
|
|
} while (false)
|
|
|
|
#define GR_GL_CALL_RET(IFACE, RET, X) \
|
|
do { \
|
|
GR_GL_CALL_RET_NOERRCHECK(IFACE, RET, X); \
|
|
GR_GL_CHECK_ERROR_IMPL(IFACE, X); \
|
|
} while (false)
|
|
|
|
#define GR_GL_CALL_RET_NOERRCHECK(IFACE, RET, X) \
|
|
do { \
|
|
GR_GL_CALLBACK_IMPL(IFACE); \
|
|
(RET) = (IFACE)->f##X; \
|
|
GR_GL_LOG_CALLS_IMPL(X); \
|
|
} while (false)
|
|
|
|
#define GR_GL_GET_ERROR(IFACE) (IFACE)->fGetError()
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
* Some drivers want the var-int arg to be zero-initialized on input.
|
|
*/
|
|
#define GR_GL_INIT_ZERO 0
|
|
#define GR_GL_GetIntegerv(gl, e, p) \
|
|
do { \
|
|
*(p) = GR_GL_INIT_ZERO; \
|
|
GR_GL_CALL(gl, GetIntegerv(e, p)); \
|
|
} while (0)
|
|
|
|
#define GR_GL_GetFramebufferAttachmentParameteriv(gl, t, a, pname, p) \
|
|
do { \
|
|
*(p) = GR_GL_INIT_ZERO; \
|
|
GR_GL_CALL(gl, GetFramebufferAttachmentParameteriv(t, a, pname, p)); \
|
|
} while (0)
|
|
|
|
#define GR_GL_GetRenderbufferParameteriv(gl, t, pname, p) \
|
|
do { \
|
|
*(p) = GR_GL_INIT_ZERO; \
|
|
GR_GL_CALL(gl, GetRenderbufferParameteriv(t, pname, p)); \
|
|
} while (0)
|
|
|
|
#define GR_GL_GetTexLevelParameteriv(gl, t, l, pname, p) \
|
|
do { \
|
|
*(p) = GR_GL_INIT_ZERO; \
|
|
GR_GL_CALL(gl, GetTexLevelParameteriv(t, l, pname, p)); \
|
|
} while (0)
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#endif
|