~ubuntu-branches/ubuntu/karmic/xpuzzles/karmic

« back to all changes in this revision

Viewing changes to xpyraminx/xpyraminx.hlp

  • Committer: Bazaar Package Importer
  • Author(s): Adam Conrad
  • Date: 2005-08-22 16:29:42 UTC
  • mfrom: (2.1.1 sarge)
  • Revision ID: james.westby@ubuntu.com-20050822162942-tdtf178zkpd3xxdg
Tags: 7.1.3-1ubuntu1
Update {build-,}depends for xorg -> mesa transition.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
6 XPYRAMINX
2
 
 
3
 
 
4
 
2 Games and Demos                                      XPYRAMINX(6)
5
 
 
6
 
xpyraminx - Pyramid X widget
7
 
 
8
 
/usr/games/xpyraminx   [-geometry   [{width}][x{height}][{+-
9
 
}{xoff}[{+-}{yoff}]]] [-display [{host}]:[{vs}]] [-[no]mono]
10
 
[-[no]{reverse|rv}]    [-{foreground|fg}     {color}]     [-
11
 
{background|bg}    {color}]    [-{border|bd}   {color}]   [-
12
 
face{0|1|2|3} {color}]  [-{size  {int}  |  sticky}]  [-{mode
13
 
{int}  | both}] [-[no]orient] [-[no]practice] [-delay msecs]
14
 
[-{font|fn} {fontname}] [-username {string}]
15
 
 
16
 
2 The original puzzle has 9 triangles per face (size = 3)  and
17
 
has  period  3  turning (i.e. the face or points turn in 120
18
 
degree intervals).  The puzzle was designed by  Uwe  Meffert
19
 
and   called   the   Pyraminx.   This  has  2^5*3^8*6!/2  or
20
 
75,582,720 different comibinations.
21
 
 
22
 
2 Another puzzle Senior Pyraminx 3x3x3 exists only  on  paper,
23
 
it  has  period  2 turning (i.e.  edges turn with 180 degree
24
 
intervals) but the corners would fall off unless it had some
25
 
tricky  mechanism.   (This  may  be  the  same as the Master
26
 
2 Pyraminx which has  446,965,972,992,000  different  combina-
27
 
tions).
28
 
 
29
 
2 Another puzzle  (which  was  not  widely  distributed),  the
30
 
2 Junior  Pyraminx  (and similarly the Junior Pyraminx Star, a
31
 
octahedron formed by two  tetrahedra,  this  has  7!*3^6  or
32
 
3,674,160  different  combinations), has 4 triangles (size =
33
 
2) per face.  This puzzle has been recently reissued by Mef-
34
 
