Function

Purplegdk_pixbuf_new_from_file_at_size

since: 3.0

Declaration [src]

GdkPixbuf*
purple_gdk_pixbuf_new_from_file_at_size (
  const char* filename,
  int width,
  int height
)

Description [src]

Helper function that calls gdk_pixbuf_new_from_file_at_size() and checks both the return code and the GError and returns NULL if either one failed.

The gdk-pixbuf documentation implies that it is sufficient to check the return value of gdk_pixbuf_new_from_file_at_size() to determine whether the image was able to be loaded. However, this is not the case with gdk-pixbuf 2.23.3 and probably many earlier versions. In some cases a GdkPixbuf object is returned that will cause some operations (like gdk_pixbuf_scale_simple()) to rapidly consume memory in an infinite loop.

This function shouldn’t be necessary once Pidgin requires a version of gdk-pixbuf where the aforementioned bug is fixed. However, it might be nice to keep this function around for the debug message that it logs.

Available since: 3.0

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 NUL terminated UTF-8 string.
width

Type: int

The width the image should have or -1 to not constrain the width.

height

Type: int

The height the image should have or -1 to not constrain the height.

Return value

Type: GdkPixbuf

The GdkPixbuf if successful. Otherwise NULL is returned and a warning is logged.

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