Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  XMINSTALLIMAGE (3)


XmInstallImage — A pixmap caching function that adds an image to the image cache



#include <Xm/Xm.h>
Boolean XmInstallImage(
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.
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 NameDescription
backgroundA tile of solid background
25_foregroundA tile of 25% foreground, 75% background
50_foregroundA tile of 50% foreground, 50% background
75_foregroundA tile of 75% foreground, 25% background
horizontalA tile of horizontal lines of the two colors
verticalA tile of vertical lines of the two colors
slant_rightA tile of slanting lines of the two colors
slant_leftA tile of slanting lines of the two colors
menu_cascadeA tile of an arrow of the foreground color
menu_checkmarkA tile of a checkmark of the foreground color
menu_dashA 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).

Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.