Charles Dang 002b1a3c87 MP Staging/Join Game: unified player list handling and added player icons
Previously, MP Staging was using connect_engine::connected_users() to fill in the user list.
However, I noticed that the server was already sending the user list to all clients, including
the host, so I could unify the handling between Staging and Join Game by just using the server
data for both.

I've also added appropriate indicators for host, observer, and self in the list for both dialogs.
Additional host= and observer= status keys are sent by the server for that purpose.

I've also made the server dispatch the player list to the host when a game is created. This is
slightly redundant, since the host is the only player at that point, but it's easier than creating
a user config locally, or using connected_users(), not to mention easier to maintain.

The wesnothd::game::send_user_list function no longer exists early id `description_` is null.
No idea why it did that. It's not even used in the function. Anyway, it needed to be removed in
order for the above change to work.

Speaking of the host's copy of the player list, I haven't touched that. It's still needed for
managing things in the connect_engine. Might simplify things further in the future by delegating
more handling to the server, since it has a lot of the data needed already, but that's a different
project.
2017-12-14 11:12:49 +11:00
..

Compiling Wesnoth on Windows using Visual Studio

Please refer to the guide on wiki.wesnoth.org
http://wiki.wesnoth.org/CompilingWesnothOnWindows#Visual_Studio_2010_and_later

Generating a .vcproject file using cmake

The Visual Studio project is manually updated by its maintainers, which basically entails appending new source files as they are added to Wesnoth. Previously, it was regenerated by cmake, for which a legacy script msvc9-cmake.bat exists:

  1. make sure that git (formerly svn) command-line executable is in your %PATH%
  2. for wesnoth 1.8 and early pre-1.9 versions: download ftp://ftp.terraninfo.net/wesnoth/msvc9/external.zip (55mb download) and unpack it into wesnoth's directory - so, there'll be an 'external' folder in there.
  3. for wesnoth 1.9: download ftp://ftp.terraninfo.net/wesnoth/msvc9/external_19.zip (59mb download) and unpack it into wesnoth's directory - so, there'll be an 'external' folder in there.
  4. install cmake http://www.cmake.org/cmake/resources/software.html and put it into %PATH% (that can be done by the installer)
  5. to allow the game to run, put full path to external/dll into %PATH%
  6. run external/msvc9-cmake.bat
  7. open generated project file in msvc9 and compile. the project should pick up changes in cmake files automatically. Also, you can re-run the .bat file to regenerate it.

Building the prerequisites

We'll assume to have two General Folders for libraries and includes to store most of the prerequisites. (Otherwise each configuration setting for each project would need to have each and every 'lib' and 'include' folder added.)
C:\projects\_include
C:\projects\_lib

