1fcft_kerning(3)                      fcft                      fcft_kerning(3)
2
3
4

NAME

6       fcft_kerning - calculate kerning distance between two wide characters
7

SYNOPSIS

9       #include <fcft/fcft.h>
10
11       bool fcft_kerning(
12           struct fcft_font *font, uint32_t left, uint32_t right, long *re‐
13           strict x, long *restrict y);
14

DESCRIPTION

16       fcft_kerning() calculates the kerning distances x (horizontal) and y
17       (vertical) between the two wide characters left and right, in pixels.
18
19       Both characters must exist in the primary font.
20
21       fcft_kerning() is just a convenience function around FT_Get_Kerning()
22       and as such, it only supports legacy kern tables. In particular, Open‐
23       Type fonts' GPOS tables are not supported. fcft is not a text shaping
24       library.
25

RETURN VALUE

27       On success, fcft_kerning() returns true, and x and y are updated with
28       the kerning distance, in pixels.
29
30       On error, false is returned. This may happen for several reasons:
31
32       •   The primary font does not have any kerning information.
33       •   One, or both, of the two characters have no corresponding glyph in
34           the primary font.
35       •   There is no kerning information for this character combination.
36
37

EXAMPLE

39       See fcft_from_name()
40
41
42
433.1.5                             2022-09-20                   fcft_kerning(3)