X-Git-Url: http://git.mutantstargoat.com/user/nuclear/?a=blobdiff_plain;f=README.md;h=2c9fb1417e8059cdd4c9043353a8210e4fb842b0;hb=HEAD;hp=3cdedae08b60da6196ca8f768dcb161553a92430;hpb=33436d7260fec0be3488e508ea96e4f8497fdf14;p=summerhack

diff --git a/README.md b/README.md
index 3cdedae..2c9fb14 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,8 @@
 Summerhack / The Lab
 ====================
+![GNU/Linux build status](https://github.com/TheLabDemos/summerhack/actions/workflows/build_gnulinux.yml/badge.svg)
+![FreeBSD build status](https://github.com/TheLabDemos/summerhack/actions/workflows/build_freebsd.yml/badge.svg)
+
 Summerhack was a short and sweet demo I've written during the summer of 2005
 for a random on-line competition. Mainly it was a showcase of the 3D engine I
 was writing back then with the help of Michael Georgoulopoulos: 3dengfx, and which was
@@ -44,3 +47,50 @@ Released under the GPL, do whatever you wish with it.
 Contact info...
 http://thelab.demoscene.gr - nuclear@siggraph.org
 ```
+
+Build instructions
+------------------
+If you acquired the source code from the git repo, it does not include the
+binary data files (images, 3D models, and music). Grab the data file archive
+from: http://nuclear.mutantstargoat.com/sw/demos/summerhack-data.tar.gz and
+extract it in the project root directory, so that you now have the `img`, `geom`
+and `music` subdirectories in the `data` directory.
+
+If you got the source code from a full release archive of the demo, the data
+files are already there. Of course the release archive also contains
+pre-compiled binaries for multiple platforms.
+
+### UNIX
+
+The only dependencies are SDL 1.2 and OpenGL. After installing them, just type
+`make` to build the demo. For example under Debian GNU/Linux:
+
+    sudo apt-get install libgl-dev libsdl1.2-dev
+    make
+
+While on FreeBSD:
+
+    sudo pkg install mesa-libs sdl
+    gmake
+
+### Windows (MSVC)
+
+The sticking point with compiling on windows, especially with MSVC, is how to
+handle dependencies. OpenGL is not an issue, but SDL must be installed and the
+compiler/linker needs to be informed of its location.
+
+For new versions of MS Visual C++ (2015 or later), use vcpkg to install SDL 1.2.
+It should work automatically.
+
+For older versions of MSVC, download the pre-compiled SDL 1.2 package:
+https://libsdl.org/release/SDL-devel-1.2.15-VC.zip
+and unzip it in the libs directory of summerhack (so that the directory
+`libs\SDL-1.2.15` exists).
+
+Once SDL is taken care of, simply open the `summerhack.sln` project and hit F7
+(Build->Build Solution).
+
+
+### MacOS X
+
+TODO