.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "fcft_set_scaling_filter" "3" "2025-01-02" "3.1.10" "fcft"
.PP
.SH NAME
.PP
fcft_set_scaling_filter - configures the filter to use when downscaling bitmap fonts
.PP
.SH SYNOPSIS
.PP
\fB#include <fcft/fcft.\&h>\fR
.PP
\fBbool fcft_set_scaling_filter(enum fcft_scaling_filter \fR\fIfilter\fR\fB);\fR
.PP
.SH DESCRIPTION
.PP
\fBfcft_set_scaling_filter\fR() configures the filter the use when
downscaling bitmap fonts (typically emoji fonts).\& The setting affects
\fBall\fR font instances.\&
.PP
This function does \fBnot\fR clear the glyph caches and should therefore be
called before any calls to \fBfcft_codepoint_rasterize\fR().\&
.PP
Possible values for \fIfilter\fR are:
.PP
.PD 0
.IP \(bu 4
\fBFCFT_SCALING_FILTER_NONE\fR
.IP \(bu 4
\fBFCFT_SCALING_FILTER_NEAREST\fR
.IP \(bu 4
\fBFCFT_SCALING_FILTER_BILINEAR\fR
.IP \(bu 4
\fBFCFT_SCALING_FILTER_CUBIC\fR
.IP \(bu 4
\fBFCFT_SCALING_FILTER_LANCZOS3\fR
.PD
.PP
\fBFCFT_SCALING_FILTER_NONE\fR disables filtering.\&
.PP
\fBFCFT_SCALING_FILTER_NEAREST\fR and
\fBFCFT_SCALING_FILTER_BILINEAR\fR are traditional filters, with
\fInearest\fR being the fastest.\&
.PP
\fBFCFT_SCALING_FILTER_CUBIC\fR and
\fBFCFT_SCALING_FILTER_LANCZOS3\fR are both examples of separable
convolution filters.\& \fICubic\fR is faster than \fIlanczos3\fR, but with
slightly worse result.\& However, both produce much better looking glyphs
than \fInearest\fR.\&
.PP
If this function is not called, fcft defaults to
\fBFCFT_SCALING_FILTER_CUBIC\fR.\&
.PP
.SH RETURN VALUE
.PP
On success, \fBfcft_set_scaling_filter\fR() returns true.\& On error, false
is returned.\&
.PP
.SH EXAMPLE
.PP
See \fBfcft_from_name\fR()