Return to ch06e.t CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / doc / Xlib

Annotation of 43BSDTahoe/new/X/doc/Xlib/ch06e.t, revision 1.1.1.1

1.1       root        1: .NH 2
                      2: Storing and Freeing Bitmaps and Pixmaps
                      3: .PP
                      4: Bitmaps and Pixmaps are off screen resources which are used for a number of
                      5: operations.
                      6: These include defining cursors,
                      7: temporarily saving some part of the screen for later,
                      8: as tiling patterns, and as the source for certain raster operations.
                      9: .FD
                     10: .IN "Definitions" "XStorePixmapXY"
                     11: .IN "Definitions" "XStorePixmapZ"
                     12: .IN "XStorePixmapXY"
                     13: .IN "XStorePixmapZ"
                     14: Pixmap XStorePixmapXY (width, height, data)
                     15:        short *data;
                     16: 
                     17: Pixmap XStorePixmapZ (width, height, data)
                     18:        caddr_t data;
                     19:        int height, width, format;
                     20: .FN
                     21: This creates a Pixmap of the specified size and returns a Pixmap id.
                     22: The data must be in the format specified by the subroutine name; see
                     23: the section on data representation.
                     24: This data is stored in the window system for later use.
                     25: .PP
                     26: This function returns 0 if the pixmap could not be created.
                     27: The client should call \fIXFreePixmap\fP when finished with the pixmap.
                     28: .FD
                     29: .IN "Definitions" "XStoreBitmap"
                     30: .IN "XStoreBitmap"
                     31: Bitmap XStoreBitmap (width, height, data)
                     32:        short *data;
                     33:        int width, height;
                     34: .FN    
                     35: \fIXStoreBitmap\fP creates a bitmap for later use.
                     36: .IN "XFreeBitmap"
                     37: The client should call \fIXFreeBitmap\fP
                     38: when finished with it.
                     39: .PP
                     40: See the section on data representation.
                     41: .PP
                     42: This function returns 0 if the operation fails, or the Bitmap
                     43: if it succeeds.
                     44: .FD
                     45: .IN "Definitions" "XMakePixmap"
                     46: .IN "XMakePixmap"
                     47: Pixmap XMakePixmap (bitmap, foreground, background)
                     48:        Bitmap bitmap;
                     49:        int foreground, background;
                     50: .FN
                     51: \fIXMakePixmap\fP
                     52: returns a Pixmap constructed from a bitmap and two pixel values.
                     53: Wherever there is a one in the bitmap, the pixmap will have a pixel
                     54: value of the \fIforeground\fP, and wherever there is a zero in the bitmap,
                     55: the pixmap will have a pixel value of the \fIbackground\fP.
                     56: If zero is specified for the \fIbitmap\fP argument, it returns a Pixmap of
                     57: indefinite size suitable for use as a constant tiling pixmap.
                     58: .FD
                     59: .IN "Definitions" "XMakeTile"
                     60: .IN "XMakeTile"
                     61: Pixmap XMakeTile (pixel)
                     62:        int pixel;      /* pixel value */
                     63: .FN
                     64: This function returns a Pixmap suitable for use as a tiling argument.
                     65: .FD
                     66: .IN "Definitions" "XFreePixmap"
                     67: .IN "XFreePixmap"
                     68: XFreePixmap (pixmap)
                     69:        Pixmap pixmap;
                     70: .FN    
                     71: \fIXFreePixmap\fP frees all the storage associated with this Pixmap.
                     72: The Pixmap should never be referenced again.
                     73: .PP
                     74: .FD
                     75: .IN "Definitions" "XFreeBitmap"
                     76: .IN "XFreeBitmap"
                     77: XFreeBitmap (bitmap)
                     78:        Bitmap bitmap;
                     79: .FN
                     80: \fIXFreeBitmap\fP frees all the storage associated with this Bitmap.
                     81: The Bitmap should never be referenced again.
                     82: .FD
                     83: .IN "Definitions" "XCharBitmap"
                     84: .IN "XCharBitmap"
                     85: Bitmap XCharBitmap (font, char)
                     86:        Font font;
                     87:        int char;
                     88: .FN
                     89: This request creates a bitmap from the specified character of the
                     90: specified font.
                     91: .PP
                     92: .IN "Resource ID's" "Freeing"
                     93: .IN "Freeing" "Resources"
                     94: The font can be freed immediately if no further explicit
                     95: references to it are to be made.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.