Mercurial > hg > forks > pwpunix
annotate README @ 43:093315d84a22
Add a small delay in SDL audio pseudo-loopflush function to avoid tightlooping in prod main loops (explained better in the added comment.)
| author | Matti Hamalainen <ccr@tnsp.org> |
|---|---|
| date | Mon, 24 May 2010 05:07:33 +0300 |
| parents | 5828a0cb4d10 |
| children | ec1bff613ae0 |
| 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 | |
| 23 libSDL-enhanced pwplib | |
| 24 | |
| 25 | |
| 26 Original pwplib 1.90 and everything else by viznut/pwp | |
| 27 | |
| 28 SDL-support, cleanups, bugfixes and new buildsystem by ccr/TNSP^pwp | |
| 29 | |
| 30 | |
| 31 About | |
| 32 ===== | |
| 33 The product at your fingertips is a cleaned up, slightly fixed | |
| 34 version of pwplib and everything else that came in pwpunix-1.90 | |
| 35 package. It has been enhanced with libSDL support for video and | |
| 36 audio. | |
| 37 | |
| 38 Why, some may ask -- the reason is simple: most of terminal-based | |
| 39 output methods provided by original pwplib do not work very well | |
| 40 in current UNIX systems, and adding support for graphical output | |
| 41 via libSDL seemed to be the easiest way to fix this. | |
| 42 | |
| 43 Additionally sound support via SDL was introduced, and it is | |
| 44 possible to cross-compile the whole thing for Win32 via MinGW | |
| 45 hosted on Linux or other UNIX-ish platform. | |
| 46 | |
| 47 | |
|
41
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
48 Usage |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
49 ===== |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
50 Information about available options can be viewed via: |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
51 |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
52 > peluce help |
|
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 Unfortunately (or fortunately) SDL for Windows redirects stdout and |
|
5828a0cb4d10
Add some more documentation.
Matti Hamalainen <ccr@tnsp.org>
parents:
39
diff
changeset
|
55 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
|
56 |
| 39 | 57 By default the SDL target runs in a window of 640x480, but this |
| 58 can be changed via commandline parameters. For example: | |
| 59 | |
| 60 > peluce xres 1024 yres 768 | |
| 61 | |
| 62 Or run in full screen: | |
| 63 | |
| 64 > peluce xres 1024 yres 768 fs | |
| 65 | |
| 66 | |
| 67 Requirements | |
| 68 ============ | |
| 69 | |
| 70 * libSDL for the SDL version. | |
| 71 | |
| 72 * A working C compiler (preferably GCC3 or later) | |
| 73 | |
| 74 * Make (GNU Make 3.81 or later works at least) | |
| 75 | |
| 76 * POSIX-ish platform for building. Windows targets | |
| 77 can be built via cross-compilation. | |
| 78 | |
| 79 Quick and dirty guide to make it: Just type 'make' | |
| 80 and follow the instructions. | |
| 81 | |
| 82 The Windows cross-compilation targets most likely require | |
| 83 manual intervention, e.g. editing of the Makefile as this | |
| 84 has only been tested on one system. | |
| 85 |