#include <SDFTextRenderStep.h>

Inheritance diagram for skgpu::graphite::SDFTextRenderStep:

Public Member Functions
	SDFTextRenderStep (bool isLCD)

	~SDFTextRenderStep () override

std::string	vertexSkSL () const override

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

const char *	fragmentCoverageSkSL () const override

void	writeVertices (DrawWriter *, const DrawParams &, skvx::ushort2 ssboIndices) const override

void	writeUniformsAndTextures (const DrawParams &, PipelineDataGatherer *) const override

Public Member Functions inherited from skgpu::graphite::RenderStep
virtual	~RenderStep ()=default

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

Additional Inherited Members
Static Public Member Functions inherited from skgpu::graphite::RenderStep
static const char *	ssboIndicesAttribute ()

static const char *	ssboIndicesVarying ()

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

Protected Member Functions inherited from 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={})

Detailed Description

Definition at line 17 of file SDFTextRenderStep.h.

Constructor & Destructor Documentation

◆ SDFTextRenderStep()

skgpu::graphite::SDFTextRenderStep::SDFTextRenderStep ( bool isLCD )

Definition at line 33 of file SDFTextRenderStep.cpp.

        : RenderStep("SDFTextRenderStep",
                     isLCD ? "565" : "A8",
                     isLCD ? Flags::kPerformsShading | Flags::kHasTextures | Flags::kEmitsCoverage |
                             Flags::kLCDCoverage
                           : Flags::kPerformsShading | Flags::kHasTextures | Flags::kEmitsCoverage,
                     /*uniforms=*/{{"subRunDeviceMatrix", SkSLType::kFloat4x4},
                                   {"deviceToLocal", SkSLType::kFloat4x4},
                                   {"atlasSizeInv", SkSLType::kFloat2},
                                   {"distAdjust", SkSLType::kFloat}},
                     PrimitiveType::kTriangleStrip,
                     kDirectDepthGEqualPass,
                     /*vertexAttrs=*/ {},
                     /*instanceAttrs=*/
                     {{"size", VertexAttribType::kUShort2, SkSLType::kUShort2},
                      {"uvPos", VertexAttribType::kUShort2, SkSLType::kUShort2},
                      {"xyPos", VertexAttribType::kFloat2, SkSLType::kFloat2},
                      {"indexAndFlags", VertexAttribType::kUShort2, SkSLType::kUShort2},
                      {"strikeToSourceScale", VertexAttribType::kFloat, SkSLType::kFloat},
                      {"depth", VertexAttribType::kFloat, SkSLType::kFloat},
                      {"ssboIndices", VertexAttribType::kUShort2, SkSLType::kUShort2}},
                     /*varyings=*/
                     {{"unormTexCoords", SkSLType::kFloat2},
                      {"textureCoords", SkSLType::kFloat2},
                      {"texIndex", SkSLType::kFloat}}) {
    // TODO: store if it's A8 and adjust shader
}

◆ ~SDFTextRenderStep()

skgpu::graphite::SDFTextRenderStep::~SDFTextRenderStep ( )

override

Definition at line 61 of file SDFTextRenderStep.cpp.

61{}

Member Function Documentation

◆ fragmentCoverageSkSL()

const char * skgpu::graphite::SDFTextRenderStep::fragmentCoverageSkSL ( ) const

overridevirtual

Reimplemented from skgpu::graphite::RenderStep.

Definition at line 93 of file SDFTextRenderStep.cpp.

                                                          {
    // The returned SkSL must write its coverage into a 'half4 outputCoverage' variable (defined in
    // the calling code) with the actual coverage splatted out into all four channels.
 
    // TODO: To minimize the number of shaders generated this is the full affine shader.
    // For best performance it may be worth creating the uniform scale shader as well,
    // as that's the most common case.
    // TODO: Need to add 565 support.
    // TODO: Need aliased and possibly sRGB support.
    static_assert(kNumSDFAtlasTextures == 4);
    return "outputCoverage = sdf_text_coverage_fn(sample_indexed_atlas(textureCoords, "
                                                                      "int(texIndex), "
                                                                      "sdf_atlas_0, "
                                                                      "sdf_atlas_1, "
                                                                      "sdf_atlas_2, "
                                                                      "sdf_atlas_3).r, "
                                                 "half(distAdjust), "
                                                 "unormTexCoords);";
}

◆ texturesAndSamplersSkSL()

std::string skgpu::graphite::SDFTextRenderStep::texturesAndSamplersSkSL	(	const ResourceBindingRequirements &	bindingReqs,
		int *	nextBindingIndex
	)		const

overridevirtual

Reimplemented from skgpu::graphite::RenderStep.

