OpenSceneGraph学习笔记1-源码编译及doxygen文档

osg 源码编译

我安装环境是：
window10、vs2017、OpenSceneGraph3.6.5

下载安装包如下：

OpenSceneGraph 源码稳定版本 下载官网链接如下：
http://www.openscenegraph.org/index.php/download-section/stable-releases

第三方依赖库 下载的官网链接如下：
http://www.openscenegraph.org/index.php/download-section/dependencies

osg官方示例数据包 下载的官网链接如下：
http://www.openscenegraph.org/index.php/download-section/data

注意：
由于 第三方依赖库 只有 vs2017 x64 和vs2013 x64。我选择的vs2017 x64。osg源码编译的时候需要编译64位的。所以，在cmake生成选择的时候要注意选择 vs2017 x64，否则会出现 编译OpenThread项目的时候报错误“error LNK1112”。这个错误有很弱智，不过记录一下吧。

doxygen文档生成配置

doxygen安装教程运行生成的帮助文档没有内容。

1、修改配置文件
需要配置，配置文档相对路径位置如下：
\osg\OpenSceneGraph-3.6.5\doc\Doxyfiles

我选择 all_Doxyfile文件的配置。先保存all_Doxyfile文件的备份，然后对文件进行修改。

• 将 ${OPENSCENEGRAPH_VERSION} 用版本号替代，我这里是3.6.5.
• 将 ${OpenSceneGraph_SOURCE_DIR} 用 源码绝对路径替代，即C:/osg/OpenSceneGraph-3.6.5
• 将 ${DOXYGEN_DOT_PATH} 用 文档输出路径替代，即C:\osg\doc\out
• 将 DOT_GRAPH_MAX_NODES = 50 改为 DOT_GRAPH_MAX_NODES = 500

2.打开doxygen软件，File-Open-\doc\Doxyfiles\all_Doxyfile；
3.将 源码位置目录改成 C:/osg/OpenSceneGraph-3.6.5，将目标位置目录改成doc想放的目录位置。
3.直接点击run，生成文档就可以了。

参考文档如下：
https://www.cnblogs.com/cll131421/p/5867634.html
https://blog.csdn.net/X249125114/article/details/101717776

运行实例程序

看看实例中的模型和数据是否齐全。
环境变量设置 对系统变量设置如下：
OSG_FILE_PATH: D:\OSG\data
这里设置的文件夹是osg的资源路径。

运行osgvision，显示osg版本号。
运行osgviewer cow.osg 显示一个奶牛模型，如下图。

osg编译运行成功。