find-pixmap

Arguments: name &key create (use-handle nil use-handle-supplied)

Returns the cached pixmap named by name which can be a symbol or a pathname namestring. If a namestring, the create argument should be true, and the pixmap is read from the file and cached as if with cache-pixmap. The use-handle argument, if true, tells the system to use the pixmap handle, creating it if necessary.

The system remembers the pathname namestrings of cached pixmaps read from files so if this function is called with name a pathname namestring for a second time, the file will not be read again but the cached pixmap will be used. The idea is that you can have various calls to find-pixmap with name a pathname namestring and create true in your code. The first one evaluated reads the pixmap and caches it. All subsequent calls use the cache pixmap so the behavior is the same no matter in what order the calls are actually encountered by the system.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.