#include <Renderer.h>

Inheritance diagram for skgpu::graphite::RenderStep:

Public Member Functions
virtual	~RenderStep ()=default

virtual void	writeVertices (DrawWriter *, const DrawParams &, skvx::ushort2 ssboIndices) const =0

virtual void	writeUniformsAndTextures (const DrawParams &, PipelineDataGatherer *) const =0

virtual std::string	vertexSkSL () const =0

virtual std::string	texturesAndSamplersSkSL (const ResourceBindingRequirements &, int *nextBindingIndex) const

virtual const char *	fragmentCoverageSkSL () const

virtual const char *	fragmentColorSkSL () const

uint32_t	uniqueID () const

const char *	name () const

bool	requiresMSAA () const

bool	performsShading () const

bool	hasTextures () const

bool	emitsPrimitiveColor () const

bool	outsetBoundsForAA () const

Coverage	coverage () const

PrimitiveType	primitiveType () const

size_t	vertexStride () const

size_t	instanceStride () const

size_t	numUniforms () const

size_t	numVertexAttributes () const

size_t	numInstanceAttributes () const

SkSpan< const Uniform >	uniforms () const

SkSpan< const Attribute >	vertexAttributes () const

SkSpan< const Attribute >	instanceAttributes () const

SkSpan< const Varying >	varyings () const

const DepthStencilSettings &	depthStencilSettings () const

SkEnumBitMask< DepthStencilFlags >	depthStencilFlags () const

Static Public Member Functions
static const char *	ssboIndicesAttribute ()

static const char *	ssboIndicesVarying ()

Protected Types
enum class	Flags : unsigned { kNone = 0b0000000 , kRequiresMSAA = 0b0000001 , kPerformsShading = 0b0000010 , kHasTextures = 0b0000100 , kEmitsCoverage = 0b0001000 , kLCDCoverage = 0b0010000 , kEmitsPrimitiveColor = 0b0100000 , kOutsetBoundsForAA = 0b1000000 }

Protected Member Functions
	RenderStep (std::string_view className, std::string_view variantName, SkEnumBitMask< Flags > flags, std::initializer_list< Uniform > uniforms, PrimitiveType primitiveType, DepthStencilSettings depthStencilSettings, SkSpan< const Attribute > vertexAttrs, SkSpan< const Attribute > instanceAttrs, SkSpan< const Varying > varyings={})

Friends
class	Renderer

Detailed Description

The actual technique for rasterizing a high-level draw recorded in a DrawList is handled by a specific Renderer. Each technique has an associated singleton Renderer that decomposes the technique into a series of RenderSteps that must be executed in the specified order for the draw. However, the RenderStep executions for multiple draws can be re-arranged so batches of each step can be performed in a larger GPU operation. This re-arranging relies on accurate determination of the DisjointStencilIndex for each draw so that stencil steps are not corrupted by another draw before its cover step is executed. It also relies on the CompressedPaintersOrder for each draw to ensure steps are not re-arranged in a way that violates the original draw order.

Renderer itself is non-virtual since it simply has to point to a list of RenderSteps. RenderSteps on the other hand are virtual implement the technique specific functionality. It is entirely possible for certain types of steps, e.g. a bounding box cover, to be re-used across different Renderers even if the preceeding steps were different.

All Renderers are accessed through the SharedContext's RendererProvider.

Definition at line 68 of file Renderer.h.

Member Enumeration Documentation

◆ Flags

enum class skgpu::graphite::RenderStep::Flags : unsigned

strongprotected

Enumerator
kNone
kRequiresMSAA
kPerformsShading
kHasTextures
kEmitsCoverage
kLCDCoverage
kEmitsPrimitiveColor
kOutsetBoundsForAA

Definition at line 165 of file Renderer.h.

                     : unsigned {
        kNone                  = 0b0000000,
        kRequiresMSAA          = 0b0000001,
        kPerformsShading       = 0b0000010,
        kHasTextures           = 0b0000100,
        kEmitsCoverage         = 0b0001000,
        kLCDCoverage           = 0b0010000,
        kEmitsPrimitiveColor   = 0b0100000,
        kOutsetBoundsForAA     = 0b1000000,
    };

Constructor & Destructor Documentation

◆ ~RenderStep()

virtual skgpu::graphite::RenderStep::~RenderStep ( )

virtualdefault

◆ RenderStep()

skgpu::graphite::RenderStep::RenderStep	(	std::string_view	className,
		std::string_view	variantName,
		SkEnumBitMask< Flags >	flags,
		std::initializer_list< Uniform >	uniforms,
		PrimitiveType	primitiveType,
		DepthStencilSettings	depthStencilSettings,
		SkSpan< const Attribute >	vertexAttrs,
		SkSpan< const Attribute >	instanceAttrs,
		SkSpan< const Varying >	varyings = `{}`
	)

protected

Definition at line 19 of file Renderer.cpp.

        : fUniqueID(next_id())
        , fFlags(flags)
        , fPrimitiveType(primitiveType)
        , fDepthStencilSettings(depthStencilSettings)
        , fUniforms(uniforms)
        , fVertexAttrs(vertexAttrs.begin(), vertexAttrs.end())
        , fInstanceAttrs(instanceAttrs.begin(), instanceAttrs.end())
        , fVaryings(varyings.begin(), varyings.end())
        , fVertexStride(0)
        , fInstanceStride(0)
        , fName(className) {
    for (auto v : this->vertexAttributes()) {
        fVertexStride += v.sizeAlign4();
    }
    for (auto i : this->instanceAttributes()) {
        fInstanceStride += i.sizeAlign4();
    }
    if (variantName.size() > 0) {
        fName += "[";
        fName += variantName;
        fName += "]";
    }
}

Member Function Documentation

◆ coverage()

Coverage skgpu::graphite::RenderStep::coverage ( ) const

inline

Definition at line 124 of file Renderer.h.

124{ return RenderStep::GetCoverage(fFlags); }

◆ depthStencilFlags()

SkEnumBitMask< DepthStencilFlags > skgpu::graphite::RenderStep::depthStencilFlags ( ) const

inline

Definition at line 150 of file Renderer.h.

                                                               {
        return (fDepthStencilSettings.fStencilTestEnabled
                        ? DepthStencilFlags::kStencil : DepthStencilFlags::kNone) |
               (fDepthStencilSettings.fDepthTestEnabled || fDepthStencilSettings.fDepthWriteEnabled
                        ? DepthStencilFlags::kDepth : DepthStencilFlags::kNone);
    }

◆ depthStencilSettings()

const DepthStencilSettings & skgpu::graphite::RenderStep::depthStencilSettings ( ) const

inline

Definition at line 148 of file Renderer.h.

148{ return fDepthStencilSettings; }

◆ emitsPrimitiveColor()

bool skgpu::graphite::RenderStep::emitsPrimitiveColor ( ) const

inline

Definition at line 121 of file Renderer.h.

121{ return SkToBool(fFlags & Flags::kEmitsPrimitiveColor); }

SkToBool

static constexpr bool SkToBool(const T &x)

Definition: SkTo.h:35

skgpu::graphite::RenderStep::Flags::kEmitsPrimitiveColor

@ kEmitsPrimitiveColor

◆ fragmentColorSkSL()

virtual const char * skgpu::graphite::RenderStep::fragmentColorSkSL ( ) const

inlinevirtual

Reimplemented in skgpu::graphite::VerticesRenderStep.

Definition at line 110 of file Renderer.h.

110{ return R"()"; }

◆ fragmentCoverageSkSL()

virtual const char * skgpu::graphite::RenderStep::fragmentCoverageSkSL ( ) const

inlinevirtual

Reimplemented in skgpu::graphite::AnalyticBlurRenderStep, skgpu::graphite::AnalyticRRectRenderStep, skgpu::graphite::BitmapTextRenderStep, skgpu::graphite::CoverageMaskRenderStep, skgpu::graphite::PerEdgeAAQuadRenderStep, skgpu::graphite::SDFTextLCDRenderStep, and skgpu::graphite::SDFTextRenderStep.

Definition at line 105 of file Renderer.h.

105{ return R"()"; }

◆ hasTextures()

bool skgpu::graphite::RenderStep::hasTextures ( ) const

inline

Definition at line 120 of file Renderer.h.

120{ return SkToBool(fFlags & Flags::kHasTextures); }

skgpu::graphite::RenderStep::Flags::kHasTextures

@ kHasTextures

◆ instanceAttributes()

SkSpan< const Attribute > skgpu::graphite::RenderStep::instanceAttributes ( ) const

inline

Definition at line 145 of file Renderer.h.

145{ return SkSpan(fInstanceAttrs); }

SkSpan

SkSpan(Container &&) -> SkSpan< std::remove_pointer_t< decltype(std::data(std::declval< Container >()))> >

◆ instanceStride()

size_t skgpu::graphite::RenderStep::instanceStride ( ) const

inline

Definition at line 128 of file Renderer.h.

128{ return fInstanceStride; }

◆ name()

const char * skgpu::graphite::RenderStep::name ( ) const

inline

Definition at line 116 of file Renderer.h.

116{ return fName.c_str(); }

◆ numInstanceAttributes()

size_t skgpu::graphite::RenderStep::numInstanceAttributes ( ) const

inline

Definition at line 132 of file Renderer.h.

132{ return fInstanceAttrs.size(); }

◆ numUniforms()

size_t skgpu::graphite::RenderStep::numUniforms ( ) const

inline

Definition at line 130 of file Renderer.h.

130{ return fUniforms.size(); }

◆ numVertexAttributes()

size_t skgpu::graphite::RenderStep::numVertexAttributes ( ) const

inline

Definition at line 131 of file Renderer.h.

131{ return fVertexAttrs.size(); }

◆ outsetBoundsForAA()

bool skgpu::graphite::RenderStep::outsetBoundsForAA ( ) const

inline

Definition at line 122 of file Renderer.h.

122{ return SkToBool(fFlags & Flags::kOutsetBoundsForAA); }

skgpu::graphite::RenderStep::Flags::kOutsetBoundsForAA

@ kOutsetBoundsForAA

◆ performsShading()

bool skgpu::graphite::RenderStep::performsShading ( ) const

inline

Definition at line 119 of file Renderer.h.

119{ return SkToBool(fFlags & Flags::kPerformsShading); }

skgpu::graphite::RenderStep::Flags::kPerformsShading

@ kPerformsShading

◆ primitiveType()

PrimitiveType skgpu::graphite::RenderStep::primitiveType ( ) const

inline

Definition at line 126 of file Renderer.h.

126{ return fPrimitiveType; }

◆ requiresMSAA()

bool skgpu::graphite::RenderStep::requiresMSAA ( ) const

inline

Definition at line 118 of file Renderer.h.

118{ return SkToBool(fFlags & Flags::kRequiresMSAA); }

skgpu::graphite::RenderStep::Flags::kRequiresMSAA

@ kRequiresMSAA

◆ ssboIndicesAttribute()

static const char * skgpu::graphite::RenderStep::ssboIndicesAttribute ( )

inlinestatic

Definition at line 135 of file Renderer.h.

135{ return "ssboIndices"; }

◆ ssboIndicesVarying()

static const char * skgpu::graphite::RenderStep::ssboIndicesVarying ( )

inlinestatic

Definition at line 139 of file Renderer.h.

139{ return "ssboIndicesVar"; }

◆ texturesAndSamplersSkSL()

virtual std::string skgpu::graphite::RenderStep::texturesAndSamplersSkSL	(	const ResourceBindingRequirements &	,
		int *	nextBindingIndex
	)		const

inlinevirtual

Reimplemented in skgpu::graphite::AnalyticBlurRenderStep, skgpu::graphite::BitmapTextRenderStep, skgpu::graphite::CoverageMaskRenderStep, skgpu::graphite::SDFTextLCDRenderStep, and skgpu::graphite::SDFTextRenderStep.

Definition at line 96 of file Renderer.h.

                                                                             {
        return R"()";
    }

◆ uniforms()

SkSpan< const Uniform > skgpu::graphite::RenderStep::uniforms ( ) const

inline

Definition at line 143 of file Renderer.h.

143{ return SkSpan(fUniforms); }

◆ uniqueID()

uint32_t skgpu::graphite::RenderStep::uniqueID ( ) const

inline

Definition at line 112 of file Renderer.h.

112{ return fUniqueID; }

◆ varyings()

SkSpan< const Varying > skgpu::graphite::RenderStep::varyings ( ) const

inline

Definition at line 146 of file Renderer.h.

146{ return SkSpan(fVaryings); }

◆ vertexAttributes()

SkSpan< const Attribute > skgpu::graphite::RenderStep::vertexAttributes ( ) const

inline

Definition at line 144 of file Renderer.h.

144{ return SkSpan(fVertexAttrs); }

◆ vertexSkSL()

virtual std::string skgpu::graphite::RenderStep::vertexSkSL ( ) const

pure virtual

◆ vertexStride()

size_t skgpu::graphite::RenderStep::vertexStride ( ) const

inline

Definition at line 127 of file Renderer.h.

127{ return fVertexStride; }

◆ writeUniformsAndTextures()

virtual void skgpu::graphite::RenderStep::writeUniformsAndTextures	(	const DrawParams &	,
		PipelineDataGatherer *
	)		const

pure virtual

◆ writeVertices()

virtual void skgpu::graphite::RenderStep::writeVertices	(	DrawWriter *	,
		const DrawParams &	,
		skvx::ushort2	ssboIndices
	)		const

pure virtual

Friends And Related Function Documentation

◆ Renderer

friend class Renderer

friend

Definition at line 191 of file Renderer.h.

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

third_party/skia/src/gpu/graphite/Renderer.h
third_party/skia/src/gpu/graphite/Renderer.cpp

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ Flags

Constructor & Destructor Documentation

◆ ~RenderStep()

◆ RenderStep()

Member Function Documentation

◆ coverage()

◆ depthStencilFlags()

◆ depthStencilSettings()

◆ emitsPrimitiveColor()

◆ fragmentColorSkSL()

◆ fragmentCoverageSkSL()

◆ hasTextures()

◆ instanceAttributes()

◆ instanceStride()

◆ name()

◆ numInstanceAttributes()

◆ numUniforms()

◆ numVertexAttributes()

◆ outsetBoundsForAA()

◆ performsShading()

◆ primitiveType()

◆ requiresMSAA()

◆ ssboIndicesAttribute()

◆ ssboIndicesVarying()

◆ texturesAndSamplersSkSL()

◆ uniforms()

◆ uniqueID()

◆ varyings()

◆ vertexAttributes()

◆ vertexSkSL()

◆ vertexStride()

◆ writeUniformsAndTextures()

◆ writeVertices()

Friends And Related Function Documentation

◆ Renderer