git.hungrycats.org Git - xscreensaver/blob - local/man/cat.1/t3d.1

   1
   2
   3
   4 t3d(1)                                                     t3d(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        t3d - clock using flying balls to display the time
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        t3d [  _\bo_\bp_\bt_\bi_\bo_\bn_\bs ]...
  12
  13 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  14        Time  3D  is  a clock. It uses flying balls to display the
  15        time. This balls move and wobble around to  give  you  the
  16        impression  your graphic workstation with its many XStones
  17        is doing something.
  18
  19        t3d uses mouse and keyboard to let  you  fly  through  the
  20        balls. Hit S\bS to speed up, A\bA to slow down, Z\bZ to zoom in and
  21        X\bX to zoom out.  Use the l\ble\bef\bft\bt m\bmo\bou\bus\bse\be b\bbu\but\btt\bto\bon\bn to rotate to the
  22        left  and the r\bri\big\bgh\bht\bt m\bmo\bou\bus\bse\be b\bbu\but\btt\bto\bon\bn to rotate the view to the
  23        right. Use the m\bmi\bid\bdd\bdl\ble\be m\bmo\bou\bus\bse\be b\bbu\but\btt\bto\bon\bn to change  the  optical
  24        axis and the moving direction.  0\b0 (zero) will stop you.  Q\bQ
  25        quits.
  26
  27
  28 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  29        -\b-m\bmo\bov\bve\be _\bf_\ba_\bc_\bt_\bo_\br
  30               Modifies the direction move of t3d. The clock looks
  31               30  degrees*  _\bf_\ba_\bc_\bt_\bo_\br  to  the left and to the right
  32               periodically.
  33
  34        -\b-w\bwo\bob\bbb\bbl\ble\be _\bf_\ba_\bc_\bt_\bo_\br
  35               Modifies the wobbling (sounds nice :-)  of  t3d  by
  36               multiplying  the  default  deformation of the clock
  37               with _\bf_\ba_\bc_\bt_\bo_\br_\b.
  38
  39        -\b-m\bmi\bin\bnu\but\bte\bes\bs
  40               Shows one small ball for every minute,  instead  of
  41               one for every 2.5 minutes.
  42
  43        -\b-m\bma\bag\bg _\bf_\ba_\bc_\bt_\bo_\br
  44               Changes  the  magnification of t3d. By default, t3d
  45               draws a 200x200 image.  A .I factor of 2 means,  it
  46               will use a 400x400 image.
  47
  48        -\b-c\bcy\byc\bcl\ble\be _\bp_\be_\br_\bi_\bo_\bd
  49               Sets   the  moving  cycle  to  _\bp_\be_\br_\bi_\bo_\bd  seconds.  By
  50               default, this value is 10 seconds.
  51
  52        -\b-w\bwa\bai\bit\bt _\bm_\bi_\bc_\br_\bo_\bs_\be_\bc
  53               Inserts a wait after drawing one view of the clock.
  54               By  default,  t3d  waits  40 ms after each drawing.
  55               This helps you to keep the performance loss  small.
  56
  57        -\b-f\bfa\bas\bst\bt _\bp_\br_\be_\bc_\ba_\bl_\bc_\b__\br_\ba_\bd_\bi_\bu_\bs
  58               t3d  uses  bitmap copy to draw precalculated balls.
  59               You can specify the radius in pixels  up  to  which
  60               t3d  should  precalculate  balls.  t3d  will  set a
  61
  62
  63
  64 Time 3D                    Version 1.1                          1
  65
  66
  67
  68
  69
  70 t3d(1)                                                     t3d(1)
  71
  72
  73               useful range by itself using the magnification when
  74               it is started.
  75
  76        -\b-c\bco\bol\blc\bcy\byc\bcl\ble\be
  77               Draws  cyclic the color scale used for the balls in
  78               the background instead of the normal black.
  79
  80        -\b-r\brg\bgb\bb _\br_\be_\bd _\bg_\br_\be_\be_\bn _\bb_\bl_\bu_\be
  81               Selects the color in RGB color space of the  light-
  82               ning  spot on the balls.  All the other colors used
  83               for balls or -\b-c\bco\bol\blc\bcy\byc\bcl\ble\be are less intensive colors of
  84               the same hue and saturation. All values in range of
  85               0 to 1.
  86
  87        -\b-h\bhs\bsv\bv _\bh_\bu_\be _\bs_\ba_\bt_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bv_\ba_\bl_\bu_\be
  88               Selects the color in HSV color space.   _\bh_\bu_\be  is  in
  89               degrees  from  0  to 360, all other values in range
  90               from 0 to 1. It gives nice but rather unpredictable
  91               results, if you use a saturation of e.g. 2.  Try it
  92               at your own risk.
  93
  94        -\b-h\bhs\bsv\bvc\bcy\byc\bcl\ble\be _\bs_\bp_\be_\be_\bd
  95               Rotates the hue axis every 10 seconds* _\bs_\bp_\be_\be_\bd_\b.
  96
  97        -\b-h\bhe\bel\blp\bp  Prints a short usage message.
  98
  99
 100
 101 A\bAU\bUT\bTH\bHO\bOR\bR
 102        Bernd Paysan
 103
 104        Email: bernd.paysan@gmx.de
 105
 106        Hacked on by jwz@jwz.org for xscreensaver.
 107
 108
 109 A\bAC\bCK\bKN\bNO\bOW\bWL\bLE\bED\bDG\bGE\bEM\bME\bEN\bNT\bT
 110        Acknowledgement to Georg Acher, who wrote the initial pro-
 111        gram displaying balls.
 112
 113
 114 C\bCO\bOP\bPY\bYI\bIN\bNG\bG
 115        Copy,  modify, and distribute T3D either under GPL version
 116        2 or newer, or under the standard MIT/X license notice.
 117
 118
 119 D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
 120        T3D is  not  related  to  T3D(tm),  the  massive  parallel
 121        Alpha--based  supercomputer from Cray Research. T3D's name
 122        was invented in 1991, years before  the  project  at  Cray
 123        Research  started. There is no relation from T3D to Cray's
 124        T3D, even  the  balls  surrounding  T3D  on  some  posters
 125        weren't  an  inspiration  for  T3D.  I don't know anything
 126        about the other way round.
 127
 128
 129
 130 Time 3D                    Version 1.1                          2
 131
 132
 133
 134
 135
 136 t3d(1)                                                     t3d(1)
 137
 138
 139        The programming style of T3D isn't intented as example  of
 140        good  style,  but as example of how a fast prototyped demo
 141        may look like. T3D wasn't created to  be  useful,  it  was
 142        created to be nice.
 143
 144
 145 K\bKN\bNO\bOW\bWN\bN B\bBU\bUG\bGS\bS
 146        There are no known bugs in T3D. Maybe there are bugs in X.
 147        Slight changes in the T3D sources are known to show  these
 148        bugs, e.g. if you remove the (int) casting at the XFillArc
 149        x,y,w,h-coordinates...
 150
 151
 152
 153
 154
 155
 156
 157
 158
 159
 160
 161
 162
 163
 164
 165
 166
 167
 168
 169
 170
 171
 172
 173
 174
 175
 176
 177
 178
 179
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196 Time 3D                    Version 1.1                          3
 197
 198