#include <GLtools.h>  //OpenGL toolkit：工具箱库——包含一个用于操作矩阵和向量的3D数学库，并依靠GLEW获得OpenGL 3.3中用来产生和渲染一些简单3D对象的函数，以及对平截头体、相机类和变换矩阵进行管理的函数的充分支持。

 #include <GLShaderManager.h>  //Shader Manager Class：

 //GLEW：自动初始化所有新函数指针并包含所需类型定义、常量和枚举值的扩展加载库。

 //#include <GL/glut.h>

 #define FREEGLUT_STATIC  //因为我们使用的是freeglut的静态库版本，所以需要在它前面添加FREEGLUT_STATIC处理器宏

 #include <GL/glut.h>   //Windows FreeGlut equivalent：一种实用工具箱

 GLBatch triangleBatch;  //声明一个简单的GLTool封装类，用于将三角形顶点批次进行封装

 GLShaderManager shaderManager;  //简单的存储着色器实例

 ////////////////////////////////////////////////////////////////////////////////////////////

 //62 CHAPTER 2 Getting Started

 //04_0321712617_ch02.qxd 6/21/10 11:35 AM Page 62

 //Windows has changed size, or has just been created. In either case, we need to use the

 //windows dimensions to set the viewport and the projection matrix.

 void ChangeSize(int w,int h)  //在窗口大小改变时接受新的宽度和高度

 {

     glViewport(,,w,h);  //修改从目的坐标系到屏幕坐标系上的映射,x,y参数代表窗口中视口的左下角坐标，而宽度和高度参数实用像素表示的。

 }

 ///////////////////////////////////////////////////////////////////////////////////////////

 //this fuction does any needed initialization on the rendering context.

 //This is the first opportunity to do any OpenGL related tasks.

 void SetupRC()

 {

     //Blue background

     glClearColor(0.0f,0.0f,1.0f,1.0f);   //这个函数设置用来进行窗口清除的颜色

     shaderManager.InitializeStockShaders();  //由于着色器管理器需要编译和链接它自己的着色器，所以我们必须在OpenGL开始的时候调用InitializeStockShaders方法。

     //Load up a triangle

     GLfloat vVerts[]={-0.5f,0.0f,0.0f,

                        0.5f,0.0f,0.0f,

                        0.0f,0.5f,0.0f };  //创建三角形图元，三角形图元就是组成三角形的一系列点或者顶点；值得一提的是，所有这些点的Z坐标均设置为0

     //下面代码建立了一个三角形的批次，仅包含3个顶点。

     triangleBatch.Begin(GL_TRIANGLES,);  //批次容器的初始化，告诉这个类它代表哪种图元，其中包括顶点数，以及（可选）一组或两组纹理坐标。

     triangleBatch.CopyVertexData3f(vVerts);  //然后至少复制一个由三分量顶点组成的数组。

     triangleBatch.End();  //表示已经完成了数据复制工作，并且将设置内部标记，以通知这个类包含哪些属性。

 }

 ///////////////////////////////////////////////////////////////////////////////////////////

 //called to draw scene

 //窗口发生改变的时候，调用该函数用以重绘窗口

 void RenderScene(void)

 {

     //Clear the window with current clearing color

     //上面的函数将清除颜色设置为蓝色，现在我们需要执行一个函数真正进行清除。

     glClear(GL_COLOR_BUFFER_BIT|GL_DEPTH_BUFFER_BIT|GL_STENCIL_BUFFER_BIT);  //glClear函数清除一个或一组特定的缓冲区。颜色缓冲区、深度缓冲区、模板缓冲区。深度缓冲区用于进行深度测试，其中存储了屏幕上每个像素的深度值。

     //下面的代码设置一组浮点数来表示红色（其alpha值设为1.0），并将它传递到存储着色器，即GLT_SHADER_IDENTITY着色器。这个着色器是使用指定颜色以默认笛卡尔坐标系在屏幕上渲染几何图形。

     GLfloat vRed[]={1.0f,0.0f,0.0f,1.0f};

     shaderManager.UseStockShader(GLT_SHADER_IDENTITY,vRed);  //UseStockShader函数会选择一个存储着色器并提供这个着色器的Uniform值。

     triangleBatch.Draw();   //指示将几何图形提交到着色器，绘制批次容器所描述的内容。

     //Perform the buffer swap to display the back buffer

     //当设置OpenGL时，我们指定要一个双缓冲渲染环境。这就意味着将在后台缓冲区进行渲染，然后在结束时交换到前台。这种形式能够防止观察者看到可能伴随着动画帧与动画帧之间闪烁的渲染过程。

     //缓冲区交换将以平台特定的方式进行，但是GLUT有一个单独的函数调用可以完成这项工作，即glutSwapBuffers()。

     glutSwapBuffers();

 }

 ///////////////////////////////////////////////////////////////////////////////////////////

 //Main entry point for GLUT based programs

 int main(int argc,char* argv[])

 {

     gltSetWorkingDirectory(argv[]);  //设置当前工作目录

     //接下来，进行一些基于GLUT的标准设置

     glutInit(&argc,argv);  //传输命令行参数，并初始化GLUT库

     glutInitDisplayMode(GLUT_DOUBLE|GLUT_RGBA|GLUT_DEPTH|GLUT_STENCIL);  //告诉GLUT库，在创建窗口时要使用哪种显示模式。GLUT_DOUBLE：双缓冲窗口  GLUT_RGBA：RGBA颜色模式  GLUT_DEPTH：将一个深度缓冲区分配为显示的一部分  GLUT_STENCIL：确保我们也会有一个可用的模板缓冲区。

                                                                          //其中深度缓冲区可用于进行深度测试，存储了屏幕上每个像素的深度值。

     glutInitWindowSize(,);  //设置窗口的大小

     glutCreateWindow("Triangle");  //创建以“Triangle”为标题的窗口

     //回调函数

     glutReshapeFunc(ChangeSize);  //为窗口改变大小而设置一个回调函数，以便能够设置视点

     glutDisplayFunc(RenderScene);  //注册一个函数以包含OpenGL渲染代码

     //在开始运行主消息循环之前，还要解决两个问题

     GLenum err=glewInit();   //初始化GLEW库。重新调用GLEW库初始化OpenGL驱动程序中所有丢失的入口点，以确保OpenGL API对我们来说完全可用。

     if(GLEW_OK!=err)    //在试图做任何渲染之前，还要检查确定驱动程序的初始化过程中没有出现任何问题。

     {

         fprintf(stderr,"GLEW Error:%s\n",glewGetErrorString(err));

         return ;

     }

     SetupRC();  //调用SetupRC。这里RC代表渲染环境（Rendering Context），这是一个运行中的OpenGL状态机的句柄。在任何OpenGL函数起作用之前必须创建一个渲染环境。

     //开始主消息循环并结束main函数

     glutMainLoop();

     return ;

 }

 #include <GLtools.h>  //OpenGL toolkit：工具箱库——包含一个用于操作矩阵和向量的3D数学库，并依靠GLEW获得OpenGL 3.3中用来产生和渲染一些简单3D对象的函数，以及对平截头体、相机类和变换矩阵进行管理的函数的充分支持。

 #include <GLShaderManager.h>  //Shader Manager Class

 #define FREEGLUT_STATIC  //因为我们使用的是freeglut的静态库版本，所以需要在它前面添加FREEGLUT_STATIC处理器宏

 #include <GL/glut.h>   //Windows FreeGlut equivalent：一种实用工具箱

 int main(int argc,char* argv[])

 {

     gltSetWorkingDirectory(argv[]);  //设置当前工作目录

     //接下来，进行一些基于GLUT的标准设置

     glutInit(&argc,argv);  //传输命令行参数，并初始化GLUT库

     glutInitDisplayMode(GLUT_DOUBLE|GLUT_RGBA|GLUT_DEPTH|GLUT_STENCIL);  //告诉GLUT库，在创建窗口时要使用哪种显示模式。GLUT_DOUBLE：双缓冲窗口  GLUT_RGBA：RGBA颜色模式  GLUT_DEPTH：将一个深度缓冲区分配为显示的一部分  GLUT_STENCIL：确保我们也会有一个可用的模板缓冲区。

                                                                          //其中深度缓冲区可用于进行深度测试，存储了屏幕上每个像素的深度值。

     glutInitWindowSize(,);  //设置窗口的大小

     glutCreateWindow("Triangle");  //创建以“Triangle”为标题的窗口

     //回调函数

     glutReshapeFunc(ChangeSize);  //为窗口改变大小而设置一个回调函数，以便能够设置视点

     glutDisplayFunc(RenderScene);  //注册一个函数以包含OpenGL渲染代码

     //在开始运行主消息循环之前，还要解决两个问题

     GLenum err=glewInit();   //初始化GLEW库。重新调用GLEW库初始化OpenGL驱动程序中所有丢失的入口点，以确保OpenGL API对我们来说完全可用。

     if(GLEW_OK!=err)    //在试图做任何渲染之前，还要检查确定驱动程序的初始化过程中没有出现任何问题。

     {

         fprintf(stderr,"GLEW Error:%s\n",glewGetErrorString(err));

         return ;

     }

     SetupRC();  //调用SetupRC。这里RC代表渲染环境（Rendering Context），这是一个运行中的OpenGL状态机的句柄。在任何OpenGL函数起作用之前必须创建一个渲染环境。

     //开始主消息循环并结束main函数

     glutMainLoop();

     return ;

 }

 GLenum err=glewInit();   //初始化GLEW库。重新调用GLEW库初始化OpenGL驱动程序中所有丢失的入口点，以确保OpenGL API对我们来说完全可用。

     if(GLEW_OK!=err)    //在试图做任何渲染之前，还要检查确定驱动程序的初始化过程中没有出现任何问题。

     {

         fprintf(stderr,"GLEW Error:%s\n",glewGetErrorString(err));

         return ;

     }

 GLfloat vRed[]={1.0f,0.0f,0.0f,1.0f};

 shaderManager.UseStockShader(GLT_SHADER_IDENTITY,vRed);  //UseStockShader函数会选择一个存储着色器并提供这个着色器的Uniform值。

 triangleBatch.Draw();   //指示将几何图形提交到着色器，绘制批次容器所描述的内容。

 //下面代码建立了一个三角形的批次，仅包含3个顶点。

     triangleBatch.Begin(GL_TRIANGLES,);  //批次容器的初始化，告诉这个类它代表哪种图元，其中包括顶点数，以及（可选）一组或两组纹理坐标。

     triangleBatch.CopyVertexData3f(vVerts);  //然后至少复制一个由三分量顶点组成的数组。

     triangleBatch.End();  //表示已经完成了数据复制工作，并且将设置内部标记，以通知这个类包含哪些属性。