summaryrefslogtreecommitdiffstats
path: root/apps/plugins/sdl/progs/wolf3d/README-devcpp.txt
diff options
context:
space:
mode:
authorFranklin Wei <git@fwei.tk>2019-07-07 22:00:20 -0400
committerFranklin Wei <git@fwei.tk>2019-07-09 11:20:55 -0400
commit3f59fc8b771625aca9c3aefe03cf1038d8461963 (patch)
treee0623a323613baa0b0993411b38bcaed144b27ed /apps/plugins/sdl/progs/wolf3d/README-devcpp.txt
parent439a0d1d91fa040d261fc39b87278bc9f5391dcc (diff)
downloadrockbox-3f59fc8b771625aca9c3aefe03cf1038d8461963.tar.gz
rockbox-3f59fc8b771625aca9c3aefe03cf1038d8461963.tar.bz2
rockbox-3f59fc8b771625aca9c3aefe03cf1038d8461963.zip
Wolfenstein 3-D!
This is a port of Wolf4SDL, which is derived from the original id software source release. The port runs on top of the SDL plugin runtime and is loaded as an overlay. Licensing of the game code is not an issue, as discussed below (essentially, the Debian project treats Wolf4SDL as GPLv2, with an email from John Carmack backing it up): http://forums.rockbox.org/index.php?topic=52872 Included is a copy of MAME's Yamaha OPL sound chip emulator (fmopl_gpl.c). This file was not part of the original Wolf4SDL source (which includes a non-GPL'd version), but was rather rebased from from a later MAME source which had been relicensed to GPLv2. Change-Id: I64c2ba035e0be7e2f49252f40640641416613439
Diffstat (limited to 'apps/plugins/sdl/progs/wolf3d/README-devcpp.txt')
-rw-r--r--apps/plugins/sdl/progs/wolf3d/README-devcpp.txt43
1 files changed, 43 insertions, 0 deletions
diff --git a/apps/plugins/sdl/progs/wolf3d/README-devcpp.txt b/apps/plugins/sdl/progs/wolf3d/README-devcpp.txt
new file mode 100644
index 0000000000..e013c48c3e
--- /dev/null
+++ b/apps/plugins/sdl/progs/wolf3d/README-devcpp.txt
@@ -0,0 +1,43 @@
+This file explains how you can compile Wolf4SDL using Bloodshed's Dev-C++.
+Keep in mind, that Dev-C++ is a dead project since 2005. The recommended way
+to compile Wolf4SDL on Windows is using Visual Studio 2005 C++ or the free
+Visual C++ 2005 Express. But for dial-up users Dev-C++ is probably still a
+good option.
+
+Needed files:
+ - "Dev-C++ 5.0 Beta 9.2 (4.9.9.2)" with Mingw/GCC 3.4.2 (about 9 MB)
+ http://www.bloodshed.net/dev/devcpp.html
+ - SDL-1.2.13-1chaos.DevPak (544 kB)
+ http://www.chaos-software.de.vu -> Downloads
+ - SDL_mixer-1.2.6-2mol.DevPak (347 kB)
+ http://sourceforge.net/project/showfiles.php?group_id=94270&package_id=151751
+
+Installation:
+ - Install Dev-C++ to C:\Dev-Cpp
+ - Open Wolf4SDL.dev
+ - Go to "Tools" -> "Package Manager"
+ - Click on the "Install" button in the toolbar
+ - Select "SDL-1.2.13-1chaos.DevPak" (where ever you saved it)
+ - Some "Next" buttons and a "Finish" button later...
+ - Click on the "Install" button in the toolbar
+ - Select "SDL_mixer-1.2.6-2mol.DevPak" (where ever you saved it)
+ - Some "Next" buttons and a "Finish" button later...
+ - Close the Package Manager
+
+Data file setup:
+ - Copy the data files (e.g. *.WL6) you want to use to the Wolf4SDL
+ source code folder
+ - If you want to use the data files of the full Activision version of
+ Wolfenstein 3D v1.4, you can just skip to the next section
+ - Otherwise open "version.h" and comment/uncomment the definitions
+ according to the description given in this file
+
+Compiling Wolf4SDL:
+ - Compile via "Execute" -> "Compile"
+ - No errors should be displayed
+ - Run Wolf4SDL via "Execute" -> "Run"
+
+Troubleshooting:
+ - If you get an error message "undefined reference to `__cpu_features_init'",
+ make sure, there is no c:\mingw folder. Otherwise Dev-C++ will mix different
+ versions of MinGW libraries...