FreeBSD Manual Pages
XmInstallImage(3) Library Functions Manual XmInstallImage(3) NAME XmInstallImage -- A pixmap caching function that adds an image to the image cache SYNOPSIS #include <Xm/Xm.h> Boolean XmInstallImage( 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 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 | +----------------+-----------------------------+ | menu_cascade | A tile of an arrow of the | | | foreground color | +----------------+-----------------------------+ | menu_checkmark | A tile of a checkmark of | | | the foreground color | +----------------+-----------------------------+ | menu_dash | A tile of one horizontal | | | line of the foreground | | | color | +----------------+-----------------------------+ +----------------+-----------------------------+ RETURN Returns True when successful; returns False if NULL image, NULL image_name, or duplicate image_name is used as a parameter value. RELATED XmUninstallImage(3), XmGetPixmap(3), and XmDestroyPixmap(3). XmInstallImage(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmInstallImage&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>