ParticleSystem (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.ParticleSystem

所有已实现的接口:

IDisposable
```
public class ParticleSystem
extends com.supermap.data.InternalHandleDisposable
```
粒子系统对象类。该类主要用于返回/设置与三维粒子几何对象（GeoParticle）所持有的粒子系统对象的各项参数。另请参见 GeoParticle 类。

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`dispose()` 释放该对象所占用的资源。
`Color`	`getColorRangeEnd()` 返回粒子系统对象中每个粒子的终止颜色值。
`String`	`getColorRangeImagePath()` 返回粒子系统对象中用于设置粒子颜色渐变的图像的路径。
`Color`	`getColorRangeStart()` 返回粒子系统对象中每个粒子的起始颜色值。
`Point3D`	`getLocalCenterPos()` 返回粒子系统对象的相对位置。
`int`	`getParticleCountPerSecond()` 返回粒子系统对象每秒产生的粒子个数，单位：个。
`float`	`getParticleHeight()` 返回粒子系统对象中每个粒子的高度，单位：米。
`int`	`getParticleLifeTime()` 返回粒子系统对象中每个粒子的生命周期，即粒子从产生到消亡的时间长度，单位：毫秒。
`float`	`getParticleWidth()` 返回粒子系统对象中每个粒子的宽度，单位：米。
`String`	`getTexturePath()` 返回粒子系统对象中粒子纹理贴图的路径。
`void`	`setColorRangeEnd(Color value)` 设置粒子系统对象中每个粒子的终止颜色值。
`void`	`setColorRangeImagePath(String value)` 设置粒子系统对象中用于设置粒子颜色渐变的图像的路径。
`void`	`setColorRangeStart(Color value)` 设置粒子系统对象中每个粒子的起始颜色值。
`void`	`setLocalCenterPos(Point3D value)` 设置粒子系统对象的相对位置。
`void`	`setParticleCountPerSecond(int value)` 设置粒子系统对象每秒产生的粒子个数，单位：个。
`void`	`setParticleHeight(float value)` 设置粒子系统对象中每个粒子的高度，单位：米。
`void`	`setParticleLifeTime(int value)` 设置粒子系统对象中每个粒子的生命周期，即粒子从产生到消亡的时间长度，单位：毫秒。
`void`	`setParticleWidth(float value)` 设置粒子系统对象中每个粒子的宽度，单位：米。
`void`	`setTexturePath(String value)` 设置粒子系统对象中粒子纹理贴图的路径。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - 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 - 用于设置粒子颜色渐变的图像的路径。

类 ParticleSystem

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

方法详细资料

dispose

getLocalCenterPos

setLocalCenterPos

getParticleWidth

setParticleWidth

getParticleHeight

setParticleHeight

getParticleLifeTime

setParticleLifeTime

getParticleCountPerSecond

setParticleCountPerSecond

getColorRangeStart

setColorRangeStart

getColorRangeEnd

setColorRangeEnd

getTexturePath

setTexturePath

getColorRangeImagePath

setColorRangeImagePath