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客户端解除指定粒子发射器的绑定状态