Class: Globe

Members

atmosphereBrightnessShiftNumber

The brightness shift to apply to the atmosphere. Defaults to 0.0 (no shift). A brightness shift of -1.0 is complete darkness, which will let space show through.

Default Value:

0.0

Methods

addExcavationRegion(){Boolean}

添加地形开挖区域。

Name	Type	Description
options.position	Array	开挖区域位置信息。
options.name	String	开挖区域名称。（唯一）
options.height	String	开挖地下深度。
options.transparent	Boolean	地表是否透明。
options.textureWrap	TextureWrap	用于指定开挖纹理的贴图方式，默认值为SuperMap3D.TextureWrap.REPEAT。

Returns:

Type	Description
Boolean	bool 成功返回true,失败返回false。

Example

var pts = [lon1,lat1,h1,lon2,lat2,h2,lon3,lat3,h3];
viewer.scene.globe.addExcavationRegion({
        name : 'test' ,
        position : pts,
        height : 100,
        transparent : false
        textureWrap :SuperMap3D.TextureWrap.REPEAT // 重复贴图
        textureWrap :SuperMap3D.TextureWrap.CLAMP_TO_EDGE // 不重复贴图（拉伸到边缘贴图）
    });

addExtractRegion()

地形开挖抽出显示效果。

Name	Type	Description
options.name	String	该开挖区域的名称。
options.position	Array	地形开挖区域。
options.height	Number	地形开挖深度。
options.transparent	Boolean	封边是否透明，默认值：false。
options.extractHeight	Number	地形开挖抽出高度，默认值：100。
options.granularity	Number	地形开挖精度，越小越精确，默认值：1。

Example

viewer.scene.globe.addExtractRegion({
 name:'ggg',
 position:positions,
 height:50,
 transparent:transparent,
 extractHeight:200
 });

addImageryClipRegions()

影像裁剪。

Name	Type	Description
options.position	Array	裁剪区域
options.layers	Array	参与裁剪的影像图层
options.name	String	该裁剪区域的name（key值）

addModifyRegion(){Boolean}

添加地形修改区域。（传入三维矢量面数据，将高低起伏的地形处理为与三维面高度一致的效果）

Name	Type	Description
options.position	Array	修改区域位置信息。
options.name	String	修改区域名称。
options.createSide	Boolean	是否创建侧边（适用于地形挖方）默认值true。

Returns:

Type	Description
Boolean	成功返回true，失败返回false。

Example

var pts = [lon1,lat1,h1,lon2,lat2,h2,lon3,lat3,h3];
viewer.scene.globe.addModifyRegion({
        name : 'test',
        position : pts,
    });

clearClipGeometry()

移除地形通过模型开挖。

clearCustomClipBox()

清除自定义裁剪面

computeSurfaceArea(polygonGeometry, ellipsoid, slice){number}

计算贴地面积。

Name	Type	Description
polygonGeometry	Object	polygonGeometry类中的对象，用于确定面积量算的范围
ellipsoid	Ellipsoid	椭球。即计算贴地面积时所采用的椭球，默认值为WGS84椭球
slice	Number	可选 拆分粒度。支持用户自定义多边形拆分的粒度，若不设置则根据多边形的范围设置粒度

Returns:

Type	Description
number	PolygonGeometry对象范围内的贴地面积

Example

var ellipsoid = SuperMap3D.Ellipsoid.WGS84;
var area = scene.globe.computeSurfaceArea(polygonGeometry, ellipsoid, 10)；

computeSurfaceDistance(polylineGeometry, ellipsoid){number}

计算贴地距离。

Name	Type	Description
polylineGeometry	Object	polylineGeometry类中的对象，用于确定距离量算的范围。
ellipsoid	Ellipsoid	椭球。即计算贴地距离时所采用的椭球体，默认值为WGS84椭球。

Returns:

Type	Description
number	PolylineGeometry对象对应的贴地距离

Example

var ellipsoid = SuperMap3D.Ellipsoid.WGS84;
var distance = scene.globe.computeSurfaceDistance(polylineGeometry,ellipsoid);

destroy(){undefined}

销毁该对象持有的 WebGL 资源。 销毁对象可以确定性地释放 WebGL 资源，而不是依赖垃圾回收器来销毁该对象。 一旦对象被销毁，就不应再使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。 因此，请按照示例中的方法将返回值（undefined）赋值给对象。

See:

• Globe#isDestroyed

Throws:

该对象已被销毁，即 destroy() 被调用。

Type

DeveloperError

Returns:

