DemData

new CooSDK.DemData(props)

用于加载数字高程模型(DEM)数据对象，支持本地及在线服务数据的加载展示。


影像及地形效果图
Name Type Description
props Object

包含如下属性的Object：

Name Type Default Description
url String

数字高程数据路径，当路径含有tms.xml时，无需配置format,srs,maxX,maxY,minX,minY,maxLevel,minLevel,tileSize
blacklistUpdateTime Number 600 optional

黑名单重新请求间隔时长，单位：秒。
blacklistRequestCount Number 5 optional

黑名单机制中黑名单对象请求次数阈值。
distance Number null optional

自定义定位：视点距离数据中心点距离，该值为null时则无法进行自定义定位。
flyTime Number 3.0 optional

自定义定位：定位飞行时间，单位：秒。
format String null optional

数据格式，数字高程数据路径目录下的tms.xml中的 tileformat 标签里的 extension 值。
interpolationMethod EnumInterpolationMode EnumInterpolationMode.NEAREST optional

临近插值法。
isCreatePyramid Boolean false optional

加载时创建金字塔文件,若已有，则先删除再创建。
isInterpolateImagery Boolean false optional

影像成像方式,如果设置为 true，将会变换影像成像方式。
isLocate Boolean false optional

数字高程数据定位开关，如果设置为 true，相机目标点会自动飞行至数字高程数据中心位置。
isVisible Boolean true optional

数字高程数据显隐开关，如果设置为 false，数据会在场景中隐藏。
isEnableBlacklist Boolean false optional

是否开启黑名单机制，如果开启，则数据加载失败时会进入黑名单。
maxLevel Number null optional

数据显示的最大层级，数字高程数据路径目录下tms.xml 中的 tileset 中 order 最大值。
maxX Number null optional

数据范围x向最大值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 maxx 值。
maxY Number null optional

数据范围Y向最大值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 maxy 值。
minLevel Number null optional

数据显示的最小层级，数字高程数据路径目录下tms.xml 中的 tileset 中 order 最小值。
minX Number null optional

数据范围X向最小值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 minx 值。
minY Number null optional

数据范围Y向最小值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 miny 值。
pitch Number -45.0 optional

自定义定位：俯仰角角度。
priorityOffset Number 0.0 optional

数字高程数据调度优先级，数值越大优先级越高。
renderOrder Number -10 optional

数字高程数据绘制顺序，数值越大绘制越往后，无特殊需求无需设置。
rotate Number 0.0 optional

自定义定位：方位角角度。
screen CooMap | ScreenObj null optional

所属窗口，默认为CooMap所拥有的主窗口。
srs String null optional

数据坐标参考，数字高程数据路径目录下的tms.xml中的 srs 标签的值。
then CBOCallback optional

对象创建完成后触发的回调事件，传出参数为DemData对象本体。
tileSize Number 256 optional

切割数据的瓦片大小, 数字高程数据路径目录下的tms.xml中的 tileformat 标签中的 height 的值。
type EnumTerrainType EnumTerrainType.SPLIT optional

数字高程数据的类型，此处默认为切割类型。 这些参数，程序会自动解析。
Examples:
// 创建数字高程切割数据对象并添加至三维场景中anywhere
var demData = new CooSDK.DemData({
     url: "http://127.0.0.1:8088/demo/DEM/tms.xml",
     isLocate: true
});
// 创建数字高程原始数据对象并添加至三维场景中
var demData = new CooSDK.DemData({
     url: "http://127.0.0.1:8088/demo/DEM/高程.img",
     type: CooSDK.EnumTerrainType.ORIGINAL,
     isCreatePyramid: false,
     isInterpolateImagery: false,
     interpolationMethod: CooSDK.EnumInterpolationMode.NEAREST,
     isLocate: true     
});
Demo:

Members

blacklistRequestCount : Number

黑名单机制中黑名单对象请求次数阈值。

Default Value: 5

blacklistUpdateTime : Number

获取或者设置黑名单重新请求间隔时长，单位：秒。

Default Value: 600

readonlydataType : String

获取数字高程数据类型名称。

distance : Number

获取或者设置自定义定位的视点距离数据中心点距离，该值不设置则无法进行自定义定位。

Default Value: null

flyTime : Number

