GrGLExtensions Class Reference

#include <GrGLExtensions.h>

Public Member Functions
	GrGLExtensions ()
	GrGLExtensions (const GrGLExtensions &)
GrGLExtensions &	operator= (const GrGLExtensions &)
void	swap (GrGLExtensions *that)
bool	init (GrGLStandard standard, GrGLFunction< GrGLGetStringFn > getString, GrGLFunction< GrGLGetStringiFn > getStringi, GrGLFunction< GrGLGetIntegervFn > getIntegerv, GrGLFunction< GrEGLQueryStringFn > queryString=nullptr, GrEGLDisplay eglDisplay=nullptr)
bool	isInitialized () const
bool	has (const char[]) const
bool	remove (const char[])
void	add (const char[])
void	reset ()
void	dumpJSON (SkJSONWriter *) const

Detailed Description

This helper queries the current GL context for its extensions, remembers them, and can be queried. It supports both glGetString- and glGetStringi-style extension string APIs and will use the latter if it is available. It also will query for EGL extensions if a eglQueryString implementation is provided.

Definition at line 26 of file GrGLExtensions.h.

Constructor & Destructor Documentation

GrGLExtensions() [1/2]

GrGLExtensions::GrGLExtensions ( )

inline

Definition at line 28 of file GrGLExtensions.h.

{}

GrGLExtensions() [2/2]

GrGLExtensions::GrGLExtensions

(

const GrGLExtensions &

that

)

Definition at line 36 of file GrGLExtensions.cpp.

                                                         {
    *this = that;
}

Member Function Documentation

add()

void GrGLExtensions::add

(

const char

ext[]

)

Adds an extension to list

Definition at line 148 of file GrGLExtensions.cpp.

                                         {
    int idx = find_string(fStrings, ext);
    if (idx < 0) {
        // This is not the most effecient approach since we end up looking at all of the
        // extensions after the add
        fStrings.emplace_back(ext);
        SkTInsertionSort(fStrings.begin(), fStrings.size(), extension_compare);
    }
}

dumpJSON()

void GrGLExtensions::dumpJSON

(

SkJSONWriter *

writer

)

const

Definition at line 169 of file GrGLExtensions.cpp.

{ }

has()

bool GrGLExtensions::has

(

const char

ext[]

)

const

Queries whether an extension is present. This will fail if init() has not been called.

Definition at line 127 of file GrGLExtensions.cpp.

                                               {
    SkASSERT(fInitialized);
    return find_string(fStrings, ext) >= 0;
}

init()

bool GrGLExtensions::init	(	GrGLStandard	standard,
		GrGLFunction< GrGLGetStringFn >	getString,
		GrGLFunction< GrGLGetStringiFn >	getStringi,
		GrGLFunction< GrGLGetIntegervFn >	getIntegerv,
		GrGLFunction< GrEGLQueryStringFn >	queryString = nullptr,
		GrEGLDisplay	eglDisplay = nullptr
	)

We sometimes need to use this class without having yet created a GrGLInterface. This version of init expects that getString is always non-NULL while getIntegerv and getStringi are non- NULL if on desktop GL with version 3.0 or higher. Otherwise it will fail.

Definition at line 68 of file GrGLExtensions.cpp.

                                                   {
    fInitialized = false;
    fStrings.clear();
 
    if (!getString) {
        return false;
    }
 
    const GrGLubyte* verString = getString(GR_GL_VERSION);
    GrGLVersion version = GrGLGetVersionFromString((const char*) verString);
    if (GR_GL_INVALID_VER == version) {
        return false;
    }
 
    bool indexed = false;
    if (GR_IS_GR_GL(standard) || GR_IS_GR_GL_ES(standard)) {
        // glGetStringi and indexed extensions were added in version 3.0 of desktop GL and ES.
        indexed = version >= GR_GL_VER(3, 0);
    } else if (GR_IS_GR_WEBGL(standard)) {
        // WebGL (1.0 or 2.0) doesn't natively support glGetStringi, but enscripten adds it in
        // https://github.com/emscripten-core/emscripten/issues/3472
        indexed = version >= GR_GL_VER(2, 0);
    }
 
    if (indexed) {
        if (!getStringi || !getIntegerv) {
            return false;
        }
        GrGLint extensionCnt = 0;
        getIntegerv(GR_GL_NUM_EXTENSIONS, &extensionCnt);
        fStrings.push_back_n(extensionCnt);
        for (int i = 0; i < extensionCnt; ++i) {
            const char* ext = (const char*) getStringi(GR_GL_EXTENSIONS, i);
            fStrings[i] = ext;
        }
    } else {
        const char* extensions = (const char*) getString(GR_GL_EXTENSIONS);
        if (!extensions) {
            return false;
        }
        eat_space_sep_strings(&fStrings, extensions);
    }
    if (queryString) {
        const char* extensions = queryString(eglDisplay, GR_EGL_EXTENSIONS);
 
        eat_space_sep_strings(&fStrings, extensions);
    }
    if (!fStrings.empty()) {
        SkTQSort(fStrings.begin(), fStrings.end(), extension_compare);
    }
    fInitialized = true;
    return true;
}

isInitialized()

bool GrGLExtensions::isInitialized ( ) const

inline

Definition at line 52 of file GrGLExtensions.h.

{ return fInitialized; }

operator=()

GrGLExtensions & GrGLExtensions::operator=

(

const GrGLExtensions &

that

)

Definition at line 40 of file GrGLExtensions.cpp.

                                                                    {
    if (this != &that) {
        fStrings = that.fStrings;
        fInitialized = that.fInitialized;
    }
    return *this;
}

remove()

bool GrGLExtensions::remove

(

const char

ext[]

)

Removes an extension if present. Returns true if the extension was present before the call.

Definition at line 132 of file GrGLExtensions.cpp.

                                            {
    SkASSERT(fInitialized);
    int idx = find_string(fStrings, ext);
    if (idx < 0) {
        return false;
    }
 
    // This is not terribly effecient but we really only expect this function to be called at
    // most a handful of times when our test programs start.
    fStrings.removeShuffle(idx);
    if (idx != fStrings.size()) {
        SkTInsertionSort(fStrings.begin() + idx, fStrings.size() - idx, extension_compare);
    }
    return true;
}

reset()

void GrGLExtensions::reset ( )

inline

Definition at line 69 of file GrGLExtensions.h.

{ fStrings.clear(); }

swap()

void GrGLExtensions::swap ( GrGLExtensions *  that )

inline

Definition at line 34 of file GrGLExtensions.h.

                                    {
        using std::swap;
        swap(fStrings, that->fStrings);
        swap(fInitialized, that->fInitialized);
    }

---

The documentation for this class was generated from the following files:

• third_party/skia/include/gpu/gl/GrGLExtensions.h
• third_party/skia/src/gpu/ganesh/gl/GrGLExtensions.cpp