【LWJGL官方教程】Introduction 入门

翻译 2015年10月27日 19:11:33

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Introduction

译注:并没有逐字逐句翻译一切,只翻译了自己觉得有用的部分。另外此翻译仅供参考,请一切以原文为准。代码例子文件链接什么的都请去原链接查找。

Initializing the OpenGL context 初始化Opengl context

首先加入error callback,这样你可以看到当GLFW初始化时是否有错。

你需要对LWJGL里任何一个callback都有强引用,由于垃圾回收机制,如果你没有强引用,VM可能会将它回收掉,导致一个ClosureError。所以保证对应每个callback都有一个类变量

回头继续说error callback,用LWJGL提供的Callbacks类里的errorCallbackPrint方法创建一个GLFWErrorCallback。
另一种方法是new出来一个GLFWErrorCallback,然后覆盖它的调用函数。

简单起见,我们就创建一个error callback然后打印System.err.


private GLFWErrorCallback errorCallback = Callbacks.errorCallbackPrint(System.err);

之后设置callback。

glfwSetErrorCallback(errorCallback);

下一步初始化GLFW,用glfwInit()。
if (glfwInit() != GL_TRUE) {
    throw new IllegalStateException("Unable to initialize GLFW");
}
现在GLFW初始化完毕,我们开始创建窗口。
在GLFW里,调用glfwCreateWindow(width, height, title, monitor, share)来创建窗口。在此教程中,我们暂时无视monitor和share。
你也可以设置窗口的hint,比如
GLFW_RESIZABLE或GLFW_VISIBLE,但是这里我们先默认就好。
如果创建失败,方法会返回NULL,在LWJGL里其实就是0,但是最好还是用MemoryUtil里的这个静态常量NULL,这样万一以后版本升级之类的你这也不会崩。但是一般来讲,这方法不会失败,会返回一个窗口的句柄。

long window = glfwCreateWindow(640, 480, "Simple example", NULL, NULL);
if (window == NULL) {
    glfwTerminate();
    throw new RuntimeException("Failed to create the GLFW window");
}

窗口建好,我们再设置些其他的callback,比如key callback。
别忘了要用强引用。创建这个需要覆盖GLFWKeyCallback的调用函数。
以下就是key callback的一个例子,它会检查ESC键是否被按下,按下时它将告诉窗口去关闭自己。

private GLFWKeyCallback keyCallback = new GLFWKeyCallback() {
    @Overridepublic void invoke(long window, int key, int scancode, int action, int mods) {
        if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS) {
            glfwSetWindowShouldClose(window, GL_TRUE);
        }
    }
};

创建key callback后,把它注册在你的窗口上。


glfwSetKeyCallback(window, keyCallback);

窗口创建完后,也可以再创建一个OpenGL context,这是渲染用的。
调用glfwMakeContextCurrent(window)来创建。在LWJGL里,你还必须调GLContext类的createFromCurrent(),这样库才会发现context,使OpenGL绑定成功可用。

glfwMakeContextCurrent(window);
GLContext.createFromCurrent();

现在你有OpenGL context了,可以开始渲染了。


Update and Rendering loop 更新和渲染的循环


我们得使我们的程序一直在运行,直到窗口关闭。所以,写一个简单的while循环。

while (glfwWindowShouldClose(window) != GL_TRUE) {
    /* Do something */
}

GL_TRUE来自GL11类,其实值是1,但是最好用静态常量。
在循环中,你可以任意调用OpenGL来渲染程序,在这个范例里,是一个旋转的三角形。
为了转得正确,我们需要拿到时间。幸运的是GLFW3自带高精度计时器,只需调用glfwGetTime()。它会提供自从glfwInit()调用以来经过的秒数,是double类型的。

double time = glfwGetTime();
Opengl调用完,需要交换颜色缓冲区,因为GLFW使用的是双缓冲机制。调用glfwSwapBuffers(window)做这件事。
另一件事是处理执行事件,比如键盘事件,用
glfwPollEvents()来做。你也可以用glfwWaitEvents(),如果你的程序在你收到新的输入指令之前只做更新的话。

glfwSwapBuffers(window);
glfwPollEvents();
具体内容请参照Introduction.java文件。


Ending the Application 结束程序


当结束程序时,需要释放callback们,销毁窗口,并且中止GLFW,这样所有分配的资源才能释放掉。
首先要销毁窗口,然后释放注册到窗口上的事件callback们,比如键盘事件。

glfwDestroyWindow(window);
keyCallback.release();

销毁窗口并释放callback之类,要中止GLFW,释放error callback。

glfwTerminate();
errorCallback.release();

以上完毕,下一篇学 游戏循环

相关文章推荐

【LWJGL官方教程】总目录

原文:https://github.com/LWJGL/lwjgl3-wiki/wiki/2.6.-Tutorial-Index 译注:慢慢翻译,主要是给自己看的。基础 开始使用LWJGL 入门 ...

【LWJGL2 WIKI】【基础篇】基础1:显示

原文:http://wiki.lwjgl.org/wiki/LWJGL_Basics_1_%28The_Display%29Introduction 介绍LWJGL库使用自带的轻量级本地窗口(即所谓的...

【LWJGL官方教程】游戏逻辑

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Game-logic 译注:并没有逐字逐句翻译一切,只翻译了自己觉得有用的部分。另外此翻...

【LWJGL官方教程】渲染

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Rendering 译注:并没有逐字逐句翻译一切,只翻译了自己觉得有用的部分。另外此翻译...

【LWJGL官方教程】纹理

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Textures 译注:并没有逐字逐句翻译一切,只翻译了自己觉得有用的部分。另外此翻译仅...

j2me游戏开发之LWJGL(Lightweight Java Game Library)

LWJGL(Lightweight Java Game Library)它可以帮助Java程序员开发有着商业性质的游戏.LWJGL为开发者提供简单易用的API来访问OpenGL (Open Graph...

LWJGL教程--- 1.The Display

声明:   本博客文章原创均为个人原创 , 翻译类文章均为个人业余时间翻译,版权所有。转载请注明出处:http://www.wjfxgame.com,另外本人的CSDN博客:http://blog.c...
  • ml3947
  • ml3947
  • 2013年06月29日 18:50
  • 4776

【LWJGL官方教程】Game loops 游戏循环

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Game-loops 译注:翻译仅供参考,请以原文为准。代码请看原文中的链接。括号里的内...

【LWJGL官方教程】Timing 计时

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Timing 译注:翻译仅供参考,请以原文为准。代码请看原文中的链接。括号里的内容一般也...

【LWJGL官方教程】批渲染

原文:https://github.com/SilverTiger/lwjgl3-tutorial/wiki/Batching 译注:并没有逐字逐句翻译一切,只翻译了自己觉得有用的部分。另外此翻译仅...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:【LWJGL官方教程】Introduction 入门
举报原因:
原因补充:

(最多只允许输入30个字)