2020-05-29 15:57:22 +02:00
|
|
|
```c
|
|
|
|
stbtt_InitFont
|
|
|
|
|
|
|
|
stbtt_ScaleForMappingEmToPixels x 3
|
|
|
|
stbtt_ScaleForPixelHeight
|
|
|
|
stbtt_BakeFontBitmap
|
|
|
|
stbtt_GetFontVMetrics x 2
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
unsigned short x0, y0, x1, y1; // coordinates of bbox in bitmap
|
|
|
|
float xoff, yoff, xadvance;
|
|
|
|
} stbtt_bakedchar;
|
|
|
|
|
|
|
|
struct RenImage {
|
|
|
|
RenColor *pixels;
|
|
|
|
int width, height;
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
RenImage *image;
|
|
|
|
stbtt_bakedchar glyphs[256];
|
|
|
|
} GlyphSet;
|
|
|
|
|
|
|
|
struct RenFont {
|
|
|
|
void *data;
|
|
|
|
stbtt_fontinfo stbfont;
|
|
|
|
GlyphSet *sets[MAX_GLYPHSET];
|
|
|
|
float size;
|
|
|
|
int height;
|
|
|
|
};
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
The function stbtt_BakeFontBitmap is used to write bitmap data into set->image->pixels (where set is a GlyphSet).
|
|
|
|
Note that set->image->pixels need data in RGB format. After stbtt_BakeFontBitmap call the bitmap data are converted into RGB.
|
|
|
|
With a single call many glyphs corresponding to a range of codepoints, all in a
|
|
|
|
single image.
|
|
|
|
|
|
|
|
## STB truetype font metrics
|
|
|
|
|
|
|
|
stbtt_ScaleForPixelHeight takes a float 'height' and returns height / (ascent - descent).
|
|
|
|
|
|
|
|
stbtt_ScaleForMappingEmToPixels take a float 'pixels' and returns pixels / unitsPerEm.
|
|
|
|
|
|
|
|
### Computing RenFont
|
|
|
|
|
|
|
|
When loading a font, in renderer.c, the font->height is determined as:
|
|
|
|
|
|
|
|
```c
|
|
|
|
int ascent, descent, linegap;
|
|
|
|
stbtt_GetFontVMetrics(&font->stbfont, &ascent, &descent, &linegap);
|
|
|
|
float scale = stbtt_ScaleForMappingEmToPixels(&font->stbfont, font->size);
|
|
|
|
font->height = (ascent - descent + linegap) * scale + 0.5;
|
|
|
|
```
|
|
|
|
|
|
|
|
so, mathematically
|
|
|
|
|
|
|
|
```c
|
|
|
|
font->height = (ascent - descent + linegap) * font->size / unitsPerEm + 0.5;
|
|
|
|
```
|
|
|
|
|
|
|
|
**TO DO**: find out for what font->height is actually used.
|
|
|
|
|
|
|
|
### Call to BakeFontBitmap
|
|
|
|
|
|
|
|
In the same file, renderer.c, to create the glyphset image it computes:
|
|
|
|
|
|
|
|
```c
|
|
|
|
// Using stbtt functions
|
|
|
|
float s = ScaleForMappingEmToPixels(1) / ScaleForPixelHeight(1);
|
|
|
|
```
|
|
|
|
|
|
|
|
so 's' is actually equal to (ascent - descent) / unitsPerEm.
|
|
|
|
|
|
|
|
Then BakeFontBitmap is called and `font->size * s` is used for the pixel_height argument.
|
2020-05-30 15:19:33 +02:00
|
|
|
So BakeFontBitmap gets
|
|
|
|
|
|
|
|
```c
|
|
|
|
pixel_height = (ascent - descent) * font->size / unitsPerEm;
|
|
|
|
```
|
|
|
|
|
2020-05-30 20:01:37 +02:00
|
|
|
In turns BakeFontBitmap passes pixel_height to ScaleForPixelHeight() and uses the
|
|
|
|
resulting 'scale' to scale the glyphs by passing it to MakeGlyphBitmap().
|
|
|
|
|
2020-05-29 15:57:22 +02:00
|
|
|
This is equal almost equal to font->height except the 0.5, the missing linegap calculation
|
|
|
|
and the fact that this latter is an integer instead of a float.
|
2020-05-30 15:19:33 +02:00
|
|
|
|
|
|
|
## AGG Font Engine
|
|
|
|
|
|
|
|
Calls
|
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
`FT_Init_FreeType` (initialize the library)
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
In `load_font()` method:
|
|
|
|
`FT_New_Face` or `FT_New_Memory_Face` (use `FT_Done_Face` when done)
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
`FT_Attach_File`
|
|
|
|
`FT_Select_Charmap`
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
In `update_char_size()` method:
|
|
|
|
`FT_Set_Char_Size` or `FT_Set_Pixel_Sizes`
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
In `prepare_glyph()` method:
|
|
|
|
`FT_Get_Char_Index`
|
|
|
|
`FT_Load_Glyph`
|
|
|
|
`FT_Render_Glyph` (if glyph_render_native_mono or native_gray8)
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
in `add_kerning()` method
|
|
|
|
`FT_Get_Kerning`
|
2020-05-30 15:19:33 +02:00
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
`FT_Done_FreeType` (end with library)
|
2020-05-30 15:19:33 +02:00
|
|
|
|
|
|
|
## Freetype2's metrics related function and structs
|
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
`FT_New_Face` return a `FT_Face` (a pointer) with font face information.
|
2020-05-30 18:07:40 +02:00
|
|
|
|
|
|
|
## AGG font engine's font size
|
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
The variable `m_height` is the size of the font muliplied by 64.
|
2020-05-30 18:07:40 +02:00
|
|
|
It will be used to set font size with:
|
|
|
|
|
2021-02-23 16:15:36 +01:00
|
|
|
- `FT_Set_Char_Size` if m_resolution is set (> 0)
|
|
|
|
- `FT_Set_Pixel_Sizes`, divided by 64, if m_resolution is not set (= 0)
|
2020-05-30 18:07:40 +02:00
|
|
|
|
|
|
|
The method height() returns m_height / 64;
|