Mercurial > hg > forks > pwpunix
annotate README @ 86:71394f177c0f
Bump version.
| author | Matti Hamalainen <ccr@tnsp.org> |
|---|---|
| date | Tue, 19 Mar 2013 07:25:50 +0200 |
| parents | 3abba0311c07 |
| children |
| rev | line source |
|---|---|
| 39 | 1 |
| 2 MMmmmmmmMM | |
| 3 MM | |
| 4 xxxxxxxxxxxx | |
| 5 xxxxxxxxxxxxxxxxxxx | |
| 6 xxxxxxxxx | |
| 7 ZZZZZ.... %%%%%%%%% %%% %%% %%%%%%%%% | |
| 8 @@@@...... %%%%%%%%%. %%%....... %%%. %%%%%%%%%.... | |
| 9 @@@@....o. .....%%% %%% %%% %%% %%% %%% %%% | |
| 10 @@@@@@@.... %%% %%% %%% %%% %%% %%% %%% | |
| 11 @@@@@@@@@@@ %%%% %%% %%% %%% %%% %%%% %%% | |
| 12 @@@@@@@@@@@@@ %%%% %%% %%% %%% %%% %%%% %%% | |
| 13 @@@@@@@@@@@@@@@ %%%%%%%%% %%% %%% %%% %%%%%%%%% | |
| 14 @@@@ %%%%%%%%% %%% %%% %%% %%%%%%%%% | |
| 15 @@@@@@ %%% %%%%% %%% %%% %%% | |
| 16 @@@@@@@@@@ xx %%% %%%%% %%% %%% %%% | |
| 17 @@@@@@@@@@@@@@ %%% %%%%% %%%% %%% %%% | |
| 18 @@@@@@@@@@@ %%% %%%%% %%%% %%% %%% | |
| 19 @@@@@@@@@ .....%%%....... %%%%%%%%%%%%%%. %%%.......... | |
| 20 @@@@@ %%% %%%%%%%%%%%%%% %%% | |
| 21 @@@@ | |
| 22 | |
| 86 | 23 libSDL-enhanced pwplib v1.97 |
| 48 | 24 |
| 25 in the year 2010 of our lameness | |
| 39 | 26 |
| 27 | |
|
44
ec1bff613ae0
Documentation clarifications.
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
28 Original pwplib 1.90 and everything else |
|
ec1bff613ae0
Documentation clarifications.
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
29 by viznut/pwp |
| 39 | 30 |
|
44
ec1bff613ae0
Documentation clarifications.
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
31 SDL-support, cleanups, bugfixes and new buildsystem |
|
ec1bff613ae0
Documentation clarifications.
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
32 by ccr/TNSP^pwp <ccr@tnsp.org> |
| 39 | 33 |
| 34 | |
| 35 About | |
| 36 ===== | |
| 37 The product at your fingertips is a cleaned up, slightly fixed | |
| 38 version of pwplib and everything else that came in pwpunix-1.90 | |
| 39 package. It has been enhanced with libSDL support for video and | |
| 40 audio. | |
| 41 | |
| 42 Why, some may ask -- the reason is simple: most of terminal-based | |
| 43 output methods provided by original pwplib do not work very well | |
| 44 in current UNIX systems, and adding support for graphical output | |
| 45 via libSDL seemed to be the easiest way to fix this. | |
| 46 | |
| 47 Additionally sound support via SDL was introduced, and it is | |
| 48 possible to cross-compile the whole thing for Win32 via MinGW | |
| 49 hosted on Linux or other UNIX-ish platform. | |
| 50 | |
| 51 | |
|
41
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
52 Usage |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
53 ===== |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
54 Information about available options can be viewed via: |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
55 |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
56 > peluce help |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
57 |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
58 Unfortunately (or fortunately) SDL for Windows redirects stdout and |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
59 stderr by default, thus the help output goes to file "stdout.txt". |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
60 |
| 39 | 61 By default the SDL target runs in a window of 640x480, but this |
| 62 can be changed via commandline parameters. For example: | |
| 63 | |
| 64 > peluce xres 1024 yres 768 | |
| 65 | |
| 66 Or run in full screen: | |
| 67 | |
| 68 > peluce xres 1024 yres 768 fs | |
| 69 | |
| 70 | |
| 71 Requirements | |
| 72 ============ | |
| 73 | |
| 74 * libSDL for the SDL version. | |
| 75 | |
| 76 * A working C compiler (preferably GCC3 or later) | |
| 77 | |
| 78 * Make (GNU Make 3.81 or later works at least) | |
| 79 | |
| 80 * POSIX-ish platform for building. Windows targets | |
| 81 can be built via cross-compilation. | |
| 82 | |
| 83 Quick and dirty guide to make it: Just type 'make' | |
| 84 and follow the instructions. | |
| 85 | |
| 86 The Windows cross-compilation targets most likely require | |
| 87 manual intervention, e.g. editing of the Makefile as this | |
| 88 has only been tested on one system. | |
| 89 | |
|
58
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
90 |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
91 Known bugs |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
92 ========== |
| 79 | 93 * While there is a "final_isi" directory, the code there is mostly |
| 94 a dirty half-working hack, as Final Isi was not originally using | |
| 95 pwplib. It should compile and run, but will not work correctly. | |
| 96 | |
|
58
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
97 * Big resolutions (1600 x 1200 for example) seem to cause some prods |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
98 partially malfunction, apparently due to some integer overflows. |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
99 As a workaround, use 1024 x 768 or so at most or experiment. |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
100 |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
101 * Sound might be slightly off-sync in some prods, but this is possibly |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
102 due to the reason that it wasn't ever properly synced to begin with. |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
103 |
|
6bddfed775f8
Add section about known bugs.
Matti Hamalainen <ccr@tnsp.org>
parents:
48
diff
changeset
|
104 |