一、准备安装程序需要的程序及其资源等
1.下载OSG源码,我这里用的是OpenSceneGraph-3.0.1版本,下载地址为:
http://www.openscenegraph.org/projects/osg/wiki/Downloads
2.编译安装源代码需要使用Cmake,版本在Cmake-2.8.6-win32-x86.zip及以上版本即可
3.第三方库资源包,我这里用的是3rdParty_VC9sp1_x86_x64_V7,下载地址为:
http://www.openscenegraph.org/projects/osg/wiki/Downloads/Dependencies
4.数据文件包OpenSceneGraph-Data-3.0.0,下载地址:
http://www.openscenegraph.org/projects/osg/wiki/Downloads/SampleDatasets
二、编译流程
本人编译环境设置如下,OSG根目录为:D:\MyUserData\Projects\GameEngine\OSG
在该目录下建立了三个文件夹
1、OpenSceneGraph-3.0.1(放置OSG最新库文件,将openSceneGraph-3.0.1.zip解压到这个文件夹下)
2、OpenSceneGraph-Data-3.0.0(放置OpenSceneGraph-Data-3.0.0.zip的解压数据,主要用于examples的演示)
3、3rdParty_VC9sp1_x86_x64_V7(放置第三方库,将3rdParty_VC9sp1_x86_x64_V7.zip解压到这个文件夹下)
三、用Cmake生成project和solution文件
1、 在xxx/OpenSceneGraph-3.0.1下新建两个文件夹,分别命名为build、bin,用于放置编译文件
2、 解压cmake-2.8.6,打开bin/cmake-gui.exe,将xxx/OpenSceneGraph-3.0.1下的CMakeLists.txt拖到界面上。
3、在Where to build thebinaries选项中,在路径的末尾加上“/build”,即为:xxx/OpenSceneGraph-3.0.1/build。在这个文件夹中将存放cmaker生成的二进制文件。
4、此时软件会弹出对话框询问你要生成哪种项目工程,我们选择Visual Studio 9 2008。然后点击Finish确定。
5、在此之后,软件便开始configure这个项目,它会分析项目中已有的相关配置。然后将有疑问的未配置项目标定为红色。
6、设置相关的cache value参数,这里主要设置的参数包括:
(1)ACTUAL_3RDPARTY_DIR:设置为前面的 xxx/3rdParty_VC9sp1_x86_x64_V7 ACTUAL_3DPARTY_DIR:即整合的第三方开发库所在目录,如果下载了OSG提供的整合好的第三方开发库,那么可以在这里设置解压缩之后它的位置,CMake将在下次配置时自动搜索所需的Lib文件和头文件路径。
(2)BUILD_OSG_EXAMPLES:是否编译OSG所有例子程序的选项,这个可以根据实际情况进行选择,默认应当选择“ON”。即编译实例,我在编译的时候选择了“YES”
(3)CMAKE_CONFIGURATION_TYPES:定义了工程文件中工程配置的种类,缺省值包括Debug,Release,MinSizeRel和RelWithDebInfo四种类型。注意不同的配置类型在工程中对应不同的编译选项,可以在CMAKE_CXX_FLAGS和CMAKE_EXE_LINKER_FLAGS中进行修改。
(4)CMAKE_INSTALL_PREFIX:xxx/OpenSceneGraph-3.0.1/bin
CMAKE_INSTALL_PREFIX:用于以后保存编译生成的EXE,DLL和LIB文件的路径,在这个路径下会自动建立bin(为可执行程序的执行提供DLLs),lib(库文件), include(头文件), and share\OpenSceneGraph\bin\(实例的可执行文件)等四个文件夹
7、配置好以上四个项目后,按下“Configure”按钮进行本次配置,而与当前所配置的项相关联的选项将在下一次配置时再次变红,等待用户重新进行配置;
第一次配置完成后,将右上角的Show Advanced Values 复选框选择上,将MFC EXAMPLE 设置为ON.
忽略其他未配置项,一直点击“Configure”按钮直到“Generate”按钮变回可用。
8、按下“Generate”按钮,此时将生成用户所需的所有Visual Studio 9 2008工程文件。
四、用VS2008编译生成二进制文件
1、进入xxx\OpenSceneGraph-3.0.1\build文件夹,双击OpenSceneGraph.sln文件,则会在VS2008中打开整个解决方案。
2、使用Debug编译模式,选择项目列表中的ALL_BUILD,然后点击右键,选择菜单中的“Build”命令编译整个解决方案。
3、整个编译过程会持续很长时间,需要耐心等待,编译完成后,在项目列表中,选择“INSTALL”子项目,然后点击右键,选择菜单中的“Build”执行安装程序,安装的目录位置就是在CMake中设置的CMAKE_INSTALL_PREFIX选项的属性值。
4、将编译选项设置为Release,重复这项2、3步骤。
至此,OSG3.0.1源码的编译工作全部完成。编译好的文件已经全部安装在xxx/OpenSceneGraph-3.0.1中。
五、设置环境变量
右击我的电脑->属性->高级->环境变量,添加相应的环境变量如下:
用户变量:OSG_FILE_PATH =D:\MyUserData\Projects\GameEngine\OSG\OpenSceneGraph-Data-3.0.0
系统变量path下添加 D:\MyUserData\Projects\GameEngine\OSG\OpenSceneGraph-3.0.1\bin\bin,主要用于dll的调用。
六、测试工程是否可用
在命令行中,输入osgViewerd.exe cow.osg回车,如果能成功运行,程序将会打开一个“母牛”的3D模型。
(注意:有的电脑可能系统提示缺失zlib1.dll和zlib1d.dll,这两个分别对应Release和Debug版本,在3rdParty文件夹中可以找到,把他们添加到C:\WINDOWS\SYSTEM32,,然后dll注册,
方法:开始,运行,输入“regsvr32 zlib1.dll”,回车,zlib1d.dll同样方式。)
七、设置VS2008的路径
打开VS2008,工具->选项->项目解决方案->VC++目录,分别设置OSG的头文件及库文件
包含文件里添加:D:\MyUserData\Projects\GameEngine\OSG\OpenSceneGraph-3.0.1\bin\include
库文件添加:D:\MyUserData\Projects\GameEngine\OSG\OpenSceneGraph-3.0.1\bin\lib
(或者直接在工程里面设置也可以)
八、新建OSG项目测试
(1)打开VS2008,创建一个WIN32控制台程序。
(2)注意:请选空项目,在源程序中添加一个新项,添加一个C++文件(cpp)。
(3)在这个CPP文件中输入代码:
#include<osgViewer/Viewer>
#include <osgDB/ReadFile>
intmain( int, char ** )
{
osgViewer::Viewer viewer;
viewer.setSceneData(osgDB::readNodeFile( "cow.osg" ) );
return viewer.run();
}
(4)打开项目属性的链接器,输入里加上:
OpenThreads.lib
osg.lib
osgDB.lib
osgUtil.lib
osgGA.lib
osgViewer.lib
osgText.lib
注意:
如编译的是Release版本,编译的库都有的命名为*.lib
如果是Debug版本,要添加对应的*d.lib库