XpmCreatePixmap(3) libXpm functions XpmCreatePixmap(3)

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(3) and thus returns the same errors. In
addition on success it then creates the related pixmaps, using
XPutImage(3), which are returned to pixmap_return and
shapemask_return if not NULL, and finally destroys the created images
using XDestroyImage(3). 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(3), it just calls
XpmCreateImageFromBuffer(3) instead of XpmReadFileToImage(3).

XpmCreatePixmapFromXpmImage

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

SEE ALSO

XpmCreateImageFromData(3), XpmCreateImageFromXpmImage(3),
XpmFreeAttributes(3), XpmReadFileToPixmap(3)


X Version 11 libXpm 3.5.17 XpmCreatePixmap(3)