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, since 1.12, there is also a set of hints:
- :fast
- Allow the backend to degrade raster quality for speed.
- :good·
- A balance between speed and quality.
- :best
- A high-fidelity, but potentially slow, raster mode.
These 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,
:fast and
:good will be mapped to
:gray, with
:best being equivalent to
:subpixel.
The interpretation of
:default is left entirely up to the backend, typically this will be similar to
:good.
(defcenum cairo-antialias-t
:default
:none
:gray
:subpixel
:fast
:good
:best)
- :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
- The backend should balance quality against performance.
- :best
- Hint that the backend should render at the highest quality, sacrificing speed if necessary.