opengl........

opengl........
2010年06月30日
　　glut常用的函数
　　一．初始化
　　void glutInit(int* argc, char** argv)
　　这个函数用来初始化GLUT库。对应main函数的形式应是：int main(int argc, char* argv[]);
　　这个函数从main函数获取其两个参数。
　　void glutInitWindowSize(int width, int height);
　　void glutInitWindowPosition(int x, int y);
　　这两个函数很好理解是设置glut程序要产生的窗口的大小和位置（左上角）。以像素为单位。
　　void glutInitDisplayMode(unsigned int mode);
　　设置图形显示模式。参数mode的可选值为：
　　GLUT_RGBA：当未指明GLUT_RGBA或GLUT_INDEX时，是默认使用的模式。表明欲建立RGBA模式的窗口。
　　GLUT_RGB：与GLUT-RGBA作用相同。
　　GLUT_INDEX：指明为颜色索引模式。
　　GLUT_SINGLE：只使用单缓存
　　GLUT_DOUBLE：使用双缓存。以避免把计算机作图的过程都表现出来，或者为了平滑地实现动画。
　　GLUT_ACCUM：让窗口使用累加的缓存。
　　GLUT_ALPHA：让颜色缓冲区使用alpha组件。
　　GLUT_DEPTH：使用深度缓存。
　　GLUT_STENCIL：使用模板缓存。
　　GLUT_MULTISAMPLE：让窗口支持多例程。
　　GLUT_STEREO：使窗口支持立体。
　　GLUT_LUMINACE:luminance是亮度的意思。但是很遗憾，在多数OpenGL平台上，不被支持。
　　二．事件处理（Event Processing）
　　void   glutMainLoop(void)
　　让glut程序进入事件循环。在一个glut程序中最多只能调用一次。一旦调用，会直到程序结束才返回。
　　三．窗口管理（Window Management）
　　int glutCreateWindow(char* name);
　　产生一个顶层的窗口。name 作为窗口的名字，也就是窗口标题栏显示的内容。
　　返回值是生成窗口的标记符，可用函数glutGetWindow()加以引用。
　　int glutCreateSubWindow(int win, int x, int y, int width, int height);
　　创建一个子窗口。win是其父窗口的标记符。x, y是相对父窗口的位移，以像素表示。
　　width,height是子窗口的宽和高。
　　void glutSetWindow(int win);
　　int glutGetWindow(void);
　　功能分别是：设置标记符为win的窗口为当前窗口；返回当前窗口的标记符。
　　void glutDestroyWindow(int win);
　　销毁以win标记的窗口。
　　void glutPostRedisplay(void);
　　将当前窗口打上标记，标记其需要再次显示。
　　void glutSwapBuffers(void);
　　当窗口模式为双缓存时，此函数的功能就是把后台缓存的内容交换到前台显示。当然，只有单缓存时，使用它的功能跟用glFlush()一样。
　　而使用双缓存是为了把完整图画一次性显示在窗口上，或者是为了实现动画。
　　void glutPositionWindow(int x, int y);
　　改变当前窗口的位置：当前窗口是顶层窗口时，x, y是相对于屏幕的的位移；当前窗口若是子窗口时，x, y是相对其父窗口原点的位移。
　　void glutReshapeWindow(int width, int height);
　　改变当前窗口的大小。
　　width,height是当前窗口新的宽度和高度值，当然只能是正值。
　　void glutFullscreen(void);
　　让当前窗口全屏显示。当前窗口是顶层窗口时才有效。
　　void glutPopWindow(void);
　　void glutPushWindow(void);
　　对顶层窗口和子窗口均有效。改变当前窗口在栈中相对于其它窗口的次序。
　　void glutShowWindow(void);
　　void glutHideWindow(void);
　　void glutIconifyWindow(void);
　　这三个函数作用是改变当前窗口的显示状态。
　　glutShowWindow让当前窗口可视（这时它还是可能被其它窗口挡住）。
　　glutHideWindow让当前窗口成为不可视状态。
　　glutIconifyWindow让当前窗口成为一个图标，也即是最小化。
　　glutSetWindowTitle(char* name);
　　glutSetIconTitle(char* name);
　　设置当前窗口（必须是顶层窗口）的标题和图标化时的标题。
　　glutSetCursor(int cursor);
　　设置当前窗口的光标样式。
　　cursor可选值有许多：如GLUT_CURSOR_RIGHT_ARROW指向右边的光标，GLUT_CURSOR_LEFT_ARROW指向左边的光标，GLUT_CURSOR_INFO成为手状。
　　GLUT_CURSOR_DESTROY呈叉状，GLUT_CURSOR_HELP呈现问号的形状。
　　等等。
　　四．窗口的覆盖管理
　　void glutEstablishOverlay(void);
　　对当前窗口创建覆盖图层。该覆盖图的模式由初始化显示模式函数glutDisplayMode()决定。glutLayerGet(GLUT_OVERLAY_POSSIBLE)可用以设置对于当前窗口，是否允许产生由初始化显示模式函数规定其模式的覆盖图层。
　　void glutUserLayer(GLenum layer);
　　枚举量layer可选值为：GLUT_NORMAL,GLUT_OVERLAY.分别选取正常位平面或覆盖平面。
　　void glutRemoveLayer(void);
　　除去覆盖图。当没有覆盖图层时，调用这条语句也是安全的，这时系统不做任何事。
　　void glutPostOverlayRedisplay(void);
　　标记该覆盖图层为需要重新显示的状态。
　　void glutShowOverlay(void);
　　void glutHideOverlay(void);
　　显示当前窗口的覆盖图层；隐藏覆盖图层。这两条语句即时执行。注意一下，只有窗口可视时，使用glutShowOverlay才能使其覆盖图层可视。当窗口被其他窗口遮挡时，其覆盖图层也被遮挡从而不可视。
　　int glutGet(GLenum state); 检索指定的GLUT状态 state为指定要检索的状态类型,为以下常量 state常量描述GLUT_WINDOW_X当前窗口的x坐标,以像素为单位GLUT_WINDOW_Y当前窗口的y坐标,以像素为单位GLUT_WINDOW_WIDTH当其窗口的宽度,以像素为单位GLUT_WINDOW_HEIGHT当前窗口的高度,以像素为单位GLUT_WINDOW_BUFFER_SIZE当前窗口中,颜色分量占用的位数,即用多少bit表示颜色分量GLUT_WINDOW_STENCIL_SIZE当前窗口中,蒙板分量占用的位数,即用多少bit表示蒙板分量GLUT_WINDOW_DEPTH_SIZE当前窗口中,深度分量占用的位数,即用多少bit表示深度分量GLUT_WINDOW_RED_SIZE当前窗口中,红色分量占用的位数,即用多少bit表示红色分量GLUT_WINDOW_GREEN_SIZE当前窗口中,绿色分量占用的位数,即用多少bit表示绿色分量GLUT_WINDOW_BLUE_SIZE当前窗口中,蓝色分量占用的位数,即用多少bit表示蓝色分量GLUT_WINDOW_ALPHA_SIZE当前窗口中,alpha色分量占用的位数,即用多少bit表示alpha色分量GLUT_WINDOW_ACCUM_RED_SIZE当前窗口累积缓存中,红色分量占用的位数,即用多少bit表示红色分量GLUT_WINDOW_ACCUM_GREEN_SIZE当前窗口累积缓存中,绿色分量占用的位数,即用多少bit表示绿色分量GLUT_WINDOW_ACCUM_BLUE_SIZE当前窗口累积缓存中,蓝色分量占用的位数,即用多少bit表示蓝色分量GLUT_WINDOW_ACCUM_ALPHA_SIZE当前窗口累积缓存中,alpha色分量占用的位数,即用多少bit表示alpha色分量GLUT_WINDOW_DOUBLEBUFFER如果窗口式双缓存模式,返回1,否则返回0GLUT_WINDOW_RGBA如果窗口是RGBA模式,返回1,否则返回0GLUT_WINDOW_PARENT查询当前窗口的父窗口个数,如果为顶层窗口返回0GLUT_WINDOW_NUM_CHILDREN查询当前窗口的子窗口个数GLUT_WINDOW_NUM_SAMPLES查询多重采样的采样点个数GLUT_WINDOW_STEREO查询是否使用立体模式,是则返回1,否则返回0GLUT_WINDOW_CURSOR返回光标的整数标示GLUT_SCREEN_HEIGHT屏幕的高度,以像素为单位GLUT_SCREEN_WIDTH屏幕的宽度,以像素为单位GLUT_SCREEN_WIDTH_MM屏幕的宽度,以毫米为单位GLUT_SCREEN_HEIGHT_MM屏幕的高度,以毫米为单位GLUT_MENU_NUM_ITEMS查询当前菜单包含的菜单项的个数GLUT_DISPLAY_MODE_POSSIBLE查询窗口系统是否支持当前的显示模式,1表示支持,0表示不支持GLUT_INIT_DISPLAY_MODE初始窗口的显示模式GLUT_INIT_WINDOW_X初始窗口的x坐标GLUT_INIT_WINDOW_Y初始窗口的y坐标GLUT_INIT_WINDOW_WIDTH初始窗口的宽度GLUT_INIT_WINDOW_HEIGHT初始窗口的高度GLUT_ELAPSED_TIME返回两次调用glutGet(GLUT_ELAPSED_TIME)的时间间隔,单位为毫秒
　　返回值根据查询的内容返回相应的值,无效的状态名返回-1.
　　int glutLayerGet(GLenum info);查询属于当前窗口的重叠层的状态 Info表示查询的重叠层状态常量 GLUT_OVERLAY_POSSIBLE在给定的初始显示模式下,能否为当前窗口创建重叠层.如果能,返回1;如果不能,返回0GLUT_LAYER_IN_USE返回当前的使用层,为GLUT_NORMAL或GLUT_OVERLAYGLUT_HAS_OVERLAY判断当前窗口是否创建了重叠层GLUT_NORMAL_DAMAGED如果当前窗口的图像层在上一次显示回调函数调用后已经破坏,则返回TRUEGLUT_OVERLAY_DAMAGED如果当前窗口的重叠层在上一次显示回调函数调用后已经破坏,则返回TRUE
　　int glutDeviceGet(GLenum info);检索设备信息 info为要检索的设备信息的名字,为以下常量 GLUT_HAS_KEYBOARD如果键盘可用,返回非0值,否则,返回0GLUT_HAS_MOUSE如果鼠标可用,返回非0值,否则,返回0GLUT_NUM_MOUSE_BUTTONS返回鼠标支持的按键数,如果鼠标不可用,返回0返回值0表示检索的设备不存在,非0表示设备可用
　　int glutGetModifiers(void);返回组合功能键的状态 返回值为以下定义的常量 GLUT_ACTIVE_SHIFT当按下shift键时GLUT_ACTIVE_CTRL当按下ctrl键时GLUT_ACTIVE_ALT当按下alt键时
　　十、实体绘制 以下所有函数中，radius表示球体的半径，slices表示球体围绕z轴分割的数目，stacks表示球体沿着z轴分割的数目。 绘制中心在模型坐标原点,半径为radius的球体,球体围绕z轴分割slices次,球体沿着z轴分割stacks次
　　void glutWireSphere(GLdouble radius, GLint slices, GLint stacks); 线框球
　　void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); 实心球void glutWireCube(GLdouble size); 线框立方体
　　void glutSolidCube(GLdouble size); 实心立方体void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 线框圆环
　　void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 实心圆环void glutWireIcosahedron(void); 线框20面体
　　void glutSolidIcosahedron(void); 实心20面体void glutWireOctahedron(void); 线框8面体
　　void glutSolidOctahedron(void); 实心8面体void glutWireTetrahedron(void); 线框4面体
　　void glutSolidTetrahedron(void); 实心4面体void glutWireDodecahedron(GLdouble radius); 线框12面体
　　void glutSolidDodecahedron(GLdouble radius); 实心12面体void glutWireCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 线框圆锥体
　　void glutSolidCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 实心圆锥体void glutWireTeapot(GLdouble size); 线框茶壶
　　void glutSolidTeapot(GLdouble size); 实心茶壶