| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: pixmap
Returns an icon handle, which can be used as the icon of a window's titlebar, or as the pixmap-icon property of controls that display pixmaps or passed to copy-to-stream or copy-pixels-to-stream. The pixmap object should contain a mask in addition to the usual texture.
An icon handle is like a pixmap handle (a handle to a device-dependent pixmap that resides in the OS) that has a mask built in, so that the background color or whatever was drawn before the icon can show through the icon.
See also extract-icon-from-file, for creating icons from Windows icon files rather than from Common Graphics pixmaps.
See cg-icons.htm.
Common Graphics icons are actually Common Graphics pixmaps on GTK. This function simply returns its pixmap argument, for compatibility with Windows Common Graphics code.
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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |