/** * @module ol/source/Zoomify */ import {DEFAULT_TILE_SIZE} from '../tilegrid/common.js'; import {inherits} from '../index.js'; import ImageTile from '../ImageTile.js'; import TileState from '../TileState.js'; import {expandUrl, createFromTileUrlFunctions} from '../tileurlfunction.js'; import {assert} from '../asserts.js'; import {createCanvasContext2D} from '../dom.js'; import {getTopLeft} from '../extent.js'; import {toSize} from '../size.js'; import TileImage from '../source/TileImage.js'; import TileGrid from '../tilegrid/TileGrid.js'; /** * @enum {string} */ const TierSizeCalculation = { DEFAULT: 'default', TRUNCATED: 'truncated' }; /** * @constructor * @extends {module:ol/ImageTile~ImageTile} * @param {module:ol/tilegrid/TileGrid~TileGrid} tileGrid TileGrid that the tile belongs to. * @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate. * @param {module:ol/TileState~TileState} state State. * @param {string} src Image source URI. * @param {?string} crossOrigin Cross origin. * @param {module:ol/Tile~LoadFunction} tileLoadFunction Tile load function. * @param {module:ol/Tile~Options=} opt_options Tile options. */ export const CustomTile = function( tileGrid, tileCoord, state, src, crossOrigin, tileLoadFunction, opt_options) { ImageTile.call(this, tileCoord, state, src, crossOrigin, tileLoadFunction, opt_options); /** * @private * @type {HTMLCanvasElement|HTMLImageElement|HTMLVideoElement} */ this.zoomifyImage_ = null; /** * @private * @type {module:ol/size~Size} */ this.tileSize_ = toSize(tileGrid.getTileSize(tileCoord[0])); }; inherits(CustomTile, ImageTile); /** * @inheritDoc */ CustomTile.prototype.getImage = function() { if (this.zoomifyImage_) { return this.zoomifyImage_; } const image = ImageTile.prototype.getImage.call(this); if (this.state == TileState.LOADED) { const tileSize = this.tileSize_; if (image.width == tileSize[0] && image.height == tileSize[1]) { this.zoomifyImage_ = image; return image; } else { const context = createCanvasContext2D(tileSize[0], tileSize[1]); context.drawImage(image, 0, 0); this.zoomifyImage_ = context.canvas; return context.canvas; } } else { return image; } }; /** * @typedef {Object} Options * @property {ol.AttributionLike} [attributions] Attributions. * @property {number} [cacheSize=2048] Cache size. * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images. Note that * you must provide a `crossOrigin` value if you are using the WebGL renderer or if you want to * access pixel data with the Canvas renderer. See * {@link https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image} for more detail. * @property {module:ol/proj~ProjectionLike} [projection] Projection. * @property {boolean} [reprojectionErrorThreshold=0.5] Maximum allowed reprojection error (in pixels). * Higher values can increase reprojection performance, but decrease precision. * @property {string} [url] URL template or base URL of the Zoomify service. * A base URL is the fixed part * of the URL, excluding the tile group, z, x, and y folder structure, e.g. * `http://my.zoomify.info/IMAGE.TIF/`. A URL template must include * `{TileGroup}`, `{x}`, `{y}`, and `{z}` placeholders, e.g. * `http://my.zoomify.info/IMAGE.TIF/{TileGroup}/{z}-{x}-{y}.jpg`. * Internet Imaging Protocol (IIP) with JTL extension can be also used with * `{tileIndex}` and `{z}` placeholders, e.g. * `http://my.zoomify.info?FIF=IMAGE.TIF&JTL={z},{tileIndex}`. * A `{?-?}` template pattern, for example `subdomain{a-f}.domain.com`, may be * used instead of defining each one separately in the `urls` option. * @property {string} [tierSizeCalculation] Tier size calculation method: `default` or `truncated`. * @property {ol.Size} [size] Size of the image. * @property {ol.Extent} [extent] Extent for the TileGrid that is created. * Default sets the TileGrid in the * fourth quadrant, meaning extent is `[0, -height, width, 0]`. To change the * extent to the first quadrant (the default for OpenLayers 2) set the extent * as `[0, 0, width, height]`. * @property {number} [transition] Duration of the opacity transition for rendering. * To disable the opacity transition, pass `transition: 0`. * @property {number} [tileSize=256] Tile size. Same tile size is used for all zoom levels. */ /** * @classdesc * Layer source for tile data in Zoomify format (both Zoomify and Internet * Imaging Protocol are supported). * * @constructor * @extends {ol.source.TileImage} * @param {module:ol/source/Zoomify~Options=} opt_options Options. * @api */ const Zoomify = function(opt_options) { const options = opt_options || {}; const size = options.size; const tierSizeCalculation = options.tierSizeCalculation !== undefined ? options.tierSizeCalculation : TierSizeCalculation.DEFAULT; const imageWidth = size[0]; const imageHeight = size[1]; const extent = options.extent || [0, -size[1], size[0], 0]; const tierSizeInTiles = []; const tileSize = options.tileSize || DEFAULT_TILE_SIZE; let tileSizeForTierSizeCalculation = tileSize; switch (tierSizeCalculation) { case TierSizeCalculation.DEFAULT: while (imageWidth > tileSizeForTierSizeCalculation || imageHeight > tileSizeForTierSizeCalculation) { tierSizeInTiles.push([ Math.ceil(imageWidth / tileSizeForTierSizeCalculation), Math.ceil(imageHeight / tileSizeForTierSizeCalculation) ]); tileSizeForTierSizeCalculation += tileSizeForTierSizeCalculation; } break; case TierSizeCalculation.TRUNCATED: let width = imageWidth; let height = imageHeight; while (width > tileSizeForTierSizeCalculation || height > tileSizeForTierSizeCalculation) { tierSizeInTiles.push([ Math.ceil(width / tileSizeForTierSizeCalculation), Math.ceil(height / tileSizeForTierSizeCalculation) ]); width >>= 1; height >>= 1; } break; default: assert(false, 53); // Unknown `tierSizeCalculation` configured break; } tierSizeInTiles.push([1, 1]); tierSizeInTiles.reverse(); const resolutions = [1]; const tileCountUpToTier = [0]; for (let i = 1, ii = tierSizeInTiles.length; i < ii; i++) { resolutions.push(1 << i); tileCountUpToTier.push( tierSizeInTiles[i - 1][0] * tierSizeInTiles[i - 1][1] + tileCountUpToTier[i - 1] ); } resolutions.reverse(); const tileGrid = new TileGrid({ tileSize: tileSize, extent: extent, origin: getTopLeft(extent), resolutions: resolutions }); let url = options.url; if (url && url.indexOf('{TileGroup}') == -1 && url.indexOf('{tileIndex}') == -1) { url += '{TileGroup}/{z}-{x}-{y}.jpg'; } const urls = expandUrl(url); /** * @param {string} template Template. * @return {module:ol/Tile~UrlFunction} Tile URL function. */ function createFromTemplate(template) { return ( /** * @param {module:ol/tilecoord~TileCoord} tileCoord Tile Coordinate. * @param {number} pixelRatio Pixel ratio. * @param {module:ol/proj/Projection~Projection} projection Projection. * @return {string|undefined} Tile URL. */ function(tileCoord, pixelRatio, projection) { if (!tileCoord) { return undefined; } else { const tileCoordZ = tileCoord[0]; const tileCoordX = tileCoord[1]; const tileCoordY = -tileCoord[2] - 1; const tileIndex = tileCoordX + tileCoordY * tierSizeInTiles[tileCoordZ][0]; const tileSize = tileGrid.getTileSize(tileCoordZ); const tileGroup = ((tileIndex + tileCountUpToTier[tileCoordZ]) / tileSize) | 0; const localContext = { 'z': tileCoordZ, 'x': tileCoordX, 'y': tileCoordY, 'tileIndex': tileIndex, 'TileGroup': 'TileGroup' + tileGroup }; return template.replace(/\{(\w+?)\}/g, function(m, p) { return localContext[p]; }); } }); } const tileUrlFunction = createFromTileUrlFunctions(urls.map(createFromTemplate)); const ZoomifyTileClass = CustomTile.bind(null, tileGrid); TileImage.call(this, { attributions: options.attributions, cacheSize: options.cacheSize, crossOrigin: options.crossOrigin, projection: options.projection, reprojectionErrorThreshold: options.reprojectionErrorThreshold, tileClass: ZoomifyTileClass, tileGrid: tileGrid, tileUrlFunction: tileUrlFunction, transition: options.transition }); }; inherits(Zoomify, TileImage); export default Zoomify;