转自：http://blog.sina.com.cn/s/blog_5f0d72800100iajl.html

GLUT函数说明

一、初始化

void glutInit(int* argc,char** argv)

这个函数从 main 函数获取其两个参数。

1 void glutInitWindowSize(int width,int height);
2 void glutInitWindowPosition(int x,int y);

void glutInitDisplayMode(unsigned int 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);

返回值是生成窗口的标记符，可用函数glutGetWindow()加以引用。

void glutDestroyWindow(int win);

int glutCreateSubWindow(int win,int x,int y,int width,int height);

width,height是子窗口的宽和高。

void glutSetWindow(int win);
int  glutGetWindow(void);

void glutDestroyWindow(int win);

销毁以 win 标记的窗口。

void glutPostRedisplay(void);

void glutSwapBuffers(void);

而使用双缓存是为了把完整图画一次性显示在窗口上，或者是为了实现动画。

void glutPositionWindow(int x,int 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);

glutLayerGet(GLUT_OVERLAY_POSSIBLE);  // 可用以设置对于当前窗口，是否允许产生由初始化显示模式函数规定其模式的覆盖图层。
void glutUserLayer(GLenum layer);

void glutRemoveLayer(void);

void glutPostOverlayRedisplay(void);

void glutShowOverlay(void);
void glutHideOverlay(void);

五、菜单管理

int glutCreateMenu(void (*func)(int value))

这个函数创建一个新的弹出式菜单,并返回一个唯一的标识次菜单的整型标识符,并将新建的弹出菜单与func函数关联在一起,这样,当选择此菜单中的一个菜单条目时,调用回调函数func.

void glutSetMenu(int menu);
int glutGetMenu(void);

void glutDestroyMenu(int menu);

void glutAddMenuEntry(char* name, int value);

void glutAddSubMenu(char* name, int menu);

void glutChangeToMenuEntry(int entry, char* name, int value);
更改当前菜单中指定菜单项

void glutChangeToSubMenu(int entry, char* name, int menu);
将指定的当前菜单中菜单项变为子菜单触发条目

void glutRemoveMenuItem(int entry);

void glutAttachMenu(int button);
void glutDetachMenu(int button);

六、注册回调

void glutDisplayFunc(void (*func)(void) );

void glutOverlayDisplayFunc(void (*func)(void) );

void glutReshapeFunc(void (*Func)(int width, int height) );

void glutKeyboardFunc(void (*func) (unsigned char key, int x, int y) );

void glutMouseFunc(void (*func) (int button, int state, int x, int y));

func为注册的鼠标回调函数,这个函数完成鼠标事件的处理

button为鼠标的按键,为以下定义的常量：

 state为鼠标按键的动作,为以下定义的常量：

x,y为鼠标按下式,光标相对于窗口左上角的位置

void glutMotionFunc(void (*func)(int x, int y));
void glutPassiveMotionFunc(void (*func)(int x, int y));

Func为注册的鼠标移动函数

x,y为鼠标按下式,光标相对于窗口左上角的位置
当鼠标在窗口中按下并移动时调用glutMotionFunc注册的回调函数
当鼠标在窗口中移动时调用glutPassiveMotionFunc注册的回调函数

void glutVisibilityFunc(void (*func) (int state) );

Func为指定的可视回调函数

state表示窗口的可视性,为以下常量:

 这个函数设置当前窗口的可视回调函数,当窗口的可视性改变时,该窗口的可视回调函数被调用.只要窗口中的任何一个像素是可见的,或者他的任意一个子窗口中任意一个像素是可见的,GLUT则认为窗口是可见的.

void glutEntryFunc(void (*func) (int state));

Func为注册的鼠标进出回调函数

state为鼠标的进出状态,为以下常量之一:

 当窗口取得焦点或失去焦点时调用这个函数,当鼠标进入窗口区域并点击时,state为GLUT_RIGHT,当鼠标离开窗口区域点击其他窗口时,state为GLUT_LEFT.

void glutSpecialFunc(void (*func) (int key, int x, int y))

Func为注册的特定键的回调函数

key为按下的特定键,为以下定义的常量：

 x,y为当按下键时鼠标的坐标,相对于窗口左上角,以像素为单位
注意:ESC,回车和delete键由ASCII码产生.

void glutMenuStatusFunc(void (*func) (int status, int x, int y));

func是注册的菜单状态回调函数

status是当前是否使用菜单,为以下定义的常量：

 x,y是鼠标按下式,光标相对于窗口左上角的位置

这个函数时glut程序判定是否正在使用菜单,当弹出菜单时,调用注册的菜单状态回调函数,同时status设置为常量GLUT_MENU_IN_USE, 当菜单使用完毕时,也调用菜单状态回调函数,此时status变量变为GLUT_MENU_NOT_IN_USE.从已弹出的菜单中再弹出的菜单不产生菜单状态回调过程.每个glut程序只有一个菜单状态回调函数.

glutSpaceballRotateFunc

glutSpaceballButtonFunc

glutButtonBoxFunc

glutDialsFunc

glutTabletMotionFunc

glutTabletButtonFunc

void glutMenuStatusFunc(void (*func) (int status, int x, int y));

设置菜单状态回调函数

func为注册的菜单状态回调函数

status表示当前是否使用菜单,为以下定义的常量：

x,y表示鼠标按下式,光标相对于窗口左上角的位置

这个函数时glut程序判定是否正在使用菜单,当弹出菜单时,调用注册的菜单状态回调函数,同时status设置为常量GLUT_MENU_IN_USE, 当菜单使用完毕时,也调用菜单状态回调函数,此时status变量变为GLUT_MENU_NOT_IN_USE.从已弹出的菜单中再弹出的菜单不产生菜单状态回调过程.每个glut程序只有一个菜单状态回调函数.

void glutIdleFunc(void (*func) (void));

func表示当系统空闲时调用的函数,它的形式为void func(void)

void glutTimerFunc(unsigned int msecs, void (*Func)(int value), int value);

msecs是等待的时间

Func是注册的函数

value是指定的一个数值,用来传递到回调函数Func中

这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数。

七、色彩管理(未完成)

glutSetColor

glutGetColor

glutCopyColormap

八、状态检索

int glutGet(GLenum state);

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,否则返回0
GLUT_WINDOW_RGBA              如果窗口是RGBA模式,返回1,否则返回0
GLUT_WINDOW_PARENT            查询当前窗口的父窗口个数,如果为顶层窗口返回0
GLUT_WINDOW_NUM_CHILDREN      查询当前窗口的子窗口个数
GLUT_WINDOW_NUM_SAMPLES       查询多重采样的采样点个数
GLUT_WINDOW_STEREO            查询是否使用立体模式,是则返回1,否则返回0
GLUT_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表示查询的重叠层状态常量：

 int glutDeviceGet(GLenum info);

 返回值0表示检索的设备不存在,非0表示设备可用

int glutGetModifiers(void);

返回值为以下定义的常量：

int glutExtensionSupported(char* extension);

九、实体绘制

以下所有函数中，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); 实心茶壶