获取或者设置自定义定位的定位飞行时间，单位：秒。

Default Value: 3.0

format : String

获取或者设置数据格式，数字高程数据路径目录下的tms.xml中的 tileformat 标签里的 mime-type 值。

readonlyid : Number

获取数字高程数据唯一标识符id。

interpolationMethod : EnumInterpolationMode

获取或者设置差值方式为临近插值法。

Default Value: EnumInterpolationMode.NEAREST

isCreatePyramid : Boolean

获取或者设置金字塔文件。

Default Value: false

isEnableBlacklist : Boolean

获取或者设置是否开启黑名单机制，如果开启，则数据加载失败时会进入黑名单。

Default Value: false

isInterpolateImagery : Boolean

获取或者设置影像成像方式。

Default Value: false

isLoad : Boolean

获取或者设置数字高程数据加载状态。

isLocate : Boolean

获取或者设置数字高程数据定位状态。

Default Value: false

isVisible : Boolean

获取或者设置数字高程数据显隐状态。

Default Value: true

maxLevel : Number

获取或者设置 数据显示的最大层级，数字高程数据路径目录下tms.xml 中的 tileset 中 order 最大值。

maxX : Number

获取或者设置数据范围x向最大值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 maxx 值。

maxY : Number

获取或者设置数据范围Y向最大值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 maxy 值。

minLevel : Number

获取或者设置数据显示的最小层级，数字高程数据路径目录下tms.xml 中的 tileset 中 order 最小值。

minX : Number

获取或者设置数据范围X向最小值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 minx 值。

minY : Number

获取或者设置数据范围Y向最小值，数字高程数据路径目录下的tms.xml中的 boundingbox 标签里的 miny 值。

pitch : Number

获取或者设置自定义定位的俯仰角角度。

Default Value: -45.0

priorityOffset : Number

获取或者设置数字高程数据调度优先级。

Default Value: 0.0

renderOrder : Number

获取或者设置数字高程数据绘制优先级。

Default Value: -10

rotate : Number

获取或者设置自定义定位的方位角角度。

Default Value: 0.0

screen : CooMap|ScreenObj

获取或者设置所属窗口，默认为CooMap所拥有的主窗口。

Default Value: null

srs : String

获取或者设置数据坐标参考，数字高程数据路径目录下的tms.xml中的 srs 标签的值。

then : CBOCallback

获取或者设置对象创建完成后触发的回调事件，传出参数为DemData对象本体。

Default Value: undefined

tileSize : Number

获取或者设置切割数据的瓦片大小, 数字高程数据路径目录下的tms.xml中的 tileformat 标签中的 height 的值。

Default Value: 256

type : EnumTerrainType

获取或者设置数据类型。

Default Value: SPLIT

url : String

获取或者设置数字高程数据路径，当路径含有tms.xml时，无需人工填写tms.xml内相关参数。

Methods

deserialize(url) → DemData

Name Type Description
url String

反序列化文件保存路径，支持本地路径和网络路径。
Returns:

数字高程对象。

destroy(reFunc)

从场景中销毁自身。

Name Type Default Description
reFunc NNCallback null optional

销毁地图成功后可传入的回调函数。
Returns:

null 空值。

Example:
// 销毁对象
demData = demData.destroy();

serialize(url)

Name Type Description
url String

序列化文件保存路径，仅支持本地路径。

update(props)

更新单个或者多个对象属性，使之立即生效。

一般用于多个属性的同时更新，避免逐个更新导致的性能开销过大。

Name Type Description
props Object optional

包含如下属性的Object：

Name Type Description
distance Number optional

自定义定位：视点距离数据中心点距离，该值为null时则无法进行自定义定位。
flyTime Number optional

自定义定位：定位飞行时间，单位：秒。
isLocate Boolean optional

数字高程数据定位开关，如果设置为 true，相机目标点会自动飞行至数字高程数据中心位置。
isVisible Boolean optional

数字高程数据显隐开关，如果设置为 false，数据会在场景中隐藏。
pitch Number optional

自定义定位：俯仰角角度。
rotate Number optional

自定义定位：方位角角度。
Example:
// 更新数据部分属性
demData.update({
   // 修改定位属性
   isLocate : true,
   // 修改显隐属性
   isVisible : false
});