1 X-BASED RUBIK'S CUBE(tm)
2 ==================== Magic cube X widgets, V5.5.2
3
4Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
5Secondary site: ftp://ftp.x.org/contrib/games/puzzles
6Web page: http://www.tux.org/~bagleyd/puzzles.html
7Maintainer: David A. Bagley <bagleyd@tux.org>
8
9 It has been tested on the following platforms:
10 Sun Ultra SunOS 5.6-5.7
11 IBM PowerPC AIX 4.3.1.0
12 PC Pentium Linux 2.0.9
13 HP 898 HP-UX 10.20
14
15 Previous versions tested on:
16 Sun SPARC SunOS 5.5.1 (X11R5 & X11R6)
17 Sun SPARC SunOS 4.1.3
18 PC 486 Linux 1.2.13(*)
19 DEC VAX & ALPHA VMS 6.1
20 HP 3xx & 700 HP-UX 9.01
21
22 * Keypad may not work, since various keycodes may not be defined
23 by default. Check that "KP_1 - KP_9, Home, Up, Prior, Left,
24 Begin, Right, End, Down, Next" are defined towards the end of
25 /usr/lib/X11/etc/xmodmap.std . If not defined
26 cp /usr/lib/X11/etc/xmodmap.std /usr/lib/X11/xinit/.Xmodmap
27 and then motify this or create your own at ${HOME}/.Xmodmap .
28 You should just have to uncomment them (get rid of some '!').
29 This should be done before X is started. Also it may work better
30 with the Num-Lock on.
31
32 If you have to do any editing to get this to work, please mail me
33 the changes.
34
35HOW TO BUILD?
36
37 An ANSI C compiler is required for build.
38
39 To build, it should be easy. There are 3 choices.
40
41 configure:
42 Relatively new so there is a good possiblity that it is not set up
43 correctly on your system. You may want to set SCOREFILE and DATAFILE
44 in Makefile.in .
45
46 configure ; make
47
48 imake:
49 Sometimes this is not setup correctly by the distributer ... i.e. not
50 my fault. You may want to set SCOREFILE and DATAFILE in Imakefile .
51 If you have Motif you may want to do this quick edit in the Imakefile:
52 Uncomment line "#define XpmLibrary".
53
54 xmkmf ; make
55
56 make.com (VMS users only):
57 You may want to set SCOREFILE and DATAFILE in make.com .
58
59 @make
60
61 Then just run "xrubik" (or "xmrubik" if you have Motif).
62 If you do a "make install" "SCOREFILE" and "DATAFILE" must be
63 set correctly.
64
65 You should have Rubik.ad (or Stupid.ad) copied to $(HOME)/Rubik or
66 /usr/lib/X11/app-defaults/Rubik to run, especially if the background
67 is similar to one of the faces. Edit this file for your preferences.
68 You might want to move xrubik into /usr/bin/X11 (or wherever your
69 X binaries are).
70 You might also want to move xrubik.man to /usr/man/man6/xrubik.6
71
72 Try resizing the cube. Notice the puzzle resizes to take advantage
73 of the "room" available.
74
75 The autosolver here only works for 2x2x2 and 3x3x3 (orient lines off).
76 One of the problems in auto-solvers the generally do not work for
77 different number of cuts. If you know of one let me know.
78
79 Also a tesseract (4D cube) would be nice. (I heard a 3^N cube has been
80 built in software and solved!)
81
82 Personally, I have solved 1-3 using this program, 2-5 using the
83 physical cubes, and 6 to my knowledge have never been done (be the
84 first on your block).
85
86 Refer to the man page for detailed command line options.
87
88 If you want further information on puzzles, I'll be glad :-) to send
89 it to you.
90
91FOUND A BUG?
92
93 Send bugs reports and fixes to the author. For bugs, please include
94 as much information as to their location as possible, since I may not
95 have the resources to duplicate the them.
96
97HISTORY
98
99 [Aug 11, 99] V5.5.2: Fixed runtime library problems when using configure.
100 [Jun 20, 99] V5.5: Added -rv, fixed flashing on mono, and added LxMxN
101 stuff.
102 [Jan 01, 97] V5.4: Username, concurrency check, configure, man page
103 updates.
104 [Aug 08, 96] V5.3.2: Fixed drag and drop bug.
105 [Apr 11, 96] V5.3.1: Even sized cubes had errors since 5.2.
106 [Apr 08, 96] V5.3: Minor changes.
107 [Jan 31, 96] V5.2: Puzzle can now moved by a more intuitive drag and
108 drop approach. Pieces will invert, when selected.
109 Now using dynamic allocation, so there is no maximum size.
110 [Dec 15, 95] V5.1: Minor updates, RNG for 32/64 bit, border color
111 to make faces look more realistic.
112 [Oct 06, 95] V5.0: Xt/Motif, your choice.
113 [May 16, 95] V4.10: Warnings removed from Sun's cc and lint and now
114 include a random number generator.
115 [Mar 13, 95] V4.9: Removed lint warnings and added a VMS make.com .
116 [Nov 11, 94] V4.8: Conservative guess for random number generator.
117 [Oct 11, 94] V4.7: Bug fix for save with undos.
118 [Sep 28, 94] V4.6: Now allows undos, saves, and recalls.
119 [Aug 08, 94] V4.5: Auto-solves from practice mode.
120 [Jun 23, 94] V4.4: Auto-solves up to 3x3x3 courtesy of
121 Michael B. Martin <martinm@sps1.phys.vt.edu>.
122 [Jun 15, 94] V4.3: Mistakenly used a Boolean variable in an array.
123 [Jun 02, 94] V4.2: Minor changes, R6.
124 [May 31, 94] V4.1: Minor changes, record sometimes displayed "32767"
125 instead of "NONE".
126 [May 10, 94] V4.0: Xt version.
127 I got some good ideas from oclock.
128 [May 20, 93] V3.0: Motif version.
129 I got some good ideas from Douglas A. Young's
130 book: "The X Window System Programming and Applications
131 with Xt OSF/Motif Edition", particularly his dial widget.
132 I got some good ideas on presentation from Q. Zhao's
133 tetris.
134 [Jan 16, 92] V2.0: XView version.
135 [Jan 16, 91] V1.0: SunView version.
136