XmInstallImage - A pixmap caching function that adds an image to the pixmap cache
#include <Xm/Xm.h> Boolean XmInstallImage (image, image_name) XImage * image; char * 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.
.Xdefaults
for referencing the image. A local copy of the
name is created by the image caching functions.
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.
Image Name Description 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
Returns True when successful; returns False if NULL image, NULL image_name, or duplicate image_name is used as a parameter value.
XmUninstallImage(3X), XmGetPixmap(3X), and XmDestroyPixmap(3X).