*** UNIX MANUAL PAGE BROWSER ***

XmInstallImage(3X) XmInstallImage(3X) 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; 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 resource converter used to reference these images. The resource con- verter 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. Points to the image structure to be installed. The installation process does not make a lo- cal copy of the image. Therefore, the application should not destroy the image until it is uninstalled from the caching functions. Speci- fies a string that the application uses to name the image. After in- stallation, this name can be used in .Xdefaults for referencing the im- age. A local copy of the name is created by the image caching func- tions. 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. l l. _ 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_fore- ground 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 im- age_name, or duplicate image_name is used as a parameter value. SEE ALSO XmUninstallImage(3X), XmGetPixmap(3X), XmDestroyPixmap(3X) XmInstallImage(3X)