com.supermap.realspace

类 Atmosphere



  • public class Atmosphere
    extends Object
    大气环境类。

    大气环境对象是为了达到三维场景的真实感所采取大气层模拟效果。

    示范代码:
    以下代码示范了显示三维场景窗口,同时使三维场景的大气环境可见
    public void TestAtmosphere()
      {
       //返回当前三维场景窗口的三维场景对象,并进行三维场景的设置
       SceneControl sceneControl = new SceneControl();
       Scene sceneObject = sceneControl.getScene();
       Atmosphere atmosphere = sceneObject.getAtmosphere();
       atmosphere.setVisible(true);
       sceneObject.refresh();
    
       //释放占用的资源
       sceneControl.dispose();
       }
    • 方法详细资料

      • setEarthRayleighScaleHeight

        public void setEarthRayleighScaleHeight(float fEarthRayleighScaleHeight)
        设置瑞利散射的高度。

        瑞利散射是一种光散射现象,主要发生在光波遇到比其波长小的多的粒子时。

        参数:
        fEarthRayleighScaleHeight - 设置瑞利散射的高度,范围[0.1 , 80],单位Km。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
        从以下版本开始:
        11.3.0。
      • getEarthRayleighScaleHeight

        public float getEarthRayleighScaleHeight()
        获取瑞利散射的高度。

        瑞利散射是一种光散射现象,主要发生在光波遇到比其波长小的多的粒子时。

        返回:
        瑞利散射的高度,范围[0.1 , 80],单位Km。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
        从以下版本开始:
        11.3.0。
      • setEarthMieScaleHeight

        public void setEarthMieScaleHeight(float fEarthMieScaleHeight)
        设置米氏散射的高度。

        米氏散射是一种光散射现象,主要发生在光波遇到与光波长相当或更大的粒子时。

        参数:
        fEarthMieScaleHeight - 设置米氏散射的高度,范围[0.01 , 12],单位Km。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
        从以下版本开始:
        11.3.0。
      • getEarthMieScaleHeight

        public float getEarthMieScaleHeight()
        获取米氏散射的高度。

        米氏散射是一种光散射现象,主要发生在光波遇到与光波长相当或更大的粒子时。

        返回:
        米氏散射的高度,范围[0.01 , 12],单位Km。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
        从以下版本开始:
        11.3.0。
      • setRayleighScatteringScale

        public void setRayleighScatteringScale(float fRayleighScatteringScale)
        设置瑞利散射的强度。

        瑞利散射是一种光散射现象,主要发生在光波遇到比其波长小的多的粒子时。

        参数:
        fRayleighScatteringScale - 设置瑞利散射的强度,范围范围[0 , 2]。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • getRayleighScatteringScale

        public float getRayleighScatteringScale()
        获取瑞利散射的强度。

        瑞利散射是一种光散射现象,主要发生在光波遇到比其波长小的多的粒子时。

        返回:
        瑞利散射的强度,范围范围[0 , 2]。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • setMieAbsorptionScale

        public void setMieAbsorptionScale(float fMieAbsorptionScale)
        设置米氏散射的强度。

        米氏散射是一种光散射现象,主要发生在光波遇到与光波长相当或更大的粒子时。

        参数:
        fMieAbsorptionScale - 设置米氏散射的强度,范围[0 , 5]。
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • getMieAbsorptionScale

        public float getMieAbsorptionScale()
        获取米氏散射的强度。

        米氏散射是一种光散射现象,主要发生在光波遇到与光波长相当或更大的粒子时。

        返回:
        米氏散射的强度,范围[0 , 5]
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • setMieScatteringScale

        public void setMieScatteringScale(float fMieScatteringScale)
        设置大气参数,米氏散射影响分布,
        参数:
        fMieScatteringScale - 米氏散射影响分布,范围[0 , 5]
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • getMieScatteringScale

        public float getMieScatteringScale()
        获取大气参数,米氏散射影响分布,
        返回:
        米氏散射影响分布,范围[0 , 5]
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • setMieAnisotropy

        public void setMieAnisotropy(float fMieAnisotropy)
        设置大气参数,米氏散射各异向性,
        参数:
        fMieAnisotropy - 米氏散射各异向性,范围[0 , 0.999]
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • getMieAnisotropy

        public float getMieAnisotropy()
        获取大气参数,米氏散射各异向性,
        返回:
        米氏散射各异向性,范围[0 , 0.999]
        抛出:
        @throws - IllegalStateException 当前对象已被释放。
      • setVisible

        public void setVisible(boolean value)
        设置大气环境是否可见。
        参数:
        value - 一个布尔值指定大气环境是否可见。
      • isVisible

        public boolean isVisible()
        返回大气环境是否可见。
        返回:
        大气环境效果打开返回 true;关闭返回 false。
      • setSwipeEnable

        public void setSwipeEnable(boolean enable)
        设置大气环境的卷帘功能是否开启。
        参数:
        enable - 指定是否开启卷帘功能。
      • isSwipeEnable

        public boolean isSwipeEnable()
        返回大气环境的卷帘功能是否开启。
        返回:
        卷帘功能是否开启。
      • getSwipeRegion

        public Rectangle2D getSwipeRegion()
        返回大气环境开启卷帘的区域。
        返回:
        开启卷帘的区域。
      • setSwipeRegion

        public void setSwipeRegion(Rectangle2D rec)
        设置大气环境开启卷帘的区域。
        参数:
        rec - 指定开启卷帘的区域。
      • isFogEnable

        public boolean isFogEnable()
        返回是否启用雾效果。
        返回:
        启用雾效果返回 true;否则 false。
        从以下版本开始:
        12.0.0。
        默认值:
        默认值为false,不启用雾。

        仅支持渲染引擎V2上使用。

      • setFogEnable

        public void setFogEnable(boolean value)
        设置是否启用雾效果。
        参数:
        value - 一个布尔值指定是否启用雾效果。

        仅支持渲染引擎V2上使用。

        从以下版本开始:
        12.0.0。
      • getFogColor

        public Color getFogColor()
        返回雾的颜色。
        返回:
        雾的颜色。
        从以下版本开始:
        12.0.0。
        默认值:
        默认值为 Color [A=255, R=0, G=0, B=0]。

        仅支持渲染引擎V2上使用。

      • setFogColor

        public void setFogColor(Color value)
        设置雾的颜色。
        参数:
        value - 雾的颜色。

        仅支持渲染引擎V2上使用。

        从以下版本开始:
        12.0.0。
      • getFogDensity

        public float getFogDensity()
        返回雾的密度。雾的密度决定了大气环境的透明度。该返回值的范围为 [0,1],默认值为0.06。
        返回:
        雾的密度。
        从以下版本开始:
        12.0.0。
        默认值:
        默认值为0.06。

        仅支持渲染引擎V2上使用。

      • setFogDensity

        public void setFogDensity(float value)
        设置雾的密度。雾的密度决定了大气环境的透明度。
        参数:
        value - 雾的密度,范围为 [0,1],默认值为0.06。

        仅支持渲染引擎V2上使用。

        从以下版本开始:
        12.0.0。
      • setFogVisibleAltitude

        public void setFogVisibleAltitude(float value)
        设置雾的可见高度,即离地球表面的海拔距离。单位为米。
        参数:
        value - 雾的可见高度。单位为米。范围【0.0 - 100000】

        仅支持渲染引擎V2上使用。

        从以下版本开始:
        12.0.0。
      • getFogVisibleAltitude

        public float getFogVisibleAltitude()
        返回雾的可见高度,即离地球表面的海拔距离。单位为米。
        返回:
        雾的可见高度。单位为米。
        从以下版本开始:
        12.0.0。
        默认值:
        默认值为 60000,单位为米。

        仅支持渲染引擎V2上使用。

      • setFogHeightFallOff

        public void setFogHeightFallOff(float value)
        设置雾随高度的衰减系数。
        参数:
        value - 衰减系数,范围为[0,1]。

        仅支持渲染引擎V2上使用。

        从以下版本开始:
        12.0.0。
      • getFogHeightFallOff

        public float getFogHeightFallOff()
        返回雾随高度的衰减系数。
        返回:
        雾随高度的衰减系数,范围为[0,1]。
        从以下版本开始:
        12.0.0。
        默认值:
        默认值为 0.2

        仅支持渲染引擎V2上使用。

Copyright © 2021–2025 SuperMap. All rights reserved.