NAME

     xtriangles - Triangles X widget


SYNOPSIS

     /usr/games/xtriangles  [-geometry   [{width}][x{height}][{+-
     }{xoff}[{+-}{yoff}]]] [-display [{host}]:[{vs}]] [-[no]mono]
     [-[no]{reverse|rv}]    [-{foreground|fg}     {color}]     [-
     {background|bg}   {color}]   [-{border|bd}  {color}]  [-tile
     {color}]  [-size  {int}]  [-delay  msecs]  [-[no]sound]   [-
     bumpsound  {filename}] [-base {int}] [-{font|fn} {fontname}]
     [-username {string}]


DESCRIPTION

     A sliding tile puzzle.  A triangular version of the 15  puz-
     zle  which was originally made around 1879 (the 14-15 puzzle
     of Sam Loyd was made soon after).   T. R. Dawson in Original
     Puzzles   has  a  similar  puzzle  with  4  diamond-  and  6
     triangular-shaped pieces.  This is easier to solve  than  15
     puzzle.


FEATURES

     Click "mouse-left" button to move a tile.  Clicks on spaces,
     or  clicks  on  tiles  that are not in line with two spaces,
     will not move tiles.  Notice, one can  move  more  than  one
     tile  at  a  time  by clicking on the tile farthest from the
     spaces but still in line with the spaces.

     Click "mouse-right" button, or press "R"  or  "r"  keys,  to
     randomize the puzzle.

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

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

     "S" or "s" keys reserved for  the  auto-solver  (not  imple-
     mented).

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

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

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

     Press "C" or "c" keys to clear a puzzle.

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

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

     Press "@" or "2" keys to toggle the sound.


     Press "Esc" key to hide program.

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

     Use the key pad, "R" keys, or arrow keys to move without the
     mouse.
     Key pad is defined for Triangles as:
     7   9  Upper Left, Upper Right
       ^
     4< >6  Left, Right
       v
     1   3  Lower Left, Lower Right

     The title is in the following format (non-motif version):
          xtriangles: <size> @ (<Number of moves>/{<Record number
          of moves> <username>|"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  trian-
             gles window (resource name "geometry").

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

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

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

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

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

     -{border|bd} color
             This option specifies the border color of the  tiles
             in  the  triangles  window  (resource  name "border-
             Color").

     -tile color
             This option specifies the tile color of  the  trian-
             gles window (resource name "tileColor").

     -size <int>
             This option allows you to change the number of  tri-
             angles in a row (resource name "sizeA").

     -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").

     -bumpsound filename
             This option specifies the file for  the  bump  sound
             (resource name "bumpSound").

     -base int
             This option specifies the base used (default is base
             10) (resource name "base").

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

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


RECORDS

     You must randomize the puzzle before a record is set, other-
     wise an assumption of cheating is made if it is solved after
     a get.


SAVE FORMAT

     The format is not standard.  The reason  for  this  is  that
     this is simple and I do not know what the standard is.

          size: 1-16 <number of tiles in a row of the same orien-
          tation as the puzzle>
          moves: 0-MAXINT <total number of moves>

          startingPosition: <array of tile positions where  0  is
          the empty space for the UP triangle and -1 is the empty
          space for the DOWN triangle>

     This is then followed by the moves, starting from 1.
          move #: <direction>
     Direction is represented as 0 upper right, 1 right, 2  lower
     right, 3 lower left, 4 left, and 5 upper left.


REFERENCES

     L.  E.  Horden,  Sliding  Piece  Puzzles   (Recreations   in
     Mathematics  Series),  Oxford  University  Press 1986, pp 1,
     148, 149.

     Jerry Slocum & Jack Botermans, Puzzles Old  &  New  (How  to
     Make  and Solve Them), University of Washington Press, Seat-
     tle, 1987, pp 126, 127.


SEE ALSO

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


COPYRIGHTS

     (Reg.) Copyright 1994-2004, David Albert Bagley


BUG REPORTS AND PROGRAM UPDATES

     Send bugs (or their reports, or fixes) to the author:
          David Albert Bagley, <bagleyd@tux.org>

     The latest version is currently at:
          ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
          ftp://ibiblio.org/pub/Linux/games/strategy