@mapgis/mapbox-gl 16.0.0 → 16.2.0

package/src/symbol/cross_tile_symbol_index.js

@@ -1,301 +0,0 @@
-// @flow
-
-import EXTENT from '../data/extent';
-
-import {SymbolInstanceArray} from '../data/array_types';
-
-import type {SymbolInstance} from '../data/array_types';
-import type {OverscaledTileID} from '../source/tile_id';
-import type SymbolBucket from '../data/bucket/symbol_bucket';
-import type StyleLayer from '../style/style_layer';
-import type Tile from '../source/tile';
-
-/*
-    The CrossTileSymbolIndex generally works on the assumption that
-    a conceptual "unique symbol" can be identified by the text of
-    the label combined with the anchor point. The goal is to assign
-    these conceptual "unique symbols" a shared crossTileID that can be
-    used by Placement to keep fading opacity states consistent and to
-    deduplicate labels.
-
-    The CrossTileSymbolIndex indexes all the current symbol instances and
-    their crossTileIDs. When a symbol bucket gets added or updated, the
-    index assigns a crossTileID to each of it's symbol instances by either
-    matching it with an existing id or assigning a new one.
-*/
-
-// Round anchor positions to roughly 4 pixel grid
-const roundingFactor = 512 / EXTENT / 2;
-
-class TileLayerIndex {
-    tileID: OverscaledTileID;
-    indexedSymbolInstances: {[_: number]: Array<{
-        crossTileID: number,
-        coord: {
-            x: number,
-            y: number
-        }
-    }>};
-    bucketInstanceId: number;
-
-    constructor(tileID: OverscaledTileID, symbolInstances: SymbolInstanceArray, bucketInstanceId: number) {
-        this.tileID = tileID;
-        this.indexedSymbolInstances = {};
-        this.bucketInstanceId = bucketInstanceId;
-
-        for (let i = 0; i < symbolInstances.length; i++) {
-            const symbolInstance = symbolInstances.get(i);
-            const key = symbolInstance.key;
-            if (!this.indexedSymbolInstances[key]) {
-                this.indexedSymbolInstances[key] = [];
-            }
-            // This tile may have multiple symbol instances with the same key
-            // Store each one along with its coordinates
-            this.indexedSymbolInstances[key].push({
-                crossTileID: symbolInstance.crossTileID,
-                coord: this.getScaledCoordinates(symbolInstance, tileID)
-            });
-        }
-    }
-
-    // Converts the coordinates of the input symbol instance into coordinates that be can compared
-    // against other symbols in this index. Coordinates are:
-    // (1) world-based (so after conversion the source tile is irrelevant)
-    // (2) converted to the z-scale of this TileLayerIndex
-    // (3) down-sampled by "roundingFactor" from tile coordinate precision in order to be
-    //     more tolerant of small differences between tiles.
-    getScaledCoordinates(symbolInstance: SymbolInstance, childTileID: OverscaledTileID) {
-        const zDifference = childTileID.canonical.z - this.tileID.canonical.z;
-        const scale = roundingFactor / Math.pow(2, zDifference);
-        return {
-            x: Math.floor((childTileID.canonical.x * EXTENT + symbolInstance.anchorX) * scale),
-            y: Math.floor((childTileID.canonical.y * EXTENT + symbolInstance.anchorY) * scale)
-        };
-    }
-
-    findMatches(symbolInstances: SymbolInstanceArray, newTileID: OverscaledTileID, zoomCrossTileIDs: {[crossTileID: number]: boolean}) {
-        const tolerance = this.tileID.canonical.z < newTileID.canonical.z ? 1 : Math.pow(2, this.tileID.canonical.z - newTileID.canonical.z);
-
-        for (let i = 0; i < symbolInstances.length; i++) {
-            const symbolInstance = symbolInstances.get(i);
-            if (symbolInstance.crossTileID) {
-                // already has a match, skip
-                continue;
-            }
-
-            const indexedInstances = this.indexedSymbolInstances[symbolInstance.key];
-            if (!indexedInstances) {
-                // No symbol with this key in this bucket
-                continue;
-            }
-
-            const scaledSymbolCoord = this.getScaledCoordinates(symbolInstance, newTileID);
-
-            for (const thisTileSymbol of indexedInstances) {
-                // Return any symbol with the same keys whose coordinates are within 1
-                // grid unit. (with a 4px grid, this covers a 12px by 12px area)
-                if (Math.abs(thisTileSymbol.coord.x - scaledSymbolCoord.x) <= tolerance &&
-                    Math.abs(thisTileSymbol.coord.y - scaledSymbolCoord.y) <= tolerance &&
-                    !zoomCrossTileIDs[thisTileSymbol.crossTileID]) {
-                    // Once we've marked ourselves duplicate against this parent symbol,
-                    // don't let any other symbols at the same zoom level duplicate against
-                    // the same parent (see issue #5993)
-                    zoomCrossTileIDs[thisTileSymbol.crossTileID] = true;
-                    symbolInstance.crossTileID = thisTileSymbol.crossTileID;
-                    break;
-                }
-            }
-        }
-    }
-}
-
-class CrossTileIDs {
-    maxCrossTileID: number;
-    constructor() {
-        this.maxCrossTileID = 0;
-    }
-    generate() {
-        return ++this.maxCrossTileID;
-    }
-}
-
-class CrossTileSymbolLayerIndex {
-    indexes: {[zoom: string | number]: {[tileId: string | number]: TileLayerIndex}};
-    usedCrossTileIDs: {[zoom: string | number]: {[crossTileID: number]: boolean}};
-    lng: number;
-
-    constructor() {
-        this.indexes = {};
-        this.usedCrossTileIDs = {};
-        this.lng = 0;
-    }
-
-    /*
-     * Sometimes when a user pans across the antimeridian the longitude value gets wrapped.
-     * To prevent labels from flashing out and in we adjust the tileID values in the indexes
-     * so that they match the new wrapped version of the map.
-     */
-    handleWrapJump(lng: number) {
-        const wrapDelta = Math.round((lng - this.lng) / 360);
-        if (wrapDelta !== 0) {
-            for (const zoom in this.indexes) {
-                const zoomIndexes = this.indexes[zoom];
-                const newZoomIndex = {};
-                for (const key in zoomIndexes) {
-                    // change the tileID's wrap and add it to a new index
-                    const index = zoomIndexes[key];
-                    index.tileID = index.tileID.unwrapTo(index.tileID.wrap + wrapDelta);
-                    newZoomIndex[index.tileID.key] = index;
-                }
-                this.indexes[zoom] = newZoomIndex;
-            }
-        }
-        this.lng = lng;
-    }
-
-    addBucket(tileID: OverscaledTileID, bucket: SymbolBucket, crossTileIDs: CrossTileIDs) {
-        if (this.indexes[tileID.overscaledZ] &&
-            this.indexes[tileID.overscaledZ][tileID.key]) {
-            if (this.indexes[tileID.overscaledZ][tileID.key].bucketInstanceId ===
-                bucket.bucketInstanceId) {
-                return false;
-            } else {
-                // We're replacing this bucket with an updated version
-                // Remove the old bucket's "used crossTileIDs" now so that
-                // the new bucket can claim them.
-                // The old index entries themselves stick around until
-                // 'removeStaleBuckets' is called.
-                this.removeBucketCrossTileIDs(tileID.overscaledZ,
-                    this.indexes[tileID.overscaledZ][tileID.key]);
-            }
-        }
-
-        for (let i = 0; i < bucket.symbolInstances.length; i++) {
-            const symbolInstance = bucket.symbolInstances.get(i);
-            symbolInstance.crossTileID = 0;
-        }
-
-        if (!this.usedCrossTileIDs[tileID.overscaledZ]) {
-            this.usedCrossTileIDs[tileID.overscaledZ] = {};
-        }
-        const zoomCrossTileIDs = this.usedCrossTileIDs[tileID.overscaledZ];
-
-        for (const zoom in this.indexes) {
-            const zoomIndexes = this.indexes[zoom];
-            if (Number(zoom) > tileID.overscaledZ) {
-                for (const id in zoomIndexes) {
-                    const childIndex = zoomIndexes[id];
-                    if (childIndex.tileID.isChildOf(tileID)) {
-                        childIndex.findMatches(bucket.symbolInstances, tileID, zoomCrossTileIDs);
-                    }
-                }
-            } else {
-                const parentCoord = tileID.scaledTo(Number(zoom));
-                const parentIndex = zoomIndexes[parentCoord.key];
-                if (parentIndex) {
-                    parentIndex.findMatches(bucket.symbolInstances, tileID, zoomCrossTileIDs);
-                }
-            }
-        }
-
-        for (let i = 0; i < bucket.symbolInstances.length; i++) {
-            const symbolInstance = bucket.symbolInstances.get(i);
-            if (!symbolInstance.crossTileID) {
-                // symbol did not match any known symbol, assign a new id
-                symbolInstance.crossTileID = crossTileIDs.generate();
-                zoomCrossTileIDs[symbolInstance.crossTileID] = true;
-            }
-        }
-
-        if (this.indexes[tileID.overscaledZ] === undefined) {
-            this.indexes[tileID.overscaledZ] = {};
-        }
-        this.indexes[tileID.overscaledZ][tileID.key] = new TileLayerIndex(tileID, bucket.symbolInstances, bucket.bucketInstanceId);
-
-        return true;
-    }
-
-    removeBucketCrossTileIDs(zoom: string | number, removedBucket: TileLayerIndex) {
-        for (const key in removedBucket.indexedSymbolInstances) {
-            for (const symbolInstance of removedBucket.indexedSymbolInstances[(key: any)]) {
-                delete this.usedCrossTileIDs[zoom][symbolInstance.crossTileID];
-            }
-        }
-    }
-
-    removeStaleBuckets(currentIDs: { [string | number]: boolean }) {
-        let tilesChanged = false;
-        for (const z in this.indexes) {
-            const zoomIndexes = this.indexes[z];
-            for (const tileKey in zoomIndexes) {
-                if (!currentIDs[zoomIndexes[tileKey].bucketInstanceId]) {
-                    this.removeBucketCrossTileIDs(z, zoomIndexes[tileKey]);
-                    delete zoomIndexes[tileKey];
-                    tilesChanged = true;
-                }
-            }
-        }
-        return tilesChanged;
-    }
-}
-
-class CrossTileSymbolIndex {
-    layerIndexes: {[layerId: string]: CrossTileSymbolLayerIndex};
-    crossTileIDs: CrossTileIDs;
-    maxBucketInstanceId: number;
-    bucketsInCurrentPlacement: {[_: number]: boolean};
-
-    constructor() {
-        this.layerIndexes = {};
-        this.crossTileIDs = new CrossTileIDs();
-        this.maxBucketInstanceId = 0;
-        this.bucketsInCurrentPlacement = {};
-    }
-
-    addLayer(styleLayer: StyleLayer, tiles: Array<Tile>, lng: number) {
-        let layerIndex = this.layerIndexes[styleLayer.id];
-        if (layerIndex === undefined) {
-            layerIndex = this.layerIndexes[styleLayer.id] = new CrossTileSymbolLayerIndex();
-        }
-
-        let symbolBucketsChanged = false;
-        const currentBucketIDs = {};
-
-        layerIndex.handleWrapJump(lng);
-
-        for (const tile of tiles) {
-            const symbolBucket = ((tile.getBucket(styleLayer): any): SymbolBucket);
-            if (!symbolBucket || styleLayer.id !== symbolBucket.layerIds[0])
-                continue;
-
-            if (!symbolBucket.bucketInstanceId) {
-                symbolBucket.bucketInstanceId = ++this.maxBucketInstanceId;
-            }
-
-            if (layerIndex.addBucket(tile.tileID, symbolBucket, this.crossTileIDs)) {
-                symbolBucketsChanged = true;
-            }
-            currentBucketIDs[symbolBucket.bucketInstanceId] = true;
-        }
-
-        if (layerIndex.removeStaleBuckets(currentBucketIDs)) {
-            symbolBucketsChanged = true;
-        }
-
-        return symbolBucketsChanged;
-    }
-
-    pruneUnusedLayers(usedLayers: Array<string>) {
-        const usedLayerMap = {};
-        usedLayers.forEach((usedLayer) => {
-            usedLayerMap[usedLayer] = true;
-        });
-        for (const layerId in this.layerIndexes) {
-            if (!usedLayerMap[layerId]) {
-                delete this.layerIndexes[layerId];
-            }
-        }
-    }
-}
-
-export default CrossTileSymbolIndex;

