Cr8-xyz/blender
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

update to cmake doc, still needs more work but update references to CVS and MSVC2005 and Python3.1

Browse Source
This commit is contained in:
Campbell Barton
2011-10-10 04:16:16 +00:00
parent f0cd9f987d
commit 1fd55c3130
1 changed files with 25 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
doc/build_systems/cmake.txt
View File

@@ -11,7 +11,7 @@ $Id$
3. Obtaining Dependencies 3. Obtaining Dependencies
4. Deciding on a Build Environment 4. Deciding on a Build Environment
5. Configuring the build for the first time 5. Configuring the build for the first time
6. Configuring the build after CVS updates 6. Configuring the build after SVN updates
7. Specify alternate Python library versions and locations 7. Specify alternate Python library versions and locations
@@ -36,7 +36,7 @@ $Id$
http://www.blender.org/cms/Getting_Dependencies.135.0.html that you http://www.blender.org/cms/Getting_Dependencies.135.0.html that you
have all dependencies needed for building Blender. Note that for have all dependencies needed for building Blender. Note that for
windows many of these dependencies already come in the lib/windows windows many of these dependencies already come in the lib/windows
module from CVS. module from SVN.
4. Deciding on a Build Environment 4. Deciding on a Build Environment
---------------------------------- ----------------------------------
@@ -47,8 +47,8 @@ $Id$
have been successfully used to generate build files for the following have been successfully used to generate build files for the following
environments: environments:
1. Microsoft Visual Studio 2005. There is a free version available 1. Microsoft Visual Studio 2008. There is a free version available
at http://msdn.microsoft.com/vstudio/express/visualc/. at http://http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express
2. Xcode on Mac OSX 2. Xcode on Mac OSX
@@ -65,7 +65,7 @@ $Id$
with different Blender configurations (Audio/NoAudio, GameEngine/NoGameEngine etc.) with different Blender configurations (Audio/NoAudio, GameEngine/NoGameEngine etc.)
while maintaining a clean source tree. It also makes it possible to generate files while maintaining a clean source tree. It also makes it possible to generate files
for different build systems on the same source tree. This also has benefits for for different build systems on the same source tree. This also has benefits for
general CVS management for the developer as patches and submit logs are much cleaner. general SVN management for the developer as patches and submit logs are much cleaner.
Create a directory outside the blender source tree where you would like to build Create a directory outside the blender source tree where you would like to build
Blender (from now on called $BLENDERBUILD). On the commandline you can then run Blender (from now on called $BLENDERBUILD). On the commandline you can then run
@@ -78,27 +78,27 @@ $Id$
% cd $BLENDERBUILD % cd $BLENDERBUILD
% cmake % cmake
... ...
... ...
--version [file] = Show program name/version banner and exit. --version [file] = Show program name/version banner and exit.
Generators Generators
The following generators are available on this platform: The following generators are available on this platform:
KDevelop3 = Generates KDevelop 3 project files. KDevelop3 = Generates KDevelop 3 project files.
Unix Makefiles = Generates standard UNIX makefiles. Unix Makefiles = Generates standard UNIX makefiles.
Xcode = Generate XCode project files. Xcode = Generate XCode project files.
% cmake -G Xcode $BLENDERSOURCE % cmake -G Xcode $BLENDERSOURCE
... ...
... ...
-- Configuring blender -- Configuring blender
-- Configuring blenderplayer -- Configuring blenderplayer
-- Configuring done -- Configuring done
-- Generating done -- Generating done
-- Build files have been written to: $BLENDERBUILD -- Build files have been written to: $BLENDERBUILD
This will generate the build files with default values. Specific features can This will generate the build files with default values. Specific features can
be enabled or disabled by running the ccmake "GUI" from $BLENDERBUILD as follows: be enabled or disabled by running the ccmake "GUI" from $BLENDERBUILD as follows:
@@ -114,15 +114,15 @@ $Id$
It is also possible to use the commandline of 'cmake' to override certain It is also possible to use the commandline of 'cmake' to override certain
of these settings. of these settings.
6. Configuring the build after CVS updates 6. Configuring the build after SVN updates
------------------------------------------ ------------------------------------------
The $BLENDERBUILD directory maintains a file called CMakeCache.txt which The $BLENDERBUILD directory maintains a file called CMakeCache.txt which
remembers the initial run's settings for subsequent generation runs. After remembers the initial run's settings for subsequent generation runs. After
every CVS update it may be a good idea to rerun the generation before building every SVN update it may be a good idea to rerun the generation before building
Blender again. Just rerun the original 'cmake' run to do this, the settings Blender again. Just rerun the original 'cmake' run to do this, the settings
will be remembered. For the example above the following will do after every will be remembered. For the example above the following will do after every
'cvs up': 'svn up':
% cmake -G Xcode $BLENDERSOURCE % cmake -G Xcode $BLENDERSOURCE
@@ -132,9 +132,9 @@ $Id$
The commandline can be used to override detected/default settings, e.g: The commandline can be used to override detected/default settings, e.g:
On Unix: On Unix:
cmake -D PYTHON_LIBRARY=/usr/local/lib/python3.1/config/libpython3.1.so -D PYTHON_INCLUDE_DIRS=/usr/local/include/python3.1 -G "Unix Makefiles" ../blender cmake -D PYTHON_LIBRARY=/usr/local/lib/python3.2/config/libpython3.2.so -D PYTHON_INCLUDE_DIR=/usr/local/include/python3.2 ../blender
On Macs: On Macs:
cmake -D PYTHON_INCLUDE_DIRS=/System/Library/Frameworks/Python.framework/Versions/3.1/include/python3.1 -G Xcode ../blender cmake -D PYTHON_INCLUDE_DIRS=/System/Library/Frameworks/Python.framework/Versions/3.2/include/python3.2 -G Xcode ../blender
Mote that this should only be needed once per build directory generation because it will keep the overrides in CMakeCache.txt for subsequent runs. Mote that this should only be needed once per build directory generation because it will keep the overrides in CMakeCache.txt for subsequent runs.
@@ -153,4 +153,3 @@ $Id$
on the various platforms. on the various platforms.
/Jacques Beaurain (jbinto) /Jacques Beaurain (jbinto)