libgdx 学习笔记四 MyFirstTriangle

Introduction（序言）

上节HelloWorld 教程证明了如何从导入一个已有的项目构造一个libgdx应用程序。让我们进一步从上一节的基础上创建项目。本教程会更详细

假使读者是一个Eclipse的初学者。以后会有更简洁的教程。

本节的源文件包含在MyFirstTriangle_<data>.zip 下载地址： Downloads

Creating the Desktop Project

下载最新的nightly zip 然后解压缩到一个名为libgdx-nightly临时目录。

大部分代码包含所有的游戏逻辑，将放在一个常规的JAVA工程。在Eclipse中 点击File -> New -> Java Project。工程名为my-first-triangle 。

在JRE选项卡中，选择JavaSE-1.6或者类似的，然后点击Finish

让我们复制包含所有必要的 libgdx 类和方法的库文件到我们的工作区。右键my-first-triangle工程 选择New -> Folder，从libgdx-nightly 目录中

复制一下文件到libs中：

gdx-backend-jogl.jar

gdx-backend-jogl-natives.jar

gdx-sources.jar

gdx-natives.jar

gdx.jar

现在我们添加库文件到我们的工程，因此我们的Java代码能用到libgdx 库文件中的类了。右键my-first-triangle工程选择Properties。来到Java Build Path 选项卡，选择Libraries tab, 点击Add JARs...，选择以下文件到我们的my-first-triangle/libs目录中

gdx-backend-jogl.jar

gdx-backend-jogl-natives.jar

gdx-natives.jar

gdx.jar

Eclipse能显示关于libgdx 类和方法的javadoc 文档供你使用。 仍在 Libraries tab，展开gdx.jar列表并 在名为Source attachment双击。点击工作区

选到my-first-triangle/libs 目录，这次选择gdx-sources.jar.

现在我们能创建一个绘制三角形的类。展开my-first-triangle 文件夹，在src source directory 上右键然后选择New -> Package.

随便取个名字，在本例中我们使用 com.test.myfirsttriangle。在一个新package上右键，选择New -> Class。名字为MyFirstTriangle

在Interfaces 字段，add com.badlogic.gdx.ApplicationListener 接口。内容如下：

package com.test.myfirsttriangle;

import com.badlogic.gdx.ApplicationListener;

public class MyFirstTriangle implements ApplicationListener