Definition at line 81 of file SDFTextRenderStep.cpp.

                                                                                     {
    std::string result;
 
    for (unsigned int i = 0; i < kNumSDFAtlasTextures; ++i) {
        result += EmitSamplerLayout(bindingReqs, nextBindingIndex);
        SkSL::String::appendf(&result, " sampler2D sdf_atlas_%u;\n", i);
    }
 
    return result;
}

◆ vertexSkSL()

std::string skgpu::graphite::SDFTextRenderStep::vertexSkSL ( ) const

overridevirtual

Implements skgpu::graphite::RenderStep.

Definition at line 63 of file SDFTextRenderStep.cpp.

                                              {
    // Returns the body of a vertex function, which must define a float4 devPosition variable and
    // must write to an already-defined float2 stepLocalCoords variable.
    return "texIndex = half(indexAndFlags.x);"
           "float4 devPosition = text_vertex_fn(float2(sk_VertexID >> 1, sk_VertexID & 1), "
                                               "subRunDeviceMatrix, "
                                               "deviceToLocal, "
                                               "atlasSizeInv, "
                                               "float2(size), "
                                               "float2(uvPos), "
                                               "xyPos, "
                                               "strikeToSourceScale, "
                                               "depth, "
                                               "textureCoords, "
                                               "unormTexCoords, "
                                               "stepLocalCoords);";
}

◆ writeUniformsAndTextures()

void skgpu::graphite::SDFTextRenderStep::writeUniformsAndTextures	(	const DrawParams &	params,
		PipelineDataGatherer *	gatherer
	)		const

overridevirtual

Implements skgpu::graphite::RenderStep.

Definition at line 126 of file SDFTextRenderStep.cpp.

                                                                                       {
    SkDEBUGCODE(UniformExpectationsValidator uev(gatherer, this->uniforms());)
 
    const SubRunData& subRunData = params.geometry().subRunData();
    unsigned int numProxies;
    Recorder* recorder = subRunData.recorder();
    const sk_sp<TextureProxy>* proxies =
            recorder->priv().atlasProvider()->textAtlasManager()->getProxies(
                    subRunData.subRun()->maskFormat(), &numProxies);
    SkASSERT(proxies && numProxies > 0);
 
    // write uniforms
    gatherer->write(params.transform().matrix());  // subRunDeviceMatrix
    gatherer->write(subRunData.deviceToLocal());
    SkV2 atlasDimensionsInverse = {1.f/proxies[0]->dimensions().width(),
                                   1.f/proxies[0]->dimensions().height()};
    gatherer->write(atlasDimensionsInverse);
 
    // TODO: get this from DistanceFieldAdjustTable and luminance color (set in SubRunData?)
    float gammaCorrection = 0.f;
    gatherer->write(gammaCorrection);
 
    // write textures and samplers
    const SkSamplingOptions kSamplingOptions(SkFilterMode::kLinear);
    constexpr SkTileMode kTileModes[2] = { SkTileMode::kClamp, SkTileMode::kClamp };
    for (unsigned int i = 0; i < numProxies; ++i) {
        gatherer->add(kSamplingOptions, kTileModes, proxies[i]);
    }
    // If the atlas has less than 4 active proxies we still need to set up samplers for the shader.
    for (unsigned int i = numProxies; i < kNumSDFAtlasTextures; ++i) {
        gatherer->add(kSamplingOptions, kTileModes, proxies[0]);
    }
}

◆ writeVertices()

void skgpu::graphite::SDFTextRenderStep::writeVertices	(	DrawWriter *	dw,
		const DrawParams &	params,
		skvx::ushort2	ssboIndices
	)		const

overridevirtual

Implements skgpu::graphite::RenderStep.

Definition at line 113 of file SDFTextRenderStep.cpp.

                                                                     {
    const SubRunData& subRunData = params.geometry().subRunData();
    subRunData.subRun()->vertexFiller().fillInstanceData(dw,
                                                         subRunData.startGlyphIndex(),
                                                         subRunData.glyphCount(),
                                                         subRunData.subRun()->instanceFlags(),
                                                         ssboIndices,
                                                         subRunData.subRun()->glyphs(),
                                                         params.order().depthAsFloat());
}

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

third_party/skia/src/gpu/graphite/render/SDFTextRenderStep.h
third_party/skia/src/gpu/graphite/render/SDFTextRenderStep.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SDFTextRenderStep()

◆ ~SDFTextRenderStep()

Member Function Documentation

◆ fragmentCoverageSkSL()

◆ texturesAndSamplersSkSL()

◆ vertexSkSL()

◆ writeUniformsAndTextures()

◆ writeVertices()