cairo-image-surface-create-from-png (filename)

filename -- a string with the name of PNG file to load

A new cairo-surface-t instance initialized with the contents of the PNG file, or a "nil" surface if any error occurred.

Creates a new image surface and initializes the contents to the given PNG file.

A "nil" surface can be checked for with the function cairo-surface-status which may return one of the following values: :no-memory, :file-not-found, or :read-error. Alternatively, you can allow errors to propagate through the drawing operations and check the status on the context upon completion using the function cairo-status.