1t3d(6x)                       XScreenSaver manual                      t3d(6x)
2
3
4

NAME

6       t3d - clock using flying balls to display the time
7

SYNOPSIS

9       t3d [  options ]...
10

DESCRIPTION

12       Time  3D  is  a  clock.  It uses flying balls to display the time. This
13       balls move and wobble around to give you the  impression  your  graphic
14       workstation with its many XStones is doing something.
15
16       t3d  uses mouse and keyboard to let you fly through the balls. Hit S to
17       speed up, A to slow down, Z to zoom in and X to zoom out.  Use the left
18       mouse button to rotate to the left and the right mouse button to rotate
19       the view to the right. Use the middle mouse button to change the  opti‐
20       cal axis and the moving direction.  0 (zero) will stop you.  Q quits.
21

OPTIONS

23       -move factor
24              Modifies  the direction move of t3d. The clock looks 30 degrees*
25              factor to the left and to the right periodically.
26
27       -wobble factor
28              Modifies the wobbling (sounds nice :-) of t3d by multiplying the
29              default deformation of the clock with factor.
30
31       -minutes
32              Shows  one small ball for every minute, instead of one for every
33              2.5 minutes.
34
35       -mag factor
36              Changes the magnification  of  t3d.  By  default,  t3d  draws  a
37              200x200  image.   A  .I factor of 2 means, it will use a 400x400
38              image.
39
40       -cycle period
41              Sets the moving cycle to period seconds. By default, this  value
42              is 10 seconds.
43
44       -delay microsec
45              Inserts  a wait after drawing one view of the clock. By default,
46              t3d waits 40 ms after each drawing. This helps you to  keep  the
47              performance loss small.
48
49       -fast precalc_radius
50              t3d  uses bitmap copy to draw precalculated balls. You can spec‐
51              ify the radius in pixels up to  which  t3d  should  precalculate
52              balls.  t3d will set a useful range by itself using the magnifi‐
53              cation when it is started.
54
55       -colcycle
56              Draws cyclic the color scale used for the  balls  in  the  back‐
57              ground instead of the normal black.
58
59       -rgb red green blue
60              Selects  the  color  in RGB color space of the lightning spot on
61              the balls.  All the other colors used for balls or -colcycle are
62              less intensive colors of the same hue and saturation. All values
63              in range of 0 to 1.
64
65       -hsv hue saturation value
66              Selects the color in HSV color space.  hue is in degrees from  0
67              to 360, all other values in range from 0 to 1. It gives nice but
68              rather unpredictable results, if you use a saturation of e.g. 2.
69              Try it at your own risk.
70
71       -hsvcycle speed
72              Rotates the hue axis every 10 seconds* speed.
73
74       -help  Prints a short usage message.
75
76

AUTHOR

78       Bernd Paysan
79
80       Email: bernd.paysan@gmx.de
81
82       Hacked on by jwz@jwz.org for xscreensaver.
83
84

ACKNOWLEDGEMENT

86       Acknowledgement  to Georg Acher, who wrote the initial program display‐
87       ing balls.
88
89

COPYING

91       Copy, modify, and distribute T3D either under GPL version 2  or  newer,
92       or under the standard MIT/X license notice.
93
94

DISCLAIMER

96       T3D is not related to T3D(tm), the massive parallel Alpha--based super‐
97       computer from Cray Research. T3D's name was  invented  in  1991,  years
98       before  the project at Cray Research started. There is no relation from
99       T3D to Cray's T3D, even the  balls  surrounding  T3D  on  some  posters
100       weren't  an  inspiration for T3D. I don't know anything about the other
101       way round.
102
103       The programming style of T3D isn't intended as example of  good  style,
104       but  as example of how a fast prototyped demo may look like. T3D wasn't
105       created to be useful, it was created to be nice.
106
107

KNOWN BUGS

109       There are no known bugs in T3D. Maybe  there  are  bugs  in  X.  Slight
110       changes  in  the  T3D sources are known to show these bugs, e.g. if you
111       remove the (int) casting at the XFillArc x,y,w,h-coordinates...
112
113
114
115X Version 11                 5.05-3 (06-Apr-2008)                      t3d(6x)
Impressum