模型

配置项

名称类型必填说明
类型 文本true固定值：模型 表示这是一个模型组件
名称 文本true节点中唯一标识
x 整数false默认显示坐标x
y 整数false默认显示坐标y
模型 文本/整数false文本型:素材标识 整数型:0:小人,1:小树,2:小猪
动作 文本false默认播放的动作
颜色 RGBAfalse模型的颜色
亮度 小数false模型的亮度，默认值为0。越大越亮,越小越暗。取值范围：-1 - 1。
缩放 小数false模型整体缩放倍率 (1.0=原始大小)
阴影效果 整数false0:无阴影, 1:圆形 , 2:实时投影
水平角度 数值falseX轴的旋转角度 0-360
播放速度 小数false模型动作播放速度，默认值为1。越大播放速度越快,负数表示反向播放。
播放模式 整数false0:播放1次, 1:循环播放 , 2:往返循环播放
镜头距离 小数false设置摄像机距离 (默认 1.0=原始大小, >1 放大/<1 缩小)
镜头角度 数值false设置摄像机角度 (度, 默认 ~26.565°=2:1等距, 45°=更俯, 90°=纯俯视)
影子透明 小数false设置影子透明度 (0=完全透明/消失, 1=完全不透明, 默认 0.35)
默认可视 逻辑false默认是否显示
气泡提示 文本false
气泡皮肤 文本false
鼠标事件 逻辑false是否接收鼠标事件
载入完成 functionfalse模型加载完成后触发 回调参数[当前对象]
{
  名称 = "模型1",
  类型 = "模型",
  默认可视 = true,
  x = 100,
  y = 200,
  模型 = "棕狼",
  动作 = "Stand - 2",
  缩放 = 1.5,
  水平角度 = 45 * 2,
  播放模式 = 1,
  鼠标事件 = true, 
  载入完成 = function(对象)
    调试输出(对象.模型信息)
  end
},

属性

可视

  • 类型：逻辑
  • 说明：是否显示组件

名称

  • 类型：文本
  • 读写：只读
  • 说明：组件的名称。

类型

  • 类型：文本
  • 读写：只读
  • 说明：组件的类型。

x

  • 类型：整数
  • 读写：读写
  • 说明：组件的x坐标。

y

  • 类型：整数
  • 读写：读写
  • 说明：组件的y坐标。

颜色

  • 类型：整数
  • 读写：读写
  • 说明：模型的颜色

亮度

  • 类型：小数
  • 读写：读写
  • 说明：模型的亮度，默认值为0。越大越亮,越小越暗。取值范围：-1 - 1。

阴影效果

  • 类型：整数
  • 读写：读写
  • 说明：0:无阴影, 1:圆形 , 2:实时投影

缩放

  • 类型：小数
  • 读写：读写
  • 说明：模型整体缩放倍率 (1.0=原始大小)

水平缩放

  • 类型：小数
  • 读写：读写
  • 说明：设置模型水平缩放倍率 (1.0=原始大小)

垂直缩放

  • 类型：小数
  • 读写：读写
  • 说明：设置模型垂直缩放倍率 (1.0=原始大小)

镜头角度

  • 类型：数值
  • 读写：读写
  • 说明：设置摄像机角度 (度, 默认 ~26.565°=2:1等距, 45°=更俯, 90°=纯俯视)

镜头距离

  • 类型：小数
  • 读写：读写
  • 说明：设置摄像机距离 (默认 1.0 = 原始大小, >1 放大/<1 缩小)

影子透明

  • 类型：小数
  • 读写：读写
  • 说明：设置影子透明度 (0=完全透明/消失, 1=完全不透明, 默认 0.35)

播放速度

  • 类型：小数
  • 读写：读写
  • 说明：模型动作播放速度，默认值为1。越大播放速度越快,负数表示反向播放。

播放模式

  • 类型：整数
  • 读写：读写
  • 说明：0:播放1次, 1:循环播放 , 2:往返循环播放。

播放状态

  • 类型：整数
  • 读写：只读
  • 说明：0:已结束/已停止, 1:播放中 , 2:暂停中。

水平角度

  • 类型：数值
  • 读写：读写
  • 说明：X轴的旋转角度 0-360

模型信息

  • 类型：table {}
  • 读写：只读
  • 说明：动画模型中的信息
