Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   12896 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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
       local 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
       installation,  this  name can be used in .Xdefaults for referencing the
       image.  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.

       ────────────────────────────────────────────────────────────
       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 col‐
		       ors
       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.

SEE ALSO
       XmUninstallImage(3X), XmGetPixmap(3X), XmDestroyPixmap(3X)

							    XmInstallImage(3X)

Vote for polarhome