XmInstallImage(3X) UNIX System V 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;
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 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.
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_name
Specifies a string that the application uses to
name the image. After installation, this name can
be used in .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
Page 1 (printed 4/30/98)
XmInstallImage(3X) UNIX System V XmInstallImage(3X)
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).
Page 2 (printed 4/30/98)