Arguments: pathname
Reads a pixmap from any device-independent bitmap file. These are
typically .bmp files. You can also load .ico (icon) files. This
function returns three values. The first two are the texture and a
texture-info. The texture-info contains a colormap read from the
pixmap file and is therefore appropriate for passing along with the
pixel-map to the function copy-pixels-to-stream in order to draw the
pixel-map on a window in its original colors. The third returned value
is nil when a .bmp file is loaded. When a
.ico file is loaded, the third returned value is a bitmap mask that
defines the transparent areas of the image. This mask bitmap can be
passed along with the main pixmap to copy-pixels-with-mask-to-stream.
The function load-texture-info reads and returns the texture-info of the file without returning the pixmap. It allows you to get the texture-info quickly, if that is all you want.
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.