Function: allout-find-image

allout-find-image is a function alias for find-image, defined in image.el.gz.

This function is obsolete since 28.1; use find-image instead.

Signature

(allout-find-image SPECS &optional CACHE)

Documentation

Find an image that satisfies one of a list of image specifications.

SPECS is a list of image specifications.

Each image specification in SPECS is a property list. The contents of a specification are image type dependent; see the info node (elisp)Image Descriptors for details. All specifications must at least contain either the property :file FILE or :data DATA, where FILE is the file from which to load the image, and DATA is a string containing the actual image data. If the property :type TYPE is omitted or nil, try to determine the image type from its first few bytes of image data. If that doesn't work, and the property :file FILE provide a file name, use its file extension as indication of the image type. If :type TYPE is provided, it must match the actual type determined for FILE or DATA by create-image.

The function returns the image specification for the first specification in the list whose TYPE is supported and FILE, if specified, exists. It returns nil if no specification in the list can be satisfied.

If CACHE is non-nil, results are cached and returned on subsequent calls.

The image is looked for in image-load-path.

Image files should not be larger than specified by max-image-size.

Aliases

allout-find-image (obsolete since 28.1)