Method Cairo.Surface()->set_fallback_resolution()

Method set_fallback_resolution

void set_fallback_resolution(float|int x_pixels_per_inch, float|int y_pixels_per_inch)

Description

Set the horizontal and vertical resolution for image fallbacks.

When certain operations aren't supported natively by a backend, cairo will fallback by rendering operations to an image and then overlaying that image onto the output. For backends that are natively vector-oriented, this function can be used to set the resolution used for these image fallbacks, (larger values will result in more detailed images, but also larger file sizes).

Some examples of natively vector-oriented backends are the ps, pdf, and svg backends.

For backends that are natively raster-oriented, image fallbacks are still possible, but they are always performed at the native device resolution. So this function has no effect on those backends.

Note

The fallback resolution only takes effect at the time of completing a page (with Context->show_page() or Context->copy_page()) so there is currently no way to have more than one fallback resolution in effect on a single page.

The default fallback resolution is 300 pixels per inch in both dimensions.

Parameter x_pixels_per_inch

horizontal setting for pixels per inch

Parameter y_pixels_per_inch

vertical setting for pixels per inch