hpux man page for xcreatepixc

XCreatePixmapFromBitmapData()											     XCreatePixmapFromBitmapData()

Name
  XCreatePixmapFromBitmapData - create a pixmap with depth from bitmap data.

Synopsis
  Pixmap XCreatePixmapFromBitmapData(display, drawable, data,
	    width, height, fg, bg, depth)
	  Display *display;
	  Drawable drawable;
	  char *data;
	  unsigned int width, height;
	  unsigned long fg, bg;
	  unsigned int depth;

Arguments
  display   Specifies a connection to an Display structure, returned from XOpenDisplay().

  drawable  Specifies a drawable ID which indicates which screen the pixmap is to be used on.

  data	    Specifies the data in bitmap format.

  width     Specify the width and height in pixels of the pixmap to create.
  height

  fg	    Specify the foreground and background pixel values to use.
  bg

  depth     Specifies the depth of the pixmap.	Must be valid on the screen specified by drawable.

Returns
  The created Pixmap.

Description
  XCreatePixmapFromBitmapData() creates a pixmap of the given depth using bitmap data and foreground and background pixel values.

  The  following format for the data is assigned, where the variables are members of the XImage structure described in Volume One, Chapter 6,
  Drawing Graphics and Text:

      format=XYPixmap
      bit_order=LSBFirst
      byte_order=LSBFirst
      bitmap_unit=8
      bitmap_pad=8
      xoffset=0
      no extra bytes per line
  XCreatePixmapFromBitmapData() creates an image from the data and uses XPutImage() to place the data into the pixmap.	For example:
      #define gray_width 16
      #define gray_height 16
      #define gray_x_hot 8
      #define gray_y_hot 8
      static char gray_bits[] = {
	  0xf8, 0x1f, 0xe3, 0xc7, 0xcf, 0xf3, 0x9f, 0xf9, 0xbf,
	  0xfd, 0x33, 0xcc, 0x7f, 0xfe, 0x7f, 0xfe, 0x7e, 0x7e,
	  0x7f, 0xfe, 0x37, 0xec, 0xbb, 0xdd, 0x9c, 0x39, 0xcf,
	  0xf3, 0xe3, 0xc7, 0xf8, 0x1f};
      unsigned long foreground, background;
      unsigned int depth;

      /* open display, determine colors and depth */

      Pixmap XCreatePixmapFromBitmapData(display, window, gray_bits,
	 gray_width, gray_height, foreground, background, depth);

  If you want to use data of a different format, it is straightforward to write a routine that does this yourself, using images.

  Pixmaps should be considered a precious resource, since many servers have limits on the amount of off-screen memory available.

  If you are creating a pixmap for use in XCreatePixmapCursor(), specify depth=1, fg=1, and bg=0.

Errors
  BadAlloc

  BadDrawable

  BadGC

  BadValue  depth is not a valid depth on the screen specified by drawable.

See Also
  XCreateBitmapFromData(), XCreateFontCursor(), XCreatePixmap(), XCreatePixmapCursor(), XDefineCursor(), XFreeCursor(), XFreePixmap(), XList-
  PixmapFormats(), XQueryBestCursor(), XQueryBestSize(), XReadBitmapFile(), XRecolorCursor(), XUndefineCursor().

Xlib - Pixmaps and Bitmaps											     XCreatePixmapFromBitmapData()