OpenLayers v10.9.0 API - Class: GeoTIFFSource

new GeoTIFFSource(options) source/GeoTIFF.js, line 456

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.js 的 `fromUrl` 或 `fromUrls` 方法的额外选项。
`convertToRGB`	true \| false \| 'auto' (defaults to false)	默认情况下，数据源的波段按原样读取。当读取 GeoTIFF 以显示为 RGB 图像时，将此设置为 `true` 会将其他色彩空间（YCbCr、CMYK）转换为 RGB。将此选项设置为 `'auto'` 会使 CMYK、YCbCr、CIELab 和 ICCLab 图像自动转换为 RGB。
`normalize`	boolean (defaults to true)	默认情况下，数据源数据根据栅格统计信息或每个数据源的 `min` 和 `max` 属性的缩放因子归一化为 0 到 1 之间的值。如果您想在样式表达式中使用原始值，请将此设置为 `false`。将此选项设置为 `false` 将使数据源上的任何 `min` 和 `max` 属性被忽略。
`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，则使用最近邻。

触发事件：

change (BaseEvent) - 通用更改事件。当修订计数器增加时触发。
error (BaseEvent) - 通用错误事件。当发生错误时触发。
propertychange (ObjectEvent) - 当属性更改时触发。
tileloadend (TileSourceEvent) - 当a tile finishes loading, either when its data is loaded, or when loading was aborted because the tile is no longer needed.
tileloaderror (TileSourceEvent) - Triggered if tile loading results in an error. Note that this is not the right place to re-fetch tiles. See load for details.
tileloadstart (TileSourceEvent) - 当瓦片开始加载时触发。

Extends

DataTileSource

Methods

changed() inherited Observable.js, line 68

增加修订计数器并分发 'change' 事件。

clear() inherited source/Tile.js, line 258

移除数据源中所有缓存的重投影瓦片。下一个渲染周期将创建新的瓦片。

dispatchEvent(event){boolean | undefined} inherited events/Target.js, line 85

分发事件并调用所有监听此类型事件的监听器。事件参数可以是一个字符串或一个具有 type 属性的对象。

Name	Type	Description
`event`	BaseEvent \| string	事件对象。

返回值：

如果有人在事件对象上调用了 preventDefault 或任何监听器返回 false，则返回 false。

get(key){*} inherited Object.js, line 136

获取一个值。

Name	Type	Description
`key`	string	键名。

返回值：

值。

getAttributions(){Attribution} inherited source/Source.js, line 129

获取数据源的归属函数。

返回值：

Attribution function.

getAttributionsCollapsible(){boolean} inherited source/Source.js, line 137

返回值：

归属信息是否可折叠。

getKeys(){Array.<string>} inherited Object.js, line 149

获取对象属性名列表。

返回值：

属性名列表。

getProjection(){Projection | null} inherited source/Source.js, line 146

获取数据源的投影。

返回值：

投影。

getProperties(){NoInfer.<Properties>} inherited Object.js, line 158

获取包含所有属性名和值的对象。

返回值：

对象。

getRevision(){number} inherited Observable.js, line 79

获取此对象的版本号。每次对象被修改时，其版本号将递增。

返回值：

版本号。

getState(){State} inherited source/Source.js, line 170

获取数据源的状态，可能的状态参见 State。

返回值：

状态。

getTileGrid(){TileGrid | null} inherited source/Tile.js, line 190

返回瓦片数据源的瓦片网格。

返回值：

瓦片网格。

getView(){Promise<ViewOptions>} source/GeoTIFF.js, line 1189

获取基于数据源的视图属性的 Promise。将此函数的结果用作地图构造函数中的 view 选项。

const source = new GeoTIFF(options);

const map = new Map({
  target: 'map',
  layers: [
    new TileLayer({
      source: source,
    }),
  ],
  view: source.getView(),
});

返回值：

A promise for view-related properties.

on(type, listener){EventsKey | Array<EventsKey>} inherited Observable.js, line 152

监听特定类型的事件。

Name	Type	Description
`type`	string \| Array.<string>	事件类型或事件类型数组。
`listener`	function	监听器函数。

返回值：

监听器的唯一键。如果第一个参数是事件类型数组，则返回键的数组。

once(type, listener){EventsKey | Array<EventsKey>} inherited Observable.js, line 164

仅监听一次特定类型的事件。

Name	Type	Description
`type`	string \| Array.<string>	事件类型或事件类型数组。
`listener`	function	监听器函数。

返回值：

监听器的唯一键。如果第一个参数是事件类型数组，则返回键的数组。

set(key, value, silent) inherited Object.js, line 218

设置一个值。

Name	Type	Description
`key`	string	键名。
`value`	*	值。
`silent`	boolean \| undefined	更新但不触发事件。

setAttributions(attributions) inherited source/Source.js, line 203

设置数据源的归属信息。

Name	Type	Description
`attributions`	AttributionLike \| undefined	归属信息。可以作为字符串、Array<string>、Attribution 或 undefined 传入。

setProperties(values, silent) inherited Object.js, line 238

设置一组键值对。注意，这会更改任何现有属性并添加新属性（不会移除任何现有属性）。

Name	Type	Description
`values`	Partial.<NoInfer.<Properties>>	值。
`silent`	boolean \| undefined	更新但不触发事件。

setTileGridForProjection(projection, tilegrid) inherited source/DataTile.js, line 468

设置在将瓦片重投影到给定投影时使用的瓦片网格，而不是默认的瓦片网格rojection.

当无法创建默认瓦片网格（例如投影未定义范围）或出于优化原因（自定义瓦片尺寸、分辨率等）时，这可能很有用。

Name	Type	Description
`projection`	ProjectionLike	投影。
`tilegrid`	TileGrid	用于投影的瓦片网格。

un(type, listener) inherited Observable.js, line 173

取消监听特定类型的事件。

Name	Type	Description
`type`	string \| Array.<string>	事件类型或事件类型数组。
`listener`	function	监听器函数。

unset(key, silent) inherited Object.js, line 262

取消设置一个属性。

Name	Type	Description
`key`	string	键名。
`silent`	boolean \| undefined	取消设置但不触发事件。