com.supermap.data
类 ParticleSystem
- 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类。
-
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 voiddispose()释放该对象所占用的资源。ColorgetColorRangeEnd()返回粒子系统对象中每个粒子的终止颜色值。StringgetColorRangeImagePath()返回粒子系统对象中用于设置粒子颜色渐变的图像的路径。ColorgetColorRangeStart()返回粒子系统对象中每个粒子的起始颜色值。Point3DgetLocalCenterPos()返回粒子系统对象的相对位置。intgetParticleCountPerSecond()返回粒子系统对象每秒产生的粒子个数,单位:个。floatgetParticleHeight()返回粒子系统对象中每个粒子的高度,单位:米。intgetParticleLifeTime()返回粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。floatgetParticleWidth()返回粒子系统对象中每个粒子的宽度,单位:米。StringgetTexturePath()返回粒子系统对象中粒子纹理贴图的路径。voidsetColorRangeEnd(Color value)设置粒子系统对象中每个粒子的终止颜色值。voidsetColorRangeImagePath(String value)设置粒子系统对象中用于设置粒子颜色渐变的图像的路径。voidsetColorRangeStart(Color value)设置粒子系统对象中每个粒子的起始颜色值。voidsetLocalCenterPos(Point3D value)设置粒子系统对象的相对位置。voidsetParticleCountPerSecond(int value)设置粒子系统对象每秒产生的粒子个数,单位:个。voidsetParticleHeight(float value)设置粒子系统对象中每个粒子的高度,单位:米。voidsetParticleLifeTime(int value)设置粒子系统对象中每个粒子的生命周期,即粒子从产生到消亡的时间长度,单位:毫秒。voidsetParticleWidth(float value)设置粒子系统对象中每个粒子的宽度,单位:米。voidsetTexturePath(String value)设置粒子系统对象中粒子纹理贴图的路径。
-
-
-
方法详细资料
-
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- 用于设置粒子颜色渐变的图像的路径。
-
-
Copyright © 2021–2025 SuperMap. All rights reserved.