fert  as  Pyramorphix  (http://www.mefferts-puzzles.com). At
35
 
the time I designed this computer puzzle thought that it had
36
 
only  period 2 turning (i.e the edges rotate).  It turns out
37
 
the puzzle has a period 4 turning (edges turn with 90 degree
38
 
intervals)  which  makes  it  analogous to the 2x2x2 Rubik's
39
 
cube.  This puzzle  makes  various  non-tetrahedral  shapes.
40
 
2 The  puzzle contained here has no period 4 turning flexabil-
41
 
ity.
42
 
 
43
 
2 One is able to simulate Halpern's  Tetrahedron  or  Pyraminx
44
 
2 Tetrahedron  (period  3 turning and sticky mode).   Also one
45
 
is able to simulate one with variant turning (period 2 turn-
46
 
ing and sticky mode).
47
 
 
48
 
2 FEATURES
49
 
2 Press "mouse-left" button to move a piece.  Release  "mouse-
50
 
left" button on a piece on the same face and in the same row
51
 
(but not an adjacent piece or the move is  ambiguous).   The
52
 
pieces  will  then  turn  towards where the mouse button was
53
 
released.
54
 
 
55
 
2 V7.1                Last change: 29 Aug 2004                    1
56
 
 
57
 
2 Games and Demos                                      XPYRAMINX(6)
58
 
 
59
 
2 Click "mouse-center", or press "P" or "p" keys to toggle the
60
 
practice mode (in practice mode the record should say "prac-
61
 
tice").  This is good for learning moves and experimenting.
62
 
 
63
 
2 Click "mouse-right", or press "R" or "r" keys  to  randomize
64
 
(this must be done first to set a new record).
65
 
 
66
 
2 Press "I" or "i" keys to increase the number of "facets".
67
 
 
68
 
2 Press "D" or "d" keys to decrease the number of "facets".
69
 
 
70
 
2 Press "O" or "o" keys to toggle the orient mode.  One has to
71
 
orient  the  faces  in  orient mode, besides getting all the
72
 
faces to be the same color.  To do this one has to  get  the
73
 
lines  to  be  oriented  in  the  same  direction, this only
74
 
matters  with  center  "facets",  if  at  all  (i.e.   those
75
 
"facets" not on a corner or edge).  This does add complexity
76
 
so there are 2 sets of records.
77
 
 
78
 
2 Press "2", "3", "B", or "b" keys (not the keypad  2,  3)  to
79
 
change modes to Period 2, Period 3, or Both.
80
 
 
81
 
2 Press   "Y"   or   "y"   keys   to   toggle   sticky    mode
82
 
(increase/decrease is disabled here if sticky mode is on).
83
 
"Sticky" and "Period 2" turning allows  only  the  edges  to
84
 
turn,  and  the 2 center rows turn together. It is as if the
85
 
middle cut of the three cuts did not exist.
86
 
"Sticky" and "Period 3" turning allows  only  the  faces  to
87
 
turn,  it  is as if the middle cut of the three cuts did not
88
 
exist.
89
 
2 Beware, the "Sticky" mode is a hack and much could  be  done
90
 
to improve its look.
91
 
 
92
 
2 Press "S" or "s" keys to start auto-solver.  Only  works  on
93
 
1x1x1, 2x2x2, and 3x3x3 pyrmaminxs in Period 3 mode.
94
 
 
95
 
2 Press "U" or "u" keys to undo move.
96
 
 
97
 
2 Press "G" or "g" keys to get a saved puzzle.
98
 
 
99
 
2 Press "W" or "w" keys to write or save a puzzle.
100
 
 
101
 
2 Press "C" or "c" keys to clear a puzzle.
102
 
 
103
 
2 Press "Esc" key to hide program.
104
 
 
105
 
2 Press "Q", "q", or "CTRL-C" keys to kill program.
106
 
 
107
 
2 Use the key pad, "R" keys, or arrow  keys  to  move  without
108
 
mouse clicks.
109
 
2 Key pad is defined for Pyraminx as:
110
 
  /     Counterclockwise
111
 
 
112
 
2 V7.1                Last change: 29 Aug 2004                    2
113
 
 
114
 
2 Games and Demos                                      XPYRAMINX(6)
115
 
 
116
 
  8 9   Up, Upper Right
117
 
  ^
118
 
4<5>6   Left, Clockwise, Right
119
 
  v
120
 
1 2     Lower Left, Down
121
 
 
122
 
2 Use the shift keys to access "Period 3"  turns  from  "Both"
123
 
mode,  otherwise  it  assumes "Period 2" turning.  Faces and
124
 
points turn in "Period 3"  and  edges  (2  points)  turn  in
125
 
"Period 2".
126
 
 
127
 
2 Use the control key and the left mouse  button,  keypad,  or
128
 
arrow  keys  to  move  the  whole  tetrahedron.  This is not
129
 
recorded as a turn.
130
 
 
131
 
2 The title is in the following format (non-motif version):
132
 
     xpyraminx.{2|3|both<turning                    modes>}:
133
 
     {1|2|3|4|5|6|7|sticky<number  of  "facets" per edge>} @
134
 
     (<Number   of   moves>/{<Record   number   of    moves>
135
 
     <username>|"NEVER noaccess"|"practice"}) - <Comment>
136
 
2 If there is no record of the  current  puzzle,  it  displays
137
 
"NEVER noaccess".
138
 
 
139
 
2 OPTIONS
140
 
-geometry {+|-}X{+|-}Y
141
 
        This option sets the initial position of the  pyram-
142
 
        inx window (resource name "geometry").
143
 
 
144
 
-display host:dpy
145
 
        This option specifies the X server to contact.
146
 
 
147
 
-[no]mono
148
 
        This option allows you to  display on a color screen
149
 
        as if monochrome (resource name "mono").
150
 
 
151
 
-[no]{reverse|rv}
152
 
        This option allows you to see the pyraminx window in
153
 
        reverse video (resource name "reverse").
154
 
 
155
 
-{foreground|fg} color
156
 
        This option specifies the foreground of the pyraminx
157
 
        window (resource name "foreground").
158
 
 
159
 
-{background|bg} color
160
 
        This option specifies the background of the pyraminx
161
 
        window (resource name "background").
162
 
 
163
 
-{border|bd} color
164
 
        This option specifies the border color of the facets
165
 
        in  the  pyraminx  window  (resource  name  "border-
166
 
        Color").
167
 
 
168
 
2 V7.1                Last change: 29 Aug 2004                    3
169
 
 
170
 
2 Games and Demos                                      XPYRAMINX(6)
171
 
 
172
 
-face{0|1|2|3} <color>
173
 
        This option allows you to change the color of a face
174
 
        (resource name "faceColorN"). In mono-mode, color is
175
 
        represented as the first letter of the  color  name.
176
 
        The  faces  are  ordered  top  to bottom and left to
177
 
        right.  If you has two colors that  begin  with  the
178
 
        same letter you should have one in uppercase and one
179
 
        in lowercase to distinguish them in  mono-mode.  You
180
 
        can  change the colors of the faces to make a stupid
181
 
        pyraminx (i.e. all White or in mono-mode  all  "W").
182
 
        Unfortunately,  it  will not normally say its solved
183
 
        when its randomized.  This would be cheating.
184
 
 
185
 
-size <int>
186
 
        This option allows  you  to  change  the  number  of
187
 
        facets on a edge (resource name "size").
188
 
 
189
 
-sticky This option  allows  you  to  set  the  sticky  mode
190
 
        (resource name "sticky").
191
 
 
192
 
-mode <int>
193
 
        This option allows  you  to  set  the  turning  mode
194
 
        (resource name "mode").
195
 
 
196
 
-both   This option allows you to set the  turning  mode  to
197
 
        both period 2 and period 3 (resource name "mode" set
198
 
        at 4).
199
 
 
200
 
-[no]orient
201
 
        This option allows you to  access  the  orient  mode
202
 
        (resource name "orient").
203
 
 
204
 
-[no]practice
205
 
        This option allows you to access the  practice  mode
206
 
        (resource name "practice").
207
 
 
208
 
-delay msecs
209
 
        This option specifies the number of milliseconds  it
210
 
        takes  to  move a tile or a group of tiles one space
211
 
        (resource name "delay").
212
 
 
213
 
-{font|fn} ontname
214
 
        This option specifies the font  that  will  be  used
215
 
        (resource name "font").
216
 
 
217
 
-username string
218
 
        This option specifies the user name for any  records
219
 
        made  or  else it will get your login name (resource
220
 
        name "userName").
221
 
 
222
 
2 RECORDS
223
 
2 You must randomize  the  puzzle  before  a  record  is  set,
224
 
 
225
 
2 V7.1                Last change: 29 Aug 2004                    4
226
 
 
227
 
2 Games and Demos                                      XPYRAMINX(6)
228
 
 
229
 
otherwise  an assumption of cheating is made if it is solved
230
 
after a get or an auto-solve.
231
 
 
232
 
2 SAVE_FORMAT
233
 
2 The format is not standard.  The reason  for  this  is  that
234
 
this  is  simple  to produce and the standard notation is no
235
 
good for variable number of "facets" and turning modes.
236
 
 
237
 
2 Pyraminx with default colors, not randomized:
238
 
0     B     Blue
239
 
  1     R   Red
240
 
2     Y     Yellow
241
 
  3     G   Green
242
 
 
243
 
     size: 1-7 <number of triangles in the same  orientation
244
 
     as the face per row>
245
 
     mode: 2-4 <period 2 turning, period 3 turning, or  both
246
 
     (4)>
247
 
     orient: 0-1 <0 false,  1  true;  if  1  then  lines  on
248
 
     "facets" to be oriented>
249
 
     sticky: 0-1 <0 false, 1 true; if 1 then  some  "facets"
250
 
     move together>
251
 
     practice: 0-1 <0 false, 1 true>
252
 
     moves: 0-MAXINT <total number of moves>
253
 
 
254
 
     startingPosition: <2 dimensional array of face  "facet"
255
 
     position, each face has size * size "facets", if orient
256
 
     mode then orientation number follows face number: 0 up,
257
 
     1  upper  right,  2  right, 3 down, 4 lower left, and 5
258
 
     left>
259
 
 
260
 
2 This is then followed by the moves, starting from 1.
261
 
     move #: <face> <position> <direction> <control>
262
 
2 Each turn is with respect to a face and position.
263
 
2 Position is 0 to size * size - 1.  Position 0 is the  trian-
264
 
gle furthest from the center, increasing clockwise.
265
 
2 Direction is represented 0 up, 1 upper  right,  2  right,  3
266
 
down,  4  lower  left,  5 left, 9 clockwise, and 15 counter-
267
 
clockwise.
268
 
2 Control is represented as 0 or 1, 1 if the whole tetrahedron
269
 
is  moved at once (here position does not matter), 0 if not.
270
 
2 The xpyraminx record keeper does not count a control move as
271
 
a move, but here we do.
272
 
 
273
 
2 If you have a Pyraminx you can not solve (2x2x2  or  3x3x3),
274
 
enter  it  in pyraminx.log file.  Have size = 2 or 3, mode =
275
 
3, orient = 0, practice = 0, randomized = 1, and moves  =  0
276
 
and  the number representation for the color of the "facets"
277
 
(usually 0=B, 1=R, 2=Y, 3=G).  Bring up xpyraminx,  hit  'g'
278
 
so it will get your configuration and then 's' to solve your
279
 
pyraminx and then 'w' to write out the steps.  Then  examine
280
 
your pyraminx.log file.
281
 
 
282
 
2 V7.1                Last change: 29 Aug 2004                    5
283
 
 
284
 
2 Games and Demos                                      XPYRAMINX(6)
285
 
 
286
 
2 REFERENCES
287
 
2 James G Nourse, The Simple Solutions to Cubic Puzzles,  Ban-
288
 
tam Books, New York, November 1981, pp 8-15.
289
 
 
290
 
2 Mastering the Magic Pyramid by Tom Werneck,  Evans  Brothers
291
 
2 Limited, London, 1981. pp 109-111.
292
 
 
293
 
2 Douglas R. Hofstadter, Beyond Rubik's Cube: spheres,  pyram-
294
 
ids, dodecahedrons and God knows what else, Scientific Amer-
295
 
ican, July 1982, pp 16-31.
296
 
 
297
 
2 John Ewing & Czes Kosniowski, Puzzle it Out:  Cubes,  Groups
298
 
and  Puzzles, Cambridge University Press, New York, 1982, pp
299
 
60-61.
300
 
 
301
 
2 Magic Cubes 1996 Catalog of Dr. Christoph Bandelow.
302
 
 
303
 
2 SEE_ALSO
304
 
2 X(1), xrubik(6), xskewb(6),  xdino(6),  xoct(6),  xmball(6),
305
 
xmlink(6),   xpanex(6),   xcubes(6),  xtriangles(6),  xhexa-
306
 
gons(6), xabacus(6)
307
 
 
308
 
2 COPYRIGHTS
309
 
(Reg.) Copyright 1994-2004, David Albert Bagley
310
 
 
311
 
2 BUG_REPORTS AND PROGRAM UPDATES
312
 
2 Send bugs (or their reports, or fixes) to the author:
313
 
     David Albert Bagley, <bagleyd@tux.org>
314
 
 
315
 
2 The latest version is currently at:
316
 
     ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
317
 
     ftp://ibiblio.org/pub/Linux/games/strategy
318
 
 
319
 
2 V7.1                Last change: 29 Aug 2004                    6
320