import Projection from '../../../../src/ol/proj/Projection.js'; import TileGrid from '../../../../src/ol/tilegrid/TileGrid.js'; import TileRange from '../../../../src/ol/TileRange.js'; import expect from '../../expect.js'; import { DEFAULT_MAX_ZOOM, DEFAULT_TILE_SIZE, } from '../../../../src/ol/tilegrid/common.js'; import {HALF_SIZE} from '../../../../src/ol/proj/epsg3857.js'; import { METERS_PER_UNIT, get as getProjection, } from '../../../../src/ol/proj.js'; import { createForExtent, createForProjection, createXYZ, getForProjection as getTileGridForProjection, } from '../../../../src/ol/tilegrid.js'; import {createOrUpdate} from '../../../../src/ol/extent.js'; describe('ol/tilegrid/TileGrid.js', function () { let resolutions; let origin; let tileSize; beforeEach(function () { resolutions = [1000, 500, 250, 100]; origin = [0, 0]; tileSize = 100; }); describe('create valid', function () { it('does not throw an exception', function () { expect(function () { return new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); }).not.to.throwException(); }); }); describe('create with duplicate resolutions', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 50, 25, 10], origin: origin, tileSize: tileSize, }); }).to.throwException(); }); }); describe('create with out of order resolutions', function () { it('throws an exception', function () { const resolutions = [100, 25, 50, 10]; expect(function () { return new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); }).to.throwException(); }); }); describe('create with multiple origins', function () { it('does not throw an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], origins: [origin, origin, origin, origin], tileSize: tileSize, }); }).not.to.throwException(); }); }); describe('create with both origin and multiple origins', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], origins: [origin, origin, origin, origin], origin: origin, tileSize: tileSize, }); }).to.throwException(); }); }); describe('create with too few origins', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], origins: [origin, origin, origin], tileSize: tileSize, }); }).to.throwException(); }); }); describe('create with too many origins', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], origins: [origin, origin, origin, origin, origin], tileSize: tileSize, }); }).to.throwException(); }); }); describe('create with multiple tileSizes', function () { it('does not throw an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], tileSizes: [tileSize, tileSize, tileSize, tileSize], origin: origin, }); }).not.to.throwException(); }); }); describe('create with both tileSize and multiple tileSizes', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], tileSizes: [tileSize, tileSize, tileSize, tileSize], tileSize: tileSize, origin: origin, }); }).to.throwException(); }); }); describe('create with too few tileSizes', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], tileSizes: [tileSize, tileSize, tileSize], origin: origin, }); }).to.throwException(); }); }); describe('create with too many tileSizes', function () { it('throws an exception', function () { expect(function () { return new TileGrid({ resolutions: [100, 50, 25, 10], tileSizes: [tileSize, tileSize, tileSize, tileSize, tileSize], origin: origin, }); }).to.throwException(); }); }); describe('create with origin', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ origin: [10, 20], tileSize: 10, resolutions: [1], }); }); it('returns the configured origin', function () { expect(tileGrid.getOrigin()).to.eql([10, 20]); }); it('returns null for an unknown extent', function () { expect(tileGrid.getExtent()).to.equal(null); }); it('returns null for an unknown full tile range', function () { expect(tileGrid.getFullTileRange(0)).to.equal(null); }); }); describe('create with extent', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ extent: [10, 20, 30, 40], tileSize: 10, resolutions: [1], }); }); it('assumes top left corner of extent as origin', function () { expect(tileGrid.getOrigin()).to.eql([10, 40]); }); it('calculates full tile ranges from extent', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minX).to.equal(0); expect(fullTileRange.maxX).to.equal(1); expect(fullTileRange.minY).to.equal(0); expect(fullTileRange.maxY).to.equal(1); }); }); describe('create with sizes', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ origin: [10, 40], sizes: [[3, 3]], tileSize: 10, resolutions: [1], }); }); it('calculates full tile ranges from sizes', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minX).to.equal(0); expect(fullTileRange.maxX).to.equal(2); expect(fullTileRange.minY).to.equal(0); expect(fullTileRange.maxY).to.equal(2); }); }); describe('create with extent and sizes', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ extent: [10, 20, 30, 40], sizes: [[3, 3]], tileSize: 10, resolutions: [1], }); }); it('returns the configured extent', function () { expect(tileGrid.getExtent()).to.eql([10, 20, 30, 40]); }); it('calculates full tile ranges from sizes, further limited by extent', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minX).to.equal(0); expect(fullTileRange.maxX).to.equal(1); expect(fullTileRange.minY).to.equal(0); expect(fullTileRange.maxY).to.equal(1); }); }); describe('create with extent', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ extent: [10, 20, 30, 40], tileSize: 10, resolutions: [1], }); }); it('calculates full tile ranges from extent', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minX).to.equal(0); expect(fullTileRange.maxX).to.equal(1); expect(fullTileRange.minY).to.equal(0); expect(fullTileRange.maxY).to.equal(1); }); }); describe('create with top-left origin and sizes', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ origin: [10, 40], sizes: [[3, 3]], tileSize: 10, resolutions: [1], }); }); it('calculates correct minY and maxY for positive heights', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minY).to.equal(0); expect(fullTileRange.maxY).to.equal(2); }); }); describe('create with bottom-left origin and sizes', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ origin: [10, 10], sizes: [[3, -3]], tileSize: 10, resolutions: [1], }); }); it('calculates correct minX and maxX for negative heights', function () { const fullTileRange = tileGrid.getFullTileRange(0); expect(fullTileRange.minY).to.equal(-3); expect(fullTileRange.maxY).to.equal(-1); }); }); describe('create with extent and origin', function () { it('uses both origin and extent', function () { const tileGrid = new TileGrid({ origin: [0, 0], extent: [10, 20, 30, 40], tileSize: 10, resolutions: [1], }); expect(tileGrid.getOrigin()).to.eql([0, 0]); expect(tileGrid.getExtent()).to.eql([10, 20, 30, 40]); }); }); describe('create with complex configuration', function () { let tileGrid; beforeEach(function () { tileGrid = new TileGrid({ extent: [ 343870.8496458133, 5809157.009546259, 1905238.0275122682, 7515502.7821859205, ], sizes: [ [1, 2], [2, 4], [2, 4], [11, 16], ], resolutions: [ 4174.778550445067, 2087.3892752225333, 1043.6946376112667, 521.8473188056333, ], tileSizes: [ [374, 204], [374, 204], [748, 409], [272, 204], ], }); }); it('creates correct tile ranges', function () { const tileRanges = [ {minX: 0, maxX: 0, minY: 0, maxY: 1}, {minX: 0, maxX: 1, minY: 0, maxY: 3}, {minX: 0, maxX: 1, minY: 0, maxY: 3}, {minX: 0, maxX: 10, minY: 0, maxY: 15}, ]; for (let z = 0; z <= 3; ++z) { const zTileRange = tileGrid.getFullTileRange(z); for (const property in tileRanges[z]) { expect(zTileRange[property]).to.be(tileRanges[z][property]); } } }); it('returns correct withinExtentAndZ results with containsXY', function () { const outOfRangeTileCoords = [ [1, 2, 0], [1, 2, 1], [1, 2, 2], [1, 2, 3], ]; outOfRangeTileCoords.forEach(function (tileCoord) { const tileRange = tileGrid.getFullTileRange(tileCoord[0]); expect(tileRange.containsXY(tileCoord[1], tileCoord[2])).to.be(false); }); }); }); describe('createForExtent', function () { it('allows creation of tile grid from extent', function () { const extent = createOrUpdate(-100, -100, 100, 100); const grid = createForExtent(extent); expect(grid).to.be.a(TileGrid); const resolutions = grid.getResolutions(); expect(resolutions.length).to.be(DEFAULT_MAX_ZOOM + 1); expect(grid.getOrigin()).to.eql([-100, 100]); }); }); describe('#zoomFactor_', function () { it('is set for a consistent zoom factor', function () { const grid = new TileGrid({ resolutions: [10, 5, 2.5, 1.25], origin: origin, tileSize: tileSize, }); expect(grid.zoomFactor_).to.be(2); }); it('is not set for an inconsistent zoom factor', function () { const grid = new TileGrid({ resolutions: [10, 5, 3, 1.25], origin: origin, tileSize: tileSize, }); expect(grid.zoomFactor_).to.be(undefined); }); }); describe('createForProjection', function () { it('allows easier creation of a tile grid', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection(projection); expect(grid).to.be.a(TileGrid); const resolutions = grid.getResolutions(); expect(resolutions.length).to.be(DEFAULT_MAX_ZOOM + 1); }); it('accepts a number of zoom levels', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection(projection, 18); expect(grid).to.be.a(TileGrid); const resolutions = grid.getResolutions(); expect(resolutions.length).to.be(19); }); it('accepts a big number of zoom levels', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection(projection, 23); expect(grid).to.be.a(TileGrid); const resolutions = grid.getResolutions(); expect(resolutions.length).to.be(24); }); it('works for projections unknown to the client', function () { const projection = new Projection({code: 'EPSG:31287', units: 'm'}); const grid = createForProjection(projection); const resolutions = grid.getResolutions(); expect(resolutions[5]).to.be( (360 * METERS_PER_UNIT['degrees']) / DEFAULT_TILE_SIZE / Math.pow(2, 5) ); }); it('assumes origin is top-left', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection(projection); const origin = grid.getOrigin(); const half = HALF_SIZE; expect(origin).to.eql([-half, half]); }); it('accepts bottom-left as corner', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection( projection, undefined, undefined, 'bottom-left' ); const origin = grid.getOrigin(); const half = HALF_SIZE; expect(origin).to.eql([-half, -half]); }); it('accepts bottom-right as corner', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection( projection, undefined, undefined, 'bottom-right' ); const origin = grid.getOrigin(); const half = HALF_SIZE; expect(origin).to.eql([half, -half]); }); it('accepts top-left as corner', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection( projection, undefined, undefined, 'top-left' ); const origin = grid.getOrigin(); const half = HALF_SIZE; expect(origin).to.eql([-half, half]); }); it('accepts top-right as corner', function () { const projection = getProjection('EPSG:3857'); const grid = createForProjection( projection, undefined, undefined, 'top-right' ); const origin = grid.getOrigin(); const half = HALF_SIZE; expect(origin).to.eql([half, half]); }); }); describe('createXYZ()', function () { it('uses defaults', function () { const tileGrid = createXYZ(); expect(tileGrid.getExtent()).to.eql( getProjection('EPSG:3857').getExtent() ); expect(tileGrid.getMinZoom()).to.equal(0); expect(tileGrid.getMaxZoom()).to.equal(DEFAULT_MAX_ZOOM); expect(tileGrid.getTileSize()).to.equal(DEFAULT_TILE_SIZE); }); it('respects configuration options', function () { const tileGrid = createXYZ({ extent: [10, 20, 30, 40], maxResolution: 10 / 128, minZoom: 1, maxZoom: 2, tileSize: 128, }); expect(tileGrid.getExtent()).to.eql([10, 20, 30, 40]); expect(tileGrid.getResolutions()).to.eql([10 / 128, 5 / 128, 2.5 / 128]); expect(tileGrid.getMinZoom()).to.equal(1); expect(tileGrid.getMaxZoom()).to.equal(2); expect(tileGrid.getTileSize()).to.equal(128); }); }); describe('getForProjection', function () { it('gets the default tile grid for a projection', function () { const projection = getProjection('EPSG:3857'); const grid = getTileGridForProjection(projection); expect(grid).to.be.a(TileGrid); const resolutions = grid.getResolutions(); expect(resolutions.length).to.be(DEFAULT_MAX_ZOOM + 1); expect(grid.getTileSize()).to.eql(256); }); it('stores the default tile grid on a projection', function () { const projection = getProjection('EPSG:3857'); const grid = getTileGridForProjection(projection); const gridAgain = getTileGridForProjection(projection); expect(grid).to.be(gridAgain); }); }); describe('#getTileCoordChildTileRange()', function () { let tileGrid; beforeEach(function () { tileGrid = createForExtent(getProjection('EPSG:3857').getExtent(), 22); }); it('returns the tile range for one zoom level deeper', function () { let range; range = tileGrid.getTileCoordChildTileRange([0, 0, 0]); expect(range.minX).to.be(0); expect(range.maxX).to.be(1); expect(range.minY).to.be(0); expect(range.maxY).to.be(1); range = tileGrid.getTileCoordChildTileRange([0, 1, 0]); expect(range.minX).to.be(2); expect(range.maxX).to.be(3); expect(range.minY).to.be(0); expect(range.maxY).to.be(1); range = tileGrid.getTileCoordChildTileRange([0, 0, 1]); expect(range.minX).to.be(0); expect(range.maxX).to.be(1); expect(range.minY).to.be(2); expect(range.maxY).to.be(3); range = tileGrid.getTileCoordChildTileRange([0, -1, 0]); expect(range.minX).to.be(-2); expect(range.maxX).to.be(-1); expect(range.minY).to.be(0); expect(range.maxY).to.be(1); range = tileGrid.getTileCoordChildTileRange([0, 0, -1]); expect(range.minX).to.be(0); expect(range.maxX).to.be(1); expect(range.minY).to.be(-2); expect(range.maxY).to.be(-1); }); it('returns null for z > maxZoom', function () { const max = tileGrid.maxZoom; const range = tileGrid.getTileCoordChildTileRange([max + 1, 0, 0]); expect(range).to.be(null); }); }); describe('#forEachTileCoordParentTileRange()', function () { let tileGrid; beforeEach(function () { tileGrid = createForExtent(getProjection('EPSG:3857').getExtent(), 22); }); it('iterates as expected', function () { const tileCoord = [5, 11, 21]; const zs = []; const tileRanges = []; tileGrid.forEachTileCoordParentTileRange( tileCoord, function (z, tileRange) { zs.push(z); tileRanges.push( new TileRange( tileRange.minX, tileRange.maxX, tileRange.minY, tileRange.maxY ) ); return false; } ); expect(zs.length).to.eql(5); expect(tileRanges.length).to.eql(5); expect(zs[0]).to.eql(4); expect(tileRanges[0].minX).to.eql(5); expect(tileRanges[0].maxX).to.eql(5); expect(tileRanges[0].minY).to.eql(10); expect(tileRanges[0].maxY).to.eql(10); expect(zs[1]).to.eql(3); expect(tileRanges[1].minX).to.eql(2); expect(tileRanges[1].maxX).to.eql(2); expect(tileRanges[1].minY).to.eql(5); expect(tileRanges[1].maxY).to.eql(5); expect(zs[2]).to.eql(2); expect(tileRanges[2].minX).to.eql(1); expect(tileRanges[2].maxX).to.eql(1); expect(tileRanges[2].minY).to.eql(2); expect(tileRanges[2].maxY).to.eql(2); expect(zs[3]).to.eql(1); expect(tileRanges[3].minX).to.eql(0); expect(tileRanges[3].maxX).to.eql(0); expect(tileRanges[3].minY).to.eql(1); expect(tileRanges[3].maxY).to.eql(1); expect(zs[4]).to.eql(0); expect(tileRanges[4].minX).to.eql(0); expect(tileRanges[4].maxX).to.eql(0); expect(tileRanges[4].minY).to.eql(0); expect(tileRanges[4].maxY).to.eql(0); }); }); describe('getResolution', function () { let tileGrid; beforeEach(function () { tileGrid = createForExtent(getProjection('EPSG:3857').getExtent(), 22); }); it('returns the correct resolution at the equator', function () { // @see https://docs.microsoft.com/en-us/bingmaps/articles/understanding-scale-and-resolution expect(tileGrid.getResolution(0)).to.roughlyEqual(156543.04, 1e-2); expect(tileGrid.getResolution(1)).to.roughlyEqual(78271.52, 1e-2); expect(tileGrid.getResolution(2)).to.roughlyEqual(39135.76, 1e-2); expect(tileGrid.getResolution(3)).to.roughlyEqual(19567.88, 1e-2); expect(tileGrid.getResolution(4)).to.roughlyEqual(9783.94, 1e-2); expect(tileGrid.getResolution(5)).to.roughlyEqual(4891.97, 1e-2); expect(tileGrid.getResolution(6)).to.roughlyEqual(2445.98, 1e-2); expect(tileGrid.getResolution(7)).to.roughlyEqual(1222.99, 1e-2); expect(tileGrid.getResolution(8)).to.roughlyEqual(611.5, 1e-2); expect(tileGrid.getResolution(9)).to.roughlyEqual(305.75, 1e-2); expect(tileGrid.getResolution(10)).to.roughlyEqual(152.87, 1e-2); expect(tileGrid.getResolution(11)).to.roughlyEqual(76.44, 1e-2); expect(tileGrid.getResolution(12)).to.roughlyEqual(38.22, 1e-2); expect(tileGrid.getResolution(13)).to.roughlyEqual(19.11, 1e-2); expect(tileGrid.getResolution(14)).to.roughlyEqual(9.55, 1e-2); expect(tileGrid.getResolution(15)).to.roughlyEqual(4.78, 1e-2); expect(tileGrid.getResolution(16)).to.roughlyEqual(2.39, 1e-2); expect(tileGrid.getResolution(17)).to.roughlyEqual(1.19, 1e-2); expect(tileGrid.getResolution(18)).to.roughlyEqual(0.6, 1e-2); expect(tileGrid.getResolution(19)).to.roughlyEqual(0.3, 1e-2); }); }); describe('#getTileCoordFromCoordAndZ()', function () { describe('Y North, X East', function () { it('returns the expected TileCoord', function () { origin = [0, 0]; const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let tileCoord; tileCoord = tileGrid.getTileCoordForCoordAndZ([0, 0], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); tileCoord = tileGrid.getTileCoordForCoordAndZ([0, 100000], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(-10); tileCoord = tileGrid.getTileCoordForCoordAndZ([100000, 0], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(10); expect(tileCoord[2]).to.eql(0); tileCoord = tileGrid.getTileCoordForCoordAndZ([100000, 100000], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(10); expect(tileCoord[2]).to.eql(-10); }); }); describe('Y South, X East', function () { it('returns the expected TileCoord', function () { origin = [0, 100000]; const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let tileCoord; tileCoord = tileGrid.getTileCoordForCoordAndZ([0, 0], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(10); tileCoord = tileGrid.getTileCoordForCoordAndZ([0, 100000], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); tileCoord = tileGrid.getTileCoordForCoordAndZ([100000, 0], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(10); expect(tileCoord[2]).to.eql(10); tileCoord = tileGrid.getTileCoordForCoordAndZ([100000, 100000], 3); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(10); expect(tileCoord[2]).to.eql(0); }); }); }); describe('getTileCoordForCoordAndResolution', function () { it('returns the expected TileCoord', function () { const tileSize = 256; const tileGrid = new TileGrid({ resolutions: [10], origin: origin, tileSize: tileSize, }); let coordinate; let tileCoord; // gets the first tile at the origin coordinate = [0, 0]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); // gets one tile northwest of the origin coordinate = [-1280, 1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(-1); expect(tileCoord[2]).to.eql(-1); // gets one tile northeast of the origin coordinate = [1280, 1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(-1); // gets one tile southeast of the origin coordinate = [1280, -1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); // gets one tile southwest of the origin coordinate = [-1280, -1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(-1); expect(tileCoord[2]).to.eql(0); // gets the tile to the east when on the edge coordinate = [2560, -1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(1); expect(tileCoord[2]).to.eql(0); // gets the tile to the south when on the edge coordinate = [1280, -2560]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(1); // pixels are top aligned to the origin coordinate = [1280, -2549.999]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); // pixels are left aligned to the origin coordinate = [2549.999, -1280]; tileCoord = tileGrid.getTileCoordForCoordAndResolution(coordinate, 10); expect(tileCoord[0]).to.eql(0); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); }); }); describe('getTileCoordForXYAndResolution_', function () { it('returns higher tile coord for intersections by default', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let tileCoord; // gets higher tile for edge intersection tileCoord = tileGrid.getTileCoordForXYAndResolution_(0, 0, 100, false); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(0); expect(tileCoord[2]).to.eql(0); // gets higher tile for edge intersection tileCoord = tileGrid.getTileCoordForXYAndResolution_( 100000, 100000, 100, false ); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(10); expect(tileCoord[2]).to.eql(-10); }); it('handles alt intersection policy', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let tileCoord; // can get lower tile for edge intersection tileCoord = tileGrid.getTileCoordForXYAndResolution_(0, 0, 100, true); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(-1); expect(tileCoord[2]).to.eql(-1); // can get lower tile for edge intersection tileCoord = tileGrid.getTileCoordForXYAndResolution_( 100000, 100000, 100, true ); expect(tileCoord[0]).to.eql(3); expect(tileCoord[1]).to.eql(9); expect(tileCoord[2]).to.eql(-11); }); }); describe('getTileCoordCenter', function () { it('returns the expected center', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let center; center = tileGrid.getTileCoordCenter([0, 0, 0]); expect(center[0]).to.eql(50000); expect(center[1]).to.eql(-50000); center = tileGrid.getTileCoordCenter([3, 0, 0]); expect(center[0]).to.eql(5000); expect(center[1]).to.eql(-5000); center = tileGrid.getTileCoordCenter([3, 9, 9]); expect(center[0]).to.eql(95000); expect(center[1]).to.eql(-95000); }); }); describe('getTileCoordExtent', function () { it('returns the expected extend', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); let tileCoordExtent; tileCoordExtent = tileGrid.getTileCoordExtent([0, 0, 0]); expect(tileCoordExtent[0]).to.eql(0); expect(tileCoordExtent[1]).to.eql(-100000); expect(tileCoordExtent[2]).to.eql(100000); expect(tileCoordExtent[3]).to.eql(0); tileCoordExtent = tileGrid.getTileCoordExtent([3, 9, 0]); expect(tileCoordExtent[0]).to.eql(90000); expect(tileCoordExtent[1]).to.eql(-10000); expect(tileCoordExtent[2]).to.eql(100000); expect(tileCoordExtent[3]).to.eql(0); tileCoordExtent = tileGrid.getTileCoordExtent([3, 0, 9]); expect(tileCoordExtent[0]).to.eql(0); expect(tileCoordExtent[1]).to.eql(-100000); expect(tileCoordExtent[2]).to.eql(10000); expect(tileCoordExtent[3]).to.eql(-90000); }); }); describe('getTileRangeForExtentAndZ', function () { it('includes a tile even if a fraction of a pixel is covered', function () { const tileGrid = new TileGrid({ resolutions: [1], origin: [0, 10], tileSize: 10, }); let tileRange; // overlaps to the right tileRange = tileGrid.getTileRangeForExtentAndZ([0, 0, 10.1, 10], 0); expect(tileRange.minX).to.be(0); expect(tileRange.maxX).to.be(1); expect(tileRange.minY).to.be(0); expect(tileRange.maxY).to.be(0); // overlaps to the bottom tileRange = tileGrid.getTileRangeForExtentAndZ([0, -0.1, 10, 10], 0); expect(tileRange.minX).to.be(0); expect(tileRange.maxX).to.be(0); expect(tileRange.minY).to.be(0); expect(tileRange.maxY).to.be(1); // overlaps to the left tileRange = tileGrid.getTileRangeForExtentAndZ([-0.1, 0, 10, 10], 0); expect(tileRange.minX).to.be(-1); expect(tileRange.maxX).to.be(0); expect(tileRange.minY).to.be(0); expect(tileRange.maxY).to.be(0); // overlaps to the top tileRange = tileGrid.getTileRangeForExtentAndZ([0, 0, 10, 10.1], 0); expect(tileRange.minX).to.be(0); expect(tileRange.maxX).to.be(0); expect(tileRange.minY).to.be(-1); expect(tileRange.maxY).to.be(0); }); it('returns the expected TileRange', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); const e = [45000, 5000, 55000, 15000]; let tileRange; tileRange = tileGrid.getTileRangeForExtentAndZ(e, 0); expect(tileRange.minY).to.eql(-1); expect(tileRange.minX).to.eql(0); expect(tileRange.maxX).to.eql(0); expect(tileRange.maxY).to.eql(-1); tileRange = tileGrid.getTileRangeForExtentAndZ(e, 1); expect(tileRange.minX).to.eql(0); expect(tileRange.minY).to.eql(-1); expect(tileRange.maxX).to.eql(1); expect(tileRange.maxY).to.eql(-1); tileRange = tileGrid.getTileRangeForExtentAndZ(e, 2); expect(tileRange.minX).to.eql(1); expect(tileRange.minY).to.eql(-1); expect(tileRange.maxX).to.eql(2); expect(tileRange.maxY).to.eql(-1); tileRange = tileGrid.getTileRangeForExtentAndZ(e, 3); expect(tileRange.minX).to.eql(4); expect(tileRange.minY).to.eql(-2); expect(tileRange.maxX).to.eql(5); expect(tileRange.maxY).to.eql(-1); }); }); describe('getTileSize', function () { const resolutions = [1000, 500, 250, 100]; const origin = [0, 0]; it('works with one tile size as number', function () { const tileGrid = new TileGrid({ tileSize: 256, resolutions: resolutions, origin: origin, }); expect(tileGrid.getTileSize(0)).to.equal(256); expect(tileGrid.getTileSize(3)).to.equal(256); }); it('works with one tile size as array', function () { const tileGrid = new TileGrid({ tileSize: [512, 256], resolutions: resolutions, origin: origin, }); expect(tileGrid.getTileSize(0)).to.eql([512, 256]); expect(tileGrid.getTileSize(3)).to.eql([512, 256]); }); it('works with multiple tile sizes as number', function () { const tileGrid = new TileGrid({ tileSizes: [256, 256, 256, 512], resolutions: resolutions, origin: origin, }); expect(tileGrid.getTileSize(0)).to.equal(256); expect(tileGrid.getTileSize(3)).to.equal(512); }); it('works with multiple tile sizes as array', function () { const tileGrid = new TileGrid({ tileSizes: [ [512, 256], [512, 256], [512, 256], [640, 320], ], resolutions: resolutions, origin: origin, }); expect(tileGrid.getTileSize(0)).to.eql([512, 256]); expect(tileGrid.getTileSize(3)).to.eql([640, 320]); }); }); describe('forEachTileCoord', function () { it('calls the provided function with each tile coordinate', function () { const tileGrid = createXYZ({extent: [-180, -90, 180, 90]}); const tileCoords = []; tileGrid.forEachTileCoord([15, 47, 16, 48], 8, function (tileCoord) { tileCoords.push(tileCoord); }); expect(tileCoords).to.eql([ [8, 138, 29], [8, 138, 30], [8, 139, 29], [8, 139, 30], ]); }); }); describe('forEachTileCoordParentTileRange', function () { it('iterates as expected', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); const zs = []; const tileRanges = []; tileGrid.forEachTileCoordParentTileRange( [3, 7, 3], function (z, tileRange) { zs.push(z); tileRanges.push(tileRange); return false; } ); expect(zs.length).to.eql(3); expect(tileRanges.length).to.eql(3); expect(zs[0]).to.eql(2); expect(tileRanges[0].minX).to.eql(2); expect(tileRanges[0].minY).to.eql(1); expect(tileRanges[0].maxX).to.eql(3); expect(tileRanges[0].maxY).to.eql(1); expect(zs[1]).to.eql(1); expect(tileRanges[1].minX).to.eql(1); expect(tileRanges[1].minY).to.eql(0); expect(tileRanges[1].maxX).to.eql(1); expect(tileRanges[1].maxY).to.eql(0); expect(zs[2]).to.eql(0); expect(tileRanges[2].minX).to.eql(0); expect(tileRanges[2].minY).to.eql(0); expect(tileRanges[2].maxX).to.eql(0); expect(tileRanges[2].maxY).to.eql(0); }); }); describe('getZForResolution (exact)', function () { it('returns the expected z value', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); expect(tileGrid.getZForResolution(1000)).to.eql(0); expect(tileGrid.getZForResolution(500)).to.eql(1); expect(tileGrid.getZForResolution(250)).to.eql(2); expect(tileGrid.getZForResolution(100)).to.eql(3); }); }); describe('getZForResolution (approximate)', function () { it('returns the expected z value', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); expect(tileGrid.getZForResolution(2000)).to.eql(0); expect(tileGrid.getZForResolution(1000)).to.eql(0); expect(tileGrid.getZForResolution(900)).to.eql(0); expect(tileGrid.getZForResolution(750)).to.eql(1); expect(tileGrid.getZForResolution(625)).to.eql(1); expect(tileGrid.getZForResolution(500)).to.eql(1); expect(tileGrid.getZForResolution(475)).to.eql(1); expect(tileGrid.getZForResolution(375)).to.eql(2); expect(tileGrid.getZForResolution(250)).to.eql(2); expect(tileGrid.getZForResolution(200)).to.eql(2); expect(tileGrid.getZForResolution(125)).to.eql(3); expect(tileGrid.getZForResolution(100)).to.eql(3); expect(tileGrid.getZForResolution(50)).to.eql(3); }); }); describe('getZForResolution (lower)', function () { it('returns the expected z value', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); expect(tileGrid.getZForResolution(2000, 1)).to.eql(0); expect(tileGrid.getZForResolution(1000, 1)).to.eql(0); expect(tileGrid.getZForResolution(900, 1)).to.eql(0); expect(tileGrid.getZForResolution(750, 1)).to.eql(0); expect(tileGrid.getZForResolution(625, 1)).to.eql(0); expect(tileGrid.getZForResolution(500, 1)).to.eql(1); expect(tileGrid.getZForResolution(475, 1)).to.eql(1); expect(tileGrid.getZForResolution(375, 1)).to.eql(1); expect(tileGrid.getZForResolution(250, 1)).to.eql(2); expect(tileGrid.getZForResolution(200, 1)).to.eql(2); expect(tileGrid.getZForResolution(125, 1)).to.eql(2); expect(tileGrid.getZForResolution(100, 1)).to.eql(3); expect(tileGrid.getZForResolution(50, 1)).to.eql(3); }); }); describe('getZForResolution (higher)', function () { it('returns the expected z value', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); expect(tileGrid.getZForResolution(2000, -1)).to.eql(0); expect(tileGrid.getZForResolution(1000, -1)).to.eql(0); expect(tileGrid.getZForResolution(900, -1)).to.eql(1); expect(tileGrid.getZForResolution(750, -1)).to.eql(1); expect(tileGrid.getZForResolution(625, -1)).to.eql(1); expect(tileGrid.getZForResolution(500, -1)).to.eql(1); expect(tileGrid.getZForResolution(475, -1)).to.eql(2); expect(tileGrid.getZForResolution(375, -1)).to.eql(2); expect(tileGrid.getZForResolution(250, -1)).to.eql(2); expect(tileGrid.getZForResolution(200, -1)).to.eql(3); expect(tileGrid.getZForResolution(125, -1)).to.eql(3); expect(tileGrid.getZForResolution(100, -1)).to.eql(3); expect(tileGrid.getZForResolution(50, -1)).to.eql(3); }); }); describe('getZForResolution (NearestDirectionFunction)', function () { it('returns the expected z value', function () { const tileGrid = new TileGrid({ resolutions: resolutions, origin: origin, tileSize: tileSize, }); expect( tileGrid.getZForResolution(626, function (value, high, low) { return value - (low + (high - low) * 0.25); }) ).to.eql(0); expect( tileGrid.getZForResolution(625, function (value, high, low) { return value - (low + (high - low) * 0.25); }) ).to.eql(1); expect( tileGrid.getZForResolution(476, function (value, high, low) { return value - (low + (high - low) * 0.9); }) ).to.eql(1); expect( tileGrid.getZForResolution(475, function (value, high, low) { return value - (low + (high - low) * 0.9); }) ).to.eql(2); expect( tileGrid.getZForResolution(201, function (value, high, low) { return value - (low + (high - low) * 0.666666667); }) ).to.eql(2); expect( tileGrid.getZForResolution(200, function (value, high, low) { return value - (low + (high - low) * 0.666666667); }) ).to.eql(3); expect( tileGrid.getZForResolution(126, function (value, high, low) { return value - (low + (high - low) * 0.166666667); }) ).to.eql(2); expect( tileGrid.getZForResolution(125, function (value, high, low) { return value - (low + (high - low) * 0.166666667); }) ).to.eql(3); }); }); describe('getTileRangeForTileCoordAndZ()', function () { const tileGrid = createForExtent( getProjection('EPSG:3857').getExtent(), 22 ); it('can be used to get the child tile range', function () { const range = tileGrid.getTileRangeForTileCoordAndZ([0, 0, 0], 1); expect(range.minX).to.be(0); expect(range.maxX).to.be(1); expect(range.minY).to.be(0); expect(range.maxY).to.be(1); }); it('can be used to get the range of a deeper level', function () { const range = tileGrid.getTileRangeForTileCoordAndZ([0, 0, 0], 3); expect(range.minX).to.be(0); expect(range.maxX).to.be(7); expect(range.minY).to.be(0); expect(range.maxY).to.be(7); }); it('can be used to get the parent tile range', function () { const range = tileGrid.getTileRangeForTileCoordAndZ([1, 1, 0], 0); expect(range.minX).to.be(0); expect(range.maxX).to.be(0); expect(range.minY).to.be(0); expect(range.maxY).to.be(0); }); it('can be used to get the range of a shallower level', function () { const range = tileGrid.getTileRangeForTileCoordAndZ([3, 1, 6], 0); expect(range.minX).to.be(0); expect(range.maxX).to.be(0); expect(range.minY).to.be(0); expect(range.maxY).to.be(0); }); const tileCoord = [15, 6239, 11751]; tileGrid.forEachTileCoordParentTileRange( tileCoord, function (z, tileRange) { it(`works for level ${z}`, function () { const range = tileGrid.getTileRangeForTileCoordAndZ(tileCoord, z); expect(range.minX).to.be(tileRange.minX); expect(range.maxX).to.be(tileRange.maxX); expect(range.minY).to.be(tileRange.minY); expect(range.maxY).to.be(tileRange.maxY); }); } ); }); });