[译]GLUT教程 - 初始化
Lighthouse3d.com >> GLUT Tutorial >> Basics >> Initialization
这一节开始从main函数入手.第一步是线初始化GLUT库和创建窗体.
GLUT进入事件处理循环之后会获得程序的控制权.GLUT会等待事件(event)发生,然后检查有没有绑定的函数来处理它.
所以在GLUT进入它的事件处理循环之前,我们要先告诉GLUT事件发生时需要调用哪个函数来处理.
你是不是想问什么是事件(event).事件就是诸如键盘的键被按下,鼠标被移动,窗体需要绘制(到显示器屏幕),还有窗体被改变大小,还有很多.. 我们先从处理绘制事件开始.
告诉GLUT一个事件对应哪个函数的方法是注册回调函数(callback function).每一个事件类型GLUT都提供一个指定的函数来注册回调函数.
main函数的框架如下:
int main(int argc, char **argv) { // init GLUT and create window // register callbacks // enter GLUT event processing cycle }
初始化GLUT和创建窗体
所有GLUT函数都以glut开头(作为名字前缀),而GLUT的初始化函数都以glutInit开头.第一步是调用glutInit函数,原型如下:
void glutInit(int *argc, char **argv);
argc和argv都是只读的main函数传入变量的指针
初始化GLUT之后,要定义窗体的属性.先定义位置,例如左上角在屏幕的位置.用glutInitWindowPosition函数实现,原型如下:
void glutInitWindowPosition(int x, int y);
x - 屏幕左边的像素值. -1表示使用默认值,意味着它交由window管理器来决定窗体出现在何处,不想这样的话就给正值,
y - 屏幕顶部的像素值. 同上.
接下来要定义窗体的大小,用glutInitWindowSize函数实现,原型如下:
void glutInitWindowSize(int width, int height);
width - 窗体的宽
height - 窗体的高
然后你要用glutInitDisplayMode函数定义显示模式,原型如下:
void glutInitDisplayMode(unsigned int mode)
mode - 指定显示模式
参数mode是由GLUT库预定义的可选值组成的一个布尔组合(OR位模式),用来指定颜色模型和缓冲的数量和类型.
预定义常量如下:
GLUT_RGBA / GLUT_RGB - 选择RGBA窗体.这是默认选项.
GLUT_INDEX - 选择颜色索引模式
显示模式允许选择单缓冲或双缓冲的窗体,预定义常量如下:
GLUT_SINGLE - 单缓存窗体
GLUT_DOUBLE - 双缓冲窗体,需要支持平滑运动
另外,你可以指定专用的缓冲集合
GLUT_ACCUM - 堆缓冲
GLUT_STENCIL - 模版缓冲
GLUT_DEPTH - 深度缓冲
假定你要创建一个RGB的双缓冲和深度缓冲的窗体.你要做的是用"或"合并这些常量.
glutInitDisplayMode(GLUT_RGB | GLUT_DOUBLE | GLUT DEPTH);
完成了以上步骤之后,只需要调用glutCreateWindow来创建窗体,原型如下:
int glutCreateWindow(char *title);
title - 设置窗体标题
返回值是窗体ID,该ID后面几章会用到.
以下是上面零散初始化代码的整合:
#ifdef __APPLE__ #include <GLUT/glut.h> #else #include <GL/glut.h> #endif int main(int argc, char **argv) { // init GLUT and create Window glutInit(&argc, argv); glutInitDisplayMode(GLUT_DEPTH | GLUT_DOUBLE | GLUT_RGBA); glutInitWindowPosition(100,100); glutInitWindowSize(320,320); glutCreateWindow("Lighthouse3D- GLUT Tutorial"); return 1; }
注意到代码开头的include语法.包含的头文件是GLUT发行包,该发行包的位置在不同的操作系统都不同,所以跨平台检查是必须的.
渲染函数和回调注册
如果你运行这段代码,你会看到一个空的黑色命令行窗体,而不是OpenGL窗体.因为在渲染前还有两件事要做. 一是告诉GLUT库渲染的响应函数,该函数在每次窗体绘制或重绘的时候被GLUT调用.
我们来创建一个渲染的例子函数.下面这函数将会清空颜色缓冲,然后画一个三角形.
void renderScene(void) { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_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(); glutSwapBuffers(); }
该函数的名字随你喜欢.现在你要做的是把它绑定到GLUT中.该绑定操作叫作注册一个回调.GLUT会在需要渲染的时候调用该函数.
现在就告诉GLUT库renderScene函数需要在窗体绘制的时候调用.GLUT有一个专门函数来做绑定回调函数的操作,需要在窗体创建的时候调用,原型如下:
void glutDisplayFunc(void (*funcName)(void));
GLUT事件处理队列
现在就剩下最后一步,就是告知GLUT可以开始获取事件处理队列.GLUT提供一个函数以死循环的方式持续等待下一个要处理的事件.原型如下:
void glutMainLoop(void)
所有步骤都给出了
到目前的完整代码在下面.当你运行以下代码,会得到一个命令行窗体和一个简单的实例--白色三角形,应该是以指定的大小出现在指定的位置.
#ifdef __APPLE__ #include <GLUT/glut.h> #else #include <GL/glut.h> #endif void renderScene(void) { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_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(); glutSwapBuffers(); } int main(int argc, char **argv) { // init GLUT and create Window glutInit(&argc, argv); glutInitDisplayMode(GLUT_DEPTH | GLUT_DOUBLE | GLUT_RGBA); glutInitWindowPosition(100,100); glutInitWindowSize(320,320); glutCreateWindow("Lighthouse3D - GLUT Tutorial"); // register callbacks glutDisplayFunc(renderScene); // enter GLUT event processing cycle glutMainLoop(); return 1; }