MayaFlux 0.4.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
GlyphAtlas.cpp
Go to the documentation of this file.
1#include "GlyphAtlas.hpp"
2
4
6
7GlyphAtlas::GlyphAtlas(FontFace& face, uint32_t pixel_size, uint32_t atlas_size)
8 : m_face(face)
9 , m_pixel_size(pixel_size)
10 , m_atlas_size(atlas_size)
11{
12 m_texture = std::make_unique<Kakshya::TextureContainer>(
14}
15
16const GlyphMetrics* GlyphAtlas::get_or_rasterize(FT_UInt glyph_index)
17{
18 auto it = m_cache.find(glyph_index);
19 if (it != m_cache.end()) {
20 return &it->second;
21 }
22
23 if (!rasterize(glyph_index)) {
24 return nullptr;
25 }
26
27 return &m_cache.at(glyph_index);
28}
29
31{
32 if (!m_face.is_loaded()) {
34 "GlyphAtlas::get_or_rasterize -- FontFace not loaded");
35 return nullptr;
36 }
37
38 const FT_UInt idx = FT_Get_Char_Index(m_face.get_face(), codepoint);
39 if (idx == 0) {
41 "GlyphAtlas: no glyph for codepoint U+{:04X}", static_cast<uint32_t>(codepoint));
42 return nullptr;
43 }
44
45 return get_or_rasterize(idx);
46}
47
48[[nodiscard]] uint32_t GlyphAtlas::line_height() const
49{
50 FT_Face face = m_face.get_face();
51 if (!face || face->size == nullptr) {
52 return m_pixel_size;
53 }
54 const int32_t h = (face->size->metrics.ascender - face->size->metrics.descender) >> 6;
55 return h > 0 ? static_cast<uint32_t>(h) : m_pixel_size;
56}
57
58bool GlyphAtlas::rasterize(FT_UInt glyph_index)
59{
60 FT_Face face = m_face.get_face();
61
62 if (const FT_Error err = FT_Set_Pixel_Sizes(face, 0, m_pixel_size); err != 0) {
64 "FT_Set_Pixel_Sizes({}) failed: {}", m_pixel_size, static_cast<int>(err));
65 return false;
66 }
67
68 if (const FT_Error err = FT_Load_Glyph(face, glyph_index, FT_LOAD_RENDER); err != 0) {
70 "FT_Load_Glyph({}) failed: {}", glyph_index, static_cast<int>(err));
71 return false;
72 }
73
74 const FT_Bitmap& bmp = face->glyph->bitmap;
75 const uint32_t gw = bmp.width;
76 const uint32_t gh = bmp.rows;
77
78 constexpr uint32_t k_pad = 1;
79
80 if (m_cursor_x + gw + k_pad > m_atlas_size) {
81 m_cursor_x = 0;
82 m_cursor_y += m_shelf_height + k_pad;
84 }
85
86 if (m_cursor_y + gh + k_pad > m_atlas_size) {
88 "GlyphAtlas full at pixel_size={} atlas_size={}. "
89 "Construct with a larger atlas_size.",
91 return false;
92 }
93
94 const std::span<uint8_t> pixels = m_texture->pixel_bytes(0);
95 if (pixels.empty()) {
97 "GlyphAtlas: TextureContainer pixel_bytes returned empty span");
98 return false;
99 }
100
101 const uint32_t stride = m_atlas_size;
102
103 for (uint32_t row = 0; row < gh; ++row) {
104 const uint8_t* src = bmp.buffer + static_cast<size_t>(row * static_cast<uint32_t>(std::abs(bmp.pitch)));
105 uint8_t* dst = pixels.data() + static_cast<size_t>((m_cursor_y + row) * stride) + m_cursor_x;
106 std::memcpy(dst, src, gw);
107 }
108
109 const float inv = 1.F / static_cast<float>(m_atlas_size);
110
111 GlyphMetrics m;
112 m.uv_x0 = static_cast<float>(m_cursor_x) * inv;
113 m.uv_y0 = static_cast<float>(m_cursor_y) * inv;
114 m.uv_x1 = static_cast<float>(m_cursor_x + gw) * inv;
115 m.uv_y1 = static_cast<float>(m_cursor_y + gh) * inv;
116 m.bearing_x = face->glyph->bitmap_left;
117 m.bearing_y = face->glyph->bitmap_top;
118 m.width = gw;
119 m.height = gh;
120 m.advance_x = static_cast<int32_t>(face->glyph->advance.x >> 6);
121
122 m_cache.emplace(glyph_index, m);
123
124 m_cursor_x += gw + k_pad;
125 if (gh > m_shelf_height) {
126 m_shelf_height = gh;
127 }
128
129 m_dirty = true;
130 return true;
131}
132
133} // namespace MayaFlux::Portal::Text
#define MF_ERROR(comp, ctx,...)
#define MF_WARN(comp, ctx,...)
uint32_t h
Definition InkPress.cpp:25
const std::vector< float > * pixels
FT_Face get_face() const
Raw FT_Face handle for use by GlyphAtlas.
Definition FontFace.hpp:59
bool is_loaded() const
Returns true after a successful load() call.
Definition FontFace.hpp:53
Owns a single FT_Face loaded from a file path.
Definition FontFace.hpp:26
std::unique_ptr< Kakshya::TextureContainer > m_texture
uint32_t line_height() const
Line advance in pixels for this atlas's pixel_size.
const GlyphMetrics * get_or_rasterize(FT_UInt glyph_index)
Return metrics for a glyph, rasterizing it into the atlas if needed.
bool rasterize(FT_UInt glyph_index)
std::unordered_map< FT_UInt, GlyphMetrics > m_cache
uint32_t atlas_size() const
Atlas texture dimension (width == height == atlas_size).
GlyphAtlas(FontFace &face, uint32_t pixel_size, uint32_t atlas_size=512)
Construct an atlas for a specific face and pixel size.
Definition GlyphAtlas.cpp:7
@ API
API calls from external code.
@ Portal
High-level user-facing API layer.
int32_t bearing_x
Horizontal bearing in pixels (from FT_GlyphSlot).
float uv_x0
Left UV edge in atlas texture.
float uv_x1
Right UV edge in atlas texture.
uint32_t height
Glyph bitmap height in pixels.
int32_t advance_x
Horizontal advance in pixels (26.6 fixed-point >> 6).
uint32_t width
Glyph bitmap width in pixels.
float uv_y0
Top UV edge in atlas texture.
int32_t bearing_y
Vertical bearing in pixels (from FT_GlyphSlot).
float uv_y1
Bottom UV edge in atlas texture.
Per-glyph layout and UV data produced by GlyphAtlas.