《Lua游戏AI开发指南》一2.7创建一个沙箱Lua脚本

本节书摘来异步社区《Lua游戏AI开发指南》一书中的第2章&＃xff0c;第2.7节&＃xff0c;作者&＃xff1a; 【美】David Young&＃xff08;杨&＃xff09; 译者&＃xff1a; 王磊 责编&＃xff1a; 陈冀康&＃xff0c;更多章节内容可以访问云栖社区“异步社区”公众号查看。

2.7　创建一个沙箱Lua脚本

基本的沙箱程序就位之后&＃xff0c;我们就可以新建沙箱的创建Lua脚本了。首先在脚本文件夹中新建一个Sandbox.lua脚本。

像下面这样创建一个Lua文件&＃xff1a;

src/my_sandbox/script/Sandbox.lua


沙箱Lua脚本必须实现4个全局函数供C&＃43;&＃43;代码调用&＃xff0c;它们分别是Sandbox_Cleanup、 Sandbox_HandleEvent、 Sandbox_Initialize和Sandbox_Update:

Sandbox.lua:function Sandbox_Cleanup(sandbox) endfunction Sandbox_HandleEvent(sandbox, event) endfunction Sandbox_Initialize(sandbox) endfunction Sandbox_Update(sandbox, deltaTimeInMillis) end


有了这些基础的回调函数&＃xff0c;就可以修改SandboxApplication类的Lua代码来创建沙箱了。

MySandbox.cpp:void MySandbox::Initialize() { SandboxApplication::Initialize();...CreateSandbox("Sandbox.lua");}


在修改任何C&＃43;&＃43;文件之后&＃xff0c;别忘了重新编译沙箱应用程序。

2.7.1　创建地板

现在沙箱已经初始化好并且连接到了Lua脚本&＃xff0c;可以开始添加一些基本的几何体和光照了。沙箱暴露给Lua的函数中有一个CreatePlane函数&＃xff0c;它可以根据指定的宽度和高度创建一个平面网格&＃xff0c;还会相应地创建一个物理半空间并添加到物理模拟中。

一个物理半空间是一个在x和z方向上无限延伸的平面。

创建好平面对象后&＃xff0c;我们可以使用Core.SetMaterial函数来为它设置一个Ogre材质。这个材质在media/materials/base.material中定义。

沙箱已经可以处理标准的漫发射、高光和法线贴图材质类型。还可以在media/materials/ base.material文件中添加新的材质。

在示例中&＃xff0c;我们给新创建的平面赋予了名为Ground2的Ogre材质。

Sandbox.lua:function Sandbox_Initialize(sandbox)local plane &＃61; Sandbox.CreatePlane(sandbox, 200, 200);Core.SetMaterial(plane, "Ground2");end


如果现在运行沙箱&＃xff0c;你可能期待看到刚刚创建的平面&＃xff0c;但实际上只会看到一个全黑的屏幕。沙箱中如果没有光照&＃xff0c;即使创建了平面&＃xff0c;你也看不到它。

2.7.2　添加光源

沙箱中没有光照的话&＃xff0c;我们的平面是看不到的。沙箱的核心包提供了函数来创建灯光并设置其漫发射和高光颜色。Core.CreateDirectionalLight函数需要两个参数&＃xff1a;沙箱和光照方向向量。使用(1&＃xff0c;-1&＃xff0c;1)向量可以创建一个向斜下方照射的光源。

Sandbox.lua:function Sandbox_Initialize(sandbox)...local directional &＃61; Core.CreateDirectionalLight( sandbox, Vector.new(1, -1, 1));--- Color is represented by a red, green, and blue vector. Core.SetLightDiffuse(directional, Vector.new(1.8, 1.4, 0.9)); Core.SetLightSpecular(directional, Vector.new(1.8, 1.4, 0.9));end


注意在使用Vector.new(red,green,blue)函数设置光源漫反射和高光时&＃xff0c;颜色值是大于1的。这使你可以调整发射光的强度。

