#include <GrGLTexture.h>

Inheritance diagram for GrGLTexture:

Classes
struct	Desc

Public Member Functions
	GrGLTexture (GrGLGpu *, skgpu::Budgeted, const Desc &, GrMipmapStatus, std::string_view label)

	~GrGLTexture () override

GrBackendTexture	getBackendTexture () const override

GrBackendFormat	backendFormat () const override

void	textureParamsModified () override

GrGLTextureParameters *	parameters ()

GrGLuint	textureID () const

GrGLenum	target () const

GrGLFormat	format () const

bool	hasBaseLevelBeenBoundToFBO () const

void	baseLevelWasBoundToFBO ()

void	dumpMemoryStatistics (SkTraceMemoryDump *traceMemoryDump) const override

Public Member Functions inherited from GrTexture
GrTexture *	asTexture () override

const GrTexture *	asTexture () const override

GrTextureType	textureType () const

bool	hasRestrictedSampling () const

void	markMipmapsDirty ()

void	markMipmapsClean ()

skgpu::Mipmapped	mipmapped () const

bool	mipmapsAreDirty () const

GrMipmapStatus	mipmapStatus () const

int	maxMipmapLevel () const

Public Member Functions inherited from GrSurface
SkISize	dimensions () const

int	width () const

int	height () const

SkRect	getBoundsRect () const

void	setRelease (sk_sp< skgpu::RefCntedCallback > releaseHelper)

void	setRelease (ReleaseProc proc, ReleaseCtx ctx)

virtual GrRenderTarget *	asRenderTarget ()

virtual const GrRenderTarget *	asRenderTarget () const

GrInternalSurfaceFlags	flags () const

bool	readOnly () const

bool	framebufferOnly () const

bool	isProtected () const

void	setFramebufferOnly ()

Public Member Functions inherited from GrGpuResource
bool	wasDestroyed () const

const GrDirectContext *	getContext () const

GrDirectContext *	getContext ()

size_t	gpuMemorySize () const

UniqueID	uniqueID () const

const skgpu::UniqueKey &	getUniqueKey () const

std::string	getLabel () const

void	setLabel (std::string_view label)

CacheAccess	cacheAccess ()

const CacheAccess	cacheAccess () const

ProxyAccess	proxyAccess ()

ResourcePriv	resourcePriv ()

const ResourcePriv	resourcePriv () const

Public Member Functions inherited from GrIORef< GrGpuResource >
bool	unique () const

void	ref () const

void	unref () const

void	refCommandBuffer () const

void	unrefCommandBuffer () const

Public Member Functions inherited from SkNoncopyable
	SkNoncopyable ()=default

	SkNoncopyable (SkNoncopyable &&)=default

SkNoncopyable &	operator= (SkNoncopyable &&)=default

Static Public Member Functions
static GrTextureType	TextureTypeFromTarget (GrGLenum textureTarget)

static sk_sp< GrGLTexture >	MakeWrapped (GrGLGpu *, GrMipmapStatus, const Desc &, sk_sp< GrGLTextureParameters >, GrWrapCacheable, GrIOType, std::string_view label)

Static Public Member Functions inherited from GrTexture
static bool	StealBackendTexture (sk_sp< GrTexture >, GrBackendTexture , SkImages::BackendTextureReleaseProc )

static void	ComputeScratchKey (const GrCaps &caps, const GrBackendFormat &format, SkISize dimensions, GrRenderable, int sampleCnt, skgpu::Mipmapped, GrProtected, skgpu::ScratchKey *key)

Static Public Member Functions inherited from GrSurface
static size_t	ComputeSize (const GrBackendFormat &, SkISize dimensions, int colorSamplesPerPixel, skgpu::Mipmapped, bool binSize=false)

Static Public Member Functions inherited from GrGpuResource
static uint32_t	CreateUniqueID ()

Protected Member Functions
	GrGLTexture (GrGLGpu *, const Desc &, sk_sp< GrGLTextureParameters >, GrMipmapStatus, std::string_view label)

	GrGLTexture (GrGLGpu *, const Desc &, GrMipmapStatus, sk_sp< GrGLTextureParameters >, GrWrapCacheable, GrIOType, std::string_view label)

void	init (const Desc &)

void	onAbandon () override

void	onRelease () override

bool	onStealBackendTexture (GrBackendTexture , SkImages::BackendTextureReleaseProc ) override

void	onSetLabel () override

Protected Member Functions inherited from GrTexture
	GrTexture (GrGpu *, const SkISize &, GrProtected, GrTextureType, GrMipmapStatus, std::string_view label)

void	computeScratchKey (skgpu::ScratchKey *) const override

Protected Member Functions inherited from GrSurface
void	setGLRTFBOIDIs0 ()

