# 索引


# 通用

接口
描述
DestroyEntity 客户端 销毁特效

# 文字面板

接口
描述
CreateTextBoardInWorld 客户端 创建文字面板
RemoveTextBoard 客户端 删除文字面板
SetBoardBackgroundColor 客户端 修改背景颜色
SetBoardBindEntity 客户端 文字面板绑定实体对象
SetBoardDepthTest 客户端 设置是否开启深度测试, 默认状态下是开启
SetBoardFaceCamera 客户端 设置文字面板的朝向
SetBoardPos 客户端 修改位置
SetBoardRot 客户端 修改旋转角度, 若设置了文本朝向相机,则旋转角度的修改不会生效
SetBoardScale 客户端 内容整体缩放
SetBoardTextColor 客户端 修改字体颜色
SetText 客户端 修改文字面板内容

# 序列帧

接口
描述
Bind 客户端 绑定entity
Bind 客户端 绑定骨骼模型
CreateEngineSfx 客户端 创建序列帧特效
CreateEngineSfxFromEditor 客户端 指使用资源包中effects/xxx.json,按照编辑器中编辑好的参数创建序列帧。支持环状序列帧
GetPos 客户端 获取序列帧特效的位置
GetRot 客户端 获取序列帧特效的旋转角度
GetScale 客户端 获取序列帧特效的缩放值
Pause 客户端 暂停播放,序列帧定格在当前时刻,再次调用Play时继续播放
Play 客户端 播放序列帧
SetDeepTest 客户端 设置序列帧是否透视,默认为否
SetFaceCamera 客户端 设置序列帧是否始终朝向摄像机,默认为是
SetFadeDistance 客户端 设置序列帧开始自动调整透明度的距离。序列帧与摄像机之间的距离小于该值时会自动调整序列帧的透明度,距离摄像机越近,序列帧越透明
SetLayer 客户端 设置序列帧渲染层级,默认层级为1,当层级不为1时表示该特效开启特效分层渲染功能。特效(粒子和帧动画)分层渲染时,层级越高渲染越靠后,层级大的会遮挡层级低的,且同一层级的特效会根据特效的相对位置产生正确的相互遮挡关系。
SetLoop 客户端 设置序列帧是否循环播放,默认为否
SetMixColor 客户端 设置序列帧混合颜色
SetPos 客户端 设置序列帧的位置
SetRot 客户端 设置序列帧的旋转
SetRotUseZXY 客户端 设置序列帧的旋转,旋转顺序按照绕z,x,y轴旋转
SetScale 客户端 设置序列帧的缩放
SetUsePointFiltering 客户端 设置序列帧是否使用点滤波
Stop 客户端 停止序列帧(不是暂停)

# 粒子

接口
描述
Bind 客户端 绑定entity
Bind 客户端 绑定骨骼模型
CreateEngineParticle 客户端 用于创建粒子特效
GetParticleEmissionRate 客户端 获取粒子发射器每帧发射粒子的频率。
GetParticleMaxNum 客户端 获取粒子发射器包含的最大粒子数量。
GetParticleMaxSize 客户端 获取粒子特效中粒子大小的最大值。
GetParticleMinSize 客户端 获取粒子特效中粒子大小的最小值。
GetParticleVolumeSize 客户端 获取粒子发射器的体积大小缩放值。
GetPos 客户端 获取粒子发射器的世界坐标位置
GetRot 客户端 获取粒子发射器的旋转角度
Pause 客户端 暂停播放,粒子定格在当前时刻,再次调用Play时继续播放
Play 客户端 播放粒子特效
SetFadeDistance 客户端 设置粒子开始自动调整透明度的距离。粒子与摄像机之间的距离小于该值时会自动调整粒子的透明度,距离摄像机越近,粒子越透明
SetLayer 客户端 粒子默认层级为1,当层级不为1时表示该特效开启特效分层渲染功能。特效(粒子和帧动画)分层渲染时,层级越高渲染越靠后,层级大的会遮挡层级低的,且同一层级的特效会根据特效的相对位置产生正确的相互遮挡关系。
SetParticleEmissionRate 客户端 设置粒子发射器每帧发射粒子的频率,频率越大则每帧发射的粒子数量越多,但粒子数量不会超过粒子发射器的粒子容量,同时由于性能考虑,每帧发射的粒子数量也不会超过100个。
SetParticleMaxNum 客户端 设置粒子发射器的粒子容量,即粒子发射器所包含的最大粒子数量。该数量并不代表目前粒子发射器所发射的粒子数量,如需要增加发射的粒子数量,需同时改变粒子的发射频率。
SetParticleSize 客户端 设置粒子特效中粒子大小的最小值及最大值。
SetParticleVolumeSize 客户端 设置粒子发射器的体积大小缩放,不影响单个粒子的尺寸。粒子发射器的体积越大,则粒子的发射范围越大。
SetPos 客户端 设置粒子发射器的世界坐标位置
SetRelative 客户端 当粒子绑定了entity或骨骼模型时,发射出的粒子使用entity坐标系还是世界坐标系。与mcstudio特效编辑器中粒子的“相对挂点运动”选项功能相同。
SetRotUseZXY 客户端 设置粒子发射器的旋转,旋转顺序按照绕z,x,y轴旋转
SetUsePointFiltering 客户端 设置粒子材质的纹理滤波是否使用点滤波方法。默认为使用双线性滤波
Stop 客户端 停止粒子播放

