DiscardMissingTileImagePolicy

介绍

DiscardMissingTileImagePolicy是CesiumJS中的一个类，用于定义当请求瓦片图像时，如果无法获取该图像，则如何处理该请求。该类提供了丰富的策略实现，以支持开发人员在不同的场景下处理缺失瓦片图像请求。

构造函数

new Cesium.DiscardMissingTileImagePolicy(options)

options

类型: Object

该参数是可选的，其中包含以下属性：

• missingImageUrl : 指定缺失图像的默认URL。

方法

shouldDiscardImage(imageUrl, image)

该方法实现了如何处理DiscardMissingTileImagePolicy实例中的缺失图像策略, 并且此方法只有在服务器返回以下错误码时才会触发:

• 404 Not Found

• 400 Bad Request

• 401 Unauthorized

• 403 Forbidden

• 502 Bad Gateway

• 504 Gateway Timeout

下面可选择的策略是，使用默认图片或者丢弃和忽略图像，这两个策略可以修改如下参数：

• DiscardMissingTileImagePolicy.prototype.defaultImage - 默认图像。

• DiscardMissingTileImagePolicy.ThrowWhenNoResource - 是否抛出异常

如果处理成功则返回值为true，否则返回值为false

示例

下面的示例展示了如何使用DiscardMissingTileImagePolicy 类:

// 所有使用此策略的瓦片图片请求将使用默认图像
var policy = new Cesium.DiscardMissingTileImagePolicy({
    missingImageUrl: 'path/to/errorImage.png'
});

// 使用策略
var imageLayer = new Cesium.UrlTemplateImageryProvider({
    url:'https://myUrl/{z}/{x}/{y}.png',
    credit : 'myCredit',
    minimumLevel: 0,
    maximumLevel: 18,
    subdomains:["a","b","c"],
    tilingScheme : new Cesium.WebMercatorTilingScheme(),
    imagePolicy: policy
});

参考

DiscardMissingTileImagePolicy

CesiumJS