#include <GrD3DCommandList.h>

Inheritance diagram for GrD3DCommandList:

Public Types
enum class	SubmitResult { kNoWork , kSuccess , kFailure }

Public Member Functions
virtual	~GrD3DCommandList ()

SubmitResult	submit (ID3D12CommandQueue *queue)

bool	close ()

void	reset ()

void	resourceBarrier (sk_sp< GrManagedResource > managedResource, int numBarriers, const D3D12_RESOURCE_TRANSITION_BARRIER *barriers)

void	uavBarrier (sk_sp< GrManagedResource > managedResource, ID3D12Resource *uavResource)

void	aliasingBarrier (sk_sp< GrManagedResource > beforeManagedResource, ID3D12Resource beforeResource, sk_sp< GrManagedResource > afterManagedResource, ID3D12Resource afterResource)

void	copyBufferToTexture (ID3D12Resource srcBuffer, const GrD3DTextureResource dstTexture, uint32_t subresourceCount, D3D12_PLACED_SUBRESOURCE_FOOTPRINT *bufferFootprints, int left, int top)

void	copyTextureRegionToTexture (sk_sp< GrManagedResource > dst, const D3D12_TEXTURE_COPY_LOCATION dstLocation, UINT dstX, UINT dstY, sk_sp< GrManagedResource > src, const D3D12_TEXTURE_COPY_LOCATION srcLocation, const D3D12_BOX *srcBox)

void	copyTextureRegionToBuffer (sk_sp< const GrBuffer > dst, const D3D12_TEXTURE_COPY_LOCATION dstLocation, UINT dstX, UINT dstY, sk_sp< GrManagedResource > src, const D3D12_TEXTURE_COPY_LOCATION srcLocation, const D3D12_BOX *srcBox)

void	copyTextureToTexture (const GrD3DTexture dst, const GrD3DTexture src, UINT subresourceIndex=-1)

void	copyBufferToBuffer (sk_sp< GrD3DBuffer > dstBuffer, uint64_t dstOffset, ID3D12Resource *srcBuffer, uint64_t srcOffset, uint64_t numBytes)

void	addGrBuffer (sk_sp< const GrBuffer > buffer)

void	addRecycledResource (sk_sp< GrRecycledResource > resource)

void	releaseResources ()

bool	hasWork () const

void	addFinishedCallback (sk_sp< skgpu::RefCntedCallback > callback)

Protected Types
template<typename T >
using	TrackedResourceArray = skia_private::STArray< kInitialTrackedResourcesCount, T >

Protected Member Functions
	GrD3DCommandList (gr_cp< ID3D12CommandAllocator > allocator, gr_cp< ID3D12GraphicsCommandList > commandList)

void	addResource (sk_sp< GrManagedResource > resource)

void	addingWork ()

virtual void	onReset ()

void	submitResourceBarriers ()

	SkDEBUGCODE (bool fIsActive=true;) bool fHasWork

Protected Attributes
gr_cp< ID3D12GraphicsCommandList >	fCommandList

TrackedResourceArray< sk_sp< GrManagedResource > >	fTrackedResources

TrackedResourceArray< sk_sp< GrRecycledResource > >	fTrackedRecycledResources

TrackedResourceArray< sk_sp< const GrBuffer > >	fTrackedGpuBuffers

Detailed Description

Definition at line 33 of file GrD3DCommandList.h.

Member Typedef Documentation

◆ TrackedResourceArray

template<typename T >

using GrD3DCommandList::TrackedResourceArray = skia_private::STArray<kInitialTrackedResourcesCount, T>

protected

Definition at line 138 of file GrD3DCommandList.h.

Member Enumeration Documentation

◆ SubmitResult

enum class GrD3DCommandList::SubmitResult

strong

Enumerator
kNoWork
kSuccess
kFailure

Definition at line 39 of file GrD3DCommandList.h.

                            {
        kNoWork,
        kSuccess,
        kFailure,
    };

Constructor & Destructor Documentation

