开发基于 OpenGL的应用程序,必须先了解 OpenGL的库函数。它采用 C语言风格,提供大量的函数来进行图形的处理和显示。 OpenGL库函数的命名方式非常有规律。所有 OpenGL函数采用了以下格式:
<库前缀><根命令 ><可选的参数个数 ><可选的参数类型 >
库前缀有 gl、glu、aux、glut、wgl、glx、agl等等,分别表示该函数属于 OpenGL那个开发库,从函数名后面中还可以看出需要多少个参数以及参数的类型。 I代表 int型,f代表 float型,d代表 double型,u代表无符号整型等等。例如glVertex3fv()表示了该函数属于 gl库,参数是三个 float型参数指针。
OpenGL函数库相关的 API有核心库 (gl)、实用库 (glu)、辅助库 (aux)、实用工具库 (glut)、窗口库(glx、agl、wgl)和扩展函数库等。从图可以看出, gl是核心, glu是对 gl的部分封装。 glx、 agl、wgl 是针对不同窗口系统的函数。 glut是为跨平台的 OpenGL程序的工具包,比 aux功能强大。扩展函数库是硬件厂商为实现硬件更新利用 OpenGL的扩展机制开发的函数。下面逐一对这些库进行详细介绍。
1.OpenGL核心库
核心库包含有 115个函数,函数名的前缀为 gl。这部分函数用于常规的、核心的图形处理。此函数由 gl.dll来负责解释执行。由于许多函数可以接收不同数以下几类。据类型的参数,因此派生出来的函数原形多达 300多个。核心库中的函数主要可以分为以下几类函数:
• 绘制基本几何图元的函数: glBegain()、glEnd()、glNormal*()、glVertex*();
• 矩阵操作、几何变换和投影变换的函数:如矩阵入栈函数 glPushMatrix(),矩阵出栈函数 glPopMatrix(),装载矩阵函数 glLoadMatrix(),矩阵相乘函数 glMultMatrix(),当前矩阵
函数 glMatrixMode()和矩阵标准化函数 glLoadIdentity(),几何变换函数 glTranslate*()、 glRotate*()和 glScale*(),投影变换函数 glOrtho()、glFrustum()和视口变换函数 glViewport();
• 颜色、光照和材质的函数:如设置颜色模式函数 glColor*()、glIndex*(),设置光照效果的函数 glLight*()、glLightModel*()和设置材质效果函数 glMaterial();
• 显示列表函数:主要有创建、结束、生成、删除和调用显示列表的函数 glNewList()、 glEndList()、glGenLists()、glCallList()和 glDeleteLists();
• 纹理映射函数:主要有一维纹理函数 glTexImage1D()、二维纹理函数 glTexImage2D()、设置纹理参数、纹理环境和纹理坐标的函数 glTexParameter*()、glTexEnv*()和 glTetCoord*();
• 特殊效果函数:融合函数 glBlendFunc()、反走样函数 glHint()和雾化效果 glFog*();
• 光栅化、像素操作函数:如象素位置 glRasterPos*()、线型宽度 glLineWidth()、多边形绘制模式 glPolygonMode(),读取象素 glReadPixel()、复制象素 glCopyPixel();
• 选择与反馈函数:主要有渲染模式 glRenderMode()、选择缓冲区 glSelectBuffer()和反馈缓冲区 glFeedbackBuffer();
• 曲线与曲面的绘制函数:生成曲线或曲面的函数 glMap*()、glMapGrid*(),求值器的函数 glEvalCoord*() glEvalMesh*();
• 状态设置与查询函数: glGet*()、glEnable()、glGetError()。
2.OpenGL实用库 The OpenGL Utility Library (GLU)
包含有 43个函数,函数名的前缀为 glu。OpenGL提供了强大的但是为数不多的绘图命令,所有较复杂的绘图都必须从点、线、面开始。 Glu 为了减轻繁重的编程工作,封装了 OpenGL函数,Glu函数通过调用核心库的函数,为开发者提供相对简单的用法,实现一些较为复杂的操作。此函数由 glu.dll来负责解释执行。 OpenGL中的核心库和实用库可以在所有的 OpenGL平台上运行。主要包括了以下几种:
• 辅助纹理贴图函数: gluScaleImage() 、gluBuild1Dmipmaps()、gluBuild2Dmipmaps();
• 坐标转换和投影变换函数:定义投影方式函数 gluPerspective()、gluOrtho2D()、 gluLookAt(),拾取投影视景体函数 gluPickMatrix(),投影矩阵计算 gluProject()和 gluUnProject();
• 多边形镶嵌工具: gluNewTess()、gluDeleteTess()、gluTessCallback()、gluBeginPolygon()、 gluTessVertex()、gluNextContour()、gluEndPolygon();
• 二次曲面绘制工具,主要有绘制球面、锥面、柱面、圆环面 gluNewQuadric()、gluSphere()、 gluCylinder()、gluDisk()、gluPartialDisk()、gluDeleteQuadric();
• 非均匀有理 B样条绘制工具:主要用来定义和绘制 Nurbs曲线和曲面,包括 gluNewNurbsRenderer()、 gluNurbsCurve()、 gluBeginSurface()、 gluEndSurface()、 gluBeginCurve()、gluNurbsProperty();
• 错误反馈工具:获取出错信息的字符串 gluErrorString()。
3.OpenGL辅助库
包含有31个函数,函数名前缀为aux。这部分函数提供窗口管理、输入输出处理以及绘制一些简单三维物体。此函数由glaux.dll来负责解释执行。创建aux库是为了学习和编写OpenGL程序,它更像是一个用于测试创意的预备基础接管。Aux库在windows实现有很多错误,因此很容易导致频繁的崩溃。在跨平台的编程实例和演示中,aux很大程度上已经被glut库取代。OpenGL中的辅助库不能在所有的OpenGL平台上运行。
辅助库函数主要包括以下几类:
- 窗口初始化和退出函数:auxInitDisplayMode()和auxInitPosition();
- 窗口处理和时间输入函数:auxReshapeFunc()、auxKeyFunc()和auxMouseFunc();
- 颜色索引装入函数:auxSetOneColor();
- 三维物体绘制函数:包括了两种形式网状体和实心体,如绘制立方体auxWireCube()和 auxSolidCube()。这里以网状体为例,长方体auxWireBox()、环形圆纹面auxWireTorus()、圆柱auxWireCylinder()、二十面体auxWireIcosahedron()、八面体auxWireOctahedron()、四面体auxWireTetrahedron()、十二面体auxWireDodecahedron()、圆锥体auxWireCone()和茶壶auxWireTeapot();
-
背景过程管理函数:auxIdleFunc();
-
程序运行函数:auxMainLoop()。
4.OpenGL工具库 OpenGL Utility Toolkit
包含大约30多个函数,函数名前缀为glut。glut是不依赖于窗口平台的OpenGL工具包,由Mark KLilgrad在SGI编写(现在在Nvidia),目的是隐藏不同窗口平台API的复杂度。函数以glut开头,它们作为aux库功能更强的替代品,提供更为复杂的绘制功能,此函数由glut.dll来负责解释执行。由于glut中的窗口管理函数是不依赖于运行环境的,因此OpenGL中的工具库可以在X-Window, Windows NT, OS/2等系统下运行,特别适合于开发不需要复杂界面的OpenGL示例程序。对于有经验的程序员来说,一般先用glut理顺3D图形代码,然后再集成为完整的应用程序。
这部分函数主要包括:
-
窗口操作函数:窗口初始化、窗口大小、窗口位置函数等[glutInit()、glutInitDisplayMode()、glutInitWindowSize()、glutInitWindowPosition()];
-
回调函数:响应刷新消息、键盘消息、鼠标消息、定时器函数[GlutDisplayFunc()、glutPostRedisplay()、glutReshapeFunc()、glutTimerFunc()、glutKeyboardFunc()、glutMouseFunc()];
-
创建复杂的三维物体:这些和aux库的函数功能相同;
-
菜单函数:创建添加菜单的函数GlutCreateMenu()、glutSetMenu()、glutAddMenuEntry()、glutAddSubMenu()和glutAttachMenu();
-
程序运行函数:glutMainLoop()。
5.Windows专用库
针对windows平台的扩展,包含有16个函数,函数名前缀为wgl。这部分函数主要用于连接OpenGL和Windows ,以弥补OpenGL在文本方面的不足。 Windows专用库只能用于Windows环境中。
这类函数主要包括以下几类:
-
绘图上下文相关函数:wglCreateContext()、wglDeleteContext()、wglGetCurrentContent()、wglGetCurrentDC()、wglDeleteContent();
-
文字和文本处理函数:wglUseFontBitmaps()、wglUseFontOutlines();
-
覆盖层、地层和主平面层处理函数:wglCopyContext()、wglCreateLayerPlane()、wglDescribeLayerPlane()、wglReakizeLayerPlatte();
-
其他函数:wglShareLists()、wglGetProcAddress()。
6.Win32 API函数库
包含有6个函数,函数名无专用前缀,是win32扩展函数。这部分函数主要用于处理像素存储格式和双帧缓存;这6个函数将替换Windows GDI中原有的同样的函数。Win32API函数库只能用于Windows 95/98/NT环境中。
7.X窗口专用库
是针对Unix和Linux的扩展函数。包括渲染上下文、绘制图元、显示列表、纹理贴图等;
- 初始化:glXQueryExtension();
-
渲染上下文函数:glXCreateContext()、glXDestroyContext()、glXCopyContext()、glXMakeCurrent()、glXCreateGLXPixmap();
-
执行:glXWaitGL()、glXWaitX();
-
缓冲区和字体:glXSwapBuffers()、glXUseXFont()。
8.其他扩展库
这些函数可能是新的OpenGL函数,并没有在标准OpenGL库中实现,或者它们是用来扩展已存在的OpenGL函数的功能。和glu、glx和wgl一样,这些OpenGL扩展是由硬件厂商和厂商组织开发的。OpenGL扩展(OpenGL Extention)包含了大量的扩展API函数。
随着硬件的更新,硬件厂商首先向SGI申请登记新的扩展,编写规格说明书(specification)。然后按照说明书进行开发扩展程序。不同的OpenGL实现(OpenGL Implementation)支持的扩展可能不一样,只有随着某一扩展的推广与应用以及硬件技术的提高该扩展才会在所有的OpenGL实现中被给予支持,从而最终成为OpenGL标准库的一部分。扩展由SGI维护,在SGI网站上列出了目前公开的已注册的扩展及其官方说明书。扩展源由扩展函数的后缀来指明(或使用扩展常量后缀)。例如,后缀WIN表明一个符合Windows规范的扩展,EXT或ARB后缀表明该扩展由多个卖主定义。
下面给出 OpenGL官方规定的命名规则:
• ARB – OpenGL Architecture Review Board正式核准的扩展,往往由厂商开发的扩展发展而来,如果同时存在厂商开发的扩展和 ARB扩展,应该优先使用 ARB扩展;
• EXT–多家 OpenGL厂商同意支持的扩展;
• HP – Hewlett-Packard惠普;
• IBM – International Business Machines ;
• KTX – Kinetix, maker of 3D Studio Max;
• INTEL – Intel 公司;
• NV – NVIDIA公司;
• MESA – Brian Paul’s freeware portable OpenGL implementation;
• SGI – Silicon Graphics公司开发的扩展;
• SGIX – Silicon Graphics (experimental) 公司开发的实验性扩展;
• SUN – Sun Microsystems;
• WIN – Microsoft 。
由于 OpenGL扩展在针对不同平台和不同驱动, OpenGL不可能把所有的接口程序全部放到 gl.h、glx.h、wgl.h中,而是将这些函数头放在了 glext.h、glxext.h和 wglext.h中。这些扩展被看作时 OpenGL核心库规范的增加和修改。