Provided by: xpuzzles_8.8.7+ds-2_amd64 bug

NAME

       xpanex - Panex X widget

SYNOPSIS

       /usr/games/xpanex  [-geometry  [{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]]  [-display  [{host}]:[{vs}]]
       [-[no]mono] [-[no]{reverse|rv}]  [-{foreground|fg}  {color}]  [-{background|bg}  {color}]  [-pyramid{0|1}
       {color}]  [-tile  {color}]  [-frame  {color}] [-[no]stippleFrame] [-delay msecs] [-[no]sound] [-moveSound
       {filename}] [-{font|fn} {fontname}]  [-tiles  {int}]  [-{mode  {int}|hanoi|algorithme|panex}]  [-userName
       {string}] [-scoreFile {filename}] [-scores] [-version]

DESCRIPTION

       Panex  -  A grooved sliding tile puzzle created by Toshio Akanuma and manufactured by the Tricks Co., Ltd
       of Tokyo, Japan (a Magic Company) in the 1980's.  Mathematicians  at  Bell  Laboratories  calculated  the
       number  of  moves  to  be  27,564  to  31,537.  It came in two varieties: one with a magenta and a orange
       pyramid of order 10 on silver tiles; in the gold version pieces of each color look alike (i.e. no pyramid
       is drawn on them), this is a little harder.  The goal in this puzzle is to simply exchange the  2  piles.
       Pieces with smaller trapazoids cannot go down as far as pieces with bigger trapazoids.

       The  original  Tower of Hanoi puzzle is the invention of Edouard Lucas and was sold as a toy in France in
       1883.  The legend of 64 disks in the great temple of Benares of the god Brahma  is  also  his  invention.
       The goal in this puzzle is to move the pile from the left side to the right most column.  Unlike panex, a
       large trapazoid cannot go on top of a smaller one, but pieces always fall to the bottom.

       The  original  Algorithme  6  is  2  stacks  of  3 wooden spheres on 2 of 3 posts.  The spheres come in 3
       different sizes.  The goal goal is to swap the spheres using the posts without putting a bigger sphere on
       a smaller one and without exceeding the size of the  post.   It  was  created  and  produced  by  Patrick
       Farvacque  around  1997.   The puzzle presented here has a simpler solution because the tiles are all the
       same height (i.e. a 39 move solution as opposed to 66).

FEATURES

       Press "mouse-left" button to move a tile in the top tile of a column.   Release  "mouse-left"  button  on
       another column to move the tile to that column.  It will not move if blocked.

       Click "mouse-right" button, or press "C" or "c" keys, to clear the puzzle.

       Press "G" or "g" keys to read (get) a saved puzzle.

       Press "W" or "w" keys to save (write) a puzzle.

       Press "U" or "u" keys to undo a move.

       Press "R" or "r" keys to redo a move.

       Press "S" or "s" keys to auto-solve.  Unfortunately, its only implemented from the starting position.

       Press  "M" or "m" keys to switch between Hanoi (one pyramid column), Algorithme, and Panex, (each has two
       pyramid columns) modes (they each have different rules).
       In Hanoi, one cannot place larger trapezoid on a smaller trapezoid.  Here the goal is to  move  the  pile
       from the left peg to the rightmost peg.
       Algorithme  is  similar, here we must exchange tiles and we are limited by the size of the stack.  A move
       from stack 1 to stack 3 and vice-versa when stack 2 is full.
       In Panex, a tile cannot go lower that its initial starting point.  Here again, the goal  is  to  exchange
       the 2 piles.

       Press "I" or "i" keys to increase the number of tiles.

       Press "D" or "d" keys to decrease the number of tiles.

       Press ">" or "." keys to speed up the movement of tiles.

       Press "<" or "," keys to slow down the movement of tiles.

       Press "@" key to toggle the sound.

       Press "Esc" key to hide program.

       Press "Q", "q", or "CTRL-C" keys to kill program.

       Unlike other puzzles in the collection there is no way to move pieces without drag and drop.

       The title is in the following format (non-motif version):
              x{hanoi  |  algorithme  |  panex}: <Number of rows> @ (<Number of moves>/{<Record number of moves>
              <user name>|"NEVER noaccess"}) - <Comment>
       If there is no record of the current puzzle, it displays "NEVER noaccess".

OPTIONS

       -geometry {+|-}X{+|-}Y
               This option sets the initial position of the panex window (resource name "geometry").

       -display host:dpy
               This option specifies the X server to contact.

       -[no]mono
               This option allows you to display the panex window on a color screen as  if  it  were  monochrome
               (resource name "mono").

       -[no]{reverse|rv}
               This option allows you to see the panex window in reverse video (resource name "reverseVideo").

       -{foreground|fg} color
               This option specifies the foreground of the panex window (resource name "foreground").

       -{background|bg} color
               This option specifies the background of the panex window (resource name "background").

       -pyramid0 color
               This option specifies the color of the first pyramid (resource name "pyramidColor0").

       -pyramid1 color
               This   option   specifies  the  color  of  the  second  pyramid,  if  it  exists  (resource  name
               "pyramidColor1").

       -tile color
               This option  specifies  the  tile  color  of  the  tiles  in  the  panex  window  (resource  name
               "tileColor").

       -frame color
               This option specifies the color of the frame (resource name "frameColor").

       -[no]stippleFrame
               This option allows you to toggle the frame stippling (resource name "stippleFrame").

       -delay msecs
               This  option specifies the number of milliseconds it takes to move a tile or a group of tiles one
               space (1-50) (resource name "delay").

       -[no]sound
               This option specifies if a sliding tile should make a sound or not (resource name "sound").

       -moveSound filename
               This option specifies the file for the move sound for the sliding of  the  tiles  (resource  name
               "moveSound").

       -{font|fn} ontname
               This option specifies the font that will be used (resource name "font").

       -tiles int
               This option specifies the number of tiles in a column (resource name "tiles").

       -mode int
               This option specifies the hanoi (0), algorithme (1), or panex (2) mode (resource name "mode").

       -hanoi  This option specifies the hanoi mode (resource name "mode").

       -algorithme
               This option specifies the algorithme mode (resource name "mode").

       -panex  This option specifies the panex mode (resource name "mode").

       -userName string
               This  option  specifies  the  user  name for any records made or else it will get your login name
               (resource name "userName").

       -scoreFile filename
               Specify an alternative score file (resource name "scoreFile").

       -scores This option lists all the recorded scores and then exits.

       -version
               This option tells you what version of xpanex you have.

RECORDS

       You must clear the puzzle before a record is set, otherwise an assumption of cheating is made  if  it  is
       solved after a get or an auto-solve.

SAVE FORMAT

       Here is the format for the xpanex configuration, starting position, and the movement of its pieces.

              mode: 0-2 <0 hanoi, 1 algorithme, 2 panex>
              tiles: 1-10 <number of tiles in a column>
              moves: 0-MAXINT <total number of moves>

              startingPosition: <array pairs of column and position of each tile>

       This is then followed by the moves, starting from 1.
              move #: <from_column> <to_column>
       from_column is the top tile of the column
       to_column is where that tile is moved to.

REFERENCES

       Mark Manasse & Danny Sleator of AT&T Bell Laboratories and Victor K. Wei of Bell Communications Research,
       Some Results on the Panex Puzzle, Murray Hill, NJ, 1985 20 pp. (unpublished).

       Vladimir  Dubrovsky,  Nesting Puzzles Part 1: Moving oriental towers, Quantum/Toy Store, January/February
       1996 pp 55-57, 50-51.

       L. E. Horden, Sliding Piece Puzzles (Recreations in Mathematics Series), Oxford University Press 1986, pp
       144, 145.

       Jerry Slocum & Jack Botermans, Puzzles Old & New (How to Make and Solve Them), University  of  Washington
       Press, Seattle, 1987, p 135.

       Dick  Hess,  Analysis of the Algorithme 6 Puzzle and its Generalisations, Cubism For Fun, July 2008 76 pp
       8-13.

SEE ALSO

       X(1), xcubes(6), xtriangles(6), xhexagons(6), xmlink(6), xbarrel(6),  xmball(6),  xpyraminx(6),  xoct(6),
       xrubik(6), xskewb(6), xdino(6), xbevel(6), xabacus(6)

COPYRIGHTS

       ® Copyright 1996-2024, David A. Bagley

       Main algorithm taken from AT&T paper above.

       Thanks to Nick Baxter <nickb AT baxterweb.com> for debugging level n > 4 and vTrick.

       Though  most  code by Rene Jansen <rene.j.jansen@bigfoot.com> is now removed, much inspiration was gained
       by his efforts implementing an algorithm from Quantum January/February 1996 by Vladimir Dubrovsky.

BUG REPORTS AND PROGRAM UPDATES

       Send bugs (or their reports, or fixes) to the author:
              David A. Bagley, <bagleyd AT verizon.net>

       The latest version is currently at:
              https://www.sillycycle.com/puzzles.html
              http://www.ibiblio.org/pub/Linux/games/strategy/

V8.8.4                                             15 Aug 2024                                         XPANEX(6)