bool	glRTFBOIDis0 () const

void	setRequiresManualMSAAResolve ()

bool	requiresManualMSAAResolve () const

void	setReadOnly ()

void	setVkRTSupportsInputAttachment ()

	GrSurface (GrGpu *gpu, const SkISize &dimensions, skgpu::Protected isProtected, std::string_view label)

	~GrSurface () override

void	onRelease () override

void	onAbandon () override

Protected Member Functions inherited from GrGpuResource
void	registerWithCache (skgpu::Budgeted)

void	registerWithCacheWrapped (GrWrapCacheable)

	GrGpuResource (GrGpu *, std::string_view label)

virtual	~GrGpuResource ()

GrGpu *	getGpu () const

virtual void	setMemoryBacking (SkTraceMemoryDump *, const SkString &) const

SkString	getResourceName () const

void	dumpMemoryStatisticsPriv (SkTraceMemoryDump traceMemoryDump, const SkString &resourceName, const char type, size_t size) const

Protected Member Functions inherited from GrIORef< GrGpuResource >
	GrIORef ()

bool	internalHasRef () const

bool	internalHasNoCommandBufferUsages () const

void	addInitialRef () const

Additional Inherited Members
Public Types inherited from GrSurface
typedef void *	ReleaseCtx

typedef void(*	ReleaseProc) (ReleaseCtx)

Public Types inherited from GrIORef< GrGpuResource >
enum	LastRemovedRef

Detailed Description

Definition at line 20 of file GrGLTexture.h.

Constructor & Destructor Documentation

◆ GrGLTexture() [1/3]

GrGLTexture::GrGLTexture	(	GrGLGpu *	gpu,
		skgpu::Budgeted	budgeted,
		const Desc &	desc,
		GrMipmapStatus	mipmapStatus,
		std::string_view	label
	)

Definition at line 50 of file GrGLTexture.cpp.

        : GrSurface(gpu, desc.fSize, desc.fIsProtected, label)
        , GrTexture(gpu,
                    desc.fSize,
                    desc.fIsProtected,
                    TextureTypeFromTarget(desc.fTarget),
                    mipmapStatus,
                    label)
        , fParameters(sk_make_sp<GrGLTextureParameters>()) {
    this->init(desc);
    this->registerWithCache(budgeted);
    if (GrGLFormatIsCompressed(desc.fFormat)) {
        this->setReadOnly();
    }
}

◆ ~GrGLTexture()

GrGLTexture::~GrGLTexture ( )

inlineoverride

Definition at line 35 of file GrGLTexture.h.

35{}

◆ GrGLTexture() [2/3]

GrGLTexture::GrGLTexture	(	GrGLGpu *	gpu,
		const Desc &	desc,
		sk_sp< GrGLTextureParameters >	parameters,
		GrMipmapStatus	mipmapStatus,
		std::string_view	label
	)

protected

Definition at line 89 of file GrGLTexture.cpp.

        : GrSurface(gpu, desc.fSize, desc.fIsProtected, label)
        , GrTexture(gpu,
                    desc.fSize,
                    desc.fIsProtected,
                    TextureTypeFromTarget(desc.fTarget),
                    mipmapStatus,
                    label) {
    SkASSERT(parameters || desc.fOwnership == GrBackendObjectOwnership::kOwned);
    fParameters = parameters ? std::move(parameters) : sk_make_sp<GrGLTextureParameters>();
    this->init(desc);
}

◆ GrGLTexture() [3/3]

GrGLTexture::GrGLTexture	(	GrGLGpu *	gpu,
		const Desc &	desc,
		GrMipmapStatus	mipmapStatus,
		sk_sp< GrGLTextureParameters >	parameters,
		GrWrapCacheable	cacheable,
		GrIOType	ioType,
		std::string_view	label
	)

protected

Definition at line 70 of file GrGLTexture.cpp.

        : GrSurface(gpu, desc.fSize, desc.fIsProtected, label)
        , GrTexture(gpu,
                    desc.fSize,
                    desc.fIsProtected,
                    TextureTypeFromTarget(desc.fTarget),
                    mipmapStatus,
                    label)
        , fParameters(std::move(parameters)) {
    SkASSERT(fParameters);
    this->init(desc);
    this->registerWithCacheWrapped(cacheable);
    if (ioType == kRead_GrIOType) {
        this->setReadOnly();
    }
}

Member Function Documentation

◆ backendFormat()

GrBackendFormat GrGLTexture::backendFormat ( ) const

overridevirtual

Implements GrSurface.

Reimplemented in GrGLTextureRenderTarget.

Definition at line 145 of file GrGLTexture.cpp.

                                                 {
    return GrBackendFormats::MakeGL(GrGLFormatToEnum(fFormat),
                                    target_from_texture_type(this->textureType()));
}

◆ baseLevelWasBoundToFBO()

void GrGLTexture::baseLevelWasBoundToFBO ( )

inline

Definition at line 53 of file GrGLTexture.h.

53{ fBaseLevelHasBeenBoundToFBO = true; }

◆ dumpMemoryStatistics()

void GrGLTexture::dumpMemoryStatistics ( SkTraceMemoryDump * traceMemoryDump ) const

overridevirtual

Dumps memory usage information for this GrGpuResource to traceMemoryDump. Typically, subclasses should not need to override this, and should only need to override setMemoryBacking.

Reimplemented from GrGpuResource.

Reimplemented in GrGLTextureRenderTarget.

Definition at line 186 of file GrGLTexture.cpp.

                                                                               {
    // Don't check this->fRefsWrappedObjects, as we might be the base of a GrGLTextureRenderTarget
    // which is multiply inherited from both ourselves and a texture. In these cases, one part
    // (texture, rt) may be wrapped, while the other is owned by Skia.
    bool refsWrappedTextureObjects =
            this->fTextureIDOwnership == GrBackendObjectOwnership::kBorrowed;
    if (refsWrappedTextureObjects && !traceMemoryDump->shouldDumpWrappedObjects()) {
        return;
    }
 
    size_t size = GrSurface::ComputeSize(this->backendFormat(), this->dimensions(), 1,
                                         this->mipmapped());
 
    // Dump as skia/gpu_resources/resource_#/texture, to avoid conflicts in the
    // GrGLTextureRenderTarget case, where multiple things may dump to the same resource. This
    // has no downside in the normal case.
    SkString resourceName = this->getResourceName();
    resourceName.append("/texture");
 
    // As we are only dumping our texture memory (not any additional memory tracked by classes
    // which may inherit from us), specifically call GrGLTexture::gpuMemorySize to avoid
    // hitting an override.
    this->dumpMemoryStatisticsPriv(traceMemoryDump, resourceName, "Texture", size);
 
    SkString texture_id;
    texture_id.appendU32(this->textureID());
    traceMemoryDump->setMemoryBacking(resourceName.c_str(), "gl_texture", texture_id.c_str());
}

◆ format()

GrGLFormat GrGLTexture::format ( ) const

inline

Definition at line 50 of file GrGLTexture.h.

50{ return fFormat; }

◆ getBackendTexture()

GrBackendTexture GrGLTexture::getBackendTexture ( ) const

overridevirtual

Implements GrTexture.

Definition at line 134 of file GrGLTexture.cpp.

                                                      {
    GrGLTextureInfo info;
    info.fTarget = target_from_texture_type(this->textureType());
    info.fID = fID;
    info.fFormat = GrGLFormatToEnum(fFormat);
    info.fProtected = skgpu::Protected(this->isProtected());
 
    return GrBackendTextures::MakeGL(
            this->width(), this->height(), this->mipmapped(), info, fParameters);
}

◆ hasBaseLevelBeenBoundToFBO()

bool GrGLTexture::hasBaseLevelBeenBoundToFBO ( ) const

inline

Definition at line 52 of file GrGLTexture.h.

52{ return fBaseLevelHasBeenBoundToFBO; }

◆ init()

void GrGLTexture::init ( const Desc & desc )

protected

Definition at line 106 of file GrGLTexture.cpp.

                                       {
    SkASSERT(0 != desc.fID);
    SkASSERT(GrGLFormat::kUnknown != desc.fFormat);
    fID = desc.fID;
    fFormat = desc.fFormat;
    fTextureIDOwnership = desc.fOwnership;
}

◆ MakeWrapped()

sk_sp< GrGLTexture > GrGLTexture::MakeWrapped	(	GrGLGpu *	gpu,
		GrMipmapStatus	mipmapStatus,
		const Desc &	desc,
		sk_sp< GrGLTextureParameters >	parameters,
		GrWrapCacheable	cacheable,
		GrIOType	ioType,
		std::string_view	label
	)

static

Definition at line 150 of file GrGLTexture.cpp.

                                                                  {
    return sk_sp<GrGLTexture>(new GrGLTexture(
            gpu, desc, mipmapStatus, std::move(parameters), cacheable, ioType, label));
}

◆ onAbandon()

void GrGLTexture::onAbandon ( )

overrideprotectedvirtual

Overridden to abandon any internal handles, ptrs, etc to backend API resources. This may be called when the underlying 3D context is no longer valid and so no backend API calls should be made.

Reimplemented from GrGpuResource.

Reimplemented in GrGLTextureRenderTarget.

Definition at line 129 of file GrGLTexture.cpp.

                            {
    fID = 0;
    INHERITED::onAbandon();
}

◆ onRelease()

