#include <GrContextFactory.h>

Inheritance diagram for sk_gpu_test::GrContextFactory:

Public Types
enum class	ContextOverrides { kNone = 0x0 , kAvoidStencilBuffers = 0x1 , kFakeGLESVersionAs2 = 0x2 , kReducedShaders = 0x4 }

using	ContextType = skgpu::ContextType

Public Member Functions
	GrContextFactory (const GrContextOptions &opts)

	GrContextFactory ()

	~GrContextFactory ()

void	destroyContexts ()

void	abandonContexts ()

void	releaseResourcesAndAbandonContexts ()

ContextInfo	getContextInfo (ContextType type, ContextOverrides=ContextOverrides::kNone)

ContextInfo	getSharedContextInfo (GrDirectContext *shareContext, uint32_t shareIndex=0)

GrDirectContext *	get (ContextType type, ContextOverrides overrides=ContextOverrides::kNone)

const GrContextOptions &	getGlobalOptions () const

Detailed Description

This is a simple class that is useful in test apps that use different GrContexts backed by different types of GL contexts. It manages creating the GL context and a GrContext that uses it. The GL/Gr contexts persist until the factory is destroyed (though the caller can always grab a ref on the returned Gr and GL contexts to make them outlive the factory).

Definition at line 34 of file GrContextFactory.h.

Member Typedef Documentation

◆ ContextType

using sk_gpu_test::GrContextFactory::ContextType = skgpu::ContextType

Definition at line 36 of file GrContextFactory.h.

Member Enumeration Documentation

◆ ContextOverrides

enum class sk_gpu_test::GrContextFactory::ContextOverrides

strong

Overrides for the initial GrContextOptions provided at construction time, and required features that will cause context creation to fail if not present.

Enumerator
kNone
kAvoidStencilBuffers
kFakeGLESVersionAs2
kReducedShaders

Definition at line 42 of file GrContextFactory.h.

                                {
        kNone                          = 0x0,
        kAvoidStencilBuffers           = 0x1,
        kFakeGLESVersionAs2            = 0x2,
        kReducedShaders                = 0x4,
    };

Constructor & Destructor Documentation

◆ GrContextFactory() [1/2]

sk_gpu_test::GrContextFactory::GrContextFactory ( const GrContextOptions & opts )

explicit

Definition at line 50 of file GrContextFactory.cpp.

51 : fGlobalOptions(opts) {}

◆ GrContextFactory() [2/2]

sk_gpu_test::GrContextFactory::GrContextFactory ( )

Definition at line 48 of file GrContextFactory.cpp.

48{}

◆ ~GrContextFactory()

sk_gpu_test::GrContextFactory::~GrContextFactory ( )

Definition at line 53 of file GrContextFactory.cpp.

                                    {
    this->destroyContexts();
}

Member Function Documentation

◆ abandonContexts()

void sk_gpu_test::GrContextFactory::abandonContexts ( )

Definition at line 78 of file GrContextFactory.cpp.

                                       {
    // We must abandon the test contexts in reverse order so that any child context is finished and
    // abandoned before a parent context. This relies on the fact that when we make a new context we
    // append it to the end of fContexts array.
    // TODO: Look into keeping a dependency dag for contexts and deletion order
    for (int i = fContexts.size() - 1; i >= 0; --i) {
        Context& context = fContexts[i];
        if (!context.fAbandoned) {
            if (context.fTestContext) {
                auto restore = context.fTestContext->makeCurrentAndAutoRestore();
                context.fTestContext->testAbandon();
            }
            GrBackendApi api = context.fGrContext->backend();
            bool requiresEarlyAbandon = api == GrBackendApi::kVulkan;
            if (requiresEarlyAbandon) {
                context.fGrContext->abandonContext();
            }
            if (context.fTestContext) {
                delete(context.fTestContext);
                context.fTestContext = nullptr;
            }
            if (!requiresEarlyAbandon) {
                context.fGrContext->abandonContext();
            }
            context.fAbandoned = true;
        }
    }
}

