XGraphicsExposeEvent(3)

1XGraphicsExposeEvent(3)         XLIB FUNCTIONS         XGraphicsExposeEvent(3)
2
3
4

NAME

6       XGraphicsExposeEvent,  XNoExposeEvent  -  GraphicsExpose  and  NoExpose
7       event structures
8

STRUCTURES

10       The structures for GraphicsExpose and NoExpose events contain:
11
12       typedef struct {
13               int type;       /* GraphicsExpose */
14               unsigned long serial;   /* # of last request processed by server */
15               Bool send_event;        /* true if this came from a SendEvent request */
16               Display *display;       /* Display the event was read from */
17               Drawable drawable;
18               int x, y;
19               int width, height;
20               int count;      /* if nonzero, at least this many more */
21               int major_code; /* core is CopyArea or CopyPlane */
22               int minor_code; /* not defined in the core */
23       } XGraphicsExposeEvent;
24
25       typedef struct {
26               int type;       /* NoExpose */
27               unsigned long serial;   /* # of last request processed by server */
28               Bool send_event;        /* true if this came from a SendEvent request */
29               Display *display;       /* Display the event was read from */
30               Drawable drawable;
31               int major_code; /* core is CopyArea or CopyPlane */
32               int minor_code; /* not defined in the core */
33       } XNoExposeEvent;
34
35       When you receive these events, their structure members are set as  fol‐
36       lows.
37
38       The  type  member  is set to the event type constant name that uniquely
39       identifies it.  For example, when the X server reports a GraphicsExpose
40       event  to a client application, it sends an XGraphicsExposeEvent struc‐
41       ture with the type member set to GraphicsExpose.  The display member is
42       set  to a pointer to the display the event was read on.  The send_event
43       member is set to True if the event came from a SendEvent  protocol  re‐
44       quest.  The serial member is set from the serial number reported in the
45       protocol but expanded from the 16-bit least-significant bits to a  full
46       32-bit value.  The window member is set to the window that is most use‐
47       ful to toolkit dispatchers.
48
49       Both structures have these common members:  drawable,  major_code,  and
50       minor_code.  The drawable member is set to the drawable of the destina‐
51       tion region on which the graphics request was to be performed.  The ma‐
52       jor_code  member is set to the graphics request initiated by the client
53       and can be either X_CopyArea or X_CopyPlane.  If it  is  X_CopyArea,  a
54       call  to XCopyArea initiated the request.  If it is X_CopyPlane, a call
55       to XCopyPlane initiated the request.  These constants  are  defined  in
56       The  minor_code  member,  like  the  major_code member, indicates which
57       graphics request was initiated by the client.  However, the  minor_code
58       member  is not defined by the core X protocol and will be zero in these
59       cases, although it may be used by an extension.
60
61       The XGraphicsExposeEvent structure has these additional members: x,  y,
62       width,  height,  and count.  The x and y members are set to the coordi‐
63       nates relative to the drawable's origin  and  indicate  the  upper-left
64       corner  of  the rectangle.  The width and height members are set to the
65       size (extent) of the rectangle.  The count member is set to the  number
66       of GraphicsExpose events to follow.  If count is zero, no more Graphic‐
67       sExpose events follow for this window.  However, if count  is  nonzero,
68       at  least  that number of GraphicsExpose events (and possibly more) are
69       to follow for this window.
70

NAME

STRUCTURES

SEE ALSO