Skip to content

索引 ​


通用 ​

接口
描述
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客户端设置序列帧开始自动调整透明度的距离。序列帧与摄像机之间的距离小于该值时会自动调整序列帧的透明度,距离摄像机越近,序列帧越透明
SetGlobal客户端设置序列帧是否是全局的,默认为否
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客户端设置粒子开始自动调整透明度的距离。粒子与摄像机之间的距离小于该值时会自动调整粒子的透明度,距离摄像机越近,粒子越透明
SetGlobal客户端设置粒子发射器是否为全局粒子发射器, 默认是False
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客户端解除指定粒子发射器的绑定状态