[Gcblue-commits] gcb_wx BUILDING.txt,1.1,1.2

[<ddc...@us...>]

Update of /cvsroot/gcblue/gcb_wx
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv30492

Modified Files:
	BUILDING.txt 
Log Message:


Index: BUILDING.txt
===================================================================
RCS file: /cvsroot/gcblue/gcb_wx/BUILDING.txt,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** BUILDING.txt	26 Nov 2003 20:39:14 -0000	1.1
--- BUILDING.txt	8 Mar 2004 21:49:01 -0000	1.2
***************
*** 1,46 ****
! List of dependencies:
!  
! wxWindows 2.4.1 
! OpenSceneGraph 0.9.5 (OpenGL 3D graphics engine)
! Producer (used by OpenSceneGraph for scene/camera management)
! OpenThreads (used by Producer for multithreaded cameras)
! OpenAL (replacement for DirectSound)
! Vorbis Ogg libraries (streaming music--build with Multithreaded DLL runtime libraries)
! Python 2.3.2 (embedded scripting engine)
! Boost Python 1.30.2 (C++ interface to Python. one file modified to build with Python 2.3. The CVS version of Boost Python may build without the mods)
  
! TODO provide links for download
! TODO provide info on auxiliary libraries like zlib, jpeg, etc that go with wxWindows and OSG
!  
! Paths for these libraries should be added to the IDE with Options->Projects->VC++ Directories 
!  
! Below is a summary of example paths for libraries installed in C:\
!  
! ---Include paths---
!  
! C:\Producer\include
! C:\OpenThreads\include
! C:\wxWindows-2.4.1\include
! C:\wxWindows-2.4.1\include\wx\msw
! C:\OpenSceneGraph-0.9.5\include
  C:\openal\include
! C:\Python-2.3.2\PC
! C:\Python-2.3.2\Include
! C:\boost-1.30.2
! C:\libogg-1.0\include
! C:\libvorbis-1.0\include
!  
! ---Libraries---
!  
! C:\Producer\lib
! C:\OpenThreads\lib
  C:\wxWindows-2.4.1\lib
! C:\OpenSceneGraph-0.9.5\lib
  C:\openal\lib
! C:\Python-2.3.2\PCbuild
! C:\boost-1.30.2\libs\python\build\bin-stage
! C:\demeter\lib
! C:\libogg-1.0\lib
! C:\libvorbis-1.0\libs (created this directory and moved vorbis libraries into it)
   
! The DLLs for these libraries should be copied into the bin/ directory.
--- 1,241 ----
! --- Download information ---
  
! * OpenSceneGraph 0.9.6-2 and OpenThreads-v1.2dev3   
! http://openscenegraph.sourceforge.net/downloads/index.html
! Follow links to Sourceforge download page.
! Download bundled OSG_OT_OP 0.9.6-2 package, and extract OSG and OT directories
!    to top level.
! Also download OSG_Win32_Dependencies-0.9.6-2.zip to get 3rdParty_2003-10-01 package.
! 
! 
! * Demeter 3.21
! http://www.terrainengine.com/downloads.html
! Follow links to Sourceforge download page
! 
! * wxWidgets 2.4.2  
! http://www.wxwidgets.org
! 
! * OpenAL (Beta) 
! CVS download instructions at http://www.openal.org/#Downloads
! 
! * LibOGG 1.1 and LibVorbis 1.0.1
! http://www.vorbis.com/download_win_1.0.1.psp
! libogg 1.1 source (listed as 1.0.1)
! libvorbis 1.0.1 source
! 
! * Python 2.3.3
! http://www.python.org/2.3.3/    
! Download  Python-2.3.3.tgz
! 
! --- Required libraries ---
! 
! Library                          Nominal installation path
! ------------------               -----------------------
! wxWidgets-2.4.2                  C:\wxWindows-2.4.2
! OpenSceneGraph-0.9.6-2           C:\OpenSceneGraph-0.9.6-2
! OpenThreads-v1.2dev3-osg0.9.6    C:\OpenThreads-v1.2dev3-osg0.9.6
! libxml and related               C:\3rdParty_2003-10-01
! Demeter 3.21                     C:\demeter-3.21
! OpenAL Beta                      C:\openal
! Lib OGG 1.1			 C:\libogg-1.1
! Lib Vorbis 1.0.1                 C:\libvorbis-1.0.1
! Python 2.3.3                     C:\Python-2.3.3
! Boost Python 1.31.0              C:\boost_1_31_0
! 
! --- Visual Studio Project Directories ---
! 
! * Include files
! 
! C:\3rdParty_2003-10-01\include
! C:\wxWindows-2.4.2\include
! C:\OpenSceneGraph-0.9.6-2\include
! C:\OpenThreads-v1.2dev3-osg0.9.6\include
  C:\openal\include
