ThreeDTileset - Documentation

Constructor

new ThreeDTileset(options)

Author:

Example

var tileset = new HczjEarth.ThreeDTileset({
        url: "http://data.marsgis.cn/3dtiles/jzw-shanghai/tileset.json",
        show : true,
        id : "shanghai",
        name : "上海白模",
        allowPicking : true
    });
    tilesetLayer.add(tileset);

Parameters:

Name Type Description

options

Object

对象，具有以下属性：

Properties

Name	Type	Attributes	Default	Description
`id`	String	<optional>	`Cesium.createGuid()`	id
`name`	String	<optional>	`""`	名称
`allowPicking`	Boolean	<optional>	`false`	是否可以选中
`url`	Cesium.Resource \| String \| Promise.<Resource> \| Promise.<String>			指向tileset JSON文件的url。
`show`	Boolean	<optional>	`true`	确定是否显示tileset。
`modelMatrix`	Cesium.Matrix4	<optional>	`Cesium.Matrix4.IDENTITY`	一个4x4变换矩阵，转换tileset的根瓦片。
`shadows`	Cesium.ShadowMode	<optional>	`Cesium.ShadowMode.ENABLED`	确定tileset是否从每个光源投射或接收阴影。
`maximumScreenSpaceError`	Number	<optional>	`16`	用于驱动细节细化级别的最大屏幕空间误差。
`maximumMemoryUsage`	Number	<optional>	`512`	tileset可以使用的最大内存（以MB为单位）。
`cullWithChildrenBounds`	Boolean	<optional>	`true`	优化选项。是否使用子包围体的合并来剔除瓦片。
`cullRequestsWhileMoving`	Boolean	<optional>	`true`	优化选项。不要请求那些可能因为相机的移动而没有使用的瓦片。
`cullRequestsWhileMovingMultiplier`	Number	<optional>	`60.0`	优化选项。用于移动时剔除请求的乘法器（multiplier）。较大的是更有积极性的剔除，较小的是不那么有积极性的剔除。
`preloadWhenHidden`	Boolean	<optional>	`false`	当`tileset.show`为`false`时预加载瓦片。加载瓦片，就好像瓦片是可见的，但不渲染它们。
`preloadFlightDestinations`	Boolean	<optional>	`true`	优化选项。当相机飞行时，在相机的飞行目的地预加载瓦片。
`preferLeaves`	Boolean	<optional>	`false`	优化选项。首选加载子代。
`dynamicScreenSpaceError`	Boolean	<optional>	`false`	优化选项。减少远离相机的瓦片的屏幕空间误差。
`dynamicScreenSpaceErrorDensity`	Number	<optional>	`0.00278`	用于调整动态屏幕空间误差的密度，类似于雾密度。
`dynamicScreenSpaceErrorFactor`	Number	<optional>	`4.0`	用于增加计算出的动态屏幕空间误差的因子。
`dynamicScreenSpaceErrorHeightFalloff`	Number	<optional>	`0.25`	密度开始下降的tileset的高度的比率。
`progressiveResolutionHeightFraction`	Number	<optional>	`0.3`	如果介于（0.0，0.5]之间，则将优先考虑屏幕空间错误或高于屏幕空间错误的图块，以降低 `progressiveResolutionHeightFraction*screenHeight` 的屏幕分辨率，这可以在下载全分辨率瓦片时，快速得到一个图层。
`foveatedScreenSpaceError`	Boolean	<optional>	`true`	优化选项。通过临时提高屏幕边缘周围的屏幕空间误差来优先加载屏幕中心的图像块。加载`Cesium3DTileset#foveatedConeSize`所确定的屏幕中心的所有瓦片后，屏幕空间误差将恢复正常。
`foveatedConeSize`	Number	<optional>	`0.1`	优化选项。当`Cesium3DTileset#foveatedScreenSpaceError`为true时，用于控制确定哪些瓦片被延迟的圆锥大小。圆锥内的瓦片立即被加载。位于圆锥外部的瓦片可能会根据它们位于圆锥外部的距离和屏幕空间误差而延迟。这是由`Cesium3DTileset#foveatedInterpolationCallback`和`Cesium3DTileset#foveatedMinimumScreenSpaceErrorRelaxation`控制的。将此设置为0.0意味着圆锥将是由相机位置及其视图方向形成的直线。将此设置为1.0意味着圆锥将包含相机的整个视场，关闭效果。
`foveatedMinimumScreenSpaceErrorRelaxation`	Number	<optional>	`0.0`	优化选项。当`Cesium3DTileset#foveatedScreenSpaceError`为true时使用，用于控制位于中心凹锥体外的瓦片的起始屏幕空间误差松弛。根据提供的`Cesium3DTileset#foveatedInterpolationCallback`，屏幕空间误差将从tileset值开始上升到`Cesium3DTileset#maximumScreenSpaceError`。
`foveatedInterpolationCallback`	Cesium3DTileset~foveatedInterpolationCallback	<optional>	`Math.lerp`	优化选项。当`Cesium3DTileset#foveatedScreenSpaceError`为true时，用于控制在圆锥体中心凹外的平铺块的屏幕空间误差上升多少，在`Cesium3DTileset#foveatedMinimumScreenSpaceErrorRelaxation`和`Cesium3DTileset#maximumScreenSpaceError`之间插值。
`foveatedTimeDelay`	Number	<optional>	`0.2`	优化选项。当`Cesium3DTileset#foveatedScreenSpaceError`为true时，用于控制相机停止移动后延迟的瓦片开始加载之前等待的时间（以秒为单位）。这个时间延迟可以防止在相机移动时请求屏幕边缘的瓦片。将此设置为0.0将立即请求任何给定视图中的所有瓦片。
`skipLevelOfDetail`	Boolean	<optional>	`true`	优化选项。确定在遍历过程中是否应该应用跳过LOD级别。
`baseScreenSpaceError`	Number	<optional>	`1024`	当`skipLevelOfDetail`为`true`时，必须达到的屏幕空间误差才能跳过的LOD级别。
`skipScreenSpaceErrorFactor`	Number	<optional>	`16`	当`skipLevelOfDetail`为`true`时，定义要跳过的最小屏幕空间误差的乘数。与`skipLevels`一起使用，以确定加载哪些瓦片。
`skipLevels`	Number	<optional>	`1`	当`skipLevelOfDetail`为`true`时，定义加载瓦片时要跳过的最小级别数。当为0时，不会跳过任何级别。与`skipScreenSpaceErrorFactor`结合使用，以确定加载哪些瓦片。
`immediatelyLoadDesiredLevelOfDetail`	Boolean	<optional>	`false`	当`skipLevelOfDetail`为`true`时，只有满足最大屏幕空间错误的瓦片才会被下载。忽略跳过的因素，只加载所需的瓦片。
`loadSiblings`	Boolean	<optional>	`false`	当`skipLevelOfDetail`为`true`时，确定在遍历过程中是否总是下载可见瓦片的同级。
`clippingPlanes`	Cesium.ClippingPlaneCollection	<optional>		`Cesium.ClippingPlaneCollection`用于选择性地禁用渲染tileset。
`classificationType`	Cesium.ClassificationType	<optional>		确定是否地形，3D Tiles或两者都将被分类这个tileset。有关限制的详细信息，请参见`Cesium3DTileset#classificationType`。
`ellipsoid`	Cesium.Ellipsoid	<optional>	`Cesium.Ellipsoid.WGS84`	决定地球大小和形状的椭球体。
`pointCloudShading`	Object	<optional>		构造`Cesium.PointCloudShading`对象的选项，以根据几何误差和光照来控制点衰减。
`imageBasedLightingFactor`	Cesium.Cartesian2	<optional>	`new Cesium.Cartesian2(1.0, 1.0)`	从地球，天空，大气和恒星天空盒缩放漫反射和基于图像反射的光照。
`lightColor`	Cesium.Cartesian3	<optional>		用来给模型阴影的阳光的颜色和强度。
`luminanceAtZenith`	Number	<optional>	`0.2`	太阳在天顶的亮度单位为千坎德拉每平方米，用于该模型的程序环境地图。
`sphericalHarmonicCoefficients`	Array.<Cesium.Cartesian3>	<optional>		三阶球谐函数系数用于基于图像的光照漫反射颜色。
`specularEnvironmentMaps`	String	<optional>		一个指向KTX文件的URL，该文件包含镜面反射光照和复杂的镜面反射贴图的立方体映射。
`debugHeatmapTilePropertyName`	String	<optional>		要作为热力图着色的瓦片变量。所有渲染的瓦片将相对于彼此的指定变量值着色。
`debugFreezeFrame`	Boolean	<optional>	`false`	仅供调试。确定是否仅使用上一帧中的瓦片进行渲染。
`debugColorizeTiles`	Boolean	<optional>	`false`	仅供调试。当为true时，为每个瓦片分配随机颜色。
`debugWireframe`	Boolean	<optional>	`false`	仅供调试。当为true时，将每个瓦片的内容渲染为一个线框。
`debugShowBoundingVolume`	Boolean	<optional>	`false`	仅供调试。当为true时，为每个瓦片渲染包围体。
`debugShowContentBoundingVolume`	Boolean	<optional>	`false`	仅供调试。当为true时，为每个瓦片的内容渲染包围体。
`debugShowViewerRequestVolume`	Boolean	<optional>	`false`	仅供调试。当为true时，为每个瓦片渲染查看器请求体。
`debugShowGeometricError`	Boolean	<optional>	`false`	仅供调试。当为true时，绘制标签以指示每个瓦片的几何误差。
`debugShowRenderingStatistics`	Boolean	<optional>	`false`	仅供调试。当为true时，绘制标签以指示每个瓦片的指令、点、三角形和要素的数量。
`debugShowMemoryUsage`	Boolean	<optional>	`false`	仅供调试。如果为true，则绘制标签以指示每个瓦片使用的纹理和几何内存（以兆字节为单位）。
`debugShowUrl`	Boolean	<optional>	`false`	仅供调试。如果为true，则绘制标签以指示每个瓦片的url。

Throws:

tileset必须是3D Tiles版本0.0或1.0。
Type DeveloperError

Extends

Cesium.Cesium3DTileset

Members

allowPicking :Boolean

Default Value:

false

获取或设置3DTileset是否可选中。

Type:

Boolean

(readonly) id :String

获取3DTileset的唯一标识符。

Type:

String

name :String

Default Value:

获取或设置3DTileset的名称。

Type:

String