psSurfaceDscBeginPageSetup

fnvoid psSurfaceDscBeginPageSetup(cairo.surface.Surface surface)

This function indicates that subsequent calls to [cairo.global.psSurfaceDscComment] should direct comments to the PageSetup section of the PostScript output.

This function call is only needed for the first page of a surface. It should be called after any call to [cairo.global.psSurfaceDscBeginSetup] and before any drawing is performed to the surface.

See [cairo.global.psSurfaceDscComment] for more details.

Parameters

surfacea PostScript #cairo_surface_t