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.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.