Package: cairo

CEnum cairo:antialias-t

Declaration

(cffi:defcenum antialias-t
  :default
  :none
  :gray
  :subpixel
  :fast
  :good
  :best)

Values

:default
Use the default antialiasing for the subsystem and target device.
:none
Use a bilevel alpha mask.
:gray
Perform single-color antialiasing, using shades of gray for black text on a white background, for example.
:subpixel
Perform antialiasing by taking advantage of the order of subpixel elements on devices such as LCD panels.
:fast
Hint that the backend should perform some antialiasing but prefer speed over quality.
:good
Hint that the backend should balance quality against performance.
:best
Hint that the backend should render at the highest quality, sacrificing speed if necessary.

Details

The cairo:antialias-t enumeration specifies the type of antialiasing to do when rendering text or shapes. As it is not necessarily clear from the above what advantages a particular antialias method provides, there is also a set of hints that have the :fast, :good, and :best values.

These hints make no guarantee on how the backend will perform its rasterisation, if it even rasterises, nor that they have any differing effect other than to enable some form of antialiasing. In the case of glyph rendering, the :fast and :good values will be mapped to the :gray value, with the :best value being equivalent to the :subpixel value. The interpretation of the :default value is left entirely up to the backend, typically this will be similar to the :good value.
 

See also

cairo:context-t
cairo:antialias
2025-1-2