! C:\Python-2.3.3\PC
! C:\Python-2.3.3\Include
! C:\boost_1_31_0
! C:\demeter-3.21\include
! C:\libogg-1.1\include
! C:\libvorbis-1.0.1\include
! 
! * Library files
! 
! C:\3rdParty_2003-10-01\lib
! C:\OpenThreads-v1.2dev3-osg0.9.6\lib\win32
  C:\wxWindows-2.4.1\lib
! C:\OpenSceneGraph-0.9.6-2\lib
  C:\openal\lib
! C:\Python-2.3.3\PCbuild
! C:\boost_1_31_0\libs\python\build\bin-stage
! C:\demeter-3.21\lib
! C:\libogg-1.1\lib
! C:\libvorbis-1.0.1\libs
! 
! * Source files (optional for debugging libraries)
! 
! C:\wxWindows-2.4.1\src\msw
! C:\wxWindows-2.4.1\src
! C:\OpenSceneGraph-0.9.6-2\src
! C:\OpenThreads-v1.2dev3-osg0.9.6\win32_src
! C:\demeter-3.21\src
! 
! * Project file conversion
! - Project files should be converted from VC6 to Visual Studio (.NET2003) format
! - To convert, open the .dsw file and select "Yes to All" when the convert dialog appears
! 
! * Runtime libaries
! - All debug libraries must be built with the Multi-threaded Debug DLL runtime library (/MDd)
! - All release libraries must be built with the Multi-threaded DLL runtime library (/MD)
! 
! 
! 
! 
! * Build OpenThreads v1.2dev3-osg0.9.6
! 
! - Project file is at win32_src/OpenThreads.dsw directory
! 
! 
! 
! * Build OSG (unload osgProducer and example projects, keep other osg projects and plugins)
! 
! - Project file in VisualStudio directory
! 
! - Preprocessor defs:
!   Debug: _WINDOWS;SG_LIBRARY;WIN32;_DEBUG
!   Release: WIN32;NDEBUG;_WINDOWS;_USRDLL;SG_LIBRARY
! 
! - Unload examples and osgProducer projects
! 
! 
! 
! * Build Demeter 3.21
! 
! - Project file in VisualStudio directory
! 
! - Add #include <iostream> before "using namespace Demeter" statement in DemeterTextureLoader.cpp
! 
! - Build Demeter, DemeterOSG, and DemeterTextureLoader projects
! 
! 
! 
! 
! * Build Python 2.3.3
! 
! - Project file is at PCbuild/pcbuild.dsw 
! 
! - Enable RTTI
! 
! - Build debug and release for pythoncore project
! 
! - Use default preprocessor defs. They should be: 
!   Debug: _DEBUG;USE_DL_EXPORT;WIN32;_WINDOWS
!   Release: NDEBUG;WIN32;_WINDOWS;USE_DL_EXPORT
! 
! 
! 
! 
! * Build Boost Python 1.31.0
! 
! - Project file is at libs/python/build/VisualStudio/boost_python.dsw
! 
! - Debug preprocessor defs do not need to be modified if using the release python23.lib only
!   Defs should be: 
!     _DEBUG;WIN32;_WINDOWS;_USRDLL;BOOST_PYTHON_DYNAMIC_LIB;BOOST_PYTHON_SOURCE 
!   To use the debug Python library add BOOST_PYTHON_DEBUG def. 
! 
! - Release preprocessor defs do not need to be modified. They should be these: 
!     NDEBUG;WIN32;_WINDOWS;_USRDLL;BOOST_PYTHON_DYNAMIC_LIB;BOOST_PYTHON_SOURCE
! 
! - Produces warning C4244
! 
! 
! 
! 
! 
! * Build wxWidgets 2.4.2 (formerly known as wxWindows)
! 
! - Project file is at src/wxWindows.dsw
! 
! - In wxWindows project, open Headers/Setup/setup.h and change line 782 to read:
!     #define    wxUSE_GLCANVAS    1  
! 
! - In include/wx/string.h  add a line to suppress size_t conversion warning:
!     #pragma warning(disable:4267)
! 
! - Build Debug and Release configs for all projects in solution 
!   (do not build other configs like Debug DLL, Debug Unicode, etc.)
   
