Constructor

GdkPixbufPixbufAnimationnew_from_file_utf8

Declaration [src]

GdkPixbufAnimation*
gdk_pixbuf_animation_new_from_file_utf8 (
  const char* filename,
  GError** error
)

Description [src]

Same as gdk_pixbuf_animation_new_from_file()

Parameters

filename

Type: const char*

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.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will left initialized to NULL by 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.

Return value

Type: GdkPixbufAnimation

A newly-created animation with a reference count of 1, or NULL if any of several error conditions ocurred: the file could not be opened, there was no loader for the file’s format, there was not enough memory to allocate the image buffer, or the image file contained invalid data.

The caller of the function takes ownership of the data, and is responsible for freeing it.