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

   1
   2
   3
   4 XScreenSaver(1)                                   XScreenSaver(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        penrose - draws quasiperiodic tilings
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        p\bpe\ben\bnr\bro\bos\bse\be [-display _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn] [-foreground _\bc_\bo_\bl_\bo_\br]
  12        [-background _\bc_\bo_\bl_\bo_\br] [-window] [-root]  [-mono]  [-install]
  13        [-visual  _\bv_\bi_\bs_\bu_\ba_\bl] [-ncolors _\bi_\bn_\bt_\be_\bg_\be_\br] [-delay _\bm_\bi_\bc_\br_\bo_\bs_\be_\bc_\bo_\bn_\bd_\bs]
  14        [-redoDelay    _\bs_\be_\bc_\bo_\bn_\bd_\bs]    [-size    _\bi_\bn_\bt_\be_\bg_\be_\br]    [-ammann]
  15        [-no-ammann]
  16
  17
  18 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  19        The _\bp_\be_\bn_\br_\bo_\bs_\be program draws quasiperiodic tilings.
  20
  21        See  Onoda,  Steinhardt,  DiVincenzo  and Socolar in Phys.
  22        Rev. Lett. 60, #25, 1988 or  Strandburg  in  Computers  in
  23        Physics, Sep/Oct 1991.
  24
  25        This implementation uses the simpler version of the growth
  26        algorithm, i.e., if there are no forced vertices,  a  ran-
  27        domly chosen tile is added to a randomly chosen vertex (no
  28        preference for those 108 degree angles).
  29
  30        There are two essential differences to the algorithm  pre-
  31        sented  in  the  literature:  First,  we  do not allow the
  32        tiling to enclose an untiled area.  Whenever  this  is  in
  33        danger  of  happening, we just do not add the tile, hoping
  34        for a better random choice the next  time.   Second,  when
  35        choosing  a  vertex  randomly,  we will take one that lies
  36        withing the viewport if available.  If this seems to cause
  37        enclosures  in the forced rule case, we will allow invisi-
  38        ble vertices to be chosen.
  39
  40        Tiling is restarted whenever one of the following happens:
  41        there  are  no  incomplete vertices within the viewport or
  42        the tiling has extended a window's length beyond the  edge
  43        of  the  window  horizontally or vertically or forced rule
  44        choice has failed 100 times due to areas about  to  become
  45        enclosed.
  46
  47        Although  quasiperiodic  tilings  are  produced, the tiles
  48        themselves are not penrose tiles  (darts  and  kites).  In
  49        contrast  to penrose tiles, these tiles can be arranged to
  50        form a periodic tiling.
  51
  52
  53 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  54        _\bp_\be_\bn_\br_\bo_\bs_\be accepts the following options:
  55
  56        -\b-w\bwi\bin\bnd\bdo\bow\bw Draw on  a  newly-created  window.   This  is  the
  57                default.
  58
  59        -\b-r\bro\boo\bot\bt   Draw on the root window.
  60
  61
  62
  63
  64 X Version 11                10-May-97                           1
  65
  66
  67
  68
  69
  70 XScreenSaver(1)                                   XScreenSaver(1)
  71
  72
  73        -\b-m\bmo\bon\bno\bo   If   on  a  color  display,  pretend  we're  on  a
  74                monochrome display.
  75
  76        -\b-i\bin\bns\bst\bta\bal\bll\bl
  77                Install a private colormap for the window.
  78
  79        -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
  80                Specify which visual to use.  Legal values are the
  81                name  of a visual class, or the id number (decimal
  82                or hex) of a specific visual.
  83
  84        -\b-n\bnc\bco\bol\blo\bor\brs\bs _\bi_\bn_\bt_\be_\bg_\be_\br
  85                How many colors  should  be  used  (if  possible).
  86                Default 64.  The colors are chosen randomly.
  87
  88        -\b-s\bsi\biz\bze\be _\bi_\bn_\bt_\be_\bg_\be_\br
  89                How big the tiles should be.  Default 40 pixels.
  90
  91
  92        -\b-d\bde\bel\bla\bay\by _\bm_\bi_\bl_\bl_\bi_\bs_\be_\bc_\bo_\bn_\bd_\bs
  93                How  long (in 1/1,000,000'ths of a second) to wait
  94                between drawing each tile.  Default 10,000 or  .01
  95                seconds.
  96
  97
  98        -\b-r\bre\bed\bdo\boD\bDe\bel\bla\bay\by _\bs_\be_\bc_\bo_\bn_\bd_\bs
  99                How long to wait between starting a completely new
 100                tiling.  Default 3 seconds.
 101
 102
 103        -\b-a\bam\bmm\bma\ban\bnn\bn _\bi_\bn_\bt_\be_\bg_\be_\br
 104
 105        -\b-n\bno\bo-\b-a\bam\bmm\bma\ban\bnn\bn _\bi_\bn_\bt_\be_\bg_\be_\br
 106                Whether Ammann lines should be added.
 107
 108
 109 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
 110        D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
 111
 112        X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
 113                to get the name of a resource file that  overrides
 114                the  global  resources stored in the RESOURCE_MAN-
 115                AGER property.
 116
 117 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 118        X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), x\bxl\blo\boc\bck\bk(1)
 119
 120 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
 121        Copyright (C) 1996 by Timo Korvola.
 122
 123        Permission to use, copy, modify, and distribute this soft-
 124        ware and its documentation for any purpose and without fee
 125        is hereby  granted,  provided  that  the  above  copyright
 126        notice  appear  in all copies and that both that copyright
 127
 128
 129
 130 X Version 11                10-May-97                           2
 131
 132
 133
 134
 135
 136 XScreenSaver(1)                                   XScreenSaver(1)
 137
 138
 139        notice and this permission  notice  appear  in  supporting
 140        documentation.
 141
 142 A\bAU\bUT\bTH\bHO\bOR\bR
 143        Timo Korvola <tkorvola@dopey.hut.fi>, 1996.
 144
 145        Ability  to  run  standalone or with _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br added by
 146        Jamie Zawinski <jwz@jwz.org>, 10-May-97.
 147
 148
 149
 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 X Version 11                10-May-97                           3
 197
 198