{

　　@Overridepublic void create()

　　{       // TODO Auto-generated method stub           }           

　　@Overridepublic void dispose()

　　{       // TODO Auto-generated method stub           }            

　　@Override

　　public void pause()

　　{       // TODO Auto-generated method stub           }            

　　@Override

　　public void render()

　　{       // TODO Auto-generated method stub           }            

　　@Override

　　public void resize(int width, int height)

　　{       // TODO Auto-generated method stub           }            

　　@Override

　　public void resume()

　　 {       // TODO Auto-generated method stub           }   

}

不久我们将添加逻辑到MyFirstTriangle 来绘制三角形。它能在桌面或者android环境下运行。让我们创建一个桌面入口点。在同一包中创建另一个类当做MyFirstTriangle类，这次名叫MyFirstTriangleDesktop。在类中加入一个main方法：

package com.test.myfirsttriangle;

import com.badlogic.gdx.backends.jogl.JoglApplication;

public class MyFirstTriangleDesktop

{

　　public static void main (String[] argv)

　　{      

　　　　 new JoglApplication(new MyFirstTriangle(), "My First Triangle", 480, 320, false);

　　}

}

MyFirstTriangleDesktop类给启动桌面应用程序一个入口点 。它由一个JoglApplication创建，通过在MyFirstTriangle类的实例中执行渲染。

在MyFirstTriangleDesktop 类上右键Run As -> Java Application来运行应用。将看到一个空白。

Rendering a Triangle（渲染一个三角形）

这个应用将显示一个空白的屏幕因为我们的MyFirstTriangle类 没有渲染逻辑。现在我们要写绘制三角形的代码了。更新MyFirstTriangle类的内容：

package com.test.myfirsttriangle;

import com.badlogic.gdx.ApplicationListener;

import com.badlogic.gdx.Gdx;

import com.badlogic.gdx.graphics.GL10;

import com.badlogic.gdx.graphics.Mesh;

import com.badlogic.gdx.graphics.VertexAttribute;

import com.badlogic.gdx.graphics.VertexAttributes.Usage;

public class MyFirstTriangle implements ApplicationListener

{

private Mesh mesh;

　　 @Override

　　public void create()

　　{      

　　　　 if (mesh == null)

　　　　{     

　　　　　　mesh = new Mesh(true, 3, 3,  new VertexAttribute(Usage.Position, 3, "a_position"));

　　　　　　mesh.setVertices(new float[] { -0.5f, -0.5f, 0,    0.5f, -0.5f, 0,    0, 0.5f, 0});                            

　　　　　　　 mesh.setIndices(new short[] { 0, 1, 2});                                        

　　　　　}        

　　　}          

　　@Override

　　 public void dispose() {}            

　　@Override

　　public void pause(){}            

　　@Override

　　public void render()

　　{      

　　　　 Gdx.gl.glClear(GL10.GL_COLOR_BUFFER_BIT);

　　　　mesh.render(GL10.GL_TRIANGLES, 0, 3);

　　}          

　　@Override

　　 public void resize(int width, int height) {}            

　　@Overridepublic void resume() {}  

}

运行工程。这个应用将在屏幕中间显示一个白色的三角形



让我们看改变的地方。当surface 被创建时create() 调用 。我们创建一个用来在屏幕上的绘制对象Mesh。它的构造函数有几个参数，但此刻注意VertexAttribute对象。VertexAttribute在构造函数中包含了表示信息的类型和mesh结果。一个mesh可能包含关于对象位置，颜色，纹理或者更多的信息，但此刻我们仅指定位置信息。因为这个mesh是个三角形，它的位置有三个顶点组成，在笛卡尔坐标系中每个顶点又有三个值表示分别是（X,Y,Z）

mesh的三个顶点的位置在(-0.5f, -0.5f, 0), (0.5f, -0.5f, 0), (0, 0.5f, 0). 我们根据顶点的顺序设置mesh的索引，就像在游戏中按顺序连接几个点。

像三角形这样简单的形状，这个顺序没有太大关系因为你连接顶点的顺序无关紧要。如果点很多，顺序将会影响对象完成的形状。

当应用程序每次运行render()方法时。基本上它能在屏幕上尽可能快的重绘。在render()方法中为了渲染它自己我们告诉mesh尽早创建 。我们每次调用

render()也清空屏幕。它通过OpenGL直接绘制。

简单的说，我们跳过许多细节 ，比如怎样根据不同的参数改变方法的行为。我们将在后来的教程中跳过更多的细节。你能简单的从javadoc查阅任一方法

在编辑器中方法名上鼠标悬停。

Setting Up an Android Project

在android测试一个应用程序仅需要在Eclipse中启动一个小的android工程，就是提交到桌我们正好创建的桌面工程。点击 File -> New -> Other

在android选项卡下面，选择 Android Project 然后点击下一步。工程名随意，本例中为 my-first-triangle-android。在Build Target 字段，选择

android平台版本。不同的平台版本关于OpenGL ES有不同的支持，但我们这是一个简单的例子，就选择android 1.5就行了。包名和类名和上面的桌面工程一样分别是 com.test.myfirsttriangle，my-first-triangle-android 。检查创建的Activity 复选框给activity一个名字，我们这里使用MyFirstTriangleAndroid。在Min SDK Version中 1.5对应的level为3.单击完成。

类似桌面应用，我们将复制libgdx 库文件到工作区中，右键 my-first-triangle-android 选择 New -> Folder。名为libs。然后回到libgdx-nightly 目录

复制如下libgdx 库文件复制到我们刚才创建的libs文件夹中：

armeabi/

armeabi-v7a/

gdx-backend-android.jar

gdx.jar

我们将在我们的工程设置中引用这些文件，右键my-first-triangle-android 文件夹，然后选择Properties。在Java Build Path选项卡下方，找到

Libraries tab.点击ADD JARs在my-first-triangle-android/libs 中选择gdx-backend-android.jar 和 gdx.jar。

我们需要引用在先前的工程中的libgdx的类。在Java Build Path界面，找到Projects tab 点击Add... 然后添加my-first-triangle 到我们早先创建的工程

剩余的最后任务是在我们早期写的游戏代码中修改我们的Activity 在Android 的入口点处。找到MyFirstTriangleAndroid 类用一以下内容替代

package com.test.myfirsttriangle;

import android.os.Bundle;

import com.badlogic.gdx.backends.android.AndroidApplication;

public class MyFirstTriangleAndroid extends AndroidApplication

{

　　@Override

　　public void onCreate (Bundle savedInstanceState)

　　{

　　　　super.onCreate(savedInstanceState);

　　　　 initialize(new MyFirstTriangle(), false);

　　}

}

类似我们的桌面入口在MyFirstTirangleDesktop类中，所有代码创建一个MyFirstTriangle 管理渲染过程的实例。在my-first-triangle-android 上右键选择 Run As -> Android Application运行应用程序。它安装在设备或模拟器中。在模拟器载入完成时，应用将自动开始。 效果如下

What's Next（下一步呢）

这是你的第一个三角形。学习更多 关于 libgdx 框架的基础， 请看MeshColorTexture 指南

Updates（更新）

Feb 22 2011

use nightly build （使用nightly编译）

added gdx-backend-jogl-natives.jar to libraries to hopefully remove link errors （添加gdx-backend-jogl-natives.jar到库中希望能移除link 错误）

MyFirstTriangle class is now importing com.badlogic.gdx.Gdx （MyFirstTriangle 类现在由com.badlogic.gdx.Gdx导入）

updated the MyFirstTriangle_<date>.zip source files for this guide (更新MyFirstTriangle_<date>.zip源文件)

added screen shots （添加一个屏幕shoots）