名称类型说明
顶点整数模型中的顶点数量
三角形整数模型中的三角形数量
图元整数模型中的图元数量 每次渲染drawcall次数
动作table { {名称,时长}, {名称,时长}, ...}模型中的所有animation
网格table {}模型中的所有mesh
骨骼table { {名称,路径}, {名称,路径}, ...}模型中的所有bone
调试输出(模型1.模型信息)

骨骼信息

  • 类型：table {kv}
  • 读写：只读
  • 说明：将模型信息中的骨骼信息转换为键值对格式方便获取。
调试输出(模型1.骨骼信息["OverHead Ref  Ref"])
调试输出(模型1.骨骼信息)

模型

  • 类型：文本/整数
  • 读写：读写
  • 说明：改变模型素材,文本型:素材标识 整数型:0:小人,1:小树,2:小猪。
模型1.模型 = math.random(0,2)

动作

  • 类型：文本
  • 读写：读写
  • 说明：改变模型当前播放的动作。
模型1.播放模式 = 0
模型1.动作 = "attack"

透明度

  • 类型：小数
  • 读写：读写
  • 说明：取值范围 0-1

气泡提示

  • 类型：文本
  • 读写：读写
  • 说明：读写气泡提示。

鼠标焦点

  • 类型：逻辑
  • 读写：只读
  • 说明：组件当前是否有鼠标焦点。

鼠标坐标

  • 类型：table {x,y}
  • 读写：只读
  • 说明：组件当前的鼠标坐标。

次序

  • 类型：数值
  • 读写：读写
  • 说明：动态改变节点的显示顺序，值越大越先显示。

方法

网格染色

网格染色
设置指定网格(Mesh)的染色。
参数名称值的类型是否必填说明描述
网格名称 文本true网格的名称。与模型mesh名称一致,可以通过属性[模型信息]获取。
颜色 RGBAtrue网格的颜色。

示例

模型1.网格染色("1 HeroArchMage",RGBA(math.random(0,255),math.random(0,255),math.random(0,255),255))

网格可视

网格可视
说明：设置或者取回网格(mesh)可见状态。
参数名称值的类型是否必填说明描述
网格名称 文本true网格的名称。与模型mesh名称一致,可以通过属性[模型信息]获取。
可视 逻辑false网格是否可见。 nil表示取回

示例

模型1.网格可视("1 Footman",not (模型1.网格可视("1 Footman")))
返回值值的类型说明描述
是否可视 逻辑网格是否可见。

注意事项
1、可视为nil时,取回当前网格的可视状态。

设置平行光

设置平行光
设置为方向光 (如太阳, 平行光线)。
参数名称值的类型是否必填说明描述
角度 数值true方位角 0°~360° (光来的水平方向)
仰角 数值false仰角 1°~90° (90°=正午头顶/影子最短, 越低影子越长)

示例

模型1.设置平行光(45,80)

注意事项
1、平行光和点光源同时只存在一个。

设置点光源

设置点光源
设置为2D点光源 (如火把/灯泡, 不同位置的模型影子不同)。
参数名称值的类型是否必填说明描述
x 数值true光源坐标
y 数值true
高度 数值false光源距地面高度 (越大影子越短)

示例

模型1.设置点光源(400,100,150)

注意事项
1、平行光和点光源同时只存在一个。

取骨骼坐标

取骨骼坐标
获取指定骨骼的屏幕坐标。
参数名称值的类型是否必填说明描述
骨骼名称 文本true骨骼的名称。与模型bone名称一致,可以通过属性[模型信息]获取。

示例

local x, y = 模型1.取骨骼坐标("OverHead Ref  Ref")
调试输出(x, y)
返回值值的类型说明描述
x 数值x偏移
y 数值y偏移

注意事项
1、x,y是相对于模型框坐标的偏移量。

闪烁

闪烁
说明：播放闪烁效果。
参数名称值的类型是否必填说明描述
颜色值 RGBAtrue
持续时间 整数false单位：毫秒 默认：100
闪烁间隔 整数false单位：毫秒 默认：50

示例

模型1.闪烁(RGBA(170,170,170,170))

溶解

溶解
说明：播放溶解效果。
参数名称值的类型是否必填说明描述
溶解强度 小数true0-1,默认1,-1表示取消溶解状态
溶解颜色 RGBAfalse

示例

模型.溶解(1,RGBA(255,255,0,255))

模型.溶解(-1) -- 恢复显示

销毁

销毁
说明：销毁当前组件。

示例

本次焦点.销毁()