# 模型特效

接口
描述
CreateEngineEffectBind 客户端 指用编辑器保存资源包中models/bind/xxx_bind.json生成编辑好的所有挂点的所有特效。生成的特效会自动进行挂接及播放,编辑器中设为不可见的特效也会进行播放。并且使用这种方式创建的特效,开发者不用维护entity进出视野导致的挂接特效被移除,引擎会在entity每次进入视野时自动创建所有特效。
Pause 客户端 暂停模型特效(即使用CreateEngineEffectBind创建的特效)
Resume 客户端 继续播放模型特效(即使用CreateEngineEffectBind创建的特效)

# 微软粒子

接口
描述
BindEntity 客户端 绑定粒子发射器到指定实体的指定骨骼上
BindModel 客户端 绑定粒子发射器到指定骨骼模型的指定骨骼上
Create 客户端 创建粒子发射器, 创建后立即播放
CreateBindEntityNew 客户端 创建粒子发射器并绑定到指定实体的指定骨骼上, 创建后立即播放
EmitManually 客户端 手动发射粒子一次
Exist 客户端 判断指定粒子发射器是否存在
GetActiveDuration 客户端 获取粒子发射器的激活周期
GetBindingID 客户端 返回粒子绑定的实体id,没有则返回"0"
GetBindingModelID 客户端 返回绑定的骨骼模型id 没有则返回-1
GetDuration 客户端 获取粒子发射器的播放周期(激活+休眠时间)
GetFacingMode 客户端 返回粒子发射器的粒子朝向模式
GetLoopAge 客户端 获取粒子发射器当前播放周期内已播放的时间
GetPos 客户端 获取粒子发射器位置
GetRot 客户端 获取粒子发射器局部旋转
GetSleepDuration 客户端 获取粒子发射器的休眠周期
GetTimeScale 客户端 获取粒子发射器的播放速度
GetVariable 客户端 获取粒子发射器的Molang变量值
Hide 客户端 隐藏粒子发射器(不渲染)
IsHiding 客户端 返回粒子发射器是否正在被隐藏(不渲染)
IsPausing 客户端 返回粒子发射器的逻辑是否正在被暂停
Pause 客户端 暂停粒子发射器的逻辑更新,但保持渲染状态
Play 客户端 播放粒子发射器
PlayAt 客户端 设置粒子发射器播放时间点
Remove 客户端 销毁指定粒子发射器
RemoveByName 客户端 销毁场景中指定名称(粒子发射器json中的identifier)的所有粒子发射器
Replay 客户端 重播粒子发射器
Resume 客户端 恢复粒子发射器的逻辑更新,不影响渲染状态
SetPos 客户端 设置粒子发射器位置
SetRelative 客户端 设置粒子是否在局部空间进行计算
SetRot 客户端 设置粒子发射器局部旋转
SetRotUseZXY 客户端 设置粒子发射器局部旋转,旋转顺序按照绕z,x,y轴旋转
SetTimeScale 客户端 设置粒子发射器的播放速度
SetVariable 客户端 设置粒子发射器的Molang变量值
Show 客户端 显示粒子发射器(开启渲染)
Stop 客户端 停止粒子发射器播放(不渲染且不更新逻辑)
Unbind 客户端 解除指定粒子发射器的绑定状态

通用

文字面板

序列帧

粒子

模型特效

微软粒子