README
1
2Name: Patrick Stein
3City: Rochester, NY
4
5Title: 54321 (v1.0.2001.11.16)
6Description:
7 54321 is five games in four-, three-, or two- dimensions for
8 one player. 54321 takes five classic two-dimensional puzzle
9 games and extends them into three and four dimensions.
10 For more information, see the help within the game.
11
12Email: 54321@nklein.com
13Web: http://www.nklein.com/products/54321
14
15Build Instructions:
16 Build: gmake all size
17
18 This will build the executable and prepare the data.
19 All of the files needed for a binary release are placed
20 in the ``Release'' directory.
21
22 Or, if you're feeling really saucy and have pdflatex,
23 notangle, and noweave installed, you can uncomment the
24 ``HAS_NOWEB'' line at the top of the GNUmakefile. But,
25 I've already distributed it with all of the source code
26 and the code doc generated, so there's no need to feel
27 saucy.
28
29 In the ``archs'' directory, there are subdirectories
30 for each platform that I have built this game under.
31 If there are any problems compiling, you may have to
32 check the ``variables.GNU'' file in the appropriate
33 subdirectory of ``archs''.
34
35 For example, if you are compiling under Linux and your
36 C++ is not called ``c++'', then you should change the
37 definition of ``CXX'' in ``archs/Linux/variables.GNU.''
38
39 And, if your are compiling under Linux or Solaris and
40 your SDL_image library is not in /usr/local/, then you
41 may have to change the definition of ``SDL_IMAGE'' in
42 the appropriate ``variables.GNU'' file.
43
44 Tools and Libraries:
45 gmake (required)
46 a C++ compiler (required)
47 SDL (required)
48 SDL_image (required)
49 SDLmain (required for Linux, Solaris, MacOS X)
50 libpng (required for Linux, Solaris, MacOS X)
51 zlib (required for Linux, Solaris, MacOS X)
52
53 pdflatex (optional)
54 noweave (optional)
55 notangle (optional)
56
57Linux Info:
58 Build Size: 694k
59
60 Running:
61 From the ``Release'' directory, run ``./54321-Linux''.
62
63 You can give the command-line option ``-window'' to
64 start 54321 in a window instead of in fullscreen
65 mode.
66
67 If you are using the binary release, then you must already have
68 the SDL, SDL_image, libpng, and zlib libraries available on
69 your system.
70
71Solaris Info:
72 Running:
73 From the ``Release'' directory, run ``./54321-SunOS''.
74
75 You can give the command-line option ``-window'' to
76 start 54321 in a window instead of in fullscreen
77 mode.
78
79 If you are using the binary release, then you must already have
80 the SDL, SDL_image, libpng, and zlib libraries available on
81 your system.
82
83BeOS Info:
84 Running:
85 Open the ``54321-BeOS'' icon.
86
87 If you are using the binary release, then you must already have
88 the SDL and SDL_image libraries available on your system.
89
90MacOS X Info:
91 Running:
92 Open the ``54321-Darwin'' icon.
93
94 If you are using the binary release, then you must already have
95 the SDL, SDL_image, libpng, and zlib libraries available on
96 your system.
97
98Win32 Info:
99 Building:
100 I had to hack things a great deal to get this to
101 build. I pretty much nuked the ``unsigned int''
102 before all of the ``redefinition of "ii"'' errors.
103 I deleted the ``unsigned char*'' in front of the
104 ``redefinition of "ptr"'' errors. I changed all
105 of the ``random()'' calls to ``rand()'' and the
106 ``srandom( getpid() ^ SDL_GetTicks() )'' to
107 ``srand( SDL_GetTicks() )''. I nuked the include
108 of <unistd.h>. And, I commented out the line
109 in main ``videoFlags |= SDL_FULLSCREEN''.
110
111 Running:
112 Open the ``54321'' icon in the ``bin/Win32'' folder.
113
114 Warning: This runs very slowly under Win32 on my test machine
115 (a P133 running Win95).
116