方法详细资料

• dispose

  public void dispose()

  释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

• getLocalCenterPos

  public Point3D getLocalCenterPos()

  返回粒子系统对象的相对位置。

  其参考位置为与三维粒子几何对象（GeoParticle）关联的几何对象的中心点，采用笛卡尔坐标系，单位：米。

  返回:

  粒子系统的相对位置。

  默认值:

  默认值为 (0,0,0)，即粒子系统的位置、三维粒子对象关联的几何对象的中心点位置两者是重合的。

• setLocalCenterPos

  public void setLocalCenterPos(Point3D value)

  设置粒子系统对象的相对位置。

  其参考位置为与三维粒子几何对象（GeoParticle）关联的几何对象的中心点，采用笛卡尔坐标系，单位：米。

  参数:

  point3D - 粒子系统的相对位置。

• getParticleWidth

  public float getParticleWidth()

  返回粒子系统对象中每个粒子的宽度，单位：米。

  返回:

  粒子的宽度。

• setParticleWidth

  public void setParticleWidth(float value)

  设置粒子系统对象中每个粒子的宽度，单位：米。

  在其它参数不变的情况下，通过粒子宽度和高度的控制，可以调节粒子效果的疏密程度。

  参数:

  value - 粒子的宽度。

• getParticleHeight

  public float getParticleHeight()

  返回粒子系统对象中每个粒子的高度，单位：米。

  返回:

  粒子的高度。

• setParticleHeight

  public void setParticleHeight(float value)

  设置粒子系统对象中每个粒子的高度，单位：米。

  在其它参数不变的情况下，通过粒子宽度和高度的控制，可以调节粒子效果的疏密程度。

  参数:

  value - 粒子的高度。

• getParticleLifeTime

  public int getParticleLifeTime()

  返回粒子系统对象中每个粒子的生命周期，即粒子从产生到消亡的时间长度，单位：毫秒。

  返回:

  粒子的生命周期。

• setParticleLifeTime

  public void setParticleLifeTime(int value)

  设置粒子系统对象中每个粒子的生命周期，即粒子从产生到消亡的时间长度，单位：毫秒。

  参数:

  value - 粒子的生命周期。

• getParticleCountPerSecond

  public int getParticleCountPerSecond()

  返回粒子系统对象每秒产生的粒子个数，单位：个。

  返回:

  每秒产生的粒子个数。

• setParticleCountPerSecond

  public void setParticleCountPerSecond(int value)

  设置粒子系统对象每秒产生的粒子个数，单位：个。

  在其它参数不变的情况下，通过每秒产生的粒子数量的控制，可以调节粒子效果的疏密程度。

  参数:

  value - 每秒产生的粒子个数。

• getColorRangeStart

  public Color getColorRangeStart()

  返回粒子系统对象中每个粒子的起始颜色值。

  返回:

  粒子的起始颜色值。

• setColorRangeStart

  public void setColorRangeStart(Color value)

  设置粒子系统对象中每个粒子的起始颜色值。

  粒子在整个生命周期中颜色是可以变化的，各个时刻的颜色值将根据生命周期在起始色和终止色之间线性插值得到。

  参数:

  colorStart - 粒子的起始颜色值。

• getColorRangeEnd

  public Color getColorRangeEnd()

  返回粒子系统对象中每个粒子的终止颜色值。

  返回:

  粒子的终止颜色值。

• setColorRangeEnd

  public void setColorRangeEnd(Color value)

  设置粒子系统对象中每个粒子的终止颜色值。

  粒子在整个生命周期中颜色是可以变化的，各个时刻的颜色值将根据生命周期在起始色和终止色之间线性插值得到。

  参数:

  colorEnd - 粒子的终止颜色值。

• getTexturePath

  public String getTexturePath()

  返回粒子系统对象中粒子纹理贴图的路径。

  返回:

  粒子纹理贴图的路径。

• setTexturePath

  public void setTexturePath(String value)

  设置粒子系统对象中粒子纹理贴图的路径。

  参数:

  value - 粒子纹理贴图的路径。

• getColorRangeImagePath

  public String getColorRangeImagePath()

  返回粒子系统对象中用于设置粒子颜色渐变的图像的路径。

  一旦调用了 setColorRangeImagePath() 方法，setColorRangeStart()、setColorRangeEnd() 方法将失效。

  返回:

  用于设置粒子颜色渐变的图像的路径。

• setColorRangeImagePath

  public void setColorRangeImagePath(String value)

  设置粒子系统对象中用于设置粒子颜色渐变的图像的路径。

  一旦设置了该方法则粒子的颜色将由指定图像首行像素的颜色值决定，要求指定的图像为 32 位，若图片不是 32位的，则 alpha 值将默认处理为 255，此外，对于 32 位的 bmp 图片将被解析为会被解析为 24位 bmp 图片；同时，setColorRangeStart()、setColorRangeEnd() 方法将失效，即粒子的颜色不再由起始颜色值和终止颜色值决定。

  下图中，分别是指定路径下的图像以及对应的粒子颜色渐变的颜色条：

  

  参数:

  value - 用于设置粒子颜色渐变的图像的路径。