GLUT函数说明 1
一、初始化 void glutInit(int* argc,char** argv) 这个函数用来初始化GLUT库。对应main函数的形式应是:int main(int argc,char* argv[]); 这个函数从main函数获取其两个参数。 void glutInitWindowSize(int width,int height); 设置glut程序要产生的窗口的大小和位置(左上角)。以像素为单位。 void glutInitDisplayMode(unsigned int mode); 设置图形显示模式。参数mode的可选值为:
二、事件处理(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); 功能分别是:设置标记符为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); 这三个函数作用是改变当前窗口的显示状态。
void glutSetWindowTitle(char* name); 设置当前窗口(必须是顶层窗口)的标题和图标化时的标题。 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); 标记该覆盖图层为需要重新显示的状态。 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为鼠标的按键,为以下定义的常量
state为鼠标按键的动作,为以下定义的常量
x,y为鼠标按下式,光标相对于窗口左上角的位置 void glutMotionFunc(void (*func)(int x, int y)); 设置移动回调函数;设置当前鼠标移动函数 Func为注册的鼠标移动函数 x,y为鼠标按下式,光标相对于窗口左上角的位置 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为当按下键时鼠标的坐标,相对于窗口左上角,以像素为单位 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); 注册一个回调函数,当指定时间值到达后,由GLUT调用注册的函数一次 msecs是等待的时间 Func是注册的函数 value是指定的一个数值,用来传递到回调函数Func中 这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数. |
GLUT函数说明 2
2009-01-25 02:58
七、色彩管理(未完成) glutSetColor glutGetColor glutCopyColormap 八、状态检索 int glutGet(GLenum state); 检索指定的GLUT状态 state为指定要检索的状态类型,为以下常量
返回值根据查询的内容返回相应的值,无效的状态名返回-1. int glutLayerGet(GLenum info); 查询属于当前窗口的重叠层的状态 Info表示查询的重叠层状态常量
int glutDeviceGet(GLenum info); 检索设备信息 info为要检索的设备信息的名字,为以下常量
返回值0表示检索的设备不存在,非0表示设备可用 int glutGetModifiers(void); 返回组合功能键的状态 返回值为以下定义的常量
int glutExtensionSupported(char* extension); 判定是否支持特定的OpenGL扩展 extension是指定要测试的OpenGL扩展的名称 如果给定扩展获得支持,函数返回非0,否则返回0 |
GLUT函数说明 3
2009-01-25 03:00
九、字体渲染 void glutBitmapCharacter(void* font, int character); 绘制一个图像字符 Font表示要使用的图像字体,如下表所示:
Character表示要绘制的字符 int glutBitmapWidth(GLUTbitmapFont font, int character); 返回一个图像字符的宽度 font是指定的图像字体,如下表所示:
character为指定的字符 返回指定字符的宽度,以像素为单位 void glutStrokeCharacter(void* font, int character); 绘制一个图形字符 Font表示要使用的图形字体,如下表所示:
Character为要绘制的字符 int glutStrokeWidth(GLUTstrokeFont font, int character); 返回一个图形字体的宽度 Font是指定的图形字体,如下表所示:
Character为绘制的字符 十、实体绘制 以下所有函数中,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); 线框茶壶 十一、实例 初始化及简单平面图形 #include <GL/glut.h> |
glut常用的函数
2009-01-25 03:01
本来想找找glut的API手册的,结果就找到这个了。都是些常用的函数,小应用应该够了。 |