void GrGLTexture::onRelease ( )

overrideprotectedvirtual

Overridden to free GPU resources in the backend API.

Reimplemented from GrGpuResource.

Reimplemented in GrGLTextureRenderTarget.

Definition at line 116 of file GrGLTexture.cpp.

                            {
    TRACE_EVENT0("skia.gpu", TRACE_FUNC);
    ATRACE_ANDROID_FRAMEWORK_ALWAYS("Texture release(%u)", this->uniqueID().asUInt());
 
    if (fID) {
        if (GrBackendObjectOwnership::kBorrowed != fTextureIDOwnership) {
            GL_CALL(DeleteTextures(1, &fID));
        }
        fID = 0;
    }
    INHERITED::onRelease();
}

◆ onSetLabel()

void GrGLTexture::onSetLabel ( )

overrideprotectedvirtual

Implements GrGpuResource.

Reimplemented in GrGLTextureRenderTarget.

Definition at line 174 of file GrGLTexture.cpp.

                             {
    SkASSERT(fID);
    SkASSERT(fTextureIDOwnership == GrBackendObjectOwnership::kOwned);
    if (!this->getLabel().empty()) {
        const std::string label = "_Skia_" + this->getLabel();
        GrGLGpu* glGpu = static_cast<GrGLGpu*>(this->getGpu());
        if (glGpu->glCaps().debugSupport()) {
            GR_GL_CALL(glGpu->glInterface(), ObjectLabel(GR_GL_TEXTURE, fID, -1, label.c_str()));
        }
    }
}

◆ onStealBackendTexture()

bool GrGLTexture::onStealBackendTexture	(	GrBackendTexture *	backendTexture,
		SkImages::BackendTextureReleaseProc *	releaseProc
	)

overrideprotectedvirtual

Implements GrTexture.

Definition at line 161 of file GrGLTexture.cpp.

                                                                                        {
    *backendTexture = this->getBackendTexture();
    // Set the release proc to a no-op function. GL doesn't require any special cleanup.
    *releaseProc = [](GrBackendTexture){};
 
    // It's important that we only abandon this texture's objects, not subclass objects such as
    // those held by GrGLTextureRenderTarget. Those objects are not being stolen and need to be
    // cleaned up by us.
    this->GrGLTexture::onAbandon();
    return true;
}

◆ parameters()

GrGLTextureParameters * GrGLTexture::parameters ( )

inline

Definition at line 44 of file GrGLTexture.h.

44{ return fParameters.get(); }

sk_sp::get

T * get() const

Definition SkRefCnt.h:303

◆ target()

GrGLenum GrGLTexture::target ( ) const

Definition at line 114 of file GrGLTexture.cpp.

114{ return target_from_texture_type(this->textureType()); }

◆ textureID()

GrGLuint GrGLTexture::textureID ( ) const

inline

Definition at line 46 of file GrGLTexture.h.

46{ return fID; }

◆ textureParamsModified()

void GrGLTexture::textureParamsModified ( )

inlineoverridevirtual

This function indicates that the texture parameters (wrap mode, filtering, ...) have been changed externally to Skia.

Implements GrTexture.

Definition at line 42 of file GrGLTexture.h.

42{ fParameters->invalidate(); }

GrGLTextureParameters::invalidate

void invalidate()

Definition GrGLTypesPriv.cpp:45

◆ TextureTypeFromTarget()

GrTextureType GrGLTexture::TextureTypeFromTarget ( GrGLenum textureTarget )

static

Definition at line 23 of file GrGLTexture.cpp.

                                                                {
    switch (target) {
        case GR_GL_TEXTURE_2D:
            return GrTextureType::k2D;
        case GR_GL_TEXTURE_RECTANGLE:
            return GrTextureType::kRectangle;
        case GR_GL_TEXTURE_EXTERNAL:
            return GrTextureType::kExternal;
    }
    SK_ABORT("Unexpected texture target");
}

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

third_party/skia/src/gpu/ganesh/gl/GrGLTexture.h
third_party/skia/src/gpu/ganesh/gl/GrGLTexture.cpp

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ GrGLTexture() [1/3]

◆ ~GrGLTexture()

◆ GrGLTexture() [2/3]

◆ GrGLTexture() [3/3]

Member Function Documentation

◆ backendFormat()

◆ baseLevelWasBoundToFBO()

◆ dumpMemoryStatistics()

◆ format()

◆ getBackendTexture()

◆ hasBaseLevelBeenBoundToFBO()

◆ init()

◆ MakeWrapped()

◆ onAbandon()

◆ onRelease()

◆ onSetLabel()

◆ onStealBackendTexture()

◆ parameters()

◆ target()

◆ textureID()

◆ textureParamsModified()

◆ TextureTypeFromTarget()