mutter/build/win32/vs9
Chun-wei Fan 37fbfffcd0 Visual C++ 2008 support: Add note in README.txt
Tell people that they need to get a stdint.h implementation for Visual C++
2008 for use with Cogl-master/1.99.x+, and where they can obtain such an
implementation.

This is not needed for Visual C++ 2010 as it ships with stdint.h by
default.

(cherry picked from commit 938d70b78d672dd07e7124f7573d17d3e3079365)
2012-08-06 14:27:42 +01:00
..
cogl_sdl.sln Fix the EOL for the cogl_sdl.sln files 2011-12-20 22:39:02 +08:00
cogl-crate.vcproj VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
cogl-hello.vcproj VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
cogl-info.vcproj VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
cogl-msaa.vcproj VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
cogl-pango.vcprojin Update VS projects 2011-12-15 20:31:30 +08:00
cogl-sdl-hello.vcproj Bug 666349: Add/update Visual C++ projects to compile SDL winsys 2011-12-20 22:36:34 +08:00
cogl.sln VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
cogl.vcprojin Visual C++ projects Update 2012-08-06 14:27:41 +01:00
cogl.vsprops Fix Visual C++ build 2012-08-06 14:27:42 +01:00
install.vcproj VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00
Makefile.am Bug 666349: Dist files needed by MSVC for SDL winsys 2011-12-20 22:41:55 +08:00
README.txt Visual C++ 2008 support: Add note in README.txt 2012-08-06 14:27:42 +01:00
test-conformance-cogl.vcprojin VS 2008/2010 project files to build Cogl 2011-11-25 13:12:45 +00:00

Note that all this is rather experimental.

A more detailed description on using Visual C++ to compile COGL with
its dependencies can be found on the following GNOME Live! page:

https://live.gnome.org/GTK%2B/Win32/MSVCCompilationOfGTKStack

Please do not attempt to compile COGL in a path that contains spaces
to avoid potential problems during compilation, linking or usage.

This VS9 solution and the projects it includes are intented to be used
in a Cogl source tree unpacked from a tarball. In a git checkout you
first need to use some Unix-like environment or manual work to expand
the files needed, like config.h.win32.in into config.h.win32 and the
.vcprojin files here into corresponding actual .vcproj files.

Decide whether you want to build the SDL winsys with your COGL build, and
use one of the .sln for building COGL (note that both will build the Windows
OpenGL (WGL) winsys):
-cogl.sln for building COGL without the SDL winsys
-cogl_sdl.sln for building COGL with the SDL winsys

You will need the parts from GNOME: GDK-Pixbuf, Pango* and GLib.
External dependencies are at least zlib, libpng,
gettext-runtime* and Cairo*, and glext.h from
http://www.opengl.org/registry/api/glext.h (which need to be in the GL folder
in your include directories or in <root>\vs9\<PlatformName>\include\GL).

As Cogl 1.99.x and later will now use C99 types in lieu of GLib types, a
compatible implementation of stdint.h for Visual C++ is required, such
as the one from http://code.google.com/p/msinttypes/, so one would need
to download and extract the .zip file from that website and extract stdint.h
into <root>\vs9\<PlatformName>\include or somewhere where it can be
automatically found by the compiler.  Note that Visual C++ 2010 and later
ships with stdint.h, so it is only required for Visual C++ 2008 builds.

If building the SDL winsys is desired, you will also need the SDL libraries
from www.libsdl.org-building the SDL source package with Visual C++ 2008
is recommended (working Visual C++ 2005 projects are included with it, upgrade
the projects one prompted), but one may want to use the VC8 binary packages
from that website.

Please see the README file in the root directory of this Cogl source package
for the versions of the dependencies required.  See also
build/win32/vs9/README.txt in the GLib source package for details
where to unpack them.  It is recommended that at least the dependencies
from GNOME are also built with VS9 to avoid crashes caused by mixing different
CRTs-please see also the build/win32/vs9/README.txt in those respective packages.

The recommended build sequence of the dependencies are as follows (the non-GNOME
packages that are not downloaded as binaries from ftp://ftp.gnome.org have
makefiles and/or VS project files that can be used to compile with VS directly,
except the optional PCRE, which is built on VS using CMake; GLib has
VS9 project files in the latest stable versions, GDK-Pixbuf have VS9 project files
in the latest unstable version, and Pango should have VS9 project files
in the next unstable release):
-Unzip the binary packages for gettext-runtime, freetype, expat and fontconfig
 downloaded from ftp://ftp.gnome.org*
-zlib
-libpng
-(optional for GLib) PCRE (8.12 or later, building PCRE using CMake is
 recommended-please see build/win32/vs9/README.txt in the GLib source package)
-(for gdk-pixbuf, if GDI+ is not to be used) IJG JPEG
-(for gdk-pixbuf, if GDI+ is not to be used) jasper [JPEG-2000 library]
-(for gdk-pixbuf, if GDI+ is not to be used, requires zlib and IJG JPEG) libtiff
-GLib
-Cairo
-Pango
-GDK-Pixbuf

The "install" project will copy build results and headers into their
appropriate location under <root>\vs9\<PlatformName>. For instance,
built DLLs go into <root>\vs9\<PlatformName>\bin, built LIBs into
<root>\vs9\<PlatformName>\lib and Cogl headers into
<root>\vs9\<PlatformName>\include\Cogl-2.0.

*There is no known official VS9 build support for fontconfig
 (required for Pango and Pango at the moment-I will see whether this
 requirement can be made optional for VS builds)
 (along with freetype and expat) and gettext-runtime, so
 please use the binaries from: 

  ftp://ftp.gnome.org/pub/GNOME/binaries/win32/dependencies/ (32 bit)
  ftp://ftp.gnome.org/pub/GNOME/binaries/win64/dependencies/ (64 bit)

--Chun-wei Fan <fanc999@yahoo.com.tw>
  (Adopted from the GTK+ Win32 VS README.txt file originally by Tor Lillqvist)