Return to ch06a.t CVS log

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

Annotation of 43BSD/contrib/X/doc/Xlib/ch06a.t, revision 1.1.1.1

1.1       root        1: .NH
                      2: Graphic Output to a Window
                      3: .XS
                      4: Graphic Operations
                      5: .XE
                      6: .NH 2
                      7: Display Functions
                      8: .PP
                      9: .IN "Definitions" "Display Functions"
                     10: .IN "Definitions" "Source"
                     11: .IN "Definitions" "Destination"
                     12: You use display functions when you update  a section of the screen (the
                     13: `destination') with bits from somewhere else (the
                     14: `source').  
                     15: Many procedures below take one of these display functions as an argument.
                     16: The function defines how the new destination bits are to be
                     17: computed from the source bits and the old destination bits.
                     18: \fIGXcopy\fP is typically the most useful as it will work on a color display,
                     19: but special applications may use other functions,
                     20: particularly in concert with particular planes of a color display.
                     21: There are
                     22: .IN "File" "<X/X.h>
                     23: 16 such functions, defined in \fI<X/X.h>\fP:
                     24: .KS
                     25: .L
                     26: .TS
                     27: center;
                     28: l c c
                     29: l c l.
                     30: Function Name  Hex Code        Operation
                     31: _
                     32: GXclear        0x0     0
                     33: GXand  0x1     src AND dst
                     34: GXandReverse   0x2     src AND NOT dst
                     35: GXcopy 0x3     src
                     36: GXandInverted  0x4     (NOT src) AND dst
                     37: GXnoop 0x5     dst
                     38: GXxor  0x6     src XOR dst
                     39: GXor   0x7     src OR dst
                     40: GXnor  0x8     (NOT src) AND NOT dst
                     41: GXequiv        0x9     (NOT src) XOR dst
                     42: GXinvert       0xa     NOT dst
                     43: GXorReverse    0xb     src OR NOT dst
                     44: GXcopyInverted 0xc     NOT src
                     45: GXorInverted   0xd     (NOT src) OR dst
                     46: GXnand 0xe     (NOT src) OR NOT dst
                     47: GXset  0xf     1
                     48: .TE
                     49: .PP
                     50: .KE
                     51: .IN "Pixel Values"
                     52: Many of the color functions below take either pixel values or
                     53: \fIplanes\fP as an argument.
                     54: The \fIplanes\fP is an integer which specifies which planes of the
                     55: display are to be modified, one bit per plane.
                     56: .IN "Definitions" "Plane Masks"
                     57: A monochrome display has only one plane and
                     58: will be the least significant bit of the word.
                     59: As planes are added to the display hardware, they will occupy more
                     60: significant bits in the plane mask.
                     61: .PP
                     62: .IN "Macro" "AllPlanes"
                     63: A macro constant \fIAllPlanes\fP can be used to refer to all planes of a display
                     64: simultaneously (``~0'').
                     65: .PP
                     66: .IN "Definitions" "Brush"
                     67: A `brush' is a rectangular area of certain allowable sizes
                     68: which will be painted in the line drawing subroutines at each point
                     69: of the line or curve.
                     70: The upper left corner of the brush follows
                     71: the line or curve.
                     72: The brush is defined by \fIheight\fP and \fIwidth\fP parameters
                     73: to many of the line- and curve-drawing routines.
                     74: .PP
                     75: If the width or height of the brush is greater than one pixel,
                     76: the display hardware
                     77: may paint some pixels more than once.
                     78: It is therefore inadvisable to use
                     79: such brushes with display functions such as \fIGXxor\fP and \fIGXinvert\fP,
                     80: which do
                     81: not have the same effect if applied more than once.

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