GdkPixbuf* gdk_pixbuf_new_from_file_at_scale ( const char* filename, int width, int height, gboolean preserve_aspect_ratio, 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
The image will be scaled to fit in the requested size, optionally preserving the image’s aspect ratio.
When preserving the aspect ratio, a
width of -1 will cause the image
to be scaled to the exact given height, and a
height of -1 will cause
the image to be scaled to the exact given width. When not preserving
aspect ratio, a
height of -1 means to not scale the image
at all in that dimension. Negative values for
allowed since 2.8.
Available since: 2.6
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 width the image should have or -1 to not constrain the width.
The height the image should have or -1 to not constrain the height.
TRUEto preserve the image’s aspect ratio.
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 |