Module: ol/source/GeoTIFF

ol/source/GeoTIFF


Classes

GeoTIFFSource

Type Definitions

GDALMetadata{Object}

Properties:
Name Type Description
STATISTICS_MINIMUM string

最小值(字符串形式)。

STATISTICS_MAXIMUM string

最大值(字符串形式)。

GeoKeys{Object}

Properties:
Name Type Description
GTModelTypeGeoKey number

模型类型。

GTRasterTypeGeoKey number

栅格类型。

GeogAngularUnitsGeoKey number

角度单位。

GeogInvFlatteningGeoKey number

扁率倒数。

GeogSemiMajorAxisGeoKey number

长半轴。

GeographicTypeGeoKey number

地理坐标系代码。

ProjLinearUnitsGeoKey number

投影线性单位代码。

ProjectedCSTypeGeoKey number

投影坐标系代码。

GeoTIFFSourceOptions{Object}

Properties:
Name Type Description
forceXHR boolean
(defaults to false)

是否强制使用浏览器的 XMLHttpRequest API。

headers 对象。<string, string> | undefined

每个请求传递的额外键值对头部。键为头部名称,值为头部值。

credentials string | undefined

凭据的处理方式。参见 https://developer.mozilla.org/en-US/docs/Web/API/fetch 了解参考和可能的值

maxRanges number | undefined

单个多范围请求中请求的最大范围数。默认仅使用单个范围。

allowFullFile boolean
(defaults to false)

当仅请求一部分时是否接受完整文件。仅在您知道源图像足够小以适应内存时使用。

blockSize number
(defaults to 65536)

要使用的块大小。

cacheSize number
(defaults to 100)

LRU 缓存中应保留的块数。

Options{Object}

Properties:
Name Type Description
attributions AttributionLike | undefined

归属信息。

sources Array<SourceInfo>

GeoTIFF 数据源信息列表。当多个数据源的分辨率集在应用缩放后相等时,可以组合使用。数据源列表定义了从每个 GeoTIFF 读取的输入波段与数据瓦片提供的输出波段之间的映射。要控制从每个 GeoTIFF 读取哪些波段,请使用 bands 属性。例如,如果指定两个数据源,一个有 3 个波段并配置了 nodata,另一个有 1 个波段,则生成的数据瓦片将有 5 个波段:3 个来自第一个数据源,1 个来自第一个数据源的 alpha 波段,1 个来自第二个数据源。

sourceOptions GeoTIFFSourceOptions | undefined

传递给 geotiff.jsfromUrlfromUrls 方法的额外选项。

convertToRGB true | false | 'auto'
(defaults to false)

默认情况下,数据源的波段按原样读取。当读取 GeoTIFF 以显示为 RGB 图像时,将此设置为 true 会将其他色彩空间(YCbCr、CMYK)转换为 RGB。将此选项设置为 'auto' 会使 CMYK、YCbCr、CIELab 和 ICCLab 图像自动转换为 RGB。

normalize boolean
(defaults to true)

默认情况下,数据源数据根据栅格统计信息或每个数据源的 minmax 属性的缩放因子归一化为 0 到 1 之间的值。如果您想在样式表达式中使用原始值,请将此设置为 false。将此选项设置为 false 将使数据源上的任何 minmax 属性被忽略。

projection ProjectionLike | undefined

源投影。如果未提供,将从 GeoTIFF 元数据读取投影信息。

loadMissingProjection boolean
(defaults to false)

是否尝试加载缺失的投影定义。使用预配置的投影查找函数,可以通过 setProjectionCodeLookup 自定义。

transition number
(defaults to 250)

渲染的不透明度过渡持续时间。要禁用不透明度过渡,请传递 transition: 0

wrapX boolean
(defaults to false)

渲染瓦片网格范围以外的瓦片。

interpolate boolean
(defaults to true)

重采样时使用插值。默认情况下,使用线性插值进行数据重采样。如果为 false,则使用最近邻。

SourceInfo{Object}

Properties:
Name Type Description
url string | undefined

源 GeoTIFF 的 URL。

loader function | undefined

基于 URL 的数据源的自定义加载函数。使用 URL、请求头和中止信号调用。预期以 Response 解析。

overviews Array.<string> | undefined

概览 URL 列表,仅在提供 url 参数且未指定加载器时适用。

blob Blob | undefined

包含源 GeoTIFF 的 Blob。bloburl 互斥。

min number | Array.<(number|undefined)>
(defaults to 0)

最小源数据值。渲染值根据配置的最小值和最大值从 0 到 1 缩放。如果未提供且栅格统计信息可用,将使用统计信息。如果两者都不可用,将使用数据类型的最小值。要禁用此行为,请在构造函数中将 normalize 选项设置为 false。如果提供数组,值对应于文件中的波段(不是 bands 选项)。数组值可以保留 undefined 以触发默认行为。

max number | Array.<(number|undefined)> | undefined

最大源数据值。渲染值根据配置的最小值和最大值从 0 到 1 缩放。如果未提供且栅格统计信息可用,将使用统计信息。如果两者都不可用,将使用数据类型的最大值。要禁用此行为,请在构造函数中将 normalize 选项设置为 false。如果提供数组,值对应于文件中的波段(不是 bands 选项)。数组值可以保留 undefined 以触发默认行为。

nodata number | Array.<(number|undefined)> | undefined

要丢弃的值(覆盖元数据中的任何 nodata 值)。提供时,将向数据添加额外的 alpha 波段。GeoTIFF 元数据通常包含有关 nodata 值的信息,因此只有当您发现元数据中未提取这些信息时才需要设置此属性。如果提供数组,值对应于文件中的波段(不是 bands 选项)。数组值可以保留 undefined 以触发默认行为。

bands Array.<number> | undefined

要读取的波段编号(第一个波段为 1)。如果未提供,将读取所有波段。例如,如果 GeoTIFF 有蓝色(1)、绿色(2)、红色(3)和近红外(4)波段,而您只需要近红外波段,则配置 bands: [4]