XmInstallImage(3X)
XmInstallImage --A pixmap caching function that adds an image to the pixmap cache
As shipped in IRIX 6.5.7. Unchanged since IRIX 6.5.
NAME XmInstallImage --A pixmap caching function that adds an image to the pixmap cache SYNOPSIS #include <Xm/Xm.h> Boolean XmInstallImage (image, image_name) XImage * image; char * image_name; VERSION This page documents version 1.2 of the Motif library. DESCRIPTION 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 re- source 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 re- sources, it is up to the application to ensure that the image is installed before the widget is created. image Points to the image structure to be installed. The installation process does not make a local copy of the image. Therefore, the application should not destroy the image until it is uninstalled from the caching functions. image_nameSpecifies a string that the application uses to name the image. After installation, this name can be used in .Xdefaults for ref- erencing 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 RETURN VALUE Returns True when successful; returns False if NULL image, NULL image_name, or duplicate image_name is used as a parameter value. RELATED INFORMATION XmUninstallImage(3X), XmGetPixmap(3X), and XmDestroyPixmap(3X). XmInstallImage(3X)