Flutter Engine
The Flutter Engine
Public Member Functions | List of all members
skgpu::graphite::SDFTextRenderStep Class Referencefinal

#include <SDFTextRenderStep.h>

Inheritance diagram for skgpu::graphite::SDFTextRenderStep:
skgpu::graphite::RenderStep

Public Member Functions

 SDFTextRenderStep ()
 
 ~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 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 Uniformuniforms () const
 
SkSpan< const AttributevertexAttributes () const
 
SkSpan< const AttributeinstanceAttributes () const
 
SkSpan< const Varyingvaryings () const
 
const DepthStencilSettingsdepthStencilSettings () const
 
SkEnumBitMask< DepthStencilFlagsdepthStencilFlags () 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 ( )

Definition at line 39 of file SDFTextRenderStep.cpp.

40 : RenderStep("SDFTextRenderStep",
41 "",
43 /*uniforms=*/{{"subRunDeviceMatrix", SkSLType::kFloat4x4},
44 {"deviceToLocal", SkSLType::kFloat4x4},
45 {"atlasSizeInv", SkSLType::kFloat2},
46 {"gammaParams", SkSLType::kHalf2}},
49 /*vertexAttrs=*/ {},
50 /*instanceAttrs=*/
55 {"strikeToSourceScale", VertexAttribType::kFloat, SkSLType::kFloat},
58 /*varyings=*/
59 {{"unormTexCoords", SkSLType::kFloat2},
60 {"textureCoords", SkSLType::kFloat2},
61 {"texIndex", SkSLType::kFloat}}) {}
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={})
Definition: Renderer.cpp:19
static constexpr DepthStencilSettings kDirectDepthGEqualPass

◆ ~SDFTextRenderStep()

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

Definition at line 63 of file SDFTextRenderStep.cpp.

63{}

Member Function Documentation

◆ fragmentCoverageSkSL()

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

Reimplemented from skgpu::graphite::RenderStep.

Definition at line 95 of file SDFTextRenderStep.cpp.

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

◆ texturesAndSamplersSkSL()

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

Reimplemented from skgpu::graphite::RenderStep.

Definition at line 83 of file SDFTextRenderStep.cpp.

84 {
85 std::string result;
86
87 for (unsigned int i = 0; i < kNumSDFAtlasTextures; ++i) {
88 result += EmitSamplerLayout(bindingReqs, nextBindingIndex);
89 SkSL::String::appendf(&result, " sampler2D sdf_atlas_%u;\n", i);
90 }
91
92 return result;
93}
GAsyncResult * result
std::string void appendf(std::string *str, const char *fmt,...) SK_PRINTF_LIKE(2
Definition: SkSLString.cpp:92
std::string EmitSamplerLayout(const ResourceBindingRequirements &bindingReqs, int *binding)

◆ vertexSkSL()

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

Implements skgpu::graphite::RenderStep.

Definition at line 65 of file SDFTextRenderStep.cpp.

65 {
66 // Returns the body of a vertex function, which must define a float4 devPosition variable and
67 // must write to an already-defined float2 stepLocalCoords variable.
68 return "texIndex = half(indexAndFlags.x);"
69 "float4 devPosition = text_vertex_fn(float2(sk_VertexID >> 1, sk_VertexID & 1), "
70 "subRunDeviceMatrix, "
71 "deviceToLocal, "
72 "atlasSizeInv, "
73 "float2(size), "
74 "float2(uvPos), "
75 "xyPos, "
76 "strikeToSourceScale, "
77 "depth, "
78 "textureCoords, "
79 "unormTexCoords, "
80 "stepLocalCoords);";
81}

◆ writeUniformsAndTextures()

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

Implements skgpu::graphite::RenderStep.

Definition at line 128 of file SDFTextRenderStep.cpp.

129 {
130 SkDEBUGCODE(UniformExpectationsValidator uev(gatherer, this->uniforms());)
131
132 const SubRunData& subRunData = params.geometry().subRunData();
133 unsigned int numProxies;
134 Recorder* recorder = subRunData.recorder();
135 const sk_sp<TextureProxy>* proxies =
137 subRunData.subRun()->maskFormat(), &numProxies);
138 SkASSERT(proxies && numProxies > 0);
139
140 // write uniforms
141 gatherer->write(params.transform().matrix()); // subRunDeviceMatrix
142 gatherer->write(subRunData.deviceToLocal());
143 SkV2 atlasDimensionsInverse = {1.f/proxies[0]->dimensions().width(),
144 1.f/proxies[0]->dimensions().height()};
145 gatherer->write(atlasDimensionsInverse);
146
147 float gammaAdjustment = 0;
148 // TODO: generate LCD adjustment
149#if defined(SK_GAMMA_APPLY_TO_A8)
150 auto dfAdjustTable = sktext::gpu::DistanceFieldAdjustTable::Get();
151 // TODO: don't do this for aliased text
153 subRunData.luminanceColor());
154 gammaAdjustment = dfAdjustTable->getAdjustment(lum, subRunData.useGammaCorrectDistanceTable());
155#endif
156 SkV2 gammaParams = {gammaAdjustment, subRunData.useGammaCorrectDistanceTable() ? 1.f : 0.f};
157 gatherer->writeHalf(gammaParams);
158
159 // write textures and samplers
160 const SkSamplingOptions kSamplingOptions(SkFilterMode::kLinear);
161 constexpr SkTileMode kTileModes[2] = { SkTileMode::kClamp, SkTileMode::kClamp };
162 for (unsigned int i = 0; i < numProxies; ++i) {
163 gatherer->add(proxies[i], {kSamplingOptions, kTileModes});
164 }
165 // If the atlas has less than 4 active proxies we still need to set up samplers for the shader.
166 for (unsigned int i = numProxies; i < kNumSDFAtlasTextures; ++i) {
167 gatherer->add(proxies[0], {kSamplingOptions, kTileModes});
168 }
169}
#define SkASSERT(cond)
Definition: SkAssert.h:116
unsigned U8CPU
Definition: SkCPUTypes.h:18
SkDEBUGCODE(SK_SPI) SkThreadID SkGetThreadID()
SkTileMode
Definition: SkTileMode.h:13
#define SK_GAMMA_EXPONENT
Definition: SkTypes.h:86
static U8CPU computeLuminance(SkScalar gamma, SkColor c)
Definition: SkMaskGamma.h:39
TextAtlasManager * textAtlasManager() const
Definition: AtlasProvider.h:53
AtlasProvider * atlasProvider()
Definition: RecorderPriv.h:61
SkSpan< const Uniform > uniforms() const
Definition: Renderer.h:143
const sk_sp< TextureProxy > * getProxies(MaskFormat format, unsigned int *numActiveProxies)
static const DistanceFieldAdjustTable * Get()
const EmbeddedViewParams * params
static float lum(float r, float g, float b)
Definition: hsl.cpp:52
Definition: SkM44.h:19

◆ writeVertices()

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

Implements skgpu::graphite::RenderStep.

Definition at line 115 of file SDFTextRenderStep.cpp.

117 {
118 const SubRunData& subRunData = params.geometry().subRunData();
119 subRunData.subRun()->vertexFiller().fillInstanceData(dw,
120 subRunData.startGlyphIndex(),
121 subRunData.glyphCount(),
122 subRunData.subRun()->instanceFlags(),
123 ssboIndices,
124 subRunData.subRun()->glyphs(),
125 params.order().depthAsFloat());
126}

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