Debian Codegraph @

upstream/debian-unstable/man1/xgc.1

raw
1 .\" Copyright (c) 1991 X Consortium
2 .\"
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:
10 .\"
11 .\" The above copyright notice and this permission notice shall be included
12 .\" in all copies or substantial portions of the Software.
13 .\"
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.
21 .\"
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.
26 .\"
27 .\" Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
28 .\"
29 .\" Permission is hereby granted, free of charge, to any person obtaining a
30 .\" copy of this software and associated documentation files (the "Software"),
31 .\" to deal in the Software without restriction, including without limitation
32 .\" the rights to use, copy, modify, merge, publish, distribute, sublicense,
33 .\" and/or sell copies of the Software, and to permit persons to whom the
34 .\" Software is furnished to do so, subject to the following conditions:
35 .\"
36 .\" The above copyright notice and this permission notice (including the next
37 .\" paragraph) shall be included in all copies or substantial portions of the
38 .\" Software.
39 .\"
40 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
41 .\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
42 .\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
43 .\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
44 .\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
45 .\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
46 .\" DEALINGS IN THE SOFTWARE.
47 .\"
48 .TH XGC 1 "xgc 1.0.6" "X Version 11"
49 .SH NAME
50 xgc - X graphics demo
51 .SH SYNOPSIS
52 .ta 8n
53 \fBxgc\fP [-\fItoolkitoption\fP ...]
54 .SH DESCRIPTION
55 The
56 .I xgc
57 program demonstrates various features of the X graphics primitives.
58 In X, most of the details about the graphics to be generated are
59 stored in a resource called a graphics context (GC). The
60 .B xgc
61 program provides a user interface for setting various GC components.
62 Pressing the "Run" button causes these results to be displayed in
63 the large drawing window on the right. Timing information is
64 displayed in the window immediately below.
65 .PP
66 The items in the upper left hand window work as follows:
67 .PP
68 .I Function
69 \- specify the logical function with which primitives
70 will drawn. The most usual setting is "set", i.e. simply to render
71 pixels without regard to what has been drawn before.
72 .PP
73 .I LineStyle
74 \- specify whether lines should be drawn solid in foreground,
75 dashed in foreground or alternating foreground and background.
76 .PP
77 .I CapStyle
78 \- specify the appearance of the ends of a line.
79 .PP
80 .I JoinStyle
81 \- specify the appearance of joints between consecutive
82 lines drawn within a single graphics primitive.
83 .PP
84 .I FillStyle
85 \- specify whether lines, text and fill requests are
86 solid, tiled with a pixmap or stippled.
87 .PP
88 .I FillRule
89 \- specifies the rule used to fill polygons. The EvenOdd
90 rule means that if areas overlap an odd number of times, they are not
91 drawn. Winding rule means that overlapping areas are always filled,
92 regardless of how many times they overlap.
93 .PP
94 .I ArcMode
95 \- specifies the rule for filling of arcs. The boundary
96 of the arc is either a Chord or two radii.
97 .PP
98 .I planemask
99 \- specifies which planes of the drawing window are
100 modified. By default, all planes are modified.
101 .PP
102 .I dashlist
103 \- specifies a pattern to be used when drawing dashed lines.
104 .PP
105 .I Line Width
106 \- specifies the width in pixels of lines to be drawn.
107 Zero means to draw using the server's fastest algorithm with a line width of
108 one pixel.
109 .PP
110 .I Font
111 \- specifies the font to be used for text primitives.
112 .PP
113 .I Foreground
114 and
115 .I Background
116 \- specify the pixel values to be
117 applied when drawing primitives.
118 The Foreground value is used as the
119 pixel value for set bits in the source in all primitives.
120 The Background value is used as the
121 pixel value for unset bits in the source when using Copy Plane, drawing
122 lines with LineStyle of DoubleDash and filling with FillStyle of
123 OpaqueStippled.
124 .PP
125 .I Percentage of Test
126 \- scrollbar permits specifying only
127 a percentage of the test to be run. The number at the left indicates
128 the current setting, which defaults to 100%.
129 .sp
130 The window labeled "Test" permits choice of one a number of graphics
131 primitive tests, including Points, Segments, Lines, Arcs and Filled Arcs,
132 8-bit Text and Image Text, Rectangles and Filled Rectangles, Image draws,
133 as well as Copy Plane and Copy Area.
134 .PP
135 The window to the right of this has buttons which permit record/playback
136 of the primitives rendered.
137 .SH OPTIONS
138 .I Xgc
139 accepts all of the standard X Toolkit command line options.
140 .SH X DEFAULTS
141 This program accepts the usual defaults for toolkit applications.
142 .SH ENVIRONMENT
143 .PP
144 .TP 8
145 .B DISPLAY
146 to get the default host and display number.
147 .TP 8
148 .B XENVIRONMENT
149 to get the name of a resource file that overrides the global resources
150 stored in the RESOURCE_MANAGER property.
151 .SH "SEE ALSO"
152 X(7)
153 .SH BUGS
154 This program isn't really finished yet, but it probably never will be,
155 since it only demonstrates the original X11 core protocol rendering
156 operations, which few modern programs use anymore.
157 .SH AUTHORS
158 Dan Schmidt, MIT