Merge pull request #128 from hkl123/patch-1

Update README.compiling-windows.txt
This commit is contained in:
Tom Reynolds 2016-10-09 19:07:01 +02:00 committed by GitHub
commit 9e4ebbbc34
1 changed files with 57 additions and 65 deletions

View File

@ -4,10 +4,10 @@
by Titus Tscharntke and Mark Vejvoda
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Build instructions for Windows
Build Instructions for Windows
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Architecture
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Architecture ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Developed on Windows with Microsoft Visual Studio Community 2015,
little endian CPU. Compiling using the mingw32 toolset is experimental, which
@ -15,44 +15,42 @@ also allows for cross compiling.
On Debian GNU/Linux systems please find license information in:
/usr/share/common-licenses
Also see Build Instructions for Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~ 2. Building and Installation ~~~~~~~~~~~~~~~~~~~~~~~~
2. Building and Installation
2.1 Prerequesites
--- 2.1 Prerequesites ---
To build the game, the following tools and libraries must be present:
- Pick 1:
* Microsoft Visual Studio Community 2015
OR
https://www.microsoft.com/en-us/download/details.aspx?id=48146
(Experimental Microsoft Visual C++ Express 2012 projects also exist in the vc2012
folder)
* mingw32
* Experiemtnal Microsoft Visual C++ Express 2012 projects also exist in the vc2012
folder
http://mingw.org/
- Pick 1:
* MegaGlest dependencies for building with VC++, which which will be downloaded
automatically in 'Option A' (see below)
OR
* MegaGlest Windows 32 bit dependencies for building with mingw:
https://github.com/MegaGlest/megaglest-source/releases/download/3.2.3/win32_deps_mingw.7z
These include:
- These include:
* Xerces-C
http://xerces.apache.org/xerces-c/
* wxWidgets
http://wxwidgets.org/
And many more.
* For a more verbose list, please inspect the archive contents and refer to the
* And many more. For a more verbose list, please inspect the archive contents and refer to the
Linux build instructions.
2.2 Building
--- 2.2 Building ---
To build and install the game proceed as follows:
Option A) (recommended) Automated build on the command line:
*** Option A ~ (recommended) Automated build on the command line:
1. Open a command prompt and navigate to the root folder where you have acquired the source code.
@ -64,7 +62,7 @@ Option A) (recommended) Automated build on the command line:
5. megaglest.exe
Option B) Using VC++ IDE:
*** Option B ~ Using VC++ IDE:
1. Download the dependencies archive (which one and from where you can find
out in the "code" of build-...bat script from 'Option A' approach, some line
@ -78,12 +76,12 @@ Option B) Using VC++ IDE:
3. Right Click on the top level 'Glest' node in Solution Explorer and select
'Rebuild All' (choose release mode or release with debug info).
If you had no errors all binaries will be created.
Before running MegaGlest you must run CopyWindowsRuntimeDlls_2015.bat.
You should now be able to just run megaglest.exe.
Note: If you had no errors all binaries will be created.
Before running MegaGlest you must run CopyWindowsRuntimeDlls_2015.bat.
You should now be able to just run megaglest.exe.
2.3 Installation
--- 2.3 Installation ---
We provide NSIS based installation packages. By default, these will create a
system-wide installation below %ProgramFiles% and setup Desktop icons for
@ -91,70 +89,64 @@ simplified access. User specific configuration will be stored within the
directory tree the %AppData% environment variable points to.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 3. Troubleshooting ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3. Troubleshooting
--- General ---
* Make sure that the hardware and software of your system match the
requirements
Some hints for troubleshooting.
In General:
* Make sure both hard- and software of your system match the requirements
* Sound is played through OpenAL - you might need to take a look at your
configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration
Compiling:
* If you cannot find what you are looking for on here please check the FAQs
(https://docs.megaglest.org/MG/FAQ) before contacting.
--- Compiling ---
* If configure fails make sure you have read the Building section above
Sound/Audio errors when starting:
--- Sound/Audio errors when starting ---
* If the game doesn't start because of audio/sound errors:
Make sure no other application is using your soundcard.
* If this doesn't solve your sound problems try to get an updated OpenAL from
http://openal.org
* Sound is played through OpenAL - you might need to take a look at your
configuration: http://supertux.lethargik.org/wiki/OpenAL_Configuration
The game complains about OpenGL 1.3 not available, is missing OpenGL extensions
or works very slowly:
--- The game complains that OpenGL 1.3: is not available, is missing OpenGL
extensions, or works very slowly ---
* Try to get updated graphics drivers.
The game crashes:
-- The game crashes ---
* Check the forums at http://forums.megaglest.org/
* It would be nice if you could report any other crashes and freezes that are
not yet described on the forums, preferably with a backtrace from a
debugging enabled build
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4. More information
* Please report any other crashes and freezes that are not yet described on
the forums, preferably with a backtrace from a debugging enabled build
~~~~~~~~~~~~~~~~~~~~~~~~~~ 4. More information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Website
http://megaglest.org/
* Wiki
http://wiki.megaglest.org/
https://docs.megaglest.org/Main_Page
* Forums
http://forums.megaglest.org/
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 5. Contact + Credits ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* MegaGlest is developed by:
Titus Tscharntke (info@titusgames.de)
Mark Vejvoda (www.soft-haus.com - mark_vejvoda@hotmail.com)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* General contact:
contact@megaglest.org
5. Contact + Credits
* MegaGlest is a fork of Glest:
http://glest.org/
MegaGlest is developed by:
Titus Tscharntke (info@titusgames.de)
Mark Vejvoda (www.soft-haus.com - mark_vejvoda@hotmail.com)
* Linux port by:
Matthias Braun
<matze@braunis.de>
with help from
Karl Robillard
<krobbillard@san.rr.com>
General contact:
contact@megaglest.org
Website:
http://megaglest.org
MegaGlest is a fork of Glest:
http://glest.org/
Linux port by:
Matthias Braun <matze@braunis.de> with help from Karl Robillard
<krobbillard@san.rr.com>
Please also refer to the copyright file.
*** Please also refer to the copyright file. ***