Package: gdk-pixbuf

Function gdk-pixbuf:pixbuf-option

Lambda List

gdk-pixbuf:pixbuf-option (pixbuf key)

Syntax

(gdk-pixbuf:pixbuf-option pixbuf key) => value
(setf (gdk-pixbuf:pixbuf-option pixbuf key) value)

Arguments

pixbuf -- a gdk-pixbuf:pixbuf object
key -- a string for a key
value -- a string for a value

Details

Gets or sets a key/value pair as an option to a pixbuf. If key already exists in the list of options attached to pixbuf, the new value is ignored.

For instance, the ANI loader provides "Title" and "Artist" options. The ICO, XBM, and XPM loaders provide "x_hot" and "y_hot" hot-spot options for cursor definitions. The PNG loader provides the tEXt ancillary chunk key/value pairs as options. Since 2.12, the TIFF and JPEG loaders return an "orientation" option string that corresponds to the embedded TIFF/Exif orientation tag (if present). Since 2.32, the TIFF loader sets the "multipage" option string to "yes" when a multi-page TIFF is loaded. Since 2.32 the JPEG and PNG loaders set "x-dpi" and "y-dpi" if the file contains image density information in dots per inch.
 

See also

#2025-09-26