GLUT函数说明
一、初始化void glutInit(int* argc,char** argv) 这个函数用来初始化GLUT库。对应main函数的形式应是:int main(int argc,char* argv[]);
这个函数从main函数获取其两个参数。 void glutInitWindowSize(int width,int height);
|
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);
msecs是等待的时间
Func是注册的函数
value是指定的一个数值,用来传递到回调函数Func中
这个函数注册了一个回调函数,当指定的毫秒数到达后,这个函数就调用注册的函数,value参数用来向这个注册的函数中传递参数.
七、色彩管理(未完成)
glutSetColor
glutGetColor
glutCopyColormap
八、状态检索
int glutGet(GLenum state);
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 |
int glutGetModifiers(void);
返回值为以下定义的常量
GLUT_ACTIVE_SHIFT | 当按下shift键时 |
GLUT_ACTIVE_CTRL | 当按下ctrl键时 |
GLUT_ACTIVE_ALT | 当按下alt键时 |
int glutExtensionSupported(char* extension);
extension是指定要测试的OpenGL扩展的名称
如果给定扩展获得支持,函数返回非0,否则返回0
九、字体渲染
void glutBitmapCharacter(void* font, int character);
Font表示要使用的图像字体,如下表所示:
GLUT_BITMAP_8_BY_13 | 一种固定宽度字体,每个字符都放在一个8x13像素的矩形框内 |
GLUT_BITMAP_9_BY_15 | 一种固定宽度字体,每个字符都放在一个9x15像素的矩形框内 |
GLUT_BITMAP_TIMES_ROMAN_10 | 一种10点均匀间距的Times Roman字体 |
GLUT_BITMAP_TIMES_ROMAN_24 | 一种24点均匀间距的Times Roman字体 |
GLUT_BITMAP_HELVETICA_10 | 一种10点均匀间距的Helvetica字体 |
GLUT_BITMAP_HELVETICA_12 | 一种12点均匀间距的Helvetica字体 |
GLUT_BITMAP_HELVETICA_18 | 一种18点均匀间距的Helvetica字体 |
int glutBitmapWidth(GLUTbitmapFont font, int character);
font是指定的图像字体,如下表所示:
GLUT_BITMAP_8_BY_13 | 一种固定宽度字体,每个字符都放在一个8x13像素的矩形框内 |
GLUT_BITMAP_9_BY_15 | 一种固定宽度字体,每个字符都放在一个9x15像素的矩形框内 |
GLUT_BITMAP_TIMES_ROMAN_10 | 一种10点均匀间距的Times Roman字体 |
GLUT_BITMAP_TIMES_ROMAN_24 | 一种24点均匀间距的Times Roman字体 |
GLUT_BITMAP_HELVETICA_10 | 一种10点均匀间距的Helvetica字体 |
GLUT_BITMAP_HELVETICA_12 | 一种12点均匀间距的Helvetica字体 |
GLUT_BITMAP_HELVETICA_18 | 一种18点均匀间距的Helvetica字体 |
返回指定字符的宽度,以像素为单位
void glutStrokeCharacter(void* font, int character);
Font表示要使用的图形字体,如下表所示:
GLUT_STROKE_ROMAN | 一种等间距的Roman Simplex字体,仅包括32到127的ASCII字符 |
GLUT_STROKE_MONO_ROMAN | 一种单一间距的Roman Simplex字体,仅包括32到127的ASCII字符 |
int glutStrokeWidth(GLUTstrokeFont font, int character);
Font是指定的图形字体,如下表所示:
GLUT_STROKE_ROMAN | 一种等间距的Roman Simplex字体,仅包括32到127的ASCII字符 |
GLUT_STROKE_MONO_ROMAN | 一种单一间距的Roman Simplex字体,仅包括32到127的ASCII字符 |
十、实体绘制
以下所有函数中,radius表示球体的半径,slices表示球体围绕z轴分割的数目,stacks表示球体沿着z轴分割的数目。绘制中心在模型坐标原点,半径为radius的球体,球体围绕z轴分割slices次,球体沿着z轴分割stacks次
void glutWireSphere(GLdouble radius, GLint slices, GLint stacks); 线框球
void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); 实心球
void glutWireCube(GLdouble size); 线框立方体
void glutSolidCube(GLdouble size); 实心立方体
void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 线框圆环
void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); 实心圆环
void glutWireIcosahedron(void); 线框20面体
void glutSolidIcosahedron(void); 实心20面体
void glutWireOctahedron(void); 线框8面体
void glutSolidOctahedron(void); 实心8面体
void glutWireTetrahedron(void); 线框4面体
void glutSolidTetrahedron(void); 实心4面体
void glutWireDodecahedron(GLdouble radius); 线框12面体
void glutSolidDodecahedron(GLdouble radius); 实心12面体
void glutWireCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 线框圆锥体
void glutSolidCone(GLdouble radius, GLdouble height, GLint slices, GLint stacks); 实心圆锥体
void glutWireTeapot(GLdouble size); 线框茶壶
void glutSolidTeapot(GLdouble size); 实心茶壶
十一、实例
初始化及简单平面图形
#include <GL/glut.h>
void renderScene(void) {
glClear(GL_COLOR_BUFFER_BIT);
glBegin(GL_TRIANGLES);
glVertex3f(-0.5,-0.5,0.0);
glVertex3f(0.5,0.0,0.0);
glVertex3f(0.0,0.5,0.0);
glEnd();
glFlush();
}
int main(int argc, char **argv) {
glutInit(&argc, argv);
glutInitDisplayMode(GLUT_DEPTH | GLUT_SINGLE | GLUT_RGBA);
glutInitWindowPosition(100,100);
glutInitWindowSize(320,320);
glutCreateWindow("3D Tech- GLUT Tutorial");
glutDisplayFunc(renderScene);
glutMainLoop();
return 0;
}