FreedoX

Class: FdTails

FdMicroApp. FdTails

运动尾迹

new FdTails(viewer, model [, option])

Parameters:
Name Type Argument Default Description
viewer Viewer

视景器
model Model | FdModelAnimationManager | FdModelAnimation

任意拥有getter属性modelMatrix的模型或动画实例
option Object <optional>

尾迹配置参数，可以省略，省略时尾迹为默认的烟雾粒子特效。可能包含以下属性：

Properties
Name Type Argument Default Description
isLine Boolean <optional>
 false

尾迹是否使用线，false表示使用粒子系统
options.emitter ParticleEmitter <optional>
 new CircleEmitter(2.0)

（粒子）粒子发射器
options.emissionRate Number <optional>
 10.0

（粒子）每秒发射的粒子数
options.bursts Array.<ParticleBurst> <optional>

（粒子）周期性爆发的粒子效果，当不需要爆发效果时，设置为空数组
options.loop Boolean <optional>
 true

（粒子）爆发效果完成后是否循环
options.startScale Number <optional>
 1.0

（粒子）应用于粒子的图片在粒子生命周期初始时的缩放值
options.endScale Number <optional>
 3.0

（粒子）应用于粒子的图片在粒子生命周期结束时的缩放值
options.startColor Color <optional>
 Freedo.Color.LIGHTSEAGREEN.withAlpha(0.7)

（粒子）粒子在生命周期初始时的颜色
options.endColor Color <optional>
 Freedo.Color.WHITE.withAlpha(0.0)

（粒子）粒子在生命周期结束时的颜色
options.image Object <optional>

（粒子）生成粒子的图片，可以是URI, HTMLImageElement, 或者HTMLCanvasElement。默认为烟雾图片
options.imageSize Cartesian2 <optional>
 new Cartesian2(2.0, 2.0)

（粒子）粒子图片的宽度、高度缩放比
options.sizeInMeters Boolean <optional>
 true

（粒子）设置标记粒子尺寸的单位，true表示米，false表示像素
options.minimumSpeed Number <optional>
 2.0

（粒子）粒子速度随机取值的最小值
options.maximumSpeed Number <optional>
 6.0

（粒子）粒子速度随机取值的最大值
options.lifetime Number <optional>
 16

（粒子）粒子系统在多长时间内发射粒子，单位秒
options.minimumParticleLife Number <optional>
 1.2

（粒子）粒子生命周期随机取值的最小值，单位秒
options.maximumParticleLife Number <optional>
 1.2

（粒子）粒子生命周期随机取值的最大值，单位秒
options.updateCallback ParticleSystem.updateCallback <optional>

（粒子）逐帧更新粒子的回调函数。默认为重力回调函数
options.gravity Number <optional>
 0.0

（粒子）默认的重力回调函数中，重力参数大小（正值表示向上）
options.emitterRotation Array.<Number> <optional>
 [0.0, 0.0, 0.0]

（粒子）粒子发射器相对于粒子系统坐标系的旋转角度（角度值），用[heading，pitch，roll]表示
options.emitterTranslation Array.<Number> <optional>
 [0.0, 0.0, 0.0]

（粒子）粒子发射器相对于粒子系统坐标系的偏移值，用[x, y, z]表示
option.width Number <optional>
 1.0

（线）线的宽度
option.length Number <optional>
 100.0

（线）线的连接点数量，控制线的长度。在不同的速度下线的实际长度会不同
option.color Color <optional>
 Freedo.Color.LIGHTSEAGREEN

（线）线的颜色，实际使用时会添加一个透明渐变效果
option.offset Array.<Number> <optional>

（线）线在粒子坐标系下的偏移量，用[x, y, z]表示
Example
// 方式一：为FdModelAnimationManager动画实例添加运动尾迹效果
// 参考FdModelAnimationManager类
var am = new Freedo.FdMicroApp.FdModelAnimationManager(viewer);
am.addAnimator(...) 

var tails = new Freedo.FdMicroApp.FdTails(viewer, am, {
   isLine: false, // 尾迹类型，true为线，false为粒子特效
   // ...
});

tails.start();

// 方式二：为model添加尾迹效果，model可以是任意具有modelMatrix属性的模型或动画对象
var model = viewer.scene.primitives.add(Freedo.Model.fromGltf({
   // ...
}));

var tails = new Freedo.FdMicroApp.FdTails(viewer, model, {
   // ...
});

tails.start();

Methods

destroy()

清除尾迹

setModel(model)

可以在实例化之后再关联需要添加尾迹的模型/动画

Parameters:
Name Type Description
model Model | FdModelAnimationManager | FdModelAnimation

任意拥有getter属性modelMatrix的模型或动画实例

setOption(option)

可以在实例化之后再设置配置参数；如果实例化时已经设置了参数，则会覆盖已有属性

Parameters:
Name Type Description
option Object

尾迹配置参数

start()

开启尾迹