现在我们有了一个光源&＃xff0c;可以运行沙箱来查看之前创建的平面了。使用鼠标可以调整相机的朝向&＃xff0c;只需要按住鼠标右键并拖动鼠标到想要朝向的方向。也可以使用键盘的W、A、S和D键来控制相机在沙箱中漫游。在按下W、A、S和D键的同时按住Shift键&＃xff0c;则可以大幅加快相机的移动速度。

2.7.3　添加天空盒

看着无尽的黑暗不是一件有趣的事情。我们可以用Sandbox.CreateSkyBox函数来创建一个天空盒。天空盒是由在Ogre材质media/materials/skybox.material中指定的6张纹理来定义的。如果你还不知道天空盒是什么的话&＃xff0c;可以认为天空盒就是一个有6 个面的盒子&＃xff0c;每个面上都有一张不同的纹理。当相机在沙箱中移动时&＃xff0c;天空盒也会跟着移动&＃xff0c;让它看上去就像真实的天空一样。

沙箱有多个天空盒材质。你可以在任意的文本编辑器中查看skybox.material文件&＃xff0c;以了解其他可用的天空盒纹理&＃xff0c;以及如何创建全新的天空盒材质。

Sandbox.CreateSkyBox函数需要传入3个参数&＃xff1a;沙箱本身、Ogre材质名和旋转向量。旋转向量的单位是角度&＃xff0c;它的作用是在我们的天空盒上添加一个初始化的偏移量。在我们的例子中&＃xff0c;我们把天空盒旋转180度来配合之前创建的方向光源&＃xff1a;

Sandbox.lua:function Sandbox_Initialize(sandbox)...Sandbox.CreateSkyBox(sandbox,"ThickCloudsWaterSkyBox",Vector.new(0, 180, 0));end


现在运行沙箱&＃xff0c;你会看到一个飘着云朵的天空和明亮的世界&＃xff0c;如图2-2所示。

2.7.4　在沙箱中添加网格

Ogre网格在沙箱中只是一个可见的几何体&＃xff0c;不包含任何物理表现。在沙箱中添加一个Ogre网格只需要调用Core.CreateMesh函数&＃xff0c;传入Ogre网格文件的路径和名称。

分别使用Core.SetPosition和Core.SetRotation函数设置网格的位置和旋转&＃xff1a;

Sandbox.lua:function Sandbox_Initialize(sandbox)...local mesh &＃61; Core.CreateMesh(sandbox, "models/nobiax_modular/modular_block.mesh"); Core.SetPosition(mesh, Vector.new(0, 1, 0)); Core.SetRotation(mesh, Vector.new(0, 45, 0));end


旋转函数的参数是一个角度向量&＃xff0c;单位是度。例如&＃xff0c;Vector.new(0,45,0)将让网格绕y轴旋转45度。

2.7.5　创建沙箱对象

如果你想让一个Ogre网格参与物理模拟&＃xff0c;可以创建一个沙箱对象。Sandbox.Create Object函数会为任何的Ogre网格生成一个凸包&＃xff0c;并让它参与物理模拟。

由于为任意网格生成物理表现是在运行时进行的&＃xff0c;复杂的网格会延长沙箱的加载时间。在内部实现中&＃xff0c;bullet物理引擎会生成一个简化的近似Ogre网格的凸包网格&＃xff0c;这两个网格的顶点不是一一对应的。要记住&＃xff0c;任何Ogre网格的物理表现都只是对原网格的近似而不是精确的复制。

现在&＃xff0c;我们可以把之前创建的方块网格转换为真正的物理模拟对象了。

Sandbox.lua:function Sandbox_Initialize(sandbox)...local object &＃61; Sandbox.CreateObject(sandbox, "models/nobiax_modular/modular_block.mesh"); -- Set the mass of the block in kilograms.Core.SetMass(object, 15);Core.SetPosition(object, Vector.new(0, 1, 0));Core.SetRotation (object, Vector.new(0, 45, 0));end