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