|
|
1.1 root 1: .TH XDEMO 1 "12 December 1985" "X Version 10"
2: .SH NAME
3: xdemo - demonstration program for X window system
4: .SH SYNOPSIS
5: .B xdemo
6: [ options ] demo [ =\fIgeometry\fP ] [ \fIhost\fP:\fInumber\fP ]
7: .SH DESCRIPTION
8: .I Xdemo
9: is a demonstration program for the X window system.
10: By default, the host and display number are extracted from the
11: environment variable ``DISPLAY''.
12: One can, however, specify a different display.
13: .I Host
14: specifies the host,
15: and
16: .I number
17: specifies the number of the display. For example, ``xdemo star orpheus:1''
18: will put the star demo on display one on machine orpheus.
19: Demo can be any of: balls, bounce, circle, circles, colors, cookie, draw, life,
20: lines, menulife, motion, plaid, qix, rgb, shades, slide, star, tetra,
21: wallpaper, web, and xor.
22: The colors, rgb, and shades demos will only work on color displays.
23: .PP
24: The window is created in the usual way using one of the mouse buttons.
25: Using the center button, depress the button to define one corner of the window,
26: move the cursor to where the opposite corner of the window should be
27: and release the button. Using the right button, depress the button to
28: define the default size window, move the cursor to position the window,
29: and release the button. Using the left button for all demos but colors,
30: life, and menulife, click the left button to place the default size window
31: in the upper left corner of the screen. Using the left button for the
32: colors, life, and menulife demos, depress the button to define the default
33: size window, move the cursor to position the window, and release the button.
34: .PP
35: The window can also be placed, or given a default size, with the standard
36: geometry specification:
37: .br
38: \fB=\fP\fIgeometry\fP
39: .br
40: The geometry specification can be used to set the size and location of the
41: window.
42: See \fIX(1)\fP for details.
43: .PP
44: Most of the demos run without user input: balls, bounce, circle, circles,
45: colors, lines, plaid, qix, slide, star, tetra, wallpaper, web, and xor.
46: Most of these have random number generators built in, and will produce
47: different results each time they are run, or each time the window is
48: resized.
49: .PP
50: .SH "MOUSE USAGE"
51: .PP
52: Mouse usage only applies on the demos draw, life, menulife, motion, rgb, and
53: shades.
54: .PP
55: In the draw demo, clicking the left button defines points that will
56: be connected by a spline when the center button is clicked.
57: If the center button is clicked twice in a row, the window is cleared.
58: Clicking the right button defines points to be connected by straight lines
59: when the center button is clicked.
60: Left and right button clicks can be combined in a single shape.
61: Clicking any button in one of the selection boxes at the upper left selects
62: a drawing mode: patterned gray line, solid white line, solid black line, dashed
63: white line, dashed black line, filled black, filled white, and filled gray.
64: The drawing function can be selected by placing the cursor over the function
65: box at the top right and typing a single hexadecimal digit (corresponding
66: to the characteristic function). For line drawing, the brush height and width
67: can be adjusted by placing the cursor over the height or width box and typing
68: a single hexadecimal digit. Text can be put into the picture by positioning
69: the mouse and typing. The color of the text is determined from the line/fill
70: color, and the display function is applied.
71: .PP
72: The motion demo uses the mouse to define points of a shape just as in the draw
73: demo, but moves the line drawing around the window, bouncing off the walls,
74: while randomly changing the points relative to each other.
75: .PP
76: The life demo uses the left button to randomly insert occupied cells into the
77: window and start the life program initially.
78: Clicking the center button will turn life on and off, so you can look
79: at interesting intermediate patterns,
80: and the right button is used to clear the `universe'.
81: .PP
82: The menulife demo uses the left button to set/clear individual cells while
83: the button is held down. The right button and the space bar can be used
84: to single step the generations. The middle button pops up a pull down menu.
85: Release the middle button on a selection for it to take effect; release outside
86: of all selections to abort. Changing rules takes a long time.
87: .PP
88: The rgb demo uses button operations in the three boxes at the top of the window
89: to change color values. The left button decrements the value, the right
90: button increments the value. If you press the middle button and then
91: move around, the vertical position of the mouse controls the value, with zero
92: intensity at the top of the box, and full intensity at the bottom of the box;
93: releasing the mouse button sets the final value.
94: .PP
95: The shades demo uses button clicks to change color values. A matrix of two
96: primary colors of varying intensity, with a third primary of constant intensity
97: is displayed. The right button increments the value of the third primary, the
98: left button decrements the value, and the middle button switches to a different
99: pair of initial primaries.
100: .SH OPTIONS
101: On color displays, colors can be specified in the command line:
102: .PP
103: .nf
104: \fB-fg=\fP\fIcolor\fP foreground (lines, text, etc.)
105: \fB-bg=\fP\fIcolor\fP background
106: \fB-bd=\fP\fIcolor\fP border
107: \fB-ms=\fP\fIcolor\fP mouse
108: \fB-fn=\fP\fIfont\fP font
109: .fi
110: .PP
111: Many demos ignore the foreground color and do random color selection.
112: .SH X DEFAULTS
113: .PP
114: For the following defaults, you can also give a demo-specific default by
115: prepending the demo name and a separating period, e.g., ``Plaid.Foreground''.
116: .PP
117: .TP 8
118: .B Background
119: To determine the background color.
120: .PP
121: .TP 8
122: .B Border
123: To determine the border color.
124: .PP
125: .TP 8
126: .B BorderWidth
127: To determine the border width.
128: .PP
129: .TP 8
130: .B BodyFont
131: To determine text font.
132: .PP
133: .TP 8
134: .B Foreground
135: To determine the foreground color.
136: .PP
137: .TP 8
138: .B Mouse
139: To determine the mouse cursor color.
140: .PP
141: .TP 8
142: .B MenuBackground
143: To determine the menu background color in menulife.
144: .PP
145: .TP 8
146: .B MenuForeground
147: To determine the menu text color in menulife.
148: .PP
149: .TP 8
150: .B MenuFont
151: To determine menu text font.
152: .PP
153: .TP 8
154: .B MenuMouse
155: To determine the menu mouse cursor color in menulife.
156: .SH COOKIE
157: The cookie monster wants you to give it a ``cookie'', of course.
158: .SH ENVIRONMENT
159: DISPLAY This program gets the display to use by default from this variable.
160: .SH AUTHOR
161: Bob Scheifler, MIT Laboratory for Computer Science.
162: Many of the demos are ripoffs:
163: balls, bounce, circle, circles, lines, plaid, slide, tetra, wallpaper, and xor
164: were taken from Lucasfilm,
165: web was taken from Steve Ward,
166: and qix from Symbolics.
167: Menulife written by Paul Johnson, MIT Laboratory for Computer Science.
168: .br
169: Copyright (c) 1985, Massachusetts Institute of Technology
170: .SH "SEE ALSO"
171: X(1), xterm(1), xwm(1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.