原文出处:OpenGL 中常用的 GLUT 函数库
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_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平台上,不被支持。
void glutPushWindow(void);
void glutHideWindow(void);
void glutIconifyWindow(void);
glutHideWindow让当前窗口成为不可视状态。
glutIconifyWindow让当前窗口成为一个图标,也即是最小化。
void glutSetWindowTitle(char* name);
void glutSetIconTitle(char* name);
GLUT_CURSOR_DESTROY呈叉状,GLUT_CURSOR_HELP呈现问号的形状。等等。
void glutHideOverlay(void);
int glutGetMenu(void);
void glutDetachMenu(int button);
| |
| |
| |
| |
| |
当鼠标在窗口中按下并移动时调用glutMotionFunc注册的回调函数
当鼠标在窗口中移动时调用glutPassiveMotionFunc注册的回调函数
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Insert键 |
| |
| |
| |
| |
GLUT_WINDOW_Y
GLUT_WINDOW_WIDTH
GLUT_WINDOW_HEIGHT
GLUT_WINDOW_BUFFER_SIZE
GLUT_WINDOW_STENCIL_SIZE
GLUT_WINDOW_DEPTH_SIZE
GLUT_WINDOW_RED_SIZE
GLUT_WINDOW_GREEN_SIZE
GLUT_WINDOW_BLUE_SIZE
GLUT_WINDOW_ALPHA_SIZE
GLUT_WINDOW_ACCUM_RED_SIZE
GLUT_WINDOW_ACCUM_GREEN_SIZE 当前窗口累积缓存中,绿色分量占用的位数,即用多少bit表示绿色分量
GLUT_WINDOW_ACCUM_BLUE_SIZE
GLUT_WINDOW_ACCUM_ALPHA_SIZE
GLUT_WINDOW_DOUBLEBUFFER
GLUT_WINDOW_RGBA
GLUT_WINDOW_PARENT
GLUT_WINDOW_NUM_CHILDREN
GLUT_WINDOW_NUM_SAMPLES
GLUT_WINDOW_STEREO
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
GLUT_INIT_DISPLAY_MODE
GLUT_INIT_WINDOW_X
GLUT_INIT_WINDOW_Y
GLUT_INIT_WINDOW_WIDTH
GLUT_INIT_WINDOW_HEIGHT
GLUT_ELAPSED_TIME
| |
| |
| |
| |
| |
info为要检索的设备信息的名字,为以下常量:
| 如果键盘可用,返回非0值,否则,返回0 |
| 如果鼠标可用,返回非0值,否则,返回0 |
| 返回鼠标支持的按键数,如果鼠标不可用,返回0 |
返回组合功能键的状态
返回值为以下定义的常量:
| |
| |
| |
extension是指定要测试的OpenGL扩展的名称
如果给定扩展获得支持,函数返回非0,否则返回0。
void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); 实心球
void glutSolidCube(GLdouble size); 实心立方体
void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 实心圆环
void glutSolidIcosahedron(void); 实心20面体
void glutSolidOctahedron(void); 实心8面体
void glutSolidTetrahedron(void); 实心4面体
void glutSolidDodecahedron(GLdouble radius); 实心12面体
void glutSolidCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 实心圆锥体
void glutSolidTeapot(GLdouble size); 实心茶壶
设置glut程序要产生的窗口的大小和位置(左上角)。以像素为单位。
void glutInitDisplayMode(unsigned int mode);
设置图形显示模式。参数mode的可选值为:
二、事件处理(Event Processing)
让 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);
功能分别是:设置标记符为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 glutShowWindow(void);
这三个函数作用是改变当前窗口的显示状态。
glutShowWindow让当前窗口可视(这时它还是可能被其它窗口挡住)。
设置当前窗口(必须是顶层窗口)的标题和图标化时的标题。
void glutSetCursor(int cursor);
设置当前窗口的光标样式。
cursor可选值有许多:如GLUT_CURSOR_RIGHT_ARROW指向右边的光标,GLUT_CURSOR_LEFT_ARROW指向左边的光标,GLUT_CURSOR_INFO成为手状。
四、窗口的覆盖管理
void glutEstablishOverlay(void);
对当前窗口创建覆盖图层。该覆盖图的模式由初始化显示模式函数glutDisplayMode()决定。
glutLayerGet(GLUT_OVERLAY_POSSIBLE)可用以设置对于当前窗口,是否允许产生由初始化显示模式函数规定其模式的覆盖图层。
void glutUserLayer(GLenum layer);
枚举量layer可选值为:GLUT_NORMAL,GLUT_OVERLAY.分别选取正常位平面或覆盖平面。
void glutRemoveLayer(void);
除去覆盖图。当没有覆盖图层时,调用这条语句也是安全的,这时系统不做任何事。
void glutPostOverlayRedisplay
标记该覆盖图层为需要重新显示的状态。
void glutShowOverlay(void);
显示当前窗口的覆盖图层;隐藏覆盖图层。这两条语句即时执行。注意一下,只有窗口可视时,使用glutShowOverlay才能使其覆盖图层可视。当窗口被其他窗口遮挡时,其覆盖图层也被遮挡从而不可视。
五、菜单管理
int glutCreateMenu(void (*func)(int value))
当点击菜单时,调用回调函数func,value为传递给回调函数的数值,它由所选择的菜单条目对应的整数值所决定。
这个函数创建一个新的弹出式菜单,并返回一个唯一的标识次菜单的整型标识符,并将新建的弹出菜单与func函数关联在一起,这样,当选择此菜单中的一个菜单条目时,调用回调函数func.
void glutSetMenu(int menu);
设置当前菜单;获取当前菜单的标识符
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 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为鼠标的按键,为以下定义的常量:
x,y为鼠标按下式,光标相对于窗口左上角的位置
void glutMotionFunc(void (*func)(int x, int y));
设置移动回调函数;设置当前鼠标移动函数
Func为注册的鼠标移动函数
x,y为鼠标按下式,光标相对于窗口左上角的位置
void glutVisibilityFunc(void (*func) (int state) );
设置当前窗口的可视回调函数
Func为指定的可视回调函数
state表示窗口的可视性,为以下常量:
void glutEntryFunc(void (*func) (int state));
设置鼠标的进出窗口的回调函数
Func为注册的鼠标进出回调函数
state为鼠标的进出状态,为以下常量之一:
void glutSpecialFunc(void (*func) (int key, int x, int y))
设置当前窗口的特定键的回调函数
Func为注册的特定键的回调函数
key为按下的特定键,为以下定义的常量:
void glutMenuStatusFunc(void (*func) (int status, int x, int y));
设置菜单状态回调函数
func是注册的菜单状态回调函数
status是当前是否使用菜单,为以下定义的常量:
这个函数时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);
注册一个回调函数,当指定时间值到达后,由GLUT调用注册的函数一次
msecs是等待的时间
Func是注册的函数
value是指定的一个数值,用来传递到回调函数Func中
这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数。
七、色彩管理(未完成)
glutSetColor
glutGetColor
glutCopyColormap
八、状态检索
int glutGet(GLenum state);
检索指定的GLUT状态
state为指定要检索的状态类型,为以下常量:
state常量
返回值根据查询的内容返回相应的值,无效的状态名返回-1.
int glutLayerGet(GLenum info);
查询属于当前窗口的重叠层的状态
Info表示查询的重叠层状态常量:
九、实体绘制
以下所有函数中,radius表示球体的半径,slices表示球体围绕z轴分割的数目(经线),stacks表示球体沿着z轴分割的数目(纬线)。
绘制中心在模型坐标原点,半径为radius的球体,球体围绕z轴分割slices次,球体沿着z轴分割stacks次
void glutWireSphere(GLdouble radius, GLint slices, GLint stacks); 线框球
void glutWireCube(GLdouble size); 线框立方体
void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 线框圆环
void glutWireIcosahedron(void); 线框20面体
void glutWireOctahedron(void); 线框8面体
void glutWireTetrahedron(void); 线框4面体
void glutWireDodecahedron(GLdouble radius); 线框12面体
void glutWireCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 线框圆锥体
void glutWireTeapot(GLdouble size); 线框茶壶