Type	Description
undefined

Example

globe = globe && globe.destroy();

getHeight(cartographic){Number|undefined}

获取经纬度对应的高度。

Name	Type	Description
cartographic	Cartographic	经纬度值。

Returns:

Type	Description
Number | undefined	高度值。

getSlopeDirectionValue(cartographic){Number|undefined}

获取地形坡度方向,传入弧度坐标，返回的结果以正北为0度。

Name	Type	Description
cartographic	Cartographic	经纬度。

Returns:

Type	Description
Number | undefined	坡度方向。

getSlopeValue(cartographic){Number|undefined}

获取地形坡度值。

Name	Type	Description
cartographic	Cartographic	经纬度。

Returns:

Type	Description
Number | undefined	坡度值。

getVisibleTiles(){Array}

获取可见瓦片。

Returns:

Type	Description
Array	对象列表，其中对象的属性为x、y、level

isDestroyed(){Boolean}

如果该对象已被销毁，则返回 true；否则返回 false。 如果该对象已被销毁，则不应使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。

See:

• Globe#destroy

Returns:

Type	Description
Boolean	如果该对象已被销毁，则为 true；否则为 false。

pick(Ray, Scene, result){Cartesian3|undefined}

获取射线和地球的交点（射线必须是三维地理坐标）。

Name	Type	Description
Ray	Number	射线，用于相机测试。
Scene	Object	场景对象。
result	Cartesian3	可选 三维空间坐标，用于保存结果。

Returns:

Type	Description
Cartesian3 | undefined	如果不相交，返回交点的三维空间坐标。

Example

// 通过屏幕空间的一个像素和相机的射线查找和地球的交点。
var ray = viewer.camera.getPickRay(windowCoordinates);
var intersection = globe.pick(ray, scene);

removeAllExcavationRegion()

移除所有开挖面

Example

viewer.scene.globe.removeAllExcavationRegion();

removeAllExtractRegion()

移除所有开挖区域和抽出部分。

Example

viewer.scene.globe.removeAllExtractRegion();

removeAllModifyRegion()

移除所有地形修改的区域

Example

viewer.scene.globe.removeAllModifyRegion();

removeExcavationRegion(name)

移除指定名称的地形开挖区域

Name	Type	Description
name	String	地形开挖区域的名称

removeExtractRegion(name)

移除地形当前开挖区域和抽出部分。

Name	Type	Description
name	String	地形开挖和抽出区域的名称

Example

viewer.scene.globe.removeExtractRegion();

removeImageryClipRegion(name, layers)

移除裁剪区域

Name	Type	Description
name	String	该裁剪区域的name（key值）。
layers	Array	参与裁剪的影像图层。

removeModifyRegion(name)

移除指定名称的地形修改区域

Name	Type	Description
name	String	地形修改区域的名称

removePBRMaterial()

移除PBR材质。

setClipGeometry(options){Boolean}

添加地形通过模型开挖

Name	Type	Description
options	Object	地形模型开挖参数对象包含以下属性： Name Type Description geometry geometry 模型 scene String 场景

Returns:

Type	Description
Boolean	成功返回true,失败返回false

Example

var geoCylinder = new SuperMap3D.GeoBox(400.0, 400.0, 10000.0);
    geoCylinder.geoPosition = positon;
    viewer.scene.globe.setClipGeometry({
        geometry:geoCylinder,
        scene:scene
    });

setCustomClipBox(options){Boolean}

添加自定义裁剪面

Name	Type	Description
options	Object	裁剪面参数包含以下属性： Name Type Description dimensions Cartesian3 裁剪box的长宽高 position Cartesian3 box裁剪中心位置 heading Number 裁剪box的heading角度 pitch Number 裁剪box的pitch角度 roll Number 裁剪box的roll角度 clipLineColor Color 裁剪线颜色。 clipMode String 裁剪模式，包括裁剪平面内、裁剪平面外、只保留�?

Throws:

options and options.dimensions and options.position are required.

Type

DeveloperError

Returns:

Type	Description
Boolean	bool 成功返回true,失败返回false

setPBRMaterialFromJSON(jsonPath)

添加地形PBR材质。

Name	Type	Description
jsonPath	String	pbr材质的文件地址

setPolygonOffset(polyOffsetFactor, polyOffsetUnits)

设置地形多边形偏移缩放因子和偏移常量。

Name	Type	Description
polyOffsetFactor	Number	偏移缩放因子，默认为0。
polyOffsetUnits	Number	偏移常量，默认为0。