glut
库下的主要函数
一 、初始化
1
、
void glutInit(int* argc,char** argv)
这个函数用来初始化
GLUT
库。对应
main
函数的形式应是:
int main(int argc,char* argv[]);
这个函数从
main
函数获取其两个参数。
2
、
void glutInitWindowSize(int width,int height);
void glutInitWindowPosition(int x,int y);
这两个函数很好理解是设置
glut
程序要产生的窗口的大小和位置(左上角)。以像素为单位。
3
、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)
1
、void glutMainLoop(void)
让glut程序进入事件循环。在一个glut程序中最多只能调用一次。一旦调用,会直到程序结束才返回。
2
、glutReshapeFunc(void (GLUTCALLBACK *func)(int width, int height))
注册当前窗口的形状变化回调函数。当改变窗口大小时,该窗口的形状改变回调函数将被调用。
3
、
glutDisplayFunc(
void (GLUTCALLBACK *func)(void)
)
注册当前窗口的显示回调函数,当一个窗口的图像层需要重新绘制时,
GLUT
将调用该窗口的的显示回调函数。显示回调函数不带任何参数,它负责整个图像层的绘制。我们的大部分工作将集中在这个函数中。
4
、
glutMouseFunc(
void (GLUTCALLBACK *func)(int button, int state, int x, int y)
)
设置鼠标器按键回调函数,当鼠标的左键、右键或中键被按下时触发被注册的函数执行。
5
、
glutMotionFunc
(
void (GLUTCALLBACK *func)(int x, int y)
)
设置鼠标器移动回调函数,当鼠标发生移动时执行被注册的函数。
6
、
glutKeyboardFunc
(
void (GLUTCALLBACK *func)(unsigned char key, int x, int y)
)
设置键盘回调函数,当键盘有键被按下是调用所注册的函数。
7
、
glutIdleFunc(
void (GLUTCALLBACK *func)(void)
)
设置空闲回调函数,当CPU空闲时调用该函数。
三、
窗口管理(Window Management)
1
、int glutCreateWindow(char* name);
产生一个顶层的窗口。name 作为窗口的名字,也就是窗口标题栏显示的内容。
返回值是生成窗口的标记符,可用函数glutGetWindow()加以引用。
2
、int glutCreateSubWindow(int win,int x,int y,int width,int height);
创建一个子窗口。win是其父窗口的标记符。x,y是相对父窗口的位移,以像素表示。
width,height
是子窗口的宽和高。
3
、void glutSetWindow(int win)
int glutGetWindow(void)
功能分别是:设置标记符为win的窗口为当前窗口;返回当前窗口的标记符。
4
、void glutDestroyWindow(int win)
销毁以win标记的窗口。
5
、void glutPostRedisplay(void)
将当前窗口打上标记,标记其需要再次显示。
6
、void glutSwapBuffers(void)
当窗口模式为双缓存时,此函数的功能就是把后台缓存的内容交换到前台显示。当然,只有单缓存时,使用它的功能跟用glFlush()一样。
而使用双缓存是为了把完整图画一次性显示在窗口上,或者是为了实现动画。
7
、void glutPositionWindow(int x,int y)
改变当前窗口的位置:当前窗口是顶层窗口时,x,y是相对于屏幕的的位移;当前窗口若是子窗口时,x,y是相对其父窗口原点的位移。
8
、void glutReshapeWindow(int width,int height)
改变当前窗口的大小。
width,height
是当前窗口新的宽度和高度值,当然只能是正值。
9
、void glutFullscreen(void)
让当前窗口全屏显示。当前窗口是顶层窗口时才有效。
10
、void glutPopWindow(void)
void glutPushWindow(void)
对顶层窗口和子窗口均有效。改变当前窗口在栈中相对于其它窗口的次序。
11
、void glutShowWindow(void)
void glutHideWindow(void)
void glutIconifyWindow(void)
这三个函数作用是改变当前窗口的显示状态。
glutShowWindow
让当前窗口可视(这时它还是可能被其它窗口挡住)。
glutHideWindow
让当前窗口成为不可视状态。
glutIconifyWindow
让当前窗口成为一个图标,也即是最小化。
12
、glutSetWindowTitle(char* name);
glutSetIconTitle(char* name);
设置当前窗口(必须是顶层窗口)的标题和图标化时的标题。
13
、glutSetCursor(int cursor);
设置当前窗口的光标样式。
cursor
可选值有许多:如GLUT_CURSOR_RIGHT_ARROW指向右边的光标,
GLUT_CURSOR_LEFT_ARROW
指向左边的光标,GLUT_CURSOR_INFO成为手状。
GLUT_CURSOR_DESTROY
呈叉状,GLUT_CURSOR_HELP呈现问号的形状。
等等。
四、
窗口的覆盖管理
1
、void glutEstablishOverlay(void);
对当前窗口创建覆盖图层。该覆盖图的模式由初始化显示模式函数glutDisplayMode()决定。glutLayerGet(GLUT_OVERLAY_POSSIBLE)可用以设置对于当前窗口,是否允许产生由初始化显示模式函数规定其模式的覆盖图层。
2
、void glutUserLayer(GLenum layer);
枚举量layer可选值为:GLUT_NORMAL,GLUT_OVERLAY.分别选取正常位平面或覆盖平面。
3
、void glutRemoveLayer(void);
除去覆盖图。当没有覆盖图层时,调用这条语句也是安全的,这时系统不做任何事。
4
、void glutPostOverlayRedisplay(void);
标记该覆盖图层为需要重新显示的状态。
5
、void glutShowOverlay(void);
void glutHideOverlay(void);
显示当前窗口的覆盖图层;隐藏覆盖图层。这两条语句即时执行。注意一下,只有窗口可视时,使用glutShowOverlay才能使其覆盖图层可视。当窗口被其他窗口遮挡时,其覆盖图层也被遮挡从而不可视。