blob: b2e77f9a0f1bff060584e3d97400ad8b4b116a4c [file] [log] [blame]
* Copyright 2018 The Android Open Source Project
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
#ifndef SkGlyphRun_DEFINED
#define SkGlyphRun_DEFINED
#include <functional>
#include <vector>
#include "include/core/SkFont.h"
#include "include/core/SkPaint.h"
#include "include/core/SkPoint.h"
#include "include/core/SkRSXform.h"
#include "include/core/SkSpan.h"
#include "include/core/SkTypes.h"
#include "include/private/SkTemplates.h"
#include "src/core/SkZip.h"
class SkBaseDevice;
class SkGlyph;
class SkTextBlob;
class SkTextBlobRunIterator;
class SkGlyphRun {
SkGlyphRun() = default;
SkGlyphRun(const SkFont& font,
SkSpan<const SkPoint> positions,
SkSpan<const SkGlyphID> glyphIDs,
SkSpan<const char> text,
SkSpan<const uint32_t> clusters,
SkSpan<const SkVector> scaledRotations);
SkGlyphRun(const SkGlyphRun& glyphRun, const SkFont& font);
size_t runSize() const { return fSource.size(); }
SkSpan<const SkPoint> positions() const { return fSource.get<1>(); }
SkSpan<const SkGlyphID> glyphsIDs() const { return fSource.get<0>(); }
SkZip<const SkGlyphID, const SkPoint> source() const { return fSource; }
const SkFont& font() const { return fFont; }
SkSpan<const uint32_t> clusters() const { return fClusters; }
SkSpan<const char> text() const { return fText; }
SkSpan<const SkVector> scaledRotations() const { return fScaledRotations; }
SkRect sourceBounds(const SkPaint& paint) const;
// GlyphIDs and positions.
const SkZip<const SkGlyphID, const SkPoint> fSource;
// Original text from SkTextBlob if present. Will be empty of not present.
const SkSpan<const char> fText;
// Original clusters from SkTextBlob if present. Will be empty if not present.
const SkSpan<const uint32_t> fClusters;
// Possible RSXForm information
const SkSpan<const SkVector> fScaledRotations;
// Font for this run modified to have glyph encoding and left alignment.
SkFont fFont;
class SkGlyphRunList {
SkSpan<const SkGlyphRun> fGlyphRuns;
// Blob maybe null.
const SkTextBlob* blob,
SkRect bounds,
SkPoint origin,
SkSpan<const SkGlyphRun> glyphRunList);
SkGlyphRunList(const SkGlyphRun& glyphRun, const SkRect& bounds, SkPoint origin);
uint64_t uniqueID() const;
bool anyRunsLCD() const;
void temporaryShuntBlobNotifyAddedToCache(uint32_t cacheID) const;
bool canCache() const { return fOriginalTextBlob != nullptr; }
size_t runCount() const { return fGlyphRuns.size(); }
size_t totalGlyphCount() const {
size_t glyphCount = 0;
for (const SkGlyphRun& run : *this) {
glyphCount += run.runSize();
return glyphCount;
bool hasRSXForm() const {
for (const SkGlyphRun& run : *this) {
if (!run.scaledRotations().empty()) { return true; }
return false;
sk_sp<SkTextBlob> makeBlob() const;
SkPoint origin() const { return fOrigin; }
SkRect sourceBounds() const { return fSourceBounds; }
const SkTextBlob* blob() const { return fOriginalTextBlob; }
auto begin() -> decltype(fGlyphRuns.begin()) { return fGlyphRuns.begin(); }
auto end() -> decltype(fGlyphRuns.end()) { return fGlyphRuns.end(); }
auto begin() const -> decltype(std::cbegin(fGlyphRuns)) { return std::cbegin(fGlyphRuns); }
auto end() const -> decltype(std::cend(fGlyphRuns)) { return std::cend(fGlyphRuns); }
auto size() const -> decltype(fGlyphRuns.size()) { return fGlyphRuns.size(); }
auto empty() const -> decltype(fGlyphRuns.empty()) { return fGlyphRuns.empty(); }
auto operator [] (size_t i) const -> decltype(fGlyphRuns[i]) { return fGlyphRuns[i]; }
// The text blob is needed to hookup the call back that the SkTextBlob destructor calls. It
// should be used for nothing else
const SkTextBlob* fOriginalTextBlob{nullptr};
const SkRect fSourceBounds{SkRect::MakeEmpty()};
const SkPoint fOrigin = {0, 0};
class SkGlyphRunBuilder {
const SkGlyphRunList& textToGlyphRunList(const SkFont& font,
const SkPaint& paint,
const void* bytes,
size_t byteLength,
SkPoint origin,
SkTextEncoding encoding = SkTextEncoding::kUTF8);
const SkGlyphRunList& blobToGlyphRunList(const SkTextBlob& blob, SkPoint origin);
std::tuple<SkSpan<const SkPoint>, SkSpan<const SkVector>>
convertRSXForm(SkSpan<const SkRSXform> xforms);
bool empty() const { return fGlyphRunListStorage.empty(); }
void initialize(const SkTextBlob& blob);
void prepareBuffers(int positionCount, int RSXFormCount);
SkSpan<const SkGlyphID> textToGlyphIDs(
const SkFont& font, const void* bytes, size_t byteLength, SkTextEncoding);
void makeGlyphRun(
const SkFont& font,
SkSpan<const SkGlyphID> glyphIDs,
SkSpan<const SkPoint> positions,
SkSpan<const char> text,
SkSpan<const uint32_t> clusters,
SkSpan<const SkVector> scaledRotations);
const SkGlyphRunList& makeGlyphRunList(
const SkTextBlob* blob, const SkRect& bounds, SkPoint origin);
int fMaxTotalRunSize{0};
SkAutoTMalloc<SkPoint> fPositions;
int fMaxScaledRotations{0};
SkAutoTMalloc<SkVector> fScaledRotations;
std::vector<SkGlyphRun> fGlyphRunListStorage;
SkGlyphRunList fGlyphRunList;
// Used as a temporary for preparing using utfN text. This implies that only one run of
// glyph ids will ever be needed because blobs are already glyph based.
std::vector<SkGlyphID> fScratchGlyphIDs;
#endif // SkGlyphRun_DEFINED