373 lines
11 KiB
JavaScript
373 lines
11 KiB
JavaScript
/**
|
|
* @module ol/source/TileImage
|
|
*/
|
|
import {ENABLE_RASTER_REPROJECTION} from '../reproj/common.js';
|
|
import {getUid, inherits} from '../index.js';
|
|
import _ol_ImageTile_ from '../ImageTile.js';
|
|
import _ol_TileCache_ from '../TileCache.js';
|
|
import _ol_TileState_ from '../TileState.js';
|
|
import _ol_events_ from '../events.js';
|
|
import EventType from '../events/EventType.js';
|
|
import {equivalent, get as getProjection} from '../proj.js';
|
|
import _ol_reproj_Tile_ from '../reproj/Tile.js';
|
|
import _ol_source_UrlTile_ from '../source/UrlTile.js';
|
|
import _ol_tilecoord_ from '../tilecoord.js';
|
|
import _ol_tilegrid_ from '../tilegrid.js';
|
|
|
|
/**
|
|
* @classdesc
|
|
* Base class for sources providing images divided into a tile grid.
|
|
*
|
|
* @constructor
|
|
* @fires ol.source.Tile.Event
|
|
* @extends {ol.source.UrlTile}
|
|
* @param {olx.source.TileImageOptions} options Image tile options.
|
|
* @api
|
|
*/
|
|
var _ol_source_TileImage_ = function(options) {
|
|
|
|
_ol_source_UrlTile_.call(this, {
|
|
attributions: options.attributions,
|
|
cacheSize: options.cacheSize,
|
|
extent: options.extent,
|
|
logo: options.logo,
|
|
opaque: options.opaque,
|
|
projection: options.projection,
|
|
state: options.state,
|
|
tileGrid: options.tileGrid,
|
|
tileLoadFunction: options.tileLoadFunction ?
|
|
options.tileLoadFunction : _ol_source_TileImage_.defaultTileLoadFunction,
|
|
tilePixelRatio: options.tilePixelRatio,
|
|
tileUrlFunction: options.tileUrlFunction,
|
|
url: options.url,
|
|
urls: options.urls,
|
|
wrapX: options.wrapX,
|
|
transition: options.transition
|
|
});
|
|
|
|
/**
|
|
* @protected
|
|
* @type {?string}
|
|
*/
|
|
this.crossOrigin =
|
|
options.crossOrigin !== undefined ? options.crossOrigin : null;
|
|
|
|
/**
|
|
* @protected
|
|
* @type {function(new: ol.ImageTile, ol.TileCoord, ol.TileState, string,
|
|
* ?string, ol.TileLoadFunctionType, olx.TileOptions=)}
|
|
*/
|
|
this.tileClass = options.tileClass !== undefined ?
|
|
options.tileClass : _ol_ImageTile_;
|
|
|
|
/**
|
|
* @protected
|
|
* @type {Object.<string, ol.TileCache>}
|
|
*/
|
|
this.tileCacheForProjection = {};
|
|
|
|
/**
|
|
* @protected
|
|
* @type {Object.<string, ol.tilegrid.TileGrid>}
|
|
*/
|
|
this.tileGridForProjection = {};
|
|
|
|
/**
|
|
* @private
|
|
* @type {number|undefined}
|
|
*/
|
|
this.reprojectionErrorThreshold_ = options.reprojectionErrorThreshold;
|
|
|
|
/**
|
|
* @private
|
|
* @type {boolean}
|
|
*/
|
|
this.renderReprojectionEdges_ = false;
|
|
};
|
|
|
|
inherits(_ol_source_TileImage_, _ol_source_UrlTile_);
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.canExpireCache = function() {
|
|
if (!ENABLE_RASTER_REPROJECTION) {
|
|
return _ol_source_UrlTile_.prototype.canExpireCache.call(this);
|
|
}
|
|
if (this.tileCache.canExpireCache()) {
|
|
return true;
|
|
} else {
|
|
for (var key in this.tileCacheForProjection) {
|
|
if (this.tileCacheForProjection[key].canExpireCache()) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.expireCache = function(projection, usedTiles) {
|
|
if (!ENABLE_RASTER_REPROJECTION) {
|
|
_ol_source_UrlTile_.prototype.expireCache.call(this, projection, usedTiles);
|
|
return;
|
|
}
|
|
var usedTileCache = this.getTileCacheForProjection(projection);
|
|
|
|
this.tileCache.expireCache(this.tileCache == usedTileCache ? usedTiles : {});
|
|
for (var id in this.tileCacheForProjection) {
|
|
var tileCache = this.tileCacheForProjection[id];
|
|
tileCache.expireCache(tileCache == usedTileCache ? usedTiles : {});
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.getGutter = function(projection) {
|
|
if (ENABLE_RASTER_REPROJECTION &&
|
|
this.getProjection() && projection && !equivalent(this.getProjection(), projection)) {
|
|
return 0;
|
|
} else {
|
|
return this.getGutterInternal();
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @protected
|
|
* @return {number} Gutter.
|
|
*/
|
|
_ol_source_TileImage_.prototype.getGutterInternal = function() {
|
|
return 0;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.getOpaque = function(projection) {
|
|
if (ENABLE_RASTER_REPROJECTION &&
|
|
this.getProjection() && projection && !equivalent(this.getProjection(), projection)) {
|
|
return false;
|
|
} else {
|
|
return _ol_source_UrlTile_.prototype.getOpaque.call(this, projection);
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.getTileGridForProjection = function(projection) {
|
|
if (!ENABLE_RASTER_REPROJECTION) {
|
|
return _ol_source_UrlTile_.prototype.getTileGridForProjection.call(this, projection);
|
|
}
|
|
var thisProj = this.getProjection();
|
|
if (this.tileGrid && (!thisProj || equivalent(thisProj, projection))) {
|
|
return this.tileGrid;
|
|
} else {
|
|
var projKey = getUid(projection).toString();
|
|
if (!(projKey in this.tileGridForProjection)) {
|
|
this.tileGridForProjection[projKey] =
|
|
_ol_tilegrid_.getForProjection(projection);
|
|
}
|
|
return /** @type {!ol.tilegrid.TileGrid} */ (this.tileGridForProjection[projKey]);
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.getTileCacheForProjection = function(projection) {
|
|
if (!ENABLE_RASTER_REPROJECTION) {
|
|
return _ol_source_UrlTile_.prototype.getTileCacheForProjection.call(this, projection);
|
|
}
|
|
var thisProj = this.getProjection(); if (!thisProj || equivalent(thisProj, projection)) {
|
|
return this.tileCache;
|
|
} else {
|
|
var projKey = getUid(projection).toString();
|
|
if (!(projKey in this.tileCacheForProjection)) {
|
|
this.tileCacheForProjection[projKey] = new _ol_TileCache_(this.tileCache.highWaterMark);
|
|
}
|
|
return this.tileCacheForProjection[projKey];
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @param {number} z Tile coordinate z.
|
|
* @param {number} x Tile coordinate x.
|
|
* @param {number} y Tile coordinate y.
|
|
* @param {number} pixelRatio Pixel ratio.
|
|
* @param {ol.proj.Projection} projection Projection.
|
|
* @param {string} key The key set on the tile.
|
|
* @return {!ol.Tile} Tile.
|
|
* @private
|
|
*/
|
|
_ol_source_TileImage_.prototype.createTile_ = function(z, x, y, pixelRatio, projection, key) {
|
|
var tileCoord = [z, x, y];
|
|
var urlTileCoord = this.getTileCoordForTileUrlFunction(
|
|
tileCoord, projection);
|
|
var tileUrl = urlTileCoord ?
|
|
this.tileUrlFunction(urlTileCoord, pixelRatio, projection) : undefined;
|
|
var tile = new this.tileClass(
|
|
tileCoord,
|
|
tileUrl !== undefined ? _ol_TileState_.IDLE : _ol_TileState_.EMPTY,
|
|
tileUrl !== undefined ? tileUrl : '',
|
|
this.crossOrigin,
|
|
this.tileLoadFunction,
|
|
this.tileOptions);
|
|
tile.key = key;
|
|
_ol_events_.listen(tile, EventType.CHANGE,
|
|
this.handleTileChange, this);
|
|
return tile;
|
|
};
|
|
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
_ol_source_TileImage_.prototype.getTile = function(z, x, y, pixelRatio, projection) {
|
|
var sourceProjection = /** @type {!ol.proj.Projection} */ (this.getProjection());
|
|
if (!ENABLE_RASTER_REPROJECTION ||
|
|
!sourceProjection || !projection || equivalent(sourceProjection, projection)) {
|
|
return this.getTileInternal(z, x, y, pixelRatio, sourceProjection || projection);
|
|
} else {
|
|
var cache = this.getTileCacheForProjection(projection);
|
|
var tileCoord = [z, x, y];
|
|
var tile;
|
|
var tileCoordKey = _ol_tilecoord_.getKey(tileCoord);
|
|
if (cache.containsKey(tileCoordKey)) {
|
|
tile = /** @type {!ol.Tile} */ (cache.get(tileCoordKey));
|
|
}
|
|
var key = this.getKey();
|
|
if (tile && tile.key == key) {
|
|
return tile;
|
|
} else {
|
|
var sourceTileGrid = this.getTileGridForProjection(sourceProjection);
|
|
var targetTileGrid = this.getTileGridForProjection(projection);
|
|
var wrappedTileCoord =
|
|
this.getTileCoordForTileUrlFunction(tileCoord, projection);
|
|
var newTile = new _ol_reproj_Tile_(
|
|
sourceProjection, sourceTileGrid,
|
|
projection, targetTileGrid,
|
|
tileCoord, wrappedTileCoord, this.getTilePixelRatio(pixelRatio),
|
|
this.getGutterInternal(),
|
|
function(z, x, y, pixelRatio) {
|
|
return this.getTileInternal(z, x, y, pixelRatio, sourceProjection);
|
|
}.bind(this), this.reprojectionErrorThreshold_,
|
|
this.renderReprojectionEdges_);
|
|
newTile.key = key;
|
|
|
|
if (tile) {
|
|
newTile.interimTile = tile;
|
|
newTile.refreshInterimChain();
|
|
cache.replace(tileCoordKey, newTile);
|
|
} else {
|
|
cache.set(tileCoordKey, newTile);
|
|
}
|
|
return newTile;
|
|
}
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @param {number} z Tile coordinate z.
|
|
* @param {number} x Tile coordinate x.
|
|
* @param {number} y Tile coordinate y.
|
|
* @param {number} pixelRatio Pixel ratio.
|
|
* @param {!ol.proj.Projection} projection Projection.
|
|
* @return {!ol.Tile} Tile.
|
|
* @protected
|
|
*/
|
|
_ol_source_TileImage_.prototype.getTileInternal = function(z, x, y, pixelRatio, projection) {
|
|
var tile = null;
|
|
var tileCoordKey = _ol_tilecoord_.getKeyZXY(z, x, y);
|
|
var key = this.getKey();
|
|
if (!this.tileCache.containsKey(tileCoordKey)) {
|
|
tile = this.createTile_(z, x, y, pixelRatio, projection, key);
|
|
this.tileCache.set(tileCoordKey, tile);
|
|
} else {
|
|
tile = this.tileCache.get(tileCoordKey);
|
|
if (tile.key != key) {
|
|
// The source's params changed. If the tile has an interim tile and if we
|
|
// can use it then we use it. Otherwise we create a new tile. In both
|
|
// cases we attempt to assign an interim tile to the new tile.
|
|
var interimTile = tile;
|
|
tile = this.createTile_(z, x, y, pixelRatio, projection, key);
|
|
|
|
//make the new tile the head of the list,
|
|
if (interimTile.getState() == _ol_TileState_.IDLE) {
|
|
//the old tile hasn't begun loading yet, and is now outdated, so we can simply discard it
|
|
tile.interimTile = interimTile.interimTile;
|
|
} else {
|
|
tile.interimTile = interimTile;
|
|
}
|
|
tile.refreshInterimChain();
|
|
this.tileCache.replace(tileCoordKey, tile);
|
|
}
|
|
}
|
|
return tile;
|
|
};
|
|
|
|
|
|
/**
|
|
* Sets whether to render reprojection edges or not (usually for debugging).
|
|
* @param {boolean} render Render the edges.
|
|
* @api
|
|
*/
|
|
_ol_source_TileImage_.prototype.setRenderReprojectionEdges = function(render) {
|
|
if (!ENABLE_RASTER_REPROJECTION ||
|
|
this.renderReprojectionEdges_ == render) {
|
|
return;
|
|
}
|
|
this.renderReprojectionEdges_ = render;
|
|
for (var id in this.tileCacheForProjection) {
|
|
this.tileCacheForProjection[id].clear();
|
|
}
|
|
this.changed();
|
|
};
|
|
|
|
|
|
/**
|
|
* Sets the tile grid to use when reprojecting the tiles to the given
|
|
* projection instead of the default tile grid for the projection.
|
|
*
|
|
* This can be useful when the default tile grid cannot be created
|
|
* (e.g. projection has no extent defined) or
|
|
* for optimization reasons (custom tile size, resolutions, ...).
|
|
*
|
|
* @param {ol.ProjectionLike} projection Projection.
|
|
* @param {ol.tilegrid.TileGrid} tilegrid Tile grid to use for the projection.
|
|
* @api
|
|
*/
|
|
_ol_source_TileImage_.prototype.setTileGridForProjection = function(projection, tilegrid) {
|
|
if (ENABLE_RASTER_REPROJECTION) {
|
|
var proj = getProjection(projection);
|
|
if (proj) {
|
|
var projKey = getUid(proj).toString();
|
|
if (!(projKey in this.tileGridForProjection)) {
|
|
this.tileGridForProjection[projKey] = tilegrid;
|
|
}
|
|
}
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* @param {ol.ImageTile} imageTile Image tile.
|
|
* @param {string} src Source.
|
|
*/
|
|
_ol_source_TileImage_.defaultTileLoadFunction = function(imageTile, src) {
|
|
imageTile.getImage().src = src;
|
|
};
|
|
export default _ol_source_TileImage_;
|