21.1 Creating a canvas
Description: Creating a canvas
Keywords: pychart

##
21.1 Creating a canvas

A new canvas is created by calling `canvas.init`. It is closed by calling the `close()` method of the canvas object.

`init`( | fname=None format=None)

  This is a "factory" procedure that creates a new canvas.T object. Both parameters, fname and format, are optional. Parameter fname specifies either the output file name or a file object. Parameter format, if specified, defines the file's format. Its value must be one of "ps", "pdf", "svg", "x11", or "png".

  When fname is omitted or is None, the output is sent to standard output. When format is omitted, it is guessed from the fname's suffix; failing that, "ps" is selected.

A canvas can be closed by calling its `close` method.

`close`( | )

  This method closes the canvas and writes contents to the associated file. Calling this procedure is optional, because Pychart calls this procedure for every open canvas on normal exit.