1
0
mirror of https://github.com/LearnOpenGL-CN/LearnOpenGL-CN.git synced 2025-08-23 12:45:29 +08:00

校对 01/01 到 01/04

This commit is contained in:
Geequlim
2015-07-26 21:31:06 +08:00
parent 71c6e392c4
commit ed925f7f7f
5 changed files with 179 additions and 155 deletions

View File

@@ -1,8 +1,13 @@
本文作者JoeyDeVries由Geequlim翻译自[http://learnopengl.com](http://learnopengl.com/#!Getting-started/Hello-Window)
## 你好,窗口
##你好,窗口
原文 | [Hello Window](http://learnopengl.com/#!Getting-started/Hello-Window)
---|---
作者 | JoeyDeVries
翻译 | Geequlim
校对 | Geequlim
上一节中我们获取到了GLFW和GLEW这两个开源库现在我们就可以使用它们来创建一个OpenGL绘图窗口了。首先新建一个 .cpp文件然后把下面的代码粘贴到该文件的最前面。注意之所以定义GLEW_STATIC宏是因为我们使用GLEW的静态链接库。
上一节中我们获取并编译了GLFW和GLEW这两个开源库现在我们就可以使用它们来创建一个OpenGL绘图窗口了。首先新建一个 .cpp文件然后把下面的代码粘贴到该文件的最前面。注意之所以定义GLEW_STATIC宏是因为我们使用GLEW的静态链接库。
```c++
// GLEW
@@ -11,6 +16,7 @@
// GLFW
#include <GLFW/glfw3.h>
```
!!! Attention
请确认在包含GLFW的头文件之前包含了GLEW的头文件。在包含glew.h头文件时会引入许多OpenGL必要的头文件例如GL/gl.h所以#include <GL/glew.h>应放在引入其他头文件的代码之前。
@@ -30,19 +36,19 @@ int main()
}
```
首先我们在main函数中调用glfwInit函数来初始化GLFW然后我们可以使用glfwWindowHint函数来配置GLFW。glfwWindowHint函数的第一个参数表示我们要进行什么样的配置我们可以选择大量以“GLFW\_”开头的枚举值第二个参数接受一个整形用来设置这个配置的值。该函数的所有的选项以及对应的值都可以在 [GLFW's window handling](http://www.glfw.org/docs/latest/window.html#window_hints) 这篇文档中找到。如果你现在编译你的cpp文件会得到大量的连接错误这是因为你还需要设置GLFW的链接库
首先我们在main函数中调用glfwInit函数来初始化GLFW然后我们可以使用glfwWindowHint函数来配置GLFW。glfwWindowHint函数的第一个参数表示我们要进行什么样的配置我们可以选择大量以“GLFW\_”开头的枚举值第二个参数接受一个整形用来设置这个配置的值。该函数的所有的选项以及对应的值都可以在 [GLFW's window handling](http://www.glfw.org/docs/latest/window.html#window_hints) 这篇文档中找到。如果你现在编译你的cpp文件会得到大量的连接错误这是因为你还需要进一步设置GLFW。
由于本站的教程都是基于OpenGL3.3以后的版本展开讨论的所以我们需要告诉GLFW我们要使用的OpenGL版本是3.3这样GLFW会在创建OpenGL上下文时做出适当的调整。这也可以确保用户在没有适当的OpenGL版本支持的情况下无法运行。在这里我们告诉GLFW想要的OpenGL版本号是3.3并且不允许用户调整窗口的大小。我们明确地告诉GLFW我们想要使用核心模式core-profile这将导致我们无法使用那些已经废弃的API而这不正是一个很好的提醒吗当我们不小心用了旧功能时报错就能避免使用一些被废弃的用法了。如果你使用的是Mac OSX系统你还需要加下面这行代码这些配置才能起作用
由于本站的教程都是基于OpenGL3.3以后的版本展开讨论的所以我们需要告诉GLFW我们要使用的OpenGL版本是3.3这样GLFW会在创建OpenGL上下文时做出适当的调整。这也可以确保用户在没有适当的OpenGL版本支持的情况下无法运行。在这里我们告诉GLFW想要的OpenGL版本号是3.3并且不允许用户调整窗口的大小。我们明确地告诉GLFW我们想要使用核心模式core-profile这将导致我们无法使用那些已经废弃的API而这不正是一个很好的提醒吗当我们不小心用了旧功能时报错就能避免使用一些被废弃的用法了。如果你使用的是Mac OSX系统你还需要加下面这行代码这些配置才能起作用
```c++
glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);
glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);
```
!!! Important
请确认您的系统支持OpenGL3.3或更高版本否则此应用有可能会崩溃或者出现不可预知的错误。可以通过运行glew附带的glxinfo程序或者其他的工具例如[OpenGL Extension Viewer ](http://download.cnet.com/OpenGL-Extensions-Viewer/3000-18487_4-34442.html)来查看的OpenGL版本。如果的OpenGL版本低于3.3请更新的驱动程序或者有必要的话更新您的设备。
请确认您的系统支持OpenGL3.3或更高版本否则此应用有可能会崩溃或者出现不可预知的错误。可以通过运行glew附带的glxinfo程序或者其他的工具例如[OpenGL Extension Viewer ](http://download.cnet.com/OpenGL-Extensions-Viewer/3000-18487_4-34442.html)来查看的OpenGL版本。如果的OpenGL版本低于3.3请更新的驱动程序或者有必要的话更新设备。
接下来我们创建一个窗口对象,这个窗口对象中具有和窗口相关的许多数据而且会被GLFW的其他函数频繁地用到。
接下来我们创建一个窗口对象这个窗口对象中具有和窗口相关的许多数据而且会被GLFW的其他函数频繁地用到。
```c++
GLFWwindow* window = glfwCreateWindow(800, 600, "LearnOpenGL", nullptr, nullptr);
@@ -58,7 +64,7 @@ glfwMakeContextCurrent(window);
glfwCreateWindow函数需要窗口的宽和高作为它的前两个参数第三个参数表示只这个窗口的名称标题这里我们使用"LearnOpenGL"当然你可以使用你喜欢的名称最后两个参数我们暂时忽略先置为空指针就行。它的返回值GLFWwindow对象的指针会在其他的GLFW操作中使用到。创建完窗口我们就可以通知GLFW给我们的窗口在当前的线程中创建我们等待已久的OpenGL上下文了。
###GLEW
### 初始化GLEW
在之前的教程中已经提到过GLEW是用来管理OpenGL的函数指针的所以在调用任何OpenGL的函数之前我们需要初始化GLEW。
@@ -70,9 +76,10 @@ if (glewInit() != GLEW_OK)
return -1;
}
```
请注意我们在初始化GLEW之前设置glewExperimental变量的值为GL_TRUE这样做能让GLEW在管理OpenGL的函数指针时更多地使用现代化的技术如果把它设置为GL_FALSE的话可能会在使用OpenGL的核心模式core-profile时出现一些问题。
###视口Viewport
请注意我们在初始化GLEW之前设置glewExperimental变量的值为GL\_TRUE这样做能让GLEW在管理OpenGL的函数指针时更多地使用现代化的技术如果把它设置为GL\_FALSE的话可能会在使用OpenGL的核心模式core-profile时出现一些问题。
### 视口Viewport
在我们绘制之前还有一件重要的事情要做我们必须告诉OpenGL渲染窗口的尺寸大小这样OpenGL才只能知道要显示数据的窗口坐标。我们可以通过调用glViewport函数来设置这些维度
@@ -85,7 +92,7 @@ glViewport(0, 0, 800, 600);
OpenGL 使用glViewport定义的位置和宽高进行位置坐标的转换将OpenGL中的位置坐标转换为你的屏幕坐标。例如OpenGL中的坐标(0.5,0.5)有可能被转换为屏幕中的坐标(200,450)。注意OpenGL只会把-1到1之间的坐标转换为屏幕坐标因此在此例中(-11)转换为屏幕坐标是0,600
###准备好你的引擎
### 准备好你的引擎
我们可不希望只绘制一个图像之后我们的应用程序就关闭窗口并立即退出。我们希望程序在我们明确地关闭它之前一直保持运行状态并能够接受用户输入。因此我们需要在程序中添加一个while循环我们可以把它称之为游戏循环game loop这样我们的程序就能在我们让GLFW退出前保持运行了。下面几行的代码就实现了一个简单的游戏循环
@@ -106,9 +113,9 @@ while(!glfwWindowShouldClose(window))
**双缓冲区**
应用程序使用单缓冲区绘图可能会存在图像闪烁的问题。 这是因为生成的图像不是一下子被绘制出来的,而是按照从左到右,由上而下逐像素地绘制而成的。因为这些不是在瞬间显示给用户,而是通过一步一步地计算结果绘制的,这可能会花费一些时间。为了规避这些问题,我们应用双缓冲区渲染窗口应用程序。前面的缓冲区保存着计算后可显示给用户的图像,被显示到屏幕上;所有的的渲染命令被传递到后台的缓冲区进行计算。当所有的渲染命令执行结束后,我们交换前台缓冲和后台缓冲,这样图像就立即呈显出来,之后清空缓冲区。
应用程序使用单缓冲区绘图可能会存在图像闪烁的问题。 这是因为生成的图像不是一下子被绘制出来的,而是按照从左到右,由上而下逐像素地绘制而成的。最终图像不是在瞬间显示给用户,而是通过一步一步地计算结果绘制的,这可能会花费一些时间。为了规避这些问题,我们应用双缓冲区渲染窗口应用程序。前面的缓冲区保存着计算后可显示给用户的图像,被显示到屏幕上;所有的的渲染命令被传递到后台的缓冲区进行计算。当所有的渲染命令执行结束后,我们交换前台缓冲和后台缓冲,这样图像就立即呈显出来,之后清空缓冲区。
###最后一件事
### 最后一件事
当游戏循环结束后我们需要释放之前的操作分配的资源我们可以在main函数的最后调用glfwTerminate函数来释放GLFW分配的内存。
@@ -123,15 +130,17 @@ return 0;
如果你没有编译通过或者有什么问题的话,首先请检查你程序的的链接选项是否正确
。然后对比本教程的代码,检查你的代码是不是哪里写错了,你也可以[点击这里](http://learnopengl.com/code_viewer.php?code=getting-started/hellowindow)获取我的完整代码。
###输入
### 输入
我们可以通过多种用户输入来控制GLFW这是通过设置GLFW的回调函数来实现的。回调函数事实上是一个函数指针当我们为GLFW设置回调函数后GLWF会在恰当的时候调用它。按键回调KeyCallback是众多回调函数中的一种当我们为GLFW设置按键回调之后GLFW会在用户有键盘交互时调用它。该回调函数的原型如下所示
```c++
void key_callback(GLFWwindow* window, int key, int scancode, int action, int mode);
```
按键回调函数接受一个GLFWwindow指针作为它的第一个参数第二个整形参数用来表示事件的按键第三个整形参数描述用户是否有第二个键按下或释放第四个整形参数表示事件类型如按下或释放最后一个参数是表示是否有Ctrl、Shift等按钮的操作。GLFW会在恰当的时候调用它并为各个参数传入适当的值。
```c++
void key_callback(GLFWwindow* window, int key, int scancode, int action, int mode)
{
@@ -141,6 +150,7 @@ void key_callback(GLFWwindow* window, int key, int scancode, int action, int mod
glfwSetWindowShouldClose(window, GL_TRUE);
}
```
当用户按下ESC键时我们设置窗口的WindowShouldClose(窗口是否应该被关闭)属性的值为真。当执行下一次游戏循环时glfwWindowShouldClose(window)返回真,此时游戏循环便不再继续,然后释放资源结束程序。
最后我们还要为GLFW注册这个按键回调函数这样它才能被GLFW在触发按键事件时被调用。
@@ -148,9 +158,11 @@ void key_callback(GLFWwindow* window, int key, int scancode, int action, int mod
```c++
glfwSetKeyCallback(window, key_callback);
```
除了按键回调函数之外我们还能为GLFW注册其他的回调函数。例如我们可以注册一个函数来处理窗口尺寸变化、处理一些错误信息等。我们可以在创建窗口之后到开始游戏循环之前注册各种回调函数。
###渲染
### 渲染
我们要把所有的渲染操作放到游戏循环中,因为我们想让这些渲染操作在每次游戏循环迭代的时候都能被执行。我们将做如下的操作:
@@ -168,6 +180,7 @@ while(!glfwWindowShouldClose(window))
glfwSwapBuffers(window);
}
```
为了测试一切都正常我们想让屏幕清空为一种我们选择的颜色。在每次执行新的渲染之前我们都希望清除上一次循环的渲染结果除非我们想要看到上一次的结果。我们可以通过调用glClear函数来清空屏幕缓冲区的颜色他接受一个整形常量参数来指定要清空的缓冲区这个常量可以是GL_COLOR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT和 GL_STENCIL_BUFFER_BIT。由于现在我们只关心颜色值所以我们只清空颜色缓冲区。
```c++
@@ -178,10 +191,10 @@ glClear(GL_COLOR_BUFFER_BIT);
!!! Important
你应该能够想起来我们在 [OpenGL]() 教程的内容, glClearColor函数是一个状态设置函数而glClear函数则是一个状态应用的函数。
你应该能够想起来我们在 [OpenGL](http://learnopengl-cn.readthedocs.org/zh/latest/01%20Getting%20started/01%20OpenGL/) 教程的内容, glClearColor函数是一个状态设置函数而glClear函数则是一个状态应用的函数。
![](http://learnopengl.com/img/getting-started/hellowindow2.png)
此程序的完整源代码可以在[这里](http://learnopengl.com/code_viewer.php?code=getting-started/hellowindow2)找到。
好了,到目前为止我们已经做好开始在游戏循环中添加许多渲染操作的准备了,我认为我们的闲扯已经够多了,从[设置:::::下一篇教程](http://www.learnopengl.com/#!Getting-started/Hello-Triangle)开始我们将真正的征程
好了,到目前为止我们已经做好开始在游戏循环中添加许多渲染操作的准备了,我认为我们的闲扯已经够多了,从下一篇教程开始我们将真正的征程