Vision引擎中 Lua 脚本介绍

 

引言
Vision 的 Lua 编辑工具组提供多种节省时间的功能,例如代码完成和预定义代码模板。
 
   重要说明:请注意,我们采用 SWIG 封装 Lua 中的 C++ 类,所以所有对象的行为都类似指针 - 包括向量(Vision.hkvVec3)或颜色(Vision.VColorRef)。 因此,赋值(vector1 = vector2)所修改的是指针而非数据。 在这种情况下,您应当使用 clone() 而非赋值(vector1 = vector2:clone())。 ‘+’、‘-’、‘*’、‘/’等关键字可以放心使用,因为它们会为您生成一个新实例:vector1 = vector2 + vector3
 
代码插入
代码插入图标提供一份传递到 Lua 系统的可用事件类型的列表。 右键单击列表中的某条目,该函数将被放置到您的脚本的末尾。

Vision引擎中 Lua 脚本介绍

例如,选择 OnThink(self) 条目将生成如下 Lua 代码片段:
function OnThink(self)	
 
end
 
自动完成
输入代码时,当您在 Timer 等定义符号后方输入一个圆点或冒号,程序会显示自动完成对话框,包括对象所包含的函数。

Vision引擎中 Lua 脚本介绍

切换脚本编辑器工具栏上的自动完成图标可启用 / 关闭该功能。

Vision引擎中 Lua 脚本介绍

自动完成功能也可手动激活,方法为组合键 CTRL + SPACE,也可用 ESC 键关闭。

Vision引擎中 Lua 脚本介绍

脚本缓存
脚本面板提供在 vForge 中启用 / 关闭脚本缓存的选项。 该选项仅影响编辑器中的行为。 脚本缓存默认为启用状态,也就是说,在每个脚本组件的实例化期间,将使用一份脚本资源的缓存版本(如可用)。 如果脚本缓存被关闭,在每个脚本组件的实例化期间,脚本文件将被检查,脚本资源将被重新载入,以防存在任何更改。 该行为模式的使用案例之一是,如果您在在编辑器中运行模式下也想编辑脚本,并为场景添加使用更新后脚本的脚本组件,则应该关闭缓存。 如果您的工作流不明确要求这一行为模式,请将脚本缓存保留为启用状态,因为其性能更佳(载入有大量脚本组件的场景时速度也更快)。

Lua 帮助
为协助您开发 Lua 脚本,您可以随时打开 Lua Scripting API,方法为选择脚本编辑工具栏中的 Lua 帮助图标,或按 F1 键:

Vision引擎中 Lua 脚本介绍

该图标会打开一份标准帮助文档,全面涵盖 Vision Lua 类,另有使用中的命令的简单示例。
 
   提示:如果您想获得有关某个具体命令的帮助,例如”OnCreate”、”SetPosition”等等,只需在脚本编辑器中选择文本并按 F1 键,帮助程序会立刻为您搜索关键词。

Vision引擎中 Lua 脚本介绍

Vision Lua 101
ScriptingAPI CHM 对于所有脚本命令都是一份宝贵的资源,但为帮助您在 Lua 学习过程中入门,有一些简单的命令和规则需要了解:
 
  信息:示例项目中有一份脚本示例:<VisionSDK>/Data/Vision/Samples/Engine/Scripting/LuaScripting.project
 
Self
self 变量用于引用该脚本所附的实体。 对于某个实体类型,我们可以使用如下脚本行。
 
self:SetMesh("Models\\Warrior\\Warrior.model")
self:SetScaling(2)
这个小示例会把实体模型文件设给 Warrior,并将其统一缩放增加到 2。
 
调试打印
如果您需要测试变量内容或仅插入简单的追踪,打印到屏幕是快捷而简单的反馈方法。 您可使用如下命令:
Debug:PrintLine("Hello World")
请使用双点技巧在 PrintLine 函数方法中合并字符串。
local numProps = self:GetNumProperties();
Debug:PrintLine("The entity has " .. numProps .. " prop(s)")
当您需要打印某个矢量的内容,请使用 tostring(var) 函数方法。
Debug:PrintLine("Setting a new property value...")
self:SetProperty("myProp", Vision.hkvVec3(1.2, 2.3, 3.4));
propVal = self:GetProperty("myProp");
Debug:PrintLine("The entity's new property value is: " .. tostring(propVal))	
时间增量
为确保运动在不同帧率下保持恒速,您可以将速度因数乘以时间增量。 当前时间增量(从上次调用至今的时间)可从 Timer:GetTimeDiff() 函数方法返回。
function OnThink(self)
    -- rotate entity over time
    local t = Timer:GetTimeDiff()
    self:IncOrientation(t*10, 0, 0)
end

转自:project anarchy中文社区

你可能感兴趣的:(visio)