psSurfaceDscBeginSetup

fnvoid psSurfaceDscBeginSetup(cairo.surface.Surface surface)

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

This function should be called at most once per surface, and must be called before any call to [cairo.global.psSurfaceDscBeginPageSetup] and before any drawing is performed to the surface.

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

Parameters

surfacea PostScript #cairo_surface_t