A pixmap caching function that adds an image to the image cache
#include <Xm/Xm.h> Boolean XmInstallImage XImage * imagechar * image_name
XmInstallImage stores an image in an image cache that can later be used to generate a pixmap. Part of the installation process is to extend the resource converter used to reference these images. The resource converter is given the image name so that the image can be referenced in a .Xdefaults file. Since an image can be referenced by a widget through its pixmap resources, it is up to the application to ensure that the image is installed before the widget is created.
The image caching functions provide a set of eight preinstalled images.
These names can be used within a .Xdefaults
file for generating
pixmaps for the resource for which they are provided.
|background||A tile of solid background|
|25_foreground||A tile of 25% foreground, 75% background|
|50_foreground||A tile of 50% foreground, 50% background|
|75_foreground||A tile of 75% foreground, 25% background|
|horizontal||A tile of horizontal lines of the two colors|
|vertical||A tile of vertical lines of the two colors|
|slant_right||A tile of slanting lines of the two colors|
|slant_left||A tile of slanting lines of the two colors|
|menu_cascade||A tile of an arrow of the foreground color|
|menu_checkmark||A tile of a checkmark of the foreground color|
|menu_dash||A tile of one horizontal line of the foreground color|
Returns True when successful; returns False if NULL image, NULL image_name, or duplicate image_name is used as a parameter value.
XmUninstallImage (3), XmGetPixmap (3), and XmDestroyPixmap (3).