OPENGL函数说明

一、初始化

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

除去覆盖图。当没有覆盖图层时，调用这条语句也是安全的，这时系统不做任何事。

void glutPostOverlayRedisplay(void);

标记该覆盖图层为需要重新显示的状态。

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

显示当前窗口的覆盖图层；隐藏覆盖图层。这两条语句即时执行。注意一下，只有窗口可视时，使用glutShowOverlay才能使其覆盖图层可视。当窗口被其他窗口遮挡时，其覆盖图层也被遮挡从而不可视。

 

五、菜单管理

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

当点击菜单时,调用回调函数func，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为鼠标的按键,为以下定义的常量

GLUT_LEFT_BUTTON	鼠标左键
GLUT_MIDDLE_BUTTON	鼠标中键
GLUT_RIGHT_BUTTON	鼠标右键

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

GLUT_UP	鼠标释放
GLUT_DOWN	鼠标按下

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_NOT_VISIBLE	窗口完全不可见
GLUT_VISIBLE	窗口可见或部分可见

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

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

设置鼠标的进出窗口的回调函数

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

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

GLUT_LEFT	鼠标离开窗口
GLUT_RIGHT	鼠标进入窗口

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

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

设置当前窗口的特定键的回调函数

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

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

key常量	描述
GLUT_KEY_F1	F1功能键
GLUT_KEY_F2	F2功能键
GLUT_KEY_F3	F3功能键
GLUT_KEY_F4	F4功能键
GLUT_KEY_F5	F5功能键
GLUT_KEY_F6	F6功能键
GLUT_KEY_F7	F7功能键
GLUT_KEY_F8	F8功能键
GLUT_KEY_F9	F9功能键
GLUT_KEY_F10	F10功能键
GLUT_KEY_F11	F11功能键
GLUT_KEY_F12	F12功能键
GLUT_KEY_LEFT	左方向键
GLUT_KEY_UP	上方向键
GLUT_KEY_RIGHT	右方向键
GLUT_KEY_DOWN	下方向键
GLUT_KEY_PAGE_UP	PageUp键
GLUT_KEY_PAGE_DOWN	PageDown键
GLUT_KEY_HOME	Home键
GLUT_KEY_END	End键
GLUT_KEY_INSERT	Insert键

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

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

设置菜单状态回调函数

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

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

GLUT_MENU_IN_USE	菜单正在使用
GLUT_MENU_NOT_IN_USE	菜单未被使用

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表示当前是否使用菜单,为以下定义的常量

GLUT_MENU_IN_USE	菜单正在使用
GLUT_MENU_NOT_IN_USE	菜单未被使用

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

注册一个回调函数,当指定时间值到达后,由GLUT调用注册的函数一次

msecs是等待的时间

Func是注册的函数

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

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