Return to ch06e.t CVS log

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

Annotation of 43BSD/contrib/X/doc/Xlib/ch06e.t, revision 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.