/** * @module ol/source/Zoomify */ import {DEFAULT_TILE_SIZE} from '../tilegrid/common.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 './TileImage.js'; import TileGrid from '../tilegrid/TileGrid.js'; /** * @enum {string} */ const TierSizeCalculation = { DEFAULT: 'default', TRUNCATED: 'truncated' }; export class CustomTile extends ImageTile { /** * @param {number} tilePixelRatio Tile pixel ratio to display the tile * @param {import("../tilegrid/TileGrid.js").default} tileGrid TileGrid that the tile belongs to. * @param {import("../tilecoord.js").TileCoord} tileCoord Tile coordinate. * @param {TileState} state State. * @param {string} src Image source URI. * @param {?string} crossOrigin Cross origin. * @param {import("../Tile.js").LoadFunction} tileLoadFunction Tile load function. * @param {import("../Tile.js").Options=} opt_options Tile options. */ constructor(tilePixelRatio, tileGrid, tileCoord, state, src, crossOrigin, tileLoadFunction, opt_options) { super(tileCoord, state, src, crossOrigin, tileLoadFunction, opt_options); /** * @private * @type {HTMLCanvasElement|HTMLImageElement|HTMLVideoElement} */ this.zoomifyImage_ = null; /** * @private * @type {import("../size.js").Size} */ this.tileSize_ = toSize(tileGrid.getTileSize(tileCoord[0])).map( function(x) { return x * tilePixelRatio; } ); } /** * @inheritDoc */ getImage() { if (this.zoomifyImage_) { return this.zoomifyImage_; } const image = super.getImage(); 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 {import("./Source.js").AttributionLike} [attributions] Attributions. * @property {number} [cacheSize] Tile cache size. The default depends on the screen size. Will increase if too small. * @property {null|string} [crossOrigin] The `crossOrigin` attribute for loaded images. Note that * you must provide a `crossOrigin` value you want to access pixel data with the Canvas renderer. * See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail. * @property {import("../proj.js").ProjectionLike} [projection] Projection. * @property {number} [tilePixelRatio] The pixel ratio used by the tile service. For example, if the tile service advertizes 256px by 256px tiles but actually sends 512px by 512px images (for retina/hidpi devices) then `tilePixelRatio` should be set to `2` * @property {number} [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 {import("../size.js").Size} [size] Size of the image. * @property {import("../extent.js").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. * @property {number} [zDirection=0] Indicate which resolution should be used * by a renderer if the view resolution does not match any resolution of the tile source. * If 0, the nearest resolution will be used. If 1, the nearest lower resolution * will be used. If -1, the nearest higher resolution will be used. */ /** * @classdesc * Layer source for tile data in Zoomify format (both Zoomify and Internet * Imaging Protocol are supported). * @api */ class Zoomify extends TileImage { /** * @param {Options=} opt_options Options. */ constructor(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; const tilePixelRatio = options.tilePixelRatio || 1; 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 {import("../Tile.js").UrlFunction} Tile URL function. */ function createFromTemplate(template) { return ( /** * @param {import("../tilecoord.js").TileCoord} tileCoord Tile Coordinate. * @param {number} pixelRatio Pixel ratio. * @param {import("../proj/Projection.js").default} 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]; const tileIndex = tileCoordX + tileCoordY * tierSizeInTiles[tileCoordZ][0]; const tileSize = tileGrid.getTileSize(tileCoordZ); const tileWidth = Array.isArray(tileSize) ? tileSize[0] : tileSize; const tileGroup = ((tileIndex + tileCountUpToTier[tileCoordZ]) / tileWidth) | 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, tilePixelRatio, tileGrid); super({ attributions: options.attributions, cacheSize: options.cacheSize, crossOrigin: options.crossOrigin, projection: options.projection, tilePixelRatio: tilePixelRatio, reprojectionErrorThreshold: options.reprojectionErrorThreshold, tileClass: ZoomifyTileClass, tileGrid: tileGrid, tileUrlFunction: tileUrlFunction, transition: options.transition }); /** * @inheritDoc */ this.zDirection = options.zDirection; } } export default Zoomify;