开发基于 OpenGL 的应用程序,必须先了解 OpenGL 的库函数。它采用 C 语言风格,提供大量的函数来进行图形的处理和显示。OpenGL 库函数的命名方式非常有规律。所有 OpenGL 函数采用了以下格式:
. <库前缀><根命令><可选的参数个数><可选的参数类型>
库前缀有 gl、glu、aux、glut、wgl、glx、agl 等等,分别表示该函数属于openGL 的哪个开发库,从函数名后面中还可以看出需要多少个参数以及参数的类型。I 代表 int 型,f 代表 float 型,d 代表 double 型,u 代表无符号整型。
例如:
glVertex3fv()
表示了该函数属于 gl 库,参数是三个 float 型参数指针。我们用glVertex*()来表示这一类函数。
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 中的工具库可以在 XWindow,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 扩展(OpenGLExtention)包含了大量的扩展 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 核心库规范的增加和修改。
9.OpenGl 核心函数库
glAccum
操作累加缓冲区
glAddSwapHintRectWIN
定义一组被 SwapBuffers 拷贝的三角形
glAlphaFunc
允许设置 alpha 检测功能
glAreTexturesResident
决定特定的纹理对象是否常驻在纹理内存中
glArrayElement
定义一个被用于顶点渲染的数组成分
glBegin、glEnd
定义一个或一组原始的顶点
glBindTexture
允许建立一个绑定到目标纹理的有名称的纹理
glBitmap
绘制一个位图
glBlendFunc
特殊的像素算法
glCallList
执行一个显示列表
glCallLists
执行一列显示列表
glClear
用当前值清除缓冲区
GlClearAccum
为累加缓冲区指定用于清除的值
glClearColor
为色彩缓冲区指定用于清除的值
glClearDepth
为深度缓冲区指定用于清除的值
glClearStencil
为模板缓冲区指定用于清除的值
glClipPlane
定义被裁剪的一个平面几何体
glColor
设置当前色彩
glColorMask
允许或不允许写色彩组件帧缓冲区
glColorMaterial
使一个材质色彩指向当前的色彩
glColorPointer
定义一列色彩
glColorTableEXT
定义目的一个调色板纹理的调色板的格式和尺寸
glColorSubTableEXT
定义目的纹理的调色板的一部分被替换
glCopyPixels
拷贝帧缓冲区里的像素
glCopyTexImage1D
将像素从帧缓冲区拷贝到一个单空间纹理图象中
glCopyTexImage2D
将像素从帧缓冲区拷贝到一个双空间纹理图象中
glCopyTexSubImage1D
从帧缓冲区拷贝一个单空间纹理的子图象
glCopyTexSubImage2D
从帧缓冲区拷贝一个双空间纹理的子图象
glCullFace
定义前面或后面是否能被精选
glDeleteLists
删除相邻一组显示列表
glDeleteTextures
删除命名的纹理
glDepthFunc
定义用于深度缓冲区对照的数据
glDepthMask
允许或不允许写入深度缓冲区
glDepthRange
定义 z 值从标准的设备坐标映射到窗口坐标
glDrawArrays
定义渲染多个图元
glDrawBuffer
定义选择哪个色彩缓冲区被绘制
glDrawElements
渲染数组数据中的图元
glDrawPixels
将一组像素写入帧缓冲区
glEdgeFlag
定义一个边缘标志数组
glEdgeFlagPointer
定义一个边缘标志数组
glEnable、glDisable
打开或关闭 OpenGL 的特殊功能
glEnableClientState、glDisableClientState
分别打开或关闭数组
glEvalCoord
求解一维和二维贴图
glEvalMesh1、glEvalMesh2
求解一维和二维点或线的网格
glEvalPoint1、glEvalPoint2
生成及求解一个网格中的单点
glFeedbackBuffer
控制反馈模式
glFinish
等待直到 OpenGL 执行结束
glFlush
在有限的时间里强制 OpenGL 的执行
glFogf、glFogi、glFogfv、glFogiv
定义雾参数
glFrontFace
定义多边形的前面和背面
glFrustum
当前矩阵乘上透视矩阵
glGenLists
生成一组空的连续的显示列表
glGenTextures
生成纹理名称
glGetBooleanv、glGetDoublev、glGetFloatv、glGetIntegerv
返回值或所选参数值
glGetClipPlane
返回特定裁减面的系数
glGetColorTableEXT
从当前目标纹理调色板得到颜色表数据
glGetColorTableParameterfvEXT、glGetColorTableParameterivEXT
从颜色表中得到调色板参数
glGetError
返回错误消息
glGetLightfv、glGetLightiv
返回光源参数值
glGetMapdv、glGetMapfv、glGetMapiv
返回求值程序参数
glGetMaterialfv、glGetMaterialiv
返回材质参数
glGetPixelMapfv、glGetpixelMapuiv、glGetpixelMapusv
返回特定的像素图
glGetPointerv
返回顶点数据数组的地址
glGetPolygonStipple
返回多边形的点图案
glGetString
返回描述当前 OpenGl 连接的字符串
glGetTexEnvfv
返回纹理环境参数
glGetTexGendv、glGetTexGenfv、glGetTexGeniv
返回纹理坐标生成参数
glGetTexImage
返回一个纹理图象
glGetTexLevelParameterfv、glGetTexLevelParameteriv
返回特定的纹理参数的细节级别
glGetTexParameterfv、glGetTexParameteriv
返回纹理参数值
glHint
定义实现特殊的线索
glIndex
建立当前的色彩索引
glIndexMask
控制写色彩索引缓冲区里的单独位
GlIndexPointer
定义一个颜色索引数组
glInitName
初始化名字堆栈
glInterleavedArrays
同时定义和允许几个在一个大的数组集合里的交替数组
glIsEnabled
定义性能是否被允许
glIsList
检测显示列表的存在
glIsTexture
确定一个名字对应一个纹理
glLightf、glLighti、glLightfv、glLightiv
设置光源参数
glLightModelf、glLightModeli、glLightModelfv、glLightModeliv
设置光线模型参数
glLineStipple
设定线点绘图案
glLineWidth
设定光栅线段的宽
glListBase
为 glcallList 设定显示列表的基础
glLoadIdentity
用恒等矩阵替换当前矩阵
glLoadMatrixd,glLoadMatrif
用一个任意矩阵替换当前矩阵
glLoadName
将一个名字调入名字堆栈
glLogicOp
为色彩索引渲染定义一个逻辑像素操作
glMap1d,glMap1f
定义一个一维求值程序
glMap2d,glMap2f
定义一个二维求值程序
glMapGrid1d,glMapGrid1f,glMapgrid2d,glMapGrid2f
定义一个一维或二维网格
glMaterialf,glMateriali,glMateriafv,glMaterialiv
为光照模型定义材质参数
glMatrixMode
定义哪一个矩阵是当前矩阵
glMultMatrixd,glMultMatrixf
用当前矩阵与任意矩阵相乘
glNewList,glEndList
创建或替换一个显示列表
glNormal
设定当前顶点法向
glNormalPointer
设定一个法向数组
glOrtho
用垂直矩阵与当前矩阵相乘
glPassThrough
在反馈缓冲区做记号
glPixelMapfv,glPixelMapuiv,glPixelMapusv
设定像素交换图
glPixelStoref,glpixelStorei
设定像素存储模式
glPixelTransferf,glPixelTransferi
设定像素存储模式
glPixelZoom
设定像素缩放因数
glPointSize
设定光栅点的直径
glPolygonMode
选择一个多边形的光栅模式
glPolygonOffset
设定 OpenGL 用于计算深度值的比例和单元
glPolygonStipple
设定多边形填充图案
glPrioritizeTextures
设定纹理固定的优先级
glPushAttrib,glPopAttrib
属性堆栈的压入和弹出操作
glPushClientAttrib,glPopClientAttrib
在客户属性堆栈存储和恢复客户状态值
glPushmatrix,glPopMatrix
矩阵堆栈的压入和弹出操作
glPushName,glPopName
名字堆栈的压入和弹出操作
glRasterPos
定义像素操作的光栅位置
glreadBuffer
为像素选择一个源色彩缓冲区
glReadPixels
从帧缓冲区读取一组数据
glRectd,glRectf,glRecti,glRects,glRectdv,glRectfv,glRectiv,glRectsv
绘制一个三角形
glRenderMode
定义光栅模式
glRotated,glRotatef
将旋转矩阵与当前矩阵相乘
glScaled,glScalef
将一般的比例矩阵与当前矩阵相乘
glScissor
定义裁减框
glSelectBuffer
为选择模式值建立一个缓冲区
glShadeModel
选择平直或平滑着色
glStencilFunc
为模板测试设置功能和参照值
glStencilMask
控制在模板面写单独的位
glStencilOp
设置激活模式测试
glTexCoord
设置当前纹理坐标
glTexCoordPointer
定义一个纹理坐标数组
glTexEnvf,glTexEnvi,glTexEnvfv,glTexEnviv
设定纹理坐标环境参数
glTexGend,glTexgenf,glTexGendv,glTexGenfv,glTexGeniv
控制纹理坐标的生成
glTexImage1D
定义一个一维的纹理图象
glTexImage2D
定义一个二维的纹理图
glTexParameterf,glTexParameteri,glTexParameterfv,glTexParameteriv
设置纹理参数
glTexSubImage1D
定义一个存在的一维纹理图像的一部分,但不能定义新的纹理
glTexSubImage2D
定义一个存在的二维纹理图像的一部分,但不能定义新的纹理
glTranslated,glTranslatef
将变换矩阵与当前矩阵相乘
glVertex
定义一个顶点
glVertexPointer
设定一个顶点数据数组
glViewport
设置视窗
10 . OpenGL 应用函数库
gluBeginCurve,gluEndCurve
定义一条不一至的有理的 NURBS 曲线
gluBeginPolygon,gluEndPolygon
定义一个非凸多边形
gluBeginSurface,gluEndSurface
定义一个 NURBS 曲线
gluBeginTrim,gluEndTrim
定义一个 NURBS 整理循环
gluBuild1Dmipmaps
建立一维多重映射
gluBuild2Dmipmaps
建立二维多重映射
gluCylinder
绘制一个圆柱
gluDeleteNurbsRenderer
删除一个 NURBS 对象
gluDeleQuadric
删除一个二次曲面对象
gluDeleteTess
删除一个镶嵌对象
gluDisk
绘制一个盘子
gluErrorString
根据 OpenGL 或 GLU 错误代码产生错误字符串
gluGetNutbsProperty
得到一个 NURBS 属性
gluGetString
得到一个描述 GLU 版本号或支持 GLU 扩展调用的字符串
gluGetTessProperty
得到一个镶嵌对象
gluLoadSamplingMatrices
加载 NUMRBS 例子和精选矩阵
gluLookAt
设定一个变换视点
gluNewNurbsRenderer
创建一个 NURBS 对象
gluNewQuadric
建立一个二次曲面对象
gluNewTess
建立一个镶嵌对象
gluNextContour
为其他轮廓的开始做标记
gluNurbsCallback
为 NURBS 对象设定一个回调
gluNnrbsCurve
设定一个 NuRBS 曲线的形状
gluNurbsProperty
设定一个 NURBS 属性
gluNurbsSurface
定义一个 NURBS 表面的形状
gluOrtho2D
定义一个二位正交投影矩阵
gluPartialDisk
绘制一个盘子的弧
gluPerspective
设置一个透视投影矩阵
gluPickMatrix
定义一个拾取区间
gluProject
将对象坐标映射为窗口坐标
gluPwlCurve
描述一个分段线性 NURBS 修剪曲线
gluQuadricCallback
为二次曲面对象定义一个回调
gluQuadricDrawStyle
为二次曲面设定合适的绘制风格
gluQuadricNormals
定义二次曲面所用的法向的种类
gluQuadricOrientation
定义二次曲面内部或外部方向
gluQuadricTexture
定义是否带二次其面做纹理帖图
gluScaleImage
将图象变换为任意尺寸
gluSphere
绘制一个球体
gluTessBeginContour,gluTessEndContour
划定一个边界描述
gluTessBeginPolygon,gluTessEndPolygon
划定一个多边形描述
gluTessCallback
为镶嵌对象定义一个回调
gluTessNormal
为一个多边行形定义法向
gluTessProperty
设置镶嵌对象的属性
gluTessVertex
定义在一个多边形上的顶点
gluUnProject
将窗口坐标映射为对象坐标