OpenGL应用编程接口文档.doc

opengl1 opengl 特点1建模：opengl图形库除了提供基本的点、线、多边形的绘制函数外，还提供了复杂的三维物体（球、锥、多面体、茶壶等）以及复杂曲线和曲面绘制函数。2变换：opengl图形库的变换包括基本变换和投影变换。基本变换有平移、旋转、变比镜像四种变换，投影变换有平行投影（又称正射投影）和透视投影两种变换。其变换方法有利于减少算法的运行时间，提高三维图形的显示速度。3颜色模式设置：opengl颜色模式有两种，即rgba模式和颜色索引（color index）。4光照和材质设置：opengl光有辐射光（emitted light）、环境光（ambient light）、漫反射光（diffuse light）和镜面光（specular light）。材质是用光反射率来表示。场景（scene）中物体最终反映到人眼的颜色是光的红绿蓝分量与材质红绿蓝分量的反射率相乘后形成的颜色。5纹理映射（texture mapping）。利用opengl纹理映射功能可以十分逼真地表达物体表面细节。6位图显示和图象增强图象功能除了基本的拷贝和像素读写外，还提供融合（blending）、反走样（antialiasing）和雾（fog）的特殊图象效果处理。以上三条可使被仿真物更具真实感，增强图形显示的效果。7双缓存动画（double buffering）双缓存即前台缓存和后台缓存，简言之，后台缓存计算场景、生成画面，前台缓存显示后台缓存已画好的画面。此外，利用opengl还能实现深度暗示（depth cue）、运动模糊（motion blur）等特殊效果。从而实现了消隐算法。2 opengl 工作机制 如何在opengl中表示3d物体 opengl 的渲染流水线 opengl中函数的命名规则 2.1 opengl中3d物体的表示 在3d空间中，场景是物体或模型的集合。在3d图形渲染中，所有的物体都是由三角形构成的。这是因为一个三角形可以表示一个平面，而3d物体就是由一个或多个平面构成的。比如下图表示了一个非常复杂的3d地形，它们也不过是由许许多多三角形表示的。渲染后的地形面貌复杂的地形也是由三角形构成的 因此,在opengl中，我们只要指定一个或多个三角形，就可以表示任意3d物体。那么如何指定三角形呢？opengl提供三种指定三角形的方法：即单个三角形、三角条形和三角扇形。 指定单个三角形。这是最简单，最直接的方法。即调用特定的opengl函数，传入三个顶点坐标，指定一个三角形。如下图：传入三个顶点(v1,v2,v3)，指定一个三角形 三角条形。这种方式适合于同时绘制多个三角形，且这些三角形之间至少存在一条公共边。一个三角条形是在单个三角形的基础上，再指定一个或多个顶点。这些顶点按照次序同上一顶点一起构成一个新的三角形。下图演示了这种推进过程。指定三个顶点，确定第一个三角形指定第四个顶点，和上一三角形共享一边指定第5个顶点，继续推进 三角扇形。三角扇形中，所有顶点按照一个中心点成扇形排列。如下图，是一个以v1为中心点的三角扇形。 既然使用三角形就可以表示任何图形，为什么还要使用三角条形和三角扇形呢？这是因为在opengl渲染流水线中，对于每个顶点都要进行变换运算。而对于一些连接在一起的三角形组来说，使用三角条形或三角扇形就减少了顶点的数目，这意味着减少了对顶点的运算，因此提高了渲染速度。例如，上图中第三个三角扇形，该扇形描述了4个三角形。如果把这四个三角形都一一作为单个三角形传给opengl的话，我们需要3*4=12个顶点，而使用了三角扇形之后，我们只使用了6个顶点。这节约了一半的运算量！2.2 opengl 的渲染流水线 当我们把要绘制的三角形传给opengl之后，opengl还要做许多工作以完成3d空间到屏幕的投影。这一系列的过程被称为opengl的渲染流水线。一般地，opengl的渲染流程如下：2.2.1 视图变换 当一个场景确定之后,如果我们想移动某个物体,或者要实现场景内的漫游,就必须进行模型视图的变换。模型视图变换可以根据需要，移动或旋转一个或多个物体。例如，如果我们想在3d空间中沿着z轴向前走的话，只需要把所有物体向-z方向移动n个单位即可。如果我们要向左看，就应该把所有物体沿着y轴渲染向右旋转n个角度。下图演示了这个过程。2.2.2 背面隐藏 在一些封闭的3d物体中，朝着物体内部的面总是不可见的。对于这些永远不可见的平面，我们可以使用背面隐藏忽略对它的绘制以提高渲染速度。为了实现背面隐藏，我们在绘制三角形的时候必须注意三角形的绕法。一般的，opengl默认为逆时针缠绕的面是正面。如下图所示的三角形中，如果把顶点按照v1-v3-v2的顺序传给opengl，那么opengl就会认为这个三角形朝着屏幕的面是正面。 使用背面隐藏，就要求我们在把图形传给opengl的时候要始终遵守正面使用逆时针绕法的规定。要开启背面隐藏的功能，只需调用函数： glenable(gl_cull_face); 当然，我们也可以改变opengl的设置，决定是对物体的正面还是背面进行隐藏。调用如下函数： glcullface(gl_front); 来隐藏正面，也可调用 glcullface(gl_back); 来隐藏背面。2.2.3 光照渲染 如果你开启了光照渲染，并且为每个顶点指定了它的法线，在此过程中，opengl将根据顶点的法线和光源的位置及性质重新计算顶点的颜色。使用光照效果可以大大提高画面的真实性。2.2.4 剪裁 剪裁就是把那些不在视见空间，或者一半在可视空间中的物体剔除或剪裁，以保证不该出现在屏幕上的图形就不出现。2.2.5 投影 要把一个3d空间中的物体显示在屏幕上，就要进行投影。投影又有两种方式：平行投影和透视投影。在平行投影中，远处的物体和近处的物体是一样大的，这种投影主要运用在计算机辅助设计（cad）上，由于这种投影没有立体感，所以一般情况下使用透视投影。在透视投影中，远处的物体会变得较小，因此在透视投影中，可视空间是一个平头截体（或台体）。下图表明了投影变换的原理。2.2.6 视见空间变换 当3d空间中的图形经过投影成为2d图形之后，我们还要把图形缩放到窗口或屏幕上。这个过程被称为视见空间变换。对于一般的游戏来说，视见空间应该是整个屏幕或窗体。但是视见空间也可以是它的子集。2.2.7 光栅化 当2d图形的所有变换都完成之后，就要把它们栅格化以显示在屏幕上，或保存为bmp图片。栅格化其实是把变换得到的2d矢量图转化为位图的过程。2.2.8 绘制 在这一步中，将由windows gdi把光栅化的图形显示在屏幕上。2.3 opengl的命名规则 在opengl1.1库中，包含了大约300多个api函数。为了方便程序员记忆和使用，这些函数都按照一定的规则进行命名。例如，函数glvertex用于传入顶点数据，而glvertex又有glvertex2i, glvertex3f, glvertex2f, glvertex2d,glvertex3d等变种。它们各自有什么意义呢？ 在函数glvertex3i中，gl表示当前函数属于opengl库。当然，此前缀如果是glu，则表示是glu库（opengl辅助库）。2.4 opengl与特定的平台opengl被设计为只有输出的，所以它只提供渲染功能。核心api没有窗口系统、音频、打印、键盘/鼠标或其它输入设备的概念。虽然这一开始看起来像是一种限制，但它允许进行渲染的代码完全独立于他运行的操作系统，允许跨平台开发。然而，有些整合于原生窗口系统的东西需要允许和宿主系统交互。这通过下列附加api实现：* glx - x11（包括透明的网络）* wgl - microsoft windows * agl - apple macos另外，glut库能够以可移植的方式提供基本的窗口功能。2.5 window nt系统中的opengl使用1nt系统windows/system32/opengl32.dll存在2在头文件内加上： #include #include #include 3在集成环境中 project | settings | link | object/library module | opengl32.lib glu32.lib glaux.lib | ok4小例子（旋转的正方形）建立win32的普通工程，添入源代码如下：#include stdafx.h#include #include #include #include static glfloat spin = 0.0;static glfloat cx,cy;void callback renderscene() glclear(gl_color_buffer_bit); / 清除缓存 glpushmatrix(); / 当前矩阵压栈 gltranslated(cx,cy,0); / 移动视点 glrotatef(spin, 0.0, 0.0, 1.0); / 旋转视点 glcolor3f(1.0, 0.0, 0.0); / 设置颜色 glrectf(-25.0, -25.0, 25.0, 25.0); / 绘制矩形 glpopmatrix(); / 还原当前矩阵 glflush(); / 强制命令执行 auxswapbuffers(); / 交换缓存，输出显示void callback changesize(glsizei w, glsizei h) if (h = 0) h = 1; if (w = 0) w = 1; glviewport(0, 0, w, h); / 设置视图尺寸 cx = w/2; cy = h/2; glloadidentity(); if (w 360.0) spin -= 360.0; renderscene(); / 渲染输出void callback leftbtnclick(aux_eventrec *event) auxidlefunc(spindisplay); / 左键动画void callback rightbtnclick(aux_eventrec *event) auxidlefunc(null); / 右键停止动画int _tmain(int argc, _tchar* argv) auxinitdisplaymode(aux_single|aux_double); / 初始化显示模式 auxinitposition(100,100,250,250); / 初始化显示位置 auxinitwindow(_t(my first opengl program); / 初始输出化窗口 cx = 125; cy = 125; glclearcolor(0.0, 0.0, 0.0, 0.0); glshademodel(gl_flat); / 明暗处理设置 auxreshapefunc(changesize); / 设置尺寸变化处理函数 auxmousefunc(aux_leftbutton, aux_mousedown, leftbtnclick); / 设置鼠标左键处理函数 auxmousefunc(aux_rightbutton, aux_mousedown, rightbtnclick); / 设置鼠标右键处理函数 auxmainloop(renderscene); / 进入主循环 printf(press anykey to return!); getchar();return 0; opengl es1 opengl 特点和桌面windows的3d应用一样，移动设备也需要api的支持。在windows的发展进程中，有两种互相竞争的api存在，那就是directx和opengl。而移动设备自从推出以来一直采用的是opengl api的派生产物，也就是opengl es。opengl es 1.0基本上是opengl 1.3子集，opengl es 1.1基本上是opengl 1.5的子集，同时加入了一些扩展。这使得该api更加灵活，比如现在一些用不到的功能可以暂时删除，当内嵌硬件发展到一定水平后，相应的功能可以从新添加回来。目前的opengl es包含两方面基本内容，common profile: 这个profile在移动设备如电话或pda中完成； common-lite profile: 这个限制较多，规定了运行3d图形程序所需最少的功能。这个主要针对安全性要求高的设备，它们的可靠性成了最需要考虑的东西。opengl es具体特性如下：geometry processing - vertex arrays - points, lines, triangles - matrix stack - viewport, depthrange - vertex lighting - shademodelrasterization - multisampling (optional) - points & anti-aliased points - lines & anti-aliased lines - polygons - face culling - polygonoffset - fill modetexture mapping - 2d textures - wrap repeat, edge_clamp - compressed texture - texsubimage, copyteximage - multitexture - rgba pixel and packed pixel formats, l, la - all filtersfragment processing - fog - scissor test - alpha test - stencil test (optional) - depth test (optional) - blending - logic op - ditherframebuffer operations/miscellaneous - clear - readpixels / alpha test / dither - flush/finish - hint - get-static state (constants)2 opengl es与opengl的区别因为内嵌设备的限制，opengl es不能包括很多opengl的多余操作，如不能在opengl es使用一个表明几何形式的临时模式。因此，如下代码在opengl es是无效的： glbegin (gl_triangles); glvertex3f (0,1,0); glvertex3f (-1,0,0); glvertex3f (1,0,0);glend();opengl es从vertex数组中渲染所有的几何模型。因此如果要在opengl es中渲染一个三角形，需要如下代码：const glbyte kvertices =0,1,0,-1,0,0,1,0,0;glenableclientstate (gl_vertex_array);glvertexpointer (3, gl_byte , 0, kvertices);gldrawarrays (gl_triangles, 0, 3);和大多数没有fpu(浮点运算处理器)的设备一样，opengl es profile只定义了可以接收整型数值的函数。整型运算是将浮点数用整数表示的一种技巧。当我们使用整型数时，这个整数会被分成2个部分：一个用来存储真正的整数部分，而剩余的用来存储小数部分。opengl es工作在16:16的32位字节数上。它表明有16位是整数，而剩余的16位是小数。opengl es还引进了glfixed类型用来表示整型数。opengl es中不存在哪些有所有的相同作用的，但有不同的缩写（如glvertex3fsidv）的函数。但是有些如glcolor4fx还是存在的；opengl es只支持rgba颜色模式（你不需要选择）opengl es不绘制线框或点（只绘制实心填充）；无需询问opengl es 1.0中的动态属性（如当前颜色）；opengl es去除了double类型和所有double精度相关的命令，byte，ubyte，short，ushort也不支持，common profile支持float、int和fixed，common-lite profile仅支持int和fixed；opengl es profile分为特征和扩展，扩展分为核心扩展和一般扩展，一般扩展分为必须实现的扩展和可选的扩展。凡是扩展都必须用语法分开，以便移植；核心扩展也是必须实现的，但是方法名同gl，不需要添加扩展标记；一般扩展的方法名需要添加扩展标记；opengl es1.0的核心扩展有oes_byte_coordinates、 oes_fixed_point、 oes_single_precision三个，必须实现的扩展有oes_read_format、 oes_compressed_paletted_texture，可选实现的扩展有oes_query_matrix；opengl es1.1的核心扩展有oes_byte_coordinates、 oes_fixed_point、 oes_single_precision、 oes_matrix_get四个，必须实现的扩展有oes_read_format、 oes_compressed_paletted_texture、 oes_point_size_array、 oes_point_sprite，可选实现的扩展有oes_matrix_palette oes_draw_texture；（oes_query_matrix已经作为profile的元素了）3 opengl es 1.1的api3.1 图元3.1.7 gl_api void gl_apientry glpolygonoffset (glfloat factor, glfloat units);描述：设置用于计算深度值的比例和单位参数：factor：指定用于创建每个多边形深度变量的比例因子，初始值为0；units：用于乘以具体实现的值，初始值为0；3.1.7 gl_api void gl_apientry glpolygonoffsetx (glfixed factor, glfixed units);描述：设置用于计算深度值的比例和单位参数：factor：指定用于创建每个多边形深度变量的比例因子，初始值为0；units：用于乘以可以具体实现的最小值，初始值为0；3.2顶点数组3.1.7 gl_api void gl_apientry glenableclientstate (glenum array);描述：使能客户端具有指定的功能参数：array： 可以选择 gl_color_array, gl_matrix_index_array_oes, gl_normal_array, gl_point_size_array_array_oes, gl_texture_coord_array, gl_vertex_array, and gl_weight_array_oes中的一个；3.1.7 gl_api void gl_apientry gldisableclientstate (glenum array);描述：禁止客户端指定的功能参数：array： 同glenableclientstate各顶点数组设置3.1.1 gl_api void gl_apientry glvertexpointer (glint size, glenum type, glsizei stride, const glvoid *pointer);描述：指定一系列顶点，用于gldrawarrays 或 gldrawelements；参数：size：顶点的坐标数，必须是2，3 或 4中的一个，初始值为4；type：坐标数据类型，仅支持gl_byte，gl_short 和 gl_fixed，对于common profile还支持gl_float，初始值为gl_float；stride：数组内数据间的步长，单位为byte，初始值为0，0表示按照数据类型的大小；pointer：顶点数组的首指针，初始值为0；3.1.2 gl_api void gl_apientry glnormalpointer (glenum type, glsizei stride, const glvoid *pointer);描述：指定法线数组参数：type：法线数据类型，仅支持gl_byte，gl_short 和 gl_fixed，对于common profile还支持gl_float，初始值为gl_float；stride：数组内数据间的步长，单位为byte，初始值为0，0表示按照数据类型的大小；pointer：法线数组的首指针，初始值为0；3.1.3 gl_api void gl_apientry glcolorpointer (glenum type, glsizei stride, const glvoid *pointer);描述：指定颜色数组参数：type：法线数据类型，仅支持gl_byte，gl_short 和 gl_fixed，对于common profile还支持gl_float，初始值为gl_float；stride：数组内数据间的步长，单位为byte，初始值为0，0表示按照数据类型的大小；pointer：法线数组的首指针，初始值为0；3.1.4 gl_api void gl_apientry gltexcoordpointer (glint size, glenum type, glsizei stride, const glvoid *pointer);描述：指定纹理坐标数组参数：size：顶点的坐标数，必须是2，3 或 4中的一个，初始值为4；type：坐标数据类型，仅支持gl_byte，gl_short 和 gl_fixed，对于common profile还支持gl_float，初始值为gl_float；stride：数组内数据间的步长，单位为byte，初始值为0，0表示按照数据类型的大小；pointer：顶点数组的首指针，初始值为0；选择活动的纹理数组3.1.7 gl_api void gl_apientry glclientactivetexture (glenum texture);描述：选择活动纹理，用于gltexcoordpointer修改属性参数：texture：纹理，必须是 gl_texturei 的一个，即0到gl_max_texture_units；3.1.7 gl_api void gl_apientry gldrawarrays (glenum mode, glint first, glsizei count);描述：绘制顶点数组参数：mode：支持gl_points, gl_line_strip, gl_line_loop, gl_lines, gl_triangle_strip, gl_triangle_fan, and gl_triangles模式；first：数组中的起始点count：绘制的点数3.1.7 gl_api void gl_apientry gldrawelements (glenum mode, glsizei count, glenum type, const glvoid *indices);描述：绘制顶点数组（索引方式）参数：mode：支持gl_points, gl_line_strip, gl_line_loop, gl_lines, gl_triangle_strip, gl_triangle_fan, and gl_triangles模式；count：待渲染的顶点个数type：gl_unsigned_byte or gl_unsigned_shortindices：顶点索引3.3 对象缓存创建缓存3.1.7 gl_api void gl_apientry glbindbuffer(glenum target, gluint buffer);描述：将一个命名缓存绑定到目标上参数：target：目标；buffer：对象缓存名称；3.1.7 gl_api void gl_apientry gldeletebuffers(glsizei n, const gluint *buffers);描述： 删除命名对象缓存对象参数：n：指定删除的对象缓存的个数；buffers：对象缓存名称数组；3.1.7 gl_api void gl_apientry glgenbuffers(glsizei n, gluint *buffers);描述：产生对象缓存名称参数：n：指定产生多少个对象缓存；buffers：存储返回的对象缓存名称；缓存修改3.1.7 gl_api void gl_apientry glbufferdata(glenum target, glsizeiptr size, const glvoid *data, glenum usage);描述：创建和初始化对象缓存的数据参数：target：指定对象缓存目标，必须是gl_array_buffer or gl_element_array_buffer；size：指定数据的大小；data：指定客户端的数据源；usage：指定数据的应用模式，可以是gl_static_draw and gl_dynamic_draw；3.1.7 gl_api void gl_apientry glbuffersubdata(glenum target, glintptr offset, glsizeiptr size, const glvoid *data);描述：修改对象缓存中部分或所有的数据参数：target：指定对象缓存目标，必须是gl_array_buffer or gl_element_array_buffer；offset：指定要修改的数据偏移；size：指定要修改的数据大小；data：指定修改的数据；3.4 坐标转换矩阵操作3.1.7 gl_api void gl_apientry glmatrixmode (glenum mode);描述： 指定当前操作的矩阵，包括gl_modelview、gl_projection、gl_texture 和 gl_matrix_palette_oes参数：mode：gl_modelview、gl_projection、gl_texture 和 gl_matrix_palette_oes；3.1.7 gl_api void gl_apientry glpopmatrix (void);描述：从当前堆栈中弹出矩阵3.1.7 gl_api void gl_apientry glpushmatrix (void);描述：将当前矩阵压入当前堆栈，每个模式的矩阵均对应一个堆栈，gl_modelview的栈深至少16，其它的栈深至少2modalview 变换函数3.1.7 gl_api void gl_apientry gltranslatef (glfloat x, glfloat y, glfloat z);描述：沿着x，y，z方向分别平移（x，y，z），矩阵具有累积效应参数：x：x方向的平移y：y方向的平移z：z方向的平移3.1.7 gl_api void gl_apientry gltranslatex (glfixed x, glfixed y, glfixed z);描述：沿着x，y，z方向分别平移（x，y，z），本矩阵具有累积效应参数：x：x方向的平移y：y方向的平移z：z方向的平移3.1.7 glapi void apientry glrotatef (glfloat angle, glfloat x, glfloat y, glfloat z);描述：绕着一个从原点到（x，y，z）点的方向矢量旋转angle角度，本矩阵具有累积效应参数：angle：旋转角度；x：世界坐标系中指定点的x坐标；y：世界坐标系中指定点的y坐标；z：世界坐标系中指定点的z坐标；3.1.7 glapi void apientry glrotatex (glfixed angle, glfixed x, glfixed y, glfixed z);描述：绕着一个从原点到（x，y，z）点的方向矢量旋转angle角度，本矩阵具有累积效应参数：angle：旋转角度；x：世界坐标系中指定点的x坐标；y：世界坐标系中指定点的y坐标；z：世界坐标系中指定点的z坐标；3.1.7 gl_api void gl_apientry glscalef (glfloat x, glfloat y, glfloat z);描述：沿着x，y，z 轴分别按照比例系数进行缩放，本矩阵具有累积效应参数：x：x 轴的缩放比例；y：y 轴的缩放比例；z：z 轴的缩放比例；3.1.7 gl_api void gl_apientry glscalex (glfixed x, glfixed y, glfixed z);描述：沿着x，y，z 轴分别按照比例系数进行缩放，本矩阵具有累积效应参数：x：x 轴的缩放比例；y：y 轴的缩放比例；z：z 轴的缩放比例；gl_projection 变换函数3.1.7 gl_api void gl_apientry glorthof (glfloat left, glfloat right, glfloat bottom, glfloat top, glfloat znear, glfloat zfar);描述：指定裁剪体的形状和大小，正交投影变换（平行六面体），具有累积效应参数：left：二维窗口最左端right：二维窗口最右端bottom：二维窗口最底端top：二维窗口最上端znear：最大的z值（znear取正值）zfar：最小的z值（zfar取负值）3.1.7 gl_api void gl_apientry glorthox (glfixed left, glfixed right, glfixed bottom, glfixed top, glfixed znear, glfixed zfar);描述：指定裁剪体的形状和大小，正交投影变换（平行六面体），具有累积效应参数：left：二维窗口最左端right：二维窗口最右端bottom：二维窗口最底端top：二维窗口最上端znear：最大的z值（znear取正值）zfar：最小的z值（zfar取负值）3.1.7 gl_api void gl_apientry glfrustumf (glfloat left, glfloat right, glfloat bottom, glfloat top, glfloat znear, glfloat zfar);描述：指定裁剪体的形状和大小，透视投影变换，具有累积效应参数：left：二维窗口最左端right：二维窗口最右端bottom：二维窗口最底端top：二维窗口最上端znear：最大的z值（znear取正值）zfar：最小的z值（zfar取负值）3.1.7 gl_api void gl_apientry glfrustumx (glfixed left, glfixed right, glfixed bottom, glfixed top, glfixed znear, glfixed zfar);描述：指定裁剪体的形状和大小，透视投影变换，具有累积效应参数：left：二维窗口最左端right：二维窗口最右端bottom：二维窗口最底端top：二维窗口最上端znear：最大的z值（取正值，实际为负）zfar：最小的z值（取正值，实际为负）变换当前矩阵3.1.7 gl_api void gl_apientry glmultmatrixf (const glfloat *m);描述：当前矩阵相乘参数：m：指向16个连续的值（即4 x 4的矩阵）3.1.7 gl_api void gl_apientry glmultmatrixx (const glfixed *m);描述：当前矩阵相乘参数：m：指向16个连续的值（即4 x 4的矩阵）3.1.7 gl_api void gl_apientry glloadidentity (void);描述：复位当前矩阵3.1.7 gl_api void gl_apientry glloadmatrixf (const glfloat *m);描述：替换当前矩阵参数：指向16个连续的值（即4 x 4的矩阵）3.1.7 gl_api void gl_apientry glloadmatrixx (const glfixed *m);描述：替换当前矩阵参数：指向16个连续的值（即4 x 4的矩阵）指定视口3.1.7 gl_api void gl_apientry glviewport (glint x, glint y, glsizei width, glsizei height);描述：设定视口的位置和大小参数：x：视口的窗口坐标y：视口的窗口坐标width：宽height：高3.1.7 gl_api void gl_apientry gldepthrangef (glclampf znear, glclampf zfar);描述：指定窗口的深度裁剪（相对于窗口深度单位化后的）参数：znear：近端值（01），默认值为0；zfar：远端值（01），默认值为1；3.5 剪切3.1.7 gl_api void gl_apientry glclipplanex(glenum plane, const glfixed *equation);描述：设定裁剪平面参数：plane：可以是 gl_clip_planei中的一个，0igl_max_clip_planes；equation：平面方程的四个参数；3.1.7 gl_api void gl_apientry glclipplanef(glenum plane, const glfloat *equation);描述：设定裁剪平面参数：plane：可以是 gl_clip_planei中的一个，0igl_max_clip_planes；equation：平面方程的四个参数；3.1.7 gl_api void gl_apientry gldepthrangex (glclampx znear, glclampx zfar);描述：指定窗口的深度裁剪（相对于窗口深度单位化后的）参数：znear：近端值（01），默认值为0；zfar：远端值（01），默认值为1；3.6 着色与光照着色3.1.7 gl_api void gl_apientry glcolor4f (glfloat red, glfloat green, glfloat blue, glfloat alpha);描述：设置当前的颜色参数：red：红色分量（01）green：绿色分量（01）blue：蓝色分量（01）alpha：透明度分量（01）3.1.7 gl_api void gl_apientry glcolor4x (glfixed red, glfixed green, glfixed blue, glfixed alpha);描述：设置当前的颜色参数：red：红色分量（01）green：绿色分量（01）blue：蓝色分量（01）alpha：透明度分量（01）3.1.2 gl_api void gl_apientry glnormal3f (glfloat nx, glfloat ny, glfloat nz);描述：指定法线参数：nx：法线坐标的x坐标分量ny：法线坐标的y坐标分量nz：法线坐标的z坐标分量3.1.2 gl_api void gl_apientry glnormal3x (glfixed nx, glfixed ny, glfixed nz);描述：指定法线参数：nx：法线坐标的x坐标分量ny：法线坐标的y坐标分量nz：法线坐标的z坐标分量光源3.1.7 gl_api void gl_apientry gllightf (glenum light, glenum pname, glfloat param);描述：设置光源参数参数：light：可取gl_lighti，其中0igl_max_lights；pname：可以是gl_spot_exponent, gl_spot_cutoff, gl_constant_attenuation, gl_linear_attenuation, and gl_quadratic_attenuation中的一个；param： 用于设置光源pname参数的值3.1.7 gl_api void gl_apientry gllightfv (glenum light, glenum pname, const glfloat *params);描述：设置光源参数参数：light：可取gl_lighti，其中0igl_max_lights；pname：可以是gl_ambient, gl_diffuse, gl_specular, gl_emission, gl_spot_cutoff, gl_spot_direction, gl_spot_exponent, gl_constant_attenuation, gl_linear_attenuation, and gl_quadratic_attenuation中的一个；params： 指向用于设置光源pname参数的值3.1.7 gl_api void gl_apientry gllightx (glenum light, glenum pname, glfixed param);描述：设置光源参数参数：light：可取gl_lighti，其中0igl_max_lights；pname：可以是gl_spot_exponent, gl_spot_cutoff, gl_constant_attenuation, gl_linear_attenuation, and gl_quadratic_attenuation中的一个；param： 用于设置光源pname参数的值3.1.7 gl_api void gl_apientry gllightxv (glenum light, glenum pname, const glfixed *params);描述：设置光源参数参数：light：可取gl_lighti，其中0igl_max_lights；pnam