GrGeometryProcessor Class Reference

#include <GrGeometryProcessor.h>

Inheritance diagram for GrGeometryProcessor:

Classes
class	Attribute
class	AttributeSet
class	ProgramImpl
class	TextureSampler

Public Member Functions
	GrGeometryProcessor (ClassID)
int	numTextureSamplers () const
const TextureSampler &	textureSampler (int index) const
int	numVertexAttributes () const
const AttributeSet &	vertexAttributes () const
int	numInstanceAttributes () const
const AttributeSet &	instanceAttributes () const
bool	hasVertexAttributes () const
bool	hasInstanceAttributes () const
size_t	vertexStride () const
size_t	instanceStride () const
virtual void	addToKey (const GrShaderCaps &, skgpu::KeyBuilder *) const =0
void	getAttributeKey (skgpu::KeyBuilder *b) const
virtual std::unique_ptr< ProgramImpl >	makeProgramImpl (const GrShaderCaps &) const =0
Public Member Functions inherited from GrProcessor
virtual	~GrProcessor ()=default
virtual const char *	name () const =0
void *	operator new (size_t size)
void *	operator new (size_t object_size, size_t footer_size)
void	operator delete (void *target)
void *	operator new (size_t size, void *placement)
void	operator delete (void *target, void *placement)
template<typename T >
const T &	cast () const
ClassID	classID () const

Static Public Member Functions
static uint32_t	ComputeCoordTransformsKey (const GrFragmentProcessor &fp)

Static Public Attributes
static constexpr int	kCoordTransformKeyBits = 4

Protected Member Functions
void	setVertexAttributes (const Attribute *attrs, int attrCount, size_t stride)
void	setInstanceAttributes (const Attribute *attrs, int attrCount, size_t stride)
void	setVertexAttributesWithImplicitOffsets (const Attribute *attrs, int attrCount)
void	setInstanceAttributesWithImplicitOffsets (const Attribute *attrs, int attrCount)
void	setTextureSamplerCnt (int cnt)
Protected Member Functions inherited from GrProcessor
	GrProcessor (ClassID classID)
	GrProcessor (const GrProcessor &)=delete
GrProcessor &	operator= (const GrProcessor &)=delete

Static Protected Member Functions
static Attribute	MakeColorAttribute (const char *name, bool wideColor)

Private Member Functions
virtual const TextureSampler &	onTextureSampler (int) const

Additional Inherited Members
Public Types inherited from GrProcessor
enum	ClassID {   kNull_ClassID , kAttributeTestProcessor_ClassID , kBigKeyProcessor_ClassID , kBlendFragmentProcessor_ClassID ,   kBlockInputFragmentProcessor_ClassID , kButtCapStrokedCircleGeometryProcessor_ClassID , kCircleGeometryProcessor_ClassID , kCircularRRectEffect_ClassID ,   kClockwiseTestProcessor_ClassID , kColorTableEffect_ClassID , kCoverageSetOpXP_ClassID , kCustomXP_ClassID ,   kDashingCircleEffect_ClassID , kDashingLineEffect_ClassID , kDefaultGeoProc_ClassID , kDeviceSpace_ClassID ,   kDIEllipseGeometryProcessor_ClassID , kDisableColorXP_ClassID , kDrawAtlasPathShader_ClassID , kEllipseGeometryProcessor_ClassID ,   kEllipticalRRectEffect_ClassID , kFwidthSquircleTestProcessor_ClassID , kGP_ClassID , kGrBicubicEffect_ClassID ,   kGrBitmapTextGeoProc_ClassID , kGrColorSpaceXformEffect_ClassID , kGrConicEffect_ClassID , kGrConvexPolyEffect_ClassID ,   kGrDiffuseLightingEffect_ClassID , kGrDisplacementMapEffect_ClassID , kGrDistanceFieldA8TextGeoProc_ClassID , kGrDistanceFieldLCDTextGeoProc_ClassID ,   kGrDistanceFieldPathGeoProc_ClassID , kGrFillRRectOp_Processor_ClassID , kGrGaussianConvolutionFragmentProcessor_ClassID , kGrMatrixConvolutionEffect_ClassID ,   kGrMatrixEffect_ClassID , kGrMeshTestProcessor_ClassID , kGrMorphologyEffect_ClassID , kGrPerlinNoise2Effect_ClassID ,   kGrPipelineDynamicStateTestProcessor_ClassID , kGrQuadEffect_ClassID , kGrRRectShadowGeoProc_ClassID , kGrSkSLFP_ClassID ,   kGrSpecularLightingEffect_ClassID , kGrTextureEffect_ClassID , kGrUnrolledBinaryGradientColorizer_ClassID , kGrYUVtoRGBEffect_ClassID ,   kHighPrecisionFragmentProcessor_ClassID , kLatticeGP_ClassID , kPDLCDXferProcessor_ClassID , kPorterDuffXferProcessor_ClassID ,   kPremulFragmentProcessor_ClassID , kQuadEdgeEffect_ClassID , kQuadPerEdgeAAGeometryProcessor_ClassID , kSeriesFragmentProcessor_ClassID ,   kShaderPDXferProcessor_ClassID , kSurfaceColorProcessor_ClassID , kSwizzleFragmentProcessor_ClassID , kTessellate_BoundingBoxShader_ClassID ,   kTessellate_GrModulateAtlasCoverageEffect_ClassID , kTessellate_GrStrokeTessellationShader_ClassID , kTessellate_HullShader_ClassID , kTessellate_MiddleOutShader_ClassID ,   kTessellate_SimpleTriangleShader_ClassID , kTessellationTestTriShader_ClassID , kTestFP_ClassID , kTestRectOp_ClassID ,   kVertexColorSpaceBenchGP_ClassID , kVerticesGP_ClassID }
Protected Attributes inherited from GrProcessor
const ClassID	fClassID

