【OpenGL】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让当前窗口成为一个图标，也即是最小化。

void glutSetWindowTitle(char* name);
void glutSetIconTitle(char* name);

 设置当前窗口（必须是顶层窗口）的标题和图标化时的标题。

void 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);

除