Coin3D的安装与设置.doc

Coin3D的安装与设置目前，世界上有三种成熟的Open Inventor产品：SGI Open Inventor、TGS（VSG）Open Inventor和SIM Open Inventor。SGI Open Inventor现为开源软件，但只能在UNIX环境下使用；TGS Open Inventor的功能最为强大，提供可以在Windows上使用的版本，但它是一个商业化产品，价格非常昂贵；SIM Open Inventor（即Coin3D）同时支持UNIX和Windows，虽然功能上不如TGS那么强悍，但提供了开源的版本。对于Open Inventor的初学者和普通用户而言，选择Coin3D是非常合适的。首先，Coin3D在功能上完全可以满足一般的编程需要（除了非常专业的商业软件开发）；其次，Coin3D的源代码是完全公开的，这使得我们可以深入地了解Open Inventor的实现细节，并可以在遵守GPL协议的前提下对其进行任意地修改。第三，它可以免费使用。在Windows环境中，Coin3D只能配合Visual Studio（确切地说是Visual C+）一起使用。Coin3D支持Visual C+的多个版本，包括6.0、7.0（2002）、7.1（2003）、8.0（2005）和9.0（2008）。使用Coin3D前，首先需要建立好相应的开发环境。由于Coin3D的较新版本（2.3.0以上）不再提供安装程序，其安装和设置均需手工完成。这个过程相对而言比较繁琐，容易出错，设置不当会导致Coin3D不能正常工作。因此，本文将详细介绍Coin3D的安装与设置方法。首先进入Coin3D官方网站的下载页面/lib/downloads，选择下载开源软件。然后，在新页面中选择继续下载。在下载列表页面中，可以发现Coin3D由Coin、GUI bindings、File import/export libs、Add-on libs等几部分组成。GUI bindings针对不同的GUI环境分化成多个组件，而File import/export libs又包含simage、Profit和Dime。需要注意的是，Coin3D的每个组件都具有自己的版本号。这说明每个组件都是单独开发和演进的，各个组件之间在架构上是相互兼容的，并不要求组件之间的版本互相搭配。例如，Coin的3.1.2版本可以搭配SoWin 1.4.0，也可以搭配SoWin 1.5.0。这样，使得每个组件的最新版本都能得到及时地应用，也为用户提供了更多的灵活性。因此，Coin3D的每个组件都是单独发行的。下表列出了Coin3D所包含的组件及其主要用途。其中绿色的部分为必装组件，黄色的部分需要根据不同的平台来选用，青色的部分为可选组件。对于Windows平台而言，必选的组件为Coin、SoWin和simage，而Dime、Profit和Voleon可根据实际需要进行选择。1 安装前的准备工作1）安装好开发环境（例如Vsiual Studio 2008）；2）建立目标文件夹（例如C:Coin3D，也称之为$(COINDIR)）。3）设置环境变量右击桌面上“我的电脑”图标，在弹出的快捷菜单中选择“属性”，在“系统属性”对话框中单击“高级”选项卡。点击“环境变量”按钮，弹出“环境变量”对话框中，新建一个环境变量COINDIR，如下图所示。新建一个环境变量方法如下：单击用户变量下的“新建”按钮，新建一个环境变量COINDIR，如下图所示。单击path变量后，再单击用户变量下的“编辑”按钮，将“C:Coin3Dbin”添加到Path列表之中，如下图所示。2 Coin组件的安装Coin组件的安装方式有两种：一种是下载Coin的源代码文件，通过生成解决方案的方法来实现安装过程；另一种方法是直接下载针对某个VC版本的组件包，解压缩到$(COINDIR)目录。由于后一种方法比较简单，而且在安装的过程中不会出现错误，推荐初学者使用。1）在Coin 3.1.3的页面上，选择“Get Coin 3.1.3 for Windows(Visual C+ 9.0 binaries)”，下载到您的计算机。2）将Coin-3.1.3-bin-msvc9.zip解压到C:Coin3D文件夹，您将发现C:Coin3D目录中增加了四个文件夹。此时，Coin组件已经安装就位。3 SoWin组件的安装SoWin组件的安装相对复杂些，步骤如下。1）在SoWin 1.5.0的页面上，下载SoWin 1.5.0的源代码压缩包（一般选择zip格式）。2）将SoWin-1.5.0解压到某个文件夹（除了C:Coin3D），在.SoWin-1.5.0buildmsvc9文件夹中找到sowin1.sln，双击它。Visual C+ 2008会自动启动，并将解决方案“sowin1”装载进来。3）点击生成菜单下的“生成解决方案”，则解决方案会被重新生成。此时，可以发现msvc9文件夹中增加了一个sowin1d.dll文件和一个debug子目录。4）将解决方案的配置改成“DLL（Release）”，再次生成解决方案。则msvc9文件夹中又增加了一个sowin1.dll文件和一个Release子目录（其中含有sowin1.lib）。由于组件程序自身版本升级带来的问题，生成解决方案过程中会提示很多的警告和写日志文件的出错，这些不影响组件的安装。打开C:Coin3D文件夹，发现C:Coin3Dbin文件夹中增加了sowin1.dll、sowin1d.dll、sowin1d.pdb，C:Coin3Dlib文件夹中增加了sowin1.lib和sowin1d.lib，C:Coin3DincludeInventor中增加了Win文件夹，其中含有一大堆与SoWin有关的头文件。此时，说明SoWin组件已安装成功。4 其他组件的安装其他组件的安装方法与SoWin一样，这里不再赘述。需要指出的是，采用组件包的方式安装Coin组件时，已经将simage组件装好了，可以直接使用。5 Visual C+ 9.0的设置Visual C+ 9.0的设置，包括指定包含文件和库文件路径、指定宏定义、指定链接的库文件几个步骤：1）启动Visual C+ 9.0，工具选项，点击“项目和解决方案”下的“VC+目录”；选择“包含文件”，新建一个条目，指向C:Coin3D include文件夹。同样的方法，添加指向Coin3D库文件的路径。以上步骤只需设置一次。当VC9重装时或$(COINDIR)发生变化时，需要重新设定。以下步骤需要对每一个使用Coin3D的项目施行。2）新建一个Visual C+项目（例如Exam02），选择Win32控制台应用程序模板。然后，选择菜单“项目”“属性”；在“配置”下拉列表中选择“所有配置”；点击“C/C+”分支，点击“预处理器”；在“与处理器定义”编辑框中添加：“COIN_DLL;SOWIN_DLL”。3）在“配置”下拉列表中选择“Debug”；点击“连接器”分支，点击“输入”；在“附加依赖项”编辑框中添加：“coin3d.lib sowin1d.lib”。 4）在“配置”下拉列表中选择“Release”；点击“连接器”分支，点击“输入”；在“附加依赖项”编辑框中添加：“coin3.lib sowin1.lib”。6 简单验证为了验证Coin3D确实安装和设置好了，我们可以通过编写一个简单的程序来进行测试。在Exam02的源文件中，添加如下代码：#include #include #include #include int main(int, char * argv) HWND window = SoWin:init(argv0); if (window=NULL) exit(1); SoWinExaminerViewer * viewer = new SoWinExaminerViewer(window); SoSeparator * root = new SoSeparator; SoCone * cone = new SoCone; root-ref(); ro