◆ destroyContexts()

void sk_gpu_test::GrContextFactory::destroyContexts ( )

Definition at line 57 of file GrContextFactory.cpp.

                                       {
    // We must delete the test contexts in reverse order so that any child context is finished and
    // deleted before a parent context. This relies on the fact that when we make a new context we
    // append it to the end of fContexts array.
    // TODO: Look into keeping a dependency dag for contexts and deletion order
    for (int i = fContexts.size() - 1; i >= 0; --i) {
        Context& context = fContexts[i];
        SkScopeExit restore(nullptr);
        if (context.fTestContext) {
            restore = context.fTestContext->makeCurrentAndAutoRestore();
        }
        if (!context.fGrContext->unique()) {
            context.fGrContext->releaseResourcesAndAbandonContext();
            context.fAbandoned = true;
        }
        context.fGrContext->unref();
        delete context.fTestContext;
    }
    fContexts.clear();
}

◆ get()

GrDirectContext * sk_gpu_test::GrContextFactory::get	(	ContextType	type,
		ContextOverrides	overrides = `ContextOverrides::kNone`
	)

Get a GrContext initialized with a type of GL context. It also makes the GL context current.

Definition at line 129 of file GrContextFactory.cpp.

                                                                                   {
    return this->getContextInfo(type, overrides).directContext();
}

◆ getContextInfo()

ContextInfo sk_gpu_test::GrContextFactory::getContextInfo	(	ContextType	type,
		ContextOverrides	overrides = `ContextOverrides::kNone`
	)

Get a context initialized with a type of GL context. It also makes the GL context current.

Definition at line 332 of file GrContextFactory.cpp.

                                                                                         {
    return this->getContextInfoInternal(type, overrides, nullptr, 0);
}

◆ getGlobalOptions()

const GrContextOptions & sk_gpu_test::GrContextFactory::getGlobalOptions ( ) const

inline

Definition at line 74 of file GrContextFactory.h.

74{ return fGlobalOptions; }

◆ getSharedContextInfo()

ContextInfo sk_gpu_test::GrContextFactory::getSharedContextInfo	(	GrDirectContext *	shareContext,
		uint32_t	shareIndex = `0`
	)

Get a context in the same share group as the passed in GrContext, with the same type and overrides. To get multiple contexts in a single share group, pass the same shareContext, with different values for shareIndex.

Definition at line 336 of file GrContextFactory.cpp.

                                                                        {
    SkASSERT(shareContext);
    for (int i = 0; i < fContexts.size(); ++i) {
        if (!fContexts[i].fAbandoned && fContexts[i].fGrContext == shareContext) {
            return this->getContextInfoInternal(fContexts[i].fType, fContexts[i].fOverrides,
                                                shareContext, shareIndex);
        }
    }
 
    return ContextInfo();
}

◆ releaseResourcesAndAbandonContexts()

void sk_gpu_test::GrContextFactory::releaseResourcesAndAbandonContexts ( )

Definition at line 107 of file GrContextFactory.cpp.

                                                          {
    // We must abandon the test contexts in reverse order so that any child context is finished and
    // abandoned before a parent context. This relies on the fact that when we make a new context we
    // append it to the end of fContexts array.
    // TODO: Look into keeping a dependency dag for contexts and deletion order
    for (int i = fContexts.size() - 1; i >= 0; --i) {
        Context& context = fContexts[i];
        SkScopeExit restore(nullptr);
        if (!context.fAbandoned) {
            if (context.fTestContext) {
                restore = context.fTestContext->makeCurrentAndAutoRestore();
            }
            context.fGrContext->releaseResourcesAndAbandonContext();
            if (context.fTestContext) {
                delete context.fTestContext;
                context.fTestContext = nullptr;
            }
            context.fAbandoned = true;
        }
    }
}

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

third_party/skia/tools/gpu/GrContextFactory.h
third_party/skia/tools/gpu/GrContextFactory.cpp

Public Types

Public Member Functions