  X-BASED HEXTRIS
  =============== Hextris X Widget, V7.2.4

Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/altris
Secondary site: ftp://ibiblio.org/pub/Linux/games/arcade/tetris
Web page: http://www.tux.org/~bagleyd/altris.html
Maintainer: David A. Bagley <bagleyd@tux.org>

  It has been tested on the following platforms:
    Sun Ultra 5     SunOS 5.8
    PC  Pentium 4   Linux 2.4.18
    PC  Pentium 4   Windows XP Cygwin
    PC  Pentium 4   Windows XP Mingw

WHY ANOTHER?

    Because "different is good"...

    Because this one is simple, easy to build, portable, and hexagonal --
    also it is a widget, so it can be easily duplicated or dropped in
    other programs.

    Polyhexes are used instead of polyominoes of Q. Alex Zhao's tetris,
    which this program is patterned after.  That original tetris can be
    found ftp.x.org under /contrib/games .


HOW TO BUILD?

  An ANSI C compiler is required for build.

  To build, it should be easy. There are 4 types.  You may want to set some
    parameters like SCOREPATH, SCOREFILE.

    configure:
      Use "configure -help" to see what options you can set using configure
      or parameters in Makefile.in .

      configure ; make

    imake:
      Sometimes this is not setup correctly by the distributor ... i.e. not
      my fault.  You may want to set parameters in Imakefile .
      If you have Xpm you may want to do this quick edit in the Imakefile:
        Uncomment line "#define XpmLibrary".
      If you have Motif you may want to do this quick edit in the Imakefile:
        Uncomment line "#define XmLibrary".

      xmkmf ; make

    make.com (VMS users only):
      Follow vms/README.vms .
      You may want to set parameters in make.com .

      @make

    win/Makefile (Mingw users only):
      You may want to set parameters in Makefile (like
      COPT=-02 -mno-cygwin).

      cd win
      make

      Then run "whextris".  Your on your own on installing the whextris.ini
      file and hextris.scores file.

  X users only:
    Then just run "hextris".  If you do a "make install" "SCOREPATH" must
    be set correctly.

    You should copy Hextris.ad to $(HOME)/Hextris or use "make install" to
    copy it to something like /usr/lib/X11/app-defaults/Hextris.  Edit
    this file for your preferences.


  make install:
    Normal installation usually in /usr/local.  The problem is that the
    file hextris.scores should be writable by the application but not
    users.

  Try resizing the game. Notice the puzzle resizes to take advantage of
  the "room" available.

  "Tetris" is the game.  It only lists the top 15 players at the
  end, each player may have at most 3 scores.  With the option
  "-scores", "hextris" will list all the scores.


ANYTHING SPECIAL IN PLAYING?

  This is another hexagonal version of tetris, and was derived
  independently of David Marley's version "xhextris",
  dm3e@+andrew.cmu.edu, dam@cs.cmu.edu .
  In that version there is no clear meaning of a row.  This is
  overcome with this version by changing the orientation of the
  hexagons and instead of having them come straight down, the pieces
  come down diagonally and slide off the walls and off each other
  and also change direction.  On the other hand, the pieces are not
  as pretty as "xhextris".  When an odd number of rows are filled
  (usually 1) the grid will change, pieces will shift left and
  right.  This proves to be necessary because if this were not
  allowed then it would be impossible to fill a row if certain
  mistakes were made previously.

  Changing the mode to corners, by pressing 'c' makes it harder for
  the pieces slide more easily past each other.  Essentially, if
  a piece has to slide between two others, it will not fit because
  of the corners.

  Use 'j' to move left; 'l' to move right; 'k' to rotate; 'i' to
  reflect.  Left-handed people may want to use 's', 'f', 'd', 'e'
  respectively.  Use the space bar to drop a block quickly.  Do you
  want to try the arrow keys or keypad?

  As usual, '+' speeds up the game.  To avoid cheating "-" is
  disabled from slowing down the game.  Note: that you do not need to
  press the SHIFT key -- '=' also works.  The 'b' key can be used to
  toggle "beep" and 'n' toggles "show next".  '>' will increase and
  '<' will decrease the number of hexagons in a polyhex.  Again, you
  do not need to press the SHIFT key -- '.' and ',' also work.
  If available for the current number of hexagons, the 'c' key
  toggles the "corners" mode, the 'm' key toggles the "mixed" mode, and
  the 'r' toggles the grid.  Note: to keep the level of play similar,
  the ability to reflect polyhexes, and later the ability to rotate
  polyhexes, may get turned off when the number of hexagons in a
  polyhex is decreased.

  If you press 'p' or "ESC", the game will be paused, and the window
  will be iconified -- just in case your boss suddenly appears at your
  door.  ;o) When the hextris window loses its focus, it also goes to
  "paused" mode except it doesn't iconify itself.

  Refer to the man page for detailed command line options.