! - 1 warning, C4702
! 
! 
! * Build OpenAL (Beta)
! 
! - Project file is at win/OpenAL.dsw
! 
! - Create a lib directory
! 
! - Preprocessor defs:
!   Debug: _DEBUG;WIN32;_WINDOWS;_USRDLL;_OPENAL32LIB
!   Release: NDEBUG;WIN32;_WINDOWS;_USRDLL;_OPENAL32LIB
! 
! - Build OpenAL32 (as DLL) and ALut (as static library)
! 
! - Rename debug output to OpenAL32d.lib, OpenAL32d.dll, and ALutd.lib
! 
! - Copy OpenAL32d.lib, OpenAL32.lib, ALut.lib, and ALutd.lib to lib directory.
!   (or add post-build step to do this)
! 
! 
! 
! 
! 
! * Build Lib OGG 1.1
! 
! - Project file is win32/ogg.dsw
! 
! - Change runtime libary option to Multi-threaded Debug DLL for Debug config and
!   Multi-threaded DLL for Release config. 
! 
! - Create a libogg-1.1/lib directory
! 
! - Add Post-Build Event (under Build Events in Properties) for Debug configuration:
!       copy Static_Debug\ogg_static_d.lib ..\lib\ogg_static_d.lib
! 
! - Add Post-Build Event (under Build Events in Properties) for Release configuration:
!       copy Static_Release\ogg_static.lib ..\lib\ogg_static.lib
! 
! - Build the ogg_static project
! 
! - Produces 15 warnings, C4244 and C4146
! 
! 
! 
! 
! * Build Lib Vorbis 1.0.1
! 
! - Project file is win32/vorbis.dsw
! 
! - Change runtime libary option to Multi-threaded Debug DLL for Debug config and
!   Multi-threaded DLL for Release config. Do this for both vorbis_static and 
!   vorbisfile_static projects.
! 
! - Create a libvorbis-1.0.1/libs directory
! 
! - Add Post-Build Event for Debug config of vorbis_static:
!       copy Vorbis_Static_Debug\vorbis_static_d.lib ..\libs\vorbis_static_d.lib
! 
! - Add Post-Build Event for Release config of vorbis_static:
!       copy Vorbis_Static_Release\vorbis_static.lib ..\libs\vorbis_static.lib
! 
! - Add Post-Build Event for Release config of vorbisfile_static:
!       copy VorbisFile_Static_Release\vorbisfile_static.lib ..\libs\vorbisfile_static.lib
! 
! - Add Post-Build Event for Debug config of vorbisfile_static:
!       copy VorbisFile_Static_Debug\vorbisfile_static_d.lib ..\libs\vorbisfile_static_d.lib
! 
! - Build the vorbis_static and vorbisfile_static projects
! 
! - vorbis_static: 147 warnings debug, 151 warnings release
! 
! - vorbisfile_static: 11 warnings debug, 15 warnings release
!