SkShaper::RunHandler Class Reference

#include <SkShaper.h>

Inheritance diagram for SkShaper::RunHandler:

Classes
struct	Buffer
struct	Range
struct	RunInfo

Public Member Functions
virtual	~RunHandler ()=default
virtual void	beginLine ()=0
virtual void	runInfo (const RunInfo &)=0
virtual void	commitRunInfo ()=0
virtual Buffer	runBuffer (const RunInfo &)=0
virtual void	commitRunBuffer (const RunInfo &)=0
virtual void	commitLine ()=0

Detailed Description

Definition at line 194 of file SkShaper.h.

Constructor & Destructor Documentation

~RunHandler()

virtual SkShaper::RunHandler::~RunHandler ( )

virtualdefault

Member Function Documentation

beginLine()

void RunHandler::beginLine ( )

pure virtual

Called when beginning a line.

Implemented in SkShaperJSONWriter, and SkTextBlobBuilderRunHandler.

Definition at line 135 of file shape.cpp.

                           {
    fCurrentPosition = fOffset;
    fMaxRunAscent = 0;
    fMaxRunDescent = 0;
    fMaxRunLeading = 0;
}

commitLine()

void RunHandler::commitLine ( )

pure virtual

Called when ending a line.

Implemented in SkShaperJSONWriter, and SkTextBlobBuilderRunHandler.

Definition at line 201 of file shape.cpp.

                            {
    if (fLineEndOffsets.empty() || fTextOffset > fLineEndOffsets.back()) {
        // Ensure that fLineEndOffsets is monotonic.
        fLineEndOffsets.push_back(fTextOffset);
    }
    fOffset += { 0, fMaxRunDescent + fMaxRunLeading - fMaxRunAscent };
}

commitRunBuffer()

void RunHandler::commitRunBuffer ( const RunInfo &  info )

pure virtual

Called after each runBuffer is filled out.

Implemented in SkTextBlobBuilderRunHandler, and SkShaperJSONWriter.

Definition at line 176 of file shape.cpp.

                                                    {
    // for (size_t i = 0; i < info.glyphCount; ++i) {
    //     SkASSERT(fClusters[i] >= info.utf8Range.begin());
    //     // this fails for khmer example.
    //     SkASSERT(fClusters[i] <  info.utf8Range.end());
    // }
    if (fCallbackFunction) {
        fCallbackFunction(fCallbackContext,
                          fUtf8Text,
                          info.utf8Range.end(),
                          info.glyphCount,
                          fCurrentGlyphs,
                          fCurrentPoints,
                          fClusters,
                          info.fFont);
    }
    SkASSERT(0 <= fClusterOffset);
    for (int i = 0; i < fGlyphCount; ++i) {
        SkASSERT(fClusters[i] >= (unsigned)fClusterOffset);
        fClusters[i] -= fClusterOffset;
    }
    fCurrentPosition += info.fAdvance;
    fTextOffset = std::max(fTextOffset, info.utf8Range.end());
}

commitRunInfo()

void RunHandler::commitRunInfo ( )

pure virtual

Called after all runInfo calls for a line.

Implemented in SkShaperJSONWriter, and SkTextBlobBuilderRunHandler.

Definition at line 150 of file shape.cpp.

                               {
    fCurrentPosition.fY -= fMaxRunAscent;
}

runBuffer()

SkShaper::RunHandler::Buffer RunHandler::runBuffer ( const RunInfo &  info )

pure virtual

Called for each run in a line after commitRunInfo. The buffer will be filled out.

Implemented in SkTextBlobBuilderRunHandler, and SkShaperJSONWriter.

Definition at line 154 of file shape.cpp.

                                                                  {
    int glyphCount = SkTFitsIn<int>(info.glyphCount) ? info.glyphCount : INT_MAX;
    int utf8RangeSize = SkTFitsIn<int>(info.utf8Range.size()) ? info.utf8Range.size() : INT_MAX;
 
    const auto& runBuffer = fBuilder.allocRunTextPos(info.fFont, glyphCount, utf8RangeSize);
    fCurrentGlyphs = runBuffer.glyphs;
    fCurrentPoints = runBuffer.points();
 
    if (runBuffer.utf8text && fUtf8Text) {
        memcpy(runBuffer.utf8text, fUtf8Text + info.utf8Range.begin(), utf8RangeSize);
    }
    fClusters = runBuffer.clusters;
    fGlyphCount = glyphCount;
    fClusterOffset = info.utf8Range.begin();
 
    return {runBuffer.glyphs,
            runBuffer.points(),
            nullptr,
            runBuffer.clusters,
            fCurrentPosition};
}

runInfo()

void RunHandler::runInfo ( const RunInfo &  info )

pure virtual

Called once for each run in a line. Can compute baselines and offsets.

Implemented in SkTextBlobBuilderRunHandler, and SkShaperJSONWriter.

Definition at line 142 of file shape.cpp.

                                                              {
    SkFontMetrics metrics;
    info.fFont.getMetrics(&metrics);
    fMaxRunAscent = std::min(fMaxRunAscent, metrics.fAscent);
    fMaxRunDescent = std::max(fMaxRunDescent, metrics.fDescent);
    fMaxRunLeading = std::max(fMaxRunLeading, metrics.fLeading);
}

---

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

• third_party/skia/modules/skshaper/include/SkShaper.h
• third_party/skia/modules/skplaintexteditor/src/shape.cpp