  X-BASED TERTRIS
  =============== Tertris 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 triangular --
    also it is a widget, so it can be easily duplicated or dropped in
    other programs.

    Polyiamonds 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 "wtertris".  Your on your own on installing the wtertris.ini
      file and tertris.scores file.

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

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


  make install:
    Normal installation usually in /usr/local.  The problem is that the
    file tertris.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.

  "Tertris" 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", "tertris" will list all the scores.


ANYTHING SPECIAL IN PLAYING?

  This is a triangular version of tetris ("tritris" did not sound
  right).  Pieces come down diagonally and slide off the walls and
  off each other and also change direction.  When an odd number of
  rows are filled (usually 1) the grid will change, "up" triangles
  will become "down" triangles and vice-versa.  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.  The default number of triangles is 5 where
  reflection is allowed.  This just "seemed right" (but if you do
  not think so try "tertris -n 4" where reflection is not allowed
  but the number of different pieces is severely limited).

  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 triangles in a polyiamond.  Again, you
  do not need to press the SHIFT key -- '.' and ',' also work.
  If available for the current number of triangles, the 'g' key
  toggles the "diagonal" mode, the 'm' key toggles the "mixed" mode, and
  the "r' key toggles the grid.  Note: to keep the level of play similar,
  the ability to reflect polyiamonds, and later the ability to rotate
  polyiamonds, may get turned off when the number of triangles in a
  polyiamond 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 tertris 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.
  [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
  [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 from compilation
    Flash bug
    Fill lines slowed down (but fast if q pressed)
    multiline complete bug in checkLines()
    3D look, -plain option
    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:
    Icon renamed.
    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 diagonal 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.
    tertris -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.
  Earlier versions were based on Q. Alex Zhao's Tetris V3.1.1 and my own
     xvtertris.
