csurface:SetFallbackResolution(x_pixels_per_inch, y_pixels_per_inch)
Wenn bestimmte Vorgänge nicht nativ von einem Backend unterstützt werden, greift Cairo zurück, indem es Vorgänge auf ein Bild rendert und dieses Bild dann über die Ausgabe legt. Für Backends, die nativ vektororientiert sind, kann diese Funktion verwendet werden, um die Auflösung festzulegen, die für diese Bild-Fallbacks verwendet wird (größere Werte führen zu detaillierteren Bildern, aber auch zu größeren Dateigrößen).
Einige Beispiele für nativ vektororientierte Backends sind die Backends ps, pdf und svg.
Für Backends, die nativ rasterorientiert sind, sind Bild-Fallbacks weiterhin möglich, sie werden jedoch immer mit der nativen Geräteauflösung durchgeführt. Diese Funktion hat also keine Auswirkung auf diese Backends.
Hinweis: Die Fallback-Auflösung wird erst wirksam, wenn eine Seite fertiggestellt wird (mit ccontext:ShowPage() oder ccontext:CopyPage()), daher gibt es derzeit keine Möglichkeit, mehr als eine Fallback-Auflösung auf einer einzigen Seite zu haben.
Die standardmäßige Fallback-Auflösung beträgt in beiden Dimensionen 300 Pixel pro Zoll.