首页 > 代码库 > glut库下的主要函数:

glut库下的主要函数:

 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才能使其覆盖图层可视。当窗口被其他窗口遮挡时,其覆盖图层也被遮挡从而不可视。 

 

二。事件处理(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才能使其覆盖图层可视。当窗口被其他窗口遮挡时,其覆盖图层

glut库下的主要函数: