skgpu::graphite::StaticBufferManager Class Reference

#include <BufferManager.h>

Public Types
enum class	FinishResult : int { kFailure , kSuccess , kNoWork }

Public Member Functions
	StaticBufferManager (ResourceProvider *, const Caps *)
	~StaticBufferManager ()
VertexWriter	getVertexWriter (size_t size, BindBufferInfo *binding)
VertexWriter	getIndexWriter (size_t size, BindBufferInfo *binding)
FinishResult	finalize (Context *, QueueManager *, GlobalCache *)

Detailed Description

The StaticBufferManager is the one-time-only analog to DrawBufferManager and provides "static" Buffers to RenderSteps and other Context-lifetime-tied objects, where the Buffers' contents will not change and can benefit from prioritizing GPU reads. The assumed use case is that they remain read-only on the GPU as well, so a single static buffer can be shared by all Recorders.

Unlike DrawBufferManager's getXWriter() functions that return both a Writer and a BindBufferInfo, StaticBufferManager returns only a Writer and accepts a BindBufferInfo* as an argument. This will be re-written with the final binding info for the GPU-private data once that can be determined after all static buffers have been requested.

Definition at line 228 of file BufferManager.h.

Member Enumeration Documentation

FinishResult

enum class skgpu::graphite::StaticBufferManager::FinishResult : int

strong

Enumerator
kFailure
kSuccess
kNoWork

Definition at line 241 of file BufferManager.h.

                            : int {
        kFailure, // Unable to create or copy static buffers
        kSuccess, // Successfully created static buffers and added GPU tasks to the queue
        kNoWork   // No static buffers required, no GPU tasks add to the queue
    };

Constructor & Destructor Documentation

StaticBufferManager()

skgpu::graphite::StaticBufferManager::StaticBufferManager	(	ResourceProvider *	resourceProvider,
		const Caps *	caps
	)

Definition at line 480 of file BufferManager.cpp.

        : fResourceProvider(resourceProvider)
        , fUploadManager(resourceProvider, caps)
        , fRequiredTransferAlignment(caps->requiredTransferBufferAlignment())
        , fVertexBufferInfo(BufferType::kVertex, caps)
        , fIndexBufferInfo(BufferType::kIndex, caps) {}

~StaticBufferManager()

skgpu::graphite::StaticBufferManager::~StaticBufferManager ( )

default

Member Function Documentation

finalize()

StaticBufferManager::FinishResult skgpu::graphite::StaticBufferManager::finalize	(	Context *	context,
		QueueManager *	queueManager,
		GlobalCache *	globalCache
	)

Definition at line 577 of file BufferManager.cpp.

                                                                                          {
    if (fMappingFailed) {
        return FinishResult::kFailure;
    }
 
    const size_t totalRequiredBytes = fVertexBufferInfo.fTotalRequiredBytes +
                                      fIndexBufferInfo.fTotalRequiredBytes;
    SkASSERT(totalRequiredBytes <= kMaxStaticDataSize);
    if (!totalRequiredBytes) {
        return FinishResult::kNoWork;
    }
 
    if (!fVertexBufferInfo.createAndUpdateBindings(fResourceProvider,
                                                   context,
                                                   queueManager,
                                                   globalCache,
                                                   "StaticVertexBuffer")) {
        return FinishResult::kFailure;
    }
    if (!fIndexBufferInfo.createAndUpdateBindings(fResourceProvider,
                                                  context,
                                                  queueManager,
                                                  globalCache,
                                                  "StaticIndexBuffer")) {
        return FinishResult::kFailure;
    }
    queueManager->addUploadBufferManagerRefs(&fUploadManager);
 
    // Reset the static buffer manager since the Recording's copy tasks now manage ownership of
    // the transfer buffers and the GlobalCache owns the final static buffers.
    fVertexBufferInfo.reset();
    fIndexBufferInfo.reset();
 
    return FinishResult::kSuccess;
}

getIndexWriter()

VertexWriter skgpu::graphite::StaticBufferManager::getIndexWriter	(	size_t	size,
		BindBufferInfo *	binding
	)

Definition at line 499 of file BufferManager.cpp.

                                                                                     {
    void* data = this->prepareStaticData(&fIndexBufferInfo, size, binding);
    return VertexWriter{data, size};
}

getVertexWriter()

VertexWriter skgpu::graphite::StaticBufferManager::getVertexWriter	(	size_t	size,
		BindBufferInfo *	binding
	)

Definition at line 494 of file BufferManager.cpp.

                                                                                      {
    void* data = this->prepareStaticData(&fVertexBufferInfo, size, binding);
    return VertexWriter{data, size};
}

---

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

• third_party/skia/src/gpu/graphite/BufferManager.h
• third_party/skia/src/gpu/graphite/BufferManager.cpp