We'll now start downloading and compiling/copying the prerequisites into the necessary folders, all version numbers are minimal requirements:

  1. zlib-1.2.3 ( http://www.zlib.net/ )

    Download the zlib source code zlib123.zip and unpack it into the projects folder to get:
    C:\projects\zlib123\

    Open the file zlib.dsw in the folder
    C:\projects\zlib123\projects\visualc6\
    with MSVC and select 'Yes To All' to convert it into a VC9 project.

    Open the properties of the 'zlib' solution and in the 'Configuration Properties' select the 'DLL Release' 'Configuration'. Select 'OK' and then right-click the 'zlib' project and select 'Build'. After a successful Build, close that instance of MSVC.

  2. libsdl-1.2.10 ( http://www.libsdl.org )

    Download the development library file for Win32 as well as the source code
    SDL-1.2.10.zip
    SDL-devel-1.2.10-VC8.zip
    and unpack them into the projects folder to get:
    C:\projects\SDL-1.2.10\

    Copy the 'SDL.dll' and the 'SDL.lib' from the 'lib' folder and the contents of 'include' folder into the corresponding General Folder ( ..._include\ resp. ..._lib\ ).

    Unpack the 'VisualC.zip' and open the 'SDL.sln' file with MSVC. Follow the instructions to convert the project to VC9.

    Right-click the 'SDLmain' project and select 'Build'. After a successful Build, close that instance of MSVC.

    Copy 'SDLmain.lib' from
    C:\projects\SDL-1.2.10\VisualC\SDLmain\Debug
    into the 'lib' General Folder.

  3. libboost-1.50.0 ( http://www.boost.org/ )

    Note these instructions are still referring to Boost 1.48.0, and are so pending possible fixes to make it Boost >= 1.50.0 compliant.

    Download Boost and unpack it into the folder
    C:\projects\

    This should give you a folder structure like
    C:\projects\boost_1_48_0\

    Download the pre-built bjam executable
    boost-jam-3.1.17-1-ntx86.zip
    from the bjam download page on sourceforge http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=72941 and unpack and move the bjam executable it into the base folder of boost
    C:\projects\boost_1_48_0\

    Now start the command prompt (CMD.exe) and invoke the following commands:

    	C:\> set ZLIB_SOURCE=C:\projects\zlib123\
    	C:\> set ZLIB_LIBPATH=C:\projects\zlib123\projects\visualc6\Win32_DLL_Release
    	C:\> set ZLIB_BINARY=zlib1.dll
    	C:\> cd C:\projects\boost_1_48_0
    	C:\projects\boost_1_48_0> bjam ^
    	More? --toolset=msvc ^
    	More? --build-type=complete ^
    	More? --prefix="C:\projects\Boost\" install
    

    If the upper last command doesn't work, replace the last line with:

    	--prefix="C:\projects\Boost" install
    

    Now bjam will compile all variants of the boost library binaries for MSVC 2008 and copies them into the folder
    C:\projects\Boost\lib\
    while all required headers are copied into
    C:\projects\Boost\include\boost-1_38\boost

    Use the time bjam is busy compiling (possibly several hours) as you wish. (It is possible to continue downloading and copying the include and lib files since all required compiling is done.)

    Once bjam has finished building/copying, you then can delete the folder
    C:\projects\boost_1_48_0\
    to free up space.

  4. sdl-image-1.2 (with PNG support) ( http://www.libsdl.org/projects/SDL_image )

    Download the binary file for Win32
    SDL_image-devel-1.2.7-VC9.zip
    and unpack it into the projects folder to get:
    C:\projects\SDL_image-1.2.7\

    Copy the contents of each the 'lib' and the 'include' folder into the corresponding General Folder.

  5. sdl-mixer-1.2.12 (with Vorbis support) ( http://www.libsdl.org/projects/SDL_mixer )

    Download the binary file for Win32
    SDL_mixer-devel-1.2.12-VC8.zip
    and unpack it into the projects folder to get:
    C:\projects\SDL_mixer-1.2.12\

    Copy the contents of each the 'lib' and the 'include' folder into the corresponding General Folder.

  6. sdl-ttf-2.0.8 ( http://www.libsdl.org/projects/SDL_ttf )

    Download the binary file for Win32
    SDL_ttf-devel-2.0.8-VC8.zip
    and unpack it into the projects folder to get:
    C:\projects\SDL_ttf-2.0.8\

    Copy the contents of each the 'lib' and the 'include' folder into the corresponding General Folder.

  7. libfontconfig-2.4.1 ( http://www.gtk.org/download/win32.php )

    Download the 'Fontconfig' package 'Binaries' from the 'Third Party Dependencies'
    fontconfig-2.4.2-tml-20071015.zip
    and unpack it into the projects folder to get: C:\projects\fontconfig-2.4.2\

    Copy the 'libfontconfig-1.dll' from the 'bin' folder into the 'lib' General Folder.

  8. pangocairo-1.24.4 ( http://www.gtk.org/download-windows.html )

    Download the following 'Binaryies' and 'Dev' packages from the 'GTK+ individual packages'
    cairo_1.8.6-1_win32.zip
    cairo-dev_1.8.6-1_win32.zip
    glib_2.20.0-1_win32.zip
    glib-dev_2.20.0-1_win32.zip
    pango_1.24.0-1_win32.zip
    pango-dev_1.24.0-1_win32.zip
    and unpack them into the projects folder to get:
    C:\projects\pangocairo\

    Copy all dll's from the 'bin' folder into the '_lib' General Folder. Copy the contents (but not the subfolders) of the 'lib' folder into the corresponding General Folder. Copy the 'glibconfig.h' file from
    C:\projects\pangocairo\lib\glib-2.0\include into the '_include'
    General Folder. Copy the contens (including subfolders) of the following folders into the '_include' General Folder:
    C:\projects\pangocairo\include\cairo
    C:\projects\pangocairo\include\glib-2.0
    C:\projects\pangocairo\include\pango-1.0