cairo-surface-copy-page (surface)

surface -- a cairo-surface-t instance

Emits the current page for backends that support multiple pages, but does not clear it, so that the contents of the current page will be retained for the next page. Use the function cairo-surface-show-page if you want to get an empty page after the emission.

There is a convenience function for this that takes a cairo_t context, namely the function cairo-copy-page.