GLUT函数说明.docx
《GLUT函数说明.docx》由会员分享，可在线阅读，更多相关《GLUT函数说明.docx（16页珍藏版）》请在冰豆网上搜索。
GLUT函数说明
GLUT函数说明
Cg/GL2010-07-1816:
13:
17阅读36评论0 字号：
大中小 订阅
GLUT函数说明
glut库下的所有函数
一、初始化
voidglutInit（int*argc,char**argv）
这个函数用来初始化GLUT库。
对应main函数的形式应是：
intmain（intargc,char*argv[]）;
这个函数从main函数获取其两个参数。
voidglutInitWindowSize（intwidth,intheight）;
voidglutInitWindowPosition（intx,inty）;
设置glut程序要产生的窗口的大小和位置（左上角）。
以像素为单位。
voidglutInitDisplayMode（unsignedintmode）;
设置图形显示模式。
参数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平台上，不被支持。
二、事件处理（EventProcessing）
void glutMainLoop（void）
让glut程序进入事件循环。
在一个glut程序中最多只能调用一次。
一旦调用，会直到程序结束才返回。
三、窗口管理（WindowManagement）
intglutCreateWindow（char*name）;
产生一个顶层的窗口。
name作为窗口的名字，也就是窗口标题栏显示的内容。
返回值是生成窗口的标记符，可用函数glutGetWindow（）加以引用。
intglutCreateSubWindow（intwin,intx,inty,intwidth,intheight）;
创建一个子窗口。
win是其父窗口的标记符。
x,y是相对父窗口的位移，以像素表示。
width,height是子窗口的宽和高。
voidglutSetWindow（intwin）;
intglutGetWindow（void）;
功能分别是：
设置标记符为win的窗口为当前窗口；返回当前窗口的标记符。
voidglutDestroyWindow（intwin）;
销毁以win标记的窗口。
voidglutPostRedisplay（void）;
将当前窗口打上标记，标记其需要再次显示。
voidglutSwapBuffers（void）;
当窗口模式为双缓存时，此函数的功能就是把后台缓存的内容交换到前台显示。
当然，只有单缓存时，使用它的功能跟用glFlush（）一样。
而使用双缓存是为了把完整图画一次性显示在窗口上，或者是为了实现动画。
voidglutPositionWindow（intx,inty）;
改变当前窗口的位置：
当前窗口是顶层窗口时，x,y是相对于屏幕的的位移；当前窗口若是子窗口时，x,y是相对其父窗口原点的位移。
voidglutReshapeWindow（intwidth,intheight）;
改变当前窗口的大小。
width,height是当前窗口新的宽度和高度值，当然只能是正值。
voidglutFullscreen（void）;
让当前窗口全屏显示。
当前窗口是顶层窗口时才有效。
voidglutPopWindow（void）;
voidglutPushWindow（void）;
对顶层窗口和子窗口均有效。
改变当前窗口在栈中相对于其它窗口的次序。
voidglutShowWindow（void）;
voidglutHideWindow（void）;
voidglutIconifyWindow（void）;
这三个函数作用是改变当前窗口的显示状态。
∙glutShowWindow让当前窗口可视（这时它还是可能被其它窗口挡住）。
∙glutHideWindow让当前窗口成为不可视状态。
∙glutIconifyWindow让当前窗口成为一个图标，也即是最小化。
voidglutSetWindowTitle（char*name）;
voidglutSetIconTitle（char*name）;
设置当前窗口（必须是顶层窗口）的标题和图标化时的标题。
voidglutSetCursor（intcursor）;
设置当前窗口的光标样式。
cursor可选值有许多：
如GLUT_CURSOR_RIGHT_ARROW指向右边的光标，GLUT_CURSOR_LEFT_ARROW指向左边的光标，GLUT_CURSOR_INFO成为手状。
GLUT_CURSOR_DESTROY呈叉状，GLUT_CURSOR_HELP呈现问号的形状。
等等。
四、窗口的覆盖管理
voidglutEstablishOverlay（void）;
对当前窗口创建覆盖图层。
该覆盖图的模式由初始化显示模式函数glutDisplayMode（）决定。
glutLayerGet（GLUT_OVERLAY_POSSIBLE）可用以设置对于当前窗口，是否允许产生由初始化显示模式函数规定其模式的覆盖图层。
voidglutUserLayer（GLenumlayer）;
枚举量layer可选值为：
GLUT_NORMAL,GLUT_OVERLAY.分别选取正常位平面或覆盖平面。
voidglutRemoveLayer（void）;
除去覆盖图。
当没有覆盖图层时，调用这条语句也是安全的，这时系统不做任何事。
voidglutPostOverlayRedisplay（void）;
标记该覆盖图层为需要重新显示的状态。
voidglutShowOverlay（void）;
voidglutHideOverlay（void）;
显示当前窗口的覆盖图层；隐藏覆盖图层。
这两条语句即时执行。
注意一下，只有窗口可视时，使用glutShowOverlay才能使其覆盖图层可视。
当窗口被其他窗口遮挡时，其覆盖图层也被遮挡从而不可视。
五、菜单管理
intglutCreateMenu（void（*func）（intvalue））
当点击菜单时,调用回调函数func，value为传递给回调函数的数值,它由所选择的菜单条目对应的整数值所决定。
这个函数创建一个新的弹出式菜单,并返回一个唯一的标识次菜单的整型标识符,并将新建的弹出菜单与func函数关联在一起,这样,当选择此菜单中的一个菜单条目时,调用回调函数func.
voidglutSetMenu（intmenu）;
intglutGetMenu（void）;
设置当前菜单;获取当前菜单的标识符
voidglutDestroyMenu（intmenu）;
删除指定的菜单
voidglutAddMenuEntry（char*name,intvalue）;
添加一个菜单条目
voidglutAddSubMenu（char*name,intmenu）;
在当前菜单的底部增加一个子菜单的触发条目
voidglutChangeToMenuEntry（intentry,char*name,intvalue）;
更改当前菜单中指定菜单项
voidglutChangeToSubMenu（intentry,char*name,intmenu）;
将指定的当前菜单中菜单项变为子菜单触发条目
voidglutRemoveMenuItem（intentry）;
删除指定的菜单项
voidglutAttachMenu（intbutton）;
voidglutDetachMenu（intbutton）;
把当前窗口的一个鼠标按键与当前菜单关联起来;解除鼠标按键与弹出式菜单的关联关系
六、注册回调
voidglutDisplayFunc（void（*func）（void））;
为当前窗口设置显示回调函数
voidglutOverlayDisplayFunc（void（*func）（void））;
注册当前窗口的重叠层的显示回调函数
voidglutReshapeFunc（void（*Func）（intwidth,intheight））;
指定当窗口的大小改变时调用的函数
voidglutKeyboardFunc（void（*func）（unsignedcharkey,intx,inty））;
注册当前窗口的键盘回调函数
voidglutMouseFunc（void（*func）（intbutton,intstate,intx,inty））;
注册当前窗口的鼠标回调函数
func为注册的鼠标回调函数,这个函数完成鼠标事件的处理
button为鼠标的按键,为以下定义的常量
GLUT_LEFT_BUTTON
鼠标左键
GLUT_MIDDLE_BUTTON
鼠标中键
GLUT_RIGHT_BUTTON
鼠标右键
state为鼠标按键的动作,为以下定义的常量
GLUT_UP
鼠标释放
GLUT_DOWN
鼠标按下
x,y为鼠标按下式,光标相对于窗口左上角的位置
voidglutMotionFunc（void（*func）（intx,inty））;
voidglutPassiveMotionFunc（void（*func）（intx,inty））;
设置移动回调函数;设置当前鼠标移动函数
Func为注册的鼠标移动函数
x,y为鼠标按下式,光标相对于窗口左上角的位置
当鼠标在窗口中按下并移动时调用glutMotionFunc注册的回调函数
当鼠标在窗口中移动时调用glutPassiveMotionFunc注册的回调函数
voidglutVisibilityFunc（void（*func）（intstate））;
设置当前窗口的可视回调函数
Func为指定的可视回调函数
state表示窗口的可视性,为以下常量:
GLUT_NOT_VISIBLE
窗口完全不可见
GLUT_VISIBLE
窗口可见或部分可见
这个函数设置当前窗口的可视回调函数,当窗口的可视性改变时,该窗口的可视回调函数被调用.只要窗口中的任何一个像素是可见的,或者他的任意一个子窗口中任意一个像素是可见的,GLUT则认为窗口是可见的.
voidglutEntryFunc（void（*func）（intstate））;
设置鼠标的进出窗口的回调函数
Func为注册的鼠标进出回调函数
state为鼠标的进出状态,为以下常量之一:
GLUT_LEFT
鼠标离开窗口
GLUT_RIGHT
鼠标进入窗口
当窗口取得焦点或失去焦点时调用这个函数,当鼠标进入窗口区域并点击时,state为GLUT_RIGHT,当鼠标离开窗口区域点击其他窗口时,state为GLUT_LEFT.
voidglutSpecialFunc（void（*func）（intkey,intx,inty））
设置当前窗口的特定键的回调函数
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码产生.
voidglutMenuStatusFunc（void（*func）（intstatus,intx,inty））;
设置菜单状态回调函数
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
voidglutMenuStatusFunc（void（*func）（intstatus,intx,inty））;
设置菜单状态回调函数
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程序只有一个菜单状态回调函数.
voidglutIdleFunc（void（*func）（void））;
设置空闲回调函数
func表示当系统空闲时调用的函数,它的形式为voidfunc（void）
voidglutTimerFunc（unsignedintmsecs,void（*Func）（intvalue）,intvalue）;
注册一个回调函数,当指定时间值到达后,由GLUT调用注册的函数一次
msecs是等待的时间
Func是注册的函数
value是指定的一个数值,用来传递到回调函数Func中
这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数.
七、色彩管理（未完成）
glutSetColor
glutGetColor
glutCopyColormap
八、状态检索
intglutGet（GLenumstate）;
检索指定的GLUT状态
state为指定要检索的状态类型,为以下常量
state常量
描述
GLUT_WINDOW_X
当前窗口的x坐标,以像素为单位
GLUT_WINDOW_Y
当前窗口的y坐标,以像素为单位
GLUT_WINDOW_WIDTH
当其窗口的宽度,以像素为单位
GLUT_WINDOW_HEIGHT
当前窗口的高度,以像素为单位
GLUT_WINDOW_BUFFER_SIZE
当前窗口中,颜色分量占用的位数,即用多少bit表示颜色分量
GLUT_WINDOW_STENCIL_SIZE
当前窗口中,蒙板分量占用的位数,即用多少bit表示蒙板分量
GLUT_WINDOW_DEPTH_SIZE
当前窗口中,深度分量占用的位数,即用多少bit表示深度分量
GLUT_WINDOW_RED_SIZE
当前窗口中,红色分量占用的位数,即用多少bit表示红色分量
GLUT_WINDOW_GREEN_SIZE
当前窗口中,绿色分量占用的位数,即用多少bit表示绿色分量
GLUT_WINDOW_BLUE_SIZE
当前窗口中,蓝色分量占用的位数,即用多少bit表示蓝色分量
GLUT_WINDOW_ALPHA_SIZE
当前窗口中,alpha色分量占用的位数,即用多少bit表示alpha色分量
GLUT_WINDOW_ACCUM_RED_SIZE
当前窗口累积缓存中,红色分量占用的位数,即用多少bit表示红色分量
GLUT_WINDOW_ACCUM_GREEN_SIZE
当前窗口累积缓存中,绿色分量占用的位数,即用多少bit表示绿色分量
GLUT_WINDOW_ACCUM_BLUE_SIZE
当前窗口累积缓存中,蓝色分量占用的位数,即用多少bit表示蓝色分量
GLUT_WINDOW_ACCUM_ALPHA_SIZE
当前窗口累积缓存中,alpha色分量占用的位数,即用多少bit表示alpha色分量
GLUT_WINDOW_DOUBLEBUFFER
如果窗口式双缓存模式,返回1,否则返回0
GLUT_WINDOW_RGBA
如果窗口是RGBA模式,返回1,否则返回0
GLUT_WINDOW_PARENT
查询当前窗口的父窗口个数,如果为顶层窗口返回0
GLUT_WINDOW_NUM_CHILDREN
查询当前窗口的子窗口个数
GLUT_WINDOW_NUM_SAMPLES
查询多重采样的采样点个数
GLUT_WINDOW_STEREO
查询是否使用立体模式,是则返回1,否则返回0
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
查询窗口系统是否支持当前的显示模式,1表示支持,0表示不支持
GLUT_INIT_DISPLAY_MODE
初始窗口的显示模式
GLUT_INIT_WINDOW_X
初始窗口的x坐标
GLUT_INIT_WINDOW_Y
初始窗口的y坐标
GLUT_INIT_WINDOW_WIDTH
初始窗口的宽度
GLUT_INIT_WINDOW_HEIGHT
初始窗口的高度
GLUT_ELAPSED_TIME
返回两次调用glutGet（GLUT_ELAPSED_TIME）的时间间隔,单位为毫秒
返回值根据查询的内容返回相应的值,无效的状态名返回-1.
intglutLayerGet（GLenuminfo）;
查询属于当前窗口的重叠层的状态
Info表示查询的重叠层状态常量
GLUT_OVERLAY_POSSIBLE
在给定的初始显示模式下,能否为当前窗口创建重叠层.如果能,返回1;如果不能,返回0
GLUT_LAYER_IN_USE
返回当前的使用层,为GLUT_NORMAL或GLUT_OVERLAY
GLUT_HAS_OVERLAY
判断当前窗口是否创建了重叠层
GLUT_NORMAL_DAMAGED
如果当前窗口的图像层在上一次显示回调函数调用后已经破坏,则返回TRUE
GLUT_OVERLAY_DAMAGED
如果当前窗口的重叠层在上一次显示回调函数调用后已经破坏,则返回TRUE
intglutDeviceGet（GLenuminfo）;
检索设备信息
info为要检索的设备信息的名字,为以下常量
GLUT_HAS_KEYBOARD
如果键盘可用,返回非0值,否则,返回0
GLUT_HAS_MOUSE
如果鼠标可用,返回非0值,否则,返回0
GLUT_NUM_MOUSE_BUTTONS
返回鼠标支持的按键数,如果鼠标不可用,返回0
返回值0表示检索的设备不存在,非0表示设备可用
intglutGetModifiers（void）;
返回组合功能键的状态
返回值为以下定义的常量
GLUT_ACTIVE_SHIFT
当按下shift键时
GLUT_ACTIVE_CTRL
当按下ctrl键时
GLUT_ACTIVE_ALT
当按下alt键时
intglutExtensionSupported（char*extension）;
判定是否支持特定的OpenGL扩展
extension是指定要测试的OpenGL扩展的名称
如果给定扩展获得支持,函数返回非0,否则返回0
九、字体渲染
voidglutBitmapCharacter（void*font,intcharacter）;
绘制一个图像字符
Font表示要使用的图像字体,如下表所示:
GLUT_BITMAP_8_BY_13
一种固定宽度字体,每个字符都放在一个8x13像素的矩形框内
GLUT_BITMAP_9_BY_15
一种固定宽度字体,每个字符都放在一个9x15像素的矩形框内
GLUT_BITMAP_TIMES_ROMAN_10
一种10点均匀间距的TimesRoman字体
GLUT_BITMAP_TIMES_ROMAN_24
一种24点均匀间距的TimesRoman字体
GLUT_BITMAP_HELVETICA_10
一种10点均匀间距的Helvetica字体
GLUT_BITMAP_HELVETICA_12
一种12点均匀间距的Helvetica字体
GLUT_BITMAP_HELVETICA_18
一种18点均匀间距的Helvetica字体
Character表示要绘
升级会员 