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
     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)