◆ ~GrD3DCommandList()

virtual GrD3DCommandList::~GrD3DCommandList ( )

inlinevirtual

Definition at line 35 of file GrD3DCommandList.h.

                                {
        this->releaseResources();
    }

◆ GrD3DCommandList()

GrD3DCommandList::GrD3DCommandList	(	gr_cp< ID3D12CommandAllocator >	allocator,
		gr_cp< ID3D12GraphicsCommandList >	commandList
	)

protected

Definition at line 22 of file GrD3DCommandList.cpp.

    : fCommandList(std::move(commandList))
    , fAllocator(std::move(allocator)) {
}

Member Function Documentation

◆ addFinishedCallback()

void GrD3DCommandList::addFinishedCallback ( sk_sp< skgpu::RefCntedCallback > callback )

Definition at line 83 of file GrD3DCommandList.cpp.

                                                                                {
    fFinishedCallbacks.push_back(std::move(callback));
}

◆ addGrBuffer()

void GrD3DCommandList::addGrBuffer ( sk_sp< const GrBuffer > buffer )

inline

Definition at line 100 of file GrD3DCommandList.h.

                                                   {
        fTrackedGpuBuffers.push_back(std::move(buffer));
    }

◆ addingWork()

void GrD3DCommandList::addingWork ( )

protected

Definition at line 263 of file GrD3DCommandList.cpp.

                                  {
    this->submitResourceBarriers();
    fHasWork = true;
}

◆ addRecycledResource()

void GrD3DCommandList::addRecycledResource ( sk_sp< GrRecycledResource > resource )

inline

Definition at line 106 of file GrD3DCommandList.h.

                                                                 {
        fTrackedRecycledResources.push_back(std::move(resource));
    }

◆ addResource()

void GrD3DCommandList::addResource ( sk_sp< GrManagedResource > resource )

inlineprotected

Definition at line 125 of file GrD3DCommandList.h.

                                                        {
        SkASSERT(resource);
        fTrackedResources.push_back(std::move(resource));
    }

◆ aliasingBarrier()

void GrD3DCommandList::aliasingBarrier	(	sk_sp< GrManagedResource >	beforeManagedResource,
		ID3D12Resource *	beforeResource,
		sk_sp< GrManagedResource >	afterManagedResource,
		ID3D12Resource *	afterResource
	)

Definition at line 125 of file GrD3DCommandList.cpp.

                                                                      {
    SkASSERT(fIsActive);
    // D3D will apply barriers in order so we can just add onto the end
    D3D12_RESOURCE_BARRIER& newBarrier = fResourceBarriers.push_back();
    newBarrier.Type = D3D12_RESOURCE_BARRIER_TYPE_ALIASING;
    newBarrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE;
    newBarrier.Aliasing.pResourceBefore = beforeResource;
    newBarrier.Aliasing.pResourceAfter = afterResource;
 
    fHasWork = true;
    if (beforeResource) {
        SkASSERT(beforeManagedResource);
        this->addResource(std::move(beforeManagedResource));
    }
    // Aliasing barriers can accept a null pointer for the second resource,
    // but at this point we're not using that feature.
    SkASSERT(afterResource);
    SkASSERT(afterManagedResource);
    this->addResource(std::move(afterManagedResource));
}

◆ close()

bool GrD3DCommandList::close ( )

Definition at line 28 of file GrD3DCommandList.cpp.

                             {
    SkASSERT(fIsActive);
    this->submitResourceBarriers();
    HRESULT hr = fCommandList->Close();
    SkDEBUGCODE(fIsActive = false;)
    return SUCCEEDED(hr);
}

◆ copyBufferToBuffer()

void GrD3DCommandList::copyBufferToBuffer	(	sk_sp< GrD3DBuffer >	dstBuffer,
		uint64_t	dstOffset,
		ID3D12Resource *	srcBuffer,
		uint64_t	srcOffset,
		uint64_t	numBytes
	)

Definition at line 246 of file GrD3DCommandList.cpp.

                                                             {
    SkASSERT(fIsActive);
 
    this->addingWork();
    ID3D12Resource* dstBuffer = dst->d3dResource();
    uint64_t dstSize = dstBuffer->GetDesc().Width;
    uint64_t srcSize = srcBuffer->GetDesc().Width;
    if (dstSize == srcSize && srcSize == numBytes) {
        fCommandList->CopyResource(dstBuffer, srcBuffer);
    } else {
        fCommandList->CopyBufferRegion(dstBuffer, dstOffset, srcBuffer, srcOffset, numBytes);
    }
    this->addGrBuffer(std::move(dst));
}

◆ copyBufferToTexture()

void GrD3DCommandList::copyBufferToTexture	(	ID3D12Resource *	srcBuffer,
		const GrD3DTextureResource *	dstTexture,
		uint32_t	subresourceCount,
		D3D12_PLACED_SUBRESOURCE_FOOTPRINT *	bufferFootprints,
		int	left,
		int	top
	)

Definition at line 159 of file GrD3DCommandList.cpp.

                                                              {
    SkASSERT(fIsActive);
    SkASSERT(subresourceCount == 1 || (left == 0 && top == 0));
 
    this->addingWork();
    this->addResource(dstTexture->resource());
 
    for (uint32_t subresource = 0; subresource < subresourceCount; ++subresource) {
        D3D12_TEXTURE_COPY_LOCATION src = {};
        src.pResource = srcBuffer;
        src.Type = D3D12_TEXTURE_COPY_TYPE_PLACED_FOOTPRINT;
        src.PlacedFootprint = bufferFootprints[subresource];
 
        D3D12_TEXTURE_COPY_LOCATION dst = {};
        dst.pResource = dstTexture->d3dResource();
        dst.Type = D3D12_TEXTURE_COPY_TYPE_SUBRESOURCE_INDEX;
        dst.SubresourceIndex = subresource;
 
        fCommandList->CopyTextureRegion(&dst, left, top, 0, &src, nullptr);
    }
}

◆ copyTextureRegionToBuffer()

void GrD3DCommandList::copyTextureRegionToBuffer	(	sk_sp< const GrBuffer >	dst,
		const D3D12_TEXTURE_COPY_LOCATION *	dstLocation,
		UINT	dstX,
		UINT	dstY,
		sk_sp< GrManagedResource >	src,
		const D3D12_TEXTURE_COPY_LOCATION *	srcLocation,
		const D3D12_BOX *	srcBox
	)

Definition at line 199 of file GrD3DCommandList.cpp.

                                                                          {
    SkASSERT(fIsActive);
    SkASSERT(dst);
    this->addingWork();
    this->addGrBuffer(std::move(dst));
    this->addResource(std::move(src));
    fCommandList->CopyTextureRegion(dstLocation, dstX, dstY, 0, srcLocation, srcBox);
}

◆ copyTextureRegionToTexture()

void GrD3DCommandList::copyTextureRegionToTexture	(	sk_sp< GrManagedResource >	dst,
		const D3D12_TEXTURE_COPY_LOCATION *	dstLocation,
		UINT	dstX,
		UINT	dstY,
		sk_sp< GrManagedResource >	src,
		const D3D12_TEXTURE_COPY_LOCATION *	srcLocation,
		const D3D12_BOX *	srcBox
	)

Definition at line 185 of file GrD3DCommandList.cpp.

                                                                           {
    SkASSERT(fIsActive);
    SkASSERT(dst);
    this->addingWork();
    this->addResource(dst);
    this->addResource(std::move(src));
    fCommandList->CopyTextureRegion(dstLocation, dstX, dstY, 0, srcLocation, srcBox);
}

◆ copyTextureToTexture()

void GrD3DCommandList::copyTextureToTexture	(	const GrD3DTexture *	dst,
		const GrD3DTexture *	src,
		UINT	subresourceIndex = `-1`
	)

Definition at line 215 of file GrD3DCommandList.cpp.

                                                                   {
    SkASSERT(fIsActive);
    SkASSERT(src);
    SkASSERT(dst);
    SkASSERT(src->width() == dst->width() && src->height() == dst->height());
 
    this->addingWork();
    ID3D12Resource* dstTexture = dst->d3dResource();
    ID3D12Resource* srcTexture = src->d3dResource();
    if (subresourceIndex == (UINT)-1) {
        fCommandList->CopyResource(dstTexture, srcTexture);
    } else {
        SkASSERT(subresourceIndex < src->mipLevels() &&
                 subresourceIndex < dst->mipLevels());
        D3D12_TEXTURE_COPY_LOCATION srcLoc = {};
        srcLoc.pResource = srcTexture;
        srcLoc.Type = D3D12_TEXTURE_COPY_TYPE_SUBRESOURCE_INDEX;
        srcLoc.SubresourceIndex = subresourceIndex;
 
        D3D12_TEXTURE_COPY_LOCATION dstLoc = {};
        dstLoc.pResource = dstTexture;
        dstLoc.Type = D3D12_TEXTURE_COPY_TYPE_SUBRESOURCE_INDEX;
        dstLoc.SubresourceIndex = subresourceIndex;
 
        fCommandList->CopyTextureRegion(&dstLoc, 0, 0, 0, &srcLoc, nullptr);
    }
    this->addResource(dst->resource());
    this->addResource(src->resource());
}

◆ hasWork()

bool GrD3DCommandList::hasWork ( ) const

inline

Definition at line 112 of file GrD3DCommandList.h.

112{ return fHasWork; }

◆ onReset()

virtual void GrD3DCommandList::onReset ( )

inlineprotectedvirtual

Reimplemented in GrD3DDirectCommandList.

Definition at line 131 of file GrD3DCommandList.h.

131{}

◆ releaseResources()

void GrD3DCommandList::releaseResources ( )

Definition at line 65 of file GrD3DCommandList.cpp.

                                        {
    TRACE_EVENT0("skia.gpu", TRACE_FUNC);
    if (fTrackedResources.size() == 0 && fTrackedRecycledResources.size() == 0) {
        return;
    }
    SkASSERT(!fIsActive);
    for (int i = 0; i < fTrackedRecycledResources.size(); ++i) {
        auto resource = fTrackedRecycledResources[i].release();
        resource->recycle();
    }
 
    fTrackedResources.clear();
    fTrackedRecycledResources.clear();
    fTrackedGpuBuffers.clear();
 
    this->callFinishedCallbacks();
}

◆ reset()

void GrD3DCommandList::reset ( )

Definition at line 53 of file GrD3DCommandList.cpp.

                             {
    SkASSERT(!fIsActive);
    GR_D3D_CALL_ERRCHECK(fAllocator->Reset());
    GR_D3D_CALL_ERRCHECK(fCommandList->Reset(fAllocator.get(), nullptr));
    this->onReset();
 
    this->releaseResources();
 
    SkDEBUGCODE(fIsActive = true;)
    fHasWork = false;
}

◆ resourceBarrier()

void GrD3DCommandList::resourceBarrier	(	sk_sp< GrManagedResource >	managedResource,
		int	numBarriers,
		const D3D12_RESOURCE_TRANSITION_BARRIER *	barriers
	)

Definition at line 91 of file GrD3DCommandList.cpp.

                                                                                          {
    SkASSERT(fIsActive);
    SkASSERT(barriers);
    for (int i = 0; i < numBarriers; ++i) {
        // D3D will apply barriers in order so we can just add onto the end
        D3D12_RESOURCE_BARRIER& newBarrier = fResourceBarriers.push_back();
        newBarrier.Type = D3D12_RESOURCE_BARRIER_TYPE_TRANSITION;
        newBarrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE;
        newBarrier.Transition = barriers[i];
    }
 
    fHasWork = true;
    if (resource) {
        this->addResource(std::move(resource));
    }
}

◆ SkDEBUGCODE()

GrD3DCommandList::SkDEBUGCODE ( bool fIsActive = true; )

protected

◆ submit()

GrD3DCommandList::SubmitResult GrD3DCommandList::submit ( ID3D12CommandQueue * queue )

Definition at line 36 of file GrD3DCommandList.cpp.

                                                                               {
    SkASSERT(fIsActive);
    if (!this->hasWork()) {
        this->callFinishedCallbacks();
        return SubmitResult::kNoWork;
    }
 
    if (!this->close()) {
        return SubmitResult::kFailure;
    }
    SkASSERT(!fIsActive);
    ID3D12CommandList* ppCommandLists[] = { fCommandList.get() };
    queue->ExecuteCommandLists(1, ppCommandLists);
 
    return SubmitResult::kSuccess;
}

◆ submitResourceBarriers()

void GrD3DCommandList::submitResourceBarriers ( )

protected

Definition at line 149 of file GrD3DCommandList.cpp.

                                              {
    SkASSERT(fIsActive);
 
    if (fResourceBarriers.size()) {
        fCommandList->ResourceBarrier(fResourceBarriers.size(), fResourceBarriers.begin());
        fResourceBarriers.clear();
    }
    SkASSERT(!fResourceBarriers.size());
}

◆ uavBarrier()

void GrD3DCommandList::uavBarrier	(	sk_sp< GrManagedResource >	managedResource,
		ID3D12Resource *	uavResource
	)

Definition at line 110 of file GrD3DCommandList.cpp.

                                                               {
    SkASSERT(fIsActive);
    // D3D will apply barriers in order so we can just add onto the end
    D3D12_RESOURCE_BARRIER& newBarrier = fResourceBarriers.push_back();
    newBarrier.Type = D3D12_RESOURCE_BARRIER_TYPE_UAV;
    newBarrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE;
    newBarrier.UAV.pResource = uavResource;
 
    fHasWork = true;
    if (resource) {
        this->addResource(std::move(resource));
    }
}

Member Data Documentation

◆ fCommandList

gr_cp<ID3D12GraphicsCommandList> GrD3DCommandList::fCommandList

protected

Definition at line 135 of file GrD3DCommandList.h.

◆ fTrackedGpuBuffers

TrackedResourceArray<sk_sp<const GrBuffer> > GrD3DCommandList::fTrackedGpuBuffers

protected

Definition at line 141 of file GrD3DCommandList.h.

◆ fTrackedRecycledResources

TrackedResourceArray<sk_sp<GrRecycledResource> > GrD3DCommandList::fTrackedRecycledResources

protected

Definition at line 140 of file GrD3DCommandList.h.

◆ fTrackedResources

TrackedResourceArray<sk_sp<GrManagedResource> > GrD3DCommandList::fTrackedResources

protected

Definition at line 139 of file GrD3DCommandList.h.

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

third_party/skia/src/gpu/ganesh/d3d/GrD3DCommandList.h
third_party/skia/src/gpu/ganesh/d3d/GrD3DCommandList.cpp

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ TrackedResourceArray

Member Enumeration Documentation

◆ SubmitResult

Constructor & Destructor Documentation

◆ ~GrD3DCommandList()

◆ GrD3DCommandList()

Member Function Documentation

◆ addFinishedCallback()

◆ addGrBuffer()

◆ addingWork()

◆ addRecycledResource()

◆ addResource()

◆ aliasingBarrier()

◆ close()

◆ copyBufferToBuffer()

◆ copyBufferToTexture()

◆ copyTextureRegionToBuffer()

◆ copyTextureRegionToTexture()

◆ copyTextureToTexture()

◆ hasWork()

◆ onReset()

◆ releaseResources()

◆ reset()

◆ resourceBarrier()

◆ SkDEBUGCODE()

◆ submit()

◆ submitResourceBarriers()

◆ uavBarrier()

Member Data Documentation

◆ fCommandList

◆ fTrackedGpuBuffers

◆ fTrackedRecycledResources

◆ fTrackedResources