text_run_planner.hpp

Go to the documentation of this file.

// text_run_planner.hpp
//
// `TextRunPlanner` is the entry point that converts an input string +
// `FontOptions` into a `ShapedText` artifact. Both measurement and paint
// pipelines are intended to consume the same artifact, keeping text metrics,
// run segmentation, and cluster boundaries aligned across layout and rendering.
// The planner resolves the font cascade, splits text into bidi/script runs when
// ICU-backed SkShaper iterators are available, builds grapheme-cluster and
// Unicode index maps, and falls back to a single compatible run on non-Skia
// builds.
 
#pragma once
 
#include "pulp/canvas/font_options.hpp"
#include "pulp/canvas/shaped_text.hpp"
 
#include <memory>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
namespace pulp::canvas {
 
class TextRunPlanner {
public:
    static TextRunPlanner& instance();

    ShapedText shape(std::string_view text, const FontOptions& options);

    std::vector<ShapedText> shape_batch(
        const std::vector<std::pair<std::string, FontOptions>>& inputs);

    void clear_cache();
 
private:
    TextRunPlanner();
    ~TextRunPlanner();
    TextRunPlanner(const TextRunPlanner&) = delete;
    TextRunPlanner& operator=(const TextRunPlanner&) = delete;
 
    struct Impl;
    std::unique_ptr<Impl> impl_;
};
 
} // namespace pulp::canvas