用OpenInventor实现的NeHe OpenGL教程－第一课

用OpenInventor实现的NeHe OpenGL教程－第一课

OpenInventor是一种基于OpenGL的面向对象的三维图形软件开发包。使用这个开发包，程序员可以快速、简洁地开发出各种类型的交互式三维图形软件。这里不对OpenInventor做详细的介绍，读者如果感兴趣，可以阅读我的blog中的这篇文章《OpenInventor 简介》。

NeHe教程是目前针对初学者来说最好的OpenGL教程，它可以带领读者由浅入深，循序渐进地掌握OpenGL编程技巧。到目前为止（2007年11月），NeHe教程一共有48节。我的计划是使用OpenInventor来实现所有48节课程同样的效果。目的是复习和巩固OpenGL的知识，同时与各位读者交流OpenInventor的使用技巧。

因为篇幅的限制，我不会介绍NeHe教程中OpenGL的实现过程，因为NeHe的教程已经讲解的很清楚了，目前网络中也有NeHe的中文版本。我将使用VC 2003作为主要的编译器。程序框架采用和NeHe一样的Win32程序框架，不使用MFC。程序也可以在VC Express，VC 2005/2008中编译。我采用的OpenInventor开发环境是Coin，这是一个免费开源的OpenInventor开发库。文章《OpenInventor－Coin3D开发环境》介绍了如何在VC中使用Coin。我使用的Coin版本是2.5。读者可以到www.coin3d.org中免费下载。

读者可以在遵循GNU协议的条件下自由使用、修改本文的代码。水平的原因，代码可能不是最优化的，我随时期待读者的指正和交流。转载请注明。谢谢。
我的联系方式：
E-mail: < openinventor@gmail.com > < openinventor@126.com >
Blog: < http://blog.csdn.net/RobinHao >
Site: < http://www.openinventor.cn >


创建一个OpenInventor窗口
NeHe在第一课中讲述了如何在Windows环境中创建OpenGL程序。包括初始化OpenGL，设置OpenGL像素格式，创建OpenGL上下文等等。应该说OpenGL的初始化过程是一个比较复杂的过程。OpenInventor的初始化相对就比较简单了。

程序开始部分包含了OpenInventor所需要的头文件。读者可以查看OivDef.h文件，这个文件包含了以后将要使用的所有OpenInventor类的头文件。

#include <windows.h>
#include "../OivDef.h"

接着声明主窗口的类名和窗口标题名称。这两个变量将在创建主窗口时使用

TCHAR szWindowClass[] = "OivClass";
TCHAR szWindowTitle[] = "OpenInventor Framework";

声明OpenInventor的观察器和场景根节点变量。观察器我们采用SoWinExaminerViewer类型，这种类型的观察器提供的功能比较多，是使用频率最多的观察器类型。OpenInventor提供了多种类型的观察器，读者可以根据自己的情况选择适合的类型。

//Begin OIV
SoWinExaminerViewer* g_pOivView = NULL;
SoSeparator* g_pOivSceneRoot = NULL;

下面的函数是初始化OpenInventor，调用SoWin::init初始化OpenInventor的内部数据。注意，在调用任何OpenInventor函数之前，必须首先调用SoWin::init函数。创建一个SoWinExaminerViewer对象作为观察器。这个对象需要主窗口句柄作为参数。接着创建场景根节点，以后所有的元素都要放在这个根节点之下。setSceneGraph是将场景和观察器相关联，这样观察器才能看到场景中的物体。setDecoration（FALSE）的作用是隐藏观察器SoWinExaminerViewer附带的工具条。读者可以体验一下注释掉这条语句后程序运行的效果。setViewing（FALSE）的作用是让观察器处于“拾取”状态。SoWinExaminerViewer观察器有两种鼠标状态，“观察”状态是用户可以使用鼠标任意旋转场景中的物体，“拾取”状态是允许用户可以选择场景中的物体。AdjustWindowRectEx函数Win32 API，它的作用是根据输入窗口的类型参数，将窗口的客户区调整到我们需要的尺寸。这里我们希望主窗口的客户区大小为（640×480）。

BOOL InitOiv(HWND hMainWnd)
{
SoWin::init("");
g_pOivView = new SoWinExaminerViewer(hMainWnd);
g_pOivSceneRoot = new SoSeparator;
g_pOivSceneRoot->ref();

g_pOivView->setSceneGraph(g_pOivSceneRoot);
g_pOivView->setDecoration(FALSE);
g_pOivView->setViewing(FALSE);
g_pOivView->setTitle(szWindowTitle);

RECT rcView = { 0,0,640,480 };
AdjustWindowRectEx(&rcView, WS_OVERLAPPEDWINDOW, FALSE, WS_EX_APPWINDOW | WS_EX_WINDOWEDGE);
g_pOivView->setSize(SbVec2s(rcView.right - rcView.left,rcView.bottom - rcView.top));

return TRUE;
}

我们还需要在程序结束的时候，对OpenInventor做一些清理的工作。下面的函数将完成此任务。函数中首先删除掉场景的根节点。OpenInventor节点对象的内存管理采用的是 «“引用计数”技术，创建节点时使用new操作符创建，但删除节点时绝对不能使用delete删除。因为我们在前面的函数中对根节点增加了一次计数，所以我们只需要减少一次计数，就可以删除掉根节点了。关于OpenInventor对象内存管理方面的资料，读者可以阅读《The Inventor Mentor》一书第三章中的内容。在我的blog中有这本书的英文版和我翻译的中文版。最后还要删除掉观察器。因为观察器不是OpenInventor的节点对象，所以我们需要使用传统的delete方式删除掉这个对象。

void KillOiv(void)
{
if(g_pOivSceneRoot != NULL)
g_pOivSceneRoot->unref();

if(g_pOivView != NULL)
delete g_pOivView;
}

下面的代码都是Win32程序的框架代码，基本上和使用VC向导产生的框架代码相同，这里我就不再做解释。需要注意的地方就是在程序响应WM_DESTROY消息的时候，调用KillOiv来清除OpenInventor。在InitInstance函数中调用InitOiv函数来初始化OpenInventor。

好了，到了这里我们基本上完成了OpenInventor程序的框架代码，现在编译运行我们程序，屏幕上会出现一个背景为黑色的窗口。效果和NeHe第一课是相同的。有一点需要说明的是，NeHe的代码有切换全屏/窗口的功能，我不喜欢经常让显示器切换全屏/窗口，这会让我的桌面变得一片混乱。因此我没有在代码中增加上类似的功能。但OpenInventor提供了切换到全屏的功能函数，在以后的教程中我将会增加上此功能。


本课的完整代码下载。（VC 2003 ＋ Coin2.5）