home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xskewb41 / xskewb_readme.txt < prev    next >
Text File  |  1994-09-07  |  6KB  |  147 lines
  1.     X-BASED SKEWB
  2.     =============    Skewb X widgets, V4.1
  3.  
  4.  
  5.     It has been tested on the following platforms:
  6.  
  7.     HP 3xx & 700        HP-UX 9.0x    X11R5
  8.     Sun4, SPARC        SunOS 4.1.3    X11R4
  9.     PC, 486 (*)        Linux 1.0    X11R5
  10.  
  11.     *    Keypad 5 key may not work, in which case, try it with the
  12.     Num-Lock on.
  13.  
  14.     If yours is not in this list, please let me know -- thanks. The
  15.     most updated source could be found on ftp.x.org under
  16.     /contrib/games/puzzles.
  17.  
  18. HOW TO BUILD?
  19.  
  20.     It should be easy. Edit the Imakefile (or Makefile.std, see below)
  21.     for appropriate settings of variable SCOREFILE, RANDOM, then do:
  22.     xmkmf
  23.     make
  24.     xskewb
  25.  
  26.     If that does not work then:
  27.     mv Imakefile Imakefile.r5
  28.     sed 's/^XCOMM/\/\*\*\/#/' > Imakefile < Imakefile.r5
  29.     xmkmf
  30.     make
  31.     xskewb
  32.  
  33.     Note: if you don't have 'xmkmf' or the "Makefile" it generates
  34.     doesn't work well, edit Makefile.std for appropriate settings for
  35.     XINCLUDEPATH and XLIBPATH, then try:
  36.     make -f Makefile.std
  37.  
  38.     You should have Skewb.ad copied to $(HOME)/Skewb or 
  39.     /usr/lib/X11/app-defaults/Skewb to run, especially if the background
  40.     is similar to one of the faces. Edit this file for your preferences.
  41.     You might want to move xskewb into /usr/bin/X11 (or wherever your
  42.     X binaries are).
  43.     You might also want to move xskewb.man to /usr/man/man6/xskewb.6
  44.  
  45. ANYTHING SPECIAL IN USING?
  46.  
  47.     Click on the left mouse button to move CCW.
  48.     Click on the middle mouse button toggle the practice mode. (This is
  49.       good for learning moves).  Also 'P' or 'p' does the same thing.
  50.       One must double click on the middle mouse button if the puzzle is
  51.       being worked on.
  52.     Click on the right mouse button if you want to randomize the cube.
  53.       Also 'R' or 'r' does the same thing.  One must double click on
  54.       the right mouse button if the puzzle is being worked on.
  55.     'O' or 'o' to toggle orient mode. (I prefer the orient mode since
  56.       it is slightly more challenging).
  57.     'Q', 'q', Control-C to kill program.
  58.  
  59.     Key pad is defined for 2d skewb as:
  60.     7       9
  61.         ^
  62.       < 5 >
  63.         v
  64.     1       3
  65.  
  66.     The key pad along with the use of the mouse will allow you to move the
  67.     cube more than just CCW ie.,
  68.     KP_7=>TopLeft                       KP_9=>TopRight
  69.             KP_5=>CW
  70.     KP_1=>BottomLeft                    KP_3=>BottomRight
  71.  
  72.     If the mouse is on a diamond, the above "KP" keys will not move cube
  73.     because the move is ambiguous. Also if the mouse is on a triangle, not
  74.     all the "KP" keys will function because the puzzle will only rotate on
  75.     the cuts, ie. a triangle with a TL-BR cut will rotate only TL & BR, a
  76.     triangle with a TR-BL cut will rotate only TR & BL. Therefore, a
  77.     triangle can only move tangential to the center of the face. No doubt
  78.     this is confusing, but the physical skewb is the same way. In fact,
  79.     that is part of its appeal.
  80.  
  81.     Key pad for 3d skewb, use your intuition (is this a cop out or what?).
  82.     The key pad is defined differently depending on which side of the cube
  83.     your mouse is pointing at. Again, the cube can not turn pointing at
  84.     center diamonds. One thing that stays the same is KP_5=>CW.
  85.  
  86.     The new control feature allows you to move the whole cube at once
  87.     without being entered as a move.  Hold down the control key while
  88.     using the left mouse button or the keypad.
  89.  
  90.     One has to orient the faces in orient mode, besides getting all the
  91.     faces to be the same color. To do this one has to get the lines to
  92.     be oriented in the same direction, this only matters with center
  93.     diamond. This does add complexity so there are 2 sets of records.
  94.  
  95.     Try resizing the cube. Notice the puzzle resizes to take advantage
  96.     of the "room" available.
  97.  
  98.     The title is in the following format:
  99.     xskewb{2|3}d: (<Number of moves>/\
  100.         {<Record number of moves>|NEVER|PRACTICE}) - <Comment>
  101.     {2|3}: current dimensional view
  102.     {<Record...}: puzzle is either in practice mode or record mode
  103.        In record mode, if there is no record of the current puzzle, it
  104.        displays "NEVER".
  105.  
  106.     If you were looking for a self-solver, sorry.  If you know of one
  107.     let me know.
  108.  
  109.     Also a tesseract (4D cube) would be nice. (Does such an analog exist
  110.     for 4d?)
  111.  
  112.     Personally, I have solved this puzzle, but only physically, never in
  113.     software. The biggest handicap is that the puzzle is hard to follow
  114.     through the diagonals. But the real one is like that too.
  115.  
  116.     Recently, Disney released Mickey's Challenge, its a spherical skewb
  117.     with a pretty good internal mechanism. It also comes with a pretty
  118.     neat book. The whole package is only about $10.
  119.      
  120.     Refer to the man page for detailed command line options.
  121.  
  122.     If you want further information on puzzles, I'll be glad :-) to send
  123.     it to you.
  124.  
  125. FOUND A BUG?
  126.  
  127.     Send bugs reports and fixes to the author. For bugs, please include
  128.     as much information as to their location as possible, since I may not
  129.     have the resources to duplicate the them.
  130.  
  131.     David Albert Bagley,    bagleyd@source.asset.com
  132.  
  133. HISTORY
  134.  
  135.    [Jun 15, 94]    V4.2: Mistakenly used a Boolean variable in an array.
  136.    [Jun 02, 94]    V4.1: R6.
  137.    [May 30, 94]    V4.0: Xt version.
  138.         I got some good ideas from oclock.
  139.    [Oct 14, 93]    V3.0: Motif version.
  140.         I got some good ideas from Douglas A. Young's
  141.         book: "The X Window System Programming and Applications
  142.         with Xt OSF/Motif Edition", particularly his dial widget.
  143.         I got some good ideas on presentation from Q. Zhao's
  144.         tetris.
  145.    [Jan 22, 92]    V2.0: XView version.
  146.    [Mar 19, 91]    V1.0: SunView version.
  147.