VkPixmap(3X)							  VkPixmap(3X)

NAME    [Toc]    [Back]

     VkPixmap, VkCreateXPMPixmap, VkSetHighlightingPixmap - Convenience
     functions that work with libXpm

SYNOPSIS    [Toc]    [Back]

     #include <Vk/VkPixmap.h>

     Pixmap VkCreateXPMPixmap (	Widget w,
			   char	**xpmPixmapDesc,
			   char	**resources = NULL);

     Pixmap VkCreateXPMPixmap (	Widget w,
			   char	*xpmBufferOrFile,
			   char	**resources = NULL);

     void VkSetHighlightingPixmap ( Widget w,
			   char	**xpmPixmapDesc,
			   const char *resource	= NULL);

     void VkSetHighlightingPixmap ( Widget w,
			   char	*xpmBufferOrFile,
			   const char *resource	= NULL);

     void VkSetHighlightingPixmap ( Widget w,
			   char	**xpmPixmapDesc,
			   char	**xpmInsensitivePixmapDesc,
			   const char *resource);

     void VkSetHighlightingPixmap ( Widget w,
			   char	*xpmBufferOrFile,
			   char	*xpmInsensitiveBufferOrFile,
			   const char *resource);

DESCRIPTION OF THE ARGUMENTS    [Toc]    [Back]

     Widget w -- used by libXpm	to derive necessary visual information.

     char **xpmPixmapDesc, **xpmInsensitivePixmapDesc -- is an xpm
     programmatic description.

     char *xpmBufferOrFile, *xpmInsensitiveBufferOrFile	-- is a	character
     string that is an xpm description in a buffer, or else a file name.

     char **resources -- specifies the resource	to be set, such	as
     XmNlabelPixmap or XmNselectPixmap.	 The default is	XmNlabelPixmap.

DESCRIPTION OF THE FUNCTIONS    [Toc]    [Back]

   VkCreateXPMPixmap
     Creates a pixmap given a widget and an XPM	pixmap description.  The
     foreground, background, top shadow	color and bottom shadow	color of the
     widget are	used as	symbolic colors	for the	pixmap (see the	XPM
     documentation).  The resources argument allows you	to pass	additional
     symbolic colors, which are	retrieved as resources.	 For example, the


									Page 1






VkPixmap(3X)							  VkPixmap(3X)



     pixmap might define a symbolic color of "BrightColor".  Then  the
     resources arg would be

     char *resources[] = { "BrightColor", NULL }

     and you could then	put:

     *BrightColor: red

     in	your application defaults file.	 The corresponding color in the	pixmap
     would be red.


   VkSetHighlightingPixmap    [Toc]    [Back]
     Installs a	pixmap into a subclass of XmLabel or XmLabelGadget, handling
     SGI's locate highlight.

SEE ALSO    [Toc]    [Back]

     VkXpm(3S)


									PPPPaaaaggggeeee 2222