VkPixmap(3X)                                                      VkPixmap(3X)



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

SYNOPSIS
     #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

     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

   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
     Installs a pixmap into a subclass of XmLabel or XmLabelGadget, handling
     SGI's locate highlight.


SEE ALSO
     VkXpm(3S)



































                                                                        Page 2