Return to ch06c.t CVS log

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

Annotation of 43BSD/contrib/X/doc/Xlib/ch06c.t, revision 1.1

1.1     ! root        1: .NH 2
        !             2: Screen Raster Operations
        !             3: .LP
        !             4: .FD
        !             5: .IN "Definitions" "XClear"
        !             6: .IN "XClear"
        !             7: .IN "Window" "Clearing the Window"
        !             8: XClear (w)
        !             9:        Window w;
        !            10: .FN
        !            11: \fIXClear\fP clears the window and repaints it with the background.  
        !            12: If the
        !            13: window is transparent, it is cleared and repainted with its parent's
        !            14: background. 
        !            15: \fIXClear\fP never generates exposure events.
        !            16: .FD
        !            17: .IN "Definitions" "XPixSet"
        !            18: .IN "Definitions" "XPixFill"
        !            19: .IN "XPixSet"
        !            20: .IN "XPixFill"
        !            21: XPixSet (w, x, y, width, height, pixel)
        !            22: 
        !            23: XPixFill (w, x, y, width, height, pixel, clipmask, func, planes)
        !            24:        Window w;
        !            25:        int x, y, width, height;
        !            26:        int pixel;      /* pixel value */
        !            27:        Bitmap clipmask;        /* which bits to modify */
        !            28:        int func;       /* display function */
        !            29:        int planes;     /* plane mask */
        !            30: .FN
        !            31: \fIXPixFill\fP performs a display function in a region of the window.  
        !            32: The \fIpixel\fP value is used as the source.
        !            33: .IN "Icons"
        !            34: If a \fIclipmask\fP bitmap is specified,
        !            35: it defines the shape of the source and which pixels of the
        !            36: destination will be affected.
        !            37: This can be useful for defining non-rectangular icons.
        !            38: .PP
        !            39: \fIXPixSet\fP sets the area in all planes to the specified pixel with no
        !            40: clipping mask. (\fIfunc\fP=\fIGXcopy\fP,
        !            41: \fIAllPlanes\fP, and no \fIclipmask\fP).
        !            42: .FD
        !            43: .IN "Definitions" "XPixmapPut"
        !            44: .IN "XPixmapPut"
        !            45: .IN "Pixmap"
        !            46: XPixmapPut (w, srcX, srcY, dstX, dstY, width, height, pixmap, func, planes)
        !            47:        Window w;
        !            48:        int srcX, srcY;
        !            49:        int dstX, dstY;
        !            50:        int width, height;
        !            51:        Pixmap pixmap;
        !            52:        int func;       /* display function */
        !            53:        int planes;     /* plane mask */
        !            54: .FN
        !            55: \fIXPixmapPut\fP
        !            56: performs a display function on a specified area of the pixmap and
        !            57: a specified area of the screen.
        !            58: .FD
        !            59: .IN "Limitiations" "Tile Shape"
        !            60: .IN "Definitions" "XQueryTileShape"
        !            61: .IN "XQueryTileShape"
        !            62: XQueryTileShape (width, height, rwidth, rheight)
        !            63:        int width, height;
        !            64:        int rwidth, rheight;    /* RETURN */
        !            65: .FN
        !            66: This function returns the `closest' shape actually supported by the display
        !            67: hardware for tiling.
        !            68: Not all hardware will allow arbitrary shape pixmaps for tile patterns.
        !            69: .FD
        !            70: .IN "Definitions" "XTileSet"
        !            71: .IN "Definitions" "XTileFill"
        !            72: .IN "XTileSet"
        !            73: .IN "XTileFill"
        !            74: XTileSet (w, x, y, width, height, tile)
        !            75: 
        !            76: XTileFill (w, x, y, width, height, tile, cmask, func, planes)
        !            77:        Window w;
        !            78:        int x, y, width, height;
        !            79:        Pixmap tile;
        !            80:        Bitmap clipmask;
        !            81:        int func;       /* display function */
        !            82:        int planes;     /* plane mask */
        !            83: .FN
        !            84: \fIXTileFill\fP performs a display function in a region of the window using a
        !            85: repeating pattern defined by the \fItile\fP pixmap.
        !            86: and a specified area of the screen.
        !            87: The tiling origin is controlled by the window's \fItilemode\fP.
        !            88: If a mask Bitmap is specified in the \fIclipmask\fP argument,
        !            89: it defines which pixels of the
        !            90: destination will be affected, and must be the same height and width as the
        !            91: destination.
        !            92: .IN "Tile Area"
        !            93: .PP
        !            94: \fIXTileSet\fP defaults to modifying all planes of the display with no
        !            95: clipping mask.
        !            96: (\fIfunc\fP = \fIGXcopy\fP, \fIAllPlanes\fP, \fIclipmask\fP = 0).
        !            97: .FD
        !            98: .IN "Definitions" "XMoveArea"
        !            99: .IN "XMoveArea"
        !           100: .IN "Definitions" "XCopyArea"
        !           101: .IN "XCopyArea"
        !           102: .IN "Window Raster Op"
        !           103: .IN "Raster Op"
        !           104: XMoveArea (w, srcX, srcY, dstX, dstY, width, height)
        !           105: 
        !           106: XCopyArea (w, srcX, srcY, dstX, dstY, width, height, func, planes)
        !           107:        Window w;
        !           108:        int srcX, srcY, dstX, dstY, width, height;
        !           109:        int planes;     /* plane mask */
        !           110:        int func;       /* display function */
        !           111: .FN
        !           112: \fIXCopyArea\fP copies one region of the window to another (possibly
        !           113: overlapping) region of the same window, using the supplied display function
        !           114: \fIfunc\fP.
        !           115: .PP
        !           116: If parts of the source region are obscured, the corresponding parts of
        !           117: the destination are painted with the background tile.
        !           118: .IN "ExposeCopy Event"
        !           119: If a client
        !           120: has called \fIXSelectInput\fP on this window with the \fIExposeCopy\fP bit set,
        !           121: then
        !           122: .IN "ExposeRegion Event"
        !           123: \fIExposeRegion\fP events will be generated on any such parts of the
        !           124: destination, and then an \fIExposeCopy event\fP will be generated.  All of
        !           125: these events are guaranteed to be together in the stream, with no
        !           126: intervening events.
        !           127: This sequence makes it possible to `scroll' the contents of a window,
        !           128: getting exposure events from where ever the window was obscured to
        !           129: refresh those areas of the screen.
        !           130: .PP
        !           131: \fIXMoveArea\fP moves the pixels in the specified source area to the
        !           132: specified destination.
        !           133: (\fIfunc\fP = \fIGXcopy\fP, \fIplanes\fP = \fIAllPlanes\fP)

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