FOUND A BUG?

  Send bugs reports and fixes to the author. For bugs, please include
  as much information as to their location as possible, since I may not
  be able to duplicate the them.

HISTORY

  [Dec 12, 2006]  V7.2.4:
    Now use http://netpbm.sourceforge.net to generate images from xpm.
  [Nov 23, 2006]  V7.2.3:
    Fixed level and fill bounding problems.
  [Jul 21, 2006]  V7.2.2:
    Fixed assorted uninitialized memory access reads.
    Fixed a core dump on Linux.
  [May 05, 2006]  V7.2.1:
    Fixed slider goof.
    Added pause key '|'.
  [Apr 01, 2006]  V7.2:
    Made usage string compatible with versions of Motif and screen.
    More defensive code in case getlogin fails.
  [Nov 01, 2005]  V7.1.6:
    Level 20 slowdown fix
    MS Window fixes:
      show next in wrong window!
      plainpiece should redraw all
      fill 0-10 invisible
      changing columns on the fly
      # for grid does not blank
  [Oct 05, 2005]  V7.1.5:
    scoreFile and userName fixes
    scores fix
  [Sep 22, 2005]  V7.1.4: Xt/Motif/Windows version
    Much code rewritten.
    -version added
    Common option help for X and X-Motif
    pieceColor changed to borderColor, -frame added
    Top line cleared in checkLines
    Simulate Xor flashing in Windows
    Configure pieces to depend on neighbors, also when a row is
      deleted a reformat takes place
    Made the edges softer in corners mode
    Redraw all when transition from corners to no corners and
      vice-versa
  [Dec 05, 2002]  V1.4:
    ANSI-C (also C++).  K&R C support dropped.  If you have trouble with
      this get gcc from prep.ai.mit.edu (also can unprotoize).  VMS stuff
      ported also but not tested.
    configure can now be used to build.
    Various bugs removed, noticed when ported to Java:
    Remove nonexistant data file from compilation
    Flash bug
    Fill lines slowed down (but fast if q pressed)
    3D look, -plain option
    drawThing & drawThingDiff check for j >= 0
    Esc key to hide, Control-C to quit
  [May 24, 2001]  V1.3.2:
    VMS port thanks to Patrick Moreau - CENA/Athis-Mons - FRANCE
      <pmoreau@cena.dgac.fr> or <moreau_p@decus.fr>
    Originally ported for altris-1.2.0 for OpenVMS in January 1995,
      now merged in distribution.  Updated and tested by Patrick Moreau.
  [Mar 23, 2001]  V1.3.1:
    New icon.
    Adopted more of Q. Alex Zhao's bonus code.  Bonus mode is now only
      available if you play fast or when the level changes automatically
      (-bonus no longer works).
  [Feb 28, 2001]  V1.3.0:
    Updated to match Q. Alex Zhao's tetris.3.2.1 from tetris.3.1.2.
    FocusOut problem on Sun with arrow keys fixed.
    Mapped more KP keys.
    Changed how scores are added up.
    Changed how corners mode is handled.
    Polyomino now in an include file instead of a data file. This
      makes it easier to install.
    Yet another new mail account.
  [Dec 28, 1995]  V1.2.0:
    Random generator fixed for 64 bit machines.  Minor patches.
    New mail account.
  [Jun 21, 1995]  V1.1.0:
    The different altris games will now have consistent numbers
      for major releases.
    hextris -fg white -bg black, should now work on monochrome monitors.
    Now provide a random number generator.
    Took out unbundled Sun cc and lint warnings.
    Format to data file changed.
    Fixed a color bug in hextris.
  Earlier versions were based on Q. Alex Zhao's Tetris V3.1.1 and my own
    xvhextris.
