1
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
3
.\" Permission is hereby granted, free of charge, to any person obtaining
4
.\" a copy of this software and associated documentation files (the
5
.\" "Software"), to deal in the Software without restriction, including
6
.\" without limitation the rights to use, copy, modify, merge, publish,
7
.\" distribute, sublicense, and/or sell copies of the Software, and to
8
.\" permit persons to whom the Software is furnished to do so, subject to
9
.\" the following conditions:
11
.\" The above copyright notice and this permission notice shall be included
12
.\" in all copies or substantial portions of the Software.
14
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
18
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20
.\" OTHER DEALINGS IN THE SOFTWARE.
22
.\" Except as contained in this notice, the name of the X Consortium shall
23
.\" not be used in advertising or otherwise to promote the sale, use or
24
.\" other dealings in this Software without prior written authorization
25
.\" from the X Consortium.
27
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
28
.\" Digital Equipment Corporation
30
.\" Portions Copyright \(co 1990, 1991 by
33
.\" Permission to use, copy, modify and distribute this documentation for
34
.\" any purpose and without fee is hereby granted, provided that the above
35
.\" copyright notice appears in all copies and that both that copyright notice
36
.\" and this permission notice appear in all copies, and that the names of
37
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
38
.\" to this documentation without specific, written prior permission.
39
.\" Digital and Tektronix makes no representations about the suitability
40
.\" of this documentation for any purpose.
41
.\" It is provided ``as is'' without express or implied warranty.
43
.\" $XFree86: xc/doc/man/X11/XDrRect.man,v 1.2 2001/01/27 18:19:58 dawes Exp $
45
.ds xT X Toolkit Intrinsics \- C Language Interface
46
.ds xW Athena X Widgets \- C Language X Toolkit Interface
47
.ds xL Xlib \- C Language X Interface
48
.ds xC Inter-Client Communication Conventions Manual
55
.\".if \\n(VS>=40 .vs \\n(VSu
56
.\".if \\n(VS<=39 .vs \\n(VSp
79
.de IN \" send an index entry to the stderr
86
.\" choose appropriate monospace font
87
.\" the imagen conditional, 480,
88
.\" may be changed to L if LB is too
89
.\" heavy for your eyes...
91
.ie "\\*(.T"480" .ft L
92
.el .ie "\\*(.T"300" .ft L
93
.el .ie "\\*(.T"202" .ft PO
94
.el .ie "\\*(.T"aps" .ft CW
97
.ie \\n(VS>40 .vs \\n(VSu
105
.ie t \\$1\fB\^\\$2\^\fR\\$3
106
.el \\$1\fI\^\\$2\^\fP\\$3
109
.ie t \fB\^\\$1\^\fR\\$2
110
.el \fI\^\\$1\^\fP\\$2
113
.ie t <\fB\\$1\fR>\\$2
119
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
120
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
134
. \" Note End -- doug kraft 3/85
143
.TH XDrawRectangle 3X11 __xorgversion__ "XLIB FUNCTIONS"
145
XDrawRectangle, XDrawRectangles, XRectangle \- draw rectangles and rectangles structure
147
XDrawRectangle\^(\^\fIdisplay\fP, \fId\fP\^, \fIgc\fP\^, \fIx\fP\^, \fIy\fP\^, \fIwidth\fP\^, \fIheight\fP\^)
149
Display *\fIdisplay\fP\^;
155
int \fIx\fP\^, \fIy\fP\^;
157
unsigned int \fIwidth\fP\^, \fIheight\fP\^;
159
XDrawRectangles\^(\^\fIdisplay\fP, \fId\fP\^, \fIgc\fP\^, \fIrectangles\fP\^, \fInrectangles\fP\^)
161
Display *\fIdisplay\fP\^;
167
XRectangle \fIrectangles\fP\^[\^]\^;
169
int \fInrectangles\fP\^;
172
Specifies the drawable.
174
Specifies the connection to the X server.
177
.IP \fInrectangles\fP 1i
178
Specifies the number of rectangles in the array.
179
.IP \fIrectangles\fP 1i
180
Specifies an array of rectangles.
181
.ds Wh , which specify the dimensions of the rectangle
186
Specify the width and height\*(Wh.
187
.ds Xy , which specify the upper-left corner of the rectangle
192
Specify the x and y coordinates\*(Xy.
198
functions draw the outlines of the specified rectangle or rectangles as
201
protocol request were specified for each rectangle:
203
[x,y] [x+width,y] [x+width,y+height] [x,y+height] [x,y]
205
For the specified rectangle or rectangles,
206
these functions do not draw a pixel more than once.
208
draws the rectangles in the order listed in the array.
209
If rectangles intersect,
210
the intersecting pixels are drawn multiple times.
212
Both functions use these GC components:
213
function, plane-mask, line-width,
214
line-style, cap-style, join-style, fill-style,
215
subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask.
216
They also use these GC mode-dependent components:
217
foreground, background, tile, stipple, tile-stipple-x-origin,
218
tile-stipple-y-origin, dash-offset, and dash-list.
239
unsigned short width, height;
243
All x and y members are signed integers.
244
The width and height members are 16-bit unsigned integers.
245
You should be careful not to generate coordinates and sizes
246
out of the 16-bit ranges, because the protocol only has 16-bit fields
251
A value for a Drawable argument does not name a defined Window or Pixmap.
254
A value for a GContext argument does not name a defined GContext.
259
window is used as a Drawable.
262
Some argument or pair of arguments has the correct type and range but fails
263
to match in some other way required by the request.