六、注册回调

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);

注册一个回调函数,当指定时间值到达后,由GLUT调用注册的函数一次

msecs是等待的时间

Func是注册的函数

value是指定的一个数值,用来传递到回调函数Func中

这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数.

七、色彩管理(未完成)

glutSetColor

glutGetColor

glutCopyColormap

八、状态检索

int glutGet(GLenum state);

检索指定的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.

int glutLayerGet(GLenum info);

查询属于当前窗口的重叠层的状态

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

int glutDeviceGet(GLenum info);

检索设备信息

info为要检索的设备信息的名字,为以下常量

GLUT_HAS_KEYBOARD 如果键盘可用,返回非0值,否则,返回0
GLUT_HAS_MOUSE 如果鼠标可用,返回非0值,否则,返回0
GLUT_NUM_MOUSE_BUTTONS 返回鼠标支持的按键数,如果鼠标不可用,返回0

返回值0表示检索的设备不存在,非0表示设备可用

int glutGetModifiers(void);

返回组合功能键的状态

返回值为以下定义的常量

GLUT_ACTIVE_SHIFT 当按下shift键时
GLUT_ACTIVE_CTRL 当按下ctrl键时
GLUT_ACTIVE_ALT 当按下alt键时

int glutExtensionSupported(char* extension);

判定是否支持特定的OpenGL扩展

extension是指定要测试的OpenGL扩展的名称

如果给定扩展获得支持,函数返回非0,否则返回0