pdfSurfaceCreate

Creates a PDF surface of the specified size in points to be written to filename.

pdfSurfaceCreate
(
string filename
,,)

Parameters

filename string

a filename for the PDF output (must be writable), null may be used to specify no output. This will generate a PDF surface that may be queried and used as a source, without generating a temporary file.

widthInPoints double

width of the surface, in points (1 point == 1/72.0 inch)

heightInPoints double

height of the surface, in points (1 point == 1/72.0 inch)

Return Value

Type: cairo.surface.Surface

a pointer to the newly created surface. The caller owns the surface and should call cairo.surface.Surface.destroy when done with it.

This function always returns a valid pointer, but it will return a pointer to a "nil" surface if an error such as out of memory occurs. You can use cairo.surface.Surface.status to check for this.