imageSurfaceCreateFromPng

fncairo.surface.Surface imageSurfaceCreateFromPng(string filename)

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

Parameters

filename name of PNG file to load. On Windows this filename is encoded in UTF-8.

Returns

a new #cairo_surface_t initialized with the contents

of the PNG file, or a "nil" surface if any error occurred. A nil surface can be checked for with cairo_surface_status(surface) which may return one of the following values:

[cairo.types.Status.NoMemory] [cairo.types.Status.FileNotFound] [cairo.types.Status.ReadError] [cairo.types.Status.PngError]

Alternatively, you can allow errors to propagate through the drawing operations and check the status on the context upon completion using [cairo.context.Context.status].