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

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.