com.supermap.data
类 ParticleSystem

java.lang.Object
  继承者 com.supermap.data.ParticleSystem

public class ParticleSystem
extends java.lang.Object

粒子系统对象类。该类主要用于返回/设置与三维粒子几何对象(GeoParticle)所持有的粒子系统对象的各项参数。另请参见 GeoParticle 类。


方法摘要
 void dispose()
          释放该对象所占用的资源。
 java.awt.Color getColorRangeEnd()
          返回粒子系统对象中每个粒子的终止颜色值。
 java.lang.String getColorRangeImagePath()
          返回粒子系统对象中用于设置粒子颜色渐变的图像的路径。
 java.awt.Color getColorRangeStart()
          返回粒子系统对象中每个粒子的起始颜色值。
 Point3D getLocalCenterPos()
          返回粒子系统对象的相对位置。
 int getParticleCountPerSecond()
          返回粒子系统对象每秒产生的粒子个数,单位:个。
 float getParticleHeight()
          返回粒子系统对象中每个粒子的高度,单位:米。
 int getParticleLifeTime()
          返回粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。
 float getParticleWidth()
          返回粒子系统对象中每个粒子的宽度,单位:米。
 java.lang.String getTexturePath()
          返回粒子系统对象中粒子纹理贴图的路径。
 void setColorRangeEnd(java.awt.Color colorEnd)
          设置粒子系统对象中每个粒子的终止颜色值。
 void setColorRangeImagePath(java.lang.String value)
          设置粒子系统对象中用于设置粒子颜色渐变的图像的路径。
 void setColorRangeStart(java.awt.Color colorStart)
          设置粒子系统对象中每个粒子的起始颜色值。
 void setLocalCenterPos(Point3D point3D)
          设置粒子系统对象的相对位置。
 void setParticleCountPerSecond(int value)
          设置粒子系统对象每秒产生的粒子个数,单位:个。
 void setParticleHeight(float value)
          设置粒子系统对象中每个粒子的高度,单位:米。
 void setParticleLifeTime(int value)
          设置粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。
 void setParticleWidth(float value)
          设置粒子系统对象中每个粒子的宽度,单位:米。
 void setTexturePath(java.lang.String value)
          设置粒子系统对象中粒子纹理贴图的路径。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

setLocalCenterPos

public void setLocalCenterPos(Point3D point3D)
设置粒子系统对象的相对位置。

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

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

getLocalCenterPos

public Point3D getLocalCenterPos()
返回粒子系统对象的相对位置。

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

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

setParticleWidth

public void setParticleWidth(float value)
设置粒子系统对象中每个粒子的宽度,单位:米。

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

参数:
value - 粒子的宽度。

getParticleWidth

public float getParticleWidth()
返回粒子系统对象中每个粒子的宽度,单位:米。

返回:
粒子的宽度。

setParticleHeight

public void setParticleHeight(float value)
设置粒子系统对象中每个粒子的高度,单位:米。

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

参数:
value - 粒子的高度。

getParticleHeight

public float getParticleHeight()
返回粒子系统对象中每个粒子的高度,单位:米。

返回:
粒子的高度。

setParticleLifeTime

public void setParticleLifeTime(int value)
设置粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。

参数:
value - 粒子的生命周期。

getParticleLifeTime

public int getParticleLifeTime()
返回粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。

返回:
粒子的生命周期。

setParticleCountPerSecond

public void setParticleCountPerSecond(int value)
设置粒子系统对象每秒产生的粒子个数,单位:个。

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

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

getParticleCountPerSecond

public int getParticleCountPerSecond()
返回粒子系统对象每秒产生的粒子个数,单位:个。

返回:
每秒产生的粒子个数。

setColorRangeStart

public void setColorRangeStart(java.awt.Color colorStart)
设置粒子系统对象中每个粒子的起始颜色值。

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

参数:
colorStart - 粒子的起始颜色值。

getColorRangeStart

public java.awt.Color getColorRangeStart()
返回粒子系统对象中每个粒子的起始颜色值。

返回:
粒子的起始颜色值。

setColorRangeEnd

public void setColorRangeEnd(java.awt.Color colorEnd)
设置粒子系统对象中每个粒子的终止颜色值。

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

参数:
colorEnd - 粒子的终止颜色值。

getColorRangeEnd

public java.awt.Color getColorRangeEnd()
返回粒子系统对象中每个粒子的终止颜色值。

返回:
粒子的终止颜色值。

setTexturePath

public void setTexturePath(java.lang.String value)
设置粒子系统对象中粒子纹理贴图的路径。

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

getTexturePath

public java.lang.String getTexturePath()
返回粒子系统对象中粒子纹理贴图的路径。

返回:
粒子纹理贴图的路径。

setColorRangeImagePath

public void setColorRangeImagePath(java.lang.String value)
设置粒子系统对象中用于设置粒子颜色渐变的图像的路径。

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

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

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

getColorRangeImagePath

public java.lang.String getColorRangeImagePath()
返回粒子系统对象中用于设置粒子颜色渐变的图像的路径。

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

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

dispose

public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。