skiatest::graphite::GraphiteTestContext Class Reference

#include <GraphiteTestContext.h>

Inheritance diagram for skiatest::graphite::GraphiteTestContext:

Public Member Functions
	GraphiteTestContext (const GraphiteTestContext &)=delete
GraphiteTestContext &	operator= (const GraphiteTestContext &)=delete
virtual	~GraphiteTestContext ()
virtual skgpu::BackendApi	backend ()=0
virtual skgpu::ContextType	contextType ()=0
virtual std::unique_ptr< skgpu::graphite::Context >	makeContext (const TestOptions &)=0
bool	getMaxGpuFrameLag (int *maxFrameLag) const
void	submitRecordingAndWaitOnSync (skgpu::graphite::Context *, skgpu::graphite::Recording *)
virtual void	tick ()
void	syncedSubmit (skgpu::graphite::Context *)

Protected Member Functions
	GraphiteTestContext ()

Protected Attributes
sk_sp< sk_gpu_test::FlushFinishTracker >	fFinishTrackers [kMaxFrameLag - 1]
int	fCurrentFlushIdx = 0

Static Protected Attributes
static constexpr int	kMaxFrameLag = 3

Detailed Description

An offscreen 3D context. This class is intended for Skia's internal testing needs and not for general use.

Definition at line 34 of file GraphiteTestContext.h.

Constructor & Destructor Documentation

GraphiteTestContext() [1/2]

skiatest::graphite::GraphiteTestContext::GraphiteTestContext ( const GraphiteTestContext &  )

delete

~GraphiteTestContext()

skiatest::graphite::GraphiteTestContext::~GraphiteTestContext ( )

virtual

Definition at line 22 of file GraphiteTestContext.cpp.

{}

GraphiteTestContext() [2/2]

skiatest::graphite::GraphiteTestContext::GraphiteTestContext ( )

protected

Definition at line 20 of file GraphiteTestContext.cpp.

{}

Member Function Documentation

backend()

virtual skgpu::BackendApi skiatest::graphite::GraphiteTestContext::backend ( )

pure virtual

Implemented in skiatest::graphite::DawnTestContext, skiatest::graphite::MtlTestContext, and skiatest::graphite::VulkanTestContext.

contextType()

virtual skgpu::ContextType skiatest::graphite::GraphiteTestContext::contextType ( )

pure virtual

Implemented in skiatest::graphite::DawnTestContext, skiatest::graphite::MtlTestContext, and skiatest::graphite::VulkanTestContext.

getMaxGpuFrameLag()

bool skiatest::graphite::GraphiteTestContext::getMaxGpuFrameLag ( int *  maxFrameLag ) const

inline

Definition at line 47 of file GraphiteTestContext.h.

                                                   {
        *maxFrameLag = kMaxFrameLag;
        return true;
    }

makeContext()

virtual std::unique_ptr< skgpu::graphite::Context > skiatest::graphite::GraphiteTestContext::makeContext ( const TestOptions &  )

pure virtual

Implemented in skiatest::graphite::DawnTestContext, skiatest::graphite::MtlTestContext, and skiatest::graphite::VulkanTestContext.

operator=()

GraphiteTestContext & skiatest::graphite::GraphiteTestContext::operator= ( const GraphiteTestContext &  )

delete

submitRecordingAndWaitOnSync()

void skiatest::graphite::GraphiteTestContext::submitRecordingAndWaitOnSync	(	skgpu::graphite::Context *	context,
		skgpu::graphite::Recording *	recording
	)

This will insert a Recording and submit work to the GPU. Additionally, we will add a finished callback to our insert recording call. We allow ourselves to have kMaxFrameLag number of unfinished flushes active on the GPU at a time. If we have 2 outstanding flushes then we will wait on the CPU until one has finished.

Definition at line 24 of file GraphiteTestContext.cpp.

                                                                                          {
    TRACE_EVENT0("skia.gpu", TRACE_FUNC);
    SkASSERT(context);
    SkASSERT(recording);
 
    if (fFinishTrackers[fCurrentFlushIdx]) {
        fFinishTrackers[fCurrentFlushIdx]->waitTillFinished([this] { tick(); });
    }
 
    fFinishTrackers[fCurrentFlushIdx].reset(new sk_gpu_test::FlushFinishTracker(context));
 
    // We add an additional ref to the current flush tracker here. This ref is owned by the finish
    // callback on the flush call. The finish callback will unref the tracker when called.
    fFinishTrackers[fCurrentFlushIdx]->ref();
 
    skgpu::graphite::InsertRecordingInfo info;
    info.fRecording = recording;
    info.fFinishedContext = fFinishTrackers[fCurrentFlushIdx].get();
    info.fFinishedProc = sk_gpu_test::FlushFinishTracker::FlushFinishedResult;
    context->insertRecording(info);
 
    context->submit(skgpu::graphite::SyncToCpu::kNo);
 
    fCurrentFlushIdx = (fCurrentFlushIdx + 1) % std::size(fFinishTrackers);
}

syncedSubmit()

void skiatest::graphite::GraphiteTestContext::syncedSubmit

(

skgpu::graphite::Context *

context

)

If the context supports CPU/GPU sync'ing this calls submit with skgpu::SyncToCpu::kYes. Otherwise it calls it with kNo in a busy loop.

Definition at line 51 of file GraphiteTestContext.cpp.

                                                                    {
    skgpu::graphite::SyncToCpu sync = context->priv().caps()->allowCpuSync()
                                              ? skgpu::graphite::SyncToCpu::kYes
                                              : skgpu::graphite::SyncToCpu::kNo;
    context->submit(sync);
    if (sync == skgpu::graphite::SyncToCpu::kNo) {
        while (context->hasUnfinishedGpuWork()) {
            this->tick();
            context->checkAsyncWorkCompletion();
        }
    }
}

tick()

virtual void skiatest::graphite::GraphiteTestContext::tick ( )

inlinevirtual

Allow the GPU API to make or detect forward progress on submitted work. For most APIs this is a no-op as the API can do this on another thread.

Reimplemented in skiatest::graphite::DawnTestContext.

Definition at line 64 of file GraphiteTestContext.h.

{}

Member Data Documentation

fCurrentFlushIdx

int skiatest::graphite::GraphiteTestContext::fCurrentFlushIdx = 0

protected

Definition at line 76 of file GraphiteTestContext.h.

fFinishTrackers

sk_sp<sk_gpu_test::FlushFinishTracker> skiatest::graphite::GraphiteTestContext::fFinishTrackers[kMaxFrameLag - 1]

protected

Definition at line 75 of file GraphiteTestContext.h.

kMaxFrameLag

constexpr int skiatest::graphite::GraphiteTestContext::kMaxFrameLag = 3

staticconstexprprotected

Definition at line 73 of file GraphiteTestContext.h.

---

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

• third_party/skia/tools/graphite/GraphiteTestContext.h
• third_party/skia/tools/graphite/GraphiteTestContext.cpp