LDKTextSize

typedef LDKSizef LDKTextSize;

LDKFontFace

typedef struct LDKFontFace LDKFontFace;

LDKFontInstance

typedef struct LDKFontInstance LDKFontInstance;

LDKFontAtlasDesc

typedef struct LDKFontAtlasDesc{
  u16 page_width;
  u16 page_height;
  u16 padding;
}LDKFontAtlasDesc;

LDKFontMetrics

typedef struct LDKFontMetrics{
  float ascent;
  float descent;
  float line_gap;
  float line_height;
}LDKFontMetrics;

LDKGlyph

typedef struct LDKGlyph{
  u32 codepoint;
  u32 glyph_index;
  u16 page_index;
  u16 atlas_x0;
  u16 atlas_y0;
  u16 atlas_x1;
  u16 atlas_y1;
  i16 offset_x;
  i16 offset_y;
  i16 advance_x;
  bool valid;
}LDKGlyph;

LDKFontPageInfo

typedef struct LDKFontPageInfo{
  u32 page_index;
  u32 width;
  u32 height;
  u8 const *pixels;
  bool dirty;
}LDKFontPageInfo;

ldk_ttf_utf8_consume_codepoint

Consumes one UTF-8 codepoint and advances the input cursor.

LDK_API bool ldk_ttf_utf8_consume_codepoint(
 char const **cursor,
 u32 *out_codepoint
);

ldk_ttf_utf8_consume_codepoint_range

Consumes one UTF-8 codepoint within a bounded byte range and advances the input cursor.

LDK_API bool ldk_ttf_utf8_consume_codepoint_range(
 char const **cursor,
 char const *end,
 u32 *out_codepoint
);

ldk_ttf_face_create

Creates a font face from TrueType font data.

LDK_API LDKFontFace * ldk_ttf_face_create(
 void const *data,
 u32 data_size
);

ldk_ttf_face_destroy

Destroys a font face and all font instances created from it.

LDK_API void ldk_ttf_face_destroy(LDKFontFace *face);

ldk_ttf_get_instance

Gets or creates a font instance for a specific pixel height.

LDK_API LDKFontInstance * ldk_ttf_get_instance(
 LDKFontFace *face,
 float pixel_height,
 LDKFontAtlasDesc const *atlas_desc
);

ldk_ttf_get_pixel_height

Gets the pixel height used by a font instance.

LDK_API float ldk_ttf_get_pixel_height(LDKFontInstance const *instance);

ldk_ttf_get_metrics

Gets scaled font metrics for a font instance.

LDK_API LDKFontMetrics ldk_ttf_get_metrics(LDKFontInstance const *instance);

ldk_ttf_get_glyph

Gets a glyph, rasterizing and caching it if necessary.

LDK_API LDKGlyph const * ldk_ttf_get_glyph(
 LDKFontInstance *instance,
 u32 codepoint
);

ldk_ttf_get_kerning

Gets the horizontal kerning adjustment between two codepoints.

LDK_API float ldk_ttf_get_kerning(
 LDKFontInstance const *instance,
 u32 left_codepoint,
 u32 right_codepoint
);

ldk_ttf_preload_range

Preloads and caches all glyphs in an inclusive codepoint range.

LDK_API bool ldk_ttf_preload_range(
 LDKFontInstance *instance,
 u32 first_codepoint,
 u32 last_codepoint
);

ldk_ttf_preload_basic_ascii

Preloads printable basic ASCII glyphs.

LDK_API bool ldk_ttf_preload_basic_ascii(LDKFontInstance *instance);

ldk_ttf_get_page_count

Gets the number of atlas pages owned by a font instance.

LDK_API u32 ldk_ttf_get_page_count(LDKFontInstance const *instance);

ldk_ttf_get_page_info

Gets information for a font atlas page.

LDK_API bool ldk_ttf_get_page_info(
 LDKFontInstance const *instance,
 u32 page_index,
 LDKFontPageInfo *out_page
);

ldk_ttf_clear_page_dirty

Clears the dirty flag of an atlas page.

LDK_API void ldk_ttf_clear_page_dirty(
 LDKFontInstance *instance,
 u32 page_index
);

ldk_ttf_get_line_height

Gets the scaled line height for a font instance.

LDK_API float ldk_ttf_get_line_height(LDKFontInstance *instance);

ldk_ttf_measure_text_cstr

Measures a null-terminated UTF-8 string.

LDK_API LDKTextSize ldk_ttf_measure_text_cstr(
 LDKFontInstance *instance,
 char const *text
);

ldk_ttf_measure_text_cstrn

Measures a UTF-8 string with a byte limit.

LDK_API LDKTextSize ldk_ttf_measure_text_cstrn(
 LDKFontInstance *instance,
 char const *text,
 u32 byte_count
);

ldk_ttf_measure_text_cstr_wrapped

Measures a null-terminated UTF-8 string with word wrapping.

LDK_API LDKSizef ldk_ttf_measure_text_cstr_wrapped(
 LDKFontInstance *instance,
 char const *text,
 float max_width
);