NAME

XReadBitmapFile, XWriteBitmapFile, XCreatePixmapFromBitmapData, XCreateBitmapFromData − manipulate bitmaps

SYNTAX

int XReadBitmapFile(display, d, filename, width_return, height_return, bitmap_return, x_hot_return,
                       y_hot_return)
      Display ∗display;
      Drawable d;
      char ∗filename;
      unsigned int ∗width_return, ∗height_return;
      Pixmap ∗bitmap_return;
      int ∗x_hot_return, ∗y_hot_return;

int XWriteBitmapFile(display, filename, bitmap, width, height, x_hot, y_hot)
      Display ∗display;
      char ∗filename;
      Pixmap bitmap;
      unsigned int width, height;
      int x_hot, y_hot;

Pixmap XCreatePixmapFromBitmapData(display, d, data, width, height, fg, bg, depth)
     Display ∗display;
     Drawable d;
     char ∗data;
     unsigned int width, height;
     unsigned long fg, bg;
     unsigned int depth;

Pixmap XCreateBitmapFromData(display, d, data, width, height)
      Display ∗display;
      Drawable d;
      char ∗data;
      unsigned int width, height;

ARGUMENTS

bitmapSpecifies the bitmap to be written. 

bitmap_return
Returns the bitmap ID that is created.

dSpecifies the drawable. 

dataSpecifies the data in bitmap format. 

dataSpecifies the location of the bitmap data. 

displaySpecifies the connection to the X server. 

depthSpecifies the depth of the pixmap. 

fg

bgSpecifies the foreground and background pixel values to use. 

filenameSpecifies the file name to use.  The format of the file name is operating system specific. 

width

heightSpecify the width and height. 

width_return

height_return
Returns the width and height values of the read in bitmap file.

x_hot

y_hotSpecifies where to place the hot spot coordinates (or -1,-1 if none are present) in the file. 

x_hot_return

y_hot_return
Returns the hot spot coordinates.

DESCRIPTION

The XReadBitmapFile function reads in a file containing a bitmap.

The XWriteBitmapFile function writes a bitmap out to a file.

XCreatePixmapFromBitmapData creates a pixmap of the given depth and then does a bitmap-format XPutImage of the data into it.

The XCreateBitmapFromData function allows you to include in your C program (using #include) a bitmap file that was written out by XWriteBitmapFile (X version 11 format only) and, without reading in the bitmap file,

SEE ALSO

Xlib − C Language X Interface

1 March 1988