GdkPixbuf* gdk_pixbuf_new_from_file ( const char* filename, GError** error )
Creates a new pixbuf by loading an image from a file.
The file format is detected automatically.
NULL is returned, then
error will be set. Possible errors are:
- the file could not be opened
- there is no loader for the file’s format
- there is not enough memory to allocate the image buffer
- the image buffer contains invalid data
The error domains are
Name of file to load, in the GLib file name encoding.
The data is owned by the caller of the function. The value is a file system path, using the OS encoding.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
The argument will left initialized to
NULLby the constructor if there are no errors.
In case of error, the argument will be set to a newly allocated
GError; the caller will take ownership of the data, and be responsible for freeing it.
A newly-created pixbuf.
|The caller of the function takes ownership of the data, and is responsible for freeing it.|
|The return value can be |