组件 - Lua 脚本

如需为某图形添加 Lua 脚本文件，您可以定义一个新文件，也可附加一个已有脚本文件。 可以为一个对象附加多个 Lua 组件，从而创造出更复杂的行为。 例如，可以将 LookAt  脚本和  PlaySoundOnFootStep  脚本配合起来使用。



重要说明： 请注意，我们采用 SWIG 封装 Lua 中的 C++ 类，所以所有对象的行为都类似指针 - 包括向量（Vision.hkvVec3）或颜色（Vision.VColorRef）。 因此，赋值（vector1 = vector2）所修改的是指针而非数据。 在这种情况下，您应当使用 clone() 而非赋值（vector1 = vector2:clone()）。 ‘+’、‘-’、‘*’、‘/’等关键字可以放心使用，因为它们会为您生成一个新实例：vector1 = vector2 + vector3



附件图形类型


该组件可附加到以下任何图形类型上：


类型

实体

粒子组

触发框

光照

路径

几何网格

VDialog（V 对话框）

VWindowBase（V 窗口基底）

声音

任意 3D 对象（布对象、立方体贴图、镜面、投射器、体积锥体、水体、路径镜头……）


属性


以下是与 Lua 脚本组件有关的属性：



1、ComponentID（组件 ID）： 可选组件名称，用于在附加组件中标识该组件。



2、ScriptFile（脚本文件）：



     提示：



如脚本编辑器视图已打开，对现有 Lua 文件选择编辑会将该文件载入到脚本编辑器中。


自定义属性


如果 Lua 脚本有 OnExpose 回调，则会显示附加的自定义属性。 该回调允许您为每个实例分别指定值。



以下 Lua 脚本示例设置了 3 个自定义变量： 


function OnExpose(self)
 	  self.HitPoints = 100                   --This value will be exposed to vForge with a default value of 100
  	  self.Weapon = "Sword"                  --So you can customize such values per instance without further modifications
  	  self.SpawnPoint = Vision.hkvVec3(104,38,10)
	end


这 3 个变量会作为脚本组件的附加属性出现，并带有代码编写的默认值。 您可以为每个具体实例编辑这些值而无需更改 Lua 脚本。


OnExpose 回调支持以下数据类型：



     基本 Lua 类型：



     基本 Vision 类型：hkvVec3、hkvMat3、VBitmask、VColorRef


提示： 当使用‘nil’（空类型）为默认值时，您可以指定任意数量的 Lua 代码为具体实例的值。 请确保代码使用正确的 Lua 语法！


组件 - 跟随路径


跟随路径组件可附加到任何 3D 对象上，在“运行游戏”模式下，或者“在编辑器中运行”已启动时，该对象会跟随一个指定了路径键名的路径图形移动。



附件图形类型


该组件可附加到以下任何图形类型上：



  • 实体
  • 所有约束
  • Vision 布对象
  • 立方体贴图
  • 体积锥体
  • 水体
  • 预建体
  • 平行光照 - 静态和动态
  • 点光照 / 全局光照 - 静态和动态
  • 聚光灯 - 静态和动态
  • 镜头位置
  • 路径 - 曲线和直线
  • 路径镜头
  • 触发框
  • 所有声音图形
  • 可视性对象


属性


以下是与跟随路径组件有关的属性



Component ID（组件 ID）：

Path Key（路径键名）：

Time（时间）：

Initial Offset（初始补偿）：

Looped（循环）：

Direction（指向）：

Position Offset（位置补偿）：

Orientation Offset（朝向补偿）：