1 X-BASED MASTERBALL(tm) 2 ================== Masterball X widget, 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 PC Pentium Linux 2.0.9 12 IBM PowerPC AIX 4.3.1.0 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 "xmball" (or "xmmball" if you have Motif). 62 If you do a "make install" "SCOREFILE" and "DATAFILE" must be 63 set correctly. 64 65 You should have Mball.ad copied to $(HOME)/Mball or 66 /usr/lib/X11/app-defaults/Mball to run, especially if the background 67 is similar to one of the wedges. Edit this file for your preferences. 68 You might want to move xmball into /usr/bin/X11 (or wherever your 69 X binaries are). 70 You might also want to move xmball.man to /usr/man/man6/xmball.6 71 72 The control feature allows you to move the whole masterball at 73 once without being entered as a move. Hold down the control key 74 while using the left mouse button or the keypad. 75 76 One has to orient the wedges in orient mode, besides getting all the 77 wedges to be the same color. To do this one has to get the wedges 78 with the numbers on one side and in order (clockwise). This will add 79 complexity, so there are 2 sets of records. 80 81 Try resizing the masterball. Notice the puzzle resizes to take 82 advantage of the "room" available. 83 84 The title is in the following format (non-motif version): 85 xmball.{2|4|6|8}: <int> @ (<Number of moves>/\ 86 {<Record number of moves>|NEVER|PRACTICE}) - <Comment> 87 {2|4|6|8}: current number of wedges. 88 <int>: number of sectors per wedge. 89 {<Record...}: puzzle is either in practice mode or record mode 90 In record mode, if there is no record of the current puzzle, it 91 displays "NEVER". 92 93 If you were looking for a auto-solver, sorry. One of the problems in 94 auto-solvers the generally don't work for different number of cuts. 95 If you know of one let me know. 96 97 I know the look is not exactly right. For simplicity, I did not take 98 into account spherical placement of the latitude cuts. 99 100 Refer to the man page for detailed command line options. 101 102 If you want further information on puzzles, I'll be glad :-) to send 103 it to you. 104 105FOUND A BUG? 106 107 Send bugs reports and fixes to the author. For bugs, please include 108 as much information as to their location as possible, since I may not 109 have the resources to duplicate the them. 110 111HISTORY 112 113 [Aug 11, 99] V5.5.2: Fixed runtime library problems when using configure. 114 [Jun 20, 99] V5.5: Added -rv, fixed flashing on mono, fixed a mixup 115 where '0' got 12 wedges instead of 10. '=' will get 12 wedges... 116 it follows the logically if you look at the keyboard... 117 [Jan 01, 97] V5.4: Username, concurrency check, configure, bug fixes in 118 get, write, and undo, man page updates. 119 [Apr 08, 96] V5.3: Minor changes. 120 [Jan 31, 96] V5.2: Puzzle can be moved by a more intuitive drag and 121 drop approach. Sectors will invert, when selected. 122 Now using dynamic allocation, so there is no maximum 123 number of rings. The maximum number of wedges though 124 is still fixed at 8. 125 [Dec 15, 95] V5.1: Minor updates, RNG for 32/64 bit. Better sector 126 drawing algorithm. I did not figure out the border 127 lines on the sectors, next time... 128 [Oct 02, 95] V5.0: Xt/Motif, your choice. 129 [May 16, 95] V4.10: Warnings removed from Sun's cc and lint and now 130 include a random number generator. 131 [Mar 13, 95] V1.4: Removed lint warnings and added a VMS make.com . 132 [Nov 11, 94] V1.3: Conservative guess for random number generator. 133 [Nov 07, 94] V1.2: Now allows undos, saves, and recalls. 134 [Sep 19, 94] V1.1: Minor changes. 135 [Sep 15, 94] V1.0: Xt version. 136