NAME

fcft_kerning - calculate kerning distance between two wide characters

SYNOPSIS

#include <fcft/fcft.h>

bool fcft_kerning(

struct fcft_font *font, uint32_t left, uint32_t right, long *restrict x, long *restrict y);

DESCRIPTION

fcft_kerning() calculates the kerning distances x (horizontal) and y (vertical) between the two wide characters left and right, in pixels.

Both characters must exist in the primary font.

fcft_kerning() is just a convenience function around FT_Get_Kerning() and as such, it only supports legacy kern tables. In particular, OpenType fonts' GPOS tables are not supported. fcft is not a text shaping library.

RETURN VALUE

On success, fcft_kerning() returns true, and x and y are updated with the kerning distance, in pixels.

On error, false is returned. This may happen for several reasons:

•The primary font does not have any kerning information.

•One, or both, of the two characters have no corresponding glyph in the primary font.

•There is no kerning information for this character combination.

EXAMPLE

See fcft_from_name()