package/src/symbol/get_anchors.js

@@ -1,167 +0,0 @@
-// @flow
-
-import {number as interpolate} from '../style-spec/util/interpolate';
-
-import Anchor from '../symbol/anchor';
-import checkMaxAngle from './check_max_angle';
-
-import type Point from '@mapbox/point-geometry';
-import type {Shaping, PositionedIcon} from './shaping';
-
-export {getAnchors, getCenterAnchor};
-
-function getLineLength(line: Array<Point>): number {
-    let lineLength = 0;
-    for (let k = 0; k < line.length - 1; k++) {
-        lineLength += line[k].dist(line[k + 1]);
-    }
-    return lineLength;
-}
-
-function getAngleWindowSize(shapedText: ?Shaping,
-                            glyphSize: number,
-                            boxScale: number): number {
-    return shapedText ?
-        3 / 5 * glyphSize * boxScale :
-        0;
-}
-
-function getShapedLabelLength(shapedText: ?Shaping, shapedIcon: ?PositionedIcon): number {
-    return Math.max(
-        shapedText ? shapedText.right - shapedText.left : 0,
-        shapedIcon ? shapedIcon.right - shapedIcon.left : 0);
-}
-
-function getCenterAnchor(line: Array<Point>,
-                         maxAngle: number,
-                         shapedText: ?Shaping,
-                         shapedIcon: ?PositionedIcon,
-                         glyphSize: number,
-                         boxScale: number) {
-    const angleWindowSize = getAngleWindowSize(shapedText, glyphSize, boxScale);
-    const labelLength = getShapedLabelLength(shapedText, shapedIcon) * boxScale;
-
-    let prevDistance = 0;
-    const centerDistance = getLineLength(line) / 2;
-
-    for (let i = 0; i < line.length - 1; i++) {
-
-        const a = line[i],
-            b = line[i + 1];
-
-        const segmentDistance = a.dist(b);
-
-        if (prevDistance + segmentDistance > centerDistance) {
-            // The center is on this segment
-            const t = (centerDistance - prevDistance) / segmentDistance,
-                x = interpolate(a.x, b.x, t),
-                y = interpolate(a.y, b.y, t);
-
-            const anchor = new Anchor(x, y, b.angleTo(a), i);
-            anchor._round();
-            if (!angleWindowSize || checkMaxAngle(line, anchor, labelLength, angleWindowSize, maxAngle)) {
-                return anchor;
-            } else {
-                return;
-            }
-        }
-
-        prevDistance += segmentDistance;
-    }
-}
-
-function getAnchors(line: Array<Point>,
-                    spacing: number,
-                    maxAngle: number,
-                    shapedText: ?Shaping,
-                    shapedIcon: ?PositionedIcon,
-                    glyphSize: number,
-                    boxScale: number,
-                    overscaling: number,
-                    tileExtent: number) {
-
-    // Resample a line to get anchor points for labels and check that each
-    // potential label passes text-max-angle check and has enough froom to fit
-    // on the line.
-
-    const angleWindowSize = getAngleWindowSize(shapedText, glyphSize, boxScale);
-    const shapedLabelLength = getShapedLabelLength(shapedText, shapedIcon);
-    const labelLength = shapedLabelLength * boxScale;
-
-    // Is the line continued from outside the tile boundary?
-    const isLineContinued = line[0].x === 0 || line[0].x === tileExtent || line[0].y === 0 || line[0].y === tileExtent;
-
-    // Is the label long, relative to the spacing?
-    // If so, adjust the spacing so there is always a minimum space of `spacing / 4` between label edges.
-    if (spacing - labelLength < spacing / 4) {
-        spacing = labelLength + spacing / 4;
-    }
-
-    // Offset the first anchor by:
-    // Either half the label length plus a fixed extra offset if the line is not continued
-    // Or half the spacing if the line is continued.
-
-    // For non-continued lines, add a bit of fixed extra offset to avoid collisions at T intersections.
-    const fixedExtraOffset = glyphSize * 2;
-
-    const offset = !isLineContinued ?
-        ((shapedLabelLength / 2 + fixedExtraOffset) * boxScale * overscaling) % spacing :
-        (spacing / 2 * overscaling) % spacing;
-
-    return resample(line, offset, spacing, angleWindowSize, maxAngle, labelLength, isLineContinued, false, tileExtent);
-}
-
-function resample(line, offset, spacing, angleWindowSize, maxAngle, labelLength, isLineContinued, placeAtMiddle, tileExtent) {
-
-    const halfLabelLength = labelLength / 2;
-    const lineLength = getLineLength(line);
-
-    let distance = 0,
-        markedDistance = offset - spacing;
-
-    let anchors = [];
-
-    for (let i = 0; i < line.length - 1; i++) {
-
-        const a = line[i],
-            b = line[i + 1];
-
-        const segmentDist = a.dist(b),
-            angle = b.angleTo(a);
-
-        while (markedDistance + spacing < distance + segmentDist) {
-            markedDistance += spacing;
-
-            const t = (markedDistance - distance) / segmentDist,
-                x = interpolate(a.x, b.x, t),
-                y = interpolate(a.y, b.y, t);
-
-            // Check that the point is within the tile boundaries and that
-            // the label would fit before the beginning and end of the line
-            // if placed at this point.
-            if (x >= 0 && x < tileExtent && y >= 0 && y < tileExtent &&
-                    markedDistance - halfLabelLength >= 0 &&
-                    markedDistance + halfLabelLength <= lineLength) {
-                const anchor = new Anchor(x, y, angle, i);
-                anchor._round();
-
-                if (!angleWindowSize || checkMaxAngle(line, anchor, labelLength, angleWindowSize, maxAngle)) {
-                    anchors.push(anchor);
-                }
-            }
-        }
-
-        distance += segmentDist;
-    }
-
-    if (!placeAtMiddle && !anchors.length && !isLineContinued) {
-        // The first attempt at finding anchors at which labels can be placed failed.
-        // Try again, but this time just try placing one anchor at the middle of the line.
-        // This has the most effect for short lines in overscaled tiles, since the
-        // initial offset used in overscaled tiles is calculated to align labels with positions in
-        // parent tiles instead of placing the label as close to the beginning as possible.
-        anchors = resample(line, distance / 2, spacing, angleWindowSize, maxAngle, labelLength, isLineContinued, true, tileExtent);
-    }
-
-    return anchors;
-}