1fcft_set_scaling_filter(3)           fcft           fcft_set_scaling_filter(3)
2
3
4

NAME

6       fcft_set_scaling_filter - configures the filter to use when downscaling
7       bitmap fonts
8

SYNOPSIS

10       #include <fcft/fcft.h>
11
12       bool fcft_set_scaling_filter(enum fcft_scaling_filter filter);
13

DESCRIPTION

15       fcft_set_scaling_filter() configures the filter the use when downscal‐
16       ing bitmap fonts (typically emoji fonts). The setting affects all font
17       instances.
18
19       This function does not clear the glyph caches and should therefore be
20       called before any calls to fcft_codepoint_rasterize().
21
22       Possible values for filter are:
23
24       •   FCFT_SCALING_FILTER_NONE
25       •   FCFT_SCALING_FILTER_NEAREST
26       •   FCFT_SCALING_FILTER_BILINEAR
27       •   FCFT_SCALING_FILTER_CUBIC
28       •   FCFT_SCALING_FILTER_LANCZOS3
29
30
31       FCFT_SCALING_FILTER_NONE disables filtering.
32
33       FCFT_SCALING_FILTER_NEAREST and FCFT_SCALING_FILTER_BILINEAR are tradi‐
34       tional filters, with nearest being the fastest.
35
36       FCFT_SCALING_FILTER_CUBIC and FCFT_SCALING_FILTER_LANCZOS3 are both ex‐
37       amples of separable convolution filters. Cubic is faster than lanczos3,
38       but with slightly worse result. However, both produce much better look‐
39       ing glyphs than nearest.
40
41       If this function is not called, fcft defaults to FCFT_SCALING_FIL‐
42       TER_CUBIC.
43

RETURN VALUE

45       On success, fcft_set_scaling_filter() returns true. On error, false is
46       returned.
47

EXAMPLE

49       See fcft_from_name()
50
51
52
533.1.5                             2022-09-20        fcft_set_scaling_filter(3)
Impressum