GLEW

Added GLEW for loading OpenGL extensions

1 files changed, 21 insertions, 5 deletions

diff --git a/HOWTO.txt b/HOWTO.txt
index f93bb0e..4c17234 100644
--- a/HOWTO.txt
+++ b/HOWTO.txt
@@ -13,16 +13,19 @@ How to...
       http://www.cmake.org/cmake/resources/software.html (the Windows zip file)
      Unpack the contents of the archive to where MinGW is installed (files from bin/ should go into bin/, etc.)
   3. Download the following libraries, installing them in your MinGW directory like with CMake:
-     SDL, SDL_imgage, SDL_ttf, libpng
+     SDL >=1.2.10, SDL_imgage >= 1.2, SDL_ttf >= 2.0, libpng >= 1.2, GLEW >= 1.8.0
+     Note #1: For most libraries, you can download binary packages with compiled files.
+              However, you must ensure that they work with MinGW as some are built with MSVC
+              and may be incompatible. If that is the case, you should compile the libraries from sources
+              using MinGW.
+     Note #2: For GLEW, you need to compile from source under MinGW. Since there is no automated
+              make script for that, follow the instructions here: http://stackoverflow.com/questions/6005076/
   4. Run MinGW console from the shortcut in menu start.
   5. Change to the directory where you have the Colobot sources by typing "cd /c/where/the/sources/are"
   6. Type "cmake -G 'MSYS Makefiles' ."
   7. Type "make"
   8. Everything should compile without errors.
 
-  Note: you might experience some troubles with OpenGL headers, as Windows (used to?) ship with outdated header files.
-  Download the newest ones from SDK of your graphics card vendor.
-
  1.2 Linux:
 
   Since you're running Linux, you probably know how to do this anyway ;)
@@ -32,6 +35,9 @@ How to...
     $ cmake .
     $ make
 
+  Note: If you experience problems with OpenGL's extensions, install GLEW library and enable
+        it in compilation by setting USE_GLEW to 1 in CMakeLists.txt
+
  1.3 Other platforms, compilers, etc.
 
    We haven't checked other platforms yet but the code isn't particularly tied to any compiler or platform, so in theory it should work.
@@ -60,7 +66,14 @@ Jak...
      http://www.cmake.org/cmake/resources/software.html (plik zip dla Windowsa)
      Zip rozpakowujemy do katalogu, gdzie zainstalowany jest MinGW (pliki z bin/ mają trafić do bin/ itd.).
   3. Ścągamy następujące biblioteki i instalujemy je tam, gdzie MinGW, podobnie jak z CMake:
-     SDL, SDL_image, SDL_ttf, libpng
+     SDL >= 1.2.10, SDL_image >= 1.2, SDL_ttf >= 2.0, libpng >= 1.2
+     Uwaga #1: W większości wymienionych bibliotek można ściągnąć paczki binarne ze skompilowanymi plikami.
+               Jednak musisz się upewnić, że pliki te będą współpracowały z MinGW, bo część z nich
+               jest kompilowana MSVC i może być niezgodna. W takim wypadku, musisz skompilować bibliotekę
+               ze źródeł pod MinGW.
+
+     Uwaga #2: W przypadku GLEW, musisz skompilować bibiotekę ze źródeł pod MinGW. Ponieważ nie ma skryptu
+               make do tego, użyj poleceń opisanych tutaj: http://stackoverflow.com/questions/6005076/
   4. Uruchamiamy MinGW console ze skrótu w menu start.
   5. Przechodzimy do katalogu, gdzie są źródła wpisując "cd /c/tam/gdzie/sa/zrodla"
   6. Wpisujemy "cmake -G 'MSYS Makefiles' ."
@@ -76,6 +89,9 @@ Jak...
     $ cmake .
     $ make
 
+  Uwaga: Jeśli natrafisz na problemy z rozszerzeniami OpenGL, zainstaluj bibliotekę GLEW i włącz ją
+         przy kompilacji, ustawiając USE_GLEW na 1 w CMakeLists.txt
+
  1.3 Inne platformy, kompilatory, etc.
 
    Nie sprawdzaliśmy jeszcze innych platform, ale kod nie jest jakoś specjalnie związany z danym kompilatorem czy platformą, więc w teorii powinien zadziałać.