Manual Pages for UNIX Operating System command usage for man XSolarisOvlCopyPaintType

X FUNCTIONS                       XSolarisOvlCopyPaintType(3xext)



NAME
     XSolarisOvlCreateWindow -  renders  opaque  and  transparent
     paint  into the destination drawable based on the paint type
     attributes of the pixels in the source drawable

SYNOPSIS
     cc [ flag... ] file... -lXext [ library... ]

     #include 


     void XSolarisOvlCopyPaintType  (Display  *display,  Drawable
          src,  Drawable  dst,  GC  gc,  int  src_x,  int  src_y,
          unsigned int width, unsigned int  height,  int  dest_x,
          int dest_y, unsigned long action, unsigned long plane)

Arguments
     display
          Specifies the connection to the X server.

     src  Specifies the source drawable from which to obtain  the
          paint type information.

     dst  Specifies the destination drawable.

     gc   Specifies the GC.

     src_x, src_y
          Specify the x  and  y  coordinates  of  the  upper-left
          corner  of  the source rectangle relative to the origin
          of the source drawable.

     width, height
          Specify the width and height of  both  the  source  and
          destination rectangles.

     dest_x, dest_y
          Specify the x  and  y  coordinates  of  the  upper-left
          corner  of  the  destination  rectangle relative to the
          origin of the destination drawable.

     action
          Specifies which paint type data is to be copied.   This
          can  be  one of XSolarisOvlCopyOpaque, XSolarisOvlCopy-
          Transparent, or XSolarisOvlCopyAll.

     plane
          Specifies the bit-plane of the src drawable to be  used
          as  paint  type  information  when the source is not an
          overlay.





X Version 11       Last change: libXext 1.1.2                   1






X FUNCTIONS                       XSolarisOvlCopyPaintType(3xext)



DESCRIPTION
     This routine uses the paint type information of  the  speci-
     fied  rectangle  of  src  to control a fill operation in the
     specified rectangle of dst. src and dst can be any  type  of
     drawable.   If  src  is  an overlay, the paint source of the
     copy, and the color information is ignored.  If src  is  any
     other  type of drawable, the bit-plane specified in plane is
     treated as if it were paint type data and it is used for the
     copy.   plane  must have only one bit set in this case.  The
     following table summarizes the possible combinations of  src
     and dst and their actions.  The left side of the table shows
     the possible src combinations.  The top of the  table  shows
     the  possible  dst  combinations.   The  actions, A1-A4, are
     explained below the table.

              _________________________________________
             | Source/Destination|  Overlay   Drawable|
             |___________________|____________________|
             | overlay           |  A1        A2      |
             | drawable          |  A3        A4      |
             |___________________|____________________|

     A1-Opaque pixels in the source overlay cause the correspond-
          ing  pixels in the destination to be filled with opaque
          color as specified by the fill attributes  of  the  GC.
          Transparent  pixels in the source cause the correspond-
          ing pixels in the destination to be filled  with  tran-
          sparent paint.

     A2-Opaque pixels in the source overlay cause the correspond-
          ing pixels in the destination to be filled according to
          the fill attributes of the GC.  Transparent  pixels  in
          the  source  overlay  cause the corresponding pixels in
          the destination to be filled according to the same fill
          attributes of the GC, but with the foreground and back-
          ground pixels swapped.

     A3-The pixels in the destination  overlay  are  filled  with
          opaque paint or made transparent as in A1 above depend-
          ing on the bit values of the source  drawable's  plane.
          Bit  values  of  1 in the source are treated as if they
          were opaque pixels and bit values of 0 are  treated  as
          if they were transparent.

     A4-The pixels in the destination drawable  are  filled  with
          paint as in A2 above depending on the bit values of the
          source drawable's plane.  Bit values of 1 in the source
          bit plane are treated as if they were opaque pixels and
          bit values of 0 are  treated  as  if  they  were  tran-
          sparent.





X Version 11       Last change: libXext 1.1.2                   2






X FUNCTIONS                       XSolarisOvlCopyPaintType(3xext)



     The action argument specifies whether opaque paint  (XSolar-
     isOvlCopyOpaque),  transparent  paint  (XSolarisOvlCopyTran-
     sparent), or both (XSolarisOvlCopyAll)  should  be  operated
     upon.   This  allows  a client to accumulate opaque or tran-
     sparent paint.

     src and dst must have the same screen, or a  BadMatch  error
     results.

     If portions of the source rectangle are obscured or are out-
     side  the boundaries of the source drawable, the server gen-
     erates  exposure  events,  using  the  same   semantics   as
     XCopyArea.

     This routine uses these GC components: function, plane-mask,
     fill-style,   subwindow-mode,   graphics-exposures,  clip-x-
     origin, clip-y-origin, and clip-mask.  It might use these GC
     mode-dependent  components:  foreground,  background,  tile,
     stipple, tile-stipple-x-origin, tile-stipple-y-origin.

     XSolarisOvlCopyPaintType can  generate  BadDrawable,  BadGC,
     BadMatch, and BadValue errors.

ERRORS
     BadDrawable
     BadGC
     BadMatch
     BadValue


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxext         |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|












X Version 11       Last change: libXext 1.1.2                   3