Cesium3DTileset

三维模型瓦片数据集。本章节主要介绍扩展的API,更多原生接口参数请参阅原生API文档

new Cesium.Cesium3DTileset(options)

Name Type Description
options Object 构造参数请参见原生API。

Members

debugShowAxes : Boolean

坐标轴是否显示

geoRollingCurtainEnabled : Boolean

激活卷帘

visualSenseStyle

三维模型的放光高亮的样式
Example:
var vsStyle = new Cesium.GeoVisualSenseStyle({
     ...
});
new Cesium.Cesium3DTileset({
     url: "./tileset.json",
     visualSenseStyle : vsStyle,
})
//更多请参见 GeoVisualSenseStyle类

Methods

createDebugAxes(options)

创建模型的本地坐标系(ENU)的坐标轴。其中X轴是红色的,指向东方向;Y轴是绿色的,指向北方向;Z轴是蓝色的,指向椭球面表面的法线方向
Name Type Description
options Object 参数选项:
Name Type Default Description
viewer Viewer optional 三维球对象
length Number 300.0 optional 坐标轴的长度,单位(m)
width Number 10.0 optional 坐标轴的宽度,单位(像素)
show Boolean true optional 是否显示

geoRotateByHeadingPitchRoll(heading)

根据偏航角对模型进行旋转操作,单位(度),范围[0, 360]
Name Type Description
heading Number 偏航角
Deprecated: true
Example:
tileset.geoRotateByHeadingPitchRoll(60);

geoTranslateAndRotate(options)

对模型进行平移和旋转操作,以模型包围球中心为原点的站心坐标系为基准。平移是沿着站心坐标系的东北上方向进行操作;旋转是根据偏航角、倾角和翻滚角进行操作, 其中偏航角是围绕Z轴进行旋转,范围[0, 360],倾角是围绕Y轴进行旋转,范围[-180, 180],翻滚角是围绕X轴进行旋转,范围[0, 360]。
Name Type Description
options Object 参数选项:
Name Type Default Description
x Number 0.0 optional 向东平移,单位(m)
y Number 0.0 optional 向北平移,单位(m)
z Number 0.0 optional 向上平移,单位(m)
heading Number 0.0 optional 偏航角,范围[0, 360],单位(°)
pitch Number 0.0 optional 倾角,范围[-180, 180],单位(°)
roll Number 0.0 optional 翻滚角,范围[0, 360],单位(°)
Example:
tileset.geoTranslateAndRotate({
     x: 10,
     y: 10,
     z: 10,
     heading: 60,
     pitch: 60,
     roll: 0
});

geoTranslateByDistance(distanceAlongLongitude, distanceAlongLatitude, distanceAlongHeight)

将模型朝东北上平移
Name Type Description
distanceAlongLongitude Number 经度方向/向东,单位米
distanceAlongLatitude Number 维度方向/向北,单位米
distanceAlongHeight Number 海拔方向/向上,单位米
Deprecated: true
Example:
tileset.geoTranslateByDistance(1, 0, 0);
Demo:

removeDebugAxes()

移除坐标轴

resetTranslationRotation()

重置模型位置,还原到最初的状态

setPosition(lng, lat, height, extent)

定位模型到指定位置。该方法会修改原始数据,不建议使用。
Name Type Description
lng Number 经度或高斯坐标横坐标
lat Number 纬度或高斯坐标纵坐标
height Number optional 高程值,如果不指定,则默认为0
extent Object optional 平面三维模式下的范围基准
Examples:
// 球面三维模式
tileset.setPosition(120, 30, 500);
// 平面三维模式
tileset.setPosition(549123.6112007063, 4641936.051786534, 51, viewer.localOptions.extent);