---
name: "fcft_set_scaling_filter"
section: "3"
platform: "linux"
package: "fcft"
version: "3.3.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/fcft_set_scaling_filter"
---

# fcft\_set\_scaling\_filter(3)

configures the filter to use when downscaling bitmap fonts

## NAME

fcft\_set\_scaling\_filter - configures the filter to use when downscaling bitmap fonts

## SYNOPSIS

**#include \<fcft/fcft.h\>**

**bool fcft\_set\_scaling\_filter(enum fcft\_scaling\_filter** *filter***);**

## DESCRIPTION

**fcft\_set\_scaling\_filter**() configures the filter the use when downscaling bitmap fonts (typically emoji fonts). The setting affects **all** font instances.

This function does **not** clear the glyph caches and should therefore be called before any calls to **fcft\_codepoint\_rasterize**().

Possible values for *filter* are:

- •

  **FCFT\_SCALING\_FILTER\_NONE**

- •

  **FCFT\_SCALING\_FILTER\_NEAREST**

- •

  **FCFT\_SCALING\_FILTER\_BILINEAR**

- •

  **FCFT\_SCALING\_FILTER\_IMPULSE**

- •

  **FCFT\_SCALING\_FILTER\_BOX**

- •

  **FCFT\_SCALING\_FILTER\_LINEAR**

- •

  **FCFT\_SCALING\_FILTER\_CUBIC**

- •

  **FCFT\_SCALING\_FILTER\_GAUSSIAN**

- •

  **FCFT\_SCALING\_FILTER\_LANCZOS2**

- •

  **FCFT\_SCALING\_FILTER\_LANCZOS3**

- •

  **FCFT\_SCALING\_FILTER\_LANCZOS3\_STRETCHED**

**FCFT\_SCALING\_FILTER\_NONE** disables filtering.

**FCFT\_SCALING\_FILTER\_NEAREST** and **FCFT\_SCALING\_FILTER\_BILINEAR** are traditional filters, with *nearest* being the fastest.

The rest are separable convolution filters.

If this function is not called, fcft defaults to **FCFT\_SCALING\_FILTER\_CUBIC**.

## RETURN VALUE

On success, **fcft\_set\_scaling\_filter**() returns true. On error, false is returned.

## EXAMPLE

See **fcft\_from\_name**()
