~ubuntu-branches/ubuntu/dapper/xscreensaver/dapper-updates

« back to all changes in this revision

Viewing changes to hacks/glx/boing.man

  • Committer: Bazaar Package Importer
  • Author(s): Ralf Hildebrandt
  • Date: 2005-04-09 00:06:43 UTC
  • mfrom: (1.1.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 3.
  • Revision ID: james.westby@ubuntu.com-20050409000643-z0abtifbt9s20pcc
Tags: 4.21-3
Patch by Joachim Breitner to check more frequently if DPMS kicked in (closes: #303374, #286664).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH XScreenSaver 1 "30-Oct-99" "X Version 11"
 
2
.SH NAME
 
3
boing - draws a bouncing ball like the ancient Amiga demo
 
4
.SH SYNOPSIS
 
5
.B boing
 
6
[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install]
 
7
[\-visual \fIvisual\fP] 
 
8
[\-delay \fIusecs\fP] 
 
9
[\-smooth]
 
10
[\-lighting]
 
11
[\-scanlines]
 
12
[\-speed]
 
13
[\-no\-spin]
 
14
[\-angle \fIdegrees\fP]
 
15
[\-size \fIratio\fP]
 
16
[\-parallels \fIn\fP]
 
17
[\-meridians \fIn\fP]
 
18
[\-wireframe]
 
19
[\-fps]
 
20
.SH DESCRIPTION
 
21
The \fIboing\fP program draws a bouncing checkered ball on a grid.
 
22
 
 
23
This is a clone of the first graphics demo for the Amiga 1000, which
 
24
was written by Dale Luck and RJ Mical during a break at the 1984
 
25
Consumer Electronics Show (or so the legend goes.)  The boing ball was
 
26
briefly the official logo of Amiga Inc., until they were bought by
 
27
Commodore later that year.
 
28
 
 
29
With no arguments, this program looks a lot like the original Amiga
 
30
demo. With "-smooth -lighting", it looks... less old.
 
31
.SH OPTIONS
 
32
.I boing
 
33
accepts the following options:
 
34
.TP 8
 
35
.B \-window
 
36
Draw on a newly-created window.  This is the default.
 
37
.TP 8
 
38
.B \-root
 
39
Draw on the root window.
 
40
.TP 8
 
41
.B \-install
 
42
Install a private colormap for the window.
 
43
.TP 8
 
44
.B \-visual \fIvisual\fP\fP
 
45
Specify which visual to use.  Legal values are the name of a visual class,
 
46
or the id number (decimal or hex) of a specific visual.
 
47
.TP 8
 
48
.B \-delay \fIusecs\fP
 
49
The delay between frames of the animation, in microseconds: default 15000.
 
50
.TP 8
 
51
.B \-smooth
 
52
Draw a smooth sphere instead of a faceted polyhedron.
 
53
.TP 8
 
54
.B \-lighting
 
55
Do shaded lighting instead of flat colors.
 
56
.TP 8
 
57
.B \-scanlines
 
58
If the window is large enough, draw horizontal lines to simulate the
 
59
scanlines on a low resolution monitor.
 
60
.TP 8
 
61
.B \-speed \fIratio\fP
 
62
Change the animation speed; 0.5 to go half as fast, 2.0 to go twice as fast.
 
63
.TP 8
 
64
.B \-no\-spin
 
65
Don't rotate the ball.
 
66
.TP 8
 
67
.B \-angle \fIdegrees\fP
 
68
The jaunty angle at which the ball sits.  Default 15 degrees.
 
69
.TP 8
 
70
.B \-size \fIratio\fP
 
71
How big the ball is; default 0.5 meaning about half the size of the window.
 
72
.TP 8
 
73
.B \-parallels \fIn\fP
 
74
.B \-meridians \fIn\fP
 
75
The pattern of rectangles on the ball.  Default 8x16.
 
76
.TP 8
 
77
.B \-wireframe
 
78
Look crummy.
 
79
.TP 8
 
80
.B \-fps
 
81
Display a running tally of how many frames per second are being rendered.
 
82
In conjunction with \fB\-delay 0\fP, this can be a useful benchmark of
 
83
your GL performance.
 
84
.SH ENVIRONMENT
 
85
.PP
 
86
.TP 8
 
87
.B DISPLAY
 
88
to get the default host and display number.
 
89
.TP 8
 
90
.B XENVIRONMENT
 
91
to get the name of a resource file that overrides the global resources
 
92
stored in the RESOURCE_MANAGER property.
 
93
.SH SEE ALSO
 
94
.BR bsod (1),
 
95
.BR pong (1),
 
96
.BR xscreensaver (1),
 
97
.BR X (1)
 
98
.SH COPYRIGHT
 
99
Copyright \(co 2005 by Jamie Zawinski.  Permission to use, copy, modify, 
 
100
distribute, and sell this software and its documentation for any purpose is 
 
101
hereby granted without fee, provided that the above copyright notice appear 
 
102
in all copies and that both that copyright notice and this permission notice
 
103
appear in supporting documentation.  No representations are made about the 
 
104
suitability of this software for any purpose.  It is provided "as is" without
 
105
express or implied warranty.
 
106
.SH AUTHOR
 
107
Jamie Zawinski <jwz@jwz.org>, 19-Feb-2005.