FreeBSD manual
download PDF document: XpmCreateImageFromData.3.pdf
XpmCreateImage(3) libXpm functions XpmCreateImage(3)
NAME
XpmCreateImage - create an XImage from an XPM
SYNOPSIS
int XpmCreateImageFromData(Display *display, char **data,
XImage **image_return, XImage **shapeimage_return,
XpmAttributes *attributes);
int XpmCreateImageFromBuffer(Display *display, char *buffer,
XImage **image_return, XImage **shapeimage_return,
XpmAttributes *attributes);
int XpmCreateImageFromXpmImage(Display *display, XpmImage *image,
XImage *image_return, XImage *shapeimage_return,
XpmAttributes *attributes);
ARGUMENTS
display
Specifies the connection to the X server.
data Specifies the location of the data.
image_return
Returns the image which is created.
shapeimage_return
Returns the shape mask image which is created if the color None
is used.
attributes
Specifies the location of a structure to get and store
information (or NULL).
shapeimage
Specifies the shape mask image which is created if any.
DESCRIPTION
XpmCreateImageFromData
To create an XImage from an XPM data, use XpmCreateImageFromData().
The XpmCreateImageFromData() function allows you to include in your C
program an XPM file which was written out by functions such as
XpmWriteFileFromImage(3) or XpmWriteFileFromPixmap(3) without reading
in the file. XpmCreateImageFromData() exactly works as
XpmReadFileToImage(3) does and returns the same way. It just reads
data instead of a file. Here again, it is the caller's responsibility
to free the returned images, the colors and possibly the data returned
into the XpmAttributes structure.
XpmCreateImageFromBuffer
To create an XImage from an XPM buffer, use XpmCreateImageFromBuffer().
The XpmCreateImageFromBuffer() function works the same way as
XpmReadFileToImage(3), it just parses the buffer instead of the file.
From the given XpmImage and XpmAttributes if not NULL,
XpmCreateImageFromXpmImage() allocates colors and creates X images
following the same mechanism as XpmReadFileToImage(3). When finished
the caller must free the images using XDestroyImage(3), the colors
using XFreeColors(3), and possibly the data returned into the
XpmAttributes using XpmFreeAttributes(3).
SEE ALSO
XpmFreeAttributes(3), XpmReadFileToImage(3)
X Version 11 libXpm 3.5.17 XpmCreateImage(3)