#include <GrMtlTextureRenderTarget.h>

Inheritance diagram for GrMtlTextureRenderTarget:

Public Member Functions
GrBackendFormat	backendFormat () const override

Public Member Functions inherited from GrMtlTexture
	~GrMtlTexture () override

GrMtlAttachment *	attachment () const

id< MTLTexture >	mtlTexture () const

GrBackendTexture	getBackendTexture () 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

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)

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

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

Public Member Functions inherited from GrMtlRenderTarget
	~GrMtlRenderTarget () override

bool	canAttemptStencilAttachment (bool useMSAASurface) const override

GrMtlAttachment *	colorAttachment () const

id< MTLTexture >	colorMTLTexture () const

GrMtlAttachment *	resolveAttachment () const

id< MTLTexture >	resolveMTLTexture () const

GrMtlAttachment *	nonMSAAAttachment () const

GrBackendRenderTarget	getBackendRenderTarget () const override

const GrMtlFramebuffer *	getFramebuffer (bool withResolve, bool withStencil)

Public Member Functions inherited from GrRenderTarget
virtual bool	alwaysClearStencil () const

GrRenderTarget *	asRenderTarget () override

const GrRenderTarget *	asRenderTarget () const override

int	numSamples () const

GrAttachment *	getStencilAttachment (bool useMSAASurface) const

GrAttachment *	getStencilAttachment () const

void	attachStencilAttachment (sk_sp< GrAttachment > stencil, bool useMSAASurface)

int	numStencilBits (bool useMSAASurface) const

int	getSamplePatternKey ()

const skia_private::TArray< SkPoint > &	getSampleLocations ()

void	setRequiresManualMSAAResolve ()

bool	requiresManualMSAAResolve () const

Static Public Member Functions
static sk_sp< GrMtlTextureRenderTarget >	MakeNewTextureRenderTarget (GrMtlGpu *, skgpu::Budgeted, SkISize, int sampleCnt, MTLPixelFormat, uint32_t mipLevels, GrMipmapStatus, std::string_view label)

static sk_sp< GrMtlTextureRenderTarget >	MakeWrappedTextureRenderTarget (GrMtlGpu *, SkISize, int sampleCnt, id< MTLTexture >, GrWrapCacheable)

Static Public Member Functions inherited from GrMtlTexture
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 ()

Static Public Member Functions inherited from GrMtlRenderTarget
static sk_sp< GrMtlRenderTarget >	MakeWrappedRenderTarget (GrMtlGpu *, SkISize, int sampleCnt, id< MTLTexture >)

Protected Member Functions
void	onAbandon () override

void	onRelease () override

Protected Member Functions inherited from GrMtlTexture
	GrMtlTexture (GrMtlGpu *, SkISize, sk_sp< GrMtlAttachment >, GrMipmapStatus, std::string_view label)

GrMtlGpu *	getMtlGpu () const

bool	onStealBackendTexture (GrBackendTexture , SkImages::BackendTextureReleaseProc ) 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

Protected Member Functions inherited from GrMtlRenderTarget
	GrMtlRenderTarget (GrMtlGpu *gpu, SkISize, sk_sp< GrMtlAttachment > colorAttachment, sk_sp< GrMtlAttachment > resolveAttachment, std::string_view label)

GrMtlGpu *	getMtlGpu () const

Protected Member Functions inherited from GrRenderTarget
	GrRenderTarget (GrGpu *, const SkISize &, int sampleCount, GrProtected, std::string_view label, sk_sp< GrAttachment > stenicl=nullptr)

	~GrRenderTarget () override

void	onAbandon () override

void	onRelease () override

Private Member Functions
size_t	onGpuMemorySize () const override

void	onSetLabel () override

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

typedef void(*	ReleaseProc) (ReleaseCtx)

Public Types inherited from GrIORef< GrGpuResource >
enum	LastRemovedRef

Protected Attributes inherited from GrMtlRenderTarget
sk_sp< GrMtlAttachment >	fColorAttachment

sk_sp< GrMtlAttachment >	fResolveAttachment

Detailed Description

Definition at line 14 of file GrMtlTextureRenderTarget.h.

Member Function Documentation

◆ backendFormat()

GrBackendFormat GrMtlTextureRenderTarget::backendFormat ( ) const

inlineoverridevirtual

Reimplemented from GrMtlTexture.

Definition at line 30 of file GrMtlTextureRenderTarget.h.

                                                   {
        return GrMtlTexture::backendFormat();
    }

◆ MakeNewTextureRenderTarget()

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

static

Definition at line 74 of file GrMtlTextureRenderTarget.mm.

                              {
    sk_sp<GrMtlAttachment> textureAttachment =
            GrMtlAttachment::MakeTexture(gpu, dimensions, format, mipLevels, GrRenderable::kYes,
                                         /*numSamples=*/1, budgeted);
    if (!textureAttachment) {
        return nullptr;
    }
    if (@available(macOS 10.11, iOS 9.0, tvOS 9.0, *)) {
        SkASSERT((MTLTextureUsageShaderRead | MTLTextureUsageRenderTarget) &
                 textureAttachment->mtlTexture().usage);
    }
 
    sk_sp<GrMtlAttachment> colorAttachment;
    sk_sp<GrMtlAttachment> resolveAttachment;
    if (!create_rt_attachments(gpu, dimensions, format, sampleCnt, textureAttachment,
                               &colorAttachment, &resolveAttachment)) {
        return nullptr;
    }
    SkASSERT(colorAttachment);
    SkASSERT(sampleCnt == 1 || resolveAttachment);
 
    return sk_sp<GrMtlTextureRenderTarget>(new GrMtlTextureRenderTarget(
            gpu, budgeted, dimensions, std::move(textureAttachment), std::move(colorAttachment),
            std::move(resolveAttachment), mipmapStatus, label));
}

◆ MakeWrappedTextureRenderTarget()

sk_sp< GrMtlTextureRenderTarget > GrMtlTextureRenderTarget::MakeWrappedTextureRenderTarget	(	GrMtlGpu *	gpu,
		SkISize	dimensions,
		int	sampleCnt,
		id< MTLTexture >	texture,
		GrWrapCacheable	cacheable
	)

static

Definition at line 108 of file GrMtlTextureRenderTarget.mm.

                                   {
    SkASSERT(nil != texture);
    if (@available(macOS 10.11, iOS 9.0, tvOS 9.0, *)) {
        SkASSERT((MTLTextureUsageShaderRead | MTLTextureUsageRenderTarget) & texture.usage);
    }
    GrMipmapStatus mipmapStatus = texture.mipmapLevelCount > 1
                                            ? GrMipmapStatus::kDirty
                                            : GrMipmapStatus::kNotAllocated;
    GrAttachment::UsageFlags textureUsageFlags = GrAttachment::UsageFlags::kTexture |
                                                 GrAttachment::UsageFlags::kColorAttachment;
    sk_sp<GrMtlAttachment> textureAttachment =
            GrMtlAttachment::MakeWrapped(gpu, dimensions, texture, textureUsageFlags, cacheable,
                                         /*label=*/"MtlAttachment_TextureAttachment");
    if (!textureAttachment) {
        return nullptr;
    }
 
    sk_sp<GrMtlAttachment> colorAttachment;
    sk_sp<GrMtlAttachment> resolveAttachment;
    if (!create_rt_attachments(gpu, dimensions, texture.pixelFormat, sampleCnt, textureAttachment,
                               &colorAttachment, &resolveAttachment)) {
        return nullptr;
    }
    SkASSERT(colorAttachment);
    SkASSERT(sampleCnt == 1 || resolveAttachment);
 
    return sk_sp<GrMtlTextureRenderTarget>(new GrMtlTextureRenderTarget(
            gpu, dimensions, std::move(textureAttachment), std::move(colorAttachment),
            std::move(resolveAttachment), mipmapStatus, cacheable,
                      /*label=*/"MtlWrappedTextureRenderTarget"));
}

◆ onAbandon()

void GrMtlTextureRenderTarget::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 GrMtlTexture.

Definition at line 35 of file GrMtlTextureRenderTarget.h.

                              {
        GrMtlRenderTarget::onAbandon();
        GrMtlTexture::onAbandon();
    }

◆ onGpuMemorySize()

size_t GrMtlTextureRenderTarget::onGpuMemorySize ( ) const

overrideprivatevirtual

Implements GrGpuResource.

Definition at line 145 of file GrMtlTextureRenderTarget.mm.

                                                       {
    // The GrTexture[RenderTarget] is built up by a bunch of attachments each of which are their
    // own GrGpuResource. Ideally the GrRenderTarget would not be a GrGpuResource and the GrTexture
    // would just merge with the new GrSurface/Attachment world. Then we could just depend on each
    // attachment to give its own size since we don't have GrGpuResources owning other
    // GrGpuResources. Until we get to that point we need to live in some hybrid world. We will let
    // the msaa and stencil attachments track their own size because they do get cached separately.
    // For all GrTexture* based things we will continue to to use the GrTexture* to report size and
    // the owned attachments will have no size and be uncached.
#ifdef SK_DEBUG
    // The nonMSAA attachment (either color or resolve depending on numSamples should have size of
    // zero since it is a texture attachment.
    SkASSERT(this->nonMSAAAttachment()->gpuMemorySize() == 0);
    if (this->numSamples() > 1) {
        // Msaa attachment should have a valid size
        SkASSERT(this->colorAttachment()->gpuMemorySize() ==
                 GrSurface::ComputeSize(this->backendFormat(),
                                        this->dimensions(),
                                        this->numSamples(),
                                        skgpu::Mipmapped::kNo));
    }
#endif
    return GrSurface::ComputeSize(this->backendFormat(), this->dimensions(),
                                  1 /*colorSamplesPerPixel*/, this->mipmapped());
}

◆ onRelease()

void GrMtlTextureRenderTarget::onRelease ( )

inlineoverrideprotectedvirtual

Overridden to free GPU resources in the backend API.

Reimplemented from GrMtlTexture.

Definition at line 40 of file GrMtlTextureRenderTarget.h.

                              {
        GrMtlRenderTarget::onRelease();
        GrMtlTexture::onRelease();
    }

◆ onSetLabel()

void GrMtlTextureRenderTarget::onSetLabel ( )

overrideprivatevirtual

Reimplemented from GrMtlTexture.

Definition at line 171 of file GrMtlTextureRenderTarget.mm.

                                          {
    GrMtlRenderTarget::onSetLabel();
    GrMtlTexture::onSetLabel();
}

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

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ backendFormat()

◆ MakeNewTextureRenderTarget()

◆ MakeWrappedTextureRenderTarget()

◆ onAbandon()

◆ onGpuMemorySize()

◆ onRelease()

◆ onSetLabel()