gdk-pixbuf-option (pixbuf key)

pixbuf -- a gdk-pixbuf object
key -- a string with a key
value -- a string with a value

Accessor of an option that may have been attached to the pixbuf.

The gdk-pixbuf-option function looks up key in the list of options that may have been attached to the pixbuf when it was loaded, or that may have been attached. The (setf gdk-pixbuf-option) function attaches 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.