XpmCreatePixmap(__libmansuffix__)

NAME
XpmCreatePixmap - create a pixmap

SYNOPSIS

int XpmCreatePixmapFromData(Display *display, Drawable d,
char **data, Pixmap *pixmap_return, Pixmap *shapemask_return,
XpmAttributes *attributes);

int XpmCreatePixmapFromBuffer(Display *display, Drawable d,
char *buffer, Pixmap *pixmap_return, Pixmap *shapemask_return,
XpmAttributes *attributes);

int XpmCreatePixmapFromXpmImage(Display *display, Drawable d,
XpmImage *image, Pixmap *pixmap_return, Pixmap *shapemask_return,
XpmAttributes *attributes);

ARGUMENTS

display
    Specifies the connection to the X server.

d   Specifies which screen the pixmap is created on.

buffer
    Specifies the location of the buffer.

pixmap_return
    Returns the pixmap which is created if the color None.

shapemask_return
    Returns the shape mask pixmap which is created if the color None is used.

attributes
    Specifies the location of a structure to get and store information.

image
    Specifies the XpmImage.

DESCRIPTION

  XpmCreatePixmapFromData
To create a Pixmap from an XPM data, use XpmCreatePixmapFromData(). The XpmCreatePixmapFromData() function creates X images using XpmCreateImageFromData(__libmansuffix__) and thus returns the same errors. In addition on success it then creates the related pixmaps, using XPutImage(__libmansuffix__), which are returned to pixmap_return and shapemask_return if not NULL, and finally destroys the created images using XDestroyImage(__libmansuffix__). Do not forget to free the returned pixmaps, the colors, and possibly the data returned into the XpmAttributes structure when done.

  XpmCreatePixmapFromBuffer
To create a Pixmap from an XPM buffer, use XpmCreatePixmapFromBuffer(). The XpmCreatePixmapFromBuffer() function works the same way as XpmReadFileToPixmap(__libmansuffix__), it just calls XpmCreateImageFromBuffer(__libmansuffix__) instead of XpmReadFileToImage(__libmansuffix__).

  XpmCreatePixmapFromXpmImage
XpmCreatePixmapFromXpmImage() creates X images calling XpmCreateImageFromXpmImage(__libmansuffix__) with the given XpmImage and XpmAttributes, then it creates the related pixmaps which are returned to pixmap_return and shapemask_return using XPutImage(__libmansuffix__). Finally it destroys the X images with XDestroyImage(__libmansuffix__). When finished the caller must free the pixmaps using XFreePixmap(__libmansuffix__), the colors using XFreeColors(__libmansuffix__) or the application equivalent function when the standard Xlib functions are not used, and possibly the data returned into the XpmAttributes using XpmFreeAttributes(__libmansuffix__).

SEE ALSO
XpmCreateImageFromData(__libmansuffix__), XpmCreateImageFromXpmImage(__libmansuffix__), XpmFreeAttributes(__libmansuffix__), XpmReadFileToPixmap(__libmansuffix__)