diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-17 05:38:26 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | d3742ddf2b3a85eb3935cb35e958fa27f1293a6b (patch) | |
| tree | b47dce7b82e72673432f6c8746517386c67ab742 /src/gui/font.c | |
| parent | b65048ac19f9f47b6faa21d1a9f3d06ba3ff1a95 (diff) | |
| parent | 81c4157b6731ee64a7bf9194c5df0818e2977f5d (diff) | |
| download | pardes-d3742ddf2b3a85eb3935cb35e958fa27f1293a6b.tar.gz pardes-d3742ddf2b3a85eb3935cb35e958fa27f1293a6b.zip | |
integration: the GPU move whole, with the terminal a module of its own, the plumber and the diff work
A merge of pardes-next (uoqyunnw) and gpu-s4b (zxswllzu). One conflict, build.zig: core-test's root is the core without a terminal AND the Cells and Atlas tests join the unit suite; gui.zig merged by itself and is formatted (two role casts spelled as zig fmt spells them, two blank lines). Gated against a baseline recorded from pardes-next with the gate's test hooks and the renderer still in gui.zig (.scratch/sketch/gpu/mbase): frame corpus 77/77 identical in Debug and in ReleaseFast, the gated window -0.032% instructions (threshold 0.5%), unit-test on gui 1583/1591 with no failure the baseline has not, every GPU counter 0; on tui core-test 810/949 (139 skipped), shell-test 989/992, behaviour-test 269/273 (the four addon ABI tests the base fails).
Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'src/gui/font.c')
| -rw-r--r-- | src/gui/font.c | 471 |
1 files changed, 0 insertions, 471 deletions
diff --git a/src/gui/font.c b/src/gui/font.c deleted file mode 100644 index aebe26e6..00000000 --- a/src/gui/font.c +++ /dev/null @@ -1,471 +0,0 @@ -// FreeType and HarfBuzz wrapper for gui.zig. The policy intentionally follows -// Ghostty's FreeType backend: native hinting enabled, the auto-hinter available -// as a fallback, and the light target for shape-preserving grayscale text. -// HarfBuzz only picks glyphs (liga, calt); the grid, not the font's advances, -// places them. -#include "font.h" -#include <freetype-zig.h> -#include <freetype/ftbitmap.h> -#include <freetype/ftmodapi.h> -#include <hb-ft.h> -#include <hb-ot.h> -#include <hb.h> - -#include <string.h> - -struct UIFont { - // FreeType allocates through ui_malloc and friends: the library holds a - // pointer to this for its lifetime, which the UIFont outlives. - struct FT_MemoryRec_ memory; - FT_Library library; - FT_Face face; - FT_F26Dot6 size; - // The charmap's answer for ASCII, which is most of every screen: a word the - // renderer has not seen before looks up each of its cells. - uint32_t ascii[128]; - // HarfBuzz state, made by the first ui_font_substitutes question (most - // fallback faces are never asked). - hb_font_t *hb; - hb_buffer_t *buffer; - FT_F26Dot6 hb_size; - // Every glyph a lookup of a ligature feature could replace. Nothing else - // can change a glyph, so a cell outside it is its nominal glyph without - // shaping: every cell, in a font without ligatures. - hb_set_t *substitutes; - // ui_font_shape's per-cell scratch, grown to the longest run seen - uint32_t *own; - uint8_t *state; - int32_t scratch; -}; - -static FT_F26Dot6 size_26_6(float px) { - if (px < 1.0f) - px = 1.0f; - return (FT_F26Dot6)(px * 64.0f + 0.5f); -} - -static int set_size(UIFont *f, float px) { - const FT_F26Dot6 size = size_26_6(px); - if (f->size == size) - return 1; - if (FT_Set_Char_Size(f->face, 0, size, 72, 72) != 0) - return 0; - f->size = size; - return 1; -} - -static int ceil_26_6(FT_Pos value) { return (int)((value + 63) >> 6); } - -static FT_Int32 load_flags(void) { - // Hinting is on because FT_LOAD_NO_HINTING is absent. Likewise, leaving - // FT_LOAD_NO_AUTOHINT absent lets FreeType fall back to its auto-hinter - // when the face has no native instructions. This is Ghostty's default. - return FT_LOAD_DEFAULT | FT_LOAD_TARGET_LIGHT; -} - -static void *ft_alloc(FT_Memory memory, long size) { - (void)memory; - return ui_malloc((size_t)size); -} - -static void ft_free(FT_Memory memory, void *block) { - (void)memory; - ui_free(block); -} - -static void *ft_realloc(FT_Memory memory, long cur_size, long new_size, - void *block) { - (void)memory; - (void)cur_size; - return ui_realloc(block, (size_t)new_size); -} - -UIFont *ui_font_new(const uint8_t *data, int32_t len) { - if (!data || len <= 0) - return NULL; - - UIFont *f = (UIFont *)ui_calloc(1, sizeof(UIFont)); - if (!f) - return NULL; - // FT_Init_FreeType is exactly FT_New_Library over FT_New_Memory's malloc - // manager, then the default modules and properties: the same, over ours. - f->memory = (struct FT_MemoryRec_){NULL, ft_alloc, ft_free, ft_realloc}; - if (FT_New_Library(&f->memory, &f->library) != 0) { - ui_free(f); - return NULL; - } - FT_Add_Default_Modules(f->library); - FT_Set_Default_Properties(f->library); - if (FT_New_Memory_Face(f->library, data, (FT_Long)len, 0, &f->face) != 0) { - FT_Done_Library(f->library); - ui_free(f); - return NULL; - } - // Some symbol fonts do not expose a Unicode charmap. FreeType already - // selects a usable default for those, so failure here is non-fatal. - (void)FT_Select_Charmap(f->face, FT_ENCODING_UNICODE); - for (uint32_t cp = 0; cp < 128; cp++) - f->ascii[cp] = FT_Get_Char_Index(f->face, cp); - return f; -} - -// HarfBuzz reads this same face (and its charmap) through FreeType, so shaping -// and rasterizing agree on glyph ids. None of these calls returns NULL: a -// failure is an inert empty object, and shaping then yields nominal glyphs. -static void start_harfbuzz(UIFont *f) { - f->hb = hb_ft_font_create_referenced(f->face); - f->buffer = hb_buffer_create(); - f->substitutes = hb_set_create(); - static const hb_tag_t features[] = { - HB_TAG('l', 'i', 'g', 'a'), HB_TAG('c', 'a', 'l', 't'), - HB_TAG('c', 'l', 'i', 'g'), HB_TAG('r', 'l', 'i', 'g'), - HB_TAG('r', 'c', 'l', 't'), HB_TAG_NONE}; - hb_face_t *face = hb_font_get_face(f->hb); - hb_set_t *lookups = hb_set_create(); - hb_ot_layout_collect_lookups(face, HB_OT_TAG_GSUB, NULL, NULL, features, - lookups); - hb_codepoint_t lookup = HB_SET_VALUE_INVALID; - while (hb_set_next(lookups, &lookup)) - hb_ot_layout_lookup_collect_glyphs(face, HB_OT_TAG_GSUB, lookup, NULL, - f->substitutes, NULL, NULL); - hb_set_destroy(lookups); -} - -const char *ui_font_name(UIFont *f) { - if (!f || !f->face) - return NULL; - const char *postscript = FT_Get_Postscript_Name(f->face); - if (postscript && postscript[0]) - return postscript; - if (f->face->family_name && f->face->family_name[0]) - return f->face->family_name; - return NULL; -} - -uint32_t ui_font_glyph(UIFont *f, int32_t cp) { - if (!f || cp < 0) - return 0; - if (cp < 128) - return f->ascii[cp]; - return FT_Get_Char_Index(f->face, (FT_ULong)(uint32_t)cp); -} - -void ui_font_free(UIFont *f) { - if (!f) - return; - // The HarfBuzz font holds a reference on the face: release it first. (All - // three accept NULL, a face that never shaped.) - hb_set_destroy(f->substitutes); - hb_buffer_destroy(f->buffer); - hb_font_destroy(f->hb); - if (f->face) - FT_Done_Face(f->face); - if (f->library) - FT_Done_Library(f->library); - ui_free(f->own); - ui_free(f->state); - ui_free(f); -} - -void ui_font_prime(UIFont *f) { - if (!f) - return; - hb_font_destroy(hb_ft_font_create_referenced(f->face)); - hb_buffer_t *buffer = hb_buffer_create(); - hb_buffer_add_utf8(buffer, "a", 1, 0, 1); - hb_buffer_guess_segment_properties(buffer); - hb_buffer_destroy(buffer); -} - -void ui_font_cell_metrics(UIFont *f, float px, int32_t *cell_w, int32_t *cell_h, - int32_t *ascent) { - if (!f || !cell_w || !cell_h || !ascent || !set_size(f, px)) { - if (cell_w) - *cell_w = 1; - if (cell_h) - *cell_h = 1; - if (ascent) - *ascent = 1; - return; - } - - const FT_Size_Metrics metrics = f->face->size->metrics; - const int asc = ceil_26_6(metrics.ascender); - const int desc = ceil_26_6(-metrics.descender); - int height = ceil_26_6(metrics.height); - if (height < asc + desc) - height = asc + desc; - - int width = ceil_26_6(metrics.max_advance); - const FT_UInt m = FT_Get_Char_Index(f->face, 'M'); - if (FT_Load_Glyph(f->face, m, load_flags()) == 0) { - const int advance = ceil_26_6(f->face->glyph->advance.x); - if (advance > 0) - width = advance; - } - - *cell_w = width > 0 ? width : 1; - *cell_h = height > 0 ? height : 1; - *ascent = asc > 0 ? asc : 1; -} - -static int raster(UIFont *f, float px, uint32_t glyph_index, int bold, - uint8_t *out, int32_t stride, int32_t width, int32_t height, - int32_t cell_x, int32_t cell_w, int32_t ascent, - int centered) { - if (!f || !out || stride < width || width <= 0 || height <= 0) - return 0; - for (int y = 0; y < height; y++) - memset(out + (size_t)y * (size_t)stride, 0, (size_t)width); - if (!set_size(f, px)) - return 0; - - if (FT_Load_Glyph(f->face, glyph_index, load_flags()) != 0) - return 0; - if (bold) { - // Synthetic bold thickens the hinted outline before it is rendered, so - // the wider stems are rasterized as one shape and keep hinted edges; the - // advance is untouched, as the cell grid requires. Strength is Ghostty's - // heuristic: 1/32 of the line height in 26.6, rounded up (one pixel at a - // 32 px line). A bitmap strike has no outline: widen it by one whole pixel, - // the classic overstrike, which keeps its pixels sharp. - FT_GlyphSlot slot = f->face->glyph; - if (slot->format == FT_GLYPH_FORMAT_OUTLINE) { - const FT_Pos height = f->face->size->metrics.height; - FT_Outline_Embolden(&slot->outline, (height + 31) / 32); - } else if (slot->format == FT_GLYPH_FORMAT_BITMAP && - FT_GlyphSlot_Own_Bitmap(slot) == 0) { - FT_Bitmap_Embolden(f->library, &slot->bitmap, 64, 0); - } - } - if (FT_Render_Glyph(f->face->glyph, FT_RENDER_MODE_NORMAL) != 0) - return 0; - - const FT_GlyphSlot glyph = f->face->glyph; - const FT_Bitmap *bitmap = &glyph->bitmap; - if (!bitmap->buffer || bitmap->width == 0 || bitmap->rows == 0) - return 0; - - const int advance = ceil_26_6(glyph->advance.x); - // Fallbacks may be proportional. Center their advance in the primary face's - // fixed cell, exactly as Ghostty centers a narrower fallback face. - const int gx = centered - ? (width - (int)bitmap->width) / 2 - : cell_x + glyph->bitmap_left + (cell_w - advance) / 2; - const int gy = - centered ? (height - (int)bitmap->rows) / 2 : ascent - glyph->bitmap_top; - const int pitch = bitmap->pitch; - const int row_bytes = pitch < 0 ? -pitch : pitch; - - for (unsigned int y = 0; y < bitmap->rows; y++) { - const int dy = gy + (int)y; - if (dy < 0 || dy >= height) - continue; - const unsigned int source_y = pitch < 0 ? bitmap->rows - 1 - y : y; - const uint8_t *src = bitmap->buffer + (size_t)source_y * (size_t)row_bytes; - - for (unsigned int x = 0; x < bitmap->width; x++) { - const int dx = gx + (int)x; - if (dx < 0 || dx >= width) - continue; - - uint8_t coverage; - if (bitmap->pixel_mode == FT_PIXEL_MODE_MONO) { - coverage = (src[x >> 3] & (0x80u >> (x & 7))) ? 255 : 0; - } else if (bitmap->pixel_mode == FT_PIXEL_MODE_GRAY) { - coverage = src[x]; - if (bitmap->num_grays > 1 && bitmap->num_grays != 256) - coverage = (uint8_t)((unsigned int)coverage * 255u / - (bitmap->num_grays - 1u)); - } else { - continue; - } - out[(size_t)dy * (size_t)stride + (size_t)dx] = coverage; - } - } - return 1; -} - -int ui_font_raster(UIFont *f, float px, uint32_t glyph, int bold, uint8_t *out, - int32_t stride, int32_t width, int32_t height, - int32_t cell_x, int32_t cell_w, int32_t ascent) { - return raster(f, px, glyph, bold, out, stride, width, height, cell_x, cell_w, - ascent, 0); -} - -int ui_font_raster_centered(UIFont *f, float px, uint32_t glyph, int bold, - uint8_t *out, int32_t stride, int32_t width, - int32_t height) { - return raster(f, px, glyph, bold, out, stride, width, height, 0, width, 0, 1); -} - -// The horizontal ink of `glyph` placed as ui_font_raster places it in a cell -// `cell` wide (26.6), relative to the cell's left edge. 0 when it has no ink. -static int ink(UIFont *f, uint32_t glyph, FT_Pos cell, FT_Pos *left, - FT_Pos *right) { - if (FT_Load_Glyph(f->face, glyph, load_flags()) != 0) - return 0; - const FT_GlyphSlot slot = f->face->glyph; - if (slot->metrics.width <= 0 || slot->metrics.height <= 0) - return 0; - const FT_Pos origin = - (FT_Pos)(((int)(cell >> 6) - ceil_26_6(slot->advance.x)) / 2) * 64; - *left = origin + slot->metrics.horiBearingX; - *right = *left + slot->metrics.width; - return 1; -} - -// ui_font_shape's per-cell marks: no glyph of its own, keep the nominal glyph, -// drawn as a slice of another cell's glyph. -#define NONE UINT32_MAX -#define PLAIN 1 -#define CLAIMED 2 - -int ui_font_substitutes(UIFont *f, uint32_t glyph) { - if (!f) - return 0; - if (!f->hb) - start_harfbuzz(f); - return hb_set_has(f->substitutes, glyph); -} - -// The GSUB features shaping leaves on are the ligature ones; the others -// HarfBuzz would apply (glyph composition, local forms, fractions around -// U+2044, ...) are off, so a cell is either its nominal glyph, as the renderer -// always drew it, or part of a ligature. Positioning is untouched: the grid -// ignores advances and keeps nominal glyphs where marks would move. -static const hb_feature_t shaping_features[] = { - {HB_TAG('c', 'c', 'm', 'p'), 0, 0, (unsigned int)-1}, - {HB_TAG('l', 'o', 'c', 'l'), 0, 0, (unsigned int)-1}, - {HB_TAG('r', 'v', 'r', 'n'), 0, 0, (unsigned int)-1}, - {HB_TAG('l', 't', 'r', 'a'), 0, 0, (unsigned int)-1}, - {HB_TAG('l', 't', 'r', 'm'), 0, 0, (unsigned int)-1}, - {HB_TAG('r', 'a', 'n', 'd'), 0, 0, (unsigned int)-1}, - {HB_TAG('f', 'r', 'a', 'c'), 0, 0, (unsigned int)-1}, - {HB_TAG('n', 'u', 'm', 'r'), 0, 0, (unsigned int)-1}, - {HB_TAG('d', 'n', 'o', 'm'), 0, 0, (unsigned int)-1}, -}; - -void ui_font_shape(UIFont *f, float px, int32_t cell_w, const uint32_t *cps, - int32_t n, UIShapedCell *out) { - if (!f || !cps || !out || n <= 0) - return; - for (int32_t i = 0; i < n; i++) - out[i] = (UIShapedCell){ui_font_glyph(f, (int32_t)cps[i]), 0, 1, 0}; - if (!f->hb) - start_harfbuzz(f); - int substitutable = 0; - for (int32_t i = 0; i < n && !substitutable; i++) - substitutable = hb_set_has(f->substitutes, out[i].glyph); - if (!substitutable || cell_w <= 0 || !set_size(f, px)) - return; - if (n > f->scratch) { - uint32_t *own = (uint32_t *)ui_realloc(f->own, (size_t)n * sizeof *own); - if (!own) - return; - f->own = own; - uint8_t *state = (uint8_t *)ui_realloc(f->state, (size_t)n); - if (!state) - return; - f->state = state; - f->scratch = n; - } - // hb-ft reads the FreeType size when told; positions are only consulted - // for being nonzero, but a zero scale would hide exactly that. - if (f->hb_size != f->size) { - hb_ft_font_changed(f->hb); - f->hb_size = f->size; - } - hb_buffer_clear_contents(f->buffer); - // One codepoint per cell, so a cluster value IS a cell index. - hb_buffer_add_codepoints(f->buffer, cps, n, 0, n); - hb_buffer_set_direction(f->buffer, HB_DIRECTION_LTR); - hb_buffer_guess_segment_properties(f->buffer); - hb_shape(f->hb, f->buffer, shaping_features, - sizeof shaping_features / sizeof shaping_features[0]); - unsigned int count = 0; - const hb_glyph_info_t *info = hb_buffer_get_glyph_infos(f->buffer, &count); - const hb_glyph_position_t *pos = - hb_buffer_get_glyph_positions(f->buffer, &count); - - // Each cell's own glyph is the one HarfBuzz left in its cluster. A cell a - // ligature merged into an earlier cluster has NONE. A cluster the grid - // cannot place (several glyphs, a positioned mark) is PLAIN, and so are the - // cells merged into it: they keep their nominal glyphs. - uint32_t *own = f->own; - uint8_t *state = f->state; - for (int32_t i = 0; i < n; i++) { - own[i] = NONE; - state[i] = 0; - } - for (unsigned int k = 0; k < count; k++) { - const uint32_t cluster = info[k].cluster; - if (cluster >= (uint32_t)n) - continue; - if (own[cluster] != NONE || pos[k].x_offset != 0 || pos[k].y_offset != 0) - state[cluster] = PLAIN; - else - own[cluster] = info[k].codepoint; - } - for (int32_t i = 1; i < n; i++) - if (own[i] == NONE && (state[i - 1] & PLAIN)) - state[i] = PLAIN; - - // A substituted glyph (or one whose cluster swallowed cells) may reach over - // its neighbours: it claims those that draw nothing of their own, nearest - // first, and each draws its slice of the one strip. Ink past a cell edge by - // half a pixel or less is noise. - const FT_Pos cell = (FT_Pos)cell_w * 64; - for (int32_t i = 0; i < n; i++) { - if ((state[i] & (PLAIN | CLAIMED)) || own[i] == NONE) - continue; - int32_t merged = 0; - while (i + 1 + merged < n && own[i + 1 + merged] == NONE && - !(state[i + 1 + merged] & PLAIN)) - merged++; - if (own[i] == out[i].glyph && merged == 0) - continue; - FT_Pos left = 0, right = 0; - if (!ink(f, own[i], cell, &left, &right)) - continue; // a spacer: claimed, never claiming - int32_t want_left = - left < -32 ? (int32_t)((-left - 32 + cell - 1) / cell) : 0; - int32_t want_right = right > cell + 32 - ? (int32_t)((right - cell - 32 + cell - 1) / cell) - : 0; - if (want_right < merged) - want_right = merged; - int32_t lead = 0, trail = 0; - while (lead < want_left && 1 + lead + trail < UI_MAX_SPAN) { - const int32_t j = i - lead - 1; - FT_Pos l, r; - if (j < 0 || (state[j] & (PLAIN | CLAIMED)) || - (own[j] != NONE && - (own[j] == out[j].glyph || ink(f, own[j], cell, &l, &r)))) - break; - lead++; - } - while (trail < want_right && 1 + lead + trail < UI_MAX_SPAN) { - const int32_t j = i + trail + 1; - FT_Pos l, r; - if (j >= n || (state[j] & (PLAIN | CLAIMED)) || - (own[j] != NONE && - (own[j] == out[j].glyph || ink(f, own[j], cell, &l, &r)))) - break; - trail++; - } - for (int32_t j = i - lead; j <= i + trail; j++) { - out[j] = - (UIShapedCell){own[i], (uint8_t)lead, (uint8_t)(1 + lead + trail), - (uint8_t)(j - (i - lead))}; - state[j] |= CLAIMED; - } - } - // The rest draw their own glyph; a merged cell nothing claimed draws blank. - const uint32_t space = f->ascii[' ']; - for (int32_t i = 0; i < n; i++) { - if (state[i] & (PLAIN | CLAIMED)) - continue; - out[i].glyph = own[i] == NONE ? space : own[i]; - } -} |
