#include <GrMtlTexture.h>

Inheritance diagram for GrMtlTexture:

Public Member Functions
	~GrMtlTexture () override

GrMtlAttachment *	attachment () const

id< MTLTexture >	mtlTexture () const

GrBackendTexture	getBackendTexture () const override

GrBackendFormat	backendFormat () const override

void	textureParamsModified () override

bool	reallocForMipmap (GrMtlGpu *gpu, uint32_t mipLevels)

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

const GrTexture *	asTexture () const override

virtual GrBackendTexture	getBackendTexture () const =0

virtual void	textureParamsModified ()=0

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

virtual GrBackendFormat	backendFormat () const =0

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

void	setRelease (ReleaseProc proc, ReleaseCtx ctx)

virtual GrTexture *	asTexture ()

virtual const GrTexture *	asTexture () const

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

virtual void	dumpMemoryStatistics (SkTraceMemoryDump *traceMemoryDump) const

virtual const char *	getResourceType () const =0

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 sk_sp< GrMtlTexture >	MakeNewTexture (GrMtlGpu *, skgpu::Budgeted budgeted, SkISize dimensions, MTLPixelFormat format, uint32_t mipLevels, GrMipmapStatus, std::string_view label)

static sk_sp< GrMtlTexture >	MakeWrappedTexture (GrMtlGpu *, SkISize, id< MTLTexture >, GrWrapCacheable, GrIOType)

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
	GrMtlTexture (GrMtlGpu *, SkISize, sk_sp< GrMtlAttachment >, GrMipmapStatus, std::string_view label)

GrMtlGpu *	getMtlGpu () const

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)

virtual bool	onStealBackendTexture (GrBackendTexture , SkImages::BackendTextureReleaseProc )=0

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	onRelease ()

virtual void	onAbandon ()

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 18 of file GrMtlTexture.h.

Constructor & Destructor Documentation

◆ ~GrMtlTexture()

GrMtlTexture::~GrMtlTexture ( )

override

Definition at line 122 of file GrMtlTexture.mm.

                            {
    SkASSERT(nil == fTexture);
}

◆ GrMtlTexture()

GrMtlTexture::GrMtlTexture	(	GrMtlGpu *	gpu,
		SkISize	dimensions,
		sk_sp< GrMtlAttachment >	texture,
		GrMipmapStatus	mipmapStatus,
		std::string_view	label
	)

protected

Definition at line 65 of file GrMtlTexture.mm.

        : GrSurface(gpu, dimensions, GrProtected::kNo, label)
        , INHERITED(gpu, dimensions, GrProtected::kNo, GrTextureType::k2D, mipmapStatus, label)
        , fTexture(std::move(texture)) {
    SkDEBUGCODE(id<MTLTexture> mtlTexture = fTexture->mtlTexture();)
    SkASSERT((GrMipmapStatus::kNotAllocated == mipmapStatus) == (1 == mtlTexture.mipmapLevelCount));
    if (@available(macOS 10.11, iOS 9.0, tvOS 9.0, *)) {
        SkASSERT(SkToBool(mtlTexture.usage & MTLTextureUsageShaderRead));
    }
    SkASSERT(!mtlTexture.framebufferOnly);
}

Member Function Documentation

◆ attachment()

GrMtlAttachment * GrMtlTexture::attachment ( ) const

inline

Definition at line 36 of file GrMtlTexture.h.

36{ return fTexture.get(); }

sk_sp::get

T * get() const

Definition: SkRefCnt.h:303

◆ backendFormat()

GrBackendFormat GrMtlTexture::backendFormat ( ) const

overridevirtual

Implements GrSurface.

Reimplemented in GrMtlTextureRenderTarget.

Definition at line 140 of file GrMtlTexture.mm.

                                                  {
    return GrBackendFormats::MakeMtl(fTexture->mtlFormat());
}

◆ getBackendTexture()

GrBackendTexture GrMtlTexture::getBackendTexture ( ) const

overridevirtual

Implements GrTexture.

Definition at line 131 of file GrMtlTexture.mm.

                                                       {
    skgpu::Mipmapped mipmapped = fTexture->mtlTexture().mipmapLevelCount > 1
                                         ? skgpu::Mipmapped::kYes
                                         : skgpu::Mipmapped::kNo;
    GrMtlTextureInfo info;
    info.fTexture.reset(GrRetainPtrFromId(fTexture->mtlTexture()));
    return GrBackendTextures::MakeMtl(this->width(), this->height(), mipmapped, info);
}

◆ getMtlGpu()

GrMtlGpu * GrMtlTexture::getMtlGpu ( ) const

protected

Definition at line 126 of file GrMtlTexture.mm.

                                        {
    SkASSERT(!this->wasDestroyed());
    return static_cast<GrMtlGpu*>(this->getGpu());
}

◆ MakeNewTexture()

sk_sp< GrMtlTexture > GrMtlTexture::MakeNewTexture	(	GrMtlGpu *	gpu,
		skgpu::Budgeted	budgeted,
		SkISize	dimensions,
		MTLPixelFormat	format,
		uint32_t	mipLevels,
		GrMipmapStatus	mipmapStatus,
		std::string_view	label
	)

static

Definition at line 81 of file GrMtlTexture.mm.

                                                                       {
    sk_sp<GrMtlAttachment> texture = GrMtlAttachment::MakeTexture(
            gpu, dimensions, format, mipLevels, GrRenderable::kNo, /*numSamples=*/1, budgeted);
 
    if (!texture) {
        return nullptr;
    }
    return sk_sp<GrMtlTexture>(new GrMtlTexture(gpu, budgeted, dimensions, std::move(texture),
                                                mipmapStatus, label));
}

◆ MakeWrappedTexture()

sk_sp< GrMtlTexture > GrMtlTexture::MakeWrappedTexture	(	GrMtlGpu *	gpu,
		SkISize	dimensions,
		id< MTLTexture >	texture,
		GrWrapCacheable	cacheable,
		GrIOType	ioType
	)

static

Definition at line 98 of file GrMtlTexture.mm.

                                                                      {
    SkASSERT(nil != texture);
    if (@available(macOS 10.11, iOS 9.0, tvOS 9.0, *)) {
        SkASSERT(SkToBool(texture.usage & MTLTextureUsageShaderRead));
    }
    sk_sp<GrMtlAttachment> attachment =
            GrMtlAttachment::MakeWrapped(gpu, dimensions, texture,
                                         GrAttachment::UsageFlags::kTexture, cacheable,
                                         /*label=*/"MtlAttachment_MakeWrapped");
    if (!attachment) {
        return nullptr;
    }
 
    GrMipmapStatus mipmapStatus = texture.mipmapLevelCount > 1 ? GrMipmapStatus::kValid
                                                               : GrMipmapStatus::kNotAllocated;
    return sk_sp<GrMtlTexture>(
            new GrMtlTexture(gpu, kWrapped, dimensions, std::move(attachment), mipmapStatus,
                             cacheable, ioType, /*label=*/"MtlTextureWrappedTexture"));
}

◆ mtlTexture()

id< MTLTexture > GrMtlTexture::mtlTexture ( ) const

inline

Definition at line 37 of file GrMtlTexture.h.

37{ return fTexture->mtlTexture(); }

◆ onAbandon()

void GrMtlTexture::onAbandon ( )

inlineoverrideprotectedvirtual

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 GrSurface.

Reimplemented in GrMtlTextureRenderTarget.

Definition at line 56 of file GrMtlTexture.h.

                              {
        fTexture = nil;
        INHERITED::onAbandon();
    }

◆ onRelease()

void GrMtlTexture::onRelease ( )

inlineoverrideprotectedvirtual

Overridden to free GPU resources in the backend API.

Reimplemented from GrSurface.

Reimplemented in GrMtlTextureRenderTarget.

Definition at line 60 of file GrMtlTexture.h.

                              {
        fTexture = nil;
        INHERITED::onRelease();
    }

◆ onSetLabel()

void GrMtlTexture::onSetLabel ( )

overrideprotectedvirtual

Implements GrGpuResource.

Definition at line 144 of file GrMtlTexture.mm.

                              {
    SkASSERT(fTexture);
    if (!this->getLabel().empty()) {
        NSString* labelStr = @(this->getLabel().c_str());
        fTexture->mtlTexture().label = [@"_Skia_" stringByAppendingString:labelStr];
    }
}

◆ onStealBackendTexture()

bool GrMtlTexture::onStealBackendTexture	(	GrBackendTexture *	,
		SkImages::BackendTextureReleaseProc *
	)

inlineoverrideprotectedvirtual

Implements GrTexture.

Definition at line 65 of file GrMtlTexture.h.

                                                                                               {
        return false;
    }

◆ reallocForMipmap()

bool GrMtlTexture::reallocForMipmap	(	GrMtlGpu *	gpu,
		uint32_t	mipLevels
	)

◆ textureParamsModified()

void GrMtlTexture::textureParamsModified ( )

inlineoverridevirtual

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

Implements GrTexture.

Definition at line 43 of file GrMtlTexture.h.

43{}

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

third_party/skia/src/gpu/ganesh/mtl/GrMtlTexture.h
third_party/skia/src/gpu/ganesh/mtl/GrMtlTexture.mm

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~GrMtlTexture()

◆ GrMtlTexture()

Member Function Documentation

◆ attachment()

◆ backendFormat()

◆ getBackendTexture()

◆ getMtlGpu()

◆ MakeNewTexture()

◆ MakeWrappedTexture()

◆ mtlTexture()

◆ onAbandon()

◆ onRelease()

◆ onSetLabel()

◆ onStealBackendTexture()

◆ reallocForMipmap()

◆ textureParamsModified()