一、初始化
void glutInit(int* argc,char** argv)
这个函数从main函数获取其两个参数。
void glutInitWindowSize(int width,int height);
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()加以引用。
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);
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为鼠标的按键,为以下定义的常量
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);
msecs是等待的时间
Func是注册的函数
value是指定的一个数值,用来传递到回调函数Func中
这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数.