Man page - fcft_kerning(3)

Packages contains this manual

Package:  libfcft-doc
apt-get install libfcft-doc

Manuals in package:
• fcft_log_init(3)
• fcft_font_options_create(3)
• fcft_init(3)
• fcft_set_scaling_filter(3)
• fcft_kerning(3)
• fcft_rasterize_char_utf32(3)
• fcft_font_options_destroy(3)
• fcft_precompose(3)
• fcft_rasterize_text_run_utf32(3)
• fcft_set_emoji_presentation(3)
• fcft_capabilities(3)
• fcft_clone(3)
• fcft_rasterize_grapheme_utf32(3)
• fcft_from_name2(3)
• fcft_destroy(3)
• fcft_fini(3)
• fcft_from_name(3)
• fcft_text_run_destroy(3)
Documentations in package:
• libfcft-doc

Manual

fcft_kerning

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
EXAMPLE

---

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 ()

---