Detailed Description

The GrGeometryProcessor represents some kind of geometric primitive. This includes the shape of the primitive and the inherent color of the primitive. The GrGeometryProcessor is responsible for providing a color and coverage input into the Ganesh rendering pipeline. Through optimization, Ganesh may decide a different color, no color, and / or no coverage are required from the GrGeometryProcessor, so the GrGeometryProcessor must be able to support this functionality.

There are two feedback loops between the GrFragmentProcessors, the GrXferProcessor, and the GrGeometryProcessor. These loops run on the CPU and to determine known properties of the final color and coverage inputs to the GrXferProcessor in order to perform optimizations that preserve correctness. The GrDrawOp seeds these loops with initial color and coverage, in its getProcessorAnalysisInputs implementation. These seed values are processed by the subsequent stages of the rendering pipeline and the output is then fed back into the GrDrawOp in the applyPipelineOptimizations call, where the op can use the information to inform decisions about GrGeometryProcessor creation.

Note that all derived classes should hide their constructors and provide a Make factory function that takes an arena (except for Tesselation-specific classes). This is because geometry processors can be created in either the record-time or flush-time arenas which define their lifetimes (i.e., a DDLs life time in the first case and a single flush in the second case).

Definition at line 53 of file GrGeometryProcessor.h.

Constructor & Destructor Documentation

GrGeometryProcessor()

GrGeometryProcessor::GrGeometryProcessor

(

ClassID

classID

)

Definition at line 20 of file GrGeometryProcessor.cpp.

: GrProcessor(classID) {}

Member Function Documentation

addToKey()

virtual void GrGeometryProcessor::addToKey ( const GrShaderCaps &  , skgpu::KeyBuilder *    ) const

pure virtual

Adds a key on the skgpu::KeyBuilder that reflects any variety in the code that the geometry processor subclass can emit.

Implemented in skgpu::ganesh::QuadPerEdgeAA::QuadPerEdgeAAGeometryProcessor, GrDistanceFieldA8TextGeoProc, GrDistanceFieldPathGeoProc, GrDistanceFieldLCDTextGeoProc, GrRRectShadowGeoProc, GrConicEffect, GrQuadEffect, GrBitmapTextGeoProc, DefaultGeoProc, CircleGeometryProcessor, ButtCapDashedCircleGeometryProcessor, EllipseGeometryProcessor, and DIEllipseGeometryProcessor.

ComputeCoordTransformsKey()

uint32_t GrGeometryProcessor::ComputeCoordTransformsKey ( const GrFragmentProcessor &  fp )

static

Computes a key for the transforms owned by an FP based on the shader code that will be emitted by the primitive processor to implement them.

Definition at line 27 of file GrGeometryProcessor.cpp.

                                                                                     {
    // This is highly coupled with the code in ProgramImpl::collectTransforms().
    uint32_t key = static_cast<uint32_t>(fp.sampleUsage().kind()) << 1;
    // This needs to be updated if GP starts specializing varyings on additional matrix types.
    if (fp.sampleUsage().hasPerspective()) {
        key |= 0b1;
    }
    return key;
}

getAttributeKey()

void GrGeometryProcessor::getAttributeKey

(

skgpu::KeyBuilder *

b

)

const

Definition at line 37 of file GrGeometryProcessor.cpp.

                                                                  {
    b->appendComment("vertex attributes");
    fVertexAttributes.addToKey(b);
    b->appendComment("instance attributes");
    fInstanceAttributes.addToKey(b);
}

hasInstanceAttributes()

bool GrGeometryProcessor::hasInstanceAttributes ( ) const

inline

Definition at line 189 of file GrGeometryProcessor.h.

{ return SkToBool(fInstanceAttributes.count()); }

hasVertexAttributes()

bool GrGeometryProcessor::hasVertexAttributes ( ) const

inline

Definition at line 188 of file GrGeometryProcessor.h.

{ return SkToBool(fVertexAttributes.count()); }

instanceAttributes()

const AttributeSet & GrGeometryProcessor::instanceAttributes ( ) const

inline

Definition at line 186 of file GrGeometryProcessor.h.

{ return fInstanceAttributes; }

instanceStride()

size_t GrGeometryProcessor::instanceStride ( ) const

inline

Definition at line 197 of file GrGeometryProcessor.h.

{ return fInstanceAttributes.stride(); }

MakeColorAttribute()

static Attribute GrGeometryProcessor::MakeColorAttribute ( const char *  name, bool  wideColor  )

inlinestaticprotected

Definition at line 224 of file GrGeometryProcessor.h.

                                                                          {
        return { name,
                 wideColor ? kFloat4_GrVertexAttribType : kUByte4_norm_GrVertexAttribType,
                 SkSLType::kHalf4 };
    }

makeProgramImpl()

virtual std::unique_ptr< ProgramImpl > GrGeometryProcessor::makeProgramImpl ( const GrShaderCaps &  ) const

pure virtual

Returns a new instance of the appropriate implementation class for the given GrGeometryProcessor.

Implemented in GrConicEffect, GrQuadEffect, GrDistanceFieldA8TextGeoProc, GrDistanceFieldPathGeoProc, GrDistanceFieldLCDTextGeoProc, GrRRectShadowGeoProc, DefaultGeoProc, CircleGeometryProcessor, ButtCapDashedCircleGeometryProcessor, EllipseGeometryProcessor, DIEllipseGeometryProcessor, skgpu::ganesh::QuadPerEdgeAA::QuadPerEdgeAAGeometryProcessor, and GrBitmapTextGeoProc.

numInstanceAttributes()

int GrGeometryProcessor::numInstanceAttributes ( ) const

inline

Definition at line 185 of file GrGeometryProcessor.h.

{ return fInstanceAttributes.count(); }

numTextureSamplers()

int GrGeometryProcessor::numTextureSamplers ( ) const

inline

Definition at line 181 of file GrGeometryProcessor.h.

{ return fTextureSamplerCnt; }

numVertexAttributes()

int GrGeometryProcessor::numVertexAttributes ( ) const

inline

Definition at line 183 of file GrGeometryProcessor.h.

{ return fVertexAttributes.count(); }

onTextureSampler()

virtual const TextureSampler & GrGeometryProcessor::onTextureSampler ( int  ) const

inlineprivatevirtual

Definition at line 250 of file GrGeometryProcessor.h.

{ SK_ABORT("no texture samplers"); }

setInstanceAttributes()

void GrGeometryProcessor::setInstanceAttributes ( const Attribute *  attrs, int  attrCount, size_t  stride  )

inlineprotected

Definition at line 232 of file GrGeometryProcessor.h.

                                                                                     {
        SkASSERT(attrCount >= 0);
        fInstanceAttributes.initExplicit(attrs, attrCount, stride);
    }

setInstanceAttributesWithImplicitOffsets()

void GrGeometryProcessor::setInstanceAttributesWithImplicitOffsets ( const Attribute *  attrs, int  attrCount  )

inlineprotected

Definition at line 240 of file GrGeometryProcessor.h.

                                                                                         {
        SkASSERT(attrCount >= 0);
        fInstanceAttributes.initImplicit(attrs, attrCount);
    }

setTextureSamplerCnt()

void GrGeometryProcessor::setTextureSamplerCnt ( int  cnt )

inlineprotected

Definition at line 244 of file GrGeometryProcessor.h.

                                       {
        SkASSERT(cnt >= 0);
        fTextureSamplerCnt = cnt;
    }

setVertexAttributes()

void GrGeometryProcessor::setVertexAttributes ( const Attribute *  attrs, int  attrCount, size_t  stride  )

inlineprotected

Definition at line 229 of file GrGeometryProcessor.h.

                                                                                   {
        fVertexAttributes.initExplicit(attrs, attrCount, stride);
    }

setVertexAttributesWithImplicitOffsets()

void GrGeometryProcessor::setVertexAttributesWithImplicitOffsets ( const Attribute *  attrs, int  attrCount  )

inlineprotected

Definition at line 237 of file GrGeometryProcessor.h.

                                                                                       {
        fVertexAttributes.initImplicit(attrs, attrCount);
    }

textureSampler()

const GrGeometryProcessor::TextureSampler & GrGeometryProcessor::textureSampler

(

int

index

)

const

Definition at line 22 of file GrGeometryProcessor.cpp.

                                                                                        {
    SkASSERT(i >= 0 && i < this->numTextureSamplers());
    return this->onTextureSampler(i);
}

vertexAttributes()

const AttributeSet & GrGeometryProcessor::vertexAttributes ( ) const

inline

Definition at line 184 of file GrGeometryProcessor.h.

{ return fVertexAttributes; }

vertexStride()

size_t GrGeometryProcessor::vertexStride ( ) const

inline

A common practice is to populate the the vertex/instance's memory using an implicit array of structs. In this case, it is best to assert that: stride == sizeof(struct)

Definition at line 196 of file GrGeometryProcessor.h.

{ return fVertexAttributes.stride(); }

Member Data Documentation

kCoordTransformKeyBits

constexpr int GrGeometryProcessor::kCoordTransformKeyBits = 4

inlinestaticconstexpr

Definition at line 205 of file GrGeometryProcessor.h.

---

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

• third_party/skia/src/gpu/ganesh/GrGeometryProcessor.h
• third_party/skia/src/gpu/ganesh/GrGeometryProcessor.cpp