/** * MapLibre GL JS * @license 3-Clause BSD. Full text of license: https://github.com/maplibre/maplibre-gl-js/blob/v4.7.0/LICENSE.txt */ (function (global, factory) { typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) : typeof define === 'function' && define.amd ? define(['exports'], factory) : (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.maplibregl = {})); })(this, (function (exports) { 'use strict'; var name = "maplibre-gl"; var description = "BSD licensed community fork of mapbox-gl, a WebGL interactive maps library"; var version$2 = "4.7.0"; var main = "dist/maplibre-gl.js"; var style = "dist/maplibre-gl.css"; var license = "BSD-3-Clause"; var homepage = "https://maplibre.org/"; var funding = "https://github.com/maplibre/maplibre-gl-js?sponsor=1"; var bugs = { url: "https://github.com/maplibre/maplibre-gl-js/issues/" }; var repository = { type: "git", url: "git://github.com/maplibre/maplibre-gl-js.git" }; var types$2 = "dist/maplibre-gl.d.ts"; var type = "module"; var dependencies = { "@mapbox/geojson-rewind": "^0.5.2", "@mapbox/jsonlint-lines-primitives": "^2.0.2", "@mapbox/point-geometry": "^0.1.0", "@mapbox/tiny-sdf": "^2.0.6", "@mapbox/unitbezier": "^0.0.1", "@mapbox/vector-tile": "^1.3.1", "@mapbox/whoots-js": "^3.1.0", "@maplibre/maplibre-gl-style-spec": "^20.3.1", "@types/geojson": "^7946.0.14", "@types/geojson-vt": "3.2.5", "@types/mapbox__point-geometry": "^0.1.4", "@types/mapbox__vector-tile": "^1.3.4", "@types/pbf": "^3.0.5", "@types/supercluster": "^7.1.3", earcut: "^3.0.0", "geojson-vt": "^4.0.2", "gl-matrix": "^3.4.3", "global-prefix": "^4.0.0", kdbush: "^4.0.2", "murmurhash-js": "^1.0.0", pbf: "^3.3.0", potpack: "^2.0.0", quickselect: "^3.0.0", supercluster: "^8.0.1", tinyqueue: "^3.0.0", "vt-pbf": "^3.1.3" }; var devDependencies = { autoprefixer: "^10.4.20", "@mapbox/mapbox-gl-rtl-text": "^0.3.0", "@mapbox/mvt-fixtures": "^3.10.0", "@rollup/plugin-commonjs": "^26.0.1", "@rollup/plugin-json": "^6.1.0", "@rollup/plugin-node-resolve": "^15.2.3", "@rollup/plugin-replace": "^5.0.7", "@rollup/plugin-strip": "^3.0.4", "@rollup/plugin-terser": "^0.4.4", "@rollup/plugin-typescript": "^11.1.6", "@types/benchmark": "^2.1.5", "@types/cssnano": "^5.0.0", "@types/d3": "^7.4.3", "@types/diff": "^5.2.2", "@types/earcut": "^2.1.4", "@types/eslint": "^8.56.7", "@types/gl": "^6.0.5", "@types/glob": "^8.1.0", "@types/jest": "^29.5.12", "@types/jsdom": "^21.1.7", "@types/minimist": "^1.2.5", "@types/murmurhash-js": "^1.0.6", "@types/nise": "^1.4.5", "@types/node": "^22.5.4", "@types/offscreencanvas": "^2019.7.3", "@types/pixelmatch": "^5.2.6", "@types/pngjs": "^6.0.5", "@types/react": "^18.3.5", "@types/react-dom": "^18.3.0", "@types/request": "^2.48.12", "@types/shuffle-seed": "^1.1.3", "@types/window-or-global": "^1.0.6", "@typescript-eslint/eslint-plugin": "^7.18.0", "@typescript-eslint/parser": "^7.18.0", address: "^2.0.3", benchmark: "^2.1.4", canvas: "^2.11.2", cssnano: "^7.0.6", d3: "^7.9.0", "d3-queue": "^3.0.7", "devtools-protocol": "^0.0.1351223", diff: "^6.0.0", "dts-bundle-generator": "^9.5.1", eslint: "^8.57.0", "eslint-config-mourner": "^3.0.0", "eslint-plugin-html": "^8.1.1", "eslint-plugin-import": "^2.30.0", "eslint-plugin-jest": "^28.8.3", "eslint-plugin-react": "^7.35.2", "eslint-plugin-tsdoc": "0.3.0", expect: "^29.7.0", glob: "^11.0.0", "is-builtin-module": "^4.0.0", jest: "^29.7.0", "jest-environment-jsdom": "^29.7.0", "jest-junit": "^16.0.0", "jest-monocart-coverage": "^1.1.1", "jest-webgl-canvas-mock": "^2.5.3", jsdom: "^25.0.0", "junit-report-builder": "^5.0.0", minimist: "^1.2.8", "mock-geolocation": "^1.0.11", "monocart-coverage-reports": "^2.10.3", nise: "^6.0.0", "npm-font-open-sans": "^1.1.0", "npm-run-all": "^4.1.5", "pdf-merger-js": "^5.1.2", pixelmatch: "^6.0.0", pngjs: "^7.0.0", postcss: "^8.4.45", "postcss-cli": "^11.0.0", "postcss-inline-svg": "^6.0.0", "pretty-bytes": "^6.1.1", puppeteer: "^23.3.0", react: "^18.3.1", "react-dom": "^18.3.1", rollup: "^4.21.2", "rollup-plugin-sourcemaps": "^0.6.3", rw: "^1.3.3", semver: "^7.6.3", "shuffle-seed": "^1.1.6", "source-map-explorer": "^2.5.3", st: "^3.0.0", stylelint: "^16.9.0", "stylelint-config-standard": "^36.0.1", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", tslib: "^2.7.0", typedoc: "^0.26.6", "typedoc-plugin-markdown": "^4.2.7", "typedoc-plugin-missing-exports": "^3.0.0", typescript: "^5.5.4" }; var scripts = { "generate-dist-package": "node --no-warnings --loader ts-node/esm build/generate-dist-package.js", "generate-shaders": "node --no-warnings --loader ts-node/esm build/generate-shaders.ts", "generate-struct-arrays": "node --no-warnings --loader ts-node/esm build/generate-struct-arrays.ts", "generate-style-code": "node --no-warnings --loader ts-node/esm build/generate-style-code.ts", "generate-typings": "dts-bundle-generator --export-referenced-types --umd-module-name=maplibregl -o ./dist/maplibre-gl.d.ts ./src/index.ts", "generate-docs": "typedoc && node --no-warnings --loader ts-node/esm build/generate-docs.ts", "generate-images": "node --no-warnings --loader ts-node/esm build/generate-doc-images.ts", "build-dist": "npm run build-css && npm run generate-typings && npm run build-dev && npm run build-csp-dev && npm run build-prod && npm run build-prod-unminified && npm run build-csp", "build-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev", "watch-dev": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:dev --watch", "build-prod": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:production,MINIFY:true", "build-prod-unminified": "rollup --configPlugin @rollup/plugin-typescript -c --environment BUILD:production", "build-csp": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.csp.ts --environment BUILD:production,MINIFY:true", "build-csp-dev": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.csp.ts --environment BUILD:dev", "build-css": "postcss -o dist/maplibre-gl.css src/css/maplibre-gl.css", "watch-css": "postcss --watch -o dist/maplibre-gl.css src/css/maplibre-gl.css", "build-benchmarks": "npm run build-dev && rollup --configPlugin @rollup/plugin-typescript -c test/bench/rollup_config_benchmarks.ts", "watch-benchmarks": "rollup --configPlugin @rollup/plugin-typescript -c test/bench/rollup_config_benchmarks.ts --watch", "start-server": "st --no-cache -H 0.0.0.0 --port 9966 .", "start-docs": "docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material", start: "run-p watch-css watch-dev start-server", "start-bench": "run-p watch-css watch-benchmarks start-server", lint: "eslint --cache --ext .ts,.tsx,.js,.html --ignore-path .gitignore .", "lint-css": "stylelint **/*.css --fix -f verbose", test: "run-p lint lint-css test-render jest", jest: "jest", "test-build": "jest --selectProjects=build --reporters=default", "test-build-ci": "jest --selectProjects=build", "test-integration": "jest --selectProjects=integration --reporters=default", "test-integration-ci": "jest --coverage --selectProjects=integration", "test-render": "node --no-warnings --loader ts-node/esm test/integration/render/run_render_tests.ts", "test-unit": "jest --selectProjects=unit --reporters=default", "test-unit-ci": "jest --coverage --selectProjects unit", "test-watch-roots": "jest --watch", codegen: "run-p --print-label generate-dist-package generate-style-code generate-struct-arrays generate-shaders && npm run generate-typings", benchmark: "node --no-warnings --loader ts-node/esm test/bench/run-benchmarks.ts", "gl-stats": "node --no-warnings --loader ts-node/esm test/bench/gl-stats.ts", prepare: "npm run codegen", typecheck: "tsc --noEmit && tsc --project tsconfig.dist.json", tsnode: "node --experimental-loader=ts-node/esm --no-warnings" }; var files = [ "build/", "dist/*", "src/" ]; var engines = { npm: ">=8.1.0", node: ">=16.14.0" }; var packageJSON = { name: name, description: description, version: version$2, main: main, style: style, license: license, homepage: homepage, funding: funding, bugs: bugs, repository: repository, types: types$2, type: type, dependencies: dependencies, devDependencies: devDependencies, scripts: scripts, files: files, engines: engines }; /****************************************************************************** Copyright (c) Microsoft Corporation. Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ***************************************************************************** */ /* global Reflect, Promise, SuppressedError, Symbol, Iterator */ var extendStatics = function(d, b) { extendStatics = Object.setPrototypeOf || ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) || function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; }; return extendStatics(d, b); }; function __extends(d, b) { if (typeof b !== "function" && b !== null) throw new TypeError("Class extends value " + String(b) + " is not a constructor or null"); extendStatics(d, b); function __() { this.constructor = d; } d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __()); } var __assign = function() { __assign = Object.assign || function __assign(t) { for (var s, i = 1, n = arguments.length; i < n; i++) { s = arguments[i]; for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p]; } return t; }; return __assign.apply(this, arguments); }; function __rest(s, e) { var t = {}; for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0) t[p] = s[p]; if (s != null && typeof Object.getOwnPropertySymbols === "function") for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) { if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i])) t[p[i]] = s[p[i]]; } return t; } function __decorate(decorators, target, key, desc) { var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d; if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc); else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r; return c > 3 && r && Object.defineProperty(target, key, r), r; } function __param(paramIndex, decorator) { return function (target, key) { decorator(target, key, paramIndex); } } function __esDecorate(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) { function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; } var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value"; var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null; var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {}); var _, done = false; for (var i = decorators.length - 1; i >= 0; i--) { var context = {}; for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p]; for (var p in contextIn.access) context.access[p] = contextIn.access[p]; context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); }; var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context); if (kind === "accessor") { if (result === void 0) continue; if (result === null || typeof result !== "object") throw new TypeError("Object expected"); if (_ = accept(result.get)) descriptor.get = _; if (_ = accept(result.set)) descriptor.set = _; if (_ = accept(result.init)) initializers.unshift(_); } else if (_ = accept(result)) { if (kind === "field") initializers.unshift(_); else descriptor[key] = _; } } if (target) Object.defineProperty(target, contextIn.name, descriptor); done = true; }; function __runInitializers(thisArg, initializers, value) { var useValue = arguments.length > 2; for (var i = 0; i < initializers.length; i++) { value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg); } return useValue ? value : void 0; }; function __propKey(x) { return typeof x === "symbol" ? x : "".concat(x); }; function __setFunctionName(f, name, prefix) { if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : ""; return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name }); }; function __metadata(metadataKey, metadataValue) { if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue); } function __awaiter(thisArg, _arguments, P, generator) { function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); } return new (P || (P = Promise))(function (resolve, reject) { function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); } step((generator = generator.apply(thisArg, _arguments || [])).next()); }); } function __generator(thisArg, body) { var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype); return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g; function verb(n) { return function (v) { return step([n, v]); }; } function step(op) { if (f) throw new TypeError("Generator is already executing."); while (g && (g = 0, op[0] && (_ = 0)), _) try { if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t; if (y = 0, t) op = [op[0] & 2, t.value]; switch (op[0]) { case 0: case 1: t = op; break; case 4: _.label++; return { value: op[1], done: false }; case 5: _.label++; y = op[1]; op = [0]; continue; case 7: op = _.ops.pop(); _.trys.pop(); continue; default: if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; } if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; } if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; } if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; } if (t[2]) _.ops.pop(); _.trys.pop(); continue; } op = body.call(thisArg, _); } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; } if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true }; } } var __createBinding = Object.create ? (function(o, m, k, k2) { if (k2 === undefined) k2 = k; var desc = Object.getOwnPropertyDescriptor(m, k); if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) { desc = { enumerable: true, get: function() { return m[k]; } }; } Object.defineProperty(o, k2, desc); }) : (function(o, m, k, k2) { if (k2 === undefined) k2 = k; o[k2] = m[k]; }); function __exportStar(m, o) { for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p); } function __values(o) { var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0; if (m) return m.call(o); if (o && typeof o.length === "number") return { next: function () { if (o && i >= o.length) o = void 0; return { value: o && o[i++], done: !o }; } }; throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined."); } function __read(o, n) { var m = typeof Symbol === "function" && o[Symbol.iterator]; if (!m) return o; var i = m.call(o), r, ar = [], e; try { while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value); } catch (error) { e = { error: error }; } finally { try { if (r && !r.done && (m = i["return"])) m.call(i); } finally { if (e) throw e.error; } } return ar; } /** @deprecated */ function __spread() { for (var ar = [], i = 0; i < arguments.length; i++) ar = ar.concat(__read(arguments[i])); return ar; } /** @deprecated */ function __spreadArrays() { for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length; for (var r = Array(s), k = 0, i = 0; i < il; i++) for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++) r[k] = a[j]; return r; } function __spreadArray(to, from, pack) { if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) { if (ar || !(i in from)) { if (!ar) ar = Array.prototype.slice.call(from, 0, i); ar[i] = from[i]; } } return to.concat(ar || Array.prototype.slice.call(from)); } function __await(v) { return this instanceof __await ? (this.v = v, this) : new __await(v); } function __asyncGenerator(thisArg, _arguments, generator) { if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined."); var g = generator.apply(thisArg, _arguments || []), i, q = []; return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i; function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; } function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } } function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } } function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); } function fulfill(value) { resume("next", value); } function reject(value) { resume("throw", value); } function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); } } function __asyncDelegator(o) { var i, p; return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i; function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; } } function __asyncValues(o) { if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined."); var m = o[Symbol.asyncIterator], i; return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i); function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; } function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); } } function __makeTemplateObject(cooked, raw) { if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; } return cooked; }; var __setModuleDefault = Object.create ? (function(o, v) { Object.defineProperty(o, "default", { enumerable: true, value: v }); }) : function(o, v) { o["default"] = v; }; function __importStar(mod) { if (mod && mod.__esModule) return mod; var result = {}; if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k); __setModuleDefault(result, mod); return result; } function __importDefault(mod) { return (mod && mod.__esModule) ? mod : { default: mod }; } function __classPrivateFieldGet(receiver, state, kind, f) { if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter"); if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it"); return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver); } function __classPrivateFieldSet(receiver, state, value, kind, f) { if (kind === "m") throw new TypeError("Private method is not writable"); if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter"); if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it"); return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value; } function __classPrivateFieldIn(state, receiver) { if (receiver === null || (typeof receiver !== "object" && typeof receiver !== "function")) throw new TypeError("Cannot use 'in' operator on non-object"); return typeof state === "function" ? receiver === state : state.has(receiver); } function __addDisposableResource(env, value, async) { if (value !== null && value !== void 0) { if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected."); var dispose, inner; if (async) { if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined."); dispose = value[Symbol.asyncDispose]; } if (dispose === void 0) { if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined."); dispose = value[Symbol.dispose]; if (async) inner = dispose; } if (typeof dispose !== "function") throw new TypeError("Object not disposable."); if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } }; env.stack.push({ value: value, dispose: dispose, async: async }); } else if (async) { env.stack.push({ async: true }); } return value; } var _SuppressedError = typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) { var e = new Error(message); return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e; }; function __disposeResources(env) { function fail(e) { env.error = env.hasError ? new _SuppressedError(e, env.error, "An error was suppressed during disposal.") : e; env.hasError = true; } var r, s = 0; function next() { while (r = env.stack.pop()) { try { if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next); if (r.dispose) { var result = r.dispose.call(r.value); if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); }); } else s |= 1; } catch (e) { fail(e); } } if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve(); if (env.hasError) throw env.error; } return next(); } var tslib_es6 = { __extends: __extends, __assign: __assign, __rest: __rest, __decorate: __decorate, __param: __param, __metadata: __metadata, __awaiter: __awaiter, __generator: __generator, __createBinding: __createBinding, __exportStar: __exportStar, __values: __values, __read: __read, __spread: __spread, __spreadArrays: __spreadArrays, __spreadArray: __spreadArray, __await: __await, __asyncGenerator: __asyncGenerator, __asyncDelegator: __asyncDelegator, __asyncValues: __asyncValues, __makeTemplateObject: __makeTemplateObject, __importStar: __importStar, __importDefault: __importDefault, __classPrivateFieldGet: __classPrivateFieldGet, __classPrivateFieldSet: __classPrivateFieldSet, __classPrivateFieldIn: __classPrivateFieldIn, __addDisposableResource: __addDisposableResource, __disposeResources: __disposeResources, }; var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {}; function getDefaultExportFromCjs$1 (x) { return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x; } function getDefaultExportFromNamespaceIfPresent (n) { return n && Object.prototype.hasOwnProperty.call(n, 'default') ? n['default'] : n; } function getDefaultExportFromNamespaceIfNotNamed (n) { return n && Object.prototype.hasOwnProperty.call(n, 'default') && Object.keys(n).length === 1 ? n['default'] : n; } function getAugmentedNamespace(n) { if (n.__esModule) return n; var f = n.default; if (typeof f == "function") { var a = function a () { if (this instanceof a) { return Reflect.construct(f, arguments, this.constructor); } return f.apply(this, arguments); }; a.prototype = f.prototype; } else a = {}; Object.defineProperty(a, '__esModule', {value: true}); Object.keys(n).forEach(function (k) { var d = Object.getOwnPropertyDescriptor(n, k); Object.defineProperty(a, k, d.get ? d : { enumerable: true, get: function () { return n[k]; } }); }); return a; } 'use strict'; var pointGeometry = Point$1; /** * A standalone point geometry with useful accessor, comparison, and * modification methods. * * @class Point * @param {Number} x the x-coordinate. this could be longitude or screen * pixels, or any other sort of unit. * @param {Number} y the y-coordinate. this could be latitude or screen * pixels, or any other sort of unit. * @example * var point = new Point(-77, 38); */ function Point$1(x, y) { this.x = x; this.y = y; } Point$1.prototype = { /** * Clone this point, returning a new point that can be modified * without affecting the old one. * @return {Point} the clone */ clone: function() { return new Point$1(this.x, this.y); }, /** * Add this point's x & y coordinates to another point, * yielding a new point. * @param {Point} p the other point * @return {Point} output point */ add: function(p) { return this.clone()._add(p); }, /** * Subtract this point's x & y coordinates to from point, * yielding a new point. * @param {Point} p the other point * @return {Point} output point */ sub: function(p) { return this.clone()._sub(p); }, /** * Multiply this point's x & y coordinates by point, * yielding a new point. * @param {Point} p the other point * @return {Point} output point */ multByPoint: function(p) { return this.clone()._multByPoint(p); }, /** * Divide this point's x & y coordinates by point, * yielding a new point. * @param {Point} p the other point * @return {Point} output point */ divByPoint: function(p) { return this.clone()._divByPoint(p); }, /** * Multiply this point's x & y coordinates by a factor, * yielding a new point. * @param {Point} k factor * @return {Point} output point */ mult: function(k) { return this.clone()._mult(k); }, /** * Divide this point's x & y coordinates by a factor, * yielding a new point. * @param {Point} k factor * @return {Point} output point */ div: function(k) { return this.clone()._div(k); }, /** * Rotate this point around the 0, 0 origin by an angle a, * given in radians * @param {Number} a angle to rotate around, in radians * @return {Point} output point */ rotate: function(a) { return this.clone()._rotate(a); }, /** * Rotate this point around p point by an angle a, * given in radians * @param {Number} a angle to rotate around, in radians * @param {Point} p Point to rotate around * @return {Point} output point */ rotateAround: function(a,p) { return this.clone()._rotateAround(a,p); }, /** * Multiply this point by a 4x1 transformation matrix * @param {Array} m transformation matrix * @return {Point} output point */ matMult: function(m) { return this.clone()._matMult(m); }, /** * Calculate this point but as a unit vector from 0, 0, meaning * that the distance from the resulting point to the 0, 0 * coordinate will be equal to 1 and the angle from the resulting * point to the 0, 0 coordinate will be the same as before. * @return {Point} unit vector point */ unit: function() { return this.clone()._unit(); }, /** * Compute a perpendicular point, where the new y coordinate * is the old x coordinate and the new x coordinate is the old y * coordinate multiplied by -1 * @return {Point} perpendicular point */ perp: function() { return this.clone()._perp(); }, /** * Return a version of this point with the x & y coordinates * rounded to integers. * @return {Point} rounded point */ round: function() { return this.clone()._round(); }, /** * Return the magitude of this point: this is the Euclidean * distance from the 0, 0 coordinate to this point's x and y * coordinates. * @return {Number} magnitude */ mag: function() { return Math.sqrt(this.x * this.x + this.y * this.y); }, /** * Judge whether this point is equal to another point, returning * true or false. * @param {Point} other the other point * @return {boolean} whether the points are equal */ equals: function(other) { return this.x === other.x && this.y === other.y; }, /** * Calculate the distance from this point to another point * @param {Point} p the other point * @return {Number} distance */ dist: function(p) { return Math.sqrt(this.distSqr(p)); }, /** * Calculate the distance from this point to another point, * without the square root step. Useful if you're comparing * relative distances. * @param {Point} p the other point * @return {Number} distance */ distSqr: function(p) { var dx = p.x - this.x, dy = p.y - this.y; return dx * dx + dy * dy; }, /** * Get the angle from the 0, 0 coordinate to this point, in radians * coordinates. * @return {Number} angle */ angle: function() { return Math.atan2(this.y, this.x); }, /** * Get the angle from this point to another point, in radians * @param {Point} b the other point * @return {Number} angle */ angleTo: function(b) { return Math.atan2(this.y - b.y, this.x - b.x); }, /** * Get the angle between this point and another point, in radians * @param {Point} b the other point * @return {Number} angle */ angleWith: function(b) { return this.angleWithSep(b.x, b.y); }, /* * Find the angle of the two vectors, solving the formula for * the cross product a x b = |a||b|sin(θ) for θ. * @param {Number} x the x-coordinate * @param {Number} y the y-coordinate * @return {Number} the angle in radians */ angleWithSep: function(x, y) { return Math.atan2( this.x * y - this.y * x, this.x * x + this.y * y); }, _matMult: function(m) { var x = m[0] * this.x + m[1] * this.y, y = m[2] * this.x + m[3] * this.y; this.x = x; this.y = y; return this; }, _add: function(p) { this.x += p.x; this.y += p.y; return this; }, _sub: function(p) { this.x -= p.x; this.y -= p.y; return this; }, _mult: function(k) { this.x *= k; this.y *= k; return this; }, _div: function(k) { this.x /= k; this.y /= k; return this; }, _multByPoint: function(p) { this.x *= p.x; this.y *= p.y; return this; }, _divByPoint: function(p) { this.x /= p.x; this.y /= p.y; return this; }, _unit: function() { this._div(this.mag()); return this; }, _perp: function() { var y = this.y; this.y = this.x; this.x = -y; return this; }, _rotate: function(angle) { var cos = Math.cos(angle), sin = Math.sin(angle), x = cos * this.x - sin * this.y, y = sin * this.x + cos * this.y; this.x = x; this.y = y; return this; }, _rotateAround: function(angle, p) { var cos = Math.cos(angle), sin = Math.sin(angle), x = p.x + cos * (this.x - p.x) - sin * (this.y - p.y), y = p.y + sin * (this.x - p.x) + cos * (this.y - p.y); this.x = x; this.y = y; return this; }, _round: function() { this.x = Math.round(this.x); this.y = Math.round(this.y); return this; } }; /** * Construct a point from an array if necessary, otherwise if the input * is already a Point, or an unknown type, return it unchanged * @param {Array|Point|*} a any kind of input value * @return {Point} constructed point, or passed-through value. * @example * // this * var point = Point.convert([0, 1]); * // is equivalent to * var point = new Point(0, 1); */ Point$1.convert = function (a) { if (a instanceof Point$1) { return a; } if (Array.isArray(a)) { return new Point$1(a[0], a[1]); } return a; }; var Point$2 = /*@__PURE__*/getDefaultExportFromCjs$1(pointGeometry); 'use strict'; var unitbezier$1 = UnitBezier$2; function UnitBezier$2(p1x, p1y, p2x, p2y) { // Calculate the polynomial coefficients, implicit first and last control points are (0,0) and (1,1). this.cx = 3.0 * p1x; this.bx = 3.0 * (p2x - p1x) - this.cx; this.ax = 1.0 - this.cx - this.bx; this.cy = 3.0 * p1y; this.by = 3.0 * (p2y - p1y) - this.cy; this.ay = 1.0 - this.cy - this.by; this.p1x = p1x; this.p1y = p1y; this.p2x = p2x; this.p2y = p2y; } UnitBezier$2.prototype = { sampleCurveX: function (t) { // `ax t^3 + bx t^2 + cx t' expanded using Horner's rule. return ((this.ax * t + this.bx) * t + this.cx) * t; }, sampleCurveY: function (t) { return ((this.ay * t + this.by) * t + this.cy) * t; }, sampleCurveDerivativeX: function (t) { return (3.0 * this.ax * t + 2.0 * this.bx) * t + this.cx; }, solveCurveX: function (x, epsilon) { if (epsilon === undefined) epsilon = 1e-6; if (x < 0.0) return 0.0; if (x > 1.0) return 1.0; var t = x; // First try a few iterations of Newton's method - normally very fast. for (var i = 0; i < 8; i++) { var x2 = this.sampleCurveX(t) - x; if (Math.abs(x2) < epsilon) return t; var d2 = this.sampleCurveDerivativeX(t); if (Math.abs(d2) < 1e-6) break; t = t - x2 / d2; } // Fall back to the bisection method for reliability. var t0 = 0.0; var t1 = 1.0; t = x; for (i = 0; i < 20; i++) { x2 = this.sampleCurveX(t); if (Math.abs(x2 - x) < epsilon) break; if (x > x2) { t0 = t; } else { t1 = t; } t = (t1 - t0) * 0.5 + t0; } return t; }, solve: function (x, epsilon) { return this.sampleCurveY(this.solveCurveX(x, epsilon)); } }; var UnitBezier$3 = /*@__PURE__*/getDefaultExportFromCjs$1(unitbezier$1); let supportsOffscreenCanvas; function offscreenCanvasSupported() { if (supportsOffscreenCanvas == null) { supportsOffscreenCanvas = typeof OffscreenCanvas !== 'undefined' && new OffscreenCanvas(1, 1).getContext('2d') && typeof createImageBitmap === 'function'; } return supportsOffscreenCanvas; } let offscreenCanvasDistorted; /** * Some browsers don't return the exact pixels from a canvas to prevent user fingerprinting (see #3185). * This function writes pixels to an OffscreenCanvas and reads them back using getImageData, returning false * if they don't match. * * @returns true if the browser supports OffscreenCanvas but it distorts getImageData results, false otherwise. */ function isOffscreenCanvasDistorted() { if (offscreenCanvasDistorted == null) { offscreenCanvasDistorted = false; if (offscreenCanvasSupported()) { const size = 5; const canvas = new OffscreenCanvas(size, size); const context = canvas.getContext('2d', { willReadFrequently: true }); if (context) { // fill each pixel with an RGB value that should make the byte at index i equal to i (except alpha channel): // [0, 1, 2, 255, 4, 5, 6, 255, 8, 9, 10, 255, ...] for (let i = 0; i < size * size; i++) { const base = i * 4; context.fillStyle = `rgb(${base},${base + 1},${base + 2})`; context.fillRect(i % size, Math.floor(i / size), 1, 1); } const data = context.getImageData(0, 0, size, size).data; for (let i = 0; i < size * size * 4; i++) { if (i % 4 !== 3 && data[i] !== i) { offscreenCanvasDistorted = true; break; } } } } } return offscreenCanvasDistorted || false; } /** * For a given collection of 2D points, returns their axis-aligned bounding box, * in the format [minX, minY, maxX, maxY]. */ function getAABB(points) { let tlX = Infinity; let tlY = Infinity; let brX = -Infinity; let brY = -Infinity; for (const p of points) { tlX = Math.min(tlX, p.x); tlY = Math.min(tlY, p.y); brX = Math.max(brX, p.x); brY = Math.max(brY, p.y); } return [tlX, tlY, brX, brY]; } /** * Given a value `t` that varies between 0 and 1, return * an interpolation function that eases between 0 and 1 in a pleasing * cubic in-out fashion. */ function easeCubicInOut(t) { if (t <= 0) return 0; if (t >= 1) return 1; const t2 = t * t, t3 = t2 * t; return 4 * (t < 0.5 ? t3 : 3 * (t - t2) + t3 - 0.75); } /** * Given given (x, y), (x1, y1) control points for a bezier curve, * return a function that interpolates along that curve. * * @param p1x - control point 1 x coordinate * @param p1y - control point 1 y coordinate * @param p2x - control point 2 x coordinate * @param p2y - control point 2 y coordinate */ function bezier$1(p1x, p1y, p2x, p2y) { const bezier = new UnitBezier$3(p1x, p1y, p2x, p2y); return (t) => { return bezier.solve(t); }; } /** * A default bezier-curve powered easing function with * control points (0.25, 0.1) and (0.25, 1) */ const defaultEasing = bezier$1(0.25, 0.1, 0.25, 1); /** * constrain n to the given range via min + max * * @param n - value * @param min - the minimum value to be returned * @param max - the maximum value to be returned * @returns the clamped value */ function clamp$1(n, min, max) { return Math.min(max, Math.max(min, n)); } /** * constrain n to the given range, excluding the minimum, via modular arithmetic * * @param n - value * @param min - the minimum value to be returned, exclusive * @param max - the maximum value to be returned, inclusive * @returns constrained number */ function wrap(n, min, max) { const d = max - min; const w = ((n - min) % d + d) % d + min; return (w === min) ? max : w; } /** * Compute the difference between the keys in one object and the keys * in another object. * * @returns keys difference */ function keysDifference(obj, other) { const difference = []; for (const i in obj) { if (!(i in other)) { difference.push(i); } } return difference; } function extend(dest, ...sources) { for (const src of sources) { for (const k in src) { dest[k] = src[k]; } } return dest; } /** * Given an object and a number of properties as strings, return version * of that object with only those properties. * * @param src - the object * @param properties - an array of property names chosen * to appear on the resulting object. * @returns object with limited properties. * @example * ```ts * let foo = { name: 'Charlie', age: 10 }; * let justName = pick(foo, ['name']); // justName = { name: 'Charlie' } * ``` */ function pick(src, properties) { const result = {}; for (let i = 0; i < properties.length; i++) { const k = properties[i]; if (k in src) { result[k] = src[k]; } } return result; } let id = 1; /** * Return a unique numeric id, starting at 1 and incrementing with * each call. * * @returns unique numeric id. */ function uniqueId() { return id++; } /** * Return whether a given value is a power of two */ function isPowerOfTwo(value) { return (Math.log(value) / Math.LN2) % 1 === 0; } /** * Return the next power of two, or the input value if already a power of two */ function nextPowerOfTwo(value) { if (value <= 1) return 1; return Math.pow(2, Math.ceil(Math.log(value) / Math.LN2)); } /** * Create an object by mapping all the values of an existing object while * preserving their keys. */ function mapObject(input, iterator, context) { const output = {}; for (const key in input) { output[key] = iterator.call(context || this, input[key], key, input); } return output; } /** * Create an object by filtering out values of an existing object. */ function filterObject(input, iterator, context) { const output = {}; for (const key in input) { if (iterator.call(context || this, input[key], key, input)) { output[key] = input[key]; } } return output; } /** * Deeply compares two object literals. * @param a - first object literal to be compared * @param b - second object literal to be compared * @returns true if the two object literals are deeply equal, false otherwise */ function deepEqual$1(a, b) { if (Array.isArray(a)) { if (!Array.isArray(b) || a.length !== b.length) return false; for (let i = 0; i < a.length; i++) { if (!deepEqual$1(a[i], b[i])) return false; } return true; } if (typeof a === 'object' && a !== null && b !== null) { if (!(typeof b === 'object')) return false; const keys = Object.keys(a); if (keys.length !== Object.keys(b).length) return false; for (const key in a) { if (!deepEqual$1(a[key], b[key])) return false; } return true; } return a === b; } /** * Deeply clones two objects. */ function clone$9(input) { if (Array.isArray(input)) { return input.map(clone$9); } else if (typeof input === 'object' && input) { return mapObject(input, clone$9); } else { return input; } } /** * Check if two arrays have at least one common element. */ function arraysIntersect(a, b) { for (let l = 0; l < a.length; l++) { if (b.indexOf(a[l]) >= 0) return true; } return false; } /** * Print a warning message to the console and ensure duplicate warning messages * are not printed. */ const warnOnceHistory = {}; function warnOnce(message) { if (!warnOnceHistory[message]) { // console isn't defined in some WebWorkers, see #2558 if (typeof console !== 'undefined') console.warn(message); warnOnceHistory[message] = true; } } /** * Indicates if the provided Points are in a counter clockwise (true) or clockwise (false) order * * @returns true for a counter clockwise set of points */ // https://bryceboe.com/2006/10/23/line-segment-intersection-algorithm/ function isCounterClockwise(a, b, c) { return (c.y - a.y) * (b.x - a.x) > (b.y - a.y) * (c.x - a.x); } /** * For two lines a and b in 2d space, defined by any two points along the lines, * find the intersection point, or return null if the lines are parallel * * @param a1 - First point on line a * @param a2 - Second point on line a * @param b1 - First point on line b * @param b2 - Second point on line b * * @returns the intersection point of the two lines or null if they are parallel */ function findLineIntersection(a1, a2, b1, b2) { const aDeltaY = a2.y - a1.y; const aDeltaX = a2.x - a1.x; const bDeltaY = b2.y - b1.y; const bDeltaX = b2.x - b1.x; const denominator = (bDeltaY * aDeltaX) - (bDeltaX * aDeltaY); if (denominator === 0) { // Lines are parallel return null; } const originDeltaY = a1.y - b1.y; const originDeltaX = a1.x - b1.x; const aInterpolation = (bDeltaX * originDeltaY - bDeltaY * originDeltaX) / denominator; // Find intersection by projecting out from origin of first segment return new Point$2(a1.x + (aInterpolation * aDeltaX), a1.y + (aInterpolation * aDeltaY)); } /** * Converts spherical coordinates to cartesian coordinates. * * @param spherical - Spherical coordinates, in [radial, azimuthal, polar] * @returns cartesian coordinates in [x, y, z] */ function sphericalToCartesian([r, azimuthal, polar]) { // We abstract "north"/"up" (compass-wise) to be 0° when really this is 90° (π/2): // correct for that here azimuthal += 90; // Convert azimuthal and polar angles to radians azimuthal *= Math.PI / 180; polar *= Math.PI / 180; return { x: r * Math.cos(azimuthal) * Math.sin(polar), y: r * Math.sin(azimuthal) * Math.sin(polar), z: r * Math.cos(polar) }; } /** * Returns true if the when run in the web-worker context. * * @returns `true` if the when run in the web-worker context. */ function isWorker(self) { // @ts-ignore return typeof WorkerGlobalScope !== 'undefined' && typeof self !== 'undefined' && self instanceof WorkerGlobalScope; } /** * Parses data from 'Cache-Control' headers. * * @param cacheControl - Value of 'Cache-Control' header * @returns object containing parsed header info. */ function parseCacheControl(cacheControl) { // Taken from [Wreck](https://github.com/hapijs/wreck) const re = /(?:^|(?:\s*\,\s*))([^\x00-\x20\(\)<>@\,;\:\\"\/\[\]\?\=\{\}\x7F]+)(?:\=(?:([^\x00-\x20\(\)<>@\,;\:\\"\/\[\]\?\=\{\}\x7F]+)|(?:\"((?:[^"\\]|\\.)*)\")))?/g; const header = {}; cacheControl.replace(re, ($0, $1, $2, $3) => { const value = $2 || $3; header[$1] = value ? value.toLowerCase() : true; return ''; }); if (header['max-age']) { const maxAge = parseInt(header['max-age'], 10); if (isNaN(maxAge)) delete header['max-age']; else header['max-age'] = maxAge; } return header; } let _isSafari = null; /** * Returns true when run in WebKit derived browsers. * This is used as a workaround for a memory leak in Safari caused by using Transferable objects to * transfer data between WebWorkers and the main thread. * https://github.com/mapbox/mapbox-gl-js/issues/8771 * * This should be removed once the underlying Safari issue is fixed. * * @param scope - Since this function is used both on the main thread and WebWorker context, * let the calling scope pass in the global scope object. * @returns `true` when run in WebKit derived browsers. */ function isSafari(scope) { if (_isSafari == null) { const userAgent = scope.navigator ? scope.navigator.userAgent : null; _isSafari = !!scope.safari || !!(userAgent && (/\b(iPad|iPhone|iPod)\b/.test(userAgent) || (!!userAgent.match('Safari') && !userAgent.match('Chrome')))); } return _isSafari; } function storageAvailable(type) { try { const storage = window[type]; storage.setItem('_mapbox_test_', 1); storage.removeItem('_mapbox_test_'); return true; } catch (e) { return false; } } // The following methods are from https://developer.mozilla.org/en-US/docs/Web/API/WindowBase64/Base64_encoding_and_decoding#The_Unicode_Problem //Unicode compliant base64 encoder for strings function b64EncodeUnicode(str) { return btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g, (match, p1) => { return String.fromCharCode(Number('0x' + p1)); //eslint-disable-line })); } // Unicode compliant decoder for base64-encoded strings function b64DecodeUnicode(str) { return decodeURIComponent(atob(str).split('').map((c) => { return '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2); //eslint-disable-line }).join('')); } function isImageBitmap(image) { return typeof ImageBitmap !== 'undefined' && image instanceof ImageBitmap; } /** * Converts an ArrayBuffer to an ImageBitmap. * * Used mostly for testing purposes only, because mocking libs don't know how to work with ArrayBuffers, but work * perfectly fine with ImageBitmaps. Might also be used for environments (other than testing) not supporting * ArrayBuffers. * * @param data - Data to convert * @returns - A promise resolved when the conversion is finished */ const arrayBufferToImageBitmap = (data) => __awaiter(void 0, void 0, void 0, function* () { if (data.byteLength === 0) { return createImageBitmap(new ImageData(1, 1)); } const blob = new Blob([new Uint8Array(data)], { type: 'image/png' }); try { return createImageBitmap(blob); } catch (e) { throw new Error(`Could not load image because of ${e.message}. Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported.`); } }); const transparentPngUrl = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVQYV2NgAAIAAAUAAarVyFEAAAAASUVORK5CYII='; /** * Converts an ArrayBuffer to an HTMLImageElement. * * Used mostly for testing purposes only, because mocking libs don't know how to work with ArrayBuffers, but work * perfectly fine with ImageBitmaps. Might also be used for environments (other than testing) not supporting * ArrayBuffers. * * @param data - Data to convert * @returns - A promise resolved when the conversion is finished */ const arrayBufferToImage = (data) => { return new Promise((resolve, reject) => { const img = new Image(); img.onload = () => { resolve(img); URL.revokeObjectURL(img.src); // prevent image dataURI memory leak in Safari; // but don't free the image immediately because it might be uploaded in the next frame // https://github.com/mapbox/mapbox-gl-js/issues/10226 img.onload = null; window.requestAnimationFrame(() => { img.src = transparentPngUrl; }); }; img.onerror = () => reject(new Error('Could not load image. Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported.')); const blob = new Blob([new Uint8Array(data)], { type: 'image/png' }); img.src = data.byteLength ? URL.createObjectURL(blob) : transparentPngUrl; }); }; /** * Computes the webcodecs VideoFrame API options to select a rectangle out of * an image and write it into the destination rectangle. * * Rect (x/y/width/height) select the overlapping rectangle from the source image * and layout (offset/stride) write that overlapping rectangle to the correct place * in the destination image. * * Offset is the byte offset in the dest image that the first pixel appears at * and stride is the number of bytes to the start of the next row: * ┌───────────┐ * │ dest │ * │ ┌───┼───────┐ * │offset→│▓▓▓│ source│ * │ │▓▓▓│ │ * │ └───┼───────┘ * │stride ⇠╌╌╌│ * │╌╌╌╌╌╌→ │ * └───────────┘ * * @param image - source image containing a width and height attribute * @param x - top-left x coordinate to read from the image * @param y - top-left y coordinate to read from the image * @param width - width of the rectangle to read from the image * @param height - height of the rectangle to read from the image * @returns the layout and rect options to pass into VideoFrame API */ function computeVideoFrameParameters(image, x, y, width, height) { const destRowOffset = Math.max(-x, 0) * 4; const firstSourceRow = Math.max(0, y); const firstDestRow = firstSourceRow - y; const offset = firstDestRow * width * 4 + destRowOffset; const stride = width * 4; const sourceLeft = Math.max(0, x); const sourceTop = Math.max(0, y); const sourceRight = Math.min(image.width, x + width); const sourceBottom = Math.min(image.height, y + height); return { rect: { x: sourceLeft, y: sourceTop, width: sourceRight - sourceLeft, height: sourceBottom - sourceTop }, layout: [{ offset, stride }] }; } /** * Reads pixels from an ImageBitmap/Image/canvas using webcodec VideoFrame API. * * @param data - image, imagebitmap, or canvas to parse * @param x - top-left x coordinate to read from the image * @param y - top-left y coordinate to read from the image * @param width - width of the rectangle to read from the image * @param height - height of the rectangle to read from the image * @returns a promise containing the parsed RGBA pixel values of the image, or the error if an error occurred */ function readImageUsingVideoFrame(image, x, y, width, height) { return __awaiter(this, void 0, void 0, function* () { if (typeof VideoFrame === 'undefined') { throw new Error('VideoFrame not supported'); } const frame = new VideoFrame(image, { timestamp: 0 }); try { const format = frame === null || frame === void 0 ? void 0 : frame.format; if (!format || !(format.startsWith('BGR') || format.startsWith('RGB'))) { throw new Error(`Unrecognized format ${format}`); } const swapBR = format.startsWith('BGR'); const result = new Uint8ClampedArray(width * height * 4); yield frame.copyTo(result, computeVideoFrameParameters(image, x, y, width, height)); if (swapBR) { for (let i = 0; i < result.length; i += 4) { const tmp = result[i]; result[i] = result[i + 2]; result[i + 2] = tmp; } } return result; } finally { frame.close(); } }); } let offscreenCanvas; let offscreenCanvasContext; /** * Reads pixels from an ImageBitmap/Image/canvas using OffscreenCanvas * * @param data - image, imagebitmap, or canvas to parse * @param x - top-left x coordinate to read from the image * @param y - top-left y coordinate to read from the image * @param width - width of the rectangle to read from the image * @param height - height of the rectangle to read from the image * @returns a promise containing the parsed RGBA pixel values of the image, or the error if an error occurred */ function readImageDataUsingOffscreenCanvas(imgBitmap, x, y, width, height) { const origWidth = imgBitmap.width; const origHeight = imgBitmap.height; // Lazily initialize OffscreenCanvas if (!offscreenCanvas || !offscreenCanvasContext) { // Dem tiles are typically 256x256 offscreenCanvas = new OffscreenCanvas(origWidth, origHeight); offscreenCanvasContext = offscreenCanvas.getContext('2d', { willReadFrequently: true }); } offscreenCanvas.width = origWidth; offscreenCanvas.height = origHeight; offscreenCanvasContext.drawImage(imgBitmap, 0, 0, origWidth, origHeight); const imgData = offscreenCanvasContext.getImageData(x, y, width, height); offscreenCanvasContext.clearRect(0, 0, origWidth, origHeight); return imgData.data; } /** * Reads RGBA pixels from an preferring OffscreenCanvas, but falling back to VideoFrame if supported and * the browser is mangling OffscreenCanvas getImageData results. * * @param data - image, imagebitmap, or canvas to parse * @param x - top-left x coordinate to read from the image * @param y - top-left y coordinate to read from the image * @param width - width of the rectangle to read from the image * @param height - height of the rectangle to read from the image * @returns a promise containing the parsed RGBA pixel values of the image */ function getImageData(image, x, y, width, height) { return __awaiter(this, void 0, void 0, function* () { if (isOffscreenCanvasDistorted()) { try { return yield readImageUsingVideoFrame(image, x, y, width, height); } catch (e) { // fall back to OffscreenCanvas } } return readImageDataUsingOffscreenCanvas(image, x, y, width, height); }); } /** * This method is used in order to register an event listener using a lambda function. * The return value will allow unsubscribing from the event, without the need to store the method reference. * @param target - The target * @param message - The message * @param listener - The listener * @param options - The options * @returns a subscription object that can be used to unsubscribe from the event */ function subscribe(target, message, listener, options) { target.addEventListener(message, listener, options); return { unsubscribe: () => { target.removeEventListener(message, listener, options); } }; } /** * This method converts degrees to radians. * The return value is the radian value. * @param degrees - The number of degrees * @returns radians */ function degreesToRadians(degrees) { return degrees * Math.PI / 180; } /** * The maximum world tile zoom (Z). * In other words, the upper bound supported for tile zoom. */ const MAX_TILE_ZOOM = 25; /** * The minimum world tile zoom (Z). * In other words, the lower bound supported for tile zoom. */ const MIN_TILE_ZOOM = 0; /** * An error message to use when an operation is aborted */ const ABORT_ERROR = 'AbortError'; /** * Check if an error is an abort error * @param error - An error object * @returns - true if the error is an abort error */ function isAbortError(error) { return error.message === ABORT_ERROR; } /** * Use this when you need to create an abort error. * @returns An error object with the message "AbortError" */ function createAbortError() { return new Error(ABORT_ERROR); } const now = typeof performance !== 'undefined' && performance && performance.now ? performance.now.bind(performance) : Date.now.bind(Date); let linkEl; let reducedMotionQuery; /** */ const browser = { /** * Provides a function that outputs milliseconds: either performance.now() * or a fallback to Date.now() */ now, frameAsync(abortController) { return new Promise((resolve, reject) => { const frame = requestAnimationFrame(resolve); abortController.signal.addEventListener('abort', () => { cancelAnimationFrame(frame); reject(createAbortError()); }); }); }, getImageData(img, padding = 0) { const context = this.getImageCanvasContext(img); return context.getImageData(-padding, -padding, img.width + 2 * padding, img.height + 2 * padding); }, getImageCanvasContext(img) { const canvas = window.document.createElement('canvas'); const context = canvas.getContext('2d', { willReadFrequently: true }); if (!context) { throw new Error('failed to create canvas 2d context'); } canvas.width = img.width; canvas.height = img.height; context.drawImage(img, 0, 0, img.width, img.height); return context; }, resolveURL(path) { if (!linkEl) linkEl = document.createElement('a'); linkEl.href = path; return linkEl.href; }, hardwareConcurrency: typeof navigator !== 'undefined' && navigator.hardwareConcurrency || 4, get prefersReducedMotion() { // In case your test crashes when checking matchMedia, call setMatchMedia from 'src/util/test/util' if (!matchMedia) return false; //Lazily initialize media query if (reducedMotionQuery == null) { reducedMotionQuery = matchMedia('(prefers-reduced-motion: reduce)'); } return reducedMotionQuery.matches; }, }; class DOM { static testProp(props) { if (!DOM.docStyle) return props[0]; for (let i = 0; i < props.length; i++) { if (props[i] in DOM.docStyle) { return props[i]; } } return props[0]; } static create(tagName, className, container) { const el = window.document.createElement(tagName); if (className !== undefined) el.className = className; if (container) container.appendChild(el); return el; } static createNS(namespaceURI, tagName) { const el = window.document.createElementNS(namespaceURI, tagName); return el; } static disableDrag() { if (DOM.docStyle && DOM.selectProp) { DOM.userSelect = DOM.docStyle[DOM.selectProp]; DOM.docStyle[DOM.selectProp] = 'none'; } } static enableDrag() { if (DOM.docStyle && DOM.selectProp) { DOM.docStyle[DOM.selectProp] = DOM.userSelect; } } static setTransform(el, value) { el.style[DOM.transformProp] = value; } static addEventListener(target, type, callback, options = {}) { if ('passive' in options) { target.addEventListener(type, callback, options); } else { target.addEventListener(type, callback, options.capture); } } static removeEventListener(target, type, callback, options = {}) { if ('passive' in options) { target.removeEventListener(type, callback, options); } else { target.removeEventListener(type, callback, options.capture); } } // Suppress the next click, but only if it's immediate. static suppressClickInternal(e) { e.preventDefault(); e.stopPropagation(); window.removeEventListener('click', DOM.suppressClickInternal, true); } static suppressClick() { window.addEventListener('click', DOM.suppressClickInternal, true); window.setTimeout(() => { window.removeEventListener('click', DOM.suppressClickInternal, true); }, 0); } static getScale(element) { const rect = element.getBoundingClientRect(); return { x: (rect.width / element.offsetWidth) || 1, y: (rect.height / element.offsetHeight) || 1, boundingClientRect: rect, }; } static getPoint(el, scale, e) { const rect = scale.boundingClientRect; return new Point$2( // rect.left/top values are in page scale (like clientX/Y), // whereas clientLeft/Top (border width) values are the original values (before CSS scale applies). ((e.clientX - rect.left) / scale.x) - el.clientLeft, ((e.clientY - rect.top) / scale.y) - el.clientTop); } static mousePos(el, e) { const scale = DOM.getScale(el); return DOM.getPoint(el, scale, e); } static touchPos(el, touches) { const points = []; const scale = DOM.getScale(el); for (let i = 0; i < touches.length; i++) { points.push(DOM.getPoint(el, scale, touches[i])); } return points; } static mouseButton(e) { return e.button; } static remove(node) { if (node.parentNode) { node.parentNode.removeChild(node); } } } DOM.docStyle = typeof window !== 'undefined' && window.document && window.document.documentElement.style; DOM.selectProp = DOM.testProp(['userSelect', 'MozUserSelect', 'WebkitUserSelect', 'msUserSelect']); DOM.transformProp = DOM.testProp(['transform', 'WebkitTransform']); const config = { MAX_PARALLEL_IMAGE_REQUESTS: 16, MAX_PARALLEL_IMAGE_REQUESTS_PER_FRAME: 8, MAX_TILE_CACHE_ZOOM_LEVELS: 5, REGISTERED_PROTOCOLS: {}, WORKER_URL: '' }; function getProtocol(url) { return config.REGISTERED_PROTOCOLS[url.substring(0, url.indexOf('://'))]; } /** * Adds a custom load resource function that will be called when using a URL that starts with a custom url schema. * This will happen in the main thread, and workers might call it if they don't know how to handle the protocol. * The example below will be triggered for custom:// urls defined in the sources list in the style definitions. * The function passed will receive the request parameters and should return with the resulting resource, * for example a pbf vector tile, non-compressed, represented as ArrayBuffer. * * @param customProtocol - the protocol to hook, for example 'custom' * @param loadFn - the function to use when trying to fetch a tile specified by the customProtocol * @example * ```ts * // This will fetch a file using the fetch API (this is obviously a non interesting example...) * addProtocol('custom', async (params, abortController) => { * const t = await fetch(`https://${params.url.split("://")[1]}`); * if (t.status == 200) { * const buffer = await t.arrayBuffer(); * return {data: buffer} * } else { * throw new Error(`Tile fetch error: ${t.statusText}`); * } * }); * // the following is an example of a way to return an error when trying to load a tile * addProtocol('custom2', async (params, abortController) => { * throw new Error('someErrorMessage')); * }); * ``` */ function addProtocol(customProtocol, loadFn) { config.REGISTERED_PROTOCOLS[customProtocol] = loadFn; } /** * Removes a previously added protocol in the main thread. * * @param customProtocol - the custom protocol to remove registration for * @example * ```ts * removeProtocol('custom'); * ``` */ function removeProtocol(customProtocol) { delete config.REGISTERED_PROTOCOLS[customProtocol]; } /** * This is used to identify the global dispatcher id when sending a message from the worker without a target map id. */ const GLOBAL_DISPATCHER_ID = 'global-dispatcher'; /** * An error thrown when a HTTP request results in an error response. */ class AJAXError extends Error { /** * @param status - The response's HTTP status code. * @param statusText - The response's HTTP status text. * @param url - The request's URL. * @param body - The response's body. */ constructor(status, statusText, url, body) { super(`AJAXError: ${statusText} (${status}): ${url}`); this.status = status; this.statusText = statusText; this.url = url; this.body = body; } } /** * Ensure that we're sending the correct referrer from blob URL worker bundles. * For files loaded from the local file system, `location.origin` will be set * to the string(!) "null" (Firefox), or "file://" (Chrome, Safari, Edge), * and we will set an empty referrer. Otherwise, we're using the document's URL. */ const getReferrer = () => isWorker(self) ? self.worker && self.worker.referrer : (window.location.protocol === 'blob:' ? window.parent : window).location.href; /** * Determines whether a URL is a file:// URL. This is obviously the case if it begins * with file://. Relative URLs are also file:// URLs iff the original document was loaded * via a file:// URL. * @param url - The URL to check * @returns `true` if the URL is a file:// URL, `false` otherwise */ const isFileURL = url => /^file:/.test(url) || (/^file:/.test(getReferrer()) && !/^\w+:/.test(url)); function makeFetchRequest(requestParameters, abortController) { return __awaiter(this, void 0, void 0, function* () { const request = new Request(requestParameters.url, { method: requestParameters.method || 'GET', body: requestParameters.body, credentials: requestParameters.credentials, headers: requestParameters.headers, cache: requestParameters.cache, referrer: getReferrer(), signal: abortController.signal }); // If the user has already set an Accept header, do not overwrite it here if (requestParameters.type === 'json' && !request.headers.has('Accept')) { request.headers.set('Accept', 'application/json'); } const response = yield fetch(request); if (!response.ok) { const body = yield response.blob(); throw new AJAXError(response.status, response.statusText, requestParameters.url, body); } let parsePromise; if ((requestParameters.type === 'arrayBuffer' || requestParameters.type === 'image')) { parsePromise = response.arrayBuffer(); } else if (requestParameters.type === 'json') { parsePromise = response.json(); } else { parsePromise = response.text(); } const result = yield parsePromise; if (abortController.signal.aborted) { throw createAbortError(); } return { data: result, cacheControl: response.headers.get('Cache-Control'), expires: response.headers.get('Expires') }; }); } function makeXMLHttpRequest(requestParameters, abortController) { return new Promise((resolve, reject) => { var _a; const xhr = new XMLHttpRequest(); xhr.open(requestParameters.method || 'GET', requestParameters.url, true); if (requestParameters.type === 'arrayBuffer' || requestParameters.type === 'image') { xhr.responseType = 'arraybuffer'; } for (const k in requestParameters.headers) { xhr.setRequestHeader(k, requestParameters.headers[k]); } if (requestParameters.type === 'json') { xhr.responseType = 'text'; // Do not overwrite the user-provided Accept header if (!((_a = requestParameters.headers) === null || _a === void 0 ? void 0 : _a.Accept)) { xhr.setRequestHeader('Accept', 'application/json'); } } xhr.withCredentials = requestParameters.credentials === 'include'; xhr.onerror = () => { reject(new Error(xhr.statusText)); }; xhr.onload = () => { if (abortController.signal.aborted) { return; } if (((xhr.status >= 200 && xhr.status < 300) || xhr.status === 0) && xhr.response !== null) { let data = xhr.response; if (requestParameters.type === 'json') { // We're manually parsing JSON here to get better error messages. try { data = JSON.parse(xhr.response); } catch (err) { reject(err); return; } } resolve({ data, cacheControl: xhr.getResponseHeader('Cache-Control'), expires: xhr.getResponseHeader('Expires') }); } else { const body = new Blob([xhr.response], { type: xhr.getResponseHeader('Content-Type') }); reject(new AJAXError(xhr.status, xhr.statusText, requestParameters.url, body)); } }; abortController.signal.addEventListener('abort', () => { xhr.abort(); reject(createAbortError()); }); xhr.send(requestParameters.body); }); } /** * We're trying to use the Fetch API if possible. However, requests for resources with the file:// URI scheme don't work with the Fetch API. * In this case we unconditionally use XHR on the current thread since referrers don't matter. * This method can also use the registered method if `addProtocol` was called. * @param requestParameters - The request parameters * @param abortController - The abort controller allowing to cancel the request * @returns a promise resolving to the response, including cache control and expiry data */ const makeRequest = function (requestParameters, abortController) { if (/:\/\//.test(requestParameters.url) && !(/^https?:|^file:/.test(requestParameters.url))) { const protocolLoadFn = getProtocol(requestParameters.url); if (protocolLoadFn) { return protocolLoadFn(requestParameters, abortController); } if (isWorker(self) && self.worker && self.worker.actor) { return self.worker.actor.sendAsync({ type: "GR" /* MessageType.getResource */, data: requestParameters, targetMapId: GLOBAL_DISPATCHER_ID }, abortController); } } if (!isFileURL(requestParameters.url)) { if (fetch && Request && AbortController && Object.prototype.hasOwnProperty.call(Request.prototype, 'signal')) { return makeFetchRequest(requestParameters, abortController); } if (isWorker(self) && self.worker && self.worker.actor) { return self.worker.actor.sendAsync({ type: "GR" /* MessageType.getResource */, data: requestParameters, mustQueue: true, targetMapId: GLOBAL_DISPATCHER_ID }, abortController); } } return makeXMLHttpRequest(requestParameters, abortController); }; const getJSON = (requestParameters, abortController) => { return makeRequest(extend(requestParameters, { type: 'json' }), abortController); }; const getArrayBuffer = (requestParameters, abortController) => { return makeRequest(extend(requestParameters, { type: 'arrayBuffer' }), abortController); }; function sameOrigin(inComingUrl) { // A relative URL "/foo" or "./foo" will throw exception in URL's ctor, // try-catch is expansive so just use a heuristic check to avoid it // also check data URL if (!inComingUrl || inComingUrl.indexOf('://') <= 0 || // relative URL inComingUrl.indexOf('data:image/') === 0 || // data image URL inComingUrl.indexOf('blob:') === 0) { // blob return true; } const urlObj = new URL(inComingUrl); const locationObj = window.location; return urlObj.protocol === locationObj.protocol && urlObj.host === locationObj.host; } const getVideo = (urls) => { const video = window.document.createElement('video'); video.muted = true; return new Promise((resolve) => { video.onloadstart = () => { resolve(video); }; for (const url of urls) { const s = window.document.createElement('source'); if (!sameOrigin(url)) { video.crossOrigin = 'Anonymous'; } s.src = url; video.appendChild(s); } }); }; const webpSupported = { supported: false, testSupport }; let glForTesting; let webpCheckComplete = false; let webpImgTest; let webpImgTestOnloadComplete = false; if (typeof document !== 'undefined') { webpImgTest = document.createElement('img'); webpImgTest.onload = () => { if (glForTesting) testWebpTextureUpload(glForTesting); glForTesting = null; webpImgTestOnloadComplete = true; }; webpImgTest.onerror = () => { webpCheckComplete = true; glForTesting = null; }; webpImgTest.src = 'data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAQAAAAfQ//73v/+BiOh/AAA='; } function testSupport(gl) { if (webpCheckComplete || !webpImgTest) return; // HTMLImageElement.complete is set when an image is done loading it's source // regardless of whether the load was successful or not. // It's possible for an error to set HTMLImageElement.complete to true which would trigger // testWebpTextureUpload and mistakenly set exported.supported to true in browsers which don't support webp // To avoid this, we set a flag in the image's onload handler and only call testWebpTextureUpload // after a successful image load event. if (webpImgTestOnloadComplete) { testWebpTextureUpload(gl); } else { glForTesting = gl; } } function testWebpTextureUpload(gl) { // Edge 18 supports WebP but not uploading a WebP image to a gl texture // Test support for this before allowing WebP images. // https://github.com/mapbox/mapbox-gl-js/issues/7671 const texture = gl.createTexture(); gl.bindTexture(gl.TEXTURE_2D, texture); try { gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, webpImgTest); // The error does not get triggered in Edge if the context is lost if (gl.isContextLost()) return; webpSupported.supported = true; } catch (e) { // Catch "Unspecified Error." in Edge 18. } gl.deleteTexture(texture); webpCheckComplete = true; } /** * By default, the image queue is self driven, meaning as soon as one requested item is processed, * it will move on to next one as quickly as it can while limiting * the number of concurrent requests to MAX_PARALLEL_IMAGE_REQUESTS. The default behavior * ensures that static views of the map can be rendered with minimal delay. * * However, the default behavior can prevent dynamic views of the map from rendering * smoothly in that many requests can finish in one render frame, putting too much pressure on GPU. * * When the view of the map is moving dynamically, smoother frame rates can be achieved * by throttling the number of items processed by the queue per frame. This can be * accomplished by using {@link addThrottleControl} to allow the caller to * use a lambda function to determine when the queue should be throttled (e.g. when isMoving()) * and manually calling {@link processQueue} in the render loop. */ var ImageRequest; (function (ImageRequest) { let imageRequestQueue; let currentParallelImageRequests; let throttleControlCallbackHandleCounter; let throttleControlCallbacks; /** * Reset the image request queue, removing all pending requests. */ ImageRequest.resetRequestQueue = () => { imageRequestQueue = []; currentParallelImageRequests = 0; throttleControlCallbackHandleCounter = 0; throttleControlCallbacks = {}; }; /** * Install a callback to control when image queue throttling is desired. * (e.g. when the map view is moving) * @param callback - The callback function to install * @returns handle that identifies the installed callback. */ ImageRequest.addThrottleControl = (callback) => { const handle = throttleControlCallbackHandleCounter++; throttleControlCallbacks[handle] = callback; return handle; }; /** * Remove a previously installed callback by passing in the handle returned * by {@link addThrottleControl}. * @param callbackHandle - The handle for the callback to remove. */ ImageRequest.removeThrottleControl = (callbackHandle) => { delete throttleControlCallbacks[callbackHandle]; // Try updating the queue processQueue(); }; /** * Check to see if any of the installed callbacks are requesting the queue * to be throttled. * @returns `true` if any callback is causing the queue to be throttled. */ const isThrottled = () => { for (const key of Object.keys(throttleControlCallbacks)) { if (throttleControlCallbacks[key]()) { return true; } } return false; }; /** * Request to load an image. * @param requestParameters - Request parameters. * @param abortController - allows to abort the request. * @param supportImageRefresh - `true`, if the image request need to support refresh based on cache headers. * @returns - A promise resolved when the image is loaded. */ ImageRequest.getImage = (requestParameters, abortController, supportImageRefresh = true) => { return new Promise((resolve, reject) => { if (webpSupported.supported) { if (!requestParameters.headers) { requestParameters.headers = {}; } requestParameters.headers.accept = 'image/webp,*/*'; } extend(requestParameters, { type: 'image' }); const request = { abortController, requestParameters, supportImageRefresh, state: 'queued', onError: (error) => { reject(error); }, onSuccess: (response) => { resolve(response); } }; imageRequestQueue.push(request); processQueue(); }); }; const arrayBufferToCanvasImageSource = (data) => { const imageBitmapSupported = typeof createImageBitmap === 'function'; if (imageBitmapSupported) { return arrayBufferToImageBitmap(data); } else { return arrayBufferToImage(data); } }; const doImageRequest = (itemInQueue) => __awaiter(this, void 0, void 0, function* () { itemInQueue.state = 'running'; const { requestParameters, supportImageRefresh, onError, onSuccess, abortController } = itemInQueue; // - If refreshExpiredTiles is false, then we can use HTMLImageElement to download raster images. // - Fetch/XHR (via MakeRequest API) will be used to download images for following scenarios: // 1. Style image sprite will had a issue with HTMLImageElement as described // here: https://github.com/mapbox/mapbox-gl-js/issues/1470 // 2. If refreshExpiredTiles is true (default), then in order to read the image cache header, // fetch/XHR request will be required // - For any special case handling like use of AddProtocol, worker initiated request or additional headers // let makeRequest handle it. // - HtmlImageElement request automatically adds accept header for all the browser supported images const canUseHTMLImageElement = supportImageRefresh === false && !isWorker(self) && !getProtocol(requestParameters.url) && (!requestParameters.headers || Object.keys(requestParameters.headers).reduce((acc, item) => acc && item === 'accept', true)); currentParallelImageRequests++; const getImagePromise = canUseHTMLImageElement ? getImageUsingHtmlImage(requestParameters, abortController) : makeRequest(requestParameters, abortController); try { const response = yield getImagePromise; delete itemInQueue.abortController; itemInQueue.state = 'completed'; if (response.data instanceof HTMLImageElement || isImageBitmap(response.data)) { // User using addProtocol can directly return HTMLImageElement/ImageBitmap type // If HtmlImageElement is used to get image then response type will be HTMLImageElement onSuccess(response); } else if (response.data) { const img = yield arrayBufferToCanvasImageSource(response.data); onSuccess({ data: img, cacheControl: response.cacheControl, expires: response.expires }); } } catch (err) { delete itemInQueue.abortController; onError(err); } finally { currentParallelImageRequests--; processQueue(); } }); /** * Process some number of items in the image request queue. */ const processQueue = () => { const maxImageRequests = isThrottled() ? config.MAX_PARALLEL_IMAGE_REQUESTS_PER_FRAME : config.MAX_PARALLEL_IMAGE_REQUESTS; // limit concurrent image loads to help with raster sources performance on big screens for (let numImageRequests = currentParallelImageRequests; numImageRequests < maxImageRequests && imageRequestQueue.length > 0; numImageRequests++) { const topItemInQueue = imageRequestQueue.shift(); if (topItemInQueue.abortController.signal.aborted) { numImageRequests--; continue; } doImageRequest(topItemInQueue); } }; const getImageUsingHtmlImage = (requestParameters, abortController) => { return new Promise((resolve, reject) => { const image = new Image(); const url = requestParameters.url; const credentials = requestParameters.credentials; if (credentials && credentials === 'include') { image.crossOrigin = 'use-credentials'; } else if ((credentials && credentials === 'same-origin') || !sameOrigin(url)) { image.crossOrigin = 'anonymous'; } abortController.signal.addEventListener('abort', () => { // Set src to '' to actually cancel the request image.src = ''; reject(createAbortError()); }); image.fetchPriority = 'high'; image.onload = () => { image.onerror = image.onload = null; resolve({ data: image }); }; image.onerror = () => { image.onerror = image.onload = null; if (abortController.signal.aborted) { return; } reject(new Error('Could not load image. Please make sure to use a supported image type such as PNG or JPEG. Note that SVGs are not supported.')); }; image.src = url; }); }; })(ImageRequest || (ImageRequest = {})); ImageRequest.resetRequestQueue(); class RequestManager { constructor(transformRequestFn) { this._transformRequestFn = transformRequestFn; } transformRequest(url, type) { if (this._transformRequestFn) { return this._transformRequestFn(url, type) || { url }; } return { url }; } setTransformRequest(transformRequest) { this._transformRequestFn = transformRequest; } } function _addEventListener(type, listener, listenerList) { const listenerExists = listenerList[type] && listenerList[type].indexOf(listener) !== -1; if (!listenerExists) { listenerList[type] = listenerList[type] || []; listenerList[type].push(listener); } } function _removeEventListener(type, listener, listenerList) { if (listenerList && listenerList[type]) { const index = listenerList[type].indexOf(listener); if (index !== -1) { listenerList[type].splice(index, 1); } } } /** * The event class */ class Event { constructor(type, data = {}) { extend(this, data); this.type = type; } } /** * An error event */ class ErrorEvent extends Event { constructor(error, data = {}) { super('error', extend({ error }, data)); } } /** * Methods mixed in to other classes for event capabilities. * * @group Event Related */ class Evented { /** * Adds a listener to a specified event type. * * @param type - The event type to add a listen for. * @param listener - The function to be called when the event is fired. * The listener function is called with the data object passed to `fire`, * extended with `target` and `type` properties. */ on(type, listener) { this._listeners = this._listeners || {}; _addEventListener(type, listener, this._listeners); return this; } /** * Removes a previously registered event listener. * * @param type - The event type to remove listeners for. * @param listener - The listener function to remove. */ off(type, listener) { _removeEventListener(type, listener, this._listeners); _removeEventListener(type, listener, this._oneTimeListeners); return this; } /** * Adds a listener that will be called only once to a specified event type. * * The listener will be called first time the event fires after the listener is registered. * * @param type - The event type to listen for. * @param listener - The function to be called when the event is fired the first time. * @returns `this` or a promise if a listener is not provided */ once(type, listener) { if (!listener) { return new Promise((resolve) => this.once(type, resolve)); } this._oneTimeListeners = this._oneTimeListeners || {}; _addEventListener(type, listener, this._oneTimeListeners); return this; } fire(event, properties) { // Compatibility with (type: string, properties: Object) signature from previous versions. // See https://github.com/mapbox/mapbox-gl-js/issues/6522, // https://github.com/mapbox/mapbox-gl-draw/issues/766 if (typeof event === 'string') { event = new Event(event, properties || {}); } const type = event.type; if (this.listens(type)) { event.target = this; // make sure adding or removing listeners inside other listeners won't cause an infinite loop const listeners = this._listeners && this._listeners[type] ? this._listeners[type].slice() : []; for (const listener of listeners) { listener.call(this, event); } const oneTimeListeners = this._oneTimeListeners && this._oneTimeListeners[type] ? this._oneTimeListeners[type].slice() : []; for (const listener of oneTimeListeners) { _removeEventListener(type, listener, this._oneTimeListeners); listener.call(this, event); } const parent = this._eventedParent; if (parent) { extend(event, typeof this._eventedParentData === 'function' ? this._eventedParentData() : this._eventedParentData); parent.fire(event); } // To ensure that no error events are dropped, print them to the // console if they have no listeners. } else if (event instanceof ErrorEvent) { console.error(event.error); } return this; } /** * Returns a true if this instance of Evented or any forwardeed instances of Evented have a listener for the specified type. * * @param type - The event type * @returns `true` if there is at least one registered listener for specified event type, `false` otherwise */ listens(type) { return ((this._listeners && this._listeners[type] && this._listeners[type].length > 0) || (this._oneTimeListeners && this._oneTimeListeners[type] && this._oneTimeListeners[type].length > 0) || (this._eventedParent && this._eventedParent.listens(type))); } /** * Bubble all events fired by this instance of Evented to this parent instance of Evented. */ setEventedParent(parent, data) { this._eventedParent = parent; this._eventedParentData = data; return this; } } var $version = 8; var $root = { version: { required: true, type: "enum", values: [ 8 ] }, name: { type: "string" }, metadata: { type: "*" }, center: { type: "array", value: "number" }, zoom: { type: "number" }, bearing: { type: "number", "default": 0, period: 360, units: "degrees" }, pitch: { type: "number", "default": 0, units: "degrees" }, light: { type: "light" }, sky: { type: "sky" }, projection: { type: "projection" }, terrain: { type: "terrain" }, sources: { required: true, type: "sources" }, sprite: { type: "sprite" }, glyphs: { type: "string" }, transition: { type: "transition" }, layers: { required: true, type: "array", value: "layer" } }; var sources = { "*": { type: "source" } }; var source = [ "source_vector", "source_raster", "source_raster_dem", "source_geojson", "source_video", "source_image" ]; var source_vector = { type: { required: true, type: "enum", values: { vector: { } } }, url: { type: "string" }, tiles: { type: "array", value: "string" }, bounds: { type: "array", value: "number", length: 4, "default": [ -180, -85.051129, 180, 85.051129 ] }, scheme: { type: "enum", values: { xyz: { }, tms: { } }, "default": "xyz" }, minzoom: { type: "number", "default": 0 }, maxzoom: { type: "number", "default": 22 }, attribution: { type: "string" }, promoteId: { type: "promoteId" }, volatile: { type: "boolean", "default": false }, "*": { type: "*" } }; var source_raster = { type: { required: true, type: "enum", values: { raster: { } } }, url: { type: "string" }, tiles: { type: "array", value: "string" }, bounds: { type: "array", value: "number", length: 4, "default": [ -180, -85.051129, 180, 85.051129 ] }, minzoom: { type: "number", "default": 0 }, maxzoom: { type: "number", "default": 22 }, tileSize: { type: "number", "default": 512, units: "pixels" }, scheme: { type: "enum", values: { xyz: { }, tms: { } }, "default": "xyz" }, attribution: { type: "string" }, volatile: { type: "boolean", "default": false }, "*": { type: "*" } }; var source_raster_dem = { type: { required: true, type: "enum", values: { "raster-dem": { } } }, url: { type: "string" }, tiles: { type: "array", value: "string" }, bounds: { type: "array", value: "number", length: 4, "default": [ -180, -85.051129, 180, 85.051129 ] }, minzoom: { type: "number", "default": 0 }, maxzoom: { type: "number", "default": 22 }, tileSize: { type: "number", "default": 512, units: "pixels" }, attribution: { type: "string" }, encoding: { type: "enum", values: { terrarium: { }, mapbox: { }, custom: { } }, "default": "mapbox" }, redFactor: { type: "number", "default": 1 }, blueFactor: { type: "number", "default": 1 }, greenFactor: { type: "number", "default": 1 }, baseShift: { type: "number", "default": 0 }, volatile: { type: "boolean", "default": false }, "*": { type: "*" } }; var source_geojson = { type: { required: true, type: "enum", values: { geojson: { } } }, data: { required: true, type: "*" }, maxzoom: { type: "number", "default": 18 }, attribution: { type: "string" }, buffer: { type: "number", "default": 128, maximum: 512, minimum: 0 }, filter: { type: "*" }, tolerance: { type: "number", "default": 0.375 }, cluster: { type: "boolean", "default": false }, clusterRadius: { type: "number", "default": 50, minimum: 0 }, clusterMaxZoom: { type: "number" }, clusterMinPoints: { type: "number" }, clusterProperties: { type: "*" }, lineMetrics: { type: "boolean", "default": false }, generateId: { type: "boolean", "default": false }, promoteId: { type: "promoteId" } }; var source_video = { type: { required: true, type: "enum", values: { video: { } } }, urls: { required: true, type: "array", value: "string" }, coordinates: { required: true, type: "array", length: 4, value: { type: "array", length: 2, value: "number" } } }; var source_image = { type: { required: true, type: "enum", values: { image: { } } }, url: { required: true, type: "string" }, coordinates: { required: true, type: "array", length: 4, value: { type: "array", length: 2, value: "number" } } }; var layer = { id: { type: "string", required: true }, type: { type: "enum", values: { fill: { }, line: { }, symbol: { }, circle: { }, heatmap: { }, "fill-extrusion": { }, raster: { }, hillshade: { }, background: { } }, required: true }, metadata: { type: "*" }, source: { type: "string" }, "source-layer": { type: "string" }, minzoom: { type: "number", minimum: 0, maximum: 24 }, maxzoom: { type: "number", minimum: 0, maximum: 24 }, filter: { type: "filter" }, layout: { type: "layout" }, paint: { type: "paint" } }; var layout$7 = [ "layout_fill", "layout_line", "layout_circle", "layout_heatmap", "layout_fill-extrusion", "layout_symbol", "layout_raster", "layout_hillshade", "layout_background" ]; var layout_background = { visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_fill = { "fill-sort-key": { type: "number", expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_circle = { "circle-sort-key": { type: "number", expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_heatmap = { visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_line = { "line-cap": { type: "enum", values: { butt: { }, round: { }, square: { } }, "default": "butt", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "line-join": { type: "enum", values: { bevel: { }, round: { }, miter: { } }, "default": "miter", expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "line-miter-limit": { type: "number", "default": 2, requires: [ { "line-join": "miter" } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "line-round-limit": { type: "number", "default": 1.05, requires: [ { "line-join": "round" } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "line-sort-key": { type: "number", expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_symbol = { "symbol-placement": { type: "enum", values: { point: { }, line: { }, "line-center": { } }, "default": "point", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "symbol-spacing": { type: "number", "default": 250, minimum: 1, units: "pixels", requires: [ { "symbol-placement": "line" } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "symbol-avoid-edges": { type: "boolean", "default": false, expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "symbol-sort-key": { type: "number", expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "symbol-z-order": { type: "enum", values: { auto: { }, "viewport-y": { }, source: { } }, "default": "auto", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-allow-overlap": { type: "boolean", "default": false, requires: [ "icon-image", { "!": "icon-overlap" } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-overlap": { type: "enum", values: { never: { }, always: { }, cooperative: { } }, requires: [ "icon-image" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-ignore-placement": { type: "boolean", "default": false, requires: [ "icon-image" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-optional": { type: "boolean", "default": false, requires: [ "icon-image", "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-rotation-alignment": { type: "enum", values: { map: { }, viewport: { }, auto: { } }, "default": "auto", requires: [ "icon-image" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-size": { type: "number", "default": 1, minimum: 0, units: "factor of the original icon size", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-text-fit": { type: "enum", values: { none: { }, width: { }, height: { }, both: { } }, "default": "none", requires: [ "icon-image", "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-text-fit-padding": { type: "array", value: "number", length: 4, "default": [ 0, 0, 0, 0 ], units: "pixels", requires: [ "icon-image", "text-field", { "icon-text-fit": [ "both", "width", "height" ] } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-image": { type: "resolvedImage", tokens: true, expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-rotate": { type: "number", "default": 0, period: 360, units: "degrees", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-padding": { type: "padding", "default": [ 2 ], units: "pixels", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-keep-upright": { type: "boolean", "default": false, requires: [ "icon-image", { "icon-rotation-alignment": "map" }, { "symbol-placement": [ "line", "line-center" ] } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-offset": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-anchor": { type: "enum", values: { center: { }, left: { }, right: { }, top: { }, bottom: { }, "top-left": { }, "top-right": { }, "bottom-left": { }, "bottom-right": { } }, "default": "center", requires: [ "icon-image" ], expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "icon-pitch-alignment": { type: "enum", values: { map: { }, viewport: { }, auto: { } }, "default": "auto", requires: [ "icon-image" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-pitch-alignment": { type: "enum", values: { map: { }, viewport: { }, auto: { } }, "default": "auto", requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-rotation-alignment": { type: "enum", values: { map: { }, viewport: { }, "viewport-glyph": { }, auto: { } }, "default": "auto", requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-field": { type: "formatted", "default": "", tokens: true, expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-font": { type: "array", value: "string", "default": [ "Open Sans Regular", "Arial Unicode MS Regular" ], requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-size": { type: "number", "default": 16, minimum: 0, units: "pixels", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-max-width": { type: "number", "default": 10, minimum: 0, units: "ems", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-line-height": { type: "number", "default": 1.2, units: "ems", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-letter-spacing": { type: "number", "default": 0, units: "ems", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-justify": { type: "enum", values: { auto: { }, left: { }, center: { }, right: { } }, "default": "center", requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-radial-offset": { type: "number", units: "ems", "default": 0, requires: [ "text-field" ], "property-type": "data-driven", expression: { interpolated: true, parameters: [ "zoom", "feature" ] } }, "text-variable-anchor": { type: "array", value: "enum", values: { center: { }, left: { }, right: { }, top: { }, bottom: { }, "top-left": { }, "top-right": { }, "bottom-left": { }, "bottom-right": { } }, requires: [ "text-field", { "symbol-placement": [ "point" ] } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-variable-anchor-offset": { type: "variableAnchorOffsetCollection", requires: [ "text-field", { "symbol-placement": [ "point" ] } ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-anchor": { type: "enum", values: { center: { }, left: { }, right: { }, top: { }, bottom: { }, "top-left": { }, "top-right": { }, "bottom-left": { }, "bottom-right": { } }, "default": "center", requires: [ "text-field", { "!": "text-variable-anchor" } ], expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-max-angle": { type: "number", "default": 45, units: "degrees", requires: [ "text-field", { "symbol-placement": [ "line", "line-center" ] } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-writing-mode": { type: "array", value: "enum", values: { horizontal: { }, vertical: { } }, requires: [ "text-field", { "symbol-placement": [ "point" ] } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-rotate": { type: "number", "default": 0, period: 360, units: "degrees", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-padding": { type: "number", "default": 2, minimum: 0, units: "pixels", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-keep-upright": { type: "boolean", "default": true, requires: [ "text-field", { "text-rotation-alignment": "map" }, { "symbol-placement": [ "line", "line-center" ] } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-transform": { type: "enum", values: { none: { }, uppercase: { }, lowercase: { } }, "default": "none", requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-offset": { type: "array", value: "number", units: "ems", length: 2, "default": [ 0, 0 ], requires: [ "text-field", { "!": "text-radial-offset" } ], expression: { interpolated: true, parameters: [ "zoom", "feature" ] }, "property-type": "data-driven" }, "text-allow-overlap": { type: "boolean", "default": false, requires: [ "text-field", { "!": "text-overlap" } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-overlap": { type: "enum", values: { never: { }, always: { }, cooperative: { } }, requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-ignore-placement": { type: "boolean", "default": false, requires: [ "text-field" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-optional": { type: "boolean", "default": false, requires: [ "text-field", "icon-image" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_raster = { visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var layout_hillshade = { visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }; var filter = { type: "array", value: "*" }; var filter_operator = { type: "enum", values: { "==": { }, "!=": { }, ">": { }, ">=": { }, "<": { }, "<=": { }, "in": { }, "!in": { }, all: { }, any: { }, none: { }, has: { }, "!has": { } } }; var geometry_type = { type: "enum", values: { Point: { }, LineString: { }, Polygon: { } } }; var function_stop = { type: "array", minimum: 0, maximum: 24, value: [ "number", "color" ], length: 2 }; var expression$1 = { type: "array", value: "*", minimum: 1 }; var light = { anchor: { type: "enum", "default": "viewport", values: { map: { }, viewport: { } }, "property-type": "data-constant", transition: false, expression: { interpolated: false, parameters: [ "zoom" ] } }, position: { type: "array", "default": [ 1.15, 210, 30 ], length: 3, value: "number", "property-type": "data-constant", transition: true, expression: { interpolated: true, parameters: [ "zoom" ] } }, color: { type: "color", "property-type": "data-constant", "default": "#ffffff", expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, intensity: { type: "number", "property-type": "data-constant", "default": 0.5, minimum: 0, maximum: 1, expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true } }; var sky = { "sky-color": { type: "color", "property-type": "data-constant", "default": "#88C6FC", expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "horizon-color": { type: "color", "property-type": "data-constant", "default": "#ffffff", expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "fog-color": { type: "color", "property-type": "data-constant", "default": "#ffffff", expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "fog-ground-blend": { type: "number", "property-type": "data-constant", "default": 0.5, minimum: 0, maximum: 1, expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "horizon-fog-blend": { type: "number", "property-type": "data-constant", "default": 0.8, minimum: 0, maximum: 1, expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "sky-horizon-blend": { type: "number", "property-type": "data-constant", "default": 0.8, minimum: 0, maximum: 1, expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true }, "atmosphere-blend": { type: "number", "property-type": "data-constant", "default": 0.8, minimum: 0, maximum: 1, expression: { interpolated: true, parameters: [ "zoom" ] }, transition: true } }; var terrain = { source: { type: "string", required: true }, exaggeration: { type: "number", minimum: 0, "default": 1 } }; var projection$1 = { type: { type: "enum", "default": "mercator", values: { mercator: { }, globe: { } } } }; var paint$9 = [ "paint_fill", "paint_line", "paint_circle", "paint_heatmap", "paint_fill-extrusion", "paint_symbol", "paint_raster", "paint_hillshade", "paint_background" ]; var paint_fill = { "fill-antialias": { type: "boolean", "default": true, expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-color": { type: "color", "default": "#000000", transition: true, requires: [ { "!": "fill-pattern" } ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-outline-color": { type: "color", transition: true, requires: [ { "!": "fill-pattern" }, { "fill-antialias": true } ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "fill-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-pattern": { type: "resolvedImage", transition: true, expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "cross-faded-data-driven" } }; var paint_line = { "line-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-color": { type: "color", "default": "#000000", transition: true, requires: [ { "!": "line-pattern" } ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "line-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "line-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "line-width": { type: "number", "default": 1, minimum: 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-gap-width": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-offset": { type: "number", "default": 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-blur": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "line-dasharray": { type: "array", value: "number", minimum: 0, transition: true, units: "line widths", requires: [ { "!": "line-pattern" } ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "cross-faded" }, "line-pattern": { type: "resolvedImage", transition: true, expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "cross-faded-data-driven" }, "line-gradient": { type: "color", transition: false, requires: [ { "!": "line-dasharray" }, { "!": "line-pattern" }, { source: "geojson", has: { lineMetrics: true } } ], expression: { interpolated: true, parameters: [ "line-progress" ] }, "property-type": "color-ramp" } }; var paint_circle = { "circle-radius": { type: "number", "default": 5, minimum: 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-color": { type: "color", "default": "#000000", transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-blur": { type: "number", "default": 0, transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "circle-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "circle-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "circle-pitch-scale": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "circle-pitch-alignment": { type: "enum", values: { map: { }, viewport: { } }, "default": "viewport", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "circle-stroke-width": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-stroke-color": { type: "color", "default": "#000000", transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "circle-stroke-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" } }; var paint_heatmap = { "heatmap-radius": { type: "number", "default": 30, minimum: 1, transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "heatmap-weight": { type: "number", "default": 1, minimum: 0, transition: false, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "heatmap-intensity": { type: "number", "default": 1, minimum: 0, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "heatmap-color": { type: "color", "default": [ "interpolate", [ "linear" ], [ "heatmap-density" ], 0, "rgba(0, 0, 255, 0)", 0.1, "royalblue", 0.3, "cyan", 0.5, "lime", 0.7, "yellow", 1, "red" ], transition: false, expression: { interpolated: true, parameters: [ "heatmap-density" ] }, "property-type": "color-ramp" }, "heatmap-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" } }; var paint_symbol = { "icon-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "icon-color": { type: "color", "default": "#000000", transition: true, requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "icon-halo-color": { type: "color", "default": "rgba(0, 0, 0, 0)", transition: true, requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "icon-halo-width": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "icon-halo-blur": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "icon-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", requires: [ "icon-image" ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "icon-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "icon-image", "icon-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "text-color": { type: "color", "default": "#000000", transition: true, overridable: true, requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "text-halo-color": { type: "color", "default": "rgba(0, 0, 0, 0)", transition: true, requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "text-halo-width": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "text-halo-blur": { type: "number", "default": 0, minimum: 0, transition: true, units: "pixels", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "text-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", requires: [ "text-field" ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "text-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "text-field", "text-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" } }; var paint_raster = { "raster-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-hue-rotate": { type: "number", "default": 0, period: 360, transition: true, units: "degrees", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-brightness-min": { type: "number", "default": 0, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-brightness-max": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-saturation": { type: "number", "default": 0, minimum: -1, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-contrast": { type: "number", "default": 0, minimum: -1, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-resampling": { type: "enum", values: { linear: { }, nearest: { } }, "default": "linear", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "raster-fade-duration": { type: "number", "default": 300, minimum: 0, transition: false, units: "milliseconds", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" } }; var paint_hillshade = { "hillshade-illumination-direction": { type: "number", "default": 335, minimum: 0, maximum: 359, transition: false, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "hillshade-illumination-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "viewport", expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "hillshade-exaggeration": { type: "number", "default": 0.5, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "hillshade-shadow-color": { type: "color", "default": "#000000", transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "hillshade-highlight-color": { type: "color", "default": "#FFFFFF", transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "hillshade-accent-color": { type: "color", "default": "#000000", transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" } }; var paint_background = { "background-color": { type: "color", "default": "#000000", transition: true, requires: [ { "!": "background-pattern" } ], expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "background-pattern": { type: "resolvedImage", transition: true, expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "cross-faded" }, "background-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" } }; var transition = { duration: { type: "number", "default": 300, minimum: 0, units: "milliseconds" }, delay: { type: "number", "default": 0, minimum: 0, units: "milliseconds" } }; var promoteId = { "*": { type: "string" } }; var v8Spec = { $version: $version, $root: $root, sources: sources, source: source, source_vector: source_vector, source_raster: source_raster, source_raster_dem: source_raster_dem, source_geojson: source_geojson, source_video: source_video, source_image: source_image, layer: layer, layout: layout$7, layout_background: layout_background, layout_fill: layout_fill, layout_circle: layout_circle, layout_heatmap: layout_heatmap, "layout_fill-extrusion": { visibility: { type: "enum", values: { visible: { }, none: { } }, "default": "visible", "property-type": "constant" } }, layout_line: layout_line, layout_symbol: layout_symbol, layout_raster: layout_raster, layout_hillshade: layout_hillshade, filter: filter, filter_operator: filter_operator, geometry_type: geometry_type, "function": { expression: { type: "expression" }, stops: { type: "array", value: "function_stop" }, base: { type: "number", "default": 1, minimum: 0 }, property: { type: "string", "default": "$zoom" }, type: { type: "enum", values: { identity: { }, exponential: { }, interval: { }, categorical: { } }, "default": "exponential" }, colorSpace: { type: "enum", values: { rgb: { }, lab: { }, hcl: { } }, "default": "rgb" }, "default": { type: "*", required: false } }, function_stop: function_stop, expression: expression$1, light: light, sky: sky, terrain: terrain, projection: projection$1, paint: paint$9, paint_fill: paint_fill, "paint_fill-extrusion": { "fill-extrusion-opacity": { type: "number", "default": 1, minimum: 0, maximum: 1, transition: true, expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-extrusion-color": { type: "color", "default": "#000000", transition: true, requires: [ { "!": "fill-extrusion-pattern" } ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-extrusion-translate": { type: "array", value: "number", length: 2, "default": [ 0, 0 ], transition: true, units: "pixels", expression: { interpolated: true, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-extrusion-translate-anchor": { type: "enum", values: { map: { }, viewport: { } }, "default": "map", requires: [ "fill-extrusion-translate" ], expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" }, "fill-extrusion-pattern": { type: "resolvedImage", transition: true, expression: { interpolated: false, parameters: [ "zoom", "feature" ] }, "property-type": "cross-faded-data-driven" }, "fill-extrusion-height": { type: "number", "default": 0, minimum: 0, units: "meters", transition: true, expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-extrusion-base": { type: "number", "default": 0, minimum: 0, units: "meters", transition: true, requires: [ "fill-extrusion-height" ], expression: { interpolated: true, parameters: [ "zoom", "feature", "feature-state" ] }, "property-type": "data-driven" }, "fill-extrusion-vertical-gradient": { type: "boolean", "default": true, transition: false, expression: { interpolated: false, parameters: [ "zoom" ] }, "property-type": "data-constant" } }, paint_line: paint_line, paint_circle: paint_circle, paint_heatmap: paint_heatmap, paint_symbol: paint_symbol, paint_raster: paint_raster, paint_hillshade: paint_hillshade, paint_background: paint_background, transition: transition, "property-type": { "data-driven": { type: "property-type" }, "cross-faded": { type: "property-type" }, "cross-faded-data-driven": { type: "property-type" }, "color-ramp": { type: "property-type" }, "data-constant": { type: "property-type" }, constant: { type: "property-type" } }, promoteId: promoteId }; const refProperties = ['type', 'source', 'source-layer', 'minzoom', 'maxzoom', 'filter', 'layout']; function deref(layer, parent) { const result = {}; for (const k in layer) { if (k !== 'ref') { result[k] = layer[k]; } } refProperties.forEach((k) => { if (k in parent) { result[k] = parent[k]; } }); return result; } /** * Given an array of layers, some of which may contain `ref` properties * whose value is the `id` of another property, return a new array where * such layers have been augmented with the 'type', 'source', etc. properties * from the parent layer, and the `ref` property has been removed. * * The input is not modified. The output may contain references to portions * of the input. * * @private * @param {Array} layers * @returns {Array} */ function derefLayers(layers) { layers = layers.slice(); const map = Object.create(null); for (let i = 0; i < layers.length; i++) { map[layers[i].id] = layers[i]; } for (let i = 0; i < layers.length; i++) { if ('ref' in layers[i]) { layers[i] = deref(layers[i], map[layers[i].ref]); } } return layers; } /** * Deeply compares two object literals. * * @private */ function deepEqual(a, b) { if (Array.isArray(a)) { if (!Array.isArray(b) || a.length !== b.length) return false; for (let i = 0; i < a.length; i++) { if (!deepEqual(a[i], b[i])) return false; } return true; } if (typeof a === 'object' && a !== null && b !== null) { if (!(typeof b === 'object')) return false; const keys = Object.keys(a); if (keys.length !== Object.keys(b).length) return false; for (const key in a) { if (!deepEqual(a[key], b[key])) return false; } return true; } return a === b; } /** * The main reason for this method is to allow type check when adding a command to the array. * @param commands - The commands array to add to * @param command - The command to add */ function addCommand(commands, command) { commands.push(command); } function addSource(sourceId, after, commands) { addCommand(commands, { command: 'addSource', args: [sourceId, after[sourceId]] }); } function removeSource(sourceId, commands, sourcesRemoved) { addCommand(commands, { command: 'removeSource', args: [sourceId] }); sourcesRemoved[sourceId] = true; } function updateSource(sourceId, after, commands, sourcesRemoved) { removeSource(sourceId, commands, sourcesRemoved); addSource(sourceId, after, commands); } function canUpdateGeoJSON(before, after, sourceId) { let prop; for (prop in before[sourceId]) { if (!Object.prototype.hasOwnProperty.call(before[sourceId], prop)) continue; if (prop !== 'data' && !deepEqual(before[sourceId][prop], after[sourceId][prop])) { return false; } } for (prop in after[sourceId]) { if (!Object.prototype.hasOwnProperty.call(after[sourceId], prop)) continue; if (prop !== 'data' && !deepEqual(before[sourceId][prop], after[sourceId][prop])) { return false; } } return true; } function diffSources(before, after, commands, sourcesRemoved) { before = before || {}; after = after || {}; let sourceId; // look for sources to remove for (sourceId in before) { if (!Object.prototype.hasOwnProperty.call(before, sourceId)) continue; if (!Object.prototype.hasOwnProperty.call(after, sourceId)) { removeSource(sourceId, commands, sourcesRemoved); } } // look for sources to add/update for (sourceId in after) { if (!Object.prototype.hasOwnProperty.call(after, sourceId)) continue; if (!Object.prototype.hasOwnProperty.call(before, sourceId)) { addSource(sourceId, after, commands); } else if (!deepEqual(before[sourceId], after[sourceId])) { if (before[sourceId].type === 'geojson' && after[sourceId].type === 'geojson' && canUpdateGeoJSON(before, after, sourceId)) { addCommand(commands, { command: 'setGeoJSONSourceData', args: [sourceId, after[sourceId].data] }); } else { // no update command, must remove then add updateSource(sourceId, after, commands, sourcesRemoved); } } } } function diffLayerPropertyChanges(before, after, commands, layerId, klass, command) { before = before || {}; after = after || {}; for (const prop in before) { if (!Object.prototype.hasOwnProperty.call(before, prop)) continue; if (!deepEqual(before[prop], after[prop])) { commands.push({ command, args: [layerId, prop, after[prop], klass] }); } } for (const prop in after) { if (!Object.prototype.hasOwnProperty.call(after, prop) || Object.prototype.hasOwnProperty.call(before, prop)) continue; if (!deepEqual(before[prop], after[prop])) { commands.push({ command, args: [layerId, prop, after[prop], klass] }); } } } function pluckId(layer) { return layer.id; } function indexById(group, layer) { group[layer.id] = layer; return group; } function diffLayers(before, after, commands) { before = before || []; after = after || []; // order of layers by id const beforeOrder = before.map(pluckId); const afterOrder = after.map(pluckId); // index of layer by id const beforeIndex = before.reduce(indexById, {}); const afterIndex = after.reduce(indexById, {}); // track order of layers as if they have been mutated const tracker = beforeOrder.slice(); // layers that have been added do not need to be diffed const clean = Object.create(null); let layerId; let beforeLayer; let afterLayer; let insertBeforeLayerId; let prop; // remove layers for (let i = 0, d = 0; i < beforeOrder.length; i++) { layerId = beforeOrder[i]; if (!Object.prototype.hasOwnProperty.call(afterIndex, layerId)) { addCommand(commands, { command: 'removeLayer', args: [layerId] }); tracker.splice(tracker.indexOf(layerId, d), 1); } else { // limit where in tracker we need to look for a match d++; } } // add/reorder layers for (let i = 0, d = 0; i < afterOrder.length; i++) { // work backwards as insert is before an existing layer layerId = afterOrder[afterOrder.length - 1 - i]; if (tracker[tracker.length - 1 - i] === layerId) continue; if (Object.prototype.hasOwnProperty.call(beforeIndex, layerId)) { // remove the layer before we insert at the correct position addCommand(commands, { command: 'removeLayer', args: [layerId] }); tracker.splice(tracker.lastIndexOf(layerId, tracker.length - d), 1); } else { // limit where in tracker we need to look for a match d++; } // add layer at correct position insertBeforeLayerId = tracker[tracker.length - i]; addCommand(commands, { command: 'addLayer', args: [afterIndex[layerId], insertBeforeLayerId] }); tracker.splice(tracker.length - i, 0, layerId); clean[layerId] = true; } // update layers for (let i = 0; i < afterOrder.length; i++) { layerId = afterOrder[i]; beforeLayer = beforeIndex[layerId]; afterLayer = afterIndex[layerId]; // no need to update if previously added (new or moved) if (clean[layerId] || deepEqual(beforeLayer, afterLayer)) continue; // If source, source-layer, or type have changes, then remove the layer // and add it back 'from scratch'. if (!deepEqual(beforeLayer.source, afterLayer.source) || !deepEqual(beforeLayer['source-layer'], afterLayer['source-layer']) || !deepEqual(beforeLayer.type, afterLayer.type)) { addCommand(commands, { command: 'removeLayer', args: [layerId] }); // we add the layer back at the same position it was already in, so // there's no need to update the `tracker` insertBeforeLayerId = tracker[tracker.lastIndexOf(layerId) + 1]; addCommand(commands, { command: 'addLayer', args: [afterLayer, insertBeforeLayerId] }); continue; } // layout, paint, filter, minzoom, maxzoom diffLayerPropertyChanges(beforeLayer.layout, afterLayer.layout, commands, layerId, null, 'setLayoutProperty'); diffLayerPropertyChanges(beforeLayer.paint, afterLayer.paint, commands, layerId, null, 'setPaintProperty'); if (!deepEqual(beforeLayer.filter, afterLayer.filter)) { addCommand(commands, { command: 'setFilter', args: [layerId, afterLayer.filter] }); } if (!deepEqual(beforeLayer.minzoom, afterLayer.minzoom) || !deepEqual(beforeLayer.maxzoom, afterLayer.maxzoom)) { addCommand(commands, { command: 'setLayerZoomRange', args: [layerId, afterLayer.minzoom, afterLayer.maxzoom] }); } // handle all other layer props, including paint.* for (prop in beforeLayer) { if (!Object.prototype.hasOwnProperty.call(beforeLayer, prop)) continue; if (prop === 'layout' || prop === 'paint' || prop === 'filter' || prop === 'metadata' || prop === 'minzoom' || prop === 'maxzoom') continue; if (prop.indexOf('paint.') === 0) { diffLayerPropertyChanges(beforeLayer[prop], afterLayer[prop], commands, layerId, prop.slice(6), 'setPaintProperty'); } else if (!deepEqual(beforeLayer[prop], afterLayer[prop])) { addCommand(commands, { command: 'setLayerProperty', args: [layerId, prop, afterLayer[prop]] }); } } for (prop in afterLayer) { if (!Object.prototype.hasOwnProperty.call(afterLayer, prop) || Object.prototype.hasOwnProperty.call(beforeLayer, prop)) continue; if (prop === 'layout' || prop === 'paint' || prop === 'filter' || prop === 'metadata' || prop === 'minzoom' || prop === 'maxzoom') continue; if (prop.indexOf('paint.') === 0) { diffLayerPropertyChanges(beforeLayer[prop], afterLayer[prop], commands, layerId, prop.slice(6), 'setPaintProperty'); } else if (!deepEqual(beforeLayer[prop], afterLayer[prop])) { addCommand(commands, { command: 'setLayerProperty', args: [layerId, prop, afterLayer[prop]] }); } } } } /** * Diff two stylesheet * * Creates semanticly aware diffs that can easily be applied at runtime. * Operations produced by the diff closely resemble the maplibre-gl-js API. Any * error creating the diff will fall back to the 'setStyle' operation. * * Example diff: * [ * { command: 'setConstant', args: ['@water', '#0000FF'] }, * { command: 'setPaintProperty', args: ['background', 'background-color', 'black'] } * ] * * @private * @param {*} [before] stylesheet to compare from * @param {*} after stylesheet to compare to * @returns Array list of changes */ function diffStyles(before, after) { if (!before) return [{ command: 'setStyle', args: [after] }]; let commands = []; try { // Handle changes to top-level properties if (!deepEqual(before.version, after.version)) { return [{ command: 'setStyle', args: [after] }]; } if (!deepEqual(before.center, after.center)) { commands.push({ command: 'setCenter', args: [after.center] }); } if (!deepEqual(before.zoom, after.zoom)) { commands.push({ command: 'setZoom', args: [after.zoom] }); } if (!deepEqual(before.bearing, after.bearing)) { commands.push({ command: 'setBearing', args: [after.bearing] }); } if (!deepEqual(before.pitch, after.pitch)) { commands.push({ command: 'setPitch', args: [after.pitch] }); } if (!deepEqual(before.sprite, after.sprite)) { commands.push({ command: 'setSprite', args: [after.sprite] }); } if (!deepEqual(before.glyphs, after.glyphs)) { commands.push({ command: 'setGlyphs', args: [after.glyphs] }); } if (!deepEqual(before.transition, after.transition)) { commands.push({ command: 'setTransition', args: [after.transition] }); } if (!deepEqual(before.light, after.light)) { commands.push({ command: 'setLight', args: [after.light] }); } if (!deepEqual(before.terrain, after.terrain)) { commands.push({ command: 'setTerrain', args: [after.terrain] }); } if (!deepEqual(before.sky, after.sky)) { commands.push({ command: 'setSky', args: [after.sky] }); } if (!deepEqual(before.projection, after.projection)) { commands.push({ command: 'setProjection', args: [after.projection] }); } // Handle changes to `sources` // If a source is to be removed, we also--before the removeSource // command--need to remove all the style layers that depend on it. const sourcesRemoved = {}; // First collect the {add,remove}Source commands const removeOrAddSourceCommands = []; diffSources(before.sources, after.sources, removeOrAddSourceCommands, sourcesRemoved); // Push a removeLayer command for each style layer that depends on a // source that's being removed. // Also, exclude any such layers them from the input to `diffLayers` // below, so that diffLayers produces the appropriate `addLayers` // command const beforeLayers = []; if (before.layers) { before.layers.forEach((layer) => { if ('source' in layer && sourcesRemoved[layer.source]) { commands.push({ command: 'removeLayer', args: [layer.id] }); } else { beforeLayers.push(layer); } }); } commands = commands.concat(removeOrAddSourceCommands); // Handle changes to `layers` diffLayers(beforeLayers, after.layers, commands); } catch (e) { // fall back to setStyle console.warn('Unable to compute style diff:', e); commands = [{ command: 'setStyle', args: [after] }]; } return commands; } // Note: Do not inherit from Error. It breaks when transpiling to ES5. class ValidationError { constructor(key, value, message, identifier) { this.message = (key ? `${key}: ` : '') + message; if (identifier) this.identifier = identifier; if (value !== null && value !== undefined && value.__line__) { this.line = value.__line__; } } } // Note: Do not inherit from Error. It breaks when transpiling to ES5. class ParsingError { constructor(error) { this.error = error; this.message = error.message; const match = error.message.match(/line (\d+)/); this.line = match ? parseInt(match[1], 10) : 0; } } function extendBy(output, ...inputs) { for (const input of inputs) { for (const k in input) { output[k] = input[k]; } } return output; } class ExpressionParsingError extends Error { constructor(key, message) { super(message); this.message = message; this.key = key; } } /** * Tracks `let` bindings during expression parsing. * @private */ class Scope { constructor(parent, bindings = []) { this.parent = parent; this.bindings = {}; for (const [name, expression] of bindings) { this.bindings[name] = expression; } } concat(bindings) { return new Scope(this, bindings); } get(name) { if (this.bindings[name]) { return this.bindings[name]; } if (this.parent) { return this.parent.get(name); } throw new Error(`${name} not found in scope.`); } has(name) { if (this.bindings[name]) return true; return this.parent ? this.parent.has(name) : false; } } const NullType = { kind: 'null' }; const NumberType = { kind: 'number' }; const StringType = { kind: 'string' }; const BooleanType = { kind: 'boolean' }; const ColorType = { kind: 'color' }; const ObjectType = { kind: 'object' }; const ValueType = { kind: 'value' }; const ErrorType = { kind: 'error' }; const CollatorType = { kind: 'collator' }; const FormattedType = { kind: 'formatted' }; const PaddingType = { kind: 'padding' }; const ResolvedImageType = { kind: 'resolvedImage' }; const VariableAnchorOffsetCollectionType = { kind: 'variableAnchorOffsetCollection' }; function array$1(itemType, N) { return { kind: 'array', itemType, N }; } function toString$1(type) { if (type.kind === 'array') { const itemType = toString$1(type.itemType); return typeof type.N === 'number' ? `array<${itemType}, ${type.N}>` : type.itemType.kind === 'value' ? 'array' : `array<${itemType}>`; } else { return type.kind; } } const valueMemberTypes = [ NullType, NumberType, StringType, BooleanType, ColorType, FormattedType, ObjectType, array$1(ValueType), PaddingType, ResolvedImageType, VariableAnchorOffsetCollectionType ]; /** * Returns null if `t` is a subtype of `expected`; otherwise returns an * error message. * @private */ function checkSubtype(expected, t) { if (t.kind === 'error') { // Error is a subtype of every type return null; } else if (expected.kind === 'array') { if (t.kind === 'array' && ((t.N === 0 && t.itemType.kind === 'value') || !checkSubtype(expected.itemType, t.itemType)) && (typeof expected.N !== 'number' || expected.N === t.N)) { return null; } } else if (expected.kind === t.kind) { return null; } else if (expected.kind === 'value') { for (const memberType of valueMemberTypes) { if (!checkSubtype(memberType, t)) { return null; } } } return `Expected ${toString$1(expected)} but found ${toString$1(t)} instead.`; } function isValidType(provided, allowedTypes) { return allowedTypes.some(t => t.kind === provided.kind); } function isValidNativeType(provided, allowedTypes) { return allowedTypes.some(t => { if (t === 'null') { return provided === null; } else if (t === 'array') { return Array.isArray(provided); } else if (t === 'object') { return provided && !Array.isArray(provided) && typeof provided === 'object'; } else { return t === typeof provided; } }); } /** * Verify whether the specified type is of the same type as the specified sample. * * @param provided Type to verify * @param sample Sample type to reference * @returns `true` if both objects are of the same type, `false` otherwise * @example basic types * if (verifyType(outputType, ValueType)) { * // type narrowed to: * outputType.kind; // 'value' * } * @example array types * if (verifyType(outputType, array(NumberType))) { * // type narrowed to: * outputType.kind; // 'array' * outputType.itemType; // NumberTypeT * outputType.itemType.kind; // 'number' * } */ function verifyType(provided, sample) { if (provided.kind === 'array' && sample.kind === 'array') { return provided.itemType.kind === sample.itemType.kind && typeof provided.N === 'number'; } return provided.kind === sample.kind; } // See https://observablehq.com/@mbostock/lab-and-rgb const Xn = 0.96422, Yn = 1, Zn = 0.82521, t0 = 4 / 29, t1 = 6 / 29, t2 = 3 * t1 * t1, t3 = t1 * t1 * t1, deg2rad = Math.PI / 180, rad2deg = 180 / Math.PI; function constrainAngle(angle) { angle = angle % 360; if (angle < 0) { angle += 360; } return angle; } function rgbToLab([r, g, b, alpha]) { r = rgb2xyz(r); g = rgb2xyz(g); b = rgb2xyz(b); let x, z; const y = xyz2lab((0.2225045 * r + 0.7168786 * g + 0.0606169 * b) / Yn); if (r === g && g === b) { x = z = y; } else { x = xyz2lab((0.4360747 * r + 0.3850649 * g + 0.1430804 * b) / Xn); z = xyz2lab((0.0139322 * r + 0.0971045 * g + 0.7141733 * b) / Zn); } const l = 116 * y - 16; return [(l < 0) ? 0 : l, 500 * (x - y), 200 * (y - z), alpha]; } function rgb2xyz(x) { return (x <= 0.04045) ? x / 12.92 : Math.pow((x + 0.055) / 1.055, 2.4); } function xyz2lab(t) { return (t > t3) ? Math.pow(t, 1 / 3) : t / t2 + t0; } function labToRgb([l, a, b, alpha]) { let y = (l + 16) / 116, x = isNaN(a) ? y : y + a / 500, z = isNaN(b) ? y : y - b / 200; y = Yn * lab2xyz(y); x = Xn * lab2xyz(x); z = Zn * lab2xyz(z); return [ xyz2rgb(3.1338561 * x - 1.6168667 * y - 0.4906146 * z), // D50 -> sRGB xyz2rgb(-0.9787684 * x + 1.9161415 * y + 0.0334540 * z), xyz2rgb(0.0719453 * x - 0.2289914 * y + 1.4052427 * z), alpha, ]; } function xyz2rgb(x) { x = (x <= 0.00304) ? 12.92 * x : 1.055 * Math.pow(x, 1 / 2.4) - 0.055; return (x < 0) ? 0 : (x > 1) ? 1 : x; // clip to 0..1 range } function lab2xyz(t) { return (t > t1) ? t * t * t : t2 * (t - t0); } function rgbToHcl(rgbColor) { const [l, a, b, alpha] = rgbToLab(rgbColor); const c = Math.sqrt(a * a + b * b); const h = Math.round(c * 10000) ? constrainAngle(Math.atan2(b, a) * rad2deg) : NaN; return [h, c, l, alpha]; } function hclToRgb([h, c, l, alpha]) { h = isNaN(h) ? 0 : h * deg2rad; return labToRgb([l, Math.cos(h) * c, Math.sin(h) * c, alpha]); } // https://drafts.csswg.org/css-color-4/#hsl-to-rgb function hslToRgb([h, s, l, alpha]) { h = constrainAngle(h); s /= 100; l /= 100; function f(n) { const k = (n + h / 30) % 12; const a = s * Math.min(l, 1 - l); return l - a * Math.max(-1, Math.min(k - 3, 9 - k, 1)); } return [f(0), f(8), f(4), alpha]; } /** * CSS color parser compliant with CSS Color 4 Specification. * Supports: named colors, `transparent` keyword, all rgb hex notations, * rgb(), rgba(), hsl() and hsla() functions. * Does not round the parsed values to integers from the range 0..255. * * Syntax: * * = | * = | * * rgb() = rgb( {3} [ / ]? ) | rgb( {3} [ / ]? ) * rgb() = rgb( #{3} , ? ) | rgb( #{3} , ? ) * * hsl() = hsl( [ / ]? ) * hsl() = hsl( , , , ? ) * * Caveats: * - - with optional `deg` suffix; `grad`, `rad`, `turn` are not supported * - `none` keyword is not supported * - comments inside rgb()/hsl() are not supported * - legacy color syntax rgba() is supported with an identical grammar and behavior to rgb() * - legacy color syntax hsla() is supported with an identical grammar and behavior to hsl() * * @param input CSS color string to parse. * @returns Color in sRGB color space, with `red`, `green`, `blue` * and `alpha` channels normalized to the range 0..1, * or `undefined` if the input is not a valid color string. */ function parseCssColor(input) { input = input.toLowerCase().trim(); if (input === 'transparent') { return [0, 0, 0, 0]; } // 'white', 'black', 'blue' const namedColorsMatch = namedColors[input]; if (namedColorsMatch) { const [r, g, b] = namedColorsMatch; return [r / 255, g / 255, b / 255, 1]; } // #f0c, #f0cf, #ff00cc, #ff00ccff if (input.startsWith('#')) { const hexRegexp = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/; if (hexRegexp.test(input)) { const step = input.length < 6 ? 1 : 2; let i = 1; return [ parseHex(input.slice(i, i += step)), parseHex(input.slice(i, i += step)), parseHex(input.slice(i, i += step)), parseHex(input.slice(i, i + step) || 'ff'), ]; } } // rgb(128 0 0), rgb(50% 0% 0%), rgba(255,0,255,0.6), rgb(255 0 255 / 60%), rgb(100% 0% 100% /.6) if (input.startsWith('rgb')) { const rgbRegExp = /^rgba?\(\s*([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s+|\s*(,)\s*)([\de.+-]+)(%)?(?:\s*([,\/])\s*([\de.+-]+)(%)?)?\s*\)$/; const rgbMatch = input.match(rgbRegExp); if (rgbMatch) { const [_, // eslint-disable-line @typescript-eslint/no-unused-vars r, // rp, // % (optional) f1, // , (optional) g, // gp, // % (optional) f2, // , (optional) b, // bp, // % (optional) f3, // ,|/ (optional) a, // (optional) ap, // % (optional) ] = rgbMatch; const argFormat = [f1 || ' ', f2 || ' ', f3].join(''); if (argFormat === ' ' || argFormat === ' /' || argFormat === ',,' || argFormat === ',,,') { const valFormat = [rp, gp, bp].join(''); const maxValue = (valFormat === '%%%') ? 100 : (valFormat === '') ? 255 : 0; if (maxValue) { const rgba = [ clamp(+r / maxValue, 0, 1), clamp(+g / maxValue, 0, 1), clamp(+b / maxValue, 0, 1), a ? parseAlpha(+a, ap) : 1, ]; if (validateNumbers(rgba)) { return rgba; } // invalid numbers } // values must be all numbers or all percentages } return; // comma optional syntax requires no commas at all } } // hsl(120 50% 80%), hsla(120deg,50%,80%,.9), hsl(12e1 50% 80% / 90%) const hslRegExp = /^hsla?\(\s*([\de.+-]+)(?:deg)?(?:\s+|\s*(,)\s*)([\de.+-]+)%(?:\s+|\s*(,)\s*)([\de.+-]+)%(?:\s*([,\/])\s*([\de.+-]+)(%)?)?\s*\)$/; const hslMatch = input.match(hslRegExp); if (hslMatch) { const [_, // eslint-disable-line @typescript-eslint/no-unused-vars h, // f1, // , (optional) s, // f2, // , (optional) l, // f3, // ,|/ (optional) a, // (optional) ap, // % (optional) ] = hslMatch; const argFormat = [f1 || ' ', f2 || ' ', f3].join(''); if (argFormat === ' ' || argFormat === ' /' || argFormat === ',,' || argFormat === ',,,') { const hsla = [ +h, clamp(+s, 0, 100), clamp(+l, 0, 100), a ? parseAlpha(+a, ap) : 1, ]; if (validateNumbers(hsla)) { return hslToRgb(hsla); } // invalid numbers } // comma optional syntax requires no commas at all } } function parseHex(hex) { return parseInt(hex.padEnd(2, hex), 16) / 255; } function parseAlpha(a, asPercentage) { return clamp(asPercentage ? (a / 100) : a, 0, 1); } function clamp(n, min, max) { return Math.min(Math.max(min, n), max); } /** * The regular expression for numeric values is not super specific, and it may * happen that it will accept a value that is not a valid number. In order to * detect and eliminate such values this function exists. * * @param array Array of uncertain numbers. * @returns `true` if the specified array contains only valid numbers, `false` otherwise. */ function validateNumbers(array) { return !array.some(Number.isNaN); } /** * To generate: * - visit {@link https://www.w3.org/TR/css-color-4/#named-colors} * - run in the console: * @example * copy(`{\n${[...document.querySelector('.named-color-table tbody').children].map((tr) => `${tr.cells[2].textContent.trim()}: [${tr.cells[4].textContent.trim().split(/\s+/).join(', ')}],`).join('\n')}\n}`); */ const namedColors = { aliceblue: [240, 248, 255], antiquewhite: [250, 235, 215], aqua: [0, 255, 255], aquamarine: [127, 255, 212], azure: [240, 255, 255], beige: [245, 245, 220], bisque: [255, 228, 196], black: [0, 0, 0], blanchedalmond: [255, 235, 205], blue: [0, 0, 255], blueviolet: [138, 43, 226], brown: [165, 42, 42], burlywood: [222, 184, 135], cadetblue: [95, 158, 160], chartreuse: [127, 255, 0], chocolate: [210, 105, 30], coral: [255, 127, 80], cornflowerblue: [100, 149, 237], cornsilk: [255, 248, 220], crimson: [220, 20, 60], cyan: [0, 255, 255], darkblue: [0, 0, 139], darkcyan: [0, 139, 139], darkgoldenrod: [184, 134, 11], darkgray: [169, 169, 169], darkgreen: [0, 100, 0], darkgrey: [169, 169, 169], darkkhaki: [189, 183, 107], darkmagenta: [139, 0, 139], darkolivegreen: [85, 107, 47], darkorange: [255, 140, 0], darkorchid: [153, 50, 204], darkred: [139, 0, 0], darksalmon: [233, 150, 122], darkseagreen: [143, 188, 143], darkslateblue: [72, 61, 139], darkslategray: [47, 79, 79], darkslategrey: [47, 79, 79], darkturquoise: [0, 206, 209], darkviolet: [148, 0, 211], deeppink: [255, 20, 147], deepskyblue: [0, 191, 255], dimgray: [105, 105, 105], dimgrey: [105, 105, 105], dodgerblue: [30, 144, 255], firebrick: [178, 34, 34], floralwhite: [255, 250, 240], forestgreen: [34, 139, 34], fuchsia: [255, 0, 255], gainsboro: [220, 220, 220], ghostwhite: [248, 248, 255], gold: [255, 215, 0], goldenrod: [218, 165, 32], gray: [128, 128, 128], green: [0, 128, 0], greenyellow: [173, 255, 47], grey: [128, 128, 128], honeydew: [240, 255, 240], hotpink: [255, 105, 180], indianred: [205, 92, 92], indigo: [75, 0, 130], ivory: [255, 255, 240], khaki: [240, 230, 140], lavender: [230, 230, 250], lavenderblush: [255, 240, 245], lawngreen: [124, 252, 0], lemonchiffon: [255, 250, 205], lightblue: [173, 216, 230], lightcoral: [240, 128, 128], lightcyan: [224, 255, 255], lightgoldenrodyellow: [250, 250, 210], lightgray: [211, 211, 211], lightgreen: [144, 238, 144], lightgrey: [211, 211, 211], lightpink: [255, 182, 193], lightsalmon: [255, 160, 122], lightseagreen: [32, 178, 170], lightskyblue: [135, 206, 250], lightslategray: [119, 136, 153], lightslategrey: [119, 136, 153], lightsteelblue: [176, 196, 222], lightyellow: [255, 255, 224], lime: [0, 255, 0], limegreen: [50, 205, 50], linen: [250, 240, 230], magenta: [255, 0, 255], maroon: [128, 0, 0], mediumaquamarine: [102, 205, 170], mediumblue: [0, 0, 205], mediumorchid: [186, 85, 211], mediumpurple: [147, 112, 219], mediumseagreen: [60, 179, 113], mediumslateblue: [123, 104, 238], mediumspringgreen: [0, 250, 154], mediumturquoise: [72, 209, 204], mediumvioletred: [199, 21, 133], midnightblue: [25, 25, 112], mintcream: [245, 255, 250], mistyrose: [255, 228, 225], moccasin: [255, 228, 181], navajowhite: [255, 222, 173], navy: [0, 0, 128], oldlace: [253, 245, 230], olive: [128, 128, 0], olivedrab: [107, 142, 35], orange: [255, 165, 0], orangered: [255, 69, 0], orchid: [218, 112, 214], palegoldenrod: [238, 232, 170], palegreen: [152, 251, 152], paleturquoise: [175, 238, 238], palevioletred: [219, 112, 147], papayawhip: [255, 239, 213], peachpuff: [255, 218, 185], peru: [205, 133, 63], pink: [255, 192, 203], plum: [221, 160, 221], powderblue: [176, 224, 230], purple: [128, 0, 128], rebeccapurple: [102, 51, 153], red: [255, 0, 0], rosybrown: [188, 143, 143], royalblue: [65, 105, 225], saddlebrown: [139, 69, 19], salmon: [250, 128, 114], sandybrown: [244, 164, 96], seagreen: [46, 139, 87], seashell: [255, 245, 238], sienna: [160, 82, 45], silver: [192, 192, 192], skyblue: [135, 206, 235], slateblue: [106, 90, 205], slategray: [112, 128, 144], slategrey: [112, 128, 144], snow: [255, 250, 250], springgreen: [0, 255, 127], steelblue: [70, 130, 180], tan: [210, 180, 140], teal: [0, 128, 128], thistle: [216, 191, 216], tomato: [255, 99, 71], turquoise: [64, 224, 208], violet: [238, 130, 238], wheat: [245, 222, 179], white: [255, 255, 255], whitesmoke: [245, 245, 245], yellow: [255, 255, 0], yellowgreen: [154, 205, 50], }; /** * Color representation used by WebGL. * Defined in sRGB color space and pre-blended with alpha. * @private */ class Color { /** * @param r Red component premultiplied by `alpha` 0..1 * @param g Green component premultiplied by `alpha` 0..1 * @param b Blue component premultiplied by `alpha` 0..1 * @param [alpha=1] Alpha component 0..1 * @param [premultiplied=true] Whether the `r`, `g` and `b` values have already * been multiplied by alpha. If `true` nothing happens if `false` then they will * be multiplied automatically. */ constructor(r, g, b, alpha = 1, premultiplied = true) { this.r = r; this.g = g; this.b = b; this.a = alpha; if (!premultiplied) { this.r *= alpha; this.g *= alpha; this.b *= alpha; if (!alpha) { // alpha = 0 erases completely rgb channels. This behavior is not desirable // if this particular color is later used in color interpolation. // Because of that, a reference to original color is saved. this.overwriteGetter('rgb', [r, g, b, alpha]); } } } /** * Parses CSS color strings and converts colors to sRGB color space if needed. * Officially supported color formats: * - keyword, e.g. 'aquamarine' or 'steelblue' * - hex (with 3, 4, 6 or 8 digits), e.g. '#f0f' or '#e9bebea9' * - rgb and rgba, e.g. 'rgb(0,240,120)' or 'rgba(0%,94%,47%,0.1)' or 'rgb(0 240 120 / .3)' * - hsl and hsla, e.g. 'hsl(0,0%,83%)' or 'hsla(0,0%,83%,.5)' or 'hsl(0 0% 83% / 20%)' * * @param input CSS color string to parse. * @returns A `Color` instance, or `undefined` if the input is not a valid color string. */ static parse(input) { // in zoom-and-property function input could be an instance of Color class if (input instanceof Color) { return input; } if (typeof input !== 'string') { return; } const rgba = parseCssColor(input); if (rgba) { return new Color(...rgba, false); } } /** * Used in color interpolation and by 'to-rgba' expression. * * @returns Gien color, with reversed alpha blending, in sRGB color space. */ get rgb() { const { r, g, b, a } = this; const f = a || Infinity; // reverse alpha blending factor return this.overwriteGetter('rgb', [r / f, g / f, b / f, a]); } /** * Used in color interpolation. * * @returns Gien color, with reversed alpha blending, in HCL color space. */ get hcl() { return this.overwriteGetter('hcl', rgbToHcl(this.rgb)); } /** * Used in color interpolation. * * @returns Gien color, with reversed alpha blending, in LAB color space. */ get lab() { return this.overwriteGetter('lab', rgbToLab(this.rgb)); } /** * Lazy getter pattern. When getter is called for the first time lazy value * is calculated and then overwrites getter function in given object instance. * * @example: * const redColor = Color.parse('red'); * let x = redColor.hcl; // this will invoke `get hcl()`, which will calculate * // the value of red in HCL space and invoke this `overwriteGetter` function * // which in turn will set a field with a key 'hcl' in the `redColor` object. * // In other words it will override `get hcl()` from its `Color` prototype * // with its own property: hcl = [calculated red value in hcl]. * let y = redColor.hcl; // next call will no longer invoke getter but simply * // return the previously calculated value * x === y; // true - `x` is exactly the same object as `y` * * @param getterKey Getter key * @param lazyValue Lazily calculated value to be memoized by current instance * @private */ overwriteGetter(getterKey, lazyValue) { Object.defineProperty(this, getterKey, { value: lazyValue }); return lazyValue; } /** * Used by 'to-string' expression. * * @returns Serialized color in format `rgba(r,g,b,a)` * where r,g,b are numbers within 0..255 and alpha is number within 1..0 * * @example * var purple = new Color.parse('purple'); * purple.toString; // = "rgba(128,0,128,1)" * var translucentGreen = new Color.parse('rgba(26, 207, 26, .73)'); * translucentGreen.toString(); // = "rgba(26,207,26,0.73)" */ toString() { const [r, g, b, a] = this.rgb; return `rgba(${[r, g, b].map(n => Math.round(n * 255)).join(',')},${a})`; } } Color.black = new Color(0, 0, 0, 1); Color.white = new Color(1, 1, 1, 1); Color.transparent = new Color(0, 0, 0, 0); Color.red = new Color(1, 0, 0, 1); // Flow type declarations for Intl cribbed from // https://github.com/facebook/flow/issues/1270 class Collator { constructor(caseSensitive, diacriticSensitive, locale) { if (caseSensitive) this.sensitivity = diacriticSensitive ? 'variant' : 'case'; else this.sensitivity = diacriticSensitive ? 'accent' : 'base'; this.locale = locale; this.collator = new Intl.Collator(this.locale ? this.locale : [], { sensitivity: this.sensitivity, usage: 'search' }); } compare(lhs, rhs) { return this.collator.compare(lhs, rhs); } resolvedLocale() { // We create a Collator without "usage: search" because we don't want // the search options encoded in our result (e.g. "en-u-co-search") return new Intl.Collator(this.locale ? this.locale : []) .resolvedOptions().locale; } } class FormattedSection { constructor(text, image, scale, fontStack, textColor) { this.text = text; this.image = image; this.scale = scale; this.fontStack = fontStack; this.textColor = textColor; } } class Formatted { constructor(sections) { this.sections = sections; } static fromString(unformatted) { return new Formatted([new FormattedSection(unformatted, null, null, null, null)]); } isEmpty() { if (this.sections.length === 0) return true; return !this.sections.some(section => section.text.length !== 0 || (section.image && section.image.name.length !== 0)); } static factory(text) { if (text instanceof Formatted) { return text; } else { return Formatted.fromString(text); } } toString() { if (this.sections.length === 0) return ''; return this.sections.map(section => section.text).join(''); } } /** * A set of four numbers representing padding around a box. Create instances from * bare arrays or numeric values using the static method `Padding.parse`. * @private */ class Padding { constructor(values) { this.values = values.slice(); } /** * Numeric padding values * @param input A padding value * @returns A `Padding` instance, or `undefined` if the input is not a valid padding value. */ static parse(input) { if (input instanceof Padding) { return input; } // Backwards compatibility: bare number is treated the same as array with single value. // Padding applies to all four sides. if (typeof input === 'number') { return new Padding([input, input, input, input]); } if (!Array.isArray(input)) { return undefined; } if (input.length < 1 || input.length > 4) { return undefined; } for (const val of input) { if (typeof val !== 'number') { return undefined; } } // Expand shortcut properties into explicit 4-sided values switch (input.length) { case 1: input = [input[0], input[0], input[0], input[0]]; break; case 2: input = [input[0], input[1], input[0], input[1]]; break; case 3: input = [input[0], input[1], input[2], input[1]]; break; } return new Padding(input); } toString() { return JSON.stringify(this.values); } } /** Set of valid anchor positions, as a set for validation */ const anchors = new Set(['center', 'left', 'right', 'top', 'bottom', 'top-left', 'top-right', 'bottom-left', 'bottom-right']); /** * Utility class to assist managing values for text-variable-anchor-offset property. Create instances from * bare arrays using the static method `VariableAnchorOffsetCollection.parse`. * @private */ class VariableAnchorOffsetCollection { constructor(values) { this.values = values.slice(); } static parse(input) { if (input instanceof VariableAnchorOffsetCollection) { return input; } if (!Array.isArray(input) || input.length < 1 || input.length % 2 !== 0) { return undefined; } for (let i = 0; i < input.length; i += 2) { // Elements in even positions should be anchor positions; Elements in odd positions should be offset values const anchorValue = input[i]; const offsetValue = input[i + 1]; if (typeof anchorValue !== 'string' || !anchors.has(anchorValue)) { return undefined; } if (!Array.isArray(offsetValue) || offsetValue.length !== 2 || typeof offsetValue[0] !== 'number' || typeof offsetValue[1] !== 'number') { return undefined; } } return new VariableAnchorOffsetCollection(input); } toString() { return JSON.stringify(this.values); } } class ResolvedImage { constructor(options) { this.name = options.name; this.available = options.available; } toString() { return this.name; } static fromString(name) { if (!name) return null; // treat empty values as no image return new ResolvedImage({ name, available: false }); } } function validateRGBA(r, g, b, a) { if (!(typeof r === 'number' && r >= 0 && r <= 255 && typeof g === 'number' && g >= 0 && g <= 255 && typeof b === 'number' && b >= 0 && b <= 255)) { const value = typeof a === 'number' ? [r, g, b, a] : [r, g, b]; return `Invalid rgba value [${value.join(', ')}]: 'r', 'g', and 'b' must be between 0 and 255.`; } if (!(typeof a === 'undefined' || (typeof a === 'number' && a >= 0 && a <= 1))) { return `Invalid rgba value [${[r, g, b, a].join(', ')}]: 'a' must be between 0 and 1.`; } return null; } function isValue(mixed) { if (mixed === null || typeof mixed === 'string' || typeof mixed === 'boolean' || typeof mixed === 'number' || mixed instanceof Color || mixed instanceof Collator || mixed instanceof Formatted || mixed instanceof Padding || mixed instanceof VariableAnchorOffsetCollection || mixed instanceof ResolvedImage) { return true; } else if (Array.isArray(mixed)) { for (const item of mixed) { if (!isValue(item)) { return false; } } return true; } else if (typeof mixed === 'object') { for (const key in mixed) { if (!isValue(mixed[key])) { return false; } } return true; } else { return false; } } function typeOf(value) { if (value === null) { return NullType; } else if (typeof value === 'string') { return StringType; } else if (typeof value === 'boolean') { return BooleanType; } else if (typeof value === 'number') { return NumberType; } else if (value instanceof Color) { return ColorType; } else if (value instanceof Collator) { return CollatorType; } else if (value instanceof Formatted) { return FormattedType; } else if (value instanceof Padding) { return PaddingType; } else if (value instanceof VariableAnchorOffsetCollection) { return VariableAnchorOffsetCollectionType; } else if (value instanceof ResolvedImage) { return ResolvedImageType; } else if (Array.isArray(value)) { const length = value.length; let itemType; for (const item of value) { const t = typeOf(item); if (!itemType) { itemType = t; } else if (itemType === t) { continue; } else { itemType = ValueType; break; } } return array$1(itemType || ValueType, length); } else { return ObjectType; } } function toString(value) { const type = typeof value; if (value === null) { return ''; } else if (type === 'string' || type === 'number' || type === 'boolean') { return String(value); } else if (value instanceof Color || value instanceof Formatted || value instanceof Padding || value instanceof VariableAnchorOffsetCollection || value instanceof ResolvedImage) { return value.toString(); } else { return JSON.stringify(value); } } class Literal { constructor(type, value) { this.type = type; this.value = value; } static parse(args, context) { if (args.length !== 2) return context.error(`'literal' expression requires exactly one argument, but found ${args.length - 1} instead.`); if (!isValue(args[1])) return context.error('invalid value'); const value = args[1]; let type = typeOf(value); // special case: infer the item type if possible for zero-length arrays const expected = context.expectedType; if (type.kind === 'array' && type.N === 0 && expected && expected.kind === 'array' && (typeof expected.N !== 'number' || expected.N === 0)) { type = expected; } return new Literal(type, value); } evaluate() { return this.value; } eachChild() { } outputDefined() { return true; } } class RuntimeError { constructor(message) { this.name = 'ExpressionEvaluationError'; this.message = message; } toJSON() { return this.message; } } const types$1 = { string: StringType, number: NumberType, boolean: BooleanType, object: ObjectType }; class Assertion { constructor(type, args) { this.type = type; this.args = args; } static parse(args, context) { if (args.length < 2) return context.error('Expected at least one argument.'); let i = 1; let type; const name = args[0]; if (name === 'array') { let itemType; if (args.length > 2) { const type = args[1]; if (typeof type !== 'string' || !(type in types$1) || type === 'object') return context.error('The item type argument of "array" must be one of string, number, boolean', 1); itemType = types$1[type]; i++; } else { itemType = ValueType; } let N; if (args.length > 3) { if (args[2] !== null && (typeof args[2] !== 'number' || args[2] < 0 || args[2] !== Math.floor(args[2]))) { return context.error('The length argument to "array" must be a positive integer literal', 2); } N = args[2]; i++; } type = array$1(itemType, N); } else { if (!types$1[name]) throw new Error(`Types doesn't contain name = ${name}`); type = types$1[name]; } const parsed = []; for (; i < args.length; i++) { const input = context.parse(args[i], i, ValueType); if (!input) return null; parsed.push(input); } return new Assertion(type, parsed); } evaluate(ctx) { for (let i = 0; i < this.args.length; i++) { const value = this.args[i].evaluate(ctx); const error = checkSubtype(this.type, typeOf(value)); if (!error) { return value; } else if (i === this.args.length - 1) { throw new RuntimeError(`Expected value to be of type ${toString$1(this.type)}, but found ${toString$1(typeOf(value))} instead.`); } } throw new Error(); } eachChild(fn) { this.args.forEach(fn); } outputDefined() { return this.args.every(arg => arg.outputDefined()); } } const types = { 'to-boolean': BooleanType, 'to-color': ColorType, 'to-number': NumberType, 'to-string': StringType }; /** * Special form for error-coalescing coercion expressions "to-number", * "to-color". Since these coercions can fail at runtime, they accept multiple * arguments, only evaluating one at a time until one succeeds. * * @private */ class Coercion { constructor(type, args) { this.type = type; this.args = args; } static parse(args, context) { if (args.length < 2) return context.error('Expected at least one argument.'); const name = args[0]; if (!types[name]) throw new Error(`Can't parse ${name} as it is not part of the known types`); if ((name === 'to-boolean' || name === 'to-string') && args.length !== 2) return context.error('Expected one argument.'); const type = types[name]; const parsed = []; for (let i = 1; i < args.length; i++) { const input = context.parse(args[i], i, ValueType); if (!input) return null; parsed.push(input); } return new Coercion(type, parsed); } evaluate(ctx) { switch (this.type.kind) { case 'boolean': return Boolean(this.args[0].evaluate(ctx)); case 'color': { let input; let error; for (const arg of this.args) { input = arg.evaluate(ctx); error = null; if (input instanceof Color) { return input; } else if (typeof input === 'string') { const c = ctx.parseColor(input); if (c) return c; } else if (Array.isArray(input)) { if (input.length < 3 || input.length > 4) { error = `Invalid rbga value ${JSON.stringify(input)}: expected an array containing either three or four numeric values.`; } else { error = validateRGBA(input[0], input[1], input[2], input[3]); } if (!error) { return new Color(input[0] / 255, input[1] / 255, input[2] / 255, input[3]); } } } throw new RuntimeError(error || `Could not parse color from value '${typeof input === 'string' ? input : JSON.stringify(input)}'`); } case 'padding': { let input; for (const arg of this.args) { input = arg.evaluate(ctx); const pad = Padding.parse(input); if (pad) { return pad; } } throw new RuntimeError(`Could not parse padding from value '${typeof input === 'string' ? input : JSON.stringify(input)}'`); } case 'variableAnchorOffsetCollection': { let input; for (const arg of this.args) { input = arg.evaluate(ctx); const coll = VariableAnchorOffsetCollection.parse(input); if (coll) { return coll; } } throw new RuntimeError(`Could not parse variableAnchorOffsetCollection from value '${typeof input === 'string' ? input : JSON.stringify(input)}'`); } case 'number': { let value = null; for (const arg of this.args) { value = arg.evaluate(ctx); if (value === null) return 0; const num = Number(value); if (isNaN(num)) continue; return num; } throw new RuntimeError(`Could not convert ${JSON.stringify(value)} to number.`); } case 'formatted': // There is no explicit 'to-formatted' but this coercion can be implicitly // created by properties that expect the 'formatted' type. return Formatted.fromString(toString(this.args[0].evaluate(ctx))); case 'resolvedImage': return ResolvedImage.fromString(toString(this.args[0].evaluate(ctx))); default: return toString(this.args[0].evaluate(ctx)); } } eachChild(fn) { this.args.forEach(fn); } outputDefined() { return this.args.every(arg => arg.outputDefined()); } } const geometryTypes = ['Unknown', 'Point', 'LineString', 'Polygon']; class EvaluationContext { constructor() { this.globals = null; this.feature = null; this.featureState = null; this.formattedSection = null; this._parseColorCache = {}; this.availableImages = null; this.canonical = null; } id() { return this.feature && 'id' in this.feature ? this.feature.id : null; } geometryType() { return this.feature ? typeof this.feature.type === 'number' ? geometryTypes[this.feature.type] : this.feature.type : null; } geometry() { return this.feature && 'geometry' in this.feature ? this.feature.geometry : null; } canonicalID() { return this.canonical; } properties() { return this.feature && this.feature.properties || {}; } parseColor(input) { let cached = this._parseColorCache[input]; if (!cached) { cached = this._parseColorCache[input] = Color.parse(input); } return cached; } } /** * State associated parsing at a given point in an expression tree. * @private */ class ParsingContext { constructor(registry, isConstantFunc, path = [], expectedType, scope = new Scope(), errors = []) { this.registry = registry; this.path = path; this.key = path.map(part => `[${part}]`).join(''); this.scope = scope; this.errors = errors; this.expectedType = expectedType; this._isConstant = isConstantFunc; } /** * @param expr the JSON expression to parse * @param index the optional argument index if this expression is an argument of a parent expression that's being parsed * @param options * @param options.omitTypeAnnotations set true to omit inferred type annotations. Caller beware: with this option set, the parsed expression's type will NOT satisfy `expectedType` if it would normally be wrapped in an inferred annotation. * @private */ parse(expr, index, expectedType, bindings, options = {}) { if (index) { return this.concat(index, expectedType, bindings)._parse(expr, options); } return this._parse(expr, options); } _parse(expr, options) { if (expr === null || typeof expr === 'string' || typeof expr === 'boolean' || typeof expr === 'number') { expr = ['literal', expr]; } function annotate(parsed, type, typeAnnotation) { if (typeAnnotation === 'assert') { return new Assertion(type, [parsed]); } else if (typeAnnotation === 'coerce') { return new Coercion(type, [parsed]); } else { return parsed; } } if (Array.isArray(expr)) { if (expr.length === 0) { return this.error('Expected an array with at least one element. If you wanted a literal array, use ["literal", []].'); } const op = expr[0]; if (typeof op !== 'string') { this.error(`Expression name must be a string, but found ${typeof op} instead. If you wanted a literal array, use ["literal", [...]].`, 0); return null; } const Expr = this.registry[op]; if (Expr) { let parsed = Expr.parse(expr, this); if (!parsed) return null; if (this.expectedType) { const expected = this.expectedType; const actual = parsed.type; // When we expect a number, string, boolean, or array but have a value, wrap it in an assertion. // When we expect a color or formatted string, but have a string or value, wrap it in a coercion. // Otherwise, we do static type-checking. // // These behaviors are overridable for: // * The "coalesce" operator, which needs to omit type annotations. // * String-valued properties (e.g. `text-field`), where coercion is more convenient than assertion. // if ((expected.kind === 'string' || expected.kind === 'number' || expected.kind === 'boolean' || expected.kind === 'object' || expected.kind === 'array') && actual.kind === 'value') { parsed = annotate(parsed, expected, options.typeAnnotation || 'assert'); } else if ((expected.kind === 'color' || expected.kind === 'formatted' || expected.kind === 'resolvedImage') && (actual.kind === 'value' || actual.kind === 'string')) { parsed = annotate(parsed, expected, options.typeAnnotation || 'coerce'); } else if (expected.kind === 'padding' && (actual.kind === 'value' || actual.kind === 'number' || actual.kind === 'array')) { parsed = annotate(parsed, expected, options.typeAnnotation || 'coerce'); } else if (expected.kind === 'variableAnchorOffsetCollection' && (actual.kind === 'value' || actual.kind === 'array')) { parsed = annotate(parsed, expected, options.typeAnnotation || 'coerce'); } else if (this.checkSubtype(expected, actual)) { return null; } } // If an expression's arguments are all literals, we can evaluate // it immediately and replace it with a literal value in the // parsed/compiled result. Expressions that expect an image should // not be resolved here so we can later get the available images. if (!(parsed instanceof Literal) && (parsed.type.kind !== 'resolvedImage') && this._isConstant(parsed)) { const ec = new EvaluationContext(); try { parsed = new Literal(parsed.type, parsed.evaluate(ec)); } catch (e) { this.error(e.message); return null; } } return parsed; } return this.error(`Unknown expression "${op}". If you wanted a literal array, use ["literal", [...]].`, 0); } else if (typeof expr === 'undefined') { return this.error('\'undefined\' value invalid. Use null instead.'); } else if (typeof expr === 'object') { return this.error('Bare objects invalid. Use ["literal", {...}] instead.'); } else { return this.error(`Expected an array, but found ${typeof expr} instead.`); } } /** * Returns a copy of this context suitable for parsing the subexpression at * index `index`, optionally appending to 'let' binding map. * * Note that `errors` property, intended for collecting errors while * parsing, is copied by reference rather than cloned. * @private */ concat(index, expectedType, bindings) { const path = typeof index === 'number' ? this.path.concat(index) : this.path; const scope = bindings ? this.scope.concat(bindings) : this.scope; return new ParsingContext(this.registry, this._isConstant, path, expectedType || null, scope, this.errors); } /** * Push a parsing (or type checking) error into the `this.errors` * @param error The message * @param keys Optionally specify the source of the error at a child * of the current expression at `this.key`. * @private */ error(error, ...keys) { const key = `${this.key}${keys.map(k => `[${k}]`).join('')}`; this.errors.push(new ExpressionParsingError(key, error)); } /** * Returns null if `t` is a subtype of `expected`; otherwise returns an * error message and also pushes it to `this.errors`. * @param expected The expected type * @param t The actual type * @returns null if `t` is a subtype of `expected`; otherwise returns an error message */ checkSubtype(expected, t) { const error = checkSubtype(expected, t); if (error) this.error(error); return error; } } class Let { constructor(bindings, result) { this.type = result.type; this.bindings = [].concat(bindings); this.result = result; } evaluate(ctx) { return this.result.evaluate(ctx); } eachChild(fn) { for (const binding of this.bindings) { fn(binding[1]); } fn(this.result); } static parse(args, context) { if (args.length < 4) return context.error(`Expected at least 3 arguments, but found ${args.length - 1} instead.`); const bindings = []; for (let i = 1; i < args.length - 1; i += 2) { const name = args[i]; if (typeof name !== 'string') { return context.error(`Expected string, but found ${typeof name} instead.`, i); } if (/[^a-zA-Z0-9_]/.test(name)) { return context.error('Variable names must contain only alphanumeric characters or \'_\'.', i); } const value = context.parse(args[i + 1], i + 1); if (!value) return null; bindings.push([name, value]); } const result = context.parse(args[args.length - 1], args.length - 1, context.expectedType, bindings); if (!result) return null; return new Let(bindings, result); } outputDefined() { return this.result.outputDefined(); } } class Var { constructor(name, boundExpression) { this.type = boundExpression.type; this.name = name; this.boundExpression = boundExpression; } static parse(args, context) { if (args.length !== 2 || typeof args[1] !== 'string') return context.error('\'var\' expression requires exactly one string literal argument.'); const name = args[1]; if (!context.scope.has(name)) { return context.error(`Unknown variable "${name}". Make sure "${name}" has been bound in an enclosing "let" expression before using it.`, 1); } return new Var(name, context.scope.get(name)); } evaluate(ctx) { return this.boundExpression.evaluate(ctx); } eachChild() { } outputDefined() { return false; } } class At { constructor(type, index, input) { this.type = type; this.index = index; this.input = input; } static parse(args, context) { if (args.length !== 3) return context.error(`Expected 2 arguments, but found ${args.length - 1} instead.`); const index = context.parse(args[1], 1, NumberType); const input = context.parse(args[2], 2, array$1(context.expectedType || ValueType)); if (!index || !input) return null; const t = input.type; return new At(t.itemType, index, input); } evaluate(ctx) { const index = this.index.evaluate(ctx); const array = this.input.evaluate(ctx); if (index < 0) { throw new RuntimeError(`Array index out of bounds: ${index} < 0.`); } if (index >= array.length) { throw new RuntimeError(`Array index out of bounds: ${index} > ${array.length - 1}.`); } if (index !== Math.floor(index)) { throw new RuntimeError(`Array index must be an integer, but found ${index} instead.`); } return array[index]; } eachChild(fn) { fn(this.index); fn(this.input); } outputDefined() { return false; } } class In { constructor(needle, haystack) { this.type = BooleanType; this.needle = needle; this.haystack = haystack; } static parse(args, context) { if (args.length !== 3) { return context.error(`Expected 2 arguments, but found ${args.length - 1} instead.`); } const needle = context.parse(args[1], 1, ValueType); const haystack = context.parse(args[2], 2, ValueType); if (!needle || !haystack) return null; if (!isValidType(needle.type, [BooleanType, StringType, NumberType, NullType, ValueType])) { return context.error(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(needle.type)} instead`); } return new In(needle, haystack); } evaluate(ctx) { const needle = this.needle.evaluate(ctx); const haystack = this.haystack.evaluate(ctx); if (!haystack) return false; if (!isValidNativeType(needle, ['boolean', 'string', 'number', 'null'])) { throw new RuntimeError(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(typeOf(needle))} instead.`); } if (!isValidNativeType(haystack, ['string', 'array'])) { throw new RuntimeError(`Expected second argument to be of type array or string, but found ${toString$1(typeOf(haystack))} instead.`); } return haystack.indexOf(needle) >= 0; } eachChild(fn) { fn(this.needle); fn(this.haystack); } outputDefined() { return true; } } class IndexOf { constructor(needle, haystack, fromIndex) { this.type = NumberType; this.needle = needle; this.haystack = haystack; this.fromIndex = fromIndex; } static parse(args, context) { if (args.length <= 2 || args.length >= 5) { return context.error(`Expected 3 or 4 arguments, but found ${args.length - 1} instead.`); } const needle = context.parse(args[1], 1, ValueType); const haystack = context.parse(args[2], 2, ValueType); if (!needle || !haystack) return null; if (!isValidType(needle.type, [BooleanType, StringType, NumberType, NullType, ValueType])) { return context.error(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(needle.type)} instead`); } if (args.length === 4) { const fromIndex = context.parse(args[3], 3, NumberType); if (!fromIndex) return null; return new IndexOf(needle, haystack, fromIndex); } else { return new IndexOf(needle, haystack); } } evaluate(ctx) { const needle = this.needle.evaluate(ctx); const haystack = this.haystack.evaluate(ctx); if (!isValidNativeType(needle, ['boolean', 'string', 'number', 'null'])) { throw new RuntimeError(`Expected first argument to be of type boolean, string, number or null, but found ${toString$1(typeOf(needle))} instead.`); } let fromIndex; if (this.fromIndex) { fromIndex = this.fromIndex.evaluate(ctx); } if (isValidNativeType(haystack, ['string'])) { const rawIndex = haystack.indexOf(needle, fromIndex); if (rawIndex === -1) { return -1; } else { // The index may be affected by surrogate pairs, so get the length of the preceding substring. return [...haystack.slice(0, rawIndex)].length; } } else if (isValidNativeType(haystack, ['array'])) { return haystack.indexOf(needle, fromIndex); } else { throw new RuntimeError(`Expected second argument to be of type array or string, but found ${toString$1(typeOf(haystack))} instead.`); } } eachChild(fn) { fn(this.needle); fn(this.haystack); if (this.fromIndex) { fn(this.fromIndex); } } outputDefined() { return false; } } class Match { constructor(inputType, outputType, input, cases, outputs, otherwise) { this.inputType = inputType; this.type = outputType; this.input = input; this.cases = cases; this.outputs = outputs; this.otherwise = otherwise; } static parse(args, context) { if (args.length < 5) return context.error(`Expected at least 4 arguments, but found only ${args.length - 1}.`); if (args.length % 2 !== 1) return context.error('Expected an even number of arguments.'); let inputType; let outputType; if (context.expectedType && context.expectedType.kind !== 'value') { outputType = context.expectedType; } const cases = {}; const outputs = []; for (let i = 2; i < args.length - 1; i += 2) { let labels = args[i]; const value = args[i + 1]; if (!Array.isArray(labels)) { labels = [labels]; } const labelContext = context.concat(i); if (labels.length === 0) { return labelContext.error('Expected at least one branch label.'); } for (const label of labels) { if (typeof label !== 'number' && typeof label !== 'string') { return labelContext.error('Branch labels must be numbers or strings.'); } else if (typeof label === 'number' && Math.abs(label) > Number.MAX_SAFE_INTEGER) { return labelContext.error(`Branch labels must be integers no larger than ${Number.MAX_SAFE_INTEGER}.`); } else if (typeof label === 'number' && Math.floor(label) !== label) { return labelContext.error('Numeric branch labels must be integer values.'); } else if (!inputType) { inputType = typeOf(label); } else if (labelContext.checkSubtype(inputType, typeOf(label))) { return null; } if (typeof cases[String(label)] !== 'undefined') { return labelContext.error('Branch labels must be unique.'); } cases[String(label)] = outputs.length; } const result = context.parse(value, i, outputType); if (!result) return null; outputType = outputType || result.type; outputs.push(result); } const input = context.parse(args[1], 1, ValueType); if (!input) return null; const otherwise = context.parse(args[args.length - 1], args.length - 1, outputType); if (!otherwise) return null; if (input.type.kind !== 'value' && context.concat(1).checkSubtype(inputType, input.type)) { return null; } return new Match(inputType, outputType, input, cases, outputs, otherwise); } evaluate(ctx) { const input = this.input.evaluate(ctx); const output = (typeOf(input) === this.inputType && this.outputs[this.cases[input]]) || this.otherwise; return output.evaluate(ctx); } eachChild(fn) { fn(this.input); this.outputs.forEach(fn); fn(this.otherwise); } outputDefined() { return this.outputs.every(out => out.outputDefined()) && this.otherwise.outputDefined(); } } class Case { constructor(type, branches, otherwise) { this.type = type; this.branches = branches; this.otherwise = otherwise; } static parse(args, context) { if (args.length < 4) return context.error(`Expected at least 3 arguments, but found only ${args.length - 1}.`); if (args.length % 2 !== 0) return context.error('Expected an odd number of arguments.'); let outputType; if (context.expectedType && context.expectedType.kind !== 'value') { outputType = context.expectedType; } const branches = []; for (let i = 1; i < args.length - 1; i += 2) { const test = context.parse(args[i], i, BooleanType); if (!test) return null; const result = context.parse(args[i + 1], i + 1, outputType); if (!result) return null; branches.push([test, result]); outputType = outputType || result.type; } const otherwise = context.parse(args[args.length - 1], args.length - 1, outputType); if (!otherwise) return null; if (!outputType) throw new Error('Can\'t infer output type'); return new Case(outputType, branches, otherwise); } evaluate(ctx) { for (const [test, expression] of this.branches) { if (test.evaluate(ctx)) { return expression.evaluate(ctx); } } return this.otherwise.evaluate(ctx); } eachChild(fn) { for (const [test, expression] of this.branches) { fn(test); fn(expression); } fn(this.otherwise); } outputDefined() { return this.branches.every(([_, out]) => out.outputDefined()) && this.otherwise.outputDefined(); } } class Slice { constructor(type, input, beginIndex, endIndex) { this.type = type; this.input = input; this.beginIndex = beginIndex; this.endIndex = endIndex; } static parse(args, context) { if (args.length <= 2 || args.length >= 5) { return context.error(`Expected 3 or 4 arguments, but found ${args.length - 1} instead.`); } const input = context.parse(args[1], 1, ValueType); const beginIndex = context.parse(args[2], 2, NumberType); if (!input || !beginIndex) return null; if (!isValidType(input.type, [array$1(ValueType), StringType, ValueType])) { return context.error(`Expected first argument to be of type array or string, but found ${toString$1(input.type)} instead`); } if (args.length === 4) { const endIndex = context.parse(args[3], 3, NumberType); if (!endIndex) return null; return new Slice(input.type, input, beginIndex, endIndex); } else { return new Slice(input.type, input, beginIndex); } } evaluate(ctx) { const input = this.input.evaluate(ctx); const beginIndex = this.beginIndex.evaluate(ctx); let endIndex; if (this.endIndex) { endIndex = this.endIndex.evaluate(ctx); } if (isValidNativeType(input, ['string'])) { // Indices may be affected by surrogate pairs. return [...input].slice(beginIndex, endIndex).join(''); } else if (isValidNativeType(input, ['array'])) { return input.slice(beginIndex, endIndex); } else { throw new RuntimeError(`Expected first argument to be of type array or string, but found ${toString$1(typeOf(input))} instead.`); } } eachChild(fn) { fn(this.input); fn(this.beginIndex); if (this.endIndex) { fn(this.endIndex); } } outputDefined() { return false; } } /** * Returns the index of the last stop <= input, or 0 if it doesn't exist. * @private */ function findStopLessThanOrEqualTo(stops, input) { const lastIndex = stops.length - 1; let lowerIndex = 0; let upperIndex = lastIndex; let currentIndex = 0; let currentValue, nextValue; while (lowerIndex <= upperIndex) { currentIndex = Math.floor((lowerIndex + upperIndex) / 2); currentValue = stops[currentIndex]; nextValue = stops[currentIndex + 1]; if (currentValue <= input) { if (currentIndex === lastIndex || input < nextValue) { // Search complete return currentIndex; } lowerIndex = currentIndex + 1; } else if (currentValue > input) { upperIndex = currentIndex - 1; } else { throw new RuntimeError('Input is not a number.'); } } return 0; } class Step { constructor(type, input, stops) { this.type = type; this.input = input; this.labels = []; this.outputs = []; for (const [label, expression] of stops) { this.labels.push(label); this.outputs.push(expression); } } static parse(args, context) { if (args.length - 1 < 4) { return context.error(`Expected at least 4 arguments, but found only ${args.length - 1}.`); } if ((args.length - 1) % 2 !== 0) { return context.error('Expected an even number of arguments.'); } const input = context.parse(args[1], 1, NumberType); if (!input) return null; const stops = []; let outputType = null; if (context.expectedType && context.expectedType.kind !== 'value') { outputType = context.expectedType; } for (let i = 1; i < args.length; i += 2) { const label = i === 1 ? -Infinity : args[i]; const value = args[i + 1]; const labelKey = i; const valueKey = i + 1; if (typeof label !== 'number') { return context.error('Input/output pairs for "step" expressions must be defined using literal numeric values (not computed expressions) for the input values.', labelKey); } if (stops.length && stops[stops.length - 1][0] >= label) { return context.error('Input/output pairs for "step" expressions must be arranged with input values in strictly ascending order.', labelKey); } const parsed = context.parse(value, valueKey, outputType); if (!parsed) return null; outputType = outputType || parsed.type; stops.push([label, parsed]); } return new Step(outputType, input, stops); } evaluate(ctx) { const labels = this.labels; const outputs = this.outputs; if (labels.length === 1) { return outputs[0].evaluate(ctx); } const value = this.input.evaluate(ctx); if (value <= labels[0]) { return outputs[0].evaluate(ctx); } const stopCount = labels.length; if (value >= labels[stopCount - 1]) { return outputs[stopCount - 1].evaluate(ctx); } const index = findStopLessThanOrEqualTo(labels, value); return outputs[index].evaluate(ctx); } eachChild(fn) { fn(this.input); for (const expression of this.outputs) { fn(expression); } } outputDefined() { return this.outputs.every(out => out.outputDefined()); } } function getDefaultExportFromCjs (x) { return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x; } var unitbezier = UnitBezier; function UnitBezier(p1x, p1y, p2x, p2y) { // Calculate the polynomial coefficients, implicit first and last control points are (0,0) and (1,1). this.cx = 3.0 * p1x; this.bx = 3.0 * (p2x - p1x) - this.cx; this.ax = 1.0 - this.cx - this.bx; this.cy = 3.0 * p1y; this.by = 3.0 * (p2y - p1y) - this.cy; this.ay = 1.0 - this.cy - this.by; this.p1x = p1x; this.p1y = p1y; this.p2x = p2x; this.p2y = p2y; } UnitBezier.prototype = { sampleCurveX: function (t) { // `ax t^3 + bx t^2 + cx t' expanded using Horner's rule. return ((this.ax * t + this.bx) * t + this.cx) * t; }, sampleCurveY: function (t) { return ((this.ay * t + this.by) * t + this.cy) * t; }, sampleCurveDerivativeX: function (t) { return (3.0 * this.ax * t + 2.0 * this.bx) * t + this.cx; }, solveCurveX: function (x, epsilon) { if (epsilon === undefined) epsilon = 1e-6; if (x < 0.0) return 0.0; if (x > 1.0) return 1.0; var t = x; // First try a few iterations of Newton's method - normally very fast. for (var i = 0; i < 8; i++) { var x2 = this.sampleCurveX(t) - x; if (Math.abs(x2) < epsilon) return t; var d2 = this.sampleCurveDerivativeX(t); if (Math.abs(d2) < 1e-6) break; t = t - x2 / d2; } // Fall back to the bisection method for reliability. var t0 = 0.0; var t1 = 1.0; t = x; for (i = 0; i < 20; i++) { x2 = this.sampleCurveX(t); if (Math.abs(x2 - x) < epsilon) break; if (x > x2) { t0 = t; } else { t1 = t; } t = (t1 - t0) * 0.5 + t0; } return t; }, solve: function (x, epsilon) { return this.sampleCurveY(this.solveCurveX(x, epsilon)); } }; var UnitBezier$1 = /*@__PURE__*/getDefaultExportFromCjs(unitbezier); /** * Checks whether the specified color space is one of the supported interpolation color spaces. * * @param colorSpace Color space key to verify. * @returns `true` if the specified color space is one of the supported * interpolation color spaces, `false` otherwise */ function isSupportedInterpolationColorSpace(colorSpace) { return colorSpace === 'rgb' || colorSpace === 'hcl' || colorSpace === 'lab'; } /** * @param interpolationType Interpolation type * @returns interpolation fn * @deprecated use `interpolate[type]` instead */ const interpolateFactory = (interpolationType) => { switch (interpolationType) { case 'number': return number; case 'color': return color; case 'array': return array; case 'padding': return padding$1; case 'variableAnchorOffsetCollection': return variableAnchorOffsetCollection; } }; function number(from, to, t) { return from + t * (to - from); } function color(from, to, t, spaceKey = 'rgb') { switch (spaceKey) { case 'rgb': { const [r, g, b, alpha] = array(from.rgb, to.rgb, t); return new Color(r, g, b, alpha, false); } case 'hcl': { const [hue0, chroma0, light0, alphaF] = from.hcl; const [hue1, chroma1, light1, alphaT] = to.hcl; // https://github.com/gka/chroma.js/blob/cd1b3c0926c7a85cbdc3b1453b3a94006de91a92/src/interpolator/_hsx.js let hue, chroma; if (!isNaN(hue0) && !isNaN(hue1)) { let dh = hue1 - hue0; if (hue1 > hue0 && dh > 180) { dh -= 360; } else if (hue1 < hue0 && hue0 - hue1 > 180) { dh += 360; } hue = hue0 + t * dh; } else if (!isNaN(hue0)) { hue = hue0; if (light1 === 1 || light1 === 0) chroma = chroma0; } else if (!isNaN(hue1)) { hue = hue1; if (light0 === 1 || light0 === 0) chroma = chroma1; } else { hue = NaN; } const [r, g, b, alpha] = hclToRgb([ hue, chroma !== null && chroma !== void 0 ? chroma : number(chroma0, chroma1, t), number(light0, light1, t), number(alphaF, alphaT, t), ]); return new Color(r, g, b, alpha, false); } case 'lab': { const [r, g, b, alpha] = labToRgb(array(from.lab, to.lab, t)); return new Color(r, g, b, alpha, false); } } } function array(from, to, t) { return from.map((d, i) => { return number(d, to[i], t); }); } function padding$1(from, to, t) { return new Padding(array(from.values, to.values, t)); } function variableAnchorOffsetCollection(from, to, t) { const fromValues = from.values; const toValues = to.values; if (fromValues.length !== toValues.length) { throw new RuntimeError(`Cannot interpolate values of different length. from: ${from.toString()}, to: ${to.toString()}`); } const output = []; for (let i = 0; i < fromValues.length; i += 2) { // Anchor entries must match if (fromValues[i] !== toValues[i]) { throw new RuntimeError(`Cannot interpolate values containing mismatched anchors. from[${i}]: ${fromValues[i]}, to[${i}]: ${toValues[i]}`); } output.push(fromValues[i]); // Interpolate the offset values for each anchor const [fx, fy] = fromValues[i + 1]; const [tx, ty] = toValues[i + 1]; output.push([number(fx, tx, t), number(fy, ty, t)]); } return new VariableAnchorOffsetCollection(output); } const interpolate = { number, color, array, padding: padding$1, variableAnchorOffsetCollection }; class Interpolate { constructor(type, operator, interpolation, input, stops) { this.type = type; this.operator = operator; this.interpolation = interpolation; this.input = input; this.labels = []; this.outputs = []; for (const [label, expression] of stops) { this.labels.push(label); this.outputs.push(expression); } } static interpolationFactor(interpolation, input, lower, upper) { let t = 0; if (interpolation.name === 'exponential') { t = exponentialInterpolation(input, interpolation.base, lower, upper); } else if (interpolation.name === 'linear') { t = exponentialInterpolation(input, 1, lower, upper); } else if (interpolation.name === 'cubic-bezier') { const c = interpolation.controlPoints; const ub = new UnitBezier$1(c[0], c[1], c[2], c[3]); t = ub.solve(exponentialInterpolation(input, 1, lower, upper)); } return t; } static parse(args, context) { let [operator, interpolation, input, ...rest] = args; if (!Array.isArray(interpolation) || interpolation.length === 0) { return context.error('Expected an interpolation type expression.', 1); } if (interpolation[0] === 'linear') { interpolation = { name: 'linear' }; } else if (interpolation[0] === 'exponential') { const base = interpolation[1]; if (typeof base !== 'number') return context.error('Exponential interpolation requires a numeric base.', 1, 1); interpolation = { name: 'exponential', base }; } else if (interpolation[0] === 'cubic-bezier') { const controlPoints = interpolation.slice(1); if (controlPoints.length !== 4 || controlPoints.some(t => typeof t !== 'number' || t < 0 || t > 1)) { return context.error('Cubic bezier interpolation requires four numeric arguments with values between 0 and 1.', 1); } interpolation = { name: 'cubic-bezier', controlPoints: controlPoints }; } else { return context.error(`Unknown interpolation type ${String(interpolation[0])}`, 1, 0); } if (args.length - 1 < 4) { return context.error(`Expected at least 4 arguments, but found only ${args.length - 1}.`); } if ((args.length - 1) % 2 !== 0) { return context.error('Expected an even number of arguments.'); } input = context.parse(input, 2, NumberType); if (!input) return null; const stops = []; let outputType = null; if (operator === 'interpolate-hcl' || operator === 'interpolate-lab') { outputType = ColorType; } else if (context.expectedType && context.expectedType.kind !== 'value') { outputType = context.expectedType; } for (let i = 0; i < rest.length; i += 2) { const label = rest[i]; const value = rest[i + 1]; const labelKey = i + 3; const valueKey = i + 4; if (typeof label !== 'number') { return context.error('Input/output pairs for "interpolate" expressions must be defined using literal numeric values (not computed expressions) for the input values.', labelKey); } if (stops.length && stops[stops.length - 1][0] >= label) { return context.error('Input/output pairs for "interpolate" expressions must be arranged with input values in strictly ascending order.', labelKey); } const parsed = context.parse(value, valueKey, outputType); if (!parsed) return null; outputType = outputType || parsed.type; stops.push([label, parsed]); } if (!verifyType(outputType, NumberType) && !verifyType(outputType, ColorType) && !verifyType(outputType, PaddingType) && !verifyType(outputType, VariableAnchorOffsetCollectionType) && !verifyType(outputType, array$1(NumberType))) { return context.error(`Type ${toString$1(outputType)} is not interpolatable.`); } return new Interpolate(outputType, operator, interpolation, input, stops); } evaluate(ctx) { const labels = this.labels; const outputs = this.outputs; if (labels.length === 1) { return outputs[0].evaluate(ctx); } const value = this.input.evaluate(ctx); if (value <= labels[0]) { return outputs[0].evaluate(ctx); } const stopCount = labels.length; if (value >= labels[stopCount - 1]) { return outputs[stopCount - 1].evaluate(ctx); } const index = findStopLessThanOrEqualTo(labels, value); const lower = labels[index]; const upper = labels[index + 1]; const t = Interpolate.interpolationFactor(this.interpolation, value, lower, upper); const outputLower = outputs[index].evaluate(ctx); const outputUpper = outputs[index + 1].evaluate(ctx); switch (this.operator) { case 'interpolate': return interpolate[this.type.kind](outputLower, outputUpper, t); case 'interpolate-hcl': return interpolate.color(outputLower, outputUpper, t, 'hcl'); case 'interpolate-lab': return interpolate.color(outputLower, outputUpper, t, 'lab'); } } eachChild(fn) { fn(this.input); for (const expression of this.outputs) { fn(expression); } } outputDefined() { return this.outputs.every(out => out.outputDefined()); } } /** * Returns a ratio that can be used to interpolate between exponential function * stops. * How it works: Two consecutive stop values define a (scaled and shifted) exponential function `f(x) = a * base^x + b`, where `base` is the user-specified base, * and `a` and `b` are constants affording sufficient degrees of freedom to fit * the function to the given stops. * * Here's a bit of algebra that lets us compute `f(x)` directly from the stop * values without explicitly solving for `a` and `b`: * * First stop value: `f(x0) = y0 = a * base^x0 + b` * Second stop value: `f(x1) = y1 = a * base^x1 + b` * => `y1 - y0 = a(base^x1 - base^x0)` * => `a = (y1 - y0)/(base^x1 - base^x0)` * * Desired value: `f(x) = y = a * base^x + b` * => `f(x) = y0 + a * (base^x - base^x0)` * * From the above, we can replace the `a` in `a * (base^x - base^x0)` and do a * little algebra: * ``` * a * (base^x - base^x0) = (y1 - y0)/(base^x1 - base^x0) * (base^x - base^x0) * = (y1 - y0) * (base^x - base^x0) / (base^x1 - base^x0) * ``` * * If we let `(base^x - base^x0) / (base^x1 base^x0)`, then we have * `f(x) = y0 + (y1 - y0) * ratio`. In other words, `ratio` may be treated as * an interpolation factor between the two stops' output values. * * (Note: a slightly different form for `ratio`, * `(base^(x-x0) - 1) / (base^(x1-x0) - 1) `, is equivalent, but requires fewer * expensive `Math.pow()` operations.) * * @private */ function exponentialInterpolation(input, base, lowerValue, upperValue) { const difference = upperValue - lowerValue; const progress = input - lowerValue; if (difference === 0) { return 0; } else if (base === 1) { return progress / difference; } else { return (Math.pow(base, progress) - 1) / (Math.pow(base, difference) - 1); } } class Coalesce { constructor(type, args) { this.type = type; this.args = args; } static parse(args, context) { if (args.length < 2) { return context.error('Expectected at least one argument.'); } let outputType = null; const expectedType = context.expectedType; if (expectedType && expectedType.kind !== 'value') { outputType = expectedType; } const parsedArgs = []; for (const arg of args.slice(1)) { const parsed = context.parse(arg, 1 + parsedArgs.length, outputType, undefined, { typeAnnotation: 'omit' }); if (!parsed) return null; outputType = outputType || parsed.type; parsedArgs.push(parsed); } if (!outputType) throw new Error('No output type'); // Above, we parse arguments without inferred type annotation so that // they don't produce a runtime error for `null` input, which would // preempt the desired null-coalescing behavior. // Thus, if any of our arguments would have needed an annotation, we // need to wrap the enclosing coalesce expression with it instead. const needsAnnotation = expectedType && parsedArgs.some(arg => checkSubtype(expectedType, arg.type)); return needsAnnotation ? new Coalesce(ValueType, parsedArgs) : new Coalesce(outputType, parsedArgs); } evaluate(ctx) { let result = null; let argCount = 0; let requestedImageName; for (const arg of this.args) { argCount++; result = arg.evaluate(ctx); // we need to keep track of the first requested image in a coalesce statement // if coalesce can't find a valid image, we return the first image name so styleimagemissing can fire if (result && result instanceof ResolvedImage && !result.available) { if (!requestedImageName) { requestedImageName = result.name; } result = null; if (argCount === this.args.length) { result = requestedImageName; } } if (result !== null) break; } return result; } eachChild(fn) { this.args.forEach(fn); } outputDefined() { return this.args.every(arg => arg.outputDefined()); } } function isComparableType(op, type) { if (op === '==' || op === '!=') { // equality operator return type.kind === 'boolean' || type.kind === 'string' || type.kind === 'number' || type.kind === 'null' || type.kind === 'value'; } else { // ordering operator return type.kind === 'string' || type.kind === 'number' || type.kind === 'value'; } } function eq(ctx, a, b) { return a === b; } function neq(ctx, a, b) { return a !== b; } function lt(ctx, a, b) { return a < b; } function gt(ctx, a, b) { return a > b; } function lteq(ctx, a, b) { return a <= b; } function gteq(ctx, a, b) { return a >= b; } function eqCollate(ctx, a, b, c) { return c.compare(a, b) === 0; } function neqCollate(ctx, a, b, c) { return !eqCollate(ctx, a, b, c); } function ltCollate(ctx, a, b, c) { return c.compare(a, b) < 0; } function gtCollate(ctx, a, b, c) { return c.compare(a, b) > 0; } function lteqCollate(ctx, a, b, c) { return c.compare(a, b) <= 0; } function gteqCollate(ctx, a, b, c) { return c.compare(a, b) >= 0; } /** * Special form for comparison operators, implementing the signatures: * - (T, T, ?Collator) => boolean * - (T, value, ?Collator) => boolean * - (value, T, ?Collator) => boolean * * For inequalities, T must be either value, string, or number. For ==/!=, it * can also be boolean or null. * * Equality semantics are equivalent to Javascript's strict equality (===/!==) * -- i.e., when the arguments' types don't match, == evaluates to false, != to * true. * * When types don't match in an ordering comparison, a runtime error is thrown. * * @private */ function makeComparison(op, compareBasic, compareWithCollator) { const isOrderComparison = op !== '==' && op !== '!='; return class Comparison { constructor(lhs, rhs, collator) { this.type = BooleanType; this.lhs = lhs; this.rhs = rhs; this.collator = collator; this.hasUntypedArgument = lhs.type.kind === 'value' || rhs.type.kind === 'value'; } static parse(args, context) { if (args.length !== 3 && args.length !== 4) return context.error('Expected two or three arguments.'); const op = args[0]; let lhs = context.parse(args[1], 1, ValueType); if (!lhs) return null; if (!isComparableType(op, lhs.type)) { return context.concat(1).error(`"${op}" comparisons are not supported for type '${toString$1(lhs.type)}'.`); } let rhs = context.parse(args[2], 2, ValueType); if (!rhs) return null; if (!isComparableType(op, rhs.type)) { return context.concat(2).error(`"${op}" comparisons are not supported for type '${toString$1(rhs.type)}'.`); } if (lhs.type.kind !== rhs.type.kind && lhs.type.kind !== 'value' && rhs.type.kind !== 'value') { return context.error(`Cannot compare types '${toString$1(lhs.type)}' and '${toString$1(rhs.type)}'.`); } if (isOrderComparison) { // typing rules specific to less/greater than operators if (lhs.type.kind === 'value' && rhs.type.kind !== 'value') { // (value, T) lhs = new Assertion(rhs.type, [lhs]); } else if (lhs.type.kind !== 'value' && rhs.type.kind === 'value') { // (T, value) rhs = new Assertion(lhs.type, [rhs]); } } let collator = null; if (args.length === 4) { if (lhs.type.kind !== 'string' && rhs.type.kind !== 'string' && lhs.type.kind !== 'value' && rhs.type.kind !== 'value') { return context.error('Cannot use collator to compare non-string types.'); } collator = context.parse(args[3], 3, CollatorType); if (!collator) return null; } return new Comparison(lhs, rhs, collator); } evaluate(ctx) { const lhs = this.lhs.evaluate(ctx); const rhs = this.rhs.evaluate(ctx); if (isOrderComparison && this.hasUntypedArgument) { const lt = typeOf(lhs); const rt = typeOf(rhs); // check that type is string or number, and equal if (lt.kind !== rt.kind || !(lt.kind === 'string' || lt.kind === 'number')) { throw new RuntimeError(`Expected arguments for "${op}" to be (string, string) or (number, number), but found (${lt.kind}, ${rt.kind}) instead.`); } } if (this.collator && !isOrderComparison && this.hasUntypedArgument) { const lt = typeOf(lhs); const rt = typeOf(rhs); if (lt.kind !== 'string' || rt.kind !== 'string') { return compareBasic(ctx, lhs, rhs); } } return this.collator ? compareWithCollator(ctx, lhs, rhs, this.collator.evaluate(ctx)) : compareBasic(ctx, lhs, rhs); } eachChild(fn) { fn(this.lhs); fn(this.rhs); if (this.collator) { fn(this.collator); } } outputDefined() { return true; } }; } const Equals = makeComparison('==', eq, eqCollate); const NotEquals = makeComparison('!=', neq, neqCollate); const LessThan = makeComparison('<', lt, ltCollate); const GreaterThan = makeComparison('>', gt, gtCollate); const LessThanOrEqual = makeComparison('<=', lteq, lteqCollate); const GreaterThanOrEqual = makeComparison('>=', gteq, gteqCollate); class CollatorExpression { constructor(caseSensitive, diacriticSensitive, locale) { this.type = CollatorType; this.locale = locale; this.caseSensitive = caseSensitive; this.diacriticSensitive = diacriticSensitive; } static parse(args, context) { if (args.length !== 2) return context.error('Expected one argument.'); const options = args[1]; if (typeof options !== 'object' || Array.isArray(options)) return context.error('Collator options argument must be an object.'); const caseSensitive = context.parse(options['case-sensitive'] === undefined ? false : options['case-sensitive'], 1, BooleanType); if (!caseSensitive) return null; const diacriticSensitive = context.parse(options['diacritic-sensitive'] === undefined ? false : options['diacritic-sensitive'], 1, BooleanType); if (!diacriticSensitive) return null; let locale = null; if (options['locale']) { locale = context.parse(options['locale'], 1, StringType); if (!locale) return null; } return new CollatorExpression(caseSensitive, diacriticSensitive, locale); } evaluate(ctx) { return new Collator(this.caseSensitive.evaluate(ctx), this.diacriticSensitive.evaluate(ctx), this.locale ? this.locale.evaluate(ctx) : null); } eachChild(fn) { fn(this.caseSensitive); fn(this.diacriticSensitive); if (this.locale) { fn(this.locale); } } outputDefined() { // Technically the set of possible outputs is the combinatoric set of Collators produced // by all possible outputs of locale/caseSensitive/diacriticSensitive // But for the primary use of Collators in comparison operators, we ignore the Collator's // possible outputs anyway, so we can get away with leaving this false for now. return false; } } class NumberFormat { constructor(number, locale, currency, minFractionDigits, maxFractionDigits) { this.type = StringType; this.number = number; this.locale = locale; this.currency = currency; this.minFractionDigits = minFractionDigits; this.maxFractionDigits = maxFractionDigits; } static parse(args, context) { if (args.length !== 3) return context.error('Expected two arguments.'); const number = context.parse(args[1], 1, NumberType); if (!number) return null; const options = args[2]; if (typeof options !== 'object' || Array.isArray(options)) return context.error('NumberFormat options argument must be an object.'); let locale = null; if (options['locale']) { locale = context.parse(options['locale'], 1, StringType); if (!locale) return null; } let currency = null; if (options['currency']) { currency = context.parse(options['currency'], 1, StringType); if (!currency) return null; } let minFractionDigits = null; if (options['min-fraction-digits']) { minFractionDigits = context.parse(options['min-fraction-digits'], 1, NumberType); if (!minFractionDigits) return null; } let maxFractionDigits = null; if (options['max-fraction-digits']) { maxFractionDigits = context.parse(options['max-fraction-digits'], 1, NumberType); if (!maxFractionDigits) return null; } return new NumberFormat(number, locale, currency, minFractionDigits, maxFractionDigits); } evaluate(ctx) { return new Intl.NumberFormat(this.locale ? this.locale.evaluate(ctx) : [], { style: this.currency ? 'currency' : 'decimal', currency: this.currency ? this.currency.evaluate(ctx) : undefined, minimumFractionDigits: this.minFractionDigits ? this.minFractionDigits.evaluate(ctx) : undefined, maximumFractionDigits: this.maxFractionDigits ? this.maxFractionDigits.evaluate(ctx) : undefined, }).format(this.number.evaluate(ctx)); } eachChild(fn) { fn(this.number); if (this.locale) { fn(this.locale); } if (this.currency) { fn(this.currency); } if (this.minFractionDigits) { fn(this.minFractionDigits); } if (this.maxFractionDigits) { fn(this.maxFractionDigits); } } outputDefined() { return false; } } class FormatExpression { constructor(sections) { this.type = FormattedType; this.sections = sections; } static parse(args, context) { if (args.length < 2) { return context.error('Expected at least one argument.'); } const firstArg = args[1]; if (!Array.isArray(firstArg) && typeof firstArg === 'object') { return context.error('First argument must be an image or text section.'); } const sections = []; let nextTokenMayBeObject = false; for (let i = 1; i <= args.length - 1; ++i) { const arg = args[i]; if (nextTokenMayBeObject && typeof arg === 'object' && !Array.isArray(arg)) { nextTokenMayBeObject = false; let scale = null; if (arg['font-scale']) { scale = context.parse(arg['font-scale'], 1, NumberType); if (!scale) return null; } let font = null; if (arg['text-font']) { font = context.parse(arg['text-font'], 1, array$1(StringType)); if (!font) return null; } let textColor = null; if (arg['text-color']) { textColor = context.parse(arg['text-color'], 1, ColorType); if (!textColor) return null; } const lastExpression = sections[sections.length - 1]; lastExpression.scale = scale; lastExpression.font = font; lastExpression.textColor = textColor; } else { const content = context.parse(args[i], 1, ValueType); if (!content) return null; const kind = content.type.kind; if (kind !== 'string' && kind !== 'value' && kind !== 'null' && kind !== 'resolvedImage') return context.error('Formatted text type must be \'string\', \'value\', \'image\' or \'null\'.'); nextTokenMayBeObject = true; sections.push({ content, scale: null, font: null, textColor: null }); } } return new FormatExpression(sections); } evaluate(ctx) { const evaluateSection = section => { const evaluatedContent = section.content.evaluate(ctx); if (typeOf(evaluatedContent) === ResolvedImageType) { return new FormattedSection('', evaluatedContent, null, null, null); } return new FormattedSection(toString(evaluatedContent), null, section.scale ? section.scale.evaluate(ctx) : null, section.font ? section.font.evaluate(ctx).join(',') : null, section.textColor ? section.textColor.evaluate(ctx) : null); }; return new Formatted(this.sections.map(evaluateSection)); } eachChild(fn) { for (const section of this.sections) { fn(section.content); if (section.scale) { fn(section.scale); } if (section.font) { fn(section.font); } if (section.textColor) { fn(section.textColor); } } } outputDefined() { // Technically the combinatoric set of all children // Usually, this.text will be undefined anyway return false; } } class ImageExpression { constructor(input) { this.type = ResolvedImageType; this.input = input; } static parse(args, context) { if (args.length !== 2) { return context.error('Expected two arguments.'); } const name = context.parse(args[1], 1, StringType); if (!name) return context.error('No image name provided.'); return new ImageExpression(name); } evaluate(ctx) { const evaluatedImageName = this.input.evaluate(ctx); const value = ResolvedImage.fromString(evaluatedImageName); if (value && ctx.availableImages) value.available = ctx.availableImages.indexOf(evaluatedImageName) > -1; return value; } eachChild(fn) { fn(this.input); } outputDefined() { // The output of image is determined by the list of available images in the evaluation context return false; } } class Length { constructor(input) { this.type = NumberType; this.input = input; } static parse(args, context) { if (args.length !== 2) return context.error(`Expected 1 argument, but found ${args.length - 1} instead.`); const input = context.parse(args[1], 1); if (!input) return null; if (input.type.kind !== 'array' && input.type.kind !== 'string' && input.type.kind !== 'value') return context.error(`Expected argument of type string or array, but found ${toString$1(input.type)} instead.`); return new Length(input); } evaluate(ctx) { const input = this.input.evaluate(ctx); if (typeof input === 'string') { // The length may be affected by surrogate pairs. return [...input].length; } else if (Array.isArray(input)) { return input.length; } else { throw new RuntimeError(`Expected value to be of type string or array, but found ${toString$1(typeOf(input))} instead.`); } } eachChild(fn) { fn(this.input); } outputDefined() { return false; } } const EXTENT$1 = 8192; function getTileCoordinates(p, canonical) { const x = mercatorXfromLng$1(p[0]); const y = mercatorYfromLat$1(p[1]); const tilesAtZoom = Math.pow(2, canonical.z); return [Math.round(x * tilesAtZoom * EXTENT$1), Math.round(y * tilesAtZoom * EXTENT$1)]; } function getLngLatFromTileCoord(coord, canonical) { const tilesAtZoom = Math.pow(2, canonical.z); const x = (coord[0] / EXTENT$1 + canonical.x) / tilesAtZoom; const y = (coord[1] / EXTENT$1 + canonical.y) / tilesAtZoom; return [lngFromMercatorXfromLng(x), latFromMercatorY$1(y)]; } function mercatorXfromLng$1(lng) { return (180 + lng) / 360; } function lngFromMercatorXfromLng(mercatorX) { return mercatorX * 360 - 180; } function mercatorYfromLat$1(lat) { return (180 - (180 / Math.PI * Math.log(Math.tan(Math.PI / 4 + lat * Math.PI / 360)))) / 360; } function latFromMercatorY$1(mercatorY) { return 360 / Math.PI * Math.atan(Math.exp((180 - mercatorY * 360) * Math.PI / 180)) - 90; } function updateBBox(bbox, coord) { bbox[0] = Math.min(bbox[0], coord[0]); bbox[1] = Math.min(bbox[1], coord[1]); bbox[2] = Math.max(bbox[2], coord[0]); bbox[3] = Math.max(bbox[3], coord[1]); } function boxWithinBox(bbox1, bbox2) { if (bbox1[0] <= bbox2[0]) return false; if (bbox1[2] >= bbox2[2]) return false; if (bbox1[1] <= bbox2[1]) return false; if (bbox1[3] >= bbox2[3]) return false; return true; } function rayIntersect(p, p1, p2) { return ((p1[1] > p[1]) !== (p2[1] > p[1])) && (p[0] < (p2[0] - p1[0]) * (p[1] - p1[1]) / (p2[1] - p1[1]) + p1[0]); } function pointOnBoundary(p, p1, p2) { const x1 = p[0] - p1[0]; const y1 = p[1] - p1[1]; const x2 = p[0] - p2[0]; const y2 = p[1] - p2[1]; return (x1 * y2 - x2 * y1 === 0) && (x1 * x2 <= 0) && (y1 * y2 <= 0); } // a, b are end points for line segment1, c and d are end points for line segment2 function segmentIntersectSegment(a, b, c, d) { // check if two segments are parallel or not // precondition is end point a, b is inside polygon, if line a->b is // parallel to polygon edge c->d, then a->b won't intersect with c->d const vectorP = [b[0] - a[0], b[1] - a[1]]; const vectorQ = [d[0] - c[0], d[1] - c[1]]; if (perp(vectorQ, vectorP) === 0) return false; // If lines are intersecting with each other, the relative location should be: // a and b lie in different sides of segment c->d // c and d lie in different sides of segment a->b if (twoSided(a, b, c, d) && twoSided(c, d, a, b)) return true; return false; } function lineIntersectPolygon(p1, p2, polygon) { for (const ring of polygon) { // loop through every edge of the ring for (let j = 0; j < ring.length - 1; ++j) { if (segmentIntersectSegment(p1, p2, ring[j], ring[j + 1])) { return true; } } } return false; } // ray casting algorithm for detecting if point is in polygon function pointWithinPolygon(point, rings, trueIfOnBoundary = false) { let inside = false; for (const ring of rings) { for (let j = 0; j < ring.length - 1; j++) { if (pointOnBoundary(point, ring[j], ring[j + 1])) return trueIfOnBoundary; if (rayIntersect(point, ring[j], ring[j + 1])) inside = !inside; } } return inside; } function pointWithinPolygons(point, polygons) { for (const polygon of polygons) { if (pointWithinPolygon(point, polygon)) return true; } return false; } function lineStringWithinPolygon(line, polygon) { // First, check if geometry points of line segments are all inside polygon for (const point of line) { if (!pointWithinPolygon(point, polygon)) { return false; } } // Second, check if there is line segment intersecting polygon edge for (let i = 0; i < line.length - 1; ++i) { if (lineIntersectPolygon(line[i], line[i + 1], polygon)) { return false; } } return true; } function lineStringWithinPolygons(line, polygons) { for (const polygon of polygons) { if (lineStringWithinPolygon(line, polygon)) return true; } return false; } function perp(v1, v2) { return (v1[0] * v2[1] - v1[1] * v2[0]); } // check if p1 and p2 are in different sides of line segment q1->q2 function twoSided(p1, p2, q1, q2) { // q1->p1 (x1, y1), q1->p2 (x2, y2), q1->q2 (x3, y3) const x1 = p1[0] - q1[0]; const y1 = p1[1] - q1[1]; const x2 = p2[0] - q1[0]; const y2 = p2[1] - q1[1]; const x3 = q2[0] - q1[0]; const y3 = q2[1] - q1[1]; const det1 = (x1 * y3 - x3 * y1); const det2 = (x2 * y3 - x3 * y2); if ((det1 > 0 && det2 < 0) || (det1 < 0 && det2 > 0)) return true; return false; } function getTilePolygon(coordinates, bbox, canonical) { const polygon = []; for (let i = 0; i < coordinates.length; i++) { const ring = []; for (let j = 0; j < coordinates[i].length; j++) { const coord = getTileCoordinates(coordinates[i][j], canonical); updateBBox(bbox, coord); ring.push(coord); } polygon.push(ring); } return polygon; } function getTilePolygons(coordinates, bbox, canonical) { const polygons = []; for (let i = 0; i < coordinates.length; i++) { const polygon = getTilePolygon(coordinates[i], bbox, canonical); polygons.push(polygon); } return polygons; } function updatePoint(p, bbox, polyBBox, worldSize) { if (p[0] < polyBBox[0] || p[0] > polyBBox[2]) { const halfWorldSize = worldSize * 0.5; let shift = (p[0] - polyBBox[0] > halfWorldSize) ? -worldSize : (polyBBox[0] - p[0] > halfWorldSize) ? worldSize : 0; if (shift === 0) { shift = (p[0] - polyBBox[2] > halfWorldSize) ? -worldSize : (polyBBox[2] - p[0] > halfWorldSize) ? worldSize : 0; } p[0] += shift; } updateBBox(bbox, p); } function resetBBox(bbox) { bbox[0] = bbox[1] = Infinity; bbox[2] = bbox[3] = -Infinity; } function getTilePoints(geometry, pointBBox, polyBBox, canonical) { const worldSize = Math.pow(2, canonical.z) * EXTENT$1; const shifts = [canonical.x * EXTENT$1, canonical.y * EXTENT$1]; const tilePoints = []; for (const points of geometry) { for (const point of points) { const p = [point.x + shifts[0], point.y + shifts[1]]; updatePoint(p, pointBBox, polyBBox, worldSize); tilePoints.push(p); } } return tilePoints; } function getTileLines(geometry, lineBBox, polyBBox, canonical) { const worldSize = Math.pow(2, canonical.z) * EXTENT$1; const shifts = [canonical.x * EXTENT$1, canonical.y * EXTENT$1]; const tileLines = []; for (const line of geometry) { const tileLine = []; for (const point of line) { const p = [point.x + shifts[0], point.y + shifts[1]]; updateBBox(lineBBox, p); tileLine.push(p); } tileLines.push(tileLine); } if (lineBBox[2] - lineBBox[0] <= worldSize / 2) { resetBBox(lineBBox); for (const line of tileLines) { for (const p of line) { updatePoint(p, lineBBox, polyBBox, worldSize); } } } return tileLines; } function pointsWithinPolygons(ctx, polygonGeometry) { const pointBBox = [Infinity, Infinity, -Infinity, -Infinity]; const polyBBox = [Infinity, Infinity, -Infinity, -Infinity]; const canonical = ctx.canonicalID(); if (polygonGeometry.type === 'Polygon') { const tilePolygon = getTilePolygon(polygonGeometry.coordinates, polyBBox, canonical); const tilePoints = getTilePoints(ctx.geometry(), pointBBox, polyBBox, canonical); if (!boxWithinBox(pointBBox, polyBBox)) return false; for (const point of tilePoints) { if (!pointWithinPolygon(point, tilePolygon)) return false; } } if (polygonGeometry.type === 'MultiPolygon') { const tilePolygons = getTilePolygons(polygonGeometry.coordinates, polyBBox, canonical); const tilePoints = getTilePoints(ctx.geometry(), pointBBox, polyBBox, canonical); if (!boxWithinBox(pointBBox, polyBBox)) return false; for (const point of tilePoints) { if (!pointWithinPolygons(point, tilePolygons)) return false; } } return true; } function linesWithinPolygons(ctx, polygonGeometry) { const lineBBox = [Infinity, Infinity, -Infinity, -Infinity]; const polyBBox = [Infinity, Infinity, -Infinity, -Infinity]; const canonical = ctx.canonicalID(); if (polygonGeometry.type === 'Polygon') { const tilePolygon = getTilePolygon(polygonGeometry.coordinates, polyBBox, canonical); const tileLines = getTileLines(ctx.geometry(), lineBBox, polyBBox, canonical); if (!boxWithinBox(lineBBox, polyBBox)) return false; for (const line of tileLines) { if (!lineStringWithinPolygon(line, tilePolygon)) return false; } } if (polygonGeometry.type === 'MultiPolygon') { const tilePolygons = getTilePolygons(polygonGeometry.coordinates, polyBBox, canonical); const tileLines = getTileLines(ctx.geometry(), lineBBox, polyBBox, canonical); if (!boxWithinBox(lineBBox, polyBBox)) return false; for (const line of tileLines) { if (!lineStringWithinPolygons(line, tilePolygons)) return false; } } return true; } class Within { constructor(geojson, geometries) { this.type = BooleanType; this.geojson = geojson; this.geometries = geometries; } static parse(args, context) { if (args.length !== 2) return context.error(`'within' expression requires exactly one argument, but found ${args.length - 1} instead.`); if (isValue(args[1])) { const geojson = args[1]; if (geojson.type === 'FeatureCollection') { const polygonsCoords = []; for (const polygon of geojson.features) { const { type, coordinates } = polygon.geometry; if (type === 'Polygon') { polygonsCoords.push(coordinates); } if (type === 'MultiPolygon') { polygonsCoords.push(...coordinates); } } if (polygonsCoords.length) { const multipolygonWrapper = { type: 'MultiPolygon', coordinates: polygonsCoords }; return new Within(geojson, multipolygonWrapper); } } else if (geojson.type === 'Feature') { const type = geojson.geometry.type; if (type === 'Polygon' || type === 'MultiPolygon') { return new Within(geojson, geojson.geometry); } } else if (geojson.type === 'Polygon' || geojson.type === 'MultiPolygon') { return new Within(geojson, geojson); } } return context.error('\'within\' expression requires valid geojson object that contains polygon geometry type.'); } evaluate(ctx) { if (ctx.geometry() != null && ctx.canonicalID() != null) { if (ctx.geometryType() === 'Point') { return pointsWithinPolygons(ctx, this.geometries); } else if (ctx.geometryType() === 'LineString') { return linesWithinPolygons(ctx, this.geometries); } } return false; } eachChild() { } outputDefined() { return true; } } let TinyQueue$1 = class TinyQueue { constructor(data = [], compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0)) { this.data = data; this.length = this.data.length; this.compare = compare; if (this.length > 0) { for (let i = (this.length >> 1) - 1; i >= 0; i--) this._down(i); } } push(item) { this.data.push(item); this._up(this.length++); } pop() { if (this.length === 0) return undefined; const top = this.data[0]; const bottom = this.data.pop(); if (--this.length > 0) { this.data[0] = bottom; this._down(0); } return top; } peek() { return this.data[0]; } _up(pos) { const {data, compare} = this; const item = data[pos]; while (pos > 0) { const parent = (pos - 1) >> 1; const current = data[parent]; if (compare(item, current) >= 0) break; data[pos] = current; pos = parent; } data[pos] = item; } _down(pos) { const {data, compare} = this; const halfLength = this.length >> 1; const item = data[pos]; while (pos < halfLength) { let bestChild = (pos << 1) + 1; // initially it is the left child const right = bestChild + 1; if (right < this.length && compare(data[right], data[bestChild]) < 0) { bestChild = right; } if (compare(data[bestChild], item) >= 0) break; data[pos] = data[bestChild]; pos = bestChild; } data[pos] = item; } }; function quickselect(arr, k, left, right, compare) { quickselectStep(arr, k, left, right || (arr.length - 1), compare || defaultCompare); } function quickselectStep(arr, k, left, right, compare) { while (right > left) { if (right - left > 600) { var n = right - left + 1; var m = k - left + 1; var z = Math.log(n); var s = 0.5 * Math.exp(2 * z / 3); var sd = 0.5 * Math.sqrt(z * s * (n - s) / n) * (m - n / 2 < 0 ? -1 : 1); var newLeft = Math.max(left, Math.floor(k - m * s / n + sd)); var newRight = Math.min(right, Math.floor(k + (n - m) * s / n + sd)); quickselectStep(arr, k, newLeft, newRight, compare); } var t = arr[k]; var i = left; var j = right; swap$2(arr, left, k); if (compare(arr[right], t) > 0) swap$2(arr, left, right); while (i < j) { swap$2(arr, i, j); i++; j--; while (compare(arr[i], t) < 0) i++; while (compare(arr[j], t) > 0) j--; } if (compare(arr[left], t) === 0) swap$2(arr, left, j); else { j++; swap$2(arr, j, right); } if (j <= k) left = j + 1; if (k <= j) right = j - 1; } } function swap$2(arr, i, j) { var tmp = arr[i]; arr[i] = arr[j]; arr[j] = tmp; } function defaultCompare(a, b) { return a < b ? -1 : a > b ? 1 : 0; } /** * Classifies an array of rings into polygons with outer rings and holes * @param rings - the rings to classify * @param maxRings - the maximum number of rings to include in a polygon, use 0 to include all rings * @returns an array of polygons with internal rings as holes */ function classifyRings$1(rings, maxRings) { const len = rings.length; if (len <= 1) return [rings]; const polygons = []; let polygon; let ccw; for (const ring of rings) { const area = calculateSignedArea(ring); if (area === 0) continue; ring.area = Math.abs(area); if (ccw === undefined) ccw = area < 0; if (ccw === area < 0) { if (polygon) polygons.push(polygon); polygon = [ring]; } else { polygon.push(ring); } } if (polygon) polygons.push(polygon); // Earcut performance degrades with the # of rings in a polygon. For this // reason, we limit strip out all but the `maxRings` largest rings. if (maxRings > 1) { for (let j = 0; j < polygons.length; j++) { if (polygons[j].length <= maxRings) continue; quickselect(polygons[j], maxRings, 1, polygons[j].length - 1, compareAreas); polygons[j] = polygons[j].slice(0, maxRings); } } return polygons; } function compareAreas(a, b) { return b.area - a.area; } /** * Returns the signed area for the polygon ring. Positive areas are exterior rings and * have a clockwise winding. Negative areas are interior rings and have a counter clockwise * ordering. * * @param ring - Exterior or interior ring * @returns Signed area */ function calculateSignedArea(ring) { let sum = 0; for (let i = 0, len = ring.length, j = len - 1, p1, p2; i < len; j = i++) { p1 = ring[i]; p2 = ring[j]; sum += (p2.x - p1.x) * (p1.y + p2.y); } return sum; } // This is taken from https://github.com/mapbox/cheap-ruler/ in order to take only the relevant parts // Values that define WGS84 ellipsoid model of the Earth const RE = 6378.137; // equatorial radius const FE = 1 / 298.257223563; // flattening const E2 = FE * (2 - FE); const RAD = Math.PI / 180; class CheapRuler { constructor(lat) { // Curvature formulas from https://en.wikipedia.org/wiki/Earth_radius#Meridional const m = RAD * RE * 1000; const coslat = Math.cos(lat * RAD); const w2 = 1 / (1 - E2 * (1 - coslat * coslat)); const w = Math.sqrt(w2); // multipliers for converting longitude and latitude degrees into distance this.kx = m * w * coslat; // based on normal radius of curvature this.ky = m * w * w2 * (1 - E2); // based on meridonal radius of curvature } /** * Given two points of the form [longitude, latitude], returns the distance. * * @param a - point [longitude, latitude] * @param b - point [longitude, latitude] * @returns distance * @example * const distance = ruler.distance([30.5, 50.5], [30.51, 50.49]); * //=distance */ distance(a, b) { const dx = this.wrap(a[0] - b[0]) * this.kx; const dy = (a[1] - b[1]) * this.ky; return Math.sqrt(dx * dx + dy * dy); } /** * Returns an object of the form {point, index, t}, where point is closest point on the line * from the given point, index is the start index of the segment with the closest point, * and t is a parameter from 0 to 1 that indicates where the closest point is on that segment. * * @param line - an array of points that form the line * @param p - point [longitude, latitude] * @returns the nearest point, its index in the array and the proportion along the line * @example * const point = ruler.pointOnLine(line, [-67.04, 50.5]).point; * //=point */ pointOnLine(line, p) { let minDist = Infinity; let minX, minY, minI, minT; for (let i = 0; i < line.length - 1; i++) { let x = line[i][0]; let y = line[i][1]; let dx = this.wrap(line[i + 1][0] - x) * this.kx; let dy = (line[i + 1][1] - y) * this.ky; let t = 0; if (dx !== 0 || dy !== 0) { t = (this.wrap(p[0] - x) * this.kx * dx + (p[1] - y) * this.ky * dy) / (dx * dx + dy * dy); if (t > 1) { x = line[i + 1][0]; y = line[i + 1][1]; } else if (t > 0) { x += (dx / this.kx) * t; y += (dy / this.ky) * t; } } dx = this.wrap(p[0] - x) * this.kx; dy = (p[1] - y) * this.ky; const sqDist = dx * dx + dy * dy; if (sqDist < minDist) { minDist = sqDist; minX = x; minY = y; minI = i; minT = t; } } return { point: [minX, minY], index: minI, t: Math.max(0, Math.min(1, minT)) }; } wrap(deg) { while (deg < -180) deg += 360; while (deg > 180) deg -= 360; return deg; } } const MinPointsSize = 100; const MinLinePointsSize = 50; function compareDistPair(a, b) { return b[0] - a[0]; } function getRangeSize(range) { return range[1] - range[0] + 1; } function isRangeSafe(range, threshold) { return range[1] >= range[0] && range[1] < threshold; } function splitRange(range, isLine) { if (range[0] > range[1]) { return [null, null]; } const size = getRangeSize(range); if (isLine) { if (size === 2) { return [range, null]; } const size1 = Math.floor(size / 2); return [[range[0], range[0] + size1], [range[0] + size1, range[1]]]; } if (size === 1) { return [range, null]; } const size1 = Math.floor(size / 2) - 1; return [[range[0], range[0] + size1], [range[0] + size1 + 1, range[1]]]; } function getBBox(coords, range) { if (!isRangeSafe(range, coords.length)) { return [Infinity, Infinity, -Infinity, -Infinity]; } const bbox = [Infinity, Infinity, -Infinity, -Infinity]; for (let i = range[0]; i <= range[1]; ++i) { updateBBox(bbox, coords[i]); } return bbox; } function getPolygonBBox(polygon) { const bbox = [Infinity, Infinity, -Infinity, -Infinity]; for (const ring of polygon) { for (const coord of ring) { updateBBox(bbox, coord); } } return bbox; } function isValidBBox(bbox) { return bbox[0] !== -Infinity && bbox[1] !== -Infinity && bbox[2] !== Infinity && bbox[3] !== Infinity; } // Calculate the distance between two bounding boxes. // Calculate the delta in x and y direction, and use two fake points {0.0, 0.0} // and {dx, dy} to calculate the distance. Distance will be 0.0 if bounding box are overlapping. function bboxToBBoxDistance(bbox1, bbox2, ruler) { if (!isValidBBox(bbox1) || !isValidBBox(bbox2)) { return NaN; } let dx = 0.0; let dy = 0.0; // bbox1 in left side if (bbox1[2] < bbox2[0]) { dx = bbox2[0] - bbox1[2]; } // bbox1 in right side if (bbox1[0] > bbox2[2]) { dx = bbox1[0] - bbox2[2]; } // bbox1 in above side if (bbox1[1] > bbox2[3]) { dy = bbox1[1] - bbox2[3]; } // bbox1 in down side if (bbox1[3] < bbox2[1]) { dy = bbox2[1] - bbox1[3]; } return ruler.distance([0.0, 0.0], [dx, dy]); } function pointToLineDistance(point, line, ruler) { const nearestPoint = ruler.pointOnLine(line, point); return ruler.distance(point, nearestPoint.point); } function segmentToSegmentDistance(p1, p2, q1, q2, ruler) { const dist1 = Math.min(pointToLineDistance(p1, [q1, q2], ruler), pointToLineDistance(p2, [q1, q2], ruler)); const dist2 = Math.min(pointToLineDistance(q1, [p1, p2], ruler), pointToLineDistance(q2, [p1, p2], ruler)); return Math.min(dist1, dist2); } function lineToLineDistance(line1, range1, line2, range2, ruler) { const rangeSafe = isRangeSafe(range1, line1.length) && isRangeSafe(range2, line2.length); if (!rangeSafe) { return Infinity; } let dist = Infinity; for (let i = range1[0]; i < range1[1]; ++i) { const p1 = line1[i]; const p2 = line1[i + 1]; for (let j = range2[0]; j < range2[1]; ++j) { const q1 = line2[j]; const q2 = line2[j + 1]; if (segmentIntersectSegment(p1, p2, q1, q2)) { return 0.0; } dist = Math.min(dist, segmentToSegmentDistance(p1, p2, q1, q2, ruler)); } } return dist; } function pointsToPointsDistance(points1, range1, points2, range2, ruler) { const rangeSafe = isRangeSafe(range1, points1.length) && isRangeSafe(range2, points2.length); if (!rangeSafe) { return NaN; } let dist = Infinity; for (let i = range1[0]; i <= range1[1]; ++i) { for (let j = range2[0]; j <= range2[1]; ++j) { dist = Math.min(dist, ruler.distance(points1[i], points2[j])); if (dist === 0.0) { return dist; } } } return dist; } function pointToPolygonDistance(point, polygon, ruler) { if (pointWithinPolygon(point, polygon, true)) { return 0.0; } let dist = Infinity; for (const ring of polygon) { const front = ring[0]; const back = ring[ring.length - 1]; if (front !== back) { dist = Math.min(dist, pointToLineDistance(point, [back, front], ruler)); if (dist === 0.0) { return dist; } } const nearestPoint = ruler.pointOnLine(ring, point); dist = Math.min(dist, ruler.distance(point, nearestPoint.point)); if (dist === 0.0) { return dist; } } return dist; } function lineToPolygonDistance(line, range, polygon, ruler) { if (!isRangeSafe(range, line.length)) { return NaN; } for (let i = range[0]; i <= range[1]; ++i) { if (pointWithinPolygon(line[i], polygon, true)) { return 0.0; } } let dist = Infinity; for (let i = range[0]; i < range[1]; ++i) { const p1 = line[i]; const p2 = line[i + 1]; for (const ring of polygon) { for (let j = 0, len = ring.length, k = len - 1; j < len; k = j++) { const q1 = ring[k]; const q2 = ring[j]; if (segmentIntersectSegment(p1, p2, q1, q2)) { return 0.0; } dist = Math.min(dist, segmentToSegmentDistance(p1, p2, q1, q2, ruler)); } } } return dist; } function polygonIntersect(poly1, poly2) { for (const ring of poly1) { for (const point of ring) { if (pointWithinPolygon(point, poly2, true)) { return true; } } } return false; } function polygonToPolygonDistance(polygon1, polygon2, ruler, currentMiniDist = Infinity) { const bbox1 = getPolygonBBox(polygon1); const bbox2 = getPolygonBBox(polygon2); if (currentMiniDist !== Infinity && bboxToBBoxDistance(bbox1, bbox2, ruler) >= currentMiniDist) { return currentMiniDist; } if (boxWithinBox(bbox1, bbox2)) { if (polygonIntersect(polygon1, polygon2)) { return 0.0; } } else if (polygonIntersect(polygon2, polygon1)) { return 0.0; } let dist = Infinity; for (const ring1 of polygon1) { for (let i = 0, len1 = ring1.length, l = len1 - 1; i < len1; l = i++) { const p1 = ring1[l]; const p2 = ring1[i]; for (const ring2 of polygon2) { for (let j = 0, len2 = ring2.length, k = len2 - 1; j < len2; k = j++) { const q1 = ring2[k]; const q2 = ring2[j]; if (segmentIntersectSegment(p1, p2, q1, q2)) { return 0.0; } dist = Math.min(dist, segmentToSegmentDistance(p1, p2, q1, q2, ruler)); } } } } return dist; } function updateQueue(distQueue, miniDist, ruler, points, polyBBox, rangeA) { if (!rangeA) { return; } const tempDist = bboxToBBoxDistance(getBBox(points, rangeA), polyBBox, ruler); // Insert new pair to the queue if the bbox distance is less than // miniDist, The pair with biggest distance will be at the top if (tempDist < miniDist) { distQueue.push([tempDist, rangeA, [0, 0]]); } } function updateQueueTwoSets(distQueue, miniDist, ruler, pointSet1, pointSet2, range1, range2) { if (!range1 || !range2) { return; } const tempDist = bboxToBBoxDistance(getBBox(pointSet1, range1), getBBox(pointSet2, range2), ruler); // Insert new pair to the queue if the bbox distance is less than // miniDist, The pair with biggest distance will be at the top if (tempDist < miniDist) { distQueue.push([tempDist, range1, range2]); } } // Divide and conquer, the time complexity is O(n*lgn), faster than Brute force // O(n*n) Most of the time, use index for in-place processing. function pointsToPolygonDistance(points, isLine, polygon, ruler, currentMiniDist = Infinity) { let miniDist = Math.min(ruler.distance(points[0], polygon[0][0]), currentMiniDist); if (miniDist === 0.0) { return miniDist; } const distQueue = new TinyQueue$1([[0, [0, points.length - 1], [0, 0]]], compareDistPair); const polyBBox = getPolygonBBox(polygon); while (distQueue.length > 0) { const distPair = distQueue.pop(); if (distPair[0] >= miniDist) { continue; } const range = distPair[1]; // In case the set size are relatively small, we could use brute-force directly const threshold = isLine ? MinLinePointsSize : MinPointsSize; if (getRangeSize(range) <= threshold) { if (!isRangeSafe(range, points.length)) { return NaN; } if (isLine) { const tempDist = lineToPolygonDistance(points, range, polygon, ruler); if (isNaN(tempDist) || tempDist === 0.0) { return tempDist; } miniDist = Math.min(miniDist, tempDist); } else { for (let i = range[0]; i <= range[1]; ++i) { const tempDist = pointToPolygonDistance(points[i], polygon, ruler); miniDist = Math.min(miniDist, tempDist); if (miniDist === 0.0) { return 0.0; } } } } else { const newRangesA = splitRange(range, isLine); updateQueue(distQueue, miniDist, ruler, points, polyBBox, newRangesA[0]); updateQueue(distQueue, miniDist, ruler, points, polyBBox, newRangesA[1]); } } return miniDist; } function pointSetToPointSetDistance(pointSet1, isLine1, pointSet2, isLine2, ruler, currentMiniDist = Infinity) { let miniDist = Math.min(currentMiniDist, ruler.distance(pointSet1[0], pointSet2[0])); if (miniDist === 0.0) { return miniDist; } const distQueue = new TinyQueue$1([[0, [0, pointSet1.length - 1], [0, pointSet2.length - 1]]], compareDistPair); while (distQueue.length > 0) { const distPair = distQueue.pop(); if (distPair[0] >= miniDist) { continue; } const rangeA = distPair[1]; const rangeB = distPair[2]; const threshold1 = isLine1 ? MinLinePointsSize : MinPointsSize; const threshold2 = isLine2 ? MinLinePointsSize : MinPointsSize; // In case the set size are relatively small, we could use brute-force directly if (getRangeSize(rangeA) <= threshold1 && getRangeSize(rangeB) <= threshold2) { if (!isRangeSafe(rangeA, pointSet1.length) && isRangeSafe(rangeB, pointSet2.length)) { return NaN; } let tempDist; if (isLine1 && isLine2) { tempDist = lineToLineDistance(pointSet1, rangeA, pointSet2, rangeB, ruler); miniDist = Math.min(miniDist, tempDist); } else if (isLine1 && !isLine2) { const sublibe = pointSet1.slice(rangeA[0], rangeA[1] + 1); for (let i = rangeB[0]; i <= rangeB[1]; ++i) { tempDist = pointToLineDistance(pointSet2[i], sublibe, ruler); miniDist = Math.min(miniDist, tempDist); if (miniDist === 0.0) { return miniDist; } } } else if (!isLine1 && isLine2) { const sublibe = pointSet2.slice(rangeB[0], rangeB[1] + 1); for (let i = rangeA[0]; i <= rangeA[1]; ++i) { tempDist = pointToLineDistance(pointSet1[i], sublibe, ruler); miniDist = Math.min(miniDist, tempDist); if (miniDist === 0.0) { return miniDist; } } } else { tempDist = pointsToPointsDistance(pointSet1, rangeA, pointSet2, rangeB, ruler); miniDist = Math.min(miniDist, tempDist); } } else { const newRangesA = splitRange(rangeA, isLine1); const newRangesB = splitRange(rangeB, isLine2); updateQueueTwoSets(distQueue, miniDist, ruler, pointSet1, pointSet2, newRangesA[0], newRangesB[0]); updateQueueTwoSets(distQueue, miniDist, ruler, pointSet1, pointSet2, newRangesA[0], newRangesB[1]); updateQueueTwoSets(distQueue, miniDist, ruler, pointSet1, pointSet2, newRangesA[1], newRangesB[0]); updateQueueTwoSets(distQueue, miniDist, ruler, pointSet1, pointSet2, newRangesA[1], newRangesB[1]); } } return miniDist; } function pointToGeometryDistance(ctx, geometries) { const tilePoints = ctx.geometry(); const pointPosition = tilePoints.flat().map(p => getLngLatFromTileCoord([p.x, p.y], ctx.canonical)); if (tilePoints.length === 0) { return NaN; } const ruler = new CheapRuler(pointPosition[0][1]); let dist = Infinity; for (const geometry of geometries) { switch (geometry.type) { case 'Point': dist = Math.min(dist, pointSetToPointSetDistance(pointPosition, false, [geometry.coordinates], false, ruler, dist)); break; case 'LineString': dist = Math.min(dist, pointSetToPointSetDistance(pointPosition, false, geometry.coordinates, true, ruler, dist)); break; case 'Polygon': dist = Math.min(dist, pointsToPolygonDistance(pointPosition, false, geometry.coordinates, ruler, dist)); break; } if (dist === 0.0) { return dist; } } return dist; } function lineStringToGeometryDistance(ctx, geometries) { const tileLine = ctx.geometry(); const linePositions = tileLine.flat().map(p => getLngLatFromTileCoord([p.x, p.y], ctx.canonical)); if (tileLine.length === 0) { return NaN; } const ruler = new CheapRuler(linePositions[0][1]); let dist = Infinity; for (const geometry of geometries) { switch (geometry.type) { case 'Point': dist = Math.min(dist, pointSetToPointSetDistance(linePositions, true, [geometry.coordinates], false, ruler, dist)); break; case 'LineString': dist = Math.min(dist, pointSetToPointSetDistance(linePositions, true, geometry.coordinates, true, ruler, dist)); break; case 'Polygon': dist = Math.min(dist, pointsToPolygonDistance(linePositions, true, geometry.coordinates, ruler, dist)); break; } if (dist === 0.0) { return dist; } } return dist; } function polygonToGeometryDistance(ctx, geometries) { const tilePolygon = ctx.geometry(); if (tilePolygon.length === 0 || tilePolygon[0].length === 0) { return NaN; } const polygons = classifyRings$1(tilePolygon, 0).map(polygon => { return polygon.map(ring => { return ring.map(p => getLngLatFromTileCoord([p.x, p.y], ctx.canonical)); }); }); const ruler = new CheapRuler(polygons[0][0][0][1]); let dist = Infinity; for (const geometry of geometries) { for (const polygon of polygons) { switch (geometry.type) { case 'Point': dist = Math.min(dist, pointsToPolygonDistance([geometry.coordinates], false, polygon, ruler, dist)); break; case 'LineString': dist = Math.min(dist, pointsToPolygonDistance(geometry.coordinates, true, polygon, ruler, dist)); break; case 'Polygon': dist = Math.min(dist, polygonToPolygonDistance(polygon, geometry.coordinates, ruler, dist)); break; } if (dist === 0.0) { return dist; } } } return dist; } function toSimpleGeometry(geometry) { if (geometry.type === 'MultiPolygon') { return geometry.coordinates.map(polygon => { return { type: 'Polygon', coordinates: polygon }; }); } if (geometry.type === 'MultiLineString') { return geometry.coordinates.map(lineString => { return { type: 'LineString', coordinates: lineString }; }); } if (geometry.type === 'MultiPoint') { return geometry.coordinates.map(point => { return { type: 'Point', coordinates: point }; }); } return [geometry]; } class Distance { constructor(geojson, geometries) { this.type = NumberType; this.geojson = geojson; this.geometries = geometries; } static parse(args, context) { if (args.length !== 2) return context.error(`'distance' expression requires exactly one argument, but found ${args.length - 1} instead.`); if (isValue(args[1])) { const geojson = args[1]; if (geojson.type === 'FeatureCollection') { return new Distance(geojson, geojson.features.map(feature => toSimpleGeometry(feature.geometry)).flat()); } else if (geojson.type === 'Feature') { return new Distance(geojson, toSimpleGeometry(geojson.geometry)); } else if ('type' in geojson && 'coordinates' in geojson) { return new Distance(geojson, toSimpleGeometry(geojson)); } } return context.error('\'distance\' expression requires valid geojson object that contains polygon geometry type.'); } evaluate(ctx) { if (ctx.geometry() != null && ctx.canonicalID() != null) { if (ctx.geometryType() === 'Point') { return pointToGeometryDistance(ctx, this.geometries); } else if (ctx.geometryType() === 'LineString') { return lineStringToGeometryDistance(ctx, this.geometries); } else if (ctx.geometryType() === 'Polygon') { return polygonToGeometryDistance(ctx, this.geometries); } } return NaN; } eachChild() { } outputDefined() { return true; } } const expressions$1 = { // special forms '==': Equals, '!=': NotEquals, '>': GreaterThan, '<': LessThan, '>=': GreaterThanOrEqual, '<=': LessThanOrEqual, 'array': Assertion, 'at': At, 'boolean': Assertion, 'case': Case, 'coalesce': Coalesce, 'collator': CollatorExpression, 'format': FormatExpression, 'image': ImageExpression, 'in': In, 'index-of': IndexOf, 'interpolate': Interpolate, 'interpolate-hcl': Interpolate, 'interpolate-lab': Interpolate, 'length': Length, 'let': Let, 'literal': Literal, 'match': Match, 'number': Assertion, 'number-format': NumberFormat, 'object': Assertion, 'slice': Slice, 'step': Step, 'string': Assertion, 'to-boolean': Coercion, 'to-color': Coercion, 'to-number': Coercion, 'to-string': Coercion, 'var': Var, 'within': Within, 'distance': Distance }; class CompoundExpression { constructor(name, type, evaluate, args) { this.name = name; this.type = type; this._evaluate = evaluate; this.args = args; } evaluate(ctx) { return this._evaluate(ctx, this.args); } eachChild(fn) { this.args.forEach(fn); } outputDefined() { return false; } static parse(args, context) { const op = args[0]; const definition = CompoundExpression.definitions[op]; if (!definition) { return context.error(`Unknown expression "${op}". If you wanted a literal array, use ["literal", [...]].`, 0); } // Now check argument types against each signature const type = Array.isArray(definition) ? definition[0] : definition.type; const availableOverloads = Array.isArray(definition) ? [[definition[1], definition[2]]] : definition.overloads; const overloads = availableOverloads.filter(([signature]) => (!Array.isArray(signature) || // varags signature.length === args.length - 1 // correct param count )); let signatureContext = null; for (const [params, evaluate] of overloads) { // Use a fresh context for each attempted signature so that, if // we eventually succeed, we haven't polluted `context.errors`. signatureContext = new ParsingContext(context.registry, isExpressionConstant, context.path, null, context.scope); // First parse all the args, potentially coercing to the // types expected by this overload. const parsedArgs = []; let argParseFailed = false; for (let i = 1; i < args.length; i++) { const arg = args[i]; const expectedType = Array.isArray(params) ? params[i - 1] : params.type; const parsed = signatureContext.parse(arg, 1 + parsedArgs.length, expectedType); if (!parsed) { argParseFailed = true; break; } parsedArgs.push(parsed); } if (argParseFailed) { // Couldn't coerce args of this overload to expected type, move // on to next one. continue; } if (Array.isArray(params)) { if (params.length !== parsedArgs.length) { signatureContext.error(`Expected ${params.length} arguments, but found ${parsedArgs.length} instead.`); continue; } } for (let i = 0; i < parsedArgs.length; i++) { const expected = Array.isArray(params) ? params[i] : params.type; const arg = parsedArgs[i]; signatureContext.concat(i + 1).checkSubtype(expected, arg.type); } if (signatureContext.errors.length === 0) { return new CompoundExpression(op, type, evaluate, parsedArgs); } } if (overloads.length === 1) { context.errors.push(...signatureContext.errors); } else { const expected = overloads.length ? overloads : availableOverloads; const signatures = expected .map(([params]) => stringifySignature(params)) .join(' | '); const actualTypes = []; // For error message, re-parse arguments without trying to // apply any coercions for (let i = 1; i < args.length; i++) { const parsed = context.parse(args[i], 1 + actualTypes.length); if (!parsed) return null; actualTypes.push(toString$1(parsed.type)); } context.error(`Expected arguments of type ${signatures}, but found (${actualTypes.join(', ')}) instead.`); } return null; } static register(registry, definitions) { CompoundExpression.definitions = definitions; for (const name in definitions) { registry[name] = CompoundExpression; } } } function rgba(ctx, [r, g, b, a]) { r = r.evaluate(ctx); g = g.evaluate(ctx); b = b.evaluate(ctx); const alpha = a ? a.evaluate(ctx) : 1; const error = validateRGBA(r, g, b, alpha); if (error) throw new RuntimeError(error); return new Color(r / 255, g / 255, b / 255, alpha, false); } function has(key, obj) { return key in obj; } function get(key, obj) { const v = obj[key]; return typeof v === 'undefined' ? null : v; } function binarySearch(v, a, i, j) { while (i <= j) { const m = (i + j) >> 1; if (a[m] === v) return true; if (a[m] > v) j = m - 1; else i = m + 1; } return false; } function varargs(type) { return { type }; } CompoundExpression.register(expressions$1, { 'error': [ ErrorType, [StringType], (ctx, [v]) => { throw new RuntimeError(v.evaluate(ctx)); } ], 'typeof': [ StringType, [ValueType], (ctx, [v]) => toString$1(typeOf(v.evaluate(ctx))) ], 'to-rgba': [ array$1(NumberType, 4), [ColorType], (ctx, [v]) => { const [r, g, b, a] = v.evaluate(ctx).rgb; return [r * 255, g * 255, b * 255, a]; }, ], 'rgb': [ ColorType, [NumberType, NumberType, NumberType], rgba ], 'rgba': [ ColorType, [NumberType, NumberType, NumberType, NumberType], rgba ], 'has': { type: BooleanType, overloads: [ [ [StringType], (ctx, [key]) => has(key.evaluate(ctx), ctx.properties()) ], [ [StringType, ObjectType], (ctx, [key, obj]) => has(key.evaluate(ctx), obj.evaluate(ctx)) ] ] }, 'get': { type: ValueType, overloads: [ [ [StringType], (ctx, [key]) => get(key.evaluate(ctx), ctx.properties()) ], [ [StringType, ObjectType], (ctx, [key, obj]) => get(key.evaluate(ctx), obj.evaluate(ctx)) ] ] }, 'feature-state': [ ValueType, [StringType], (ctx, [key]) => get(key.evaluate(ctx), ctx.featureState || {}) ], 'properties': [ ObjectType, [], (ctx) => ctx.properties() ], 'geometry-type': [ StringType, [], (ctx) => ctx.geometryType() ], 'id': [ ValueType, [], (ctx) => ctx.id() ], 'zoom': [ NumberType, [], (ctx) => ctx.globals.zoom ], 'heatmap-density': [ NumberType, [], (ctx) => ctx.globals.heatmapDensity || 0 ], 'line-progress': [ NumberType, [], (ctx) => ctx.globals.lineProgress || 0 ], 'accumulated': [ ValueType, [], (ctx) => ctx.globals.accumulated === undefined ? null : ctx.globals.accumulated ], '+': [ NumberType, varargs(NumberType), (ctx, args) => { let result = 0; for (const arg of args) { result += arg.evaluate(ctx); } return result; } ], '*': [ NumberType, varargs(NumberType), (ctx, args) => { let result = 1; for (const arg of args) { result *= arg.evaluate(ctx); } return result; } ], '-': { type: NumberType, overloads: [ [ [NumberType, NumberType], (ctx, [a, b]) => a.evaluate(ctx) - b.evaluate(ctx) ], [ [NumberType], (ctx, [a]) => -a.evaluate(ctx) ] ] }, '/': [ NumberType, [NumberType, NumberType], (ctx, [a, b]) => a.evaluate(ctx) / b.evaluate(ctx) ], '%': [ NumberType, [NumberType, NumberType], (ctx, [a, b]) => a.evaluate(ctx) % b.evaluate(ctx) ], 'ln2': [ NumberType, [], () => Math.LN2 ], 'pi': [ NumberType, [], () => Math.PI ], 'e': [ NumberType, [], () => Math.E ], '^': [ NumberType, [NumberType, NumberType], (ctx, [b, e]) => Math.pow(b.evaluate(ctx), e.evaluate(ctx)) ], 'sqrt': [ NumberType, [NumberType], (ctx, [x]) => Math.sqrt(x.evaluate(ctx)) ], 'log10': [ NumberType, [NumberType], (ctx, [n]) => Math.log(n.evaluate(ctx)) / Math.LN10 ], 'ln': [ NumberType, [NumberType], (ctx, [n]) => Math.log(n.evaluate(ctx)) ], 'log2': [ NumberType, [NumberType], (ctx, [n]) => Math.log(n.evaluate(ctx)) / Math.LN2 ], 'sin': [ NumberType, [NumberType], (ctx, [n]) => Math.sin(n.evaluate(ctx)) ], 'cos': [ NumberType, [NumberType], (ctx, [n]) => Math.cos(n.evaluate(ctx)) ], 'tan': [ NumberType, [NumberType], (ctx, [n]) => Math.tan(n.evaluate(ctx)) ], 'asin': [ NumberType, [NumberType], (ctx, [n]) => Math.asin(n.evaluate(ctx)) ], 'acos': [ NumberType, [NumberType], (ctx, [n]) => Math.acos(n.evaluate(ctx)) ], 'atan': [ NumberType, [NumberType], (ctx, [n]) => Math.atan(n.evaluate(ctx)) ], 'min': [ NumberType, varargs(NumberType), (ctx, args) => Math.min(...args.map(arg => arg.evaluate(ctx))) ], 'max': [ NumberType, varargs(NumberType), (ctx, args) => Math.max(...args.map(arg => arg.evaluate(ctx))) ], 'abs': [ NumberType, [NumberType], (ctx, [n]) => Math.abs(n.evaluate(ctx)) ], 'round': [ NumberType, [NumberType], (ctx, [n]) => { const v = n.evaluate(ctx); // Javascript's Math.round() rounds towards +Infinity for halfway // values, even when they're negative. It's more common to round // away from 0 (e.g., this is what python and C++ do) return v < 0 ? -Math.round(-v) : Math.round(v); } ], 'floor': [ NumberType, [NumberType], (ctx, [n]) => Math.floor(n.evaluate(ctx)) ], 'ceil': [ NumberType, [NumberType], (ctx, [n]) => Math.ceil(n.evaluate(ctx)) ], 'filter-==': [ BooleanType, [StringType, ValueType], (ctx, [k, v]) => ctx.properties()[k.value] === v.value ], 'filter-id-==': [ BooleanType, [ValueType], (ctx, [v]) => ctx.id() === v.value ], 'filter-type-==': [ BooleanType, [StringType], (ctx, [v]) => ctx.geometryType() === v.value ], 'filter-<': [ BooleanType, [StringType, ValueType], (ctx, [k, v]) => { const a = ctx.properties()[k.value]; const b = v.value; return typeof a === typeof b && a < b; } ], 'filter-id-<': [ BooleanType, [ValueType], (ctx, [v]) => { const a = ctx.id(); const b = v.value; return typeof a === typeof b && a < b; } ], 'filter->': [ BooleanType, [StringType, ValueType], (ctx, [k, v]) => { const a = ctx.properties()[k.value]; const b = v.value; return typeof a === typeof b && a > b; } ], 'filter-id->': [ BooleanType, [ValueType], (ctx, [v]) => { const a = ctx.id(); const b = v.value; return typeof a === typeof b && a > b; } ], 'filter-<=': [ BooleanType, [StringType, ValueType], (ctx, [k, v]) => { const a = ctx.properties()[k.value]; const b = v.value; return typeof a === typeof b && a <= b; } ], 'filter-id-<=': [ BooleanType, [ValueType], (ctx, [v]) => { const a = ctx.id(); const b = v.value; return typeof a === typeof b && a <= b; } ], 'filter->=': [ BooleanType, [StringType, ValueType], (ctx, [k, v]) => { const a = ctx.properties()[k.value]; const b = v.value; return typeof a === typeof b && a >= b; } ], 'filter-id->=': [ BooleanType, [ValueType], (ctx, [v]) => { const a = ctx.id(); const b = v.value; return typeof a === typeof b && a >= b; } ], 'filter-has': [ BooleanType, [ValueType], (ctx, [k]) => k.value in ctx.properties() ], 'filter-has-id': [ BooleanType, [], (ctx) => (ctx.id() !== null && ctx.id() !== undefined) ], 'filter-type-in': [ BooleanType, [array$1(StringType)], (ctx, [v]) => v.value.indexOf(ctx.geometryType()) >= 0 ], 'filter-id-in': [ BooleanType, [array$1(ValueType)], (ctx, [v]) => v.value.indexOf(ctx.id()) >= 0 ], 'filter-in-small': [ BooleanType, [StringType, array$1(ValueType)], // assumes v is an array literal (ctx, [k, v]) => v.value.indexOf(ctx.properties()[k.value]) >= 0 ], 'filter-in-large': [ BooleanType, [StringType, array$1(ValueType)], // assumes v is a array literal with values sorted in ascending order and of a single type (ctx, [k, v]) => binarySearch(ctx.properties()[k.value], v.value, 0, v.value.length - 1) ], 'all': { type: BooleanType, overloads: [ [ [BooleanType, BooleanType], (ctx, [a, b]) => a.evaluate(ctx) && b.evaluate(ctx) ], [ varargs(BooleanType), (ctx, args) => { for (const arg of args) { if (!arg.evaluate(ctx)) return false; } return true; } ] ] }, 'any': { type: BooleanType, overloads: [ [ [BooleanType, BooleanType], (ctx, [a, b]) => a.evaluate(ctx) || b.evaluate(ctx) ], [ varargs(BooleanType), (ctx, args) => { for (const arg of args) { if (arg.evaluate(ctx)) return true; } return false; } ] ] }, '!': [ BooleanType, [BooleanType], (ctx, [b]) => !b.evaluate(ctx) ], 'is-supported-script': [ BooleanType, [StringType], // At parse time this will always return true, so we need to exclude this expression with isGlobalPropertyConstant (ctx, [s]) => { const isSupportedScript = ctx.globals && ctx.globals.isSupportedScript; if (isSupportedScript) { return isSupportedScript(s.evaluate(ctx)); } return true; } ], 'upcase': [ StringType, [StringType], (ctx, [s]) => s.evaluate(ctx).toUpperCase() ], 'downcase': [ StringType, [StringType], (ctx, [s]) => s.evaluate(ctx).toLowerCase() ], 'concat': [ StringType, varargs(ValueType), (ctx, args) => args.map(arg => toString(arg.evaluate(ctx))).join('') ], 'resolved-locale': [ StringType, [CollatorType], (ctx, [collator]) => collator.evaluate(ctx).resolvedLocale() ] }); function stringifySignature(signature) { if (Array.isArray(signature)) { return `(${signature.map(toString$1).join(', ')})`; } else { return `(${toString$1(signature.type)}...)`; } } function isExpressionConstant(expression) { if (expression instanceof Var) { return isExpressionConstant(expression.boundExpression); } else if (expression instanceof CompoundExpression && expression.name === 'error') { return false; } else if (expression instanceof CollatorExpression) { // Although the results of a Collator expression with fixed arguments // generally shouldn't change between executions, we can't serialize them // as constant expressions because results change based on environment. return false; } else if (expression instanceof Within) { return false; } else if (expression instanceof Distance) { return false; } const isTypeAnnotation = expression instanceof Coercion || expression instanceof Assertion; let childrenConstant = true; expression.eachChild(child => { // We can _almost_ assume that if `expressions` children are constant, // they would already have been evaluated to Literal values when they // were parsed. Type annotations are the exception, because they might // have been inferred and added after a child was parsed. // So we recurse into isConstant() for the children of type annotations, // but otherwise simply check whether they are Literals. if (isTypeAnnotation) { childrenConstant = childrenConstant && isExpressionConstant(child); } else { childrenConstant = childrenConstant && child instanceof Literal; } }); if (!childrenConstant) { return false; } return isFeatureConstant(expression) && isGlobalPropertyConstant(expression, ['zoom', 'heatmap-density', 'line-progress', 'accumulated', 'is-supported-script']); } function isFeatureConstant(e) { if (e instanceof CompoundExpression) { if (e.name === 'get' && e.args.length === 1) { return false; } else if (e.name === 'feature-state') { return false; } else if (e.name === 'has' && e.args.length === 1) { return false; } else if (e.name === 'properties' || e.name === 'geometry-type' || e.name === 'id') { return false; } else if (/^filter-/.test(e.name)) { return false; } } if (e instanceof Within) { return false; } if (e instanceof Distance) { return false; } let result = true; e.eachChild(arg => { if (result && !isFeatureConstant(arg)) { result = false; } }); return result; } function isStateConstant(e) { if (e instanceof CompoundExpression) { if (e.name === 'feature-state') { return false; } } let result = true; e.eachChild(arg => { if (result && !isStateConstant(arg)) { result = false; } }); return result; } function isGlobalPropertyConstant(e, properties) { if (e instanceof CompoundExpression && properties.indexOf(e.name) >= 0) { return false; } let result = true; e.eachChild((arg) => { if (result && !isGlobalPropertyConstant(arg, properties)) { result = false; } }); return result; } function success(value) { return { result: 'success', value }; } function error(value) { return { result: 'error', value }; } function supportsPropertyExpression(spec) { return spec['property-type'] === 'data-driven' || spec['property-type'] === 'cross-faded-data-driven'; } function supportsZoomExpression(spec) { return !!spec.expression && spec.expression.parameters.indexOf('zoom') > -1; } function supportsInterpolation(spec) { return !!spec.expression && spec.expression.interpolated; } function getType(val) { if (val instanceof Number) { return 'number'; } else if (val instanceof String) { return 'string'; } else if (val instanceof Boolean) { return 'boolean'; } else if (Array.isArray(val)) { return 'array'; } else if (val === null) { return 'null'; } else { return typeof val; } } function isFunction$1(value) { return typeof value === 'object' && value !== null && !Array.isArray(value); } function identityFunction(x) { return x; } function createFunction(parameters, propertySpec) { const isColor = propertySpec.type === 'color'; const zoomAndFeatureDependent = parameters.stops && typeof parameters.stops[0][0] === 'object'; const featureDependent = zoomAndFeatureDependent || parameters.property !== undefined; const zoomDependent = zoomAndFeatureDependent || !featureDependent; const type = parameters.type || (supportsInterpolation(propertySpec) ? 'exponential' : 'interval'); if (isColor || propertySpec.type === 'padding') { const parseFn = isColor ? Color.parse : Padding.parse; parameters = extendBy({}, parameters); if (parameters.stops) { parameters.stops = parameters.stops.map((stop) => { return [stop[0], parseFn(stop[1])]; }); } if (parameters.default) { parameters.default = parseFn(parameters.default); } else { parameters.default = parseFn(propertySpec.default); } } if (parameters.colorSpace && !isSupportedInterpolationColorSpace(parameters.colorSpace)) { throw new Error(`Unknown color space: "${parameters.colorSpace}"`); } let innerFun; let hashedStops; let categoricalKeyType; if (type === 'exponential') { innerFun = evaluateExponentialFunction; } else if (type === 'interval') { innerFun = evaluateIntervalFunction; } else if (type === 'categorical') { innerFun = evaluateCategoricalFunction; // For categorical functions, generate an Object as a hashmap of the stops for fast searching hashedStops = Object.create(null); for (const stop of parameters.stops) { hashedStops[stop[0]] = stop[1]; } // Infer key type based on first stop key-- used to encforce strict type checking later categoricalKeyType = typeof parameters.stops[0][0]; } else if (type === 'identity') { innerFun = evaluateIdentityFunction; } else { throw new Error(`Unknown function type "${type}"`); } if (zoomAndFeatureDependent) { const featureFunctions = {}; const zoomStops = []; for (let s = 0; s < parameters.stops.length; s++) { const stop = parameters.stops[s]; const zoom = stop[0].zoom; if (featureFunctions[zoom] === undefined) { featureFunctions[zoom] = { zoom, type: parameters.type, property: parameters.property, default: parameters.default, stops: [] }; zoomStops.push(zoom); } featureFunctions[zoom].stops.push([stop[0].value, stop[1]]); } const featureFunctionStops = []; for (const z of zoomStops) { featureFunctionStops.push([featureFunctions[z].zoom, createFunction(featureFunctions[z], propertySpec)]); } const interpolationType = { name: 'linear' }; return { kind: 'composite', interpolationType, interpolationFactor: Interpolate.interpolationFactor.bind(undefined, interpolationType), zoomStops: featureFunctionStops.map(s => s[0]), evaluate({ zoom }, properties) { return evaluateExponentialFunction({ stops: featureFunctionStops, base: parameters.base }, propertySpec, zoom).evaluate(zoom, properties); } }; } else if (zoomDependent) { const interpolationType = type === 'exponential' ? { name: 'exponential', base: parameters.base !== undefined ? parameters.base : 1 } : null; return { kind: 'camera', interpolationType, interpolationFactor: Interpolate.interpolationFactor.bind(undefined, interpolationType), zoomStops: parameters.stops.map(s => s[0]), evaluate: ({ zoom }) => innerFun(parameters, propertySpec, zoom, hashedStops, categoricalKeyType) }; } else { return { kind: 'source', evaluate(_, feature) { const value = feature && feature.properties ? feature.properties[parameters.property] : undefined; if (value === undefined) { return coalesce$1(parameters.default, propertySpec.default); } return innerFun(parameters, propertySpec, value, hashedStops, categoricalKeyType); } }; } } function coalesce$1(a, b, c) { if (a !== undefined) return a; if (b !== undefined) return b; if (c !== undefined) return c; } function evaluateCategoricalFunction(parameters, propertySpec, input, hashedStops, keyType) { const evaluated = typeof input === keyType ? hashedStops[input] : undefined; // Enforce strict typing on input return coalesce$1(evaluated, parameters.default, propertySpec.default); } function evaluateIntervalFunction(parameters, propertySpec, input) { // Edge cases if (getType(input) !== 'number') return coalesce$1(parameters.default, propertySpec.default); const n = parameters.stops.length; if (n === 1) return parameters.stops[0][1]; if (input <= parameters.stops[0][0]) return parameters.stops[0][1]; if (input >= parameters.stops[n - 1][0]) return parameters.stops[n - 1][1]; const index = findStopLessThanOrEqualTo(parameters.stops.map((stop) => stop[0]), input); return parameters.stops[index][1]; } function evaluateExponentialFunction(parameters, propertySpec, input) { const base = parameters.base !== undefined ? parameters.base : 1; // Edge cases if (getType(input) !== 'number') return coalesce$1(parameters.default, propertySpec.default); const n = parameters.stops.length; if (n === 1) return parameters.stops[0][1]; if (input <= parameters.stops[0][0]) return parameters.stops[0][1]; if (input >= parameters.stops[n - 1][0]) return parameters.stops[n - 1][1]; const index = findStopLessThanOrEqualTo(parameters.stops.map((stop) => stop[0]), input); const t = interpolationFactor(input, base, parameters.stops[index][0], parameters.stops[index + 1][0]); const outputLower = parameters.stops[index][1]; const outputUpper = parameters.stops[index + 1][1]; const interp = interpolate[propertySpec.type] || identityFunction; if (typeof outputLower.evaluate === 'function') { return { evaluate(...args) { const evaluatedLower = outputLower.evaluate.apply(undefined, args); const evaluatedUpper = outputUpper.evaluate.apply(undefined, args); // Special case for fill-outline-color, which has no spec default. if (evaluatedLower === undefined || evaluatedUpper === undefined) { return undefined; } return interp(evaluatedLower, evaluatedUpper, t, parameters.colorSpace); } }; } return interp(outputLower, outputUpper, t, parameters.colorSpace); } function evaluateIdentityFunction(parameters, propertySpec, input) { switch (propertySpec.type) { case 'color': input = Color.parse(input); break; case 'formatted': input = Formatted.fromString(input.toString()); break; case 'resolvedImage': input = ResolvedImage.fromString(input.toString()); break; case 'padding': input = Padding.parse(input); break; default: if (getType(input) !== propertySpec.type && (propertySpec.type !== 'enum' || !propertySpec.values[input])) { input = undefined; } } return coalesce$1(input, parameters.default, propertySpec.default); } /** * Returns a ratio that can be used to interpolate between exponential function * stops. * * How it works: * Two consecutive stop values define a (scaled and shifted) exponential * function `f(x) = a * base^x + b`, where `base` is the user-specified base, * and `a` and `b` are constants affording sufficient degrees of freedom to fit * the function to the given stops. * * Here's a bit of algebra that lets us compute `f(x)` directly from the stop * values without explicitly solving for `a` and `b`: * * First stop value: `f(x0) = y0 = a * base^x0 + b` * Second stop value: `f(x1) = y1 = a * base^x1 + b` * => `y1 - y0 = a(base^x1 - base^x0)` * => `a = (y1 - y0)/(base^x1 - base^x0)` * * Desired value: `f(x) = y = a * base^x + b` * => `f(x) = y0 + a * (base^x - base^x0)` * * From the above, we can replace the `a` in `a * (base^x - base^x0)` and do a * little algebra: * ``` * a * (base^x - base^x0) = (y1 - y0)/(base^x1 - base^x0) * (base^x - base^x0) * = (y1 - y0) * (base^x - base^x0) / (base^x1 - base^x0) * ``` * * If we let `(base^x - base^x0) / (base^x1 base^x0)`, then we have * `f(x) = y0 + (y1 - y0) * ratio`. In other words, `ratio` may be treated as * an interpolation factor between the two stops' output values. * * (Note: a slightly different form for `ratio`, * `(base^(x-x0) - 1) / (base^(x1-x0) - 1) `, is equivalent, but requires fewer * expensive `Math.pow()` operations.) * * @private */ function interpolationFactor(input, base, lowerValue, upperValue) { const difference = upperValue - lowerValue; const progress = input - lowerValue; if (difference === 0) { return 0; } else if (base === 1) { return progress / difference; } else { return (Math.pow(base, progress) - 1) / (Math.pow(base, difference) - 1); } } class StyleExpression { constructor(expression, propertySpec) { this.expression = expression; this._warningHistory = {}; this._evaluator = new EvaluationContext(); this._defaultValue = propertySpec ? getDefaultValue(propertySpec) : null; this._enumValues = propertySpec && propertySpec.type === 'enum' ? propertySpec.values : null; } evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection) { this._evaluator.globals = globals; this._evaluator.feature = feature; this._evaluator.featureState = featureState; this._evaluator.canonical = canonical; this._evaluator.availableImages = availableImages || null; this._evaluator.formattedSection = formattedSection; return this.expression.evaluate(this._evaluator); } evaluate(globals, feature, featureState, canonical, availableImages, formattedSection) { this._evaluator.globals = globals; this._evaluator.feature = feature || null; this._evaluator.featureState = featureState || null; this._evaluator.canonical = canonical; this._evaluator.availableImages = availableImages || null; this._evaluator.formattedSection = formattedSection || null; try { const val = this.expression.evaluate(this._evaluator); // eslint-disable-next-line no-self-compare if (val === null || val === undefined || (typeof val === 'number' && val !== val)) { return this._defaultValue; } if (this._enumValues && !(val in this._enumValues)) { throw new RuntimeError(`Expected value to be one of ${Object.keys(this._enumValues).map(v => JSON.stringify(v)).join(', ')}, but found ${JSON.stringify(val)} instead.`); } return val; } catch (e) { if (!this._warningHistory[e.message]) { this._warningHistory[e.message] = true; if (typeof console !== 'undefined') { console.warn(e.message); } } return this._defaultValue; } } } function isExpression(expression) { return Array.isArray(expression) && expression.length > 0 && typeof expression[0] === 'string' && expression[0] in expressions$1; } /** * Parse and typecheck the given style spec JSON expression. If * options.defaultValue is provided, then the resulting StyleExpression's * `evaluate()` method will handle errors by logging a warning (once per * message) and returning the default value. Otherwise, it will throw * evaluation errors. * * @private */ function createExpression(expression, propertySpec) { const parser = new ParsingContext(expressions$1, isExpressionConstant, [], propertySpec ? getExpectedType(propertySpec) : undefined); // For string-valued properties, coerce to string at the top level rather than asserting. const parsed = parser.parse(expression, undefined, undefined, undefined, propertySpec && propertySpec.type === 'string' ? { typeAnnotation: 'coerce' } : undefined); if (!parsed) { return error(parser.errors); } return success(new StyleExpression(parsed, propertySpec)); } class ZoomConstantExpression { constructor(kind, expression) { this.kind = kind; this._styleExpression = expression; this.isStateDependent = kind !== 'constant' && !isStateConstant(expression.expression); } evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection) { return this._styleExpression.evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection); } evaluate(globals, feature, featureState, canonical, availableImages, formattedSection) { return this._styleExpression.evaluate(globals, feature, featureState, canonical, availableImages, formattedSection); } } class ZoomDependentExpression { constructor(kind, expression, zoomStops, interpolationType) { this.kind = kind; this.zoomStops = zoomStops; this._styleExpression = expression; this.isStateDependent = kind !== 'camera' && !isStateConstant(expression.expression); this.interpolationType = interpolationType; } evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection) { return this._styleExpression.evaluateWithoutErrorHandling(globals, feature, featureState, canonical, availableImages, formattedSection); } evaluate(globals, feature, featureState, canonical, availableImages, formattedSection) { return this._styleExpression.evaluate(globals, feature, featureState, canonical, availableImages, formattedSection); } interpolationFactor(input, lower, upper) { if (this.interpolationType) { return Interpolate.interpolationFactor(this.interpolationType, input, lower, upper); } else { return 0; } } } function isZoomExpression(expression) { return expression._styleExpression !== undefined; } function createPropertyExpression(expressionInput, propertySpec) { const expression = createExpression(expressionInput, propertySpec); if (expression.result === 'error') { return expression; } const parsed = expression.value.expression; const isFeatureConstantResult = isFeatureConstant(parsed); if (!isFeatureConstantResult && !supportsPropertyExpression(propertySpec)) { return error([new ExpressionParsingError('', 'data expressions not supported')]); } const isZoomConstant = isGlobalPropertyConstant(parsed, ['zoom']); if (!isZoomConstant && !supportsZoomExpression(propertySpec)) { return error([new ExpressionParsingError('', 'zoom expressions not supported')]); } const zoomCurve = findZoomCurve(parsed); if (!zoomCurve && !isZoomConstant) { return error([new ExpressionParsingError('', '"zoom" expression may only be used as input to a top-level "step" or "interpolate" expression.')]); } else if (zoomCurve instanceof ExpressionParsingError) { return error([zoomCurve]); } else if (zoomCurve instanceof Interpolate && !supportsInterpolation(propertySpec)) { return error([new ExpressionParsingError('', '"interpolate" expressions cannot be used with this property')]); } if (!zoomCurve) { return success(isFeatureConstantResult ? new ZoomConstantExpression('constant', expression.value) : new ZoomConstantExpression('source', expression.value)); } const interpolationType = zoomCurve instanceof Interpolate ? zoomCurve.interpolation : undefined; return success(isFeatureConstantResult ? new ZoomDependentExpression('camera', expression.value, zoomCurve.labels, interpolationType) : new ZoomDependentExpression('composite', expression.value, zoomCurve.labels, interpolationType)); } // serialization wrapper for old-style stop functions normalized to the // expression interface class StylePropertyFunction { constructor(parameters, specification) { this._parameters = parameters; this._specification = specification; extendBy(this, createFunction(this._parameters, this._specification)); } static deserialize(serialized) { return new StylePropertyFunction(serialized._parameters, serialized._specification); } static serialize(input) { return { _parameters: input._parameters, _specification: input._specification }; } } function normalizePropertyExpression(value, specification) { if (isFunction$1(value)) { return new StylePropertyFunction(value, specification); } else if (isExpression(value)) { const expression = createPropertyExpression(value, specification); if (expression.result === 'error') { // this should have been caught in validation throw new Error(expression.value.map(err => `${err.key}: ${err.message}`).join(', ')); } return expression.value; } else { let constant = value; if (specification.type === 'color' && typeof value === 'string') { constant = Color.parse(value); } else if (specification.type === 'padding' && (typeof value === 'number' || Array.isArray(value))) { constant = Padding.parse(value); } else if (specification.type === 'variableAnchorOffsetCollection' && Array.isArray(value)) { constant = VariableAnchorOffsetCollection.parse(value); } return { kind: 'constant', evaluate: () => constant }; } } // Zoom-dependent expressions may only use ["zoom"] as the input to a top-level "step" or "interpolate" // expression (collectively referred to as a "curve"). The curve may be wrapped in one or more "let" or // "coalesce" expressions. function findZoomCurve(expression) { let result = null; if (expression instanceof Let) { result = findZoomCurve(expression.result); } else if (expression instanceof Coalesce) { for (const arg of expression.args) { result = findZoomCurve(arg); if (result) { break; } } } else if ((expression instanceof Step || expression instanceof Interpolate) && expression.input instanceof CompoundExpression && expression.input.name === 'zoom') { result = expression; } if (result instanceof ExpressionParsingError) { return result; } expression.eachChild((child) => { const childResult = findZoomCurve(child); if (childResult instanceof ExpressionParsingError) { result = childResult; } else if (!result && childResult) { result = new ExpressionParsingError('', '"zoom" expression may only be used as input to a top-level "step" or "interpolate" expression.'); } else if (result && childResult && result !== childResult) { result = new ExpressionParsingError('', 'Only one zoom-based "step" or "interpolate" subexpression may be used in an expression.'); } }); return result; } function getExpectedType(spec) { const types = { color: ColorType, string: StringType, number: NumberType, enum: StringType, boolean: BooleanType, formatted: FormattedType, padding: PaddingType, resolvedImage: ResolvedImageType, variableAnchorOffsetCollection: VariableAnchorOffsetCollectionType }; if (spec.type === 'array') { return array$1(types[spec.value] || ValueType, spec.length); } return types[spec.type]; } function getDefaultValue(spec) { if (spec.type === 'color' && isFunction$1(spec.default)) { // Special case for heatmap-color: it uses the 'default:' to define a // default color ramp, but createExpression expects a simple value to fall // back to in case of runtime errors return new Color(0, 0, 0, 0); } else if (spec.type === 'color') { return Color.parse(spec.default) || null; } else if (spec.type === 'padding') { return Padding.parse(spec.default) || null; } else if (spec.type === 'variableAnchorOffsetCollection') { return VariableAnchorOffsetCollection.parse(spec.default) || null; } else if (spec.default === undefined) { return null; } else { return spec.default; } } function isExpressionFilter(filter) { if (filter === true || filter === false) { return true; } if (!Array.isArray(filter) || filter.length === 0) { return false; } switch (filter[0]) { case 'has': return filter.length >= 2 && filter[1] !== '$id' && filter[1] !== '$type'; case 'in': return filter.length >= 3 && (typeof filter[1] !== 'string' || Array.isArray(filter[2])); case '!in': case '!has': case 'none': return false; case '==': case '!=': case '>': case '>=': case '<': case '<=': return filter.length !== 3 || (Array.isArray(filter[1]) || Array.isArray(filter[2])); case 'any': case 'all': for (const f of filter.slice(1)) { if (!isExpressionFilter(f) && typeof f !== 'boolean') { return false; } } return true; default: return true; } } const filterSpec = { 'type': 'boolean', 'default': false, 'transition': false, 'property-type': 'data-driven', 'expression': { 'interpolated': false, 'parameters': ['zoom', 'feature'] } }; /** * Given a filter expressed as nested arrays, return a new function * that evaluates whether a given feature (with a .properties or .tags property) * passes its test. * * @private * @param {Array} filter MapLibre filter * @returns {Function} filter-evaluating function */ function createFilter(filter) { if (filter === null || filter === undefined) { return { filter: () => true, needGeometry: false }; } if (!isExpressionFilter(filter)) { filter = convertFilter$1(filter); } const compiled = createExpression(filter, filterSpec); if (compiled.result === 'error') { throw new Error(compiled.value.map(err => `${err.key}: ${err.message}`).join(', ')); } else { const needGeometry = geometryNeeded(filter); return { filter: (globalProperties, feature, canonical) => compiled.value.evaluate(globalProperties, feature, {}, canonical), needGeometry }; } } // Comparison function to sort numbers and strings function compare(a, b) { return a < b ? -1 : a > b ? 1 : 0; } function geometryNeeded(filter) { if (!Array.isArray(filter)) return false; if (filter[0] === 'within' || filter[0] === 'distance') return true; for (let index = 1; index < filter.length; index++) { if (geometryNeeded(filter[index])) return true; } return false; } function convertFilter$1(filter) { if (!filter) return true; const op = filter[0]; if (filter.length <= 1) return (op !== 'any'); const converted = op === '==' ? convertComparisonOp$1(filter[1], filter[2], '==') : op === '!=' ? convertNegation(convertComparisonOp$1(filter[1], filter[2], '==')) : op === '<' || op === '>' || op === '<=' || op === '>=' ? convertComparisonOp$1(filter[1], filter[2], op) : op === 'any' ? convertDisjunctionOp(filter.slice(1)) : op === 'all' ? ['all'].concat(filter.slice(1).map(convertFilter$1)) : op === 'none' ? ['all'].concat(filter.slice(1).map(convertFilter$1).map(convertNegation)) : op === 'in' ? convertInOp$1(filter[1], filter.slice(2)) : op === '!in' ? convertNegation(convertInOp$1(filter[1], filter.slice(2))) : op === 'has' ? convertHasOp$1(filter[1]) : op === '!has' ? convertNegation(convertHasOp$1(filter[1])) : true; return converted; } function convertComparisonOp$1(property, value, op) { switch (property) { case '$type': return [`filter-type-${op}`, value]; case '$id': return [`filter-id-${op}`, value]; default: return [`filter-${op}`, property, value]; } } function convertDisjunctionOp(filters) { return ['any'].concat(filters.map(convertFilter$1)); } function convertInOp$1(property, values) { if (values.length === 0) { return false; } switch (property) { case '$type': return ['filter-type-in', ['literal', values]]; case '$id': return ['filter-id-in', ['literal', values]]; default: if (values.length > 200 && !values.some(v => typeof v !== typeof values[0])) { return ['filter-in-large', property, ['literal', values.sort(compare)]]; } else { return ['filter-in-small', property, ['literal', values]]; } } } function convertHasOp$1(property) { switch (property) { case '$type': return true; case '$id': return ['filter-has-id']; default: return ['filter-has', property]; } } function convertNegation(filter) { return ['!', filter]; } /* * Convert the given filter to an expression, storing the expected types for * any feature properties referenced in expectedTypes. * * These expected types are needed in order to construct preflight type checks * needed for handling 'any' filters. A preflight type check is necessary in * order to mimic legacy filters' semantics around expected type mismatches. * For example, consider the legacy filter: * * ["any", ["all", [">", "y", 0], [">", "y", 0]], [">", "x", 0]] * * Naively, we might convert this to the expression: * * ["any", ["all", [">", ["get", "y"], 0], [">", ["get", "z"], 0]], [">", ["get", "x"], 0]] * * But if we tried to evaluate this against, say `{x: 1, y: null, z: 0}`, the * [">", ["get", "y"], 0] would cause an evaluation error, leading to the * entire filter returning false. Legacy filter semantics, though, ask for * [">", "y", 0] to simply return `false` when `y` is of the wrong type, * allowing the subsequent terms of the outer "any" expression to be evaluated * (resulting, in this case, in a `true` value, because x > 0). * * We account for this by inserting a preflight type-checking expression before * each "any" term, allowing us to avoid evaluating the actual converted filter * if any type mismatches would cause it to produce an evalaution error: * * ["any", * ["case", * ["all", ["==", ["typeof", ["get", "y"]], "number"], ["==", ["typeof", ["get", "z"], "number]], * ["all", [">", ["get", "y"], 0], [">", ["get", "z"], 0]], * false * ], * ["case", * ["==", ["typeof", ["get", "x"], "number"]], * [">", ["get", "x"], 0], * false * ] * ] * * An alternative, possibly more direct approach would be to use type checks * in the conversion of each comparison operator, so that the converted version * of each individual ==, >=, etc. would mimic the legacy filter semantics. The * downside of this approach is that it can lead to many more type checks than * would otherwise be necessary: outside the context of an "any" expression, * bailing out due to a runtime type error (expression semantics) and returning * false (legacy filter semantics) are equivalent: they cause the filter to * produce a `false` result. */ function convertFilter(filter, expectedTypes = {}) { if (isExpressionFilter(filter)) return filter; if (!filter) return true; const legacyFilter = filter; const legacyOp = legacyFilter[0]; if (filter.length <= 1) return (legacyOp !== 'any'); switch (legacyOp) { case '==': case '!=': case '<': case '>': case '<=': case '>=': { const [, property, value] = filter; return convertComparisonOp(property, value, legacyOp, expectedTypes); } case 'any': { const [, ...conditions] = legacyFilter; const children = conditions.map((f) => { const types = {}; const child = convertFilter(f, types); const typechecks = runtimeTypeChecks(types); return typechecks === true ? child : ['case', typechecks, child, false]; }); return ['any', ...children]; } case 'all': { const [, ...conditions] = legacyFilter; const children = conditions.map(f => convertFilter(f, expectedTypes)); return children.length > 1 ? ['all', ...children] : children[0]; } case 'none': { const [, ...conditions] = legacyFilter; return ['!', convertFilter(['any', ...conditions], {})]; } case 'in': { const [, property, ...values] = legacyFilter; return convertInOp(property, values); } case '!in': { const [, property, ...values] = legacyFilter; return convertInOp(property, values, true); } case 'has': return convertHasOp(legacyFilter[1]); case '!has': return ['!', convertHasOp(legacyFilter[1])]; default: return true; } } // Given a set of feature properties and an expected type for each one, // construct an boolean expression that tests whether each property has the // right type. // E.g.: for {name: 'string', population: 'number'}, return // [ 'all', // ['==', ['typeof', ['get', 'name'], 'string']], // ['==', ['typeof', ['get', 'population'], 'number]] // ] function runtimeTypeChecks(expectedTypes) { const conditions = []; for (const property in expectedTypes) { const get = property === '$id' ? ['id'] : ['get', property]; conditions.push(['==', ['typeof', get], expectedTypes[property]]); } if (conditions.length === 0) return true; if (conditions.length === 1) return conditions[0]; return ['all', ...conditions]; } function convertComparisonOp(property, value, op, expectedTypes) { let get; if (property === '$type') { return [op, ['geometry-type'], value]; } else if (property === '$id') { get = ['id']; } else { get = ['get', property]; } if (expectedTypes && value !== null) { const type = typeof value; expectedTypes[property] = type; } if (op === '==' && property !== '$id' && value === null) { return [ 'all', ['has', property], // missing property != null for legacy filters ['==', get, null] ]; } else if (op === '!=' && property !== '$id' && value === null) { return [ 'any', ['!', ['has', property]], // missing property != null for legacy filters ['!=', get, null] ]; } return [op, get, value]; } function convertInOp(property, values, negate = false) { if (values.length === 0) return negate; let get; if (property === '$type') { get = ['geometry-type']; } else if (property === '$id') { get = ['id']; } else { get = ['get', property]; } // Determine if the list of values to be searched is homogenously typed. // If so (and if the type is string or number), then we can use a // [match, input, [...values], true, false] construction rather than a // bunch of `==` tests. let uniformTypes = true; const type = typeof values[0]; for (const value of values) { if (typeof value !== type) { uniformTypes = false; break; } } if (uniformTypes && (type === 'string' || type === 'number')) { // Match expressions must have unique values. const uniqueValues = values.sort().filter((v, i) => i === 0 || values[i - 1] !== v); return ['match', get, uniqueValues, !negate, negate]; } if (negate) { return ['all', ...values.map(v => ['!=', get, v])]; } else { return ['any', ...values.map(v => ['==', get, v])]; } } function convertHasOp(property) { if (property === '$type') { return true; } else if (property === '$id') { return ['!=', ['id'], null]; } else { return ['has', property]; } } function convertLiteral(value) { return typeof value === 'object' ? ['literal', value] : value; } function convertFunction(parameters, propertySpec) { let stops = parameters.stops; if (!stops) { // identity function return convertIdentityFunction(parameters, propertySpec); } const zoomAndFeatureDependent = stops && typeof stops[0][0] === 'object'; const featureDependent = zoomAndFeatureDependent || parameters.property !== undefined; const zoomDependent = zoomAndFeatureDependent || !featureDependent; stops = stops.map((stop) => { if (!featureDependent && propertySpec.tokens && typeof stop[1] === 'string') { return [stop[0], convertTokenString(stop[1])]; } return [stop[0], convertLiteral(stop[1])]; }); if (zoomAndFeatureDependent) { return convertZoomAndPropertyFunction(parameters, propertySpec, stops); } else if (zoomDependent) { return convertZoomFunction(parameters, propertySpec, stops); } else { return convertPropertyFunction(parameters, propertySpec, stops); } } function convertIdentityFunction(parameters, propertySpec) { const get = ['get', parameters.property]; if (parameters.default === undefined) { // By default, expressions for string-valued properties get coerced. To preserve // legacy function semantics, insert an explicit assertion instead. return propertySpec.type === 'string' ? ['string', get] : get; } else if (propertySpec.type === 'enum') { return [ 'match', get, Object.keys(propertySpec.values), get, parameters.default ]; } else { const expression = [propertySpec.type === 'color' ? 'to-color' : propertySpec.type, get, convertLiteral(parameters.default)]; if (propertySpec.type === 'array') { expression.splice(1, 0, propertySpec.value, propertySpec.length || null); } return expression; } } function getInterpolateOperator(parameters) { switch (parameters.colorSpace) { case 'hcl': return 'interpolate-hcl'; case 'lab': return 'interpolate-lab'; default: return 'interpolate'; } } function convertZoomAndPropertyFunction(parameters, propertySpec, stops) { const featureFunctionParameters = {}; const featureFunctionStops = {}; const zoomStops = []; for (let s = 0; s < stops.length; s++) { const stop = stops[s]; const zoom = stop[0].zoom; if (featureFunctionParameters[zoom] === undefined) { featureFunctionParameters[zoom] = { zoom, type: parameters.type, property: parameters.property, default: parameters.default, }; featureFunctionStops[zoom] = []; zoomStops.push(zoom); } featureFunctionStops[zoom].push([stop[0].value, stop[1]]); } // the interpolation type for the zoom dimension of a zoom-and-property // function is determined directly from the style property specification // for which it's being used: linear for interpolatable properties, step // otherwise. const functionType = getFunctionType({}, propertySpec); if (functionType === 'exponential') { const expression = [getInterpolateOperator(parameters), ['linear'], ['zoom']]; for (const z of zoomStops) { const output = convertPropertyFunction(featureFunctionParameters[z], propertySpec, featureFunctionStops[z]); appendStopPair(expression, z, output, false); } return expression; } else { const expression = ['step', ['zoom']]; for (const z of zoomStops) { const output = convertPropertyFunction(featureFunctionParameters[z], propertySpec, featureFunctionStops[z]); appendStopPair(expression, z, output, true); } fixupDegenerateStepCurve(expression); return expression; } } function coalesce(a, b) { if (a !== undefined) return a; if (b !== undefined) return b; } function getFallback(parameters, propertySpec) { const defaultValue = convertLiteral(coalesce(parameters.default, propertySpec.default)); /* * Some fields with type: resolvedImage have an undefined default. * Because undefined is an invalid value for resolvedImage, set fallback to * an empty string instead of undefined to ensure output * passes validation. */ if (defaultValue === undefined && propertySpec.type === 'resolvedImage') { return ''; } return defaultValue; } function convertPropertyFunction(parameters, propertySpec, stops) { const type = getFunctionType(parameters, propertySpec); const get = ['get', parameters.property]; if (type === 'categorical' && typeof stops[0][0] === 'boolean') { const expression = ['case']; for (const stop of stops) { expression.push(['==', get, stop[0]], stop[1]); } expression.push(getFallback(parameters, propertySpec)); return expression; } else if (type === 'categorical') { const expression = ['match', get]; for (const stop of stops) { appendStopPair(expression, stop[0], stop[1], false); } expression.push(getFallback(parameters, propertySpec)); return expression; } else if (type === 'interval') { const expression = ['step', ['number', get]]; for (const stop of stops) { appendStopPair(expression, stop[0], stop[1], true); } fixupDegenerateStepCurve(expression); return parameters.default === undefined ? expression : [ 'case', ['==', ['typeof', get], 'number'], expression, convertLiteral(parameters.default) ]; } else if (type === 'exponential') { const base = parameters.base !== undefined ? parameters.base : 1; const expression = [ getInterpolateOperator(parameters), base === 1 ? ['linear'] : ['exponential', base], ['number', get] ]; for (const stop of stops) { appendStopPair(expression, stop[0], stop[1], false); } return parameters.default === undefined ? expression : [ 'case', ['==', ['typeof', get], 'number'], expression, convertLiteral(parameters.default) ]; } else { throw new Error(`Unknown property function type ${type}`); } } function convertZoomFunction(parameters, propertySpec, stops, input = ['zoom']) { const type = getFunctionType(parameters, propertySpec); let expression; let isStep = false; if (type === 'interval') { expression = ['step', input]; isStep = true; } else if (type === 'exponential') { const base = parameters.base !== undefined ? parameters.base : 1; expression = [getInterpolateOperator(parameters), base === 1 ? ['linear'] : ['exponential', base], input]; } else { throw new Error(`Unknown zoom function type "${type}"`); } for (const stop of stops) { appendStopPair(expression, stop[0], stop[1], isStep); } fixupDegenerateStepCurve(expression); return expression; } function fixupDegenerateStepCurve(expression) { // degenerate step curve (i.e. a constant function): add a noop stop if (expression[0] === 'step' && expression.length === 3) { expression.push(0); expression.push(expression[3]); } } function appendStopPair(curve, input, output, isStep) { // Skip duplicate stop values. They were not validated for functions, but they are for expressions. // https://github.com/mapbox/mapbox-gl-js/issues/4107 if (curve.length > 3 && input === curve[curve.length - 2]) { return; } // step curves don't get the first input value, as it is redundant. if (!(isStep && curve.length === 2)) { curve.push(input); } curve.push(output); } function getFunctionType(parameters, propertySpec) { if (parameters.type) { return parameters.type; } else { return propertySpec.expression.interpolated ? 'exponential' : 'interval'; } } // "String with {name} token" => ["concat", "String with ", ["get", "name"], " token"] function convertTokenString(s) { const result = ['concat']; const re = /{([^{}]+)}/g; let pos = 0; for (let match = re.exec(s); match !== null; match = re.exec(s)) { const literal = s.slice(pos, re.lastIndex - match[0].length); pos = re.lastIndex; if (literal.length > 0) result.push(literal); result.push(['get', match[1]]); } if (result.length === 1) { return s; } if (pos < s.length) { result.push(s.slice(pos)); } else if (result.length === 2) { return ['to-string', result[1]]; } return result; } function getPropertyReference(propertyName) { for (let i = 0; i < v8Spec.layout.length; i++) { for (const key in v8Spec[v8Spec.layout[i]]) { if (key === propertyName) return v8Spec[v8Spec.layout[i]][key]; } } for (let i = 0; i < v8Spec.paint.length; i++) { for (const key in v8Spec[v8Spec.paint[i]]) { if (key === propertyName) return v8Spec[v8Spec.paint[i]][key]; } } return null; } function eachSource(style, callback) { for (const k in style.sources) { callback(style.sources[k]); } } function eachLayer(style, callback) { for (const layer of style.layers) { callback(layer); } } function eachProperty(style, options, callback) { function inner(layer, propertyType) { const properties = layer[propertyType]; if (!properties) return; Object.keys(properties).forEach((key) => { callback({ path: [layer.id, propertyType, key], key, value: properties[key], reference: getPropertyReference(key), set(x) { properties[key] = x; } }); }); } eachLayer(style, (layer) => { if (options.paint) { inner(layer, 'paint'); } if (options.layout) { inner(layer, 'layout'); } }); } function stringify$1(obj) { const type = typeof obj; if (type === 'number' || type === 'boolean' || type === 'string' || obj === undefined || obj === null) return JSON.stringify(obj); if (Array.isArray(obj)) { let str = '['; for (const val of obj) { str += `${stringify$1(val)},`; } return `${str}]`; } const keys = Object.keys(obj).sort(); let str = '{'; for (let i = 0; i < keys.length; i++) { str += `${JSON.stringify(keys[i])}:${stringify$1(obj[keys[i]])},`; } return `${str}}`; } function getKey(layer) { let key = ''; for (const k of refProperties) { key += `/${stringify$1(layer[k])}`; } return key; } /** * Given an array of layers, return an array of arrays of layers where all * layers in each group have identical layout-affecting properties. These * are the properties that were formerly used by explicit `ref` mechanism * for layers: 'type', 'source', 'source-layer', 'minzoom', 'maxzoom', * 'filter', and 'layout'. * * The input is not modified. The output layers are references to the * input layers. * * @private * @param {Array} layers * @param {Object} [cachedKeys] - an object to keep already calculated keys. * @returns {Array>} */ function groupByLayout(layers, cachedKeys) { const groups = {}; for (let i = 0; i < layers.length; i++) { const k = (cachedKeys && cachedKeys[layers[i].id]) || getKey(layers[i]); // update the cache if there is one if (cachedKeys) cachedKeys[layers[i].id] = k; let group = groups[k]; if (!group) { group = groups[k] = []; } group.push(layers[i]); } const result = []; for (const k in groups) { result.push(groups[k]); } return result; } function emptyStyle() { const style = {}; const version = v8Spec['$version']; for (const styleKey in v8Spec['$root']) { const spec = v8Spec['$root'][styleKey]; if (spec.required) { let value = null; if (styleKey === 'version') { value = version; } else { if (spec.type === 'array') { value = []; } else { value = {}; } } if (value != null) { style[styleKey] = value; } } } return style; } function validateConstants(options) { const key = options.key; const constants = options.value; if (constants) { return [new ValidationError(key, constants, 'constants have been deprecated as of v8')]; } else { return []; } } // Turn jsonlint-lines-primitives objects into primitive objects function unbundle(value) { if (value instanceof Number || value instanceof String || value instanceof Boolean) { return value.valueOf(); } else { return value; } } function deepUnbundle(value) { if (Array.isArray(value)) { return value.map(deepUnbundle); } else if (value instanceof Object && !(value instanceof Number || value instanceof String || value instanceof Boolean)) { const unbundledValue = {}; for (const key in value) { unbundledValue[key] = deepUnbundle(value[key]); } return unbundledValue; } return unbundle(value); } function validateObject(options) { const key = options.key; const object = options.value; const elementSpecs = options.valueSpec || {}; const elementValidators = options.objectElementValidators || {}; const style = options.style; const styleSpec = options.styleSpec; const validateSpec = options.validateSpec; let errors = []; const type = getType(object); if (type !== 'object') { return [new ValidationError(key, object, `object expected, ${type} found`)]; } for (const objectKey in object) { const elementSpecKey = objectKey.split('.')[0]; // treat 'paint.*' as 'paint' const elementSpec = elementSpecs[elementSpecKey] || elementSpecs['*']; let validateElement; if (elementValidators[elementSpecKey]) { validateElement = elementValidators[elementSpecKey]; } else if (elementSpecs[elementSpecKey]) { validateElement = validateSpec; } else if (elementValidators['*']) { validateElement = elementValidators['*']; } else if (elementSpecs['*']) { validateElement = validateSpec; } else { errors.push(new ValidationError(key, object[objectKey], `unknown property "${objectKey}"`)); continue; } errors = errors.concat(validateElement({ key: (key ? `${key}.` : key) + objectKey, value: object[objectKey], valueSpec: elementSpec, style, styleSpec, object, objectKey, validateSpec, }, object)); } for (const elementSpecKey in elementSpecs) { // Don't check `required` when there's a custom validator for that property. if (elementValidators[elementSpecKey]) { continue; } if (elementSpecs[elementSpecKey].required && elementSpecs[elementSpecKey]['default'] === undefined && object[elementSpecKey] === undefined) { errors.push(new ValidationError(key, object, `missing required property "${elementSpecKey}"`)); } } return errors; } function validateArray(options) { const array = options.value; const arraySpec = options.valueSpec; const validateSpec = options.validateSpec; const style = options.style; const styleSpec = options.styleSpec; const key = options.key; const validateArrayElement = options.arrayElementValidator || validateSpec; if (getType(array) !== 'array') { return [new ValidationError(key, array, `array expected, ${getType(array)} found`)]; } if (arraySpec.length && array.length !== arraySpec.length) { return [new ValidationError(key, array, `array length ${arraySpec.length} expected, length ${array.length} found`)]; } if (arraySpec['min-length'] && array.length < arraySpec['min-length']) { return [new ValidationError(key, array, `array length at least ${arraySpec['min-length']} expected, length ${array.length} found`)]; } let arrayElementSpec = { 'type': arraySpec.value, 'values': arraySpec.values }; if (styleSpec.$version < 7) { arrayElementSpec['function'] = arraySpec.function; } if (getType(arraySpec.value) === 'object') { arrayElementSpec = arraySpec.value; } let errors = []; for (let i = 0; i < array.length; i++) { errors = errors.concat(validateArrayElement({ array, arrayIndex: i, value: array[i], valueSpec: arrayElementSpec, validateSpec: options.validateSpec, style, styleSpec, key: `${key}[${i}]` })); } return errors; } function validateNumber(options) { const key = options.key; const value = options.value; const valueSpec = options.valueSpec; let type = getType(value); // eslint-disable-next-line no-self-compare if (type === 'number' && value !== value) { type = 'NaN'; } if (type !== 'number') { return [new ValidationError(key, value, `number expected, ${type} found`)]; } if ('minimum' in valueSpec && value < valueSpec.minimum) { return [new ValidationError(key, value, `${value} is less than the minimum value ${valueSpec.minimum}`)]; } if ('maximum' in valueSpec && value > valueSpec.maximum) { return [new ValidationError(key, value, `${value} is greater than the maximum value ${valueSpec.maximum}`)]; } return []; } function validateFunction(options) { const functionValueSpec = options.valueSpec; const functionType = unbundle(options.value.type); let stopKeyType; let stopDomainValues = {}; let previousStopDomainValue; let previousStopDomainZoom; const isZoomFunction = functionType !== 'categorical' && options.value.property === undefined; const isPropertyFunction = !isZoomFunction; const isZoomAndPropertyFunction = getType(options.value.stops) === 'array' && getType(options.value.stops[0]) === 'array' && getType(options.value.stops[0][0]) === 'object'; const errors = validateObject({ key: options.key, value: options.value, valueSpec: options.styleSpec.function, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec, objectElementValidators: { stops: validateFunctionStops, default: validateFunctionDefault } }); if (functionType === 'identity' && isZoomFunction) { errors.push(new ValidationError(options.key, options.value, 'missing required property "property"')); } if (functionType !== 'identity' && !options.value.stops) { errors.push(new ValidationError(options.key, options.value, 'missing required property "stops"')); } if (functionType === 'exponential' && options.valueSpec.expression && !supportsInterpolation(options.valueSpec)) { errors.push(new ValidationError(options.key, options.value, 'exponential functions not supported')); } if (options.styleSpec.$version >= 8) { if (isPropertyFunction && !supportsPropertyExpression(options.valueSpec)) { errors.push(new ValidationError(options.key, options.value, 'property functions not supported')); } else if (isZoomFunction && !supportsZoomExpression(options.valueSpec)) { errors.push(new ValidationError(options.key, options.value, 'zoom functions not supported')); } } if ((functionType === 'categorical' || isZoomAndPropertyFunction) && options.value.property === undefined) { errors.push(new ValidationError(options.key, options.value, '"property" property is required')); } return errors; function validateFunctionStops(options) { if (functionType === 'identity') { return [new ValidationError(options.key, options.value, 'identity function may not have a "stops" property')]; } let errors = []; const value = options.value; errors = errors.concat(validateArray({ key: options.key, value, valueSpec: options.valueSpec, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec, arrayElementValidator: validateFunctionStop })); if (getType(value) === 'array' && value.length === 0) { errors.push(new ValidationError(options.key, value, 'array must have at least one stop')); } return errors; } function validateFunctionStop(options) { let errors = []; const value = options.value; const key = options.key; if (getType(value) !== 'array') { return [new ValidationError(key, value, `array expected, ${getType(value)} found`)]; } if (value.length !== 2) { return [new ValidationError(key, value, `array length 2 expected, length ${value.length} found`)]; } if (isZoomAndPropertyFunction) { if (getType(value[0]) !== 'object') { return [new ValidationError(key, value, `object expected, ${getType(value[0])} found`)]; } if (value[0].zoom === undefined) { return [new ValidationError(key, value, 'object stop key must have zoom')]; } if (value[0].value === undefined) { return [new ValidationError(key, value, 'object stop key must have value')]; } if (previousStopDomainZoom && previousStopDomainZoom > unbundle(value[0].zoom)) { return [new ValidationError(key, value[0].zoom, 'stop zoom values must appear in ascending order')]; } if (unbundle(value[0].zoom) !== previousStopDomainZoom) { previousStopDomainZoom = unbundle(value[0].zoom); previousStopDomainValue = undefined; stopDomainValues = {}; } errors = errors.concat(validateObject({ key: `${key}[0]`, value: value[0], valueSpec: { zoom: {} }, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec, objectElementValidators: { zoom: validateNumber, value: validateStopDomainValue } })); } else { errors = errors.concat(validateStopDomainValue({ key: `${key}[0]`, value: value[0], valueSpec: {}, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec }, value)); } if (isExpression(deepUnbundle(value[1]))) { return errors.concat([new ValidationError(`${key}[1]`, value[1], 'expressions are not allowed in function stops.')]); } return errors.concat(options.validateSpec({ key: `${key}[1]`, value: value[1], valueSpec: functionValueSpec, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec })); } function validateStopDomainValue(options, stop) { const type = getType(options.value); const value = unbundle(options.value); const reportValue = options.value !== null ? options.value : stop; if (!stopKeyType) { stopKeyType = type; } else if (type !== stopKeyType) { return [new ValidationError(options.key, reportValue, `${type} stop domain type must match previous stop domain type ${stopKeyType}`)]; } if (type !== 'number' && type !== 'string' && type !== 'boolean') { return [new ValidationError(options.key, reportValue, 'stop domain value must be a number, string, or boolean')]; } if (type !== 'number' && functionType !== 'categorical') { let message = `number expected, ${type} found`; if (supportsPropertyExpression(functionValueSpec) && functionType === undefined) { message += '\nIf you intended to use a categorical function, specify `"type": "categorical"`.'; } return [new ValidationError(options.key, reportValue, message)]; } if (functionType === 'categorical' && type === 'number' && (!isFinite(value) || Math.floor(value) !== value)) { return [new ValidationError(options.key, reportValue, `integer expected, found ${value}`)]; } if (functionType !== 'categorical' && type === 'number' && previousStopDomainValue !== undefined && value < previousStopDomainValue) { return [new ValidationError(options.key, reportValue, 'stop domain values must appear in ascending order')]; } else { previousStopDomainValue = value; } if (functionType === 'categorical' && value in stopDomainValues) { return [new ValidationError(options.key, reportValue, 'stop domain values must be unique')]; } else { stopDomainValues[value] = true; } return []; } function validateFunctionDefault(options) { return options.validateSpec({ key: options.key, value: options.value, valueSpec: functionValueSpec, validateSpec: options.validateSpec, style: options.style, styleSpec: options.styleSpec }); } } function validateExpression(options) { const expression = (options.expressionContext === 'property' ? createPropertyExpression : createExpression)(deepUnbundle(options.value), options.valueSpec); if (expression.result === 'error') { return expression.value.map((error) => { return new ValidationError(`${options.key}${error.key}`, options.value, error.message); }); } const expressionObj = expression.value.expression || expression.value._styleExpression.expression; if (options.expressionContext === 'property' && (options.propertyKey === 'text-font') && !expressionObj.outputDefined()) { return [new ValidationError(options.key, options.value, `Invalid data expression for "${options.propertyKey}". Output values must be contained as literals within the expression.`)]; } if (options.expressionContext === 'property' && options.propertyType === 'layout' && (!isStateConstant(expressionObj))) { return [new ValidationError(options.key, options.value, '"feature-state" data expressions are not supported with layout properties.')]; } if (options.expressionContext === 'filter' && !isStateConstant(expressionObj)) { return [new ValidationError(options.key, options.value, '"feature-state" data expressions are not supported with filters.')]; } if (options.expressionContext && options.expressionContext.indexOf('cluster') === 0) { if (!isGlobalPropertyConstant(expressionObj, ['zoom', 'feature-state'])) { return [new ValidationError(options.key, options.value, '"zoom" and "feature-state" expressions are not supported with cluster properties.')]; } if (options.expressionContext === 'cluster-initial' && !isFeatureConstant(expressionObj)) { return [new ValidationError(options.key, options.value, 'Feature data expressions are not supported with initial expression part of cluster properties.')]; } } return []; } function validateBoolean(options) { const value = options.value; const key = options.key; const type = getType(value); if (type !== 'boolean') { return [new ValidationError(key, value, `boolean expected, ${type} found`)]; } return []; } function validateColor(options) { const key = options.key; const value = options.value; const type = getType(value); if (type !== 'string') { return [new ValidationError(key, value, `color expected, ${type} found`)]; } if (!Color.parse(String(value))) { // cast String object to string primitive return [new ValidationError(key, value, `color expected, "${value}" found`)]; } return []; } function validateEnum(options) { const key = options.key; const value = options.value; const valueSpec = options.valueSpec; const errors = []; if (Array.isArray(valueSpec.values)) { // <=v7 if (valueSpec.values.indexOf(unbundle(value)) === -1) { errors.push(new ValidationError(key, value, `expected one of [${valueSpec.values.join(', ')}], ${JSON.stringify(value)} found`)); } } else { // >=v8 if (Object.keys(valueSpec.values).indexOf(unbundle(value)) === -1) { errors.push(new ValidationError(key, value, `expected one of [${Object.keys(valueSpec.values).join(', ')}], ${JSON.stringify(value)} found`)); } } return errors; } function validateFilter$1(options) { if (isExpressionFilter(deepUnbundle(options.value))) { return validateExpression(extendBy({}, options, { expressionContext: 'filter', valueSpec: { value: 'boolean' } })); } else { return validateNonExpressionFilter(options); } } function validateNonExpressionFilter(options) { const value = options.value; const key = options.key; if (getType(value) !== 'array') { return [new ValidationError(key, value, `array expected, ${getType(value)} found`)]; } const styleSpec = options.styleSpec; let type; let errors = []; if (value.length < 1) { return [new ValidationError(key, value, 'filter array must have at least 1 element')]; } errors = errors.concat(validateEnum({ key: `${key}[0]`, value: value[0], valueSpec: styleSpec.filter_operator, style: options.style, styleSpec: options.styleSpec })); switch (unbundle(value[0])) { case '<': case '<=': case '>': case '>=': if (value.length >= 2 && unbundle(value[1]) === '$type') { errors.push(new ValidationError(key, value, `"$type" cannot be use with operator "${value[0]}"`)); } /* falls through */ case '==': case '!=': if (value.length !== 3) { errors.push(new ValidationError(key, value, `filter array for operator "${value[0]}" must have 3 elements`)); } /* falls through */ case 'in': case '!in': if (value.length >= 2) { type = getType(value[1]); if (type !== 'string') { errors.push(new ValidationError(`${key}[1]`, value[1], `string expected, ${type} found`)); } } for (let i = 2; i < value.length; i++) { type = getType(value[i]); if (unbundle(value[1]) === '$type') { errors = errors.concat(validateEnum({ key: `${key}[${i}]`, value: value[i], valueSpec: styleSpec.geometry_type, style: options.style, styleSpec: options.styleSpec })); } else if (type !== 'string' && type !== 'number' && type !== 'boolean') { errors.push(new ValidationError(`${key}[${i}]`, value[i], `string, number, or boolean expected, ${type} found`)); } } break; case 'any': case 'all': case 'none': for (let i = 1; i < value.length; i++) { errors = errors.concat(validateNonExpressionFilter({ key: `${key}[${i}]`, value: value[i], style: options.style, styleSpec: options.styleSpec })); } break; case 'has': case '!has': type = getType(value[1]); if (value.length !== 2) { errors.push(new ValidationError(key, value, `filter array for "${value[0]}" operator must have 2 elements`)); } else if (type !== 'string') { errors.push(new ValidationError(`${key}[1]`, value[1], `string expected, ${type} found`)); } break; } return errors; } function validateProperty(options, propertyType) { const key = options.key; const validateSpec = options.validateSpec; const style = options.style; const styleSpec = options.styleSpec; const value = options.value; const propertyKey = options.objectKey; const layerSpec = styleSpec[`${propertyType}_${options.layerType}`]; if (!layerSpec) return []; const transitionMatch = propertyKey.match(/^(.*)-transition$/); if (propertyType === 'paint' && transitionMatch && layerSpec[transitionMatch[1]] && layerSpec[transitionMatch[1]].transition) { return validateSpec({ key, value, valueSpec: styleSpec.transition, style, styleSpec }); } const valueSpec = options.valueSpec || layerSpec[propertyKey]; if (!valueSpec) { return [new ValidationError(key, value, `unknown property "${propertyKey}"`)]; } let tokenMatch; if (getType(value) === 'string' && supportsPropertyExpression(valueSpec) && !valueSpec.tokens && (tokenMatch = /^{([^}]+)}$/.exec(value))) { return [new ValidationError(key, value, `"${propertyKey}" does not support interpolation syntax\n` + `Use an identity property function instead: \`{ "type": "identity", "property": ${JSON.stringify(tokenMatch[1])} }\`.`)]; } const errors = []; if (options.layerType === 'symbol') { if (propertyKey === 'text-field' && style && !style.glyphs) { errors.push(new ValidationError(key, value, 'use of "text-field" requires a style "glyphs" property')); } if (propertyKey === 'text-font' && isFunction$1(deepUnbundle(value)) && unbundle(value.type) === 'identity') { errors.push(new ValidationError(key, value, '"text-font" does not support identity functions')); } } return errors.concat(validateSpec({ key: options.key, value, valueSpec, style, styleSpec, expressionContext: 'property', propertyType, propertyKey })); } function validatePaintProperty$1(options) { return validateProperty(options, 'paint'); } function validateLayoutProperty$1(options) { return validateProperty(options, 'layout'); } function validateLayer(options) { let errors = []; const layer = options.value; const key = options.key; const style = options.style; const styleSpec = options.styleSpec; if (!layer.type && !layer.ref) { errors.push(new ValidationError(key, layer, 'either "type" or "ref" is required')); } let type = unbundle(layer.type); const ref = unbundle(layer.ref); if (layer.id) { const layerId = unbundle(layer.id); for (let i = 0; i < options.arrayIndex; i++) { const otherLayer = style.layers[i]; if (unbundle(otherLayer.id) === layerId) { errors.push(new ValidationError(key, layer.id, `duplicate layer id "${layer.id}", previously used at line ${otherLayer.id.__line__}`)); } } } if ('ref' in layer) { ['type', 'source', 'source-layer', 'filter', 'layout'].forEach((p) => { if (p in layer) { errors.push(new ValidationError(key, layer[p], `"${p}" is prohibited for ref layers`)); } }); let parent; style.layers.forEach((layer) => { if (unbundle(layer.id) === ref) parent = layer; }); if (!parent) { errors.push(new ValidationError(key, layer.ref, `ref layer "${ref}" not found`)); } else if (parent.ref) { errors.push(new ValidationError(key, layer.ref, 'ref cannot reference another ref layer')); } else { type = unbundle(parent.type); } } else if (type !== 'background') { if (!layer.source) { errors.push(new ValidationError(key, layer, 'missing required property "source"')); } else { const source = style.sources && style.sources[layer.source]; const sourceType = source && unbundle(source.type); if (!source) { errors.push(new ValidationError(key, layer.source, `source "${layer.source}" not found`)); } else if (sourceType === 'vector' && type === 'raster') { errors.push(new ValidationError(key, layer.source, `layer "${layer.id}" requires a raster source`)); } else if (sourceType !== 'raster-dem' && type === 'hillshade') { errors.push(new ValidationError(key, layer.source, `layer "${layer.id}" requires a raster-dem source`)); } else if (sourceType === 'raster' && type !== 'raster') { errors.push(new ValidationError(key, layer.source, `layer "${layer.id}" requires a vector source`)); } else if (sourceType === 'vector' && !layer['source-layer']) { errors.push(new ValidationError(key, layer, `layer "${layer.id}" must specify a "source-layer"`)); } else if (sourceType === 'raster-dem' && type !== 'hillshade') { errors.push(new ValidationError(key, layer.source, 'raster-dem source can only be used with layer type \'hillshade\'.')); } else if (type === 'line' && layer.paint && layer.paint['line-gradient'] && (sourceType !== 'geojson' || !source.lineMetrics)) { errors.push(new ValidationError(key, layer, `layer "${layer.id}" specifies a line-gradient, which requires a GeoJSON source with \`lineMetrics\` enabled.`)); } } } errors = errors.concat(validateObject({ key, value: layer, valueSpec: styleSpec.layer, style: options.style, styleSpec: options.styleSpec, validateSpec: options.validateSpec, objectElementValidators: { '*'() { return []; }, // We don't want to enforce the spec's `"requires": true` for backward compatibility with refs; // the actual requirement is validated above. See https://github.com/mapbox/mapbox-gl-js/issues/5772. type() { return options.validateSpec({ key: `${key}.type`, value: layer.type, valueSpec: styleSpec.layer.type, style: options.style, styleSpec: options.styleSpec, validateSpec: options.validateSpec, object: layer, objectKey: 'type' }); }, filter: validateFilter$1, layout(options) { return validateObject({ layer, key: options.key, value: options.value, style: options.style, styleSpec: options.styleSpec, validateSpec: options.validateSpec, objectElementValidators: { '*'(options) { return validateLayoutProperty$1(extendBy({ layerType: type }, options)); } } }); }, paint(options) { return validateObject({ layer, key: options.key, value: options.value, style: options.style, styleSpec: options.styleSpec, validateSpec: options.validateSpec, objectElementValidators: { '*'(options) { return validatePaintProperty$1(extendBy({ layerType: type }, options)); } } }); } } })); return errors; } function validateString(options) { const value = options.value; const key = options.key; const type = getType(value); if (type !== 'string') { return [new ValidationError(key, value, `string expected, ${type} found`)]; } return []; } function validateRasterDEMSource(options) { var _a; const sourceName = (_a = options.sourceName) !== null && _a !== void 0 ? _a : ''; const rasterDEM = options.value; const styleSpec = options.styleSpec; const rasterDEMSpec = styleSpec.source_raster_dem; const style = options.style; let errors = []; const rootType = getType(rasterDEM); if (rasterDEM === undefined) { return errors; } else if (rootType !== 'object') { errors.push(new ValidationError('source_raster_dem', rasterDEM, `object expected, ${rootType} found`)); return errors; } const encoding = unbundle(rasterDEM.encoding); const isCustomEncoding = encoding === 'custom'; const customEncodingKeys = ['redFactor', 'greenFactor', 'blueFactor', 'baseShift']; const encodingName = options.value.encoding ? `"${options.value.encoding}"` : 'Default'; for (const key in rasterDEM) { if (!isCustomEncoding && customEncodingKeys.includes(key)) { errors.push(new ValidationError(key, rasterDEM[key], `In "${sourceName}": "${key}" is only valid when "encoding" is set to "custom". ${encodingName} encoding found`)); } else if (rasterDEMSpec[key]) { errors = errors.concat(options.validateSpec({ key, value: rasterDEM[key], valueSpec: rasterDEMSpec[key], validateSpec: options.validateSpec, style, styleSpec })); } else { errors.push(new ValidationError(key, rasterDEM[key], `unknown property "${key}"`)); } } return errors; } const objectElementValidators = { promoteId: validatePromoteId }; function validateSource$1(options) { const value = options.value; const key = options.key; const styleSpec = options.styleSpec; const style = options.style; const validateSpec = options.validateSpec; if (!value.type) { return [new ValidationError(key, value, '"type" is required')]; } const type = unbundle(value.type); let errors; switch (type) { case 'vector': case 'raster': errors = validateObject({ key, value, valueSpec: styleSpec[`source_${type.replace('-', '_')}`], style: options.style, styleSpec, objectElementValidators, validateSpec, }); return errors; case 'raster-dem': errors = validateRasterDEMSource({ sourceName: key, value, style: options.style, styleSpec, validateSpec, }); return errors; case 'geojson': errors = validateObject({ key, value, valueSpec: styleSpec.source_geojson, style, styleSpec, validateSpec, objectElementValidators }); if (value.cluster) { for (const prop in value.clusterProperties) { const [operator, mapExpr] = value.clusterProperties[prop]; const reduceExpr = typeof operator === 'string' ? [operator, ['accumulated'], ['get', prop]] : operator; errors.push(...validateExpression({ key: `${key}.${prop}.map`, value: mapExpr, validateSpec, expressionContext: 'cluster-map' })); errors.push(...validateExpression({ key: `${key}.${prop}.reduce`, value: reduceExpr, validateSpec, expressionContext: 'cluster-reduce' })); } } return errors; case 'video': return validateObject({ key, value, valueSpec: styleSpec.source_video, style, validateSpec, styleSpec }); case 'image': return validateObject({ key, value, valueSpec: styleSpec.source_image, style, validateSpec, styleSpec }); case 'canvas': return [new ValidationError(key, null, 'Please use runtime APIs to add canvas sources, rather than including them in stylesheets.', 'source.canvas')]; default: return validateEnum({ key: `${key}.type`, value: value.type, valueSpec: { values: ['vector', 'raster', 'raster-dem', 'geojson', 'video', 'image'] }, style, validateSpec, styleSpec }); } } function validatePromoteId({ key, value }) { if (getType(value) === 'string') { return validateString({ key, value }); } else { const errors = []; for (const prop in value) { errors.push(...validateString({ key: `${key}.${prop}`, value: value[prop] })); } return errors; } } function validateLight$1(options) { const light = options.value; const styleSpec = options.styleSpec; const lightSpec = styleSpec.light; const style = options.style; let errors = []; const rootType = getType(light); if (light === undefined) { return errors; } else if (rootType !== 'object') { errors = errors.concat([new ValidationError('light', light, `object expected, ${rootType} found`)]); return errors; } for (const key in light) { const transitionMatch = key.match(/^(.*)-transition$/); if (transitionMatch && lightSpec[transitionMatch[1]] && lightSpec[transitionMatch[1]].transition) { errors = errors.concat(options.validateSpec({ key, value: light[key], valueSpec: styleSpec.transition, validateSpec: options.validateSpec, style, styleSpec })); } else if (lightSpec[key]) { errors = errors.concat(options.validateSpec({ key, value: light[key], valueSpec: lightSpec[key], validateSpec: options.validateSpec, style, styleSpec })); } else { errors = errors.concat([new ValidationError(key, light[key], `unknown property "${key}"`)]); } } return errors; } function validateSky$1(options) { const sky = options.value; const styleSpec = options.styleSpec; const skySpec = styleSpec.sky; const style = options.style; const rootType = getType(sky); if (sky === undefined) { return []; } else if (rootType !== 'object') { return [new ValidationError('sky', sky, `object expected, ${rootType} found`)]; } let errors = []; for (const key in sky) { if (skySpec[key]) { errors = errors.concat(options.validateSpec({ key, value: sky[key], valueSpec: skySpec[key], style, styleSpec })); } else { errors = errors.concat([new ValidationError(key, sky[key], `unknown property "${key}"`)]); } } return errors; } function validateTerrain$1(options) { const terrain = options.value; const styleSpec = options.styleSpec; const terrainSpec = styleSpec.terrain; const style = options.style; let errors = []; const rootType = getType(terrain); if (terrain === undefined) { return errors; } else if (rootType !== 'object') { errors = errors.concat([new ValidationError('terrain', terrain, `object expected, ${rootType} found`)]); return errors; } for (const key in terrain) { if (terrainSpec[key]) { errors = errors.concat(options.validateSpec({ key, value: terrain[key], valueSpec: terrainSpec[key], validateSpec: options.validateSpec, style, styleSpec })); } else { errors = errors.concat([new ValidationError(key, terrain[key], `unknown property "${key}"`)]); } } return errors; } function validateFormatted(options) { if (validateString(options).length === 0) { return []; } return validateExpression(options); } function validateImage(options) { if (validateString(options).length === 0) { return []; } return validateExpression(options); } function validatePadding(options) { const key = options.key; const value = options.value; const type = getType(value); if (type === 'array') { if (value.length < 1 || value.length > 4) { return [new ValidationError(key, value, `padding requires 1 to 4 values; ${value.length} values found`)]; } const arrayElementSpec = { type: 'number' }; let errors = []; for (let i = 0; i < value.length; i++) { errors = errors.concat(options.validateSpec({ key: `${key}[${i}]`, value: value[i], validateSpec: options.validateSpec, valueSpec: arrayElementSpec })); } return errors; } else { return validateNumber({ key, value, valueSpec: {} }); } } function validateVariableAnchorOffsetCollection(options) { const key = options.key; const value = options.value; const type = getType(value); const styleSpec = options.styleSpec; if (type !== 'array' || value.length < 1 || value.length % 2 !== 0) { return [new ValidationError(key, value, 'variableAnchorOffsetCollection requires a non-empty array of even length')]; } let errors = []; for (let i = 0; i < value.length; i += 2) { // Elements in even positions should be values from text-anchor enum errors = errors.concat(validateEnum({ key: `${key}[${i}]`, value: value[i], valueSpec: styleSpec['layout_symbol']['text-anchor'] })); // Elements in odd positions should be points (2-element numeric arrays) errors = errors.concat(validateArray({ key: `${key}[${i + 1}]`, value: value[i + 1], valueSpec: { length: 2, value: 'number' }, validateSpec: options.validateSpec, style: options.style, styleSpec })); } return errors; } function validateSprite(options) { let errors = []; const sprite = options.value; const key = options.key; if (!Array.isArray(sprite)) { return validateString({ key, value: sprite }); } else { const allSpriteIds = []; const allSpriteURLs = []; for (const i in sprite) { if (sprite[i].id && allSpriteIds.includes(sprite[i].id)) errors.push(new ValidationError(key, sprite, `all the sprites' ids must be unique, but ${sprite[i].id} is duplicated`)); allSpriteIds.push(sprite[i].id); if (sprite[i].url && allSpriteURLs.includes(sprite[i].url)) errors.push(new ValidationError(key, sprite, `all the sprites' URLs must be unique, but ${sprite[i].url} is duplicated`)); allSpriteURLs.push(sprite[i].url); const pairSpec = { id: { type: 'string', required: true, }, url: { type: 'string', required: true, } }; errors = errors.concat(validateObject({ key: `${key}[${i}]`, value: sprite[i], valueSpec: pairSpec, validateSpec: options.validateSpec, })); } return errors; } } function validateProjection(options) { const projection = options.value; const styleSpec = options.styleSpec; const projectionSpec = styleSpec.projection; const style = options.style; const rootType = getType(projection); if (projection === undefined) { return []; } else if (rootType !== 'object') { return [new ValidationError('projection', projection, `object expected, ${rootType} found`)]; } let errors = []; for (const key in projection) { if (projectionSpec[key]) { errors = errors.concat(options.validateSpec({ key, value: projection[key], valueSpec: projectionSpec[key], style, styleSpec })); } else { errors = errors.concat([new ValidationError(key, projection[key], `unknown property "${key}"`)]); } } return errors; } const VALIDATORS = { '*'() { return []; }, 'array': validateArray, 'boolean': validateBoolean, 'number': validateNumber, 'color': validateColor, 'constants': validateConstants, 'enum': validateEnum, 'filter': validateFilter$1, 'function': validateFunction, 'layer': validateLayer, 'object': validateObject, 'source': validateSource$1, 'light': validateLight$1, 'sky': validateSky$1, 'terrain': validateTerrain$1, 'projection': validateProjection, 'string': validateString, 'formatted': validateFormatted, 'resolvedImage': validateImage, 'padding': validatePadding, 'variableAnchorOffsetCollection': validateVariableAnchorOffsetCollection, 'sprite': validateSprite, }; /** * Main recursive validation function used internally. * You should use `validateStyleMin` in the browser or `validateStyle` in node env. * @param options - the options object * @param options.key - string representing location of validation in style tree. Used only * for more informative error reporting. * @param options.value - current value from style being evaluated. May be anything from a * high level object that needs to be descended into deeper or a simple * scalar value. * @param options.valueSpec - current spec being evaluated. Tracks value. * @param options.styleSpec - current full spec being evaluated. * @param options.validateSpec - the validate function itself * @param options.style - the style object * @param options.objectElementValidators - optional object of functions that will be called * @returns an array of errors, or an empty array if no errors are found. */ function validate(options) { const value = options.value; const valueSpec = options.valueSpec; const styleSpec = options.styleSpec; options.validateSpec = validate; if (valueSpec.expression && isFunction$1(unbundle(value))) { return validateFunction(options); } else if (valueSpec.expression && isExpression(deepUnbundle(value))) { return validateExpression(options); } else if (valueSpec.type && VALIDATORS[valueSpec.type]) { return VALIDATORS[valueSpec.type](options); } else { const valid = validateObject(extendBy({}, options, { valueSpec: valueSpec.type ? styleSpec[valueSpec.type] : valueSpec })); return valid; } } function validateGlyphsUrl(options) { const value = options.value; const key = options.key; const errors = validateString(options); if (errors.length) return errors; if (value.indexOf('{fontstack}') === -1) { errors.push(new ValidationError(key, value, '"glyphs" url must include a "{fontstack}" token')); } if (value.indexOf('{range}') === -1) { errors.push(new ValidationError(key, value, '"glyphs" url must include a "{range}" token')); } return errors; } /** * Validate a MapLibre style against the style specification. * Use this when running in the browser. * * @param style - The style to be validated. * @param styleSpec - The style specification to validate against. * If omitted, the latest style spec is used. * @returns an array of errors, or an empty array if no errors are found. * @example * const validate = require('@maplibre/maplibre-gl-style-spec/').validateStyleMin; * const errors = validate(style); */ function validateStyleMin(style, styleSpec = v8Spec) { let errors = []; errors = errors.concat(validate({ key: '', value: style, valueSpec: styleSpec.$root, styleSpec, style, validateSpec: validate, objectElementValidators: { glyphs: validateGlyphsUrl, '*'() { return []; } } })); if (style['constants']) { errors = errors.concat(validateConstants({ key: 'constants', value: style['constants'], style, styleSpec, validateSpec: validate, })); } return sortErrors(errors); } validateStyleMin.source = wrapCleanErrors(injectValidateSpec(validateSource$1)); validateStyleMin.sprite = wrapCleanErrors(injectValidateSpec(validateSprite)); validateStyleMin.glyphs = wrapCleanErrors(injectValidateSpec(validateGlyphsUrl)); validateStyleMin.light = wrapCleanErrors(injectValidateSpec(validateLight$1)); validateStyleMin.sky = wrapCleanErrors(injectValidateSpec(validateSky$1)); validateStyleMin.terrain = wrapCleanErrors(injectValidateSpec(validateTerrain$1)); validateStyleMin.layer = wrapCleanErrors(injectValidateSpec(validateLayer)); validateStyleMin.filter = wrapCleanErrors(injectValidateSpec(validateFilter$1)); validateStyleMin.paintProperty = wrapCleanErrors(injectValidateSpec(validatePaintProperty$1)); validateStyleMin.layoutProperty = wrapCleanErrors(injectValidateSpec(validateLayoutProperty$1)); function injectValidateSpec(validator) { return function (options) { return validator({ ...options, validateSpec: validate, }); }; } function sortErrors(errors) { return [].concat(errors).sort((a, b) => { return a.line - b.line; }); } function wrapCleanErrors(inner) { return function (...args) { return sortErrors(inner.apply(this, args)); }; } // Note: This regex matches even invalid JSON strings, but since we’re // working on the output of `JSON.stringify` we know that only valid strings // are present (unless the user supplied a weird `options.indent` but in // that case we don’t care since the output would be invalid anyway). const stringOrChar = /("(?:[^\\"]|\\.)*")|[:,]/g; function stringify(passedObj, options = {}) { const indent = JSON.stringify( [1], undefined, options.indent === undefined ? 2 : options.indent ).slice(2, -3); const maxLength = indent === "" ? Infinity : options.maxLength === undefined ? 80 : options.maxLength; let { replacer } = options; return (function _stringify(obj, currentIndent, reserved) { if (obj && typeof obj.toJSON === "function") { obj = obj.toJSON(); } const string = JSON.stringify(obj, replacer); if (string === undefined) { return string; } const length = maxLength - currentIndent.length - reserved; if (string.length <= length) { const prettified = string.replace( stringOrChar, (match, stringLiteral) => { return stringLiteral || `${match} `; } ); if (prettified.length <= length) { return prettified; } } if (replacer != null) { obj = JSON.parse(string); replacer = undefined; } if (typeof obj === "object" && obj !== null) { const nextIndent = currentIndent + indent; const items = []; let index = 0; let start; let end; if (Array.isArray(obj)) { start = "["; end = "]"; const { length } = obj; for (; index < length; index++) { items.push( _stringify(obj[index], nextIndent, index === length - 1 ? 0 : 1) || "null" ); } } else { start = "{"; end = "}"; const keys = Object.keys(obj); const { length } = keys; for (; index < length; index++) { const key = keys[index]; const keyPart = `${JSON.stringify(key)}: `; const value = _stringify( obj[key], nextIndent, keyPart.length + (index === length - 1 ? 0 : 1) ); if (value !== undefined) { items.push(keyPart + value); } } } if (items.length > 0) { return [start, indent + items.join(`,\n${nextIndent}`), end].join( `\n${currentIndent}` ); } } return string; })(passedObj, "", 0); } function sortKeysBy(obj, reference) { const result = {}; for (const key in reference) { if (obj[key] !== undefined) { result[key] = obj[key]; } } for (const key in obj) { if (result[key] === undefined) { result[key] = obj[key]; } } return result; } /** * Format a MapLibre Style. Returns a stringified style with its keys * sorted in the same order as the reference style. * * The optional `space` argument is passed to * [`JSON.stringify`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) * to generate formatted output. * * If `space` is unspecified, a default of `2` spaces will be used. * * @private * @param {Object} style a MapLibre Style * @param {number} [space] space argument to pass to `JSON.stringify` * @returns {string} stringified formatted JSON * @example * var fs = require('fs'); * var format = require('maplibre-gl-style-spec').format; * var style = fs.readFileSync('./source.json', 'utf8'); * fs.writeFileSync('./dest.json', format(style)); * fs.writeFileSync('./dest.min.json', format(style, 0)); */ function format(style, space = 2) { style = sortKeysBy(style, v8Spec.$root); if (style.layers) { style.layers = style.layers.map((layer) => sortKeysBy(layer, v8Spec.layer)); } return stringify(style, { indent: space }); } function eachLayout(layer, callback) { for (const k in layer) { if (k.indexOf('layout') === 0) { callback(layer[k], k); } } } function eachPaint(layer, callback) { for (const k in layer) { if (k.indexOf('paint') === 0) { callback(layer[k], k); } } } function resolveConstant(style, value) { if (typeof value === 'string' && value[0] === '@') { return resolveConstant(style, style.constants[value]); } else { return value; } } function isFunction(value) { return Array.isArray(value.stops); } function renameProperty(obj, from, to) { obj[to] = obj[from]; delete obj[from]; } function migrateV8(style) { style.version = 8; // Rename properties, reverse coordinates in source and layers eachSource(style, (source) => { if (source.type === 'video' && source['url'] !== undefined) { renameProperty(source, 'url', 'urls'); } if (source.type === 'video') { source.coordinates.forEach((coord) => { return coord.reverse(); }); } }); eachLayer(style, (layer) => { eachLayout(layer, (layout) => { if (layout['symbol-min-distance'] !== undefined) { renameProperty(layout, 'symbol-min-distance', 'symbol-spacing'); } }); eachPaint(layer, (paint) => { if (paint['background-image'] !== undefined) { renameProperty(paint, 'background-image', 'background-pattern'); } if (paint['line-image'] !== undefined) { renameProperty(paint, 'line-image', 'line-pattern'); } if (paint['fill-image'] !== undefined) { renameProperty(paint, 'fill-image', 'fill-pattern'); } }); }); // Inline Constants eachProperty(style, { paint: true, layout: true }, (property) => { const value = resolveConstant(style, property.value); if (isFunction(value)) { value.stops.forEach((stop) => { stop[1] = resolveConstant(style, stop[1]); }); } property.set(value); }); delete style['constants']; eachLayer(style, (layer) => { // get rid of text-max-size, icon-max-size // turn text-size, icon-size into layout properties // https://github.com/mapbox/mapbox-gl-style-spec/issues/255 eachLayout(layer, (layout) => { delete layout['text-max-size']; delete layout['icon-max-size']; }); eachPaint(layer, (paint) => { if (paint['text-size']) { if (!layer.layout) layer.layout = {}; layer.layout['text-size'] = paint['text-size']; delete paint['text-size']; } if (paint['icon-size']) { if (!layer.layout) layer.layout = {}; layer.layout['icon-size'] = paint['icon-size']; delete paint['icon-size']; } }); }); function migrateFontStack(font) { function splitAndTrim(string) { return string.split(',').map((s) => { return s.trim(); }); } if (Array.isArray(font)) { // Assume it's a previously migrated font-array. return font; } else if (typeof font === 'string') { return splitAndTrim(font); } else if (typeof font === 'object') { font.stops.forEach((stop) => { stop[1] = splitAndTrim(stop[1]); }); return font; } else { throw new Error('unexpected font value'); } } eachLayer(style, (layer) => { eachLayout(layer, (layout) => { if (layout['text-font']) { layout['text-font'] = migrateFontStack(layout['text-font']); } }); }); // Reverse order of symbol layers. This is an imperfect migration. // // The order of a symbol layer in the layers list affects two things: // - how it is drawn relative to other layers (like oneway arrows below bridges) // - the placement priority compared to other layers // // It's impossible to reverse the placement priority without breaking the draw order // in some cases. This migration only reverses the order of symbol layers that // are above all other types of layers. // // Symbol layers that are at the top of the map preserve their priority. // Symbol layers that are below another type (line, fill) of layer preserve their draw order. let firstSymbolLayer = 0; for (let i = style.layers.length - 1; i >= 0; i--) { const layer = style.layers[i]; if (layer.type !== 'symbol') { firstSymbolLayer = i + 1; break; } } const symbolLayers = style.layers.splice(firstSymbolLayer); symbolLayers.reverse(); style.layers = style.layers.concat(symbolLayers); return style; } /** * Migrate the given style object in place to use expressions. Specifically, * this will convert (a) "stop" functions, and (b) legacy filters to their * expression equivalents. * @param style The style object to migrate. * @returns The migrated style object. */ function expressions(style) { const converted = []; eachLayer(style, (layer) => { if (layer.filter) { layer.filter = convertFilter(layer.filter); } }); eachProperty(style, { paint: true, layout: true }, ({ path, value, reference, set }) => { if (isExpression(value)) return; if (typeof value === 'object' && !Array.isArray(value)) { set(convertFunction(value, reference)); converted.push(path.join('.')); } else if (reference.tokens && typeof value === 'string') { set(convertTokenString(value)); } }); return style; } /** * Migrate color style values to supported format. * * @param colorToMigrate Color value to migrate, could be a string or an expression. * @returns Color style value in supported format. */ function migrateColors(colorToMigrate) { return JSON.parse(migrateHslColors(JSON.stringify(colorToMigrate))); } /** * Created to migrate from colors supported by the former CSS color parsing * library `csscolorparser` but not compliant with the CSS Color specification, * like `hsl(900, 0.15, 90%)`. * * @param colorToMigrate Serialized color style value. * @returns A serialized color style value in which all non-standard hsl color values * have been converted to a format that complies with the CSS Color specification. * * @example * migrateHslColors('"hsl(900, 0.15, 90%)"'); // returns '"hsl(900, 15%, 90%)"' * migrateHslColors('"hsla(900, .15, .9)"'); // returns '"hsl(900, 15%, 90%)"' * migrateHslColors('"hsl(900, 15%, 90%)"'); // returns '"hsl(900, 15%, 90%)"' - no changes */ function migrateHslColors(colorToMigrate) { return colorToMigrate.replace(/"hsla?\((.+?)\)"/gi, (match, hslArgs) => { const argsMatch = hslArgs.match(/^(.+?)\s*,\s*(.+?)\s*,\s*(.+?)(?:\s*,\s*(.+))?$/i); if (argsMatch) { let [h, s, l, a] = argsMatch.slice(1); [s, l] = [s, l].map(v => v.endsWith('%') ? v : `${parseFloat(v) * 100}%`); return `"hsl${typeof a === 'string' ? 'a' : ''}(${[h, s, l, a].filter(Boolean).join(',')})"`; } return match; }); } /** * Migrate a Mapbox/MapLibre GL Style to the latest version. * * @param style - a MapLibre Style * @returns a migrated style * @example * const fs = require('fs'); * csont migrate = require('@maplibre/maplibre-gl-style-spec').migrate; * const style = fs.readFileSync('./style.json', 'utf8'); * fs.writeFileSync('./style.json', JSON.stringify(migrate(style))); */ function migrate(style) { let migrated = false; if (style.version === 7) { style = migrateV8(style); migrated = true; } if (style.version === 8) { migrated = !!expressions(style); migrated = true; } eachProperty(style, { paint: true, layout: true }, ({ value, reference, set }) => { if (reference.type === 'color') { set(migrateColors(value)); } }); if (!migrated) { throw new Error(`Cannot migrate from ${style.version}`); } return style; } const v8 = v8Spec; const expression = { StyleExpression, StylePropertyFunction, ZoomConstantExpression, ZoomDependentExpression, createExpression, createPropertyExpression, isExpression, isExpressionFilter, isZoomExpression, normalizePropertyExpression, }; const styleFunction = { convertFunction, createFunction, isFunction: isFunction$1 }; const visit = { eachLayer, eachProperty, eachSource }; const validateStyle = validateStyleMin; const validateSource = validateStyle.source; const validateLight = validateStyle.light; const validateSky = validateStyle.sky; const validateTerrain = validateStyle.terrain; const validateFilter = validateStyle.filter; const validatePaintProperty = validateStyle.paintProperty; const validateLayoutProperty = validateStyle.layoutProperty; function emitValidationErrors$1(emitter, errors) { let hasErrors = false; if (errors && errors.length) { for (const error of errors) { emitter.fire(new ErrorEvent(new Error(error.message))); hasErrors = true; } } return hasErrors; } /* This file was copied from https://github.com/mapbox/grid-index and was migrated from JavaScript to TypeScript. Copyright (c) 2016, Mapbox Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ const NUM_PARAMS = 3; class TransferableGridIndex { constructor(extent, n, padding) { const cells = this.cells = []; if (extent instanceof ArrayBuffer) { this.arrayBuffer = extent; const array = new Int32Array(this.arrayBuffer); extent = array[0]; n = array[1]; padding = array[2]; this.d = n + 2 * padding; for (let k = 0; k < this.d * this.d; k++) { const start = array[NUM_PARAMS + k]; const end = array[NUM_PARAMS + k + 1]; cells.push(start === end ? null : array.subarray(start, end)); } const keysOffset = array[NUM_PARAMS + cells.length]; const bboxesOffset = array[NUM_PARAMS + cells.length + 1]; this.keys = array.subarray(keysOffset, bboxesOffset); this.bboxes = array.subarray(bboxesOffset); this.insert = this._insertReadonly; } else { this.d = n + 2 * padding; for (let i = 0; i < this.d * this.d; i++) { cells.push([]); } this.keys = []; this.bboxes = []; } this.n = n; this.extent = extent; this.padding = padding; this.scale = n / extent; this.uid = 0; const p = (padding / n) * extent; this.min = -p; this.max = extent + p; } insert(key, x1, y1, x2, y2) { this._forEachCell(x1, y1, x2, y2, this._insertCell, this.uid++, undefined, undefined); this.keys.push(key); this.bboxes.push(x1); this.bboxes.push(y1); this.bboxes.push(x2); this.bboxes.push(y2); } _insertReadonly() { throw new Error('Cannot insert into a GridIndex created from an ArrayBuffer.'); } _insertCell(x1, y1, x2, y2, cellIndex, uid) { this.cells[cellIndex].push(uid); } query(x1, y1, x2, y2, intersectionTest) { const min = this.min; const max = this.max; if (x1 <= min && y1 <= min && max <= x2 && max <= y2 && !intersectionTest) { // We use `Array#slice` because `this.keys` may be a `Int32Array` and // some browsers (Safari and IE) do not support `TypedArray#slice` // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/slice#Browser_compatibility return Array.prototype.slice.call(this.keys); } else { const result = []; const seenUids = {}; this._forEachCell(x1, y1, x2, y2, this._queryCell, result, seenUids, intersectionTest); return result; } } _queryCell(x1, y1, x2, y2, cellIndex, result, seenUids, intersectionTest) { const cell = this.cells[cellIndex]; if (cell !== null) { const keys = this.keys; const bboxes = this.bboxes; for (let u = 0; u < cell.length; u++) { const uid = cell[u]; if (seenUids[uid] === undefined) { const offset = uid * 4; if (intersectionTest ? intersectionTest(bboxes[offset + 0], bboxes[offset + 1], bboxes[offset + 2], bboxes[offset + 3]) : ((x1 <= bboxes[offset + 2]) && (y1 <= bboxes[offset + 3]) && (x2 >= bboxes[offset + 0]) && (y2 >= bboxes[offset + 1]))) { seenUids[uid] = true; result.push(keys[uid]); } else { seenUids[uid] = false; } } } } } _forEachCell(x1, y1, x2, y2, fn, arg1, arg2, intersectionTest) { const cx1 = this._convertToCellCoord(x1); const cy1 = this._convertToCellCoord(y1); const cx2 = this._convertToCellCoord(x2); const cy2 = this._convertToCellCoord(y2); for (let x = cx1; x <= cx2; x++) { for (let y = cy1; y <= cy2; y++) { const cellIndex = this.d * y + x; if (intersectionTest && !intersectionTest(this._convertFromCellCoord(x), this._convertFromCellCoord(y), this._convertFromCellCoord(x + 1), this._convertFromCellCoord(y + 1))) continue; if (fn.call(this, x1, y1, x2, y2, cellIndex, arg1, arg2, intersectionTest)) return; } } } _convertFromCellCoord(x) { return (x - this.padding) / this.scale; } _convertToCellCoord(x) { return Math.max(0, Math.min(this.d - 1, Math.floor(x * this.scale) + this.padding)); } toArrayBuffer() { if (this.arrayBuffer) return this.arrayBuffer; const cells = this.cells; const metadataLength = NUM_PARAMS + this.cells.length + 1 + 1; let totalCellLength = 0; for (let i = 0; i < this.cells.length; i++) { totalCellLength += this.cells[i].length; } const array = new Int32Array(metadataLength + totalCellLength + this.keys.length + this.bboxes.length); array[0] = this.extent; array[1] = this.n; array[2] = this.padding; let offset = metadataLength; for (let k = 0; k < cells.length; k++) { const cell = cells[k]; array[NUM_PARAMS + k] = offset; array.set(cell, offset); offset += cell.length; } array[NUM_PARAMS + cells.length] = offset; array.set(this.keys, offset); offset += this.keys.length; array[NUM_PARAMS + cells.length + 1] = offset; array.set(this.bboxes, offset); offset += this.bboxes.length; return array.buffer; } static serialize(grid, transferables) { const buffer = grid.toArrayBuffer(); if (transferables) { transferables.push(buffer); } return { buffer }; } static deserialize(serialized) { return new TransferableGridIndex(serialized.buffer); } } const registry = {}; /** * Register the given class as serializable. * * @param options - the registration options */ function register(name, klass, options = {}) { if (registry[name]) throw new Error(`${name} is already registered.`); Object.defineProperty(klass, '_classRegistryKey', { value: name, writeable: false }); registry[name] = { klass, omit: options.omit || [], shallow: options.shallow || [] }; } register('Object', Object); register('TransferableGridIndex', TransferableGridIndex); register('Color', Color); register('Error', Error); register('AJAXError', AJAXError); register('ResolvedImage', ResolvedImage); register('StylePropertyFunction', StylePropertyFunction); register('StyleExpression', StyleExpression, { omit: ['_evaluator'] }); register('ZoomDependentExpression', ZoomDependentExpression); register('ZoomConstantExpression', ZoomConstantExpression); register('CompoundExpression', CompoundExpression, { omit: ['_evaluate'] }); for (const name in expressions$1) { if (expressions$1[name]._classRegistryKey) continue; register(`Expression_${name}`, expressions$1[name]); } function isArrayBuffer(value) { return value && typeof ArrayBuffer !== 'undefined' && (value instanceof ArrayBuffer || (value.constructor && value.constructor.name === 'ArrayBuffer')); } function getClassRegistryKey(input) { const klass = input.constructor; return input.$name || klass._classRegistryKey; } function isRegistered(input) { if (input === null || typeof input !== 'object') { return false; } const classRegistryKey = getClassRegistryKey(input); if (classRegistryKey && classRegistryKey !== 'Object') { return true; } return false; } function isSerializeHandledByBuiltin(input) { return (!isRegistered(input) && (input === null || input === undefined || typeof input === 'boolean' || typeof input === 'number' || typeof input === 'string' || input instanceof Boolean || input instanceof Number || input instanceof String || input instanceof Date || input instanceof RegExp || input instanceof Blob || input instanceof Error || isArrayBuffer(input) || isImageBitmap(input) || ArrayBuffer.isView(input) || input instanceof ImageData)); } /** * Serialize the given object for transfer to or from a web worker. * * For non-builtin types, recursively serialize each property (possibly * omitting certain properties - see register()), and package the result along * with the constructor's `name` so that the appropriate constructor can be * looked up in `deserialize()`. * * If a `transferables` array is provided, add any transferable objects (i.e., * any ArrayBuffers or ArrayBuffer views) to the list. (If a copy is needed, * this should happen in the client code, before using serialize().) */ function serialize(input, transferables) { if (isSerializeHandledByBuiltin(input)) { if (isArrayBuffer(input) || isImageBitmap(input)) { if (transferables) { transferables.push(input); } } if (ArrayBuffer.isView(input)) { const view = input; if (transferables) { transferables.push(view.buffer); } } if (input instanceof ImageData) { if (transferables) { transferables.push(input.data.buffer); } } return input; } if (Array.isArray(input)) { const serialized = []; for (const item of input) { serialized.push(serialize(item, transferables)); } return serialized; } if (typeof input !== 'object') { throw new Error(`can't serialize object of type ${typeof input}`); } const classRegistryKey = getClassRegistryKey(input); if (!classRegistryKey) { throw new Error(`can't serialize object of unregistered class ${input.constructor.name}`); } if (!registry[classRegistryKey]) throw new Error(`${classRegistryKey} is not registered.`); const { klass } = registry[classRegistryKey]; const properties = klass.serialize ? // (Temporary workaround) allow a class to provide static // `serialize()` and `deserialize()` methods to bypass the generic // approach. // This temporary workaround lets us use the generic serialization // approach for objects whose members include instances of dynamic // StructArray types. Once we refactor StructArray to be static, // we can remove this complexity. klass.serialize(input, transferables) : {}; if (!klass.serialize) { for (const key in input) { if (!input.hasOwnProperty(key)) continue; // eslint-disable-line no-prototype-builtins if (registry[classRegistryKey].omit.indexOf(key) >= 0) continue; const property = input[key]; properties[key] = registry[classRegistryKey].shallow.indexOf(key) >= 0 ? property : serialize(property, transferables); } if (input instanceof Error) { properties.message = input.message; } } else { if (transferables && properties === transferables[transferables.length - 1]) { throw new Error('statically serialized object won\'t survive transfer of $name property'); } } if (properties.$name) { throw new Error('$name property is reserved for worker serialization logic.'); } if (classRegistryKey !== 'Object') { properties.$name = classRegistryKey; } return properties; } function deserialize$1(input) { if (isSerializeHandledByBuiltin(input)) { return input; } if (Array.isArray(input)) { return input.map(deserialize$1); } if (typeof input !== 'object') { throw new Error(`can't deserialize object of type ${typeof input}`); } const classRegistryKey = getClassRegistryKey(input) || 'Object'; if (!registry[classRegistryKey]) { throw new Error(`can't deserialize unregistered class ${classRegistryKey}`); } const { klass } = registry[classRegistryKey]; if (!klass) { throw new Error(`can't deserialize unregistered class ${classRegistryKey}`); } if (klass.deserialize) { return klass.deserialize(input); } const result = Object.create(klass.prototype); for (const key of Object.keys(input)) { if (key === '$name') continue; const value = input[key]; result[key] = registry[classRegistryKey].shallow.indexOf(key) >= 0 ? value : deserialize$1(value); } return result; } class ZoomHistory { constructor() { this.first = true; } update(z, now) { const floorZ = Math.floor(z); if (this.first) { this.first = false; this.lastIntegerZoom = floorZ; this.lastIntegerZoomTime = 0; this.lastZoom = z; this.lastFloorZoom = floorZ; return true; } if (this.lastFloorZoom > floorZ) { this.lastIntegerZoom = floorZ + 1; this.lastIntegerZoomTime = now; } else if (this.lastFloorZoom < floorZ) { this.lastIntegerZoom = floorZ; this.lastIntegerZoomTime = now; } if (z !== this.lastZoom) { this.lastZoom = z; this.lastFloorZoom = floorZ; return true; } return false; } } // The following table comes from . // Keep it synchronized with . const unicodeBlockLookup = { // 'Basic Latin': (char) => char >= 0x0000 && char <= 0x007F, 'Latin-1 Supplement': (char) => char >= 0x0080 && char <= 0x00FF, // 'Latin Extended-A': (char) => char >= 0x0100 && char <= 0x017F, // 'Latin Extended-B': (char) => char >= 0x0180 && char <= 0x024F, // 'IPA Extensions': (char) => char >= 0x0250 && char <= 0x02AF, // 'Spacing Modifier Letters': (char) => char >= 0x02B0 && char <= 0x02FF, // 'Combining Diacritical Marks': (char) => char >= 0x0300 && char <= 0x036F, // 'Greek and Coptic': (char) => char >= 0x0370 && char <= 0x03FF, // 'Cyrillic': (char) => char >= 0x0400 && char <= 0x04FF, // 'Cyrillic Supplement': (char) => char >= 0x0500 && char <= 0x052F, // 'Armenian': (char) => char >= 0x0530 && char <= 0x058F, //'Hebrew': (char) => char >= 0x0590 && char <= 0x05FF, // 'Arabic': (char) => char >= 0x0600 && char <= 0x06FF, //'Syriac': (char) => char >= 0x0700 && char <= 0x074F, // 'Arabic Supplement': (char) => char >= 0x0750 && char <= 0x077F, // 'Thaana': (char) => char >= 0x0780 && char <= 0x07BF, // 'NKo': (char) => char >= 0x07C0 && char <= 0x07FF, // 'Samaritan': (char) => char >= 0x0800 && char <= 0x083F, // 'Mandaic': (char) => char >= 0x0840 && char <= 0x085F, // 'Syriac Supplement': (char) => char >= 0x0860 && char <= 0x086F, // 'Arabic Extended-B': (char) => char >= 0x0870 && char <= 0x089F, // 'Arabic Extended-A': (char) => char >= 0x08A0 && char <= 0x08FF, // 'Devanagari': (char) => char >= 0x0900 && char <= 0x097F, // 'Bengali': (char) => char >= 0x0980 && char <= 0x09FF, // 'Gurmukhi': (char) => char >= 0x0A00 && char <= 0x0A7F, // 'Gujarati': (char) => char >= 0x0A80 && char <= 0x0AFF, // 'Oriya': (char) => char >= 0x0B00 && char <= 0x0B7F, // 'Tamil': (char) => char >= 0x0B80 && char <= 0x0BFF, // 'Telugu': (char) => char >= 0x0C00 && char <= 0x0C7F, // 'Kannada': (char) => char >= 0x0C80 && char <= 0x0CFF, // 'Malayalam': (char) => char >= 0x0D00 && char <= 0x0D7F, // 'Sinhala': (char) => char >= 0x0D80 && char <= 0x0DFF, // 'Thai': (char) => char >= 0x0E00 && char <= 0x0E7F, // 'Lao': (char) => char >= 0x0E80 && char <= 0x0EFF, // 'Tibetan': (char) => char >= 0x0F00 && char <= 0x0FFF, // 'Myanmar': (char) => char >= 0x1000 && char <= 0x109F, // 'Georgian': (char) => char >= 0x10A0 && char <= 0x10FF, 'Hangul Jamo': (char) => char >= 0x1100 && char <= 0x11FF, // 'Ethiopic': (char) => char >= 0x1200 && char <= 0x137F, // 'Ethiopic Supplement': (char) => char >= 0x1380 && char <= 0x139F, // 'Cherokee': (char) => char >= 0x13A0 && char <= 0x13FF, // 'Unified Canadian Aboriginal Syllabics': (char) => char >= 0x1400 && char <= 0x167F, // 'Ogham': (char) => char >= 0x1680 && char <= 0x169F, // 'Runic': (char) => char >= 0x16A0 && char <= 0x16FF, // 'Tagalog': (char) => char >= 0x1700 && char <= 0x171F, // 'Hanunoo': (char) => char >= 0x1720 && char <= 0x173F, // 'Buhid': (char) => char >= 0x1740 && char <= 0x175F, // 'Tagbanwa': (char) => char >= 0x1760 && char <= 0x177F, 'Khmer': (char) => char >= 0x1780 && char <= 0x17FF, // 'Mongolian': (char) => char >= 0x1800 && char <= 0x18AF, // 'Unified Canadian Aboriginal Syllabics Extended': (char) => char >= 0x18B0 && char <= 0x18FF, // 'Limbu': (char) => char >= 0x1900 && char <= 0x194F, // 'Tai Le': (char) => char >= 0x1950 && char <= 0x197F, // 'New Tai Lue': (char) => char >= 0x1980 && char <= 0x19DF, // 'Khmer Symbols': (char) => char >= 0x19E0 && char <= 0x19FF, // 'Buginese': (char) => char >= 0x1A00 && char <= 0x1A1F, // 'Tai Tham': (char) => char >= 0x1A20 && char <= 0x1AAF, // 'Combining Diacritical Marks Extended': (char) => char >= 0x1AB0 && char <= 0x1AFF, // 'Balinese': (char) => char >= 0x1B00 && char <= 0x1B7F, // 'Sundanese': (char) => char >= 0x1B80 && char <= 0x1BBF, // 'Batak': (char) => char >= 0x1BC0 && char <= 0x1BFF, // 'Lepcha': (char) => char >= 0x1C00 && char <= 0x1C4F, // 'Ol Chiki': (char) => char >= 0x1C50 && char <= 0x1C7F, // 'Cyrillic Extended-C': (char) => char >= 0x1C80 && char <= 0x1C8F, // 'Georgian Extended': (char) => char >= 0x1C90 && char <= 0x1CBF, // 'Sundanese Supplement': (char) => char >= 0x1CC0 && char <= 0x1CCF, // 'Vedic Extensions': (char) => char >= 0x1CD0 && char <= 0x1CFF, // 'Phonetic Extensions': (char) => char >= 0x1D00 && char <= 0x1D7F, // 'Phonetic Extensions Supplement': (char) => char >= 0x1D80 && char <= 0x1DBF, // 'Combining Diacritical Marks Supplement': (char) => char >= 0x1DC0 && char <= 0x1DFF, // 'Latin Extended Additional': (char) => char >= 0x1E00 && char <= 0x1EFF, // 'Greek Extended': (char) => char >= 0x1F00 && char <= 0x1FFF, 'General Punctuation': (char) => char >= 0x2000 && char <= 0x206F, // 'Superscripts and Subscripts': (char) => char >= 0x2070 && char <= 0x209F, // 'Currency Symbols': (char) => char >= 0x20A0 && char <= 0x20CF, // 'Combining Diacritical Marks for Symbols': (char) => char >= 0x20D0 && char <= 0x20FF, 'Letterlike Symbols': (char) => char >= 0x2100 && char <= 0x214F, 'Number Forms': (char) => char >= 0x2150 && char <= 0x218F, // 'Arrows': (char) => char >= 0x2190 && char <= 0x21FF, // 'Mathematical Operators': (char) => char >= 0x2200 && char <= 0x22FF, 'Miscellaneous Technical': (char) => char >= 0x2300 && char <= 0x23FF, 'Control Pictures': (char) => char >= 0x2400 && char <= 0x243F, 'Optical Character Recognition': (char) => char >= 0x2440 && char <= 0x245F, 'Enclosed Alphanumerics': (char) => char >= 0x2460 && char <= 0x24FF, // 'Box Drawing': (char) => char >= 0x2500 && char <= 0x257F, // 'Block Elements': (char) => char >= 0x2580 && char <= 0x259F, 'Geometric Shapes': (char) => char >= 0x25A0 && char <= 0x25FF, 'Miscellaneous Symbols': (char) => char >= 0x2600 && char <= 0x26FF, // 'Dingbats': (char) => char >= 0x2700 && char <= 0x27BF, // 'Miscellaneous Mathematical Symbols-A': (char) => char >= 0x27C0 && char <= 0x27EF, // 'Supplemental Arrows-A': (char) => char >= 0x27F0 && char <= 0x27FF, // 'Braille Patterns': (char) => char >= 0x2800 && char <= 0x28FF, // 'Supplemental Arrows-B': (char) => char >= 0x2900 && char <= 0x297F, // 'Miscellaneous Mathematical Symbols-B': (char) => char >= 0x2980 && char <= 0x29FF, // 'Supplemental Mathematical Operators': (char) => char >= 0x2A00 && char <= 0x2AFF, 'Miscellaneous Symbols and Arrows': (char) => char >= 0x2B00 && char <= 0x2BFF, // 'Glagolitic': (char) => char >= 0x2C00 && char <= 0x2C5F, // 'Latin Extended-C': (char) => char >= 0x2C60 && char <= 0x2C7F, // 'Coptic': (char) => char >= 0x2C80 && char <= 0x2CFF, // 'Georgian Supplement': (char) => char >= 0x2D00 && char <= 0x2D2F, // 'Tifinagh': (char) => char >= 0x2D30 && char <= 0x2D7F, // 'Ethiopic Extended': (char) => char >= 0x2D80 && char <= 0x2DDF, // 'Cyrillic Extended-A': (char) => char >= 0x2DE0 && char <= 0x2DFF, // 'Supplemental Punctuation': (char) => char >= 0x2E00 && char <= 0x2E7F, // 'CJK Radicals Supplement': (char) => char >= 0x2E80 && char <= 0x2EFF, // 'Kangxi Radicals': (char) => char >= 0x2F00 && char <= 0x2FDF, 'Ideographic Description Characters': (char) => char >= 0x2FF0 && char <= 0x2FFF, 'CJK Symbols and Punctuation': (char) => char >= 0x3000 && char <= 0x303F, // 'Hiragana': (char) => char >= 0x3040 && char <= 0x309F, 'Katakana': (char) => char >= 0x30A0 && char <= 0x30FF, // 'Bopomofo': (char) => char >= 0x3100 && char <= 0x312F, // 'Hangul Compatibility Jamo': (char) => char >= 0x3130 && char <= 0x318F, 'Kanbun': (char) => char >= 0x3190 && char <= 0x319F, // 'Bopomofo Extended': (char) => char >= 0x31A0 && char <= 0x31BF, 'CJK Strokes': (char) => char >= 0x31C0 && char <= 0x31EF, // 'Katakana Phonetic Extensions': (char) => char >= 0x31F0 && char <= 0x31FF, 'Enclosed CJK Letters and Months': (char) => char >= 0x3200 && char <= 0x32FF, 'CJK Compatibility': (char) => char >= 0x3300 && char <= 0x33FF, // 'CJK Unified Ideographs Extension A': (char) => char >= 0x3400 && char <= 0x4DBF, 'Yijing Hexagram Symbols': (char) => char >= 0x4DC0 && char <= 0x4DFF, // 'CJK Unified Ideographs': (char) => char >= 0x4E00 && char <= 0x9FFF, // 'Yi Syllables': (char) => char >= 0xA000 && char <= 0xA48F, // 'Yi Radicals': (char) => char >= 0xA490 && char <= 0xA4CF, // 'Lisu': (char) => char >= 0xA4D0 && char <= 0xA4FF, // 'Vai': (char) => char >= 0xA500 && char <= 0xA63F, // 'Cyrillic Extended-B': (char) => char >= 0xA640 && char <= 0xA69F, // 'Bamum': (char) => char >= 0xA6A0 && char <= 0xA6FF, // 'Modifier Tone Letters': (char) => char >= 0xA700 && char <= 0xA71F, // 'Latin Extended-D': (char) => char >= 0xA720 && char <= 0xA7FF, // 'Syloti Nagri': (char) => char >= 0xA800 && char <= 0xA82F, // 'Common Indic Number Forms': (char) => char >= 0xA830 && char <= 0xA83F, // 'Phags-pa': (char) => char >= 0xA840 && char <= 0xA87F, // 'Saurashtra': (char) => char >= 0xA880 && char <= 0xA8DF, // 'Devanagari Extended': (char) => char >= 0xA8E0 && char <= 0xA8FF, // 'Kayah Li': (char) => char >= 0xA900 && char <= 0xA92F, // 'Rejang': (char) => char >= 0xA930 && char <= 0xA95F, // 'Hangul Jamo Extended-A': (char) => char >= 0xA960 && char <= 0xA97F, // 'Javanese': (char) => char >= 0xA980 && char <= 0xA9DF, // 'Myanmar Extended-B': (char) => char >= 0xA9E0 && char <= 0xA9FF, // 'Cham': (char) => char >= 0xAA00 && char <= 0xAA5F, // 'Myanmar Extended-A': (char) => char >= 0xAA60 && char <= 0xAA7F, // 'Tai Viet': (char) => char >= 0xAA80 && char <= 0xAADF, // 'Meetei Mayek Extensions': (char) => char >= 0xAAE0 && char <= 0xAAFF, // 'Ethiopic Extended-A': (char) => char >= 0xAB00 && char <= 0xAB2F, // 'Latin Extended-E': (char) => char >= 0xAB30 && char <= 0xAB6F, // 'Cherokee Supplement': (char) => char >= 0xAB70 && char <= 0xABBF, // 'Meetei Mayek': (char) => char >= 0xABC0 && char <= 0xABFF, // 'Hangul Syllables': (char) => char >= 0xAC00 && char <= 0xD7AF, // 'Hangul Jamo Extended-B': (char) => char >= 0xD7B0 && char <= 0xD7FF, // 'High Surrogates': (char) => char >= 0xD800 && char <= 0xDB7F, // 'High Private Use Surrogates': (char) => char >= 0xDB80 && char <= 0xDBFF, // 'Low Surrogates': (char) => char >= 0xDC00 && char <= 0xDFFF, 'Private Use Area': (char) => char >= 0xE000 && char <= 0xF8FF, // 'CJK Compatibility Ideographs': (char) => char >= 0xF900 && char <= 0xFAFF, // 'Alphabetic Presentation Forms': (char) => char >= 0xFB00 && char <= 0xFB4F, // 'Arabic Presentation Forms-A': (char) => char >= 0xFB50 && char <= 0xFDFF, // 'Variation Selectors': (char) => char >= 0xFE00 && char <= 0xFE0F, 'Vertical Forms': (char) => char >= 0xFE10 && char <= 0xFE1F, // 'Combining Half Marks': (char) => char >= 0xFE20 && char <= 0xFE2F, 'CJK Compatibility Forms': (char) => char >= 0xFE30 && char <= 0xFE4F, 'Small Form Variants': (char) => char >= 0xFE50 && char <= 0xFE6F, // 'Arabic Presentation Forms-B': (char) => char >= 0xFE70 && char <= 0xFEFF, 'Halfwidth and Fullwidth Forms': (char) => char >= 0xFF00 && char <= 0xFFEF // 'Specials': (char) => char >= 0xFFF0 && char <= 0xFFFF, // 'Linear B Syllabary': (char) => char >= 0x10000 && char <= 0x1007F, // 'Linear B Ideograms': (char) => char >= 0x10080 && char <= 0x100FF, // 'Aegean Numbers': (char) => char >= 0x10100 && char <= 0x1013F, // 'Ancient Greek Numbers': (char) => char >= 0x10140 && char <= 0x1018F, // 'Ancient Symbols': (char) => char >= 0x10190 && char <= 0x101CF, // 'Phaistos Disc': (char) => char >= 0x101D0 && char <= 0x101FF, // 'Lycian': (char) => char >= 0x10280 && char <= 0x1029F, // 'Carian': (char) => char >= 0x102A0 && char <= 0x102DF, // 'Coptic Epact Numbers': (char) => char >= 0x102E0 && char <= 0x102FF, // 'Old Italic': (char) => char >= 0x10300 && char <= 0x1032F, // 'Gothic': (char) => char >= 0x10330 && char <= 0x1034F, // 'Old Permic': (char) => char >= 0x10350 && char <= 0x1037F, // 'Ugaritic': (char) => char >= 0x10380 && char <= 0x1039F, // 'Old Persian': (char) => char >= 0x103A0 && char <= 0x103DF, // 'Deseret': (char) => char >= 0x10400 && char <= 0x1044F, // 'Shavian': (char) => char >= 0x10450 && char <= 0x1047F, // 'Osmanya': (char) => char >= 0x10480 && char <= 0x104AF, // 'Osage': (char) => char >= 0x104B0 && char <= 0x104FF, // 'Elbasan': (char) => char >= 0x10500 && char <= 0x1052F, // 'Caucasian Albanian': (char) => char >= 0x10530 && char <= 0x1056F, // 'Vithkuqi': (char) => char >= 0x10570 && char <= 0x105BF, // 'Todhri': (char) => char >= 0x105C0 && char <= 0x105FF, // 'Linear A': (char) => char >= 0x10600 && char <= 0x1077F, // 'Latin Extended-F': (char) => char >= 0x10780 && char <= 0x107BF, // 'Cypriot Syllabary': (char) => char >= 0x10800 && char <= 0x1083F, // 'Imperial Aramaic': (char) => char >= 0x10840 && char <= 0x1085F, // 'Palmyrene': (char) => char >= 0x10860 && char <= 0x1087F, // 'Nabataean': (char) => char >= 0x10880 && char <= 0x108AF, // 'Hatran': (char) => char >= 0x108E0 && char <= 0x108FF, // 'Phoenician': (char) => char >= 0x10900 && char <= 0x1091F, // 'Lydian': (char) => char >= 0x10920 && char <= 0x1093F, // 'Meroitic Hieroglyphs': (char) => char >= 0x10980 && char <= 0x1099F, // 'Meroitic Cursive': (char) => char >= 0x109A0 && char <= 0x109FF, // 'Kharoshthi': (char) => char >= 0x10A00 && char <= 0x10A5F, // 'Old South Arabian': (char) => char >= 0x10A60 && char <= 0x10A7F, // 'Old North Arabian': (char) => char >= 0x10A80 && char <= 0x10A9F, // 'Manichaean': (char) => char >= 0x10AC0 && char <= 0x10AFF, // 'Avestan': (char) => char >= 0x10B00 && char <= 0x10B3F, // 'Inscriptional Parthian': (char) => char >= 0x10B40 && char <= 0x10B5F, // 'Inscriptional Pahlavi': (char) => char >= 0x10B60 && char <= 0x10B7F, // 'Psalter Pahlavi': (char) => char >= 0x10B80 && char <= 0x10BAF, // 'Old Turkic': (char) => char >= 0x10C00 && char <= 0x10C4F, // 'Old Hungarian': (char) => char >= 0x10C80 && char <= 0x10CFF, // 'Hanifi Rohingya': (char) => char >= 0x10D00 && char <= 0x10D3F, // 'Garay': (char) => char >= 0x10D40 && char <= 0x10D8F, // 'Rumi Numeral Symbols': (char) => char >= 0x10E60 && char <= 0x10E7F, // 'Yezidi': (char) => char >= 0x10E80 && char <= 0x10EBF, // 'Arabic Extended-C': (char) => char >= 0x10EC0 && char <= 0x10EFF, // 'Old Sogdian': (char) => char >= 0x10F00 && char <= 0x10F2F, // 'Sogdian': (char) => char >= 0x10F30 && char <= 0x10F6F, // 'Old Uyghur': (char) => char >= 0x10F70 && char <= 0x10FAF, // 'Chorasmian': (char) => char >= 0x10FB0 && char <= 0x10FDF, // 'Elymaic': (char) => char >= 0x10FE0 && char <= 0x10FFF, // 'Brahmi': (char) => char >= 0x11000 && char <= 0x1107F, // 'Kaithi': (char) => char >= 0x11080 && char <= 0x110CF, // 'Sora Sompeng': (char) => char >= 0x110D0 && char <= 0x110FF, // 'Chakma': (char) => char >= 0x11100 && char <= 0x1114F, // 'Mahajani': (char) => char >= 0x11150 && char <= 0x1117F, // 'Sharada': (char) => char >= 0x11180 && char <= 0x111DF, // 'Sinhala Archaic Numbers': (char) => char >= 0x111E0 && char <= 0x111FF, // 'Khojki': (char) => char >= 0x11200 && char <= 0x1124F, // 'Multani': (char) => char >= 0x11280 && char <= 0x112AF, // 'Khudawadi': (char) => char >= 0x112B0 && char <= 0x112FF, // 'Grantha': (char) => char >= 0x11300 && char <= 0x1137F, // 'Tulu-Tigalari': (char) => char >= 0x11380 && char <= 0x113FF, // 'Newa': (char) => char >= 0x11400 && char <= 0x1147F, // 'Tirhuta': (char) => char >= 0x11480 && char <= 0x114DF, // 'Siddham': (char) => char >= 0x11580 && char <= 0x115FF, // 'Modi': (char) => char >= 0x11600 && char <= 0x1165F, // 'Mongolian Supplement': (char) => char >= 0x11660 && char <= 0x1167F, // 'Takri': (char) => char >= 0x11680 && char <= 0x116CF, // 'Myanmar Extended-C': (char) => char >= 0x116D0 && char <= 0x116FF, // 'Ahom': (char) => char >= 0x11700 && char <= 0x1174F, // 'Dogra': (char) => char >= 0x11800 && char <= 0x1184F, // 'Warang Citi': (char) => char >= 0x118A0 && char <= 0x118FF, // 'Dives Akuru': (char) => char >= 0x11900 && char <= 0x1195F, // 'Nandinagari': (char) => char >= 0x119A0 && char <= 0x119FF, // 'Zanabazar Square': (char) => char >= 0x11A00 && char <= 0x11A4F, // 'Soyombo': (char) => char >= 0x11A50 && char <= 0x11AAF, // 'Unified Canadian Aboriginal Syllabics Extended-A': (char) => char >= 0x11AB0 && char <= 0x11ABF, // 'Pau Cin Hau': (char) => char >= 0x11AC0 && char <= 0x11AFF, // 'Devanagari Extended-A': (char) => char >= 0x11B00 && char <= 0x11B5F, // 'Sunuwar': (char) => char >= 0x11BC0 && char <= 0x11BFF, // 'Bhaiksuki': (char) => char >= 0x11C00 && char <= 0x11C6F, // 'Marchen': (char) => char >= 0x11C70 && char <= 0x11CBF, // 'Masaram Gondi': (char) => char >= 0x11D00 && char <= 0x11D5F, // 'Gunjala Gondi': (char) => char >= 0x11D60 && char <= 0x11DAF, // 'Makasar': (char) => char >= 0x11EE0 && char <= 0x11EFF, // 'Kawi': (char) => char >= 0x11F00 && char <= 0x11F5F, // 'Lisu Supplement': (char) => char >= 0x11FB0 && char <= 0x11FBF, // 'Tamil Supplement': (char) => char >= 0x11FC0 && char <= 0x11FFF, // 'Cuneiform': (char) => char >= 0x12000 && char <= 0x123FF, // 'Cuneiform Numbers and Punctuation': (char) => char >= 0x12400 && char <= 0x1247F, // 'Early Dynastic Cuneiform': (char) => char >= 0x12480 && char <= 0x1254F, // 'Cypro-Minoan': (char) => char >= 0x12F90 && char <= 0x12FFF, // 'Egyptian Hieroglyphs': (char) => char >= 0x13000 && char <= 0x1342F, // 'Egyptian Hieroglyph Format Controls': (char) => char >= 0x13430 && char <= 0x1345F, // 'Egyptian Hieroglyphs Extended-A': (char) => char >= 0x13460 && char <= 0x143FF, // 'Anatolian Hieroglyphs': (char) => char >= 0x14400 && char <= 0x1467F, // 'Gurung Khema': (char) => char >= 0x16100 && char <= 0x1613F, // 'Bamum Supplement': (char) => char >= 0x16800 && char <= 0x16A3F, // 'Mro': (char) => char >= 0x16A40 && char <= 0x16A6F, // 'Tangsa': (char) => char >= 0x16A70 && char <= 0x16ACF, // 'Bassa Vah': (char) => char >= 0x16AD0 && char <= 0x16AFF, // 'Pahawh Hmong': (char) => char >= 0x16B00 && char <= 0x16B8F, // 'Kirat Rai': (char) => char >= 0x16D40 && char <= 0x16D7F, // 'Medefaidrin': (char) => char >= 0x16E40 && char <= 0x16E9F, // 'Miao': (char) => char >= 0x16F00 && char <= 0x16F9F, // 'Ideographic Symbols and Punctuation': (char) => char >= 0x16FE0 && char <= 0x16FFF, // 'Tangut': (char) => char >= 0x17000 && char <= 0x187FF, // 'Tangut Components': (char) => char >= 0x18800 && char <= 0x18AFF, // 'Khitan Small Script': (char) => char >= 0x18B00 && char <= 0x18CFF, // 'Tangut Supplement': (char) => char >= 0x18D00 && char <= 0x18D7F, // 'Kana Extended-B': (char) => char >= 0x1AFF0 && char <= 0x1AFFF, // 'Kana Supplement': (char) => char >= 0x1B000 && char <= 0x1B0FF, // 'Kana Extended-A': (char) => char >= 0x1B100 && char <= 0x1B12F, // 'Small Kana Extension': (char) => char >= 0x1B130 && char <= 0x1B16F, // 'Nushu': (char) => char >= 0x1B170 && char <= 0x1B2FF, // 'Duployan': (char) => char >= 0x1BC00 && char <= 0x1BC9F, // 'Shorthand Format Controls': (char) => char >= 0x1BCA0 && char <= 0x1BCAF, // 'Symbols for Legacy Computing Supplement': (char) => char >= 0x1CC00 && char <= 0x1CEBF, // 'Znamenny Musical Notation': (char) => char >= 0x1CF00 && char <= 0x1CFCF, // 'Byzantine Musical Symbols': (char) => char >= 0x1D000 && char <= 0x1D0FF, // 'Musical Symbols': (char) => char >= 0x1D100 && char <= 0x1D1FF, // 'Ancient Greek Musical Notation': (char) => char >= 0x1D200 && char <= 0x1D24F, // 'Kaktovik Numerals': (char) => char >= 0x1D2C0 && char <= 0x1D2DF, // 'Mayan Numerals': (char) => char >= 0x1D2E0 && char <= 0x1D2FF, // 'Tai Xuan Jing Symbols': (char) => char >= 0x1D300 && char <= 0x1D35F, // 'Counting Rod Numerals': (char) => char >= 0x1D360 && char <= 0x1D37F, // 'Mathematical Alphanumeric Symbols': (char) => char >= 0x1D400 && char <= 0x1D7FF, // 'Sutton SignWriting': (char) => char >= 0x1D800 && char <= 0x1DAAF, // 'Latin Extended-G': (char) => char >= 0x1DF00 && char <= 0x1DFFF, // 'Glagolitic Supplement': (char) => char >= 0x1E000 && char <= 0x1E02F, // 'Cyrillic Extended-D': (char) => char >= 0x1E030 && char <= 0x1E08F, // 'Nyiakeng Puachue Hmong': (char) => char >= 0x1E100 && char <= 0x1E14F, // 'Toto': (char) => char >= 0x1E290 && char <= 0x1E2BF, // 'Wancho': (char) => char >= 0x1E2C0 && char <= 0x1E2FF, // 'Nag Mundari': (char) => char >= 0x1E4D0 && char <= 0x1E4FF, // 'Ol Onal': (char) => char >= 0x1E5D0 && char <= 0x1E5FF, // 'Ethiopic Extended-B': (char) => char >= 0x1E7E0 && char <= 0x1E7FF, // 'Mende Kikakui': (char) => char >= 0x1E800 && char <= 0x1E8DF, // 'Adlam': (char) => char >= 0x1E900 && char <= 0x1E95F, // 'Indic Siyaq Numbers': (char) => char >= 0x1EC70 && char <= 0x1ECBF, // 'Ottoman Siyaq Numbers': (char) => char >= 0x1ED00 && char <= 0x1ED4F, // 'Arabic Mathematical Alphabetic Symbols': (char) => char >= 0x1EE00 && char <= 0x1EEFF, // 'Mahjong Tiles': (char) => char >= 0x1F000 && char <= 0x1F02F, // 'Domino Tiles': (char) => char >= 0x1F030 && char <= 0x1F09F, // 'Playing Cards': (char) => char >= 0x1F0A0 && char <= 0x1F0FF, // 'Enclosed Alphanumeric Supplement': (char) => char >= 0x1F100 && char <= 0x1F1FF, // 'Enclosed Ideographic Supplement': (char) => char >= 0x1F200 && char <= 0x1F2FF, // 'Miscellaneous Symbols and Pictographs': (char) => char >= 0x1F300 && char <= 0x1F5FF, // 'Emoticons': (char) => char >= 0x1F600 && char <= 0x1F64F, // 'Ornamental Dingbats': (char) => char >= 0x1F650 && char <= 0x1F67F, // 'Transport and Map Symbols': (char) => char >= 0x1F680 && char <= 0x1F6FF, // 'Alchemical Symbols': (char) => char >= 0x1F700 && char <= 0x1F77F, // 'Geometric Shapes Extended': (char) => char >= 0x1F780 && char <= 0x1F7FF, // 'Supplemental Arrows-C': (char) => char >= 0x1F800 && char <= 0x1F8FF, // 'Supplemental Symbols and Pictographs': (char) => char >= 0x1F900 && char <= 0x1F9FF, // 'Chess Symbols': (char) => char >= 0x1FA00 && char <= 0x1FA6F, // 'Symbols and Pictographs Extended-A': (char) => char >= 0x1FA70 && char <= 0x1FAFF, // 'Symbols for Legacy Computing': (char) => char >= 0x1FB00 && char <= 0x1FBFF, // 'CJK Unified Ideographs Extension B': (char) => char >= 0x20000 && char <= 0x2A6DF, // 'CJK Unified Ideographs Extension C': (char) => char >= 0x2A700 && char <= 0x2B73F, // 'CJK Unified Ideographs Extension D': (char) => char >= 0x2B740 && char <= 0x2B81F, // 'CJK Unified Ideographs Extension E': (char) => char >= 0x2B820 && char <= 0x2CEAF, // 'CJK Unified Ideographs Extension F': (char) => char >= 0x2CEB0 && char <= 0x2EBEF, // 'CJK Unified Ideographs Extension I': (char) => char >= 0x2EBF0 && char <= 0x2EE5F, // 'CJK Unified Ideographs Extension G': (char) => char >= 0x30000 && char <= 0x3134F, // 'CJK Unified Ideographs Extension H': (char) => char >= 0x31350 && char <= 0x323AF, // 'CJK Compatibility Ideographs Supplement': (char) => char >= 0x2F800 && char <= 0x2FA1F, // 'Tags': (char) => char >= 0xE0000 && char <= 0xE007F, // 'Variation Selectors Supplement': (char) => char >= 0xE0100 && char <= 0xE01EF, // 'Supplementary Private Use Area-A': (char) => char >= 0xF0000 && char <= 0xFFFFF, // 'Supplementary Private Use Area-B': (char) => char >= 0x100000 && char <= 0x10FFFF, }; /* eslint-disable new-cap */ function allowsIdeographicBreaking(chars) { for (const char of chars) { if (!charAllowsIdeographicBreaking(char.charCodeAt(0))) return false; } return true; } function allowsVerticalWritingMode(chars) { for (const char of chars) { if (charHasUprightVerticalOrientation(char.charCodeAt(0))) return true; } return false; } function allowsLetterSpacing(chars) { for (const char of chars) { if (!charAllowsLetterSpacing(char.charCodeAt(0))) return false; } return true; } /** * Returns a regular expression matching the given script codes, excluding any * code that the execution environment lacks support for in regular expressions. */ function sanitizedRegExpFromScriptCodes(scriptCodes) { const supportedPropertyEscapes = scriptCodes.map(code => { try { return new RegExp(`\\p{sc=${code}}`, 'u').source; } catch (e) { return null; } }).filter(pe => pe); return new RegExp(supportedPropertyEscapes.join('|'), 'u'); } /** * ISO 15924 script codes of scripts that disallow letter spacing as of Unicode * 16.0.0. * * In general, cursive scripts are incompatible with letter spacing. */ const cursiveScriptCodes = [ 'Arab', // Arabic 'Dupl', // Duployan 'Mong', // Mongolian 'Ougr', // Old Uyghur 'Syrc', // Syriac ]; const cursiveScriptRegExp = sanitizedRegExpFromScriptCodes(cursiveScriptCodes); function charAllowsLetterSpacing(char) { return !cursiveScriptRegExp.test(String.fromCodePoint(char)); } /** * ISO 15924 script codes of scripts that allow ideographic line breaking beyond * the CJKV scripts that are considered ideographic in Unicode 16.0.0. */ const ideographicBreakingScriptCodes = [ 'Bopo', // Bopomofo 'Hani', // Han 'Hira', // Hiragana 'Kana', // Katakana 'Kits', // Khitan Small Script 'Nshu', // Nushu 'Tang', // Tangut 'Yiii', // Yi ]; const ideographicBreakingRegExp = sanitizedRegExpFromScriptCodes(ideographicBreakingScriptCodes); function charAllowsIdeographicBreaking(char) { // Return early for characters outside all ideographic ranges. if (char < 0x2E80) return false; if (unicodeBlockLookup['CJK Compatibility Forms'](char)) return true; if (unicodeBlockLookup['CJK Compatibility'](char)) return true; if (unicodeBlockLookup['CJK Strokes'](char)) return true; if (unicodeBlockLookup['CJK Symbols and Punctuation'](char)) return true; if (unicodeBlockLookup['Enclosed CJK Letters and Months'](char)) return true; if (unicodeBlockLookup['Halfwidth and Fullwidth Forms'](char)) return true; if (unicodeBlockLookup['Ideographic Description Characters'](char)) return true; if (unicodeBlockLookup['Vertical Forms'](char)) return true; return ideographicBreakingRegExp.test(String.fromCodePoint(char)); } // The following logic comes from // . // Keep it synchronized with // . // The data file denotes with “U” or “Tu” any codepoint that may be drawn // upright in vertical text but does not distinguish between upright and // “neutral” characters. // Blocks in the Unicode supplementary planes are excluded from this module due // to . /** * Returns true if the given Unicode codepoint identifies a character with * upright orientation. * * A character has upright orientation if it is drawn upright (unrotated) * whether the line is oriented horizontally or vertically, even if both * adjacent characters can be rotated. For example, a Chinese character is * always drawn upright. An uprightly oriented character causes an adjacent * “neutral” character to be drawn upright as well. */ function charHasUprightVerticalOrientation(char) { if (char === 0x02EA /* modifier letter yin departing tone mark */ || char === 0x02EB /* modifier letter yang departing tone mark */) { return true; } // Return early for characters outside all ranges whose characters remain // upright in vertical writing mode. if (char < 0x1100) return false; if (unicodeBlockLookup['CJK Compatibility Forms'](char)) { if (!((char >= 0xFE49 /* dashed overline */ && char <= 0xFE4F) /* wavy low line */)) { return true; } } if (unicodeBlockLookup['CJK Compatibility'](char)) return true; if (unicodeBlockLookup['CJK Strokes'](char)) return true; if (unicodeBlockLookup['CJK Symbols and Punctuation'](char)) { if (!((char >= 0x3008 /* left angle bracket */ && char <= 0x3011) /* right black lenticular bracket */) && !((char >= 0x3014 /* left tortoise shell bracket */ && char <= 0x301F) /* low double prime quotation mark */) && char !== 0x3030 /* wavy dash */) { return true; } } if (unicodeBlockLookup['Enclosed CJK Letters and Months'](char)) return true; if (unicodeBlockLookup['Ideographic Description Characters'](char)) return true; if (unicodeBlockLookup['Kanbun'](char)) return true; if (unicodeBlockLookup['Katakana'](char)) { if (char !== 0x30FC /* katakana-hiragana prolonged sound mark */) { return true; } } if (unicodeBlockLookup['Halfwidth and Fullwidth Forms'](char)) { if (char !== 0xFF08 /* fullwidth left parenthesis */ && char !== 0xFF09 /* fullwidth right parenthesis */ && char !== 0xFF0D /* fullwidth hyphen-minus */ && !((char >= 0xFF1A /* fullwidth colon */ && char <= 0xFF1E) /* fullwidth greater-than sign */) && char !== 0xFF3B /* fullwidth left square bracket */ && char !== 0xFF3D /* fullwidth right square bracket */ && char !== 0xFF3F /* fullwidth low line */ && !(char >= 0xFF5B /* fullwidth left curly bracket */ && char <= 0xFFDF) && char !== 0xFFE3 /* fullwidth macron */ && !(char >= 0xFFE8 /* halfwidth forms light vertical */ && char <= 0xFFEF)) { return true; } } if (unicodeBlockLookup['Small Form Variants'](char)) { if (!((char >= 0xFE58 /* small em dash */ && char <= 0xFE5E) /* small right tortoise shell bracket */) && !((char >= 0xFE63 /* small hyphen-minus */ && char <= 0xFE66) /* small equals sign */)) { return true; } } if (unicodeBlockLookup['Vertical Forms'](char)) return true; if (unicodeBlockLookup['Yijing Hexagram Symbols'](char)) return true; if ( /* Canadian Aboriginal *//\p{sc=Cans}/u.test(String.fromCodePoint(char))) return true; if ( /* Hangul *//\p{sc=Hang}/u.test(String.fromCodePoint(char))) return true; if (ideographicBreakingRegExp.test(String.fromCodePoint(char))) return true; return false; } /** * Returns true if the given Unicode codepoint identifies a character with * neutral orientation. * * A character has neutral orientation if it may be drawn rotated or unrotated * when the line is oriented vertically, depending on the orientation of the * adjacent characters. For example, along a vertically oriented line, the vulgar * fraction ½ is drawn upright among Chinese characters but rotated among Latin * letters. A neutrally oriented character does not influence whether an * adjacent character is drawn upright or rotated. */ function charHasNeutralVerticalOrientation(char) { if (unicodeBlockLookup['Latin-1 Supplement'](char)) { if (char === 0x00A7 /* section sign */ || char === 0x00A9 /* copyright sign */ || char === 0x00AE /* registered sign */ || char === 0x00B1 /* plus-minus sign */ || char === 0x00BC /* vulgar fraction one quarter */ || char === 0x00BD /* vulgar fraction one half */ || char === 0x00BE /* vulgar fraction three quarters */ || char === 0x00D7 /* multiplication sign */ || char === 0x00F7 /* division sign */) { return true; } } if (unicodeBlockLookup['General Punctuation'](char)) { if (char === 0x2016 /* double vertical line */ || char === 0x2020 /* dagger */ || char === 0x2021 /* double dagger */ || char === 0x2030 /* per mille sign */ || char === 0x2031 /* per ten thousand sign */ || char === 0x203B /* reference mark */ || char === 0x203C /* double exclamation mark */ || char === 0x2042 /* asterism */ || char === 0x2047 /* double question mark */ || char === 0x2048 /* question exclamation mark */ || char === 0x2049 /* exclamation question mark */ || char === 0x2051 /* two asterisks aligned vertically */) { return true; } } if (unicodeBlockLookup['Letterlike Symbols'](char)) return true; if (unicodeBlockLookup['Number Forms'](char)) return true; if (unicodeBlockLookup['Miscellaneous Technical'](char)) { if ((char >= 0x2300 /* diameter sign */ && char <= 0x2307 /* wavy line */) || (char >= 0x230C /* bottom right crop */ && char <= 0x231F /* bottom right corner */) || (char >= 0x2324 /* up arrowhead between two horizontal bars */ && char <= 0x2328 /* keyboard */) || char === 0x232B /* erase to the left */ || (char >= 0x237D /* shouldered open box */ && char <= 0x239A /* clear screen symbol */) || (char >= 0x23BE /* dentistry symbol light vertical and top right */ && char <= 0x23CD /* square foot */) || char === 0x23CF /* eject symbol */ || (char >= 0x23D1 /* metrical breve */ && char <= 0x23DB /* fuse */) || (char >= 0x23E2 /* white trapezium */ && char <= 0x23FF)) { return true; } } if (unicodeBlockLookup['Control Pictures'](char) && char !== 0x2423 /* open box */) return true; if (unicodeBlockLookup['Optical Character Recognition'](char)) return true; if (unicodeBlockLookup['Enclosed Alphanumerics'](char)) return true; if (unicodeBlockLookup['Geometric Shapes'](char)) return true; if (unicodeBlockLookup['Miscellaneous Symbols'](char)) { if (!((char >= 0x261A /* black left pointing index */ && char <= 0x261F) /* white down pointing index */)) { return true; } } if (unicodeBlockLookup['Miscellaneous Symbols and Arrows'](char)) { if ((char >= 0x2B12 /* square with top half black */ && char <= 0x2B2F /* white vertical ellipse */) || (char >= 0x2B50 /* white medium star */ && char <= 0x2B59 /* heavy circled saltire */) || (char >= 0x2BB8 /* upwards white arrow from bar with horizontal bar */ && char <= 0x2BEB)) { return true; } } if (unicodeBlockLookup['CJK Symbols and Punctuation'](char)) return true; if (unicodeBlockLookup['Katakana'](char)) return true; if (unicodeBlockLookup['Private Use Area'](char)) return true; if (unicodeBlockLookup['CJK Compatibility Forms'](char)) return true; if (unicodeBlockLookup['Small Form Variants'](char)) return true; if (unicodeBlockLookup['Halfwidth and Fullwidth Forms'](char)) return true; if (char === 0x221E /* infinity */ || char === 0x2234 /* therefore */ || char === 0x2235 /* because */ || (char >= 0x2700 /* black safety scissors */ && char <= 0x2767 /* rotated floral heart bullet */) || (char >= 0x2776 /* dingbat negative circled digit one */ && char <= 0x2793 /* dingbat negative circled sans-serif number ten */) || char === 0xFFFC /* object replacement character */ || char === 0xFFFD /* replacement character */) { return true; } return false; } /** * Returns true if the given Unicode codepoint identifies a character with * rotated orientation. * * A character has rotated orientation if it is drawn rotated when the line is * oriented vertically, even if both adjacent characters are upright. For * example, a Latin letter is drawn rotated along a vertical line. A rotated * character causes an adjacent “neutral” character to be drawn rotated as well. */ function charHasRotatedVerticalOrientation(char) { return !(charHasUprightVerticalOrientation(char) || charHasNeutralVerticalOrientation(char)); } function charInComplexShapingScript(char) { return /\p{sc=Arab}/u.test(String.fromCodePoint(char)); } /** * ISO 15924 script codes of scripts that are primarily written horizontally * right-to-left according to Unicode 16.0.0. */ const rtlScriptCodes = [ 'Adlm', // Adlam 'Arab', // Arabic 'Armi', // Imperial Aramaic 'Avst', // Avestan 'Chrs', // Chorasmian 'Cprt', // Cypriot 'Egyp', // Egyptian Hieroglyphs 'Elym', // Elymaic 'Gara', // Garay 'Hatr', // Hatran 'Hebr', // Hebrew 'Hung', // Old Hungarian 'Khar', // Kharoshthi 'Lydi', // Lydian 'Mand', // Mandaic 'Mani', // Manichaean 'Mend', // Mende Kikakui 'Merc', // Meroitic Cursive 'Mero', // Meroitic Hieroglyphs 'Narb', // Old North Arabian 'Nbat', // Nabataean 'Nkoo', // NKo 'Orkh', // Old Turkic 'Palm', // Palmyrene 'Phli', // Inscriptional Pahlavi 'Phlp', // Psalter Pahlavi 'Phnx', // Phoenician 'Prti', // Inscriptional Parthian 'Rohg', // Hanifi Rohingya 'Samr', // Samaritan 'Sarb', // Old South Arabian 'Sogo', // Old Sogdian 'Syrc', // Syriac 'Thaa', // Thaana 'Todr', // Todhri 'Yezi', // Yezidi ]; const rtlScriptRegExp = sanitizedRegExpFromScriptCodes(rtlScriptCodes); function charInRTLScript(char) { return rtlScriptRegExp.test(String.fromCodePoint(char)); } function charInSupportedScript(char, canRenderRTL) { // This is a rough heuristic: whether we "can render" a script // actually depends on the properties of the font being used // and whether differences from the ideal rendering are considered // semantically significant. // Even in Latin script, we "can't render" combinations such as the fi // ligature, but we don't consider that semantically significant. if (!canRenderRTL && charInRTLScript(char)) { return false; } if ((char >= 0x0900 && char <= 0x0DFF) || // Main blocks for Indic scripts and Sinhala (char >= 0x0F00 && char <= 0x109F) || // Main blocks for Tibetan and Myanmar unicodeBlockLookup['Khmer'](char)) { // These blocks cover common scripts that require // complex text shaping, based on unicode script metadata: // https://www.unicode.org/repos/cldr/trunk/common/properties/scriptMetadata.txt // where "Web Rank <= 32" "Shaping Required = YES" return false; } return true; } function stringContainsRTLText(chars) { for (const char of chars) { if (charInRTLScript(char.charCodeAt(0))) { return true; } } return false; } function isStringInSupportedScript(chars, canRenderRTL) { for (const char of chars) { if (!charInSupportedScript(char.charCodeAt(0), canRenderRTL)) { return false; } } return true; } class RTLWorkerPlugin { constructor() { this.applyArabicShaping = null; this.processBidirectionalText = null; this.processStyledBidirectionalText = null; this.pluginStatus = 'unavailable'; this.pluginURL = null; } setState(state) { this.pluginStatus = state.pluginStatus; this.pluginURL = state.pluginURL; } getState() { return { pluginStatus: this.pluginStatus, pluginURL: this.pluginURL }; } setMethods(rtlTextPlugin) { this.applyArabicShaping = rtlTextPlugin.applyArabicShaping; this.processBidirectionalText = rtlTextPlugin.processBidirectionalText; this.processStyledBidirectionalText = rtlTextPlugin.processStyledBidirectionalText; } isParsed() { return this.applyArabicShaping != null && this.processBidirectionalText != null && this.processStyledBidirectionalText != null; } getPluginURL() { return this.pluginURL; } getRTLTextPluginStatus() { return this.pluginStatus; } } const rtlWorkerPlugin = new RTLWorkerPlugin(); /** * @internal * A parameter that can be evaluated to a value */ class EvaluationParameters { // "options" may also be another EvaluationParameters to copy, see CrossFadedProperty.possiblyEvaluate constructor(zoom, options) { this.zoom = zoom; if (options) { this.now = options.now; this.fadeDuration = options.fadeDuration; this.zoomHistory = options.zoomHistory; this.transition = options.transition; } else { this.now = 0; this.fadeDuration = 0; this.zoomHistory = new ZoomHistory(); this.transition = {}; } } isSupportedScript(str) { return isStringInSupportedScript(str, rtlWorkerPlugin.getRTLTextPluginStatus() === 'loaded'); } crossFadingFactor() { if (this.fadeDuration === 0) { return 1; } else { return Math.min((this.now - this.zoomHistory.lastIntegerZoomTime) / this.fadeDuration, 1); } } getCrossfadeParameters() { const z = this.zoom; const fraction = z - Math.floor(z); const t = this.crossFadingFactor(); return z > this.zoomHistory.lastIntegerZoom ? { fromScale: 2, toScale: 1, t: fraction + (1 - fraction) * t } : { fromScale: 0.5, toScale: 1, t: 1 - (1 - t) * fraction }; } } /** * @internal * `PropertyValue` represents the value part of a property key-value unit. It's used to represent both * paint and layout property values, and regardless of whether or not their property supports data-driven * expressions. * * `PropertyValue` stores the raw input value as seen in a style or a runtime styling API call, i.e. one of the * following: * * * A constant value of the type appropriate for the property * * A function which produces a value of that type (but functions are quasi-deprecated in favor of expressions) * * An expression which produces a value of that type * * "undefined"/"not present", in which case the property is assumed to take on its default value. * * In addition to storing the original input value, `PropertyValue` also stores a normalized representation, * effectively treating functions as if they are expressions, and constant or default values as if they are * (constant) expressions. */ class PropertyValue { constructor(property, value) { this.property = property; this.value = value; this.expression = normalizePropertyExpression(value === undefined ? property.specification.default : value, property.specification); } isDataDriven() { return this.expression.kind === 'source' || this.expression.kind === 'composite'; } possiblyEvaluate(parameters, canonical, availableImages) { return this.property.possiblyEvaluate(this, parameters, canonical, availableImages); } } /** * @internal * Paint properties are _transitionable_: they can change in a fluid manner, interpolating or cross-fading between * old and new value. The duration of the transition, and the delay before it begins, is configurable. * * `TransitionablePropertyValue` is a compositional class that stores both the property value and that transition * configuration. * * A `TransitionablePropertyValue` can calculate the next step in the evaluation chain for paint property values: * `TransitioningPropertyValue`. */ class TransitionablePropertyValue { constructor(property) { this.property = property; this.value = new PropertyValue(property, undefined); } transitioned(parameters, prior) { return new TransitioningPropertyValue(this.property, this.value, prior, extend({}, parameters.transition, this.transition), parameters.now); } untransitioned() { return new TransitioningPropertyValue(this.property, this.value, null, {}, 0); } } /** * @internal * `Transitionable` stores a map of all (property name, `TransitionablePropertyValue`) pairs for paint properties of a * given layer type. It can calculate the `TransitioningPropertyValue`s for all of them at once, producing a * `Transitioning` instance for the same set of properties. */ class Transitionable { constructor(properties) { this._properties = properties; this._values = Object.create(properties.defaultTransitionablePropertyValues); } getValue(name) { return clone$9(this._values[name].value.value); } setValue(name, value) { if (!Object.prototype.hasOwnProperty.call(this._values, name)) { this._values[name] = new TransitionablePropertyValue(this._values[name].property); } // Note that we do not _remove_ an own property in the case where a value is being reset // to the default: the transition might still be non-default. this._values[name].value = new PropertyValue(this._values[name].property, value === null ? undefined : clone$9(value)); } getTransition(name) { return clone$9(this._values[name].transition); } setTransition(name, value) { if (!Object.prototype.hasOwnProperty.call(this._values, name)) { this._values[name] = new TransitionablePropertyValue(this._values[name].property); } this._values[name].transition = clone$9(value) || undefined; } serialize() { const result = {}; for (const property of Object.keys(this._values)) { const value = this.getValue(property); if (value !== undefined) { result[property] = value; } const transition = this.getTransition(property); if (transition !== undefined) { result[`${property}-transition`] = transition; } } return result; } transitioned(parameters, prior) { const result = new Transitioning(this._properties); for (const property of Object.keys(this._values)) { result._values[property] = this._values[property].transitioned(parameters, prior._values[property]); } return result; } untransitioned() { const result = new Transitioning(this._properties); for (const property of Object.keys(this._values)) { result._values[property] = this._values[property].untransitioned(); } return result; } } /** * @internal * `TransitioningPropertyValue` implements the first of two intermediate steps in the evaluation chain of a paint * property value. In this step, transitions between old and new values are handled: as long as the transition is in * progress, `TransitioningPropertyValue` maintains a reference to the prior value, and interpolates between it and * the new value based on the current time and the configured transition duration and delay. The product is the next * step in the evaluation chain: the "possibly evaluated" result type `R`. See below for more on this concept. */ class TransitioningPropertyValue { constructor(property, value, prior, transition, now) { this.property = property; this.value = value; this.begin = now + transition.delay || 0; this.end = this.begin + transition.duration || 0; if (property.specification.transition && (transition.delay || transition.duration)) { this.prior = prior; } } possiblyEvaluate(parameters, canonical, availableImages) { const now = parameters.now || 0; const finalValue = this.value.possiblyEvaluate(parameters, canonical, availableImages); const prior = this.prior; if (!prior) { // No prior value. return finalValue; } else if (now > this.end) { // Transition from prior value is now complete. this.prior = null; return finalValue; } else if (this.value.isDataDriven()) { // Transitions to data-driven properties are not supported. // We snap immediately to the data-driven value so that, when we perform layout, // we see the data-driven function and can use it to populate vertex buffers. this.prior = null; return finalValue; } else if (now < this.begin) { // Transition hasn't started yet. return prior.possiblyEvaluate(parameters, canonical, availableImages); } else { // Interpolate between recursively-calculated prior value and final. const t = (now - this.begin) / (this.end - this.begin); return this.property.interpolate(prior.possiblyEvaluate(parameters, canonical, availableImages), finalValue, easeCubicInOut(t)); } } } /** * @internal * `Transitioning` stores a map of all (property name, `TransitioningPropertyValue`) pairs for paint properties of a * given layer type. It can calculate the possibly-evaluated values for all of them at once, producing a * `PossiblyEvaluated` instance for the same set of properties. */ class Transitioning { constructor(properties) { this._properties = properties; this._values = Object.create(properties.defaultTransitioningPropertyValues); } possiblyEvaluate(parameters, canonical, availableImages) { const result = new PossiblyEvaluated(this._properties); for (const property of Object.keys(this._values)) { result._values[property] = this._values[property].possiblyEvaluate(parameters, canonical, availableImages); } return result; } hasTransition() { for (const property of Object.keys(this._values)) { if (this._values[property].prior) { return true; } } return false; } } // ------- Layout ------- /** * Because layout properties are not transitionable, they have a simpler representation and evaluation chain than * paint properties: `PropertyValue`s are possibly evaluated, producing possibly evaluated values, which are then * fully evaluated. * * `Layout` stores a map of all (property name, `PropertyValue`) pairs for layout properties of a * given layer type. It can calculate the possibly-evaluated values for all of them at once, producing a * `PossiblyEvaluated` instance for the same set of properties. */ class Layout { constructor(properties) { this._properties = properties; this._values = Object.create(properties.defaultPropertyValues); } hasValue(name) { return this._values[name].value !== undefined; } getValue(name) { return clone$9(this._values[name].value); } setValue(name, value) { this._values[name] = new PropertyValue(this._values[name].property, value === null ? undefined : clone$9(value)); } serialize() { const result = {}; for (const property of Object.keys(this._values)) { const value = this.getValue(property); if (value !== undefined) { result[property] = value; } } return result; } possiblyEvaluate(parameters, canonical, availableImages) { const result = new PossiblyEvaluated(this._properties); for (const property of Object.keys(this._values)) { result._values[property] = this._values[property].possiblyEvaluate(parameters, canonical, availableImages); } return result; } } /** * @internal * `PossiblyEvaluatedPropertyValue` is used for data-driven paint and layout property values. It holds a * `PossiblyEvaluatedValue` and the `GlobalProperties` that were used to generate it. You're not allowed to supply * a different set of `GlobalProperties` when performing the final evaluation because they would be ignored in the * case where the input value was a constant or camera function. */ class PossiblyEvaluatedPropertyValue { constructor(property, value, parameters) { this.property = property; this.value = value; this.parameters = parameters; } isConstant() { return this.value.kind === 'constant'; } constantOr(value) { if (this.value.kind === 'constant') { return this.value.value; } else { return value; } } evaluate(feature, featureState, canonical, availableImages) { return this.property.evaluate(this.value, this.parameters, feature, featureState, canonical, availableImages); } } /** * @internal * `PossiblyEvaluated` stores a map of all (property name, `R`) pairs for paint or layout properties of a * given layer type. */ class PossiblyEvaluated { constructor(properties) { this._properties = properties; this._values = Object.create(properties.defaultPossiblyEvaluatedValues); } get(name) { return this._values[name]; } } /** * @internal * An implementation of `Property` for properties that do not permit data-driven (source or composite) expressions. * This restriction allows us to declare statically that the result of possibly evaluating this kind of property * is in fact always the scalar type `T`, and can be used without further evaluating the value on a per-feature basis. */ class DataConstantProperty { constructor(specification) { this.specification = specification; } possiblyEvaluate(value, parameters) { if (value.isDataDriven()) throw new Error('Value should not be data driven'); return value.expression.evaluate(parameters); } interpolate(a, b, t) { const interpolationType = this.specification.type; const interpolationFn = interpolate[interpolationType]; if (interpolationFn) { return interpolationFn(a, b, t); } else { return a; } } } /** * @internal * An implementation of `Property` for properties that permit data-driven (source or composite) expressions. * The result of possibly evaluating this kind of property is `PossiblyEvaluatedPropertyValue`; obtaining * a scalar value `T` requires further evaluation on a per-feature basis. */ class DataDrivenProperty { constructor(specification, overrides) { this.specification = specification; this.overrides = overrides; } possiblyEvaluate(value, parameters, canonical, availableImages) { if (value.expression.kind === 'constant' || value.expression.kind === 'camera') { return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: value.expression.evaluate(parameters, null, {}, canonical, availableImages) }, parameters); } else { return new PossiblyEvaluatedPropertyValue(this, value.expression, parameters); } } interpolate(a, b, t) { // If either possibly-evaluated value is non-constant, give up: we aren't able to interpolate data-driven values. if (a.value.kind !== 'constant' || b.value.kind !== 'constant') { return a; } // Special case hack solely for fill-outline-color. The undefined value is subsequently handled in // FillStyleLayer#recalculate, which sets fill-outline-color to the fill-color value if the former // is a PossiblyEvaluatedPropertyValue containing a constant undefined value. In addition to the // return value here, the other source of a PossiblyEvaluatedPropertyValue containing a constant // undefined value is the "default value" for fill-outline-color held in // `Properties#defaultPossiblyEvaluatedValues`, which serves as the prototype of // `PossiblyEvaluated#_values`. if (a.value.value === undefined || b.value.value === undefined) { return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: undefined }, a.parameters); } const interpolationType = this.specification.type; const interpolationFn = interpolate[interpolationType]; if (interpolationFn) { const interpolatedValue = interpolationFn(a.value.value, b.value.value, t); return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: interpolatedValue }, a.parameters); } else { return a; } } evaluate(value, parameters, feature, featureState, canonical, availableImages) { if (value.kind === 'constant') { return value.value; } else { return value.evaluate(parameters, feature, featureState, canonical, availableImages); } } } /** * @internal * An implementation of `Property` for data driven `line-pattern` which are transitioned by cross-fading * rather than interpolation. */ class CrossFadedDataDrivenProperty extends DataDrivenProperty { possiblyEvaluate(value, parameters, canonical, availableImages) { if (value.value === undefined) { return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: undefined }, parameters); } else if (value.expression.kind === 'constant') { const evaluatedValue = value.expression.evaluate(parameters, null, {}, canonical, availableImages); const isImageExpression = value.property.specification.type === 'resolvedImage'; const constantValue = isImageExpression && typeof evaluatedValue !== 'string' ? evaluatedValue.name : evaluatedValue; const constant = this._calculate(constantValue, constantValue, constantValue, parameters); return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: constant }, parameters); } else if (value.expression.kind === 'camera') { const cameraVal = this._calculate(value.expression.evaluate({ zoom: parameters.zoom - 1.0 }), value.expression.evaluate({ zoom: parameters.zoom }), value.expression.evaluate({ zoom: parameters.zoom + 1.0 }), parameters); return new PossiblyEvaluatedPropertyValue(this, { kind: 'constant', value: cameraVal }, parameters); } else { // source or composite expression return new PossiblyEvaluatedPropertyValue(this, value.expression, parameters); } } evaluate(value, globals, feature, featureState, canonical, availableImages) { if (value.kind === 'source') { const constant = value.evaluate(globals, feature, featureState, canonical, availableImages); return this._calculate(constant, constant, constant, globals); } else if (value.kind === 'composite') { return this._calculate(value.evaluate({ zoom: Math.floor(globals.zoom) - 1.0 }, feature, featureState), value.evaluate({ zoom: Math.floor(globals.zoom) }, feature, featureState), value.evaluate({ zoom: Math.floor(globals.zoom) + 1.0 }, feature, featureState), globals); } else { return value.value; } } _calculate(min, mid, max, parameters) { const z = parameters.zoom; return z > parameters.zoomHistory.lastIntegerZoom ? { from: min, to: mid } : { from: max, to: mid }; } interpolate(a) { return a; } } /** * @internal * An implementation of `Property` for `*-pattern` and `line-dasharray`, which are transitioned by cross-fading * rather than interpolation. */ class CrossFadedProperty { constructor(specification) { this.specification = specification; } possiblyEvaluate(value, parameters, canonical, availableImages) { if (value.value === undefined) { return undefined; } else if (value.expression.kind === 'constant') { const constant = value.expression.evaluate(parameters, null, {}, canonical, availableImages); return this._calculate(constant, constant, constant, parameters); } else { return this._calculate(value.expression.evaluate(new EvaluationParameters(Math.floor(parameters.zoom - 1.0), parameters)), value.expression.evaluate(new EvaluationParameters(Math.floor(parameters.zoom), parameters)), value.expression.evaluate(new EvaluationParameters(Math.floor(parameters.zoom + 1.0), parameters)), parameters); } } _calculate(min, mid, max, parameters) { const z = parameters.zoom; return z > parameters.zoomHistory.lastIntegerZoom ? { from: min, to: mid } : { from: max, to: mid }; } interpolate(a) { return a; } } /** * @internal * An implementation of `Property` for `heatmap-color` and `line-gradient`. Interpolation is a no-op, and * evaluation returns a boolean value in order to indicate its presence, but the real * evaluation happens in StyleLayer classes. */ class ColorRampProperty { constructor(specification) { this.specification = specification; } possiblyEvaluate(value, parameters, canonical, availableImages) { return !!value.expression.evaluate(parameters, null, {}, canonical, availableImages); } interpolate() { return false; } } /** * @internal * `Properties` holds objects containing default values for the layout or paint property set of a given * layer type. These objects are immutable, and they are used as the prototypes for the `_values` members of * `Transitionable`, `Transitioning`, `Layout`, and `PossiblyEvaluated`. This allows these classes to avoid * doing work in the common case where a property has no explicit value set and should be considered to take * on the default value: using `for (const property of Object.keys(this._values))`, they can iterate over * only the _own_ properties of `_values`, skipping repeated calculation of transitions and possible/final * evaluations for defaults, the result of which will always be the same. */ class Properties { constructor(properties) { this.properties = properties; this.defaultPropertyValues = {}; this.defaultTransitionablePropertyValues = {}; this.defaultTransitioningPropertyValues = {}; this.defaultPossiblyEvaluatedValues = {}; this.overridableProperties = []; for (const property in properties) { const prop = properties[property]; if (prop.specification.overridable) { this.overridableProperties.push(property); } const defaultPropertyValue = this.defaultPropertyValues[property] = new PropertyValue(prop, undefined); const defaultTransitionablePropertyValue = this.defaultTransitionablePropertyValues[property] = new TransitionablePropertyValue(prop); this.defaultTransitioningPropertyValues[property] = defaultTransitionablePropertyValue.untransitioned(); this.defaultPossiblyEvaluatedValues[property] = defaultPropertyValue.possiblyEvaluate({}); } } } register('DataDrivenProperty', DataDrivenProperty); register('DataConstantProperty', DataConstantProperty); register('CrossFadedDataDrivenProperty', CrossFadedDataDrivenProperty); register('CrossFadedProperty', CrossFadedProperty); register('ColorRampProperty', ColorRampProperty); const TRANSITION_SUFFIX$2 = '-transition'; /** * A base class for style layers */ class StyleLayer extends Evented { constructor(layer, properties) { super(); this.id = layer.id; this.type = layer.type; this._featureFilter = { filter: () => true, needGeometry: false }; if (layer.type === 'custom') return; layer = layer; this.metadata = layer.metadata; this.minzoom = layer.minzoom; this.maxzoom = layer.maxzoom; if (layer.type !== 'background') { this.source = layer.source; this.sourceLayer = layer['source-layer']; this.filter = layer.filter; } if (properties.layout) { this._unevaluatedLayout = new Layout(properties.layout); } if (properties.paint) { this._transitionablePaint = new Transitionable(properties.paint); for (const property in layer.paint) { this.setPaintProperty(property, layer.paint[property], { validate: false }); } for (const property in layer.layout) { this.setLayoutProperty(property, layer.layout[property], { validate: false }); } this._transitioningPaint = this._transitionablePaint.untransitioned(); //$FlowFixMe this.paint = new PossiblyEvaluated(properties.paint); } } getCrossfadeParameters() { return this._crossfadeParameters; } getLayoutProperty(name) { if (name === 'visibility') { return this.visibility; } return this._unevaluatedLayout.getValue(name); } setLayoutProperty(name, value, options = {}) { if (value !== null && value !== undefined) { const key = `layers.${this.id}.layout.${name}`; if (this._validate(validateLayoutProperty, key, name, value, options)) { return; } } if (name === 'visibility') { this.visibility = value; return; } this._unevaluatedLayout.setValue(name, value); } getPaintProperty(name) { if (name.endsWith(TRANSITION_SUFFIX$2)) { return this._transitionablePaint.getTransition(name.slice(0, -TRANSITION_SUFFIX$2.length)); } else { return this._transitionablePaint.getValue(name); } } setPaintProperty(name, value, options = {}) { if (value !== null && value !== undefined) { const key = `layers.${this.id}.paint.${name}`; if (this._validate(validatePaintProperty, key, name, value, options)) { return false; } } if (name.endsWith(TRANSITION_SUFFIX$2)) { this._transitionablePaint.setTransition(name.slice(0, -TRANSITION_SUFFIX$2.length), value || undefined); return false; } else { const transitionable = this._transitionablePaint._values[name]; const isCrossFadedProperty = transitionable.property.specification['property-type'] === 'cross-faded-data-driven'; const wasDataDriven = transitionable.value.isDataDriven(); const oldValue = transitionable.value; this._transitionablePaint.setValue(name, value); this._handleSpecialPaintPropertyUpdate(name); const newValue = this._transitionablePaint._values[name].value; const isDataDriven = newValue.isDataDriven(); // if a cross-faded value is changed, we need to make sure the new icons get added to each tile's iconAtlas // so a call to _updateLayer is necessary, and we return true from this function so it gets called in // Style#setPaintProperty return isDataDriven || wasDataDriven || isCrossFadedProperty || this._handleOverridablePaintPropertyUpdate(name, oldValue, newValue); } } _handleSpecialPaintPropertyUpdate(_) { // No-op; can be overridden by derived classes. } // eslint-disable-next-line @typescript-eslint/no-unused-vars _handleOverridablePaintPropertyUpdate(name, oldValue, newValue) { // No-op; can be overridden by derived classes. return false; } isHidden(zoom) { if (this.minzoom && zoom < this.minzoom) return true; if (this.maxzoom && zoom >= this.maxzoom) return true; return this.visibility === 'none'; } updateTransitions(parameters) { this._transitioningPaint = this._transitionablePaint.transitioned(parameters, this._transitioningPaint); } hasTransition() { return this._transitioningPaint.hasTransition(); } recalculate(parameters, availableImages) { if (parameters.getCrossfadeParameters) { this._crossfadeParameters = parameters.getCrossfadeParameters(); } if (this._unevaluatedLayout) { this.layout = this._unevaluatedLayout.possiblyEvaluate(parameters, undefined, availableImages); } this.paint = this._transitioningPaint.possiblyEvaluate(parameters, undefined, availableImages); } serialize() { const output = { 'id': this.id, 'type': this.type, 'source': this.source, 'source-layer': this.sourceLayer, 'metadata': this.metadata, 'minzoom': this.minzoom, 'maxzoom': this.maxzoom, 'filter': this.filter, 'layout': this._unevaluatedLayout && this._unevaluatedLayout.serialize(), 'paint': this._transitionablePaint && this._transitionablePaint.serialize() }; if (this.visibility) { output.layout = output.layout || {}; output.layout.visibility = this.visibility; } return filterObject(output, (value, key) => { return value !== undefined && !(key === 'layout' && !Object.keys(value).length) && !(key === 'paint' && !Object.keys(value).length); }); } _validate(validate, key, name, value, options = {}) { if (options && options.validate === false) { return false; } return emitValidationErrors$1(this, validate.call(validateStyle, { key, layerType: this.type, objectKey: name, value, styleSpec: v8Spec, // Workaround for https://github.com/mapbox/mapbox-gl-js/issues/2407 style: { glyphs: true, sprite: true } })); } is3D() { return false; } isTileClipped() { return false; } hasOffscreenPass() { return false; } resize() { // noop } isStateDependent() { for (const property in this.paint._values) { const value = this.paint.get(property); if (!(value instanceof PossiblyEvaluatedPropertyValue) || !supportsPropertyExpression(value.property.specification)) { continue; } if ((value.value.kind === 'source' || value.value.kind === 'composite') && value.value.isStateDependent) { return true; } } return false; } } // Note: all "sizes" are measured in bytes /** * @internal * A view type size */ const viewTypes = { 'Int8': Int8Array, 'Uint8': Uint8Array, 'Int16': Int16Array, 'Uint16': Uint16Array, 'Int32': Int32Array, 'Uint32': Uint32Array, 'Float32': Float32Array }; /** @internal */ class Struct { /** * @param structArray - The StructArray the struct is stored in * @param index - The index of the struct in the StructArray. */ constructor(structArray, index) { this._structArray = structArray; this._pos1 = index * this.size; this._pos2 = this._pos1 / 2; this._pos4 = this._pos1 / 4; this._pos8 = this._pos1 / 8; } } const DEFAULT_CAPACITY = 128; const RESIZE_MULTIPLIER = 5; /** * @internal * `StructArray` provides an abstraction over `ArrayBuffer` and `TypedArray` * making it behave like an array of typed structs. * * Conceptually, a StructArray is comprised of elements, i.e., instances of its * associated struct type. Each particular struct type, together with an * alignment size, determines the memory layout of a StructArray whose elements * are of that type. Thus, for each such layout that we need, we have * a corresponding StructArrayLayout class, inheriting from StructArray and * implementing `emplaceBack()` and `_refreshViews()`. * * In some cases, where we need to access particular elements of a StructArray, * we implement a more specific subclass that inherits from one of the * StructArrayLayouts and adds a `get(i): T` accessor that returns a structured * object whose properties are proxies into the underlying memory space for the * i-th element. This affords the convenience of working with (seemingly) plain * Javascript objects without the overhead of serializing/deserializing them * into ArrayBuffers for efficient web worker transfer. */ class StructArray { constructor() { this.isTransferred = false; this.capacity = -1; this.resize(0); } /** * Serialize a StructArray instance. Serializes both the raw data and the * metadata needed to reconstruct the StructArray base class during * deserialization. */ static serialize(array, transferables) { array._trim(); if (transferables) { array.isTransferred = true; transferables.push(array.arrayBuffer); } return { length: array.length, arrayBuffer: array.arrayBuffer, }; } static deserialize(input) { const structArray = Object.create(this.prototype); structArray.arrayBuffer = input.arrayBuffer; structArray.length = input.length; structArray.capacity = input.arrayBuffer.byteLength / structArray.bytesPerElement; structArray._refreshViews(); return structArray; } /** * Resize the array to discard unused capacity. */ _trim() { if (this.length !== this.capacity) { this.capacity = this.length; this.arrayBuffer = this.arrayBuffer.slice(0, this.length * this.bytesPerElement); this._refreshViews(); } } /** * Resets the length of the array to 0 without de-allocating capacity. */ clear() { this.length = 0; } /** * Resize the array. * If `n` is greater than the current length then additional elements with undefined values are added. * If `n` is less than the current length then the array will be reduced to the first `n` elements. * @param n - The new size of the array. */ resize(n) { this.reserve(n); this.length = n; } /** * Indicate a planned increase in size, so that any necessary allocation may * be done once, ahead of time. * @param n - The expected size of the array. */ reserve(n) { if (n > this.capacity) { this.capacity = Math.max(n, Math.floor(this.capacity * RESIZE_MULTIPLIER), DEFAULT_CAPACITY); this.arrayBuffer = new ArrayBuffer(this.capacity * this.bytesPerElement); const oldUint8Array = this.uint8; this._refreshViews(); if (oldUint8Array) this.uint8.set(oldUint8Array); } } /** * Create TypedArray views for the current ArrayBuffer. */ _refreshViews() { throw new Error('_refreshViews() must be implemented by each concrete StructArray layout'); } } /** * Given a list of member fields, create a full StructArrayLayout, in * particular calculating the correct byte offset for each field. This data * is used at build time to generate StructArrayLayout_*#emplaceBack() and * other accessors, and at runtime for binding vertex buffer attributes. */ function createLayout(members, alignment = 1) { let offset = 0; let maxSize = 0; const layoutMembers = members.map((member) => { const typeSize = sizeOf(member.type); const memberOffset = offset = align$1(offset, Math.max(alignment, typeSize)); const components = member.components || 1; maxSize = Math.max(maxSize, typeSize); offset += typeSize * components; return { name: member.name, type: member.type, components, offset: memberOffset, }; }); const size = align$1(offset, Math.max(maxSize, alignment)); return { members: layoutMembers, size, alignment }; } function sizeOf(type) { return viewTypes[type].BYTES_PER_ELEMENT; } function align$1(offset, size) { return Math.ceil(offset / size) * size; } // This file is generated. Edit build/generate-struct-arrays.ts, then run `npm run codegen`. /** * @internal * Implementation of the StructArray layout: * [0] - Int16[2] * */ class StructArrayLayout2i4 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1); } emplace(i, v0, v1) { const o2 = i * 2; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; return i; } } StructArrayLayout2i4.prototype.bytesPerElement = 4; register('StructArrayLayout2i4', StructArrayLayout2i4); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[3] * */ class StructArrayLayout3i6 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2); } emplace(i, v0, v1, v2) { const o2 = i * 3; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; return i; } } StructArrayLayout3i6.prototype.bytesPerElement = 6; register('StructArrayLayout3i6', StructArrayLayout3i6); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[4] * */ class StructArrayLayout4i8 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3); } emplace(i, v0, v1, v2, v3) { const o2 = i * 4; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; return i; } } StructArrayLayout4i8.prototype.bytesPerElement = 8; register('StructArrayLayout4i8', StructArrayLayout4i8); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[2] * [4] - Int16[4] * */ class StructArrayLayout2i4i12 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5); } emplace(i, v0, v1, v2, v3, v4, v5) { const o2 = i * 6; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; this.int16[o2 + 4] = v4; this.int16[o2 + 5] = v5; return i; } } StructArrayLayout2i4i12.prototype.bytesPerElement = 12; register('StructArrayLayout2i4i12', StructArrayLayout2i4i12); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[2] * [4] - Uint8[4] * */ class StructArrayLayout2i4ub8 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5); } emplace(i, v0, v1, v2, v3, v4, v5) { const o2 = i * 4; const o1 = i * 8; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.uint8[o1 + 4] = v2; this.uint8[o1 + 5] = v3; this.uint8[o1 + 6] = v4; this.uint8[o1 + 7] = v5; return i; } } StructArrayLayout2i4ub8.prototype.bytesPerElement = 8; register('StructArrayLayout2i4ub8', StructArrayLayout2i4ub8); /** * @internal * Implementation of the StructArray layout: * [0] - Float32[2] * */ class StructArrayLayout2f8 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1); } emplace(i, v0, v1) { const o4 = i * 2; this.float32[o4 + 0] = v0; this.float32[o4 + 1] = v1; return i; } } StructArrayLayout2f8.prototype.bytesPerElement = 8; register('StructArrayLayout2f8', StructArrayLayout2f8); /** * @internal * Implementation of the StructArray layout: * [0] - Uint16[10] * */ class StructArrayLayout10ui20 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5, v6, v7, v8, v9) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9); } emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9) { const o2 = i * 10; this.uint16[o2 + 0] = v0; this.uint16[o2 + 1] = v1; this.uint16[o2 + 2] = v2; this.uint16[o2 + 3] = v3; this.uint16[o2 + 4] = v4; this.uint16[o2 + 5] = v5; this.uint16[o2 + 6] = v6; this.uint16[o2 + 7] = v7; this.uint16[o2 + 8] = v8; this.uint16[o2 + 9] = v9; return i; } } StructArrayLayout10ui20.prototype.bytesPerElement = 20; register('StructArrayLayout10ui20', StructArrayLayout10ui20); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[4] * [8] - Uint16[4] * [16] - Int16[4] * */ class StructArrayLayout4i4ui4i24 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11); } emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11) { const o2 = i * 12; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; this.uint16[o2 + 4] = v4; this.uint16[o2 + 5] = v5; this.uint16[o2 + 6] = v6; this.uint16[o2 + 7] = v7; this.int16[o2 + 8] = v8; this.int16[o2 + 9] = v9; this.int16[o2 + 10] = v10; this.int16[o2 + 11] = v11; return i; } } StructArrayLayout4i4ui4i24.prototype.bytesPerElement = 24; register('StructArrayLayout4i4ui4i24', StructArrayLayout4i4ui4i24); /** * @internal * Implementation of the StructArray layout: * [0] - Float32[3] * */ class StructArrayLayout3f12 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1, v2) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2); } emplace(i, v0, v1, v2) { const o4 = i * 3; this.float32[o4 + 0] = v0; this.float32[o4 + 1] = v1; this.float32[o4 + 2] = v2; return i; } } StructArrayLayout3f12.prototype.bytesPerElement = 12; register('StructArrayLayout3f12', StructArrayLayout3f12); /** * @internal * Implementation of the StructArray layout: * [0] - Uint32[1] * */ class StructArrayLayout1ul4 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint32 = new Uint32Array(this.arrayBuffer); } emplaceBack(v0) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0); } emplace(i, v0) { const o4 = i * 1; this.uint32[o4 + 0] = v0; return i; } } StructArrayLayout1ul4.prototype.bytesPerElement = 4; register('StructArrayLayout1ul4', StructArrayLayout1ul4); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[6] * [12] - Uint32[1] * [16] - Uint16[2] * */ class StructArrayLayout6i1ul2ui20 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); this.uint32 = new Uint32Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5, v6, v7, v8) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8); } emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8) { const o2 = i * 10; const o4 = i * 5; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; this.int16[o2 + 4] = v4; this.int16[o2 + 5] = v5; this.uint32[o4 + 3] = v6; this.uint16[o2 + 8] = v7; this.uint16[o2 + 9] = v8; return i; } } StructArrayLayout6i1ul2ui20.prototype.bytesPerElement = 20; register('StructArrayLayout6i1ul2ui20', StructArrayLayout6i1ul2ui20); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[2] * [4] - Int16[2] * [8] - Int16[2] * */ class StructArrayLayout2i2i2i12 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5); } emplace(i, v0, v1, v2, v3, v4, v5) { const o2 = i * 6; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; this.int16[o2 + 4] = v4; this.int16[o2 + 5] = v5; return i; } } StructArrayLayout2i2i2i12.prototype.bytesPerElement = 12; register('StructArrayLayout2i2i2i12', StructArrayLayout2i2i2i12); /** * @internal * Implementation of the StructArray layout: * [0] - Float32[2] * [8] - Float32[1] * [12] - Int16[2] * */ class StructArrayLayout2f1f2i16 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4); } emplace(i, v0, v1, v2, v3, v4) { const o4 = i * 4; const o2 = i * 8; this.float32[o4 + 0] = v0; this.float32[o4 + 1] = v1; this.float32[o4 + 2] = v2; this.int16[o2 + 6] = v3; this.int16[o2 + 7] = v4; return i; } } StructArrayLayout2f1f2i16.prototype.bytesPerElement = 16; register('StructArrayLayout2f1f2i16', StructArrayLayout2f1f2i16); /** * @internal * Implementation of the StructArray layout: * [0] - Uint8[2] * [4] - Float32[2] * [12] - Int16[2] * */ class StructArrayLayout2ub2f2i16 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5); } emplace(i, v0, v1, v2, v3, v4, v5) { const o1 = i * 16; const o4 = i * 4; const o2 = i * 8; this.uint8[o1 + 0] = v0; this.uint8[o1 + 1] = v1; this.float32[o4 + 1] = v2; this.float32[o4 + 2] = v3; this.int16[o2 + 6] = v4; this.int16[o2 + 7] = v5; return i; } } StructArrayLayout2ub2f2i16.prototype.bytesPerElement = 16; register('StructArrayLayout2ub2f2i16', StructArrayLayout2ub2f2i16); /** * @internal * Implementation of the StructArray layout: * [0] - Uint16[3] * */ class StructArrayLayout3ui6 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2); } emplace(i, v0, v1, v2) { const o2 = i * 3; this.uint16[o2 + 0] = v0; this.uint16[o2 + 1] = v1; this.uint16[o2 + 2] = v2; return i; } } StructArrayLayout3ui6.prototype.bytesPerElement = 6; register('StructArrayLayout3ui6', StructArrayLayout3ui6); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[2] * [4] - Uint16[2] * [8] - Uint32[3] * [20] - Uint16[3] * [28] - Float32[2] * [36] - Uint8[3] * [40] - Uint32[1] * [44] - Int16[1] * */ class StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); this.uint32 = new Uint32Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16); } emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16) { const o2 = i * 24; const o4 = i * 12; const o1 = i * 48; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.uint16[o2 + 2] = v2; this.uint16[o2 + 3] = v3; this.uint32[o4 + 2] = v4; this.uint32[o4 + 3] = v5; this.uint32[o4 + 4] = v6; this.uint16[o2 + 10] = v7; this.uint16[o2 + 11] = v8; this.uint16[o2 + 12] = v9; this.float32[o4 + 7] = v10; this.float32[o4 + 8] = v11; this.uint8[o1 + 36] = v12; this.uint8[o1 + 37] = v13; this.uint8[o1 + 38] = v14; this.uint32[o4 + 10] = v15; this.int16[o2 + 22] = v16; return i; } } StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48.prototype.bytesPerElement = 48; register('StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48', StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48); /** * @internal * Implementation of the StructArray layout: * [0] - Int16[8] * [16] - Uint16[15] * [48] - Uint32[1] * [52] - Float32[2] * [60] - Uint16[2] * */ class StructArrayLayout8i15ui1ul2f2ui64 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.int16 = new Int16Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); this.uint32 = new Uint32Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27); } emplace(i, v0, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27) { const o2 = i * 32; const o4 = i * 16; this.int16[o2 + 0] = v0; this.int16[o2 + 1] = v1; this.int16[o2 + 2] = v2; this.int16[o2 + 3] = v3; this.int16[o2 + 4] = v4; this.int16[o2 + 5] = v5; this.int16[o2 + 6] = v6; this.int16[o2 + 7] = v7; this.uint16[o2 + 8] = v8; this.uint16[o2 + 9] = v9; this.uint16[o2 + 10] = v10; this.uint16[o2 + 11] = v11; this.uint16[o2 + 12] = v12; this.uint16[o2 + 13] = v13; this.uint16[o2 + 14] = v14; this.uint16[o2 + 15] = v15; this.uint16[o2 + 16] = v16; this.uint16[o2 + 17] = v17; this.uint16[o2 + 18] = v18; this.uint16[o2 + 19] = v19; this.uint16[o2 + 20] = v20; this.uint16[o2 + 21] = v21; this.uint16[o2 + 22] = v22; this.uint32[o4 + 12] = v23; this.float32[o4 + 13] = v24; this.float32[o4 + 14] = v25; this.uint16[o2 + 30] = v26; this.uint16[o2 + 31] = v27; return i; } } StructArrayLayout8i15ui1ul2f2ui64.prototype.bytesPerElement = 64; register('StructArrayLayout8i15ui1ul2f2ui64', StructArrayLayout8i15ui1ul2f2ui64); /** * @internal * Implementation of the StructArray layout: * [0] - Float32[1] * */ class StructArrayLayout1f4 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0); } emplace(i, v0) { const o4 = i * 1; this.float32[o4 + 0] = v0; return i; } } StructArrayLayout1f4.prototype.bytesPerElement = 4; register('StructArrayLayout1f4', StructArrayLayout1f4); /** * @internal * Implementation of the StructArray layout: * [0] - Uint16[1] * [4] - Float32[2] * */ class StructArrayLayout1ui2f12 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1, v2) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2); } emplace(i, v0, v1, v2) { const o2 = i * 6; const o4 = i * 3; this.uint16[o2 + 0] = v0; this.float32[o4 + 1] = v1; this.float32[o4 + 2] = v2; return i; } } StructArrayLayout1ui2f12.prototype.bytesPerElement = 12; register('StructArrayLayout1ui2f12', StructArrayLayout1ui2f12); /** * @internal * Implementation of the StructArray layout: * [0] - Uint32[1] * [4] - Uint16[2] * */ class StructArrayLayout1ul2ui8 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint32 = new Uint32Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1, v2) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2); } emplace(i, v0, v1, v2) { const o4 = i * 2; const o2 = i * 4; this.uint32[o4 + 0] = v0; this.uint16[o2 + 2] = v1; this.uint16[o2 + 3] = v2; return i; } } StructArrayLayout1ul2ui8.prototype.bytesPerElement = 8; register('StructArrayLayout1ul2ui8', StructArrayLayout1ul2ui8); /** * @internal * Implementation of the StructArray layout: * [0] - Uint16[2] * */ class StructArrayLayout2ui4 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0, v1) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1); } emplace(i, v0, v1) { const o2 = i * 2; this.uint16[o2 + 0] = v0; this.uint16[o2 + 1] = v1; return i; } } StructArrayLayout2ui4.prototype.bytesPerElement = 4; register('StructArrayLayout2ui4', StructArrayLayout2ui4); /** * @internal * Implementation of the StructArray layout: * [0] - Uint16[1] * */ class StructArrayLayout1ui2 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.uint16 = new Uint16Array(this.arrayBuffer); } emplaceBack(v0) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0); } emplace(i, v0) { const o2 = i * 1; this.uint16[o2 + 0] = v0; return i; } } StructArrayLayout1ui2.prototype.bytesPerElement = 2; register('StructArrayLayout1ui2', StructArrayLayout1ui2); /** * @internal * Implementation of the StructArray layout: * [0] - Float32[4] * */ class StructArrayLayout4f16 extends StructArray { _refreshViews() { this.uint8 = new Uint8Array(this.arrayBuffer); this.float32 = new Float32Array(this.arrayBuffer); } emplaceBack(v0, v1, v2, v3) { const i = this.length; this.resize(i + 1); return this.emplace(i, v0, v1, v2, v3); } emplace(i, v0, v1, v2, v3) { const o4 = i * 4; this.float32[o4 + 0] = v0; this.float32[o4 + 1] = v1; this.float32[o4 + 2] = v2; this.float32[o4 + 3] = v3; return i; } } StructArrayLayout4f16.prototype.bytesPerElement = 16; register('StructArrayLayout4f16', StructArrayLayout4f16); /** @internal */ class CollisionBoxStruct extends Struct { get anchorPointX() { return this._structArray.int16[this._pos2 + 0]; } get anchorPointY() { return this._structArray.int16[this._pos2 + 1]; } get x1() { return this._structArray.int16[this._pos2 + 2]; } get y1() { return this._structArray.int16[this._pos2 + 3]; } get x2() { return this._structArray.int16[this._pos2 + 4]; } get y2() { return this._structArray.int16[this._pos2 + 5]; } get featureIndex() { return this._structArray.uint32[this._pos4 + 3]; } get sourceLayerIndex() { return this._structArray.uint16[this._pos2 + 8]; } get bucketIndex() { return this._structArray.uint16[this._pos2 + 9]; } get anchorPoint() { return new Point$2(this.anchorPointX, this.anchorPointY); } } CollisionBoxStruct.prototype.size = 20; /** @internal */ class CollisionBoxArray extends StructArrayLayout6i1ul2ui20 { /** * Return the CollisionBoxStruct at the given location in the array. * @param index The index of the element. */ get(index) { return new CollisionBoxStruct(this, index); } } register('CollisionBoxArray', CollisionBoxArray); /** @internal */ class PlacedSymbolStruct extends Struct { get anchorX() { return this._structArray.int16[this._pos2 + 0]; } get anchorY() { return this._structArray.int16[this._pos2 + 1]; } get glyphStartIndex() { return this._structArray.uint16[this._pos2 + 2]; } get numGlyphs() { return this._structArray.uint16[this._pos2 + 3]; } get vertexStartIndex() { return this._structArray.uint32[this._pos4 + 2]; } get lineStartIndex() { return this._structArray.uint32[this._pos4 + 3]; } get lineLength() { return this._structArray.uint32[this._pos4 + 4]; } get segment() { return this._structArray.uint16[this._pos2 + 10]; } get lowerSize() { return this._structArray.uint16[this._pos2 + 11]; } get upperSize() { return this._structArray.uint16[this._pos2 + 12]; } get lineOffsetX() { return this._structArray.float32[this._pos4 + 7]; } get lineOffsetY() { return this._structArray.float32[this._pos4 + 8]; } get writingMode() { return this._structArray.uint8[this._pos1 + 36]; } get placedOrientation() { return this._structArray.uint8[this._pos1 + 37]; } set placedOrientation(x) { this._structArray.uint8[this._pos1 + 37] = x; } get hidden() { return this._structArray.uint8[this._pos1 + 38]; } set hidden(x) { this._structArray.uint8[this._pos1 + 38] = x; } get crossTileID() { return this._structArray.uint32[this._pos4 + 10]; } set crossTileID(x) { this._structArray.uint32[this._pos4 + 10] = x; } get associatedIconIndex() { return this._structArray.int16[this._pos2 + 22]; } } PlacedSymbolStruct.prototype.size = 48; /** @internal */ class PlacedSymbolArray extends StructArrayLayout2i2ui3ul3ui2f3ub1ul1i48 { /** * Return the PlacedSymbolStruct at the given location in the array. * @param index The index of the element. */ get(index) { return new PlacedSymbolStruct(this, index); } } register('PlacedSymbolArray', PlacedSymbolArray); /** @internal */ class SymbolInstanceStruct extends Struct { get anchorX() { return this._structArray.int16[this._pos2 + 0]; } get anchorY() { return this._structArray.int16[this._pos2 + 1]; } get rightJustifiedTextSymbolIndex() { return this._structArray.int16[this._pos2 + 2]; } get centerJustifiedTextSymbolIndex() { return this._structArray.int16[this._pos2 + 3]; } get leftJustifiedTextSymbolIndex() { return this._structArray.int16[this._pos2 + 4]; } get verticalPlacedTextSymbolIndex() { return this._structArray.int16[this._pos2 + 5]; } get placedIconSymbolIndex() { return this._structArray.int16[this._pos2 + 6]; } get verticalPlacedIconSymbolIndex() { return this._structArray.int16[this._pos2 + 7]; } get key() { return this._structArray.uint16[this._pos2 + 8]; } get textBoxStartIndex() { return this._structArray.uint16[this._pos2 + 9]; } get textBoxEndIndex() { return this._structArray.uint16[this._pos2 + 10]; } get verticalTextBoxStartIndex() { return this._structArray.uint16[this._pos2 + 11]; } get verticalTextBoxEndIndex() { return this._structArray.uint16[this._pos2 + 12]; } get iconBoxStartIndex() { return this._structArray.uint16[this._pos2 + 13]; } get iconBoxEndIndex() { return this._structArray.uint16[this._pos2 + 14]; } get verticalIconBoxStartIndex() { return this._structArray.uint16[this._pos2 + 15]; } get verticalIconBoxEndIndex() { return this._structArray.uint16[this._pos2 + 16]; } get featureIndex() { return this._structArray.uint16[this._pos2 + 17]; } get numHorizontalGlyphVertices() { return this._structArray.uint16[this._pos2 + 18]; } get numVerticalGlyphVertices() { return this._structArray.uint16[this._pos2 + 19]; } get numIconVertices() { return this._structArray.uint16[this._pos2 + 20]; } get numVerticalIconVertices() { return this._structArray.uint16[this._pos2 + 21]; } get useRuntimeCollisionCircles() { return this._structArray.uint16[this._pos2 + 22]; } get crossTileID() { return this._structArray.uint32[this._pos4 + 12]; } set crossTileID(x) { this._structArray.uint32[this._pos4 + 12] = x; } get textBoxScale() { return this._structArray.float32[this._pos4 + 13]; } get collisionCircleDiameter() { return this._structArray.float32[this._pos4 + 14]; } get textAnchorOffsetStartIndex() { return this._structArray.uint16[this._pos2 + 30]; } get textAnchorOffsetEndIndex() { return this._structArray.uint16[this._pos2 + 31]; } } SymbolInstanceStruct.prototype.size = 64; /** @internal */ class SymbolInstanceArray extends StructArrayLayout8i15ui1ul2f2ui64 { /** * Return the SymbolInstanceStruct at the given location in the array. * @param index The index of the element. */ get(index) { return new SymbolInstanceStruct(this, index); } } register('SymbolInstanceArray', SymbolInstanceArray); /** @internal */ class GlyphOffsetArray extends StructArrayLayout1f4 { getoffsetX(index) { return this.float32[index * 1 + 0]; } } register('GlyphOffsetArray', GlyphOffsetArray); /** @internal */ class SymbolLineVertexArray extends StructArrayLayout3i6 { getx(index) { return this.int16[index * 3 + 0]; } gety(index) { return this.int16[index * 3 + 1]; } gettileUnitDistanceFromAnchor(index) { return this.int16[index * 3 + 2]; } } register('SymbolLineVertexArray', SymbolLineVertexArray); /** @internal */ class TextAnchorOffsetStruct extends Struct { get textAnchor() { return this._structArray.uint16[this._pos2 + 0]; } get textOffset0() { return this._structArray.float32[this._pos4 + 1]; } get textOffset1() { return this._structArray.float32[this._pos4 + 2]; } } TextAnchorOffsetStruct.prototype.size = 12; /** @internal */ class TextAnchorOffsetArray extends StructArrayLayout1ui2f12 { /** * Return the TextAnchorOffsetStruct at the given location in the array. * @param index The index of the element. */ get(index) { return new TextAnchorOffsetStruct(this, index); } } register('TextAnchorOffsetArray', TextAnchorOffsetArray); /** @internal */ class FeatureIndexStruct extends Struct { get featureIndex() { return this._structArray.uint32[this._pos4 + 0]; } get sourceLayerIndex() { return this._structArray.uint16[this._pos2 + 2]; } get bucketIndex() { return this._structArray.uint16[this._pos2 + 3]; } } FeatureIndexStruct.prototype.size = 8; /** @internal */ class FeatureIndexArray extends StructArrayLayout1ul2ui8 { /** * Return the FeatureIndexStruct at the given location in the array. * @param index The index of the element. */ get(index) { return new FeatureIndexStruct(this, index); } } register('FeatureIndexArray', FeatureIndexArray); class PosArray extends StructArrayLayout2i4 { } class Pos3dArray extends StructArrayLayout3i6 { } class RasterBoundsArray extends StructArrayLayout4i8 { } class CircleLayoutArray extends StructArrayLayout2i4 { } class FillLayoutArray extends StructArrayLayout2i4 { } class FillExtrusionLayoutArray extends StructArrayLayout2i4i12 { } class HeatmapLayoutArray extends StructArrayLayout2i4 { } class LineLayoutArray extends StructArrayLayout2i4ub8 { } class LineExtLayoutArray extends StructArrayLayout2f8 { } class PatternLayoutArray extends StructArrayLayout10ui20 { } class SymbolLayoutArray extends StructArrayLayout4i4ui4i24 { } class SymbolDynamicLayoutArray extends StructArrayLayout3f12 { } class SymbolOpacityArray extends StructArrayLayout1ul4 { } class CollisionBoxLayoutArray extends StructArrayLayout2i2i2i12 { } class CollisionCircleLayoutArray extends StructArrayLayout2f1f2i16 { } class CollisionVertexArray extends StructArrayLayout2ub2f2i16 { } class QuadTriangleArray extends StructArrayLayout3ui6 { } class TriangleIndexArray extends StructArrayLayout3ui6 { } class LineIndexArray extends StructArrayLayout2ui4 { } class LineStripIndexArray extends StructArrayLayout1ui2 { } const layout$6 = createLayout([ { name: 'a_pos', components: 2, type: 'Int16' } ], 4); const { members: members$4, size: size$4, alignment: alignment$4 } = layout$6; /** * @internal * Used for calculations on vector segments */ class SegmentVector { constructor(segments = []) { this.segments = segments; } prepareSegment(numVertices, layoutVertexArray, indexArray, sortKey) { let segment = this.segments[this.segments.length - 1]; if (numVertices > SegmentVector.MAX_VERTEX_ARRAY_LENGTH) warnOnce(`Max vertices per segment is ${SegmentVector.MAX_VERTEX_ARRAY_LENGTH}: bucket requested ${numVertices}`); if (!segment || segment.vertexLength + numVertices > SegmentVector.MAX_VERTEX_ARRAY_LENGTH || segment.sortKey !== sortKey) { segment = { vertexOffset: layoutVertexArray.length, primitiveOffset: indexArray.length, vertexLength: 0, primitiveLength: 0 }; if (sortKey !== undefined) segment.sortKey = sortKey; this.segments.push(segment); } return segment; } get() { return this.segments; } destroy() { for (const segment of this.segments) { for (const k in segment.vaos) { segment.vaos[k].destroy(); } } } static simpleSegment(vertexOffset, primitiveOffset, vertexLength, primitiveLength) { return new SegmentVector([{ vertexOffset, primitiveOffset, vertexLength, primitiveLength, vaos: {}, sortKey: 0 }]); } } /** * The maximum size of a vertex array. This limit is imposed by WebGL's 16 bit * addressing of vertex buffers. */ SegmentVector.MAX_VERTEX_ARRAY_LENGTH = Math.pow(2, 16) - 1; register('SegmentVector', SegmentVector); /** * Packs two numbers, interpreted as 8-bit unsigned integers, into a single * float. Unpack them in the shader using the `unpack_float()` function, * defined in _prelude.vertex.glsl */ function packUint8ToFloat(a, b) { // coerce a and b to 8-bit ints a = clamp$1(Math.floor(a), 0, 255); b = clamp$1(Math.floor(b), 0, 255); return 256 * a + b; } const patternAttributes = createLayout([ // [tl.x, tl.y, br.x, br.y] { name: 'a_pattern_from', components: 4, type: 'Uint16' }, { name: 'a_pattern_to', components: 4, type: 'Uint16' }, { name: 'a_pixel_ratio_from', components: 1, type: 'Uint16' }, { name: 'a_pixel_ratio_to', components: 1, type: 'Uint16' }, ]); var murmurhashJs$1 = {exports: {}}; var murmurhash3_gc$2 = {exports: {}}; /** * JS Implementation of MurmurHash3 (r136) (as of May 20, 2011) * * @author Gary Court * @see http://github.com/garycourt/murmurhash-js * @author Austin Appleby * @see http://sites.google.com/site/murmurhash/ * * @param {string} key ASCII only * @param {number} seed Positive integer only * @return {number} 32-bit positive integer hash */ var murmurhash3_gc = murmurhash3_gc$2.exports; (function (module) { function murmurhash3_32_gc(key, seed) { var remainder, bytes, h1, h1b, c1, c1b, c2, c2b, k1, i; remainder = key.length & 3; // key.length % 4 bytes = key.length - remainder; h1 = seed; c1 = 0xcc9e2d51; c2 = 0x1b873593; i = 0; while (i < bytes) { k1 = ((key.charCodeAt(i) & 0xff)) | ((key.charCodeAt(++i) & 0xff) << 8) | ((key.charCodeAt(++i) & 0xff) << 16) | ((key.charCodeAt(++i) & 0xff) << 24); ++i; k1 = ((((k1 & 0xffff) * c1) + ((((k1 >>> 16) * c1) & 0xffff) << 16))) & 0xffffffff; k1 = (k1 << 15) | (k1 >>> 17); k1 = ((((k1 & 0xffff) * c2) + ((((k1 >>> 16) * c2) & 0xffff) << 16))) & 0xffffffff; h1 ^= k1; h1 = (h1 << 13) | (h1 >>> 19); h1b = ((((h1 & 0xffff) * 5) + ((((h1 >>> 16) * 5) & 0xffff) << 16))) & 0xffffffff; h1 = (((h1b & 0xffff) + 0x6b64) + ((((h1b >>> 16) + 0xe654) & 0xffff) << 16)); } k1 = 0; switch (remainder) { case 3: k1 ^= (key.charCodeAt(i + 2) & 0xff) << 16; case 2: k1 ^= (key.charCodeAt(i + 1) & 0xff) << 8; case 1: k1 ^= (key.charCodeAt(i) & 0xff); k1 = (((k1 & 0xffff) * c1) + ((((k1 >>> 16) * c1) & 0xffff) << 16)) & 0xffffffff; k1 = (k1 << 15) | (k1 >>> 17); k1 = (((k1 & 0xffff) * c2) + ((((k1 >>> 16) * c2) & 0xffff) << 16)) & 0xffffffff; h1 ^= k1; } h1 ^= key.length; h1 ^= h1 >>> 16; h1 = (((h1 & 0xffff) * 0x85ebca6b) + ((((h1 >>> 16) * 0x85ebca6b) & 0xffff) << 16)) & 0xffffffff; h1 ^= h1 >>> 13; h1 = ((((h1 & 0xffff) * 0xc2b2ae35) + ((((h1 >>> 16) * 0xc2b2ae35) & 0xffff) << 16))) & 0xffffffff; h1 ^= h1 >>> 16; return h1 >>> 0; } if('object' !== "undefined") { module.exports = murmurhash3_32_gc; } } (murmurhash3_gc$2)); var murmurhash3_gcExports = murmurhash3_gc$2.exports; var murmurhash3_gc$1 = /*@__PURE__*/getDefaultExportFromCjs$1(murmurhash3_gcExports); var murmurhash2_gc$2 = {exports: {}}; /** * JS Implementation of MurmurHash2 * * @author Gary Court * @see http://github.com/garycourt/murmurhash-js * @author Austin Appleby * @see http://sites.google.com/site/murmurhash/ * * @param {string} str ASCII only * @param {number} seed Positive integer only * @return {number} 32-bit positive integer hash */ var murmurhash2_gc = murmurhash2_gc$2.exports; (function (module) { function murmurhash2_32_gc(str, seed) { var l = str.length, h = seed ^ l, i = 0, k; while (l >= 4) { k = ((str.charCodeAt(i) & 0xff)) | ((str.charCodeAt(++i) & 0xff) << 8) | ((str.charCodeAt(++i) & 0xff) << 16) | ((str.charCodeAt(++i) & 0xff) << 24); k = (((k & 0xffff) * 0x5bd1e995) + ((((k >>> 16) * 0x5bd1e995) & 0xffff) << 16)); k ^= k >>> 24; k = (((k & 0xffff) * 0x5bd1e995) + ((((k >>> 16) * 0x5bd1e995) & 0xffff) << 16)); h = (((h & 0xffff) * 0x5bd1e995) + ((((h >>> 16) * 0x5bd1e995) & 0xffff) << 16)) ^ k; l -= 4; ++i; } switch (l) { case 3: h ^= (str.charCodeAt(i + 2) & 0xff) << 16; case 2: h ^= (str.charCodeAt(i + 1) & 0xff) << 8; case 1: h ^= (str.charCodeAt(i) & 0xff); h = (((h & 0xffff) * 0x5bd1e995) + ((((h >>> 16) * 0x5bd1e995) & 0xffff) << 16)); } h ^= h >>> 13; h = (((h & 0xffff) * 0x5bd1e995) + ((((h >>> 16) * 0x5bd1e995) & 0xffff) << 16)); h ^= h >>> 15; return h >>> 0; } if('object' !== undefined) { module.exports = murmurhash2_32_gc; } } (murmurhash2_gc$2)); var murmurhash2_gcExports = murmurhash2_gc$2.exports; var murmurhash2_gc$1 = /*@__PURE__*/getDefaultExportFromCjs$1(murmurhash2_gcExports); var murmurhashJs = murmurhashJs$1.exports; var murmur3 = murmurhash3_gcExports; var murmur2 = murmurhash2_gcExports; murmurhashJs$1.exports = murmur3; var murmur3_1 = murmurhashJs$1.exports.murmur3 = murmur3; var murmur2_1 = murmurhashJs$1.exports.murmur2 = murmur2; var murmurhashJsExports = murmurhashJs$1.exports; var murmur3$1 = /*@__PURE__*/getDefaultExportFromCjs$1(murmurhashJsExports); // A transferable data structure that maps feature ids to their indices and buffer offsets class FeaturePositionMap { constructor() { this.ids = []; this.positions = []; this.indexed = false; } add(id, index, start, end) { this.ids.push(getNumericId(id)); this.positions.push(index, start, end); } getPositions(id) { if (!this.indexed) throw new Error('Trying to get index, but feature positions are not indexed'); const intId = getNumericId(id); // binary search for the first occurrence of id in this.ids; // relies on ids/positions being sorted by id, which happens in serialization let i = 0; let j = this.ids.length - 1; while (i < j) { const m = (i + j) >> 1; if (this.ids[m] >= intId) { j = m; } else { i = m + 1; } } const positions = []; while (this.ids[i] === intId) { const index = this.positions[3 * i]; const start = this.positions[3 * i + 1]; const end = this.positions[3 * i + 2]; positions.push({ index, start, end }); i++; } return positions; } static serialize(map, transferables) { const ids = new Float64Array(map.ids); const positions = new Uint32Array(map.positions); sort$1(ids, positions, 0, ids.length - 1); if (transferables) { transferables.push(ids.buffer, positions.buffer); } return { ids, positions }; } static deserialize(obj) { const map = new FeaturePositionMap(); // after transferring, we only use these arrays statically (no pushes), // so TypedArray vs Array distinction that flow points out doesn't matter map.ids = obj.ids; map.positions = obj.positions; map.indexed = true; return map; } } function getNumericId(value) { const numValue = +value; if (!isNaN(numValue) && numValue <= Number.MAX_SAFE_INTEGER) { return numValue; } return murmur3$1(String(value)); } // custom quicksort that sorts ids, indices and offsets together (by ids) // uses Hoare partitioning & manual tail call optimization to avoid worst case scenarios function sort$1(ids, positions, left, right) { while (left < right) { const pivot = ids[(left + right) >> 1]; let i = left - 1; let j = right + 1; while (true) { do i++; while (ids[i] < pivot); do j--; while (ids[j] > pivot); if (i >= j) break; swap$1(ids, i, j); swap$1(positions, 3 * i, 3 * j); swap$1(positions, 3 * i + 1, 3 * j + 1); swap$1(positions, 3 * i + 2, 3 * j + 2); } if (j - left < right - j) { sort$1(ids, positions, left, j); left = j + 1; } else { sort$1(ids, positions, j + 1, right); right = j; } } } function swap$1(arr, i, j) { const tmp = arr[i]; arr[i] = arr[j]; arr[j] = tmp; } register('FeaturePositionMap', FeaturePositionMap); /** * @internal * A base uniform abstract class */ class Uniform { constructor(context, location) { this.gl = context.gl; this.location = location; } } class Uniform1i extends Uniform { constructor(context, location) { super(context, location); this.current = 0; } set(v) { if (this.current !== v) { this.current = v; this.gl.uniform1i(this.location, v); } } } class Uniform1f extends Uniform { constructor(context, location) { super(context, location); this.current = 0; } set(v) { if (this.current !== v) { this.current = v; this.gl.uniform1f(this.location, v); } } } class Uniform2f extends Uniform { constructor(context, location) { super(context, location); this.current = [0, 0]; } set(v) { if (v[0] !== this.current[0] || v[1] !== this.current[1]) { this.current = v; this.gl.uniform2f(this.location, v[0], v[1]); } } } class Uniform3f extends Uniform { constructor(context, location) { super(context, location); this.current = [0, 0, 0]; } set(v) { if (v[0] !== this.current[0] || v[1] !== this.current[1] || v[2] !== this.current[2]) { this.current = v; this.gl.uniform3f(this.location, v[0], v[1], v[2]); } } } class Uniform4f extends Uniform { constructor(context, location) { super(context, location); this.current = [0, 0, 0, 0]; } set(v) { if (v[0] !== this.current[0] || v[1] !== this.current[1] || v[2] !== this.current[2] || v[3] !== this.current[3]) { this.current = v; this.gl.uniform4f(this.location, v[0], v[1], v[2], v[3]); } } } class UniformColor extends Uniform { constructor(context, location) { super(context, location); this.current = Color.transparent; } set(v) { if (v.r !== this.current.r || v.g !== this.current.g || v.b !== this.current.b || v.a !== this.current.a) { this.current = v; this.gl.uniform4f(this.location, v.r, v.g, v.b, v.a); } } } const emptyMat4 = new Float32Array(16); class UniformMatrix4f extends Uniform { constructor(context, location) { super(context, location); this.current = emptyMat4; } set(v) { // The vast majority of matrix comparisons that will trip this set // happen at i=12 or i=0, so we check those first to avoid lots of // unnecessary iteration: if (v[12] !== this.current[12] || v[0] !== this.current[0]) { this.current = v; this.gl.uniformMatrix4fv(this.location, false, v); return; } for (let i = 1; i < 16; i++) { if (v[i] !== this.current[i]) { this.current = v; this.gl.uniformMatrix4fv(this.location, false, v); break; } } } } function packColor(color) { return [ packUint8ToFloat(255 * color.r, 255 * color.g), packUint8ToFloat(255 * color.b, 255 * color.a) ]; } class ConstantBinder { constructor(value, names, type) { this.value = value; this.uniformNames = names.map(name => `u_${name}`); this.type = type; } setUniform(uniform, globals, currentValue) { uniform.set(currentValue.constantOr(this.value)); } getBinding(context, location, _) { return (this.type === 'color') ? new UniformColor(context, location) : new Uniform1f(context, location); } } class CrossFadedConstantBinder { constructor(value, names) { this.uniformNames = names.map(name => `u_${name}`); this.patternFrom = null; this.patternTo = null; this.pixelRatioFrom = 1.0; this.pixelRatioTo = 1.0; } setConstantPatternPositions(posTo, posFrom) { this.pixelRatioFrom = posFrom.pixelRatio; this.pixelRatioTo = posTo.pixelRatio; this.patternFrom = posFrom.tlbr; this.patternTo = posTo.tlbr; } setUniform(uniform, globals, currentValue, uniformName) { const pos = uniformName === 'u_pattern_to' ? this.patternTo : uniformName === 'u_pattern_from' ? this.patternFrom : uniformName === 'u_pixel_ratio_to' ? this.pixelRatioTo : uniformName === 'u_pixel_ratio_from' ? this.pixelRatioFrom : null; if (pos) uniform.set(pos); } getBinding(context, location, name) { return name.substr(0, 9) === 'u_pattern' ? new Uniform4f(context, location) : new Uniform1f(context, location); } } class SourceExpressionBinder { constructor(expression, names, type, PaintVertexArray) { this.expression = expression; this.type = type; this.maxValue = 0; this.paintVertexAttributes = names.map((name) => ({ name: `a_${name}`, type: 'Float32', components: type === 'color' ? 2 : 1, offset: 0 })); this.paintVertexArray = new PaintVertexArray(); } populatePaintArray(newLength, feature, imagePositions, canonical, formattedSection) { const start = this.paintVertexArray.length; const value = this.expression.evaluate(new EvaluationParameters(0), feature, {}, canonical, [], formattedSection); this.paintVertexArray.resize(newLength); this._setPaintValue(start, newLength, value); } updatePaintArray(start, end, feature, featureState) { const value = this.expression.evaluate({ zoom: 0 }, feature, featureState); this._setPaintValue(start, end, value); } _setPaintValue(start, end, value) { if (this.type === 'color') { const color = packColor(value); for (let i = start; i < end; i++) { this.paintVertexArray.emplace(i, color[0], color[1]); } } else { for (let i = start; i < end; i++) { this.paintVertexArray.emplace(i, value); } this.maxValue = Math.max(this.maxValue, Math.abs(value)); } } upload(context) { if (this.paintVertexArray && this.paintVertexArray.arrayBuffer) { if (this.paintVertexBuffer && this.paintVertexBuffer.buffer) { this.paintVertexBuffer.updateData(this.paintVertexArray); } else { this.paintVertexBuffer = context.createVertexBuffer(this.paintVertexArray, this.paintVertexAttributes, this.expression.isStateDependent); } } } destroy() { if (this.paintVertexBuffer) { this.paintVertexBuffer.destroy(); } } } class CompositeExpressionBinder { constructor(expression, names, type, useIntegerZoom, zoom, PaintVertexArray) { this.expression = expression; this.uniformNames = names.map(name => `u_${name}_t`); this.type = type; this.useIntegerZoom = useIntegerZoom; this.zoom = zoom; this.maxValue = 0; this.paintVertexAttributes = names.map((name) => ({ name: `a_${name}`, type: 'Float32', components: type === 'color' ? 4 : 2, offset: 0 })); this.paintVertexArray = new PaintVertexArray(); } populatePaintArray(newLength, feature, imagePositions, canonical, formattedSection) { const min = this.expression.evaluate(new EvaluationParameters(this.zoom), feature, {}, canonical, [], formattedSection); const max = this.expression.evaluate(new EvaluationParameters(this.zoom + 1), feature, {}, canonical, [], formattedSection); const start = this.paintVertexArray.length; this.paintVertexArray.resize(newLength); this._setPaintValue(start, newLength, min, max); } updatePaintArray(start, end, feature, featureState) { const min = this.expression.evaluate({ zoom: this.zoom }, feature, featureState); const max = this.expression.evaluate({ zoom: this.zoom + 1 }, feature, featureState); this._setPaintValue(start, end, min, max); } _setPaintValue(start, end, min, max) { if (this.type === 'color') { const minColor = packColor(min); const maxColor = packColor(max); for (let i = start; i < end; i++) { this.paintVertexArray.emplace(i, minColor[0], minColor[1], maxColor[0], maxColor[1]); } } else { for (let i = start; i < end; i++) { this.paintVertexArray.emplace(i, min, max); } this.maxValue = Math.max(this.maxValue, Math.abs(min), Math.abs(max)); } } upload(context) { if (this.paintVertexArray && this.paintVertexArray.arrayBuffer) { if (this.paintVertexBuffer && this.paintVertexBuffer.buffer) { this.paintVertexBuffer.updateData(this.paintVertexArray); } else { this.paintVertexBuffer = context.createVertexBuffer(this.paintVertexArray, this.paintVertexAttributes, this.expression.isStateDependent); } } } destroy() { if (this.paintVertexBuffer) { this.paintVertexBuffer.destroy(); } } setUniform(uniform, globals) { const currentZoom = this.useIntegerZoom ? Math.floor(globals.zoom) : globals.zoom; const factor = clamp$1(this.expression.interpolationFactor(currentZoom, this.zoom, this.zoom + 1), 0, 1); uniform.set(factor); } getBinding(context, location, _) { return new Uniform1f(context, location); } } class CrossFadedCompositeBinder { constructor(expression, type, useIntegerZoom, zoom, PaintVertexArray, layerId) { this.expression = expression; this.type = type; this.useIntegerZoom = useIntegerZoom; this.zoom = zoom; this.layerId = layerId; this.zoomInPaintVertexArray = new PaintVertexArray(); this.zoomOutPaintVertexArray = new PaintVertexArray(); } populatePaintArray(length, feature, imagePositions) { const start = this.zoomInPaintVertexArray.length; this.zoomInPaintVertexArray.resize(length); this.zoomOutPaintVertexArray.resize(length); this._setPaintValues(start, length, feature.patterns && feature.patterns[this.layerId], imagePositions); } updatePaintArray(start, end, feature, featureState, imagePositions) { this._setPaintValues(start, end, feature.patterns && feature.patterns[this.layerId], imagePositions); } _setPaintValues(start, end, patterns, positions) { if (!positions || !patterns) return; const { min, mid, max } = patterns; const imageMin = positions[min]; const imageMid = positions[mid]; const imageMax = positions[max]; if (!imageMin || !imageMid || !imageMax) return; // We populate two paint arrays because, for cross-faded properties, we don't know which direction // we're cross-fading to at layout time. In order to keep vertex attributes to a minimum and not pass // unnecessary vertex data to the shaders, we determine which to upload at draw time. for (let i = start; i < end; i++) { this.zoomInPaintVertexArray.emplace(i, imageMid.tl[0], imageMid.tl[1], imageMid.br[0], imageMid.br[1], imageMin.tl[0], imageMin.tl[1], imageMin.br[0], imageMin.br[1], imageMid.pixelRatio, imageMin.pixelRatio); this.zoomOutPaintVertexArray.emplace(i, imageMid.tl[0], imageMid.tl[1], imageMid.br[0], imageMid.br[1], imageMax.tl[0], imageMax.tl[1], imageMax.br[0], imageMax.br[1], imageMid.pixelRatio, imageMax.pixelRatio); } } upload(context) { if (this.zoomInPaintVertexArray && this.zoomInPaintVertexArray.arrayBuffer && this.zoomOutPaintVertexArray && this.zoomOutPaintVertexArray.arrayBuffer) { this.zoomInPaintVertexBuffer = context.createVertexBuffer(this.zoomInPaintVertexArray, patternAttributes.members, this.expression.isStateDependent); this.zoomOutPaintVertexBuffer = context.createVertexBuffer(this.zoomOutPaintVertexArray, patternAttributes.members, this.expression.isStateDependent); } } destroy() { if (this.zoomOutPaintVertexBuffer) this.zoomOutPaintVertexBuffer.destroy(); if (this.zoomInPaintVertexBuffer) this.zoomInPaintVertexBuffer.destroy(); } } /** * @internal * ProgramConfiguration contains the logic for binding style layer properties and tile * layer feature data into GL program uniforms and vertex attributes. * * Non-data-driven property values are bound to shader uniforms. Data-driven property * values are bound to vertex attributes. In order to support a uniform GLSL syntax over * both, [Mapbox GL Shaders](https://github.com/mapbox/mapbox-gl-shaders) defines a `#pragma` * abstraction, which ProgramConfiguration is responsible for implementing. At runtime, * it examines the attributes of a particular layer, combines this with fixed knowledge * about how layers of the particular type are implemented, and determines which uniforms * and vertex attributes will be required. It can then substitute the appropriate text * into the shader source code, create and link a program, and bind the uniforms and * vertex attributes in preparation for drawing. * * When a vector tile is parsed, this same configuration information is used to * populate the attribute buffers needed for data-driven styling using the zoom * level and feature property data. */ class ProgramConfiguration { constructor(layer, zoom, filterProperties) { this.binders = {}; this._buffers = []; const keys = []; for (const property in layer.paint._values) { if (!filterProperties(property)) continue; const value = layer.paint.get(property); if (!(value instanceof PossiblyEvaluatedPropertyValue) || !supportsPropertyExpression(value.property.specification)) { continue; } const names = paintAttributeNames(property, layer.type); const expression = value.value; const type = value.property.specification.type; const useIntegerZoom = value.property.useIntegerZoom; const propType = value.property.specification['property-type']; const isCrossFaded = propType === 'cross-faded' || propType === 'cross-faded-data-driven'; if (expression.kind === 'constant') { this.binders[property] = isCrossFaded ? new CrossFadedConstantBinder(expression.value, names) : new ConstantBinder(expression.value, names, type); keys.push(`/u_${property}`); } else if (expression.kind === 'source' || isCrossFaded) { const StructArrayLayout = layoutType(property, type, 'source'); this.binders[property] = isCrossFaded ? new CrossFadedCompositeBinder(expression, type, useIntegerZoom, zoom, StructArrayLayout, layer.id) : new SourceExpressionBinder(expression, names, type, StructArrayLayout); keys.push(`/a_${property}`); } else { const StructArrayLayout = layoutType(property, type, 'composite'); this.binders[property] = new CompositeExpressionBinder(expression, names, type, useIntegerZoom, zoom, StructArrayLayout); keys.push(`/z_${property}`); } } this.cacheKey = keys.sort().join(''); } getMaxValue(property) { const binder = this.binders[property]; return binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder ? binder.maxValue : 0; } populatePaintArrays(newLength, feature, imagePositions, canonical, formattedSection) { for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder || binder instanceof CrossFadedCompositeBinder) binder.populatePaintArray(newLength, feature, imagePositions, canonical, formattedSection); } } setConstantPatternPositions(posTo, posFrom) { for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof CrossFadedConstantBinder) binder.setConstantPatternPositions(posTo, posFrom); } } updatePaintArrays(featureStates, featureMap, vtLayer, layer, imagePositions) { let dirty = false; for (const id in featureStates) { const positions = featureMap.getPositions(id); for (const pos of positions) { const feature = vtLayer.feature(pos.index); for (const property in this.binders) { const binder = this.binders[property]; if ((binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder || binder instanceof CrossFadedCompositeBinder) && binder.expression.isStateDependent === true) { //AHM: Remove after https://github.com/mapbox/mapbox-gl-js/issues/6255 const value = layer.paint.get(property); binder.expression = value.value; binder.updatePaintArray(pos.start, pos.end, feature, featureStates[id], imagePositions); dirty = true; } } } } return dirty; } defines() { const result = []; for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof ConstantBinder || binder instanceof CrossFadedConstantBinder) { result.push(...binder.uniformNames.map(name => `#define HAS_UNIFORM_${name}`)); } } return result; } getBinderAttributes() { const result = []; for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder) { for (let i = 0; i < binder.paintVertexAttributes.length; i++) { result.push(binder.paintVertexAttributes[i].name); } } else if (binder instanceof CrossFadedCompositeBinder) { for (let i = 0; i < patternAttributes.members.length; i++) { result.push(patternAttributes.members[i].name); } } } return result; } getBinderUniforms() { const uniforms = []; for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof ConstantBinder || binder instanceof CrossFadedConstantBinder || binder instanceof CompositeExpressionBinder) { for (const uniformName of binder.uniformNames) { uniforms.push(uniformName); } } } return uniforms; } getPaintVertexBuffers() { return this._buffers; } getUniforms(context, locations) { const uniforms = []; for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof ConstantBinder || binder instanceof CrossFadedConstantBinder || binder instanceof CompositeExpressionBinder) { for (const name of binder.uniformNames) { if (locations[name]) { const binding = binder.getBinding(context, locations[name], name); uniforms.push({ name, property, binding }); } } } } return uniforms; } setUniforms(context, binderUniforms, properties, globals) { // Uniform state bindings are owned by the Program, but we set them // from within the ProgramConfiguration's binder members. for (const { name, property, binding } of binderUniforms) { this.binders[property].setUniform(binding, globals, properties.get(property), name); } } updatePaintBuffers(crossfade) { this._buffers = []; for (const property in this.binders) { const binder = this.binders[property]; if (crossfade && binder instanceof CrossFadedCompositeBinder) { const patternVertexBuffer = crossfade.fromScale === 2 ? binder.zoomInPaintVertexBuffer : binder.zoomOutPaintVertexBuffer; if (patternVertexBuffer) this._buffers.push(patternVertexBuffer); } else if ((binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder) && binder.paintVertexBuffer) { this._buffers.push(binder.paintVertexBuffer); } } } upload(context) { for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder || binder instanceof CrossFadedCompositeBinder) binder.upload(context); } this.updatePaintBuffers(); } destroy() { for (const property in this.binders) { const binder = this.binders[property]; if (binder instanceof SourceExpressionBinder || binder instanceof CompositeExpressionBinder || binder instanceof CrossFadedCompositeBinder) binder.destroy(); } } } class ProgramConfigurationSet { constructor(layers, zoom, filterProperties = () => true) { this.programConfigurations = {}; for (const layer of layers) { this.programConfigurations[layer.id] = new ProgramConfiguration(layer, zoom, filterProperties); } this.needsUpload = false; this._featureMap = new FeaturePositionMap(); this._bufferOffset = 0; } populatePaintArrays(length, feature, index, imagePositions, canonical, formattedSection) { for (const key in this.programConfigurations) { this.programConfigurations[key].populatePaintArrays(length, feature, imagePositions, canonical, formattedSection); } if (feature.id !== undefined) { this._featureMap.add(feature.id, index, this._bufferOffset, length); } this._bufferOffset = length; this.needsUpload = true; } updatePaintArrays(featureStates, vtLayer, layers, imagePositions) { for (const layer of layers) { this.needsUpload = this.programConfigurations[layer.id].updatePaintArrays(featureStates, this._featureMap, vtLayer, layer, imagePositions) || this.needsUpload; } } get(layerId) { return this.programConfigurations[layerId]; } upload(context) { if (!this.needsUpload) return; for (const layerId in this.programConfigurations) { this.programConfigurations[layerId].upload(context); } this.needsUpload = false; } destroy() { for (const layerId in this.programConfigurations) { this.programConfigurations[layerId].destroy(); } } } function paintAttributeNames(property, type) { const attributeNameExceptions = { 'text-opacity': ['opacity'], 'icon-opacity': ['opacity'], 'text-color': ['fill_color'], 'icon-color': ['fill_color'], 'text-halo-color': ['halo_color'], 'icon-halo-color': ['halo_color'], 'text-halo-blur': ['halo_blur'], 'icon-halo-blur': ['halo_blur'], 'text-halo-width': ['halo_width'], 'icon-halo-width': ['halo_width'], 'line-gap-width': ['gapwidth'], 'line-pattern': ['pattern_to', 'pattern_from', 'pixel_ratio_to', 'pixel_ratio_from'], 'fill-pattern': ['pattern_to', 'pattern_from', 'pixel_ratio_to', 'pixel_ratio_from'], 'fill-extrusion-pattern': ['pattern_to', 'pattern_from', 'pixel_ratio_to', 'pixel_ratio_from'], }; return attributeNameExceptions[property] || [property.replace(`${type}-`, '').replace(/-/g, '_')]; } function getLayoutException(property) { const propertyExceptions = { 'line-pattern': { 'source': PatternLayoutArray, 'composite': PatternLayoutArray }, 'fill-pattern': { 'source': PatternLayoutArray, 'composite': PatternLayoutArray }, 'fill-extrusion-pattern': { 'source': PatternLayoutArray, 'composite': PatternLayoutArray } }; return propertyExceptions[property]; } function layoutType(property, type, binderType) { const defaultLayouts = { 'color': { 'source': StructArrayLayout2f8, 'composite': StructArrayLayout4f16 }, 'number': { 'source': StructArrayLayout1f4, 'composite': StructArrayLayout2f8 } }; const layoutException = getLayoutException(property); return layoutException && layoutException[binderType] || defaultLayouts[type][binderType]; } register('ConstantBinder', ConstantBinder); register('CrossFadedConstantBinder', CrossFadedConstantBinder); register('SourceExpressionBinder', SourceExpressionBinder); register('CrossFadedCompositeBinder', CrossFadedCompositeBinder); register('CompositeExpressionBinder', CompositeExpressionBinder); register('ProgramConfiguration', ProgramConfiguration, { omit: ['_buffers'] }); register('ProgramConfigurationSet', ProgramConfigurationSet); /** * The maximum value of a coordinate in the internal tile coordinate system. Coordinates of * all source features normalized to this extent upon load. * * The value is a consequence of the following: * * * Vertex buffer store positions as signed 16 bit integers. * * One bit is lost for signedness to support tile buffers. * * One bit is lost because the line vertex buffer used to pack 1 bit of other data into the int. * * One bit is lost to support features extending past the extent on the right edge of the tile. * * This leaves us with 2^13 = 8192 */ const EXTENT = 8192; // These bounds define the minimum and maximum supported coordinate values. // While visible coordinates are within [0, EXTENT], tiles may theoretically // contain coordinates within [-Infinity, Infinity]. Our range is limited by the // number of bits used to represent the coordinate. const BITS = 15; const MAX = Math.pow(2, BITS - 1) - 1; const MIN = -MAX - 1; /** * Loads a geometry from a VectorTileFeature and scales it to the common extent * used internally. * @param feature - the vector tile feature to load */ function loadGeometry(feature) { const scale = EXTENT / feature.extent; const geometry = feature.loadGeometry(); for (let r = 0; r < geometry.length; r++) { const ring = geometry[r]; for (let p = 0; p < ring.length; p++) { const point = ring[p]; // round here because mapbox-gl-native uses integers to represent // points and we need to do the same to avoid renering differences. const x = Math.round(point.x * scale); const y = Math.round(point.y * scale); point.x = clamp$1(x, MIN, MAX); point.y = clamp$1(y, MIN, MAX); if (x < point.x || x > point.x + 1 || y < point.y || y > point.y + 1) { // warn when exceeding allowed extent except for the 1-px-off case // https://github.com/mapbox/mapbox-gl-js/issues/8992 warnOnce('Geometry exceeds allowed extent, reduce your vector tile buffer size'); } } } return geometry; } /** * Construct a new feature based on a VectorTileFeature for expression evaluation, the geometry of which * will be loaded based on necessity. * @param feature - the feature to evaluate * @param needGeometry - if set to true this will load the geometry */ function toEvaluationFeature(feature, needGeometry) { return { type: feature.type, id: feature.id, properties: feature.properties, geometry: needGeometry ? loadGeometry(feature) : [] }; } function addCircleVertex(layoutVertexArray, x, y, extrudeX, extrudeY) { layoutVertexArray.emplaceBack((x * 2) + ((extrudeX + 1) / 2), (y * 2) + ((extrudeY + 1) / 2)); } /** * @internal * Circles are represented by two triangles. * * Each corner has a pos that is the center of the circle and an extrusion * vector that is where it points. */ class CircleBucket { constructor(options) { this.zoom = options.zoom; this.overscaling = options.overscaling; this.layers = options.layers; this.layerIds = this.layers.map(layer => layer.id); this.index = options.index; this.hasPattern = false; this.layoutVertexArray = new CircleLayoutArray(); this.indexArray = new TriangleIndexArray(); this.segments = new SegmentVector(); this.programConfigurations = new ProgramConfigurationSet(options.layers, options.zoom); this.stateDependentLayerIds = this.layers.filter((l) => l.isStateDependent()).map((l) => l.id); } populate(features, options, canonical) { const styleLayer = this.layers[0]; const bucketFeatures = []; let circleSortKey = null; let sortFeaturesByKey = false; // Heatmap layers are handled in this bucket and have no evaluated properties, so we check our access if (styleLayer.type === 'circle') { circleSortKey = styleLayer.layout.get('circle-sort-key'); sortFeaturesByKey = !circleSortKey.isConstant(); } for (const { feature, id, index, sourceLayerIndex } of features) { const needGeometry = this.layers[0]._featureFilter.needGeometry; const evaluationFeature = toEvaluationFeature(feature, needGeometry); if (!this.layers[0]._featureFilter.filter(new EvaluationParameters(this.zoom), evaluationFeature, canonical)) continue; const sortKey = sortFeaturesByKey ? circleSortKey.evaluate(evaluationFeature, {}, canonical) : undefined; const bucketFeature = { id, properties: feature.properties, type: feature.type, sourceLayerIndex, index, geometry: needGeometry ? evaluationFeature.geometry : loadGeometry(feature), patterns: {}, sortKey }; bucketFeatures.push(bucketFeature); } if (sortFeaturesByKey) { bucketFeatures.sort((a, b) => a.sortKey - b.sortKey); } for (const bucketFeature of bucketFeatures) { const { geometry, index, sourceLayerIndex } = bucketFeature; const feature = features[index].feature; this.addFeature(bucketFeature, geometry, index, canonical); options.featureIndex.insert(feature, geometry, index, sourceLayerIndex, this.index); } } update(states, vtLayer, imagePositions) { if (!this.stateDependentLayers.length) return; this.programConfigurations.updatePaintArrays(states, vtLayer, this.stateDependentLayers, imagePositions); } isEmpty() { return this.layoutVertexArray.length === 0; } uploadPending() { return !this.uploaded || this.programConfigurations.needsUpload; } upload(context) { if (!this.uploaded) { this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, members$4); this.indexBuffer = context.createIndexBuffer(this.indexArray); } this.programConfigurations.upload(context); this.uploaded = true; } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.programConfigurations.destroy(); this.segments.destroy(); } addFeature(feature, geometry, index, canonical) { for (const ring of geometry) { for (const point of ring) { const x = point.x; const y = point.y; // Do not include points that are outside the tile boundaries. if (x < 0 || x >= EXTENT || y < 0 || y >= EXTENT) continue; // this geometry will be of the Point type, and we'll derive // two triangles from it. // // ┌─────────┐ // │ 3 2 │ // │ │ // │ 0 1 │ // └─────────┘ const segment = this.segments.prepareSegment(4, this.layoutVertexArray, this.indexArray, feature.sortKey); const index = segment.vertexLength; addCircleVertex(this.layoutVertexArray, x, y, -1, -1); addCircleVertex(this.layoutVertexArray, x, y, 1, -1); addCircleVertex(this.layoutVertexArray, x, y, 1, 1); addCircleVertex(this.layoutVertexArray, x, y, -1, 1); this.indexArray.emplaceBack(index, index + 1, index + 2); this.indexArray.emplaceBack(index, index + 3, index + 2); segment.vertexLength += 4; segment.primitiveLength += 2; } } this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length, feature, index, {}, canonical); } } register('CircleBucket', CircleBucket, { omit: ['layers'] }); function polygonIntersectsPolygon(polygonA, polygonB) { for (let i = 0; i < polygonA.length; i++) { if (polygonContainsPoint(polygonB, polygonA[i])) return true; } for (let i = 0; i < polygonB.length; i++) { if (polygonContainsPoint(polygonA, polygonB[i])) return true; } if (lineIntersectsLine(polygonA, polygonB)) return true; return false; } function polygonIntersectsBufferedPoint(polygon, point, radius) { if (polygonContainsPoint(polygon, point)) return true; if (pointIntersectsBufferedLine(point, polygon, radius)) return true; return false; } function polygonIntersectsMultiPolygon(polygon, multiPolygon) { if (polygon.length === 1) { return multiPolygonContainsPoint(multiPolygon, polygon[0]); } for (let m = 0; m < multiPolygon.length; m++) { const ring = multiPolygon[m]; for (let n = 0; n < ring.length; n++) { if (polygonContainsPoint(polygon, ring[n])) return true; } } for (let i = 0; i < polygon.length; i++) { if (multiPolygonContainsPoint(multiPolygon, polygon[i])) return true; } for (let k = 0; k < multiPolygon.length; k++) { if (lineIntersectsLine(polygon, multiPolygon[k])) return true; } return false; } function polygonIntersectsBufferedMultiLine(polygon, multiLine, radius) { for (let i = 0; i < multiLine.length; i++) { const line = multiLine[i]; if (polygon.length >= 3) { for (let k = 0; k < line.length; k++) { if (polygonContainsPoint(polygon, line[k])) return true; } } if (lineIntersectsBufferedLine(polygon, line, radius)) return true; } return false; } function lineIntersectsBufferedLine(lineA, lineB, radius) { if (lineA.length > 1) { if (lineIntersectsLine(lineA, lineB)) return true; // Check whether any point in either line is within radius of the other line for (let j = 0; j < lineB.length; j++) { if (pointIntersectsBufferedLine(lineB[j], lineA, radius)) return true; } } for (let k = 0; k < lineA.length; k++) { if (pointIntersectsBufferedLine(lineA[k], lineB, radius)) return true; } return false; } function lineIntersectsLine(lineA, lineB) { if (lineA.length === 0 || lineB.length === 0) return false; for (let i = 0; i < lineA.length - 1; i++) { const a0 = lineA[i]; const a1 = lineA[i + 1]; for (let j = 0; j < lineB.length - 1; j++) { const b0 = lineB[j]; const b1 = lineB[j + 1]; if (lineSegmentIntersectsLineSegment(a0, a1, b0, b1)) return true; } } return false; } function lineSegmentIntersectsLineSegment(a0, a1, b0, b1) { return isCounterClockwise(a0, b0, b1) !== isCounterClockwise(a1, b0, b1) && isCounterClockwise(a0, a1, b0) !== isCounterClockwise(a0, a1, b1); } function pointIntersectsBufferedLine(p, line, radius) { const radiusSquared = radius * radius; if (line.length === 1) return p.distSqr(line[0]) < radiusSquared; for (let i = 1; i < line.length; i++) { // Find line segments that have a distance <= radius^2 to p // In that case, we treat the line as "containing point p". const v = line[i - 1], w = line[i]; if (distToSegmentSquared(p, v, w) < radiusSquared) return true; } return false; } // Code from https://stackoverflow.com/a/1501725/331379. function distToSegmentSquared(p, v, w) { const l2 = v.distSqr(w); if (l2 === 0) return p.distSqr(v); const t = ((p.x - v.x) * (w.x - v.x) + (p.y - v.y) * (w.y - v.y)) / l2; if (t < 0) return p.distSqr(v); if (t > 1) return p.distSqr(w); return p.distSqr(w.sub(v)._mult(t)._add(v)); } // point in polygon ray casting algorithm function multiPolygonContainsPoint(rings, p) { let c = false, ring, p1, p2; for (let k = 0; k < rings.length; k++) { ring = rings[k]; for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) { p1 = ring[i]; p2 = ring[j]; if (((p1.y > p.y) !== (p2.y > p.y)) && (p.x < (p2.x - p1.x) * (p.y - p1.y) / (p2.y - p1.y) + p1.x)) { c = !c; } } } return c; } function polygonContainsPoint(ring, p) { let c = false; for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) { const p1 = ring[i]; const p2 = ring[j]; if (((p1.y > p.y) !== (p2.y > p.y)) && (p.x < (p2.x - p1.x) * (p.y - p1.y) / (p2.y - p1.y) + p1.x)) { c = !c; } } return c; } function polygonIntersectsBox(ring, boxX1, boxY1, boxX2, boxY2) { for (const p of ring) { if (boxX1 <= p.x && boxY1 <= p.y && boxX2 >= p.x && boxY2 >= p.y) return true; } const corners = [ new Point$2(boxX1, boxY1), new Point$2(boxX1, boxY2), new Point$2(boxX2, boxY2), new Point$2(boxX2, boxY1) ]; if (ring.length > 2) { for (const corner of corners) { if (polygonContainsPoint(ring, corner)) return true; } } for (let i = 0; i < ring.length - 1; i++) { const p1 = ring[i]; const p2 = ring[i + 1]; if (edgeIntersectsBox(p1, p2, corners)) return true; } return false; } function edgeIntersectsBox(e1, e2, corners) { const tl = corners[0]; const br = corners[2]; // the edge and box do not intersect in either the x or y dimensions if (((e1.x < tl.x) && (e2.x < tl.x)) || ((e1.x > br.x) && (e2.x > br.x)) || ((e1.y < tl.y) && (e2.y < tl.y)) || ((e1.y > br.y) && (e2.y > br.y))) return false; // check if all corners of the box are on the same side of the edge const dir = isCounterClockwise(e1, e2, corners[0]); return dir !== isCounterClockwise(e1, e2, corners[1]) || dir !== isCounterClockwise(e1, e2, corners[2]) || dir !== isCounterClockwise(e1, e2, corners[3]); } function getMaximumPaintValue(property, layer, bucket) { const value = layer.paint.get(property).value; if (value.kind === 'constant') { return value.value; } else { return bucket.programConfigurations.get(layer.id).getMaxValue(property); } } function translateDistance(translate) { return Math.sqrt(translate[0] * translate[0] + translate[1] * translate[1]); } function translate$4(queryGeometry, translate, translateAnchor, bearing, pixelsToTileUnits) { if (!translate[0] && !translate[1]) { return queryGeometry; } const pt = Point$2.convert(translate)._mult(pixelsToTileUnits); if (translateAnchor === 'viewport') { pt._rotate(-bearing); } const translated = []; for (let i = 0; i < queryGeometry.length; i++) { const point = queryGeometry[i]; translated.push(point.sub(pt)); } return translated; } function offsetLine(rings, offset) { const newRings = []; for (let ringIndex = 0; ringIndex < rings.length; ringIndex++) { const ring = rings[ringIndex]; const newRing = []; for (let index = 0; index < ring.length; index++) { const a = ring[index - 1]; const b = ring[index]; const c = ring[index + 1]; const aToB = index === 0 ? new Point$2(0, 0) : b.sub(a)._unit()._perp(); const bToC = index === ring.length - 1 ? new Point$2(0, 0) : c.sub(b)._unit()._perp(); const extrude = aToB._add(bToC)._unit(); const cosHalfAngle = extrude.x * bToC.x + extrude.y * bToC.y; if (cosHalfAngle !== 0) { extrude._mult(1 / cosHalfAngle); } newRing.push(extrude._mult(offset)._add(b)); } newRings.push(newRing); } return newRings; } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let layout$5; const getLayout$3 = () => layout$5 = layout$5 || new Properties({ "circle-sort-key": new DataDrivenProperty(v8Spec["layout_circle"]["circle-sort-key"]), }); let paint$8; const getPaint$8 = () => paint$8 = paint$8 || new Properties({ "circle-radius": new DataDrivenProperty(v8Spec["paint_circle"]["circle-radius"]), "circle-color": new DataDrivenProperty(v8Spec["paint_circle"]["circle-color"]), "circle-blur": new DataDrivenProperty(v8Spec["paint_circle"]["circle-blur"]), "circle-opacity": new DataDrivenProperty(v8Spec["paint_circle"]["circle-opacity"]), "circle-translate": new DataConstantProperty(v8Spec["paint_circle"]["circle-translate"]), "circle-translate-anchor": new DataConstantProperty(v8Spec["paint_circle"]["circle-translate-anchor"]), "circle-pitch-scale": new DataConstantProperty(v8Spec["paint_circle"]["circle-pitch-scale"]), "circle-pitch-alignment": new DataConstantProperty(v8Spec["paint_circle"]["circle-pitch-alignment"]), "circle-stroke-width": new DataDrivenProperty(v8Spec["paint_circle"]["circle-stroke-width"]), "circle-stroke-color": new DataDrivenProperty(v8Spec["paint_circle"]["circle-stroke-color"]), "circle-stroke-opacity": new DataDrivenProperty(v8Spec["paint_circle"]["circle-stroke-opacity"]), }); var properties$9 = ({ get paint() { return getPaint$8(); }, get layout() { return getLayout$3(); } }); /** * Common utilities * @module glMatrix */ // Configuration Constants var EPSILON = 0.000001; var ARRAY_TYPE = typeof Float32Array !== 'undefined' ? Float32Array : Array; var RANDOM = Math.random; /** * Sets the type of array used when creating new vectors and matrices * * @param {Float32ArrayConstructor | ArrayConstructor} type Array type, such as Float32Array or Array */ function setMatrixArrayType(type) { ARRAY_TYPE = type; } var degree = Math.PI / 180; /** * Convert Degree To Radian * * @param {Number} a Angle in Degrees */ function toRadian(a) { return a * degree; } /** * Tests whether or not the arguments have approximately the same value, within an absolute * or relative tolerance of glMatrix.EPSILON (an absolute tolerance is used for values less * than or equal to 1.0, and a relative tolerance is used for larger values) * * @param {Number} a The first number to test. * @param {Number} b The second number to test. * @returns {Boolean} True if the numbers are approximately equal, false otherwise. */ function equals$a(a, b) { return Math.abs(a - b) <= EPSILON * Math.max(1.0, Math.abs(a), Math.abs(b)); } if (!Math.hypot) Math.hypot = function () { var y = 0, i = arguments.length; while (i--) { y += arguments[i] * arguments[i]; } return Math.sqrt(y); }; var common = /*#__PURE__*/Object.freeze({ __proto__: null, get ARRAY_TYPE () { return ARRAY_TYPE; }, EPSILON: EPSILON, RANDOM: RANDOM, equals: equals$a, setMatrixArrayType: setMatrixArrayType, toRadian: toRadian }); /** * 2x2 Matrix * @module mat2 */ /** * Creates a new identity mat2 * * @returns {mat2} a new 2x2 matrix */ function create$9() { var out = new ARRAY_TYPE(4); if (ARRAY_TYPE != Float32Array) { out[1] = 0; out[2] = 0; } out[0] = 1; out[3] = 1; return out; } /** * Creates a new mat2 initialized with values from an existing matrix * * @param {ReadonlyMat2} a matrix to clone * @returns {mat2} a new 2x2 matrix */ function clone$8(a) { var out = new ARRAY_TYPE(4); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; return out; } /** * Copy the values from one mat2 to another * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the source matrix * @returns {mat2} out */ function copy$8(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; return out; } /** * Set a mat2 to the identity matrix * * @param {mat2} out the receiving matrix * @returns {mat2} out */ function identity$5(out) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 1; return out; } /** * Create a new mat2 with the given values * * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m10 Component in column 1, row 0 position (index 2) * @param {Number} m11 Component in column 1, row 1 position (index 3) * @returns {mat2} out A new 2x2 matrix */ function fromValues$8(m00, m01, m10, m11) { var out = new ARRAY_TYPE(4); out[0] = m00; out[1] = m01; out[2] = m10; out[3] = m11; return out; } /** * Set the components of a mat2 to the given values * * @param {mat2} out the receiving matrix * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m10 Component in column 1, row 0 position (index 2) * @param {Number} m11 Component in column 1, row 1 position (index 3) * @returns {mat2} out */ function set$8(out, m00, m01, m10, m11) { out[0] = m00; out[1] = m01; out[2] = m10; out[3] = m11; return out; } /** * Transpose the values of a mat2 * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the source matrix * @returns {mat2} out */ function transpose$2(out, a) { // If we are transposing ourselves we can skip a few steps but have to cache // some values if (out === a) { var a1 = a[1]; out[1] = a[2]; out[2] = a1; } else { out[0] = a[0]; out[1] = a[2]; out[2] = a[1]; out[3] = a[3]; } return out; } /** * Inverts a mat2 * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the source matrix * @returns {mat2} out */ function invert$5(out, a) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; // Calculate the determinant var det = a0 * a3 - a2 * a1; if (!det) { return null; } det = 1.0 / det; out[0] = a3 * det; out[1] = -a1 * det; out[2] = -a2 * det; out[3] = a0 * det; return out; } /** * Calculates the adjugate of a mat2 * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the source matrix * @returns {mat2} out */ function adjoint$2(out, a) { // Caching this value is nessecary if out == a var a0 = a[0]; out[0] = a[3]; out[1] = -a[1]; out[2] = -a[2]; out[3] = a0; return out; } /** * Calculates the determinant of a mat2 * * @param {ReadonlyMat2} a the source matrix * @returns {Number} determinant of a */ function determinant$3(a) { return a[0] * a[3] - a[2] * a[1]; } /** * Multiplies two mat2's * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the first operand * @param {ReadonlyMat2} b the second operand * @returns {mat2} out */ function multiply$8(out, a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3]; out[0] = a0 * b0 + a2 * b1; out[1] = a1 * b0 + a3 * b1; out[2] = a0 * b2 + a2 * b3; out[3] = a1 * b2 + a3 * b3; return out; } /** * Rotates a mat2 by the given angle * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat2} out */ function rotate$4(out, a, rad) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var s = Math.sin(rad); var c = Math.cos(rad); out[0] = a0 * c + a2 * s; out[1] = a1 * c + a3 * s; out[2] = a0 * -s + a2 * c; out[3] = a1 * -s + a3 * c; return out; } /** * Scales the mat2 by the dimensions in the given vec2 * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the matrix to rotate * @param {ReadonlyVec2} v the vec2 to scale the matrix by * @returns {mat2} out **/ function scale$8(out, a, v) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var v0 = v[0], v1 = v[1]; out[0] = a0 * v0; out[1] = a1 * v0; out[2] = a2 * v1; out[3] = a3 * v1; return out; } /** * Creates a matrix from a given angle * This is equivalent to (but much faster than): * * mat2.identity(dest); * mat2.rotate(dest, dest, rad); * * @param {mat2} out mat2 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat2} out */ function fromRotation$4(out, rad) { var s = Math.sin(rad); var c = Math.cos(rad); out[0] = c; out[1] = s; out[2] = -s; out[3] = c; return out; } /** * Creates a matrix from a vector scaling * This is equivalent to (but much faster than): * * mat2.identity(dest); * mat2.scale(dest, dest, vec); * * @param {mat2} out mat2 receiving operation result * @param {ReadonlyVec2} v Scaling vector * @returns {mat2} out */ function fromScaling$3(out, v) { out[0] = v[0]; out[1] = 0; out[2] = 0; out[3] = v[1]; return out; } /** * Returns a string representation of a mat2 * * @param {ReadonlyMat2} a matrix to represent as a string * @returns {String} string representation of the matrix */ function str$8(a) { return "mat2(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ")"; } /** * Returns Frobenius norm of a mat2 * * @param {ReadonlyMat2} a the matrix to calculate Frobenius norm of * @returns {Number} Frobenius norm */ function frob$3(a) { return Math.hypot(a[0], a[1], a[2], a[3]); } /** * Returns L, D and U matrices (Lower triangular, Diagonal and Upper triangular) by factorizing the input matrix * @param {ReadonlyMat2} L the lower triangular matrix * @param {ReadonlyMat2} D the diagonal matrix * @param {ReadonlyMat2} U the upper triangular matrix * @param {ReadonlyMat2} a the input matrix to factorize */ function LDU(L, D, U, a) { L[2] = a[2] / a[0]; U[0] = a[0]; U[1] = a[1]; U[3] = a[3] - L[2] * U[1]; return [L, D, U]; } /** * Adds two mat2's * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the first operand * @param {ReadonlyMat2} b the second operand * @returns {mat2} out */ function add$8(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; return out; } /** * Subtracts matrix b from matrix a * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the first operand * @param {ReadonlyMat2} b the second operand * @returns {mat2} out */ function subtract$6(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; out[3] = a[3] - b[3]; return out; } /** * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyMat2} a The first matrix. * @param {ReadonlyMat2} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function exactEquals$8(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3]; } /** * Returns whether or not the matrices have approximately the same elements in the same position. * * @param {ReadonlyMat2} a The first matrix. * @param {ReadonlyMat2} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function equals$9(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)); } /** * Multiply each element of the matrix by a scalar. * * @param {mat2} out the receiving matrix * @param {ReadonlyMat2} a the matrix to scale * @param {Number} b amount to scale the matrix's elements by * @returns {mat2} out */ function multiplyScalar$3(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; return out; } /** * Adds two mat2's after multiplying each element of the second operand by a scalar value. * * @param {mat2} out the receiving vector * @param {ReadonlyMat2} a the first operand * @param {ReadonlyMat2} b the second operand * @param {Number} scale the amount to scale b's elements by before adding * @returns {mat2} out */ function multiplyScalarAndAdd$3(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; out[3] = a[3] + b[3] * scale; return out; } /** * Alias for {@link mat2.multiply} * @function */ var mul$8 = multiply$8; /** * Alias for {@link mat2.subtract} * @function */ var sub$6 = subtract$6; var mat2 = /*#__PURE__*/Object.freeze({ __proto__: null, LDU: LDU, add: add$8, adjoint: adjoint$2, clone: clone$8, copy: copy$8, create: create$9, determinant: determinant$3, equals: equals$9, exactEquals: exactEquals$8, frob: frob$3, fromRotation: fromRotation$4, fromScaling: fromScaling$3, fromValues: fromValues$8, identity: identity$5, invert: invert$5, mul: mul$8, multiply: multiply$8, multiplyScalar: multiplyScalar$3, multiplyScalarAndAdd: multiplyScalarAndAdd$3, rotate: rotate$4, scale: scale$8, set: set$8, str: str$8, sub: sub$6, subtract: subtract$6, transpose: transpose$2 }); /** * 2x3 Matrix * @module mat2d * @description * A mat2d contains six elements defined as: * 
 * [a, b,
 *  c, d,
 *  tx, ty]
 *
* This is a short form for the 3x3 matrix: * 
 * [a, b, 0,
 *  c, d, 0,
 *  tx, ty, 1]
 *
* The last column is ignored so the array is shorter and operations are faster. */ /** * Creates a new identity mat2d * * @returns {mat2d} a new 2x3 matrix */ function create$8() { var out = new ARRAY_TYPE(6); if (ARRAY_TYPE != Float32Array) { out[1] = 0; out[2] = 0; out[4] = 0; out[5] = 0; } out[0] = 1; out[3] = 1; return out; } /** * Creates a new mat2d initialized with values from an existing matrix * * @param {ReadonlyMat2d} a matrix to clone * @returns {mat2d} a new 2x3 matrix */ function clone$7(a) { var out = new ARRAY_TYPE(6); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; return out; } /** * Copy the values from one mat2d to another * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the source matrix * @returns {mat2d} out */ function copy$7(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; return out; } /** * Set a mat2d to the identity matrix * * @param {mat2d} out the receiving matrix * @returns {mat2d} out */ function identity$4(out) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 1; out[4] = 0; out[5] = 0; return out; } /** * Create a new mat2d with the given values * * @param {Number} a Component A (index 0) * @param {Number} b Component B (index 1) * @param {Number} c Component C (index 2) * @param {Number} d Component D (index 3) * @param {Number} tx Component TX (index 4) * @param {Number} ty Component TY (index 5) * @returns {mat2d} A new mat2d */ function fromValues$7(a, b, c, d, tx, ty) { var out = new ARRAY_TYPE(6); out[0] = a; out[1] = b; out[2] = c; out[3] = d; out[4] = tx; out[5] = ty; return out; } /** * Set the components of a mat2d to the given values * * @param {mat2d} out the receiving matrix * @param {Number} a Component A (index 0) * @param {Number} b Component B (index 1) * @param {Number} c Component C (index 2) * @param {Number} d Component D (index 3) * @param {Number} tx Component TX (index 4) * @param {Number} ty Component TY (index 5) * @returns {mat2d} out */ function set$7(out, a, b, c, d, tx, ty) { out[0] = a; out[1] = b; out[2] = c; out[3] = d; out[4] = tx; out[5] = ty; return out; } /** * Inverts a mat2d * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the source matrix * @returns {mat2d} out */ function invert$4(out, a) { var aa = a[0], ab = a[1], ac = a[2], ad = a[3]; var atx = a[4], aty = a[5]; var det = aa * ad - ab * ac; if (!det) { return null; } det = 1.0 / det; out[0] = ad * det; out[1] = -ab * det; out[2] = -ac * det; out[3] = aa * det; out[4] = (ac * aty - ad * atx) * det; out[5] = (ab * atx - aa * aty) * det; return out; } /** * Calculates the determinant of a mat2d * * @param {ReadonlyMat2d} a the source matrix * @returns {Number} determinant of a */ function determinant$2(a) { return a[0] * a[3] - a[1] * a[2]; } /** * Multiplies two mat2d's * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the first operand * @param {ReadonlyMat2d} b the second operand * @returns {mat2d} out */ function multiply$7(out, a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3], b4 = b[4], b5 = b[5]; out[0] = a0 * b0 + a2 * b1; out[1] = a1 * b0 + a3 * b1; out[2] = a0 * b2 + a2 * b3; out[3] = a1 * b2 + a3 * b3; out[4] = a0 * b4 + a2 * b5 + a4; out[5] = a1 * b4 + a3 * b5 + a5; return out; } /** * Rotates a mat2d by the given angle * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat2d} out */ function rotate$3(out, a, rad) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5]; var s = Math.sin(rad); var c = Math.cos(rad); out[0] = a0 * c + a2 * s; out[1] = a1 * c + a3 * s; out[2] = a0 * -s + a2 * c; out[3] = a1 * -s + a3 * c; out[4] = a4; out[5] = a5; return out; } /** * Scales the mat2d by the dimensions in the given vec2 * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the matrix to translate * @param {ReadonlyVec2} v the vec2 to scale the matrix by * @returns {mat2d} out **/ function scale$7(out, a, v) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5]; var v0 = v[0], v1 = v[1]; out[0] = a0 * v0; out[1] = a1 * v0; out[2] = a2 * v1; out[3] = a3 * v1; out[4] = a4; out[5] = a5; return out; } /** * Translates the mat2d by the dimensions in the given vec2 * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the matrix to translate * @param {ReadonlyVec2} v the vec2 to translate the matrix by * @returns {mat2d} out **/ function translate$3(out, a, v) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5]; var v0 = v[0], v1 = v[1]; out[0] = a0; out[1] = a1; out[2] = a2; out[3] = a3; out[4] = a0 * v0 + a2 * v1 + a4; out[5] = a1 * v0 + a3 * v1 + a5; return out; } /** * Creates a matrix from a given angle * This is equivalent to (but much faster than): * * mat2d.identity(dest); * mat2d.rotate(dest, dest, rad); * * @param {mat2d} out mat2d receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat2d} out */ function fromRotation$3(out, rad) { var s = Math.sin(rad), c = Math.cos(rad); out[0] = c; out[1] = s; out[2] = -s; out[3] = c; out[4] = 0; out[5] = 0; return out; } /** * Creates a matrix from a vector scaling * This is equivalent to (but much faster than): * * mat2d.identity(dest); * mat2d.scale(dest, dest, vec); * * @param {mat2d} out mat2d receiving operation result * @param {ReadonlyVec2} v Scaling vector * @returns {mat2d} out */ function fromScaling$2(out, v) { out[0] = v[0]; out[1] = 0; out[2] = 0; out[3] = v[1]; out[4] = 0; out[5] = 0; return out; } /** * Creates a matrix from a vector translation * This is equivalent to (but much faster than): * * mat2d.identity(dest); * mat2d.translate(dest, dest, vec); * * @param {mat2d} out mat2d receiving operation result * @param {ReadonlyVec2} v Translation vector * @returns {mat2d} out */ function fromTranslation$3(out, v) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 1; out[4] = v[0]; out[5] = v[1]; return out; } /** * Returns a string representation of a mat2d * * @param {ReadonlyMat2d} a matrix to represent as a string * @returns {String} string representation of the matrix */ function str$7(a) { return "mat2d(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ", " + a[4] + ", " + a[5] + ")"; } /** * Returns Frobenius norm of a mat2d * * @param {ReadonlyMat2d} a the matrix to calculate Frobenius norm of * @returns {Number} Frobenius norm */ function frob$2(a) { return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], 1); } /** * Adds two mat2d's * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the first operand * @param {ReadonlyMat2d} b the second operand * @returns {mat2d} out */ function add$7(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; out[4] = a[4] + b[4]; out[5] = a[5] + b[5]; return out; } /** * Subtracts matrix b from matrix a * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the first operand * @param {ReadonlyMat2d} b the second operand * @returns {mat2d} out */ function subtract$5(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; out[3] = a[3] - b[3]; out[4] = a[4] - b[4]; out[5] = a[5] - b[5]; return out; } /** * Multiply each element of the matrix by a scalar. * * @param {mat2d} out the receiving matrix * @param {ReadonlyMat2d} a the matrix to scale * @param {Number} b amount to scale the matrix's elements by * @returns {mat2d} out */ function multiplyScalar$2(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; out[4] = a[4] * b; out[5] = a[5] * b; return out; } /** * Adds two mat2d's after multiplying each element of the second operand by a scalar value. * * @param {mat2d} out the receiving vector * @param {ReadonlyMat2d} a the first operand * @param {ReadonlyMat2d} b the second operand * @param {Number} scale the amount to scale b's elements by before adding * @returns {mat2d} out */ function multiplyScalarAndAdd$2(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; out[3] = a[3] + b[3] * scale; out[4] = a[4] + b[4] * scale; out[5] = a[5] + b[5] * scale; return out; } /** * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyMat2d} a The first matrix. * @param {ReadonlyMat2d} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function exactEquals$7(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5]; } /** * Returns whether or not the matrices have approximately the same elements in the same position. * * @param {ReadonlyMat2d} a The first matrix. * @param {ReadonlyMat2d} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function equals$8(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3], b4 = b[4], b5 = b[5]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)); } /** * Alias for {@link mat2d.multiply} * @function */ var mul$7 = multiply$7; /** * Alias for {@link mat2d.subtract} * @function */ var sub$5 = subtract$5; var mat2d = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$7, clone: clone$7, copy: copy$7, create: create$8, determinant: determinant$2, equals: equals$8, exactEquals: exactEquals$7, frob: frob$2, fromRotation: fromRotation$3, fromScaling: fromScaling$2, fromTranslation: fromTranslation$3, fromValues: fromValues$7, identity: identity$4, invert: invert$4, mul: mul$7, multiply: multiply$7, multiplyScalar: multiplyScalar$2, multiplyScalarAndAdd: multiplyScalarAndAdd$2, rotate: rotate$3, scale: scale$7, set: set$7, str: str$7, sub: sub$5, subtract: subtract$5, translate: translate$3 }); /** * 3x3 Matrix * @module mat3 */ /** * Creates a new identity mat3 * * @returns {mat3} a new 3x3 matrix */ function create$7() { var out = new ARRAY_TYPE(9); if (ARRAY_TYPE != Float32Array) { out[1] = 0; out[2] = 0; out[3] = 0; out[5] = 0; out[6] = 0; out[7] = 0; } out[0] = 1; out[4] = 1; out[8] = 1; return out; } /** * Copies the upper-left 3x3 values into the given mat3. * * @param {mat3} out the receiving 3x3 matrix * @param {ReadonlyMat4} a the source 4x4 matrix * @returns {mat3} out */ function fromMat4$1(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[4]; out[4] = a[5]; out[5] = a[6]; out[6] = a[8]; out[7] = a[9]; out[8] = a[10]; return out; } /** * Creates a new mat3 initialized with values from an existing matrix * * @param {ReadonlyMat3} a matrix to clone * @returns {mat3} a new 3x3 matrix */ function clone$6(a) { var out = new ARRAY_TYPE(9); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; out[8] = a[8]; return out; } /** * Copy the values from one mat3 to another * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the source matrix * @returns {mat3} out */ function copy$6(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; out[8] = a[8]; return out; } /** * Create a new mat3 with the given values * * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m02 Component in column 0, row 2 position (index 2) * @param {Number} m10 Component in column 1, row 0 position (index 3) * @param {Number} m11 Component in column 1, row 1 position (index 4) * @param {Number} m12 Component in column 1, row 2 position (index 5) * @param {Number} m20 Component in column 2, row 0 position (index 6) * @param {Number} m21 Component in column 2, row 1 position (index 7) * @param {Number} m22 Component in column 2, row 2 position (index 8) * @returns {mat3} A new mat3 */ function fromValues$6(m00, m01, m02, m10, m11, m12, m20, m21, m22) { var out = new ARRAY_TYPE(9); out[0] = m00; out[1] = m01; out[2] = m02; out[3] = m10; out[4] = m11; out[5] = m12; out[6] = m20; out[7] = m21; out[8] = m22; return out; } /** * Set the components of a mat3 to the given values * * @param {mat3} out the receiving matrix * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m02 Component in column 0, row 2 position (index 2) * @param {Number} m10 Component in column 1, row 0 position (index 3) * @param {Number} m11 Component in column 1, row 1 position (index 4) * @param {Number} m12 Component in column 1, row 2 position (index 5) * @param {Number} m20 Component in column 2, row 0 position (index 6) * @param {Number} m21 Component in column 2, row 1 position (index 7) * @param {Number} m22 Component in column 2, row 2 position (index 8) * @returns {mat3} out */ function set$6(out, m00, m01, m02, m10, m11, m12, m20, m21, m22) { out[0] = m00; out[1] = m01; out[2] = m02; out[3] = m10; out[4] = m11; out[5] = m12; out[6] = m20; out[7] = m21; out[8] = m22; return out; } /** * Set a mat3 to the identity matrix * * @param {mat3} out the receiving matrix * @returns {mat3} out */ function identity$3(out) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 1; out[5] = 0; out[6] = 0; out[7] = 0; out[8] = 1; return out; } /** * Transpose the values of a mat3 * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the source matrix * @returns {mat3} out */ function transpose$1(out, a) { // If we are transposing ourselves we can skip a few steps but have to cache some values if (out === a) { var a01 = a[1], a02 = a[2], a12 = a[5]; out[1] = a[3]; out[2] = a[6]; out[3] = a01; out[5] = a[7]; out[6] = a02; out[7] = a12; } else { out[0] = a[0]; out[1] = a[3]; out[2] = a[6]; out[3] = a[1]; out[4] = a[4]; out[5] = a[7]; out[6] = a[2]; out[7] = a[5]; out[8] = a[8]; } return out; } /** * Inverts a mat3 * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the source matrix * @returns {mat3} out */ function invert$3(out, a) { var a00 = a[0], a01 = a[1], a02 = a[2]; var a10 = a[3], a11 = a[4], a12 = a[5]; var a20 = a[6], a21 = a[7], a22 = a[8]; var b01 = a22 * a11 - a12 * a21; var b11 = -a22 * a10 + a12 * a20; var b21 = a21 * a10 - a11 * a20; // Calculate the determinant var det = a00 * b01 + a01 * b11 + a02 * b21; if (!det) { return null; } det = 1.0 / det; out[0] = b01 * det; out[1] = (-a22 * a01 + a02 * a21) * det; out[2] = (a12 * a01 - a02 * a11) * det; out[3] = b11 * det; out[4] = (a22 * a00 - a02 * a20) * det; out[5] = (-a12 * a00 + a02 * a10) * det; out[6] = b21 * det; out[7] = (-a21 * a00 + a01 * a20) * det; out[8] = (a11 * a00 - a01 * a10) * det; return out; } /** * Calculates the adjugate of a mat3 * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the source matrix * @returns {mat3} out */ function adjoint$1(out, a) { var a00 = a[0], a01 = a[1], a02 = a[2]; var a10 = a[3], a11 = a[4], a12 = a[5]; var a20 = a[6], a21 = a[7], a22 = a[8]; out[0] = a11 * a22 - a12 * a21; out[1] = a02 * a21 - a01 * a22; out[2] = a01 * a12 - a02 * a11; out[3] = a12 * a20 - a10 * a22; out[4] = a00 * a22 - a02 * a20; out[5] = a02 * a10 - a00 * a12; out[6] = a10 * a21 - a11 * a20; out[7] = a01 * a20 - a00 * a21; out[8] = a00 * a11 - a01 * a10; return out; } /** * Calculates the determinant of a mat3 * * @param {ReadonlyMat3} a the source matrix * @returns {Number} determinant of a */ function determinant$1(a) { var a00 = a[0], a01 = a[1], a02 = a[2]; var a10 = a[3], a11 = a[4], a12 = a[5]; var a20 = a[6], a21 = a[7], a22 = a[8]; return a00 * (a22 * a11 - a12 * a21) + a01 * (-a22 * a10 + a12 * a20) + a02 * (a21 * a10 - a11 * a20); } /** * Multiplies two mat3's * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the first operand * @param {ReadonlyMat3} b the second operand * @returns {mat3} out */ function multiply$6(out, a, b) { var a00 = a[0], a01 = a[1], a02 = a[2]; var a10 = a[3], a11 = a[4], a12 = a[5]; var a20 = a[6], a21 = a[7], a22 = a[8]; var b00 = b[0], b01 = b[1], b02 = b[2]; var b10 = b[3], b11 = b[4], b12 = b[5]; var b20 = b[6], b21 = b[7], b22 = b[8]; out[0] = b00 * a00 + b01 * a10 + b02 * a20; out[1] = b00 * a01 + b01 * a11 + b02 * a21; out[2] = b00 * a02 + b01 * a12 + b02 * a22; out[3] = b10 * a00 + b11 * a10 + b12 * a20; out[4] = b10 * a01 + b11 * a11 + b12 * a21; out[5] = b10 * a02 + b11 * a12 + b12 * a22; out[6] = b20 * a00 + b21 * a10 + b22 * a20; out[7] = b20 * a01 + b21 * a11 + b22 * a21; out[8] = b20 * a02 + b21 * a12 + b22 * a22; return out; } /** * Translate a mat3 by the given vector * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the matrix to translate * @param {ReadonlyVec2} v vector to translate by * @returns {mat3} out */ function translate$2(out, a, v) { var a00 = a[0], a01 = a[1], a02 = a[2], a10 = a[3], a11 = a[4], a12 = a[5], a20 = a[6], a21 = a[7], a22 = a[8], x = v[0], y = v[1]; out[0] = a00; out[1] = a01; out[2] = a02; out[3] = a10; out[4] = a11; out[5] = a12; out[6] = x * a00 + y * a10 + a20; out[7] = x * a01 + y * a11 + a21; out[8] = x * a02 + y * a12 + a22; return out; } /** * Rotates a mat3 by the given angle * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat3} out */ function rotate$2(out, a, rad) { var a00 = a[0], a01 = a[1], a02 = a[2], a10 = a[3], a11 = a[4], a12 = a[5], a20 = a[6], a21 = a[7], a22 = a[8], s = Math.sin(rad), c = Math.cos(rad); out[0] = c * a00 + s * a10; out[1] = c * a01 + s * a11; out[2] = c * a02 + s * a12; out[3] = c * a10 - s * a00; out[4] = c * a11 - s * a01; out[5] = c * a12 - s * a02; out[6] = a20; out[7] = a21; out[8] = a22; return out; } /** * Scales the mat3 by the dimensions in the given vec2 * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the matrix to rotate * @param {ReadonlyVec2} v the vec2 to scale the matrix by * @returns {mat3} out **/ function scale$6(out, a, v) { var x = v[0], y = v[1]; out[0] = x * a[0]; out[1] = x * a[1]; out[2] = x * a[2]; out[3] = y * a[3]; out[4] = y * a[4]; out[5] = y * a[5]; out[6] = a[6]; out[7] = a[7]; out[8] = a[8]; return out; } /** * Creates a matrix from a vector translation * This is equivalent to (but much faster than): * * mat3.identity(dest); * mat3.translate(dest, dest, vec); * * @param {mat3} out mat3 receiving operation result * @param {ReadonlyVec2} v Translation vector * @returns {mat3} out */ function fromTranslation$2(out, v) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 1; out[5] = 0; out[6] = v[0]; out[7] = v[1]; out[8] = 1; return out; } /** * Creates a matrix from a given angle * This is equivalent to (but much faster than): * * mat3.identity(dest); * mat3.rotate(dest, dest, rad); * * @param {mat3} out mat3 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat3} out */ function fromRotation$2(out, rad) { var s = Math.sin(rad), c = Math.cos(rad); out[0] = c; out[1] = s; out[2] = 0; out[3] = -s; out[4] = c; out[5] = 0; out[6] = 0; out[7] = 0; out[8] = 1; return out; } /** * Creates a matrix from a vector scaling * This is equivalent to (but much faster than): * * mat3.identity(dest); * mat3.scale(dest, dest, vec); * * @param {mat3} out mat3 receiving operation result * @param {ReadonlyVec2} v Scaling vector * @returns {mat3} out */ function fromScaling$1(out, v) { out[0] = v[0]; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = v[1]; out[5] = 0; out[6] = 0; out[7] = 0; out[8] = 1; return out; } /** * Copies the values from a mat2d into a mat3 * * @param {mat3} out the receiving matrix * @param {ReadonlyMat2d} a the matrix to copy * @returns {mat3} out **/ function fromMat2d(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = 0; out[3] = a[2]; out[4] = a[3]; out[5] = 0; out[6] = a[4]; out[7] = a[5]; out[8] = 1; return out; } /** * Calculates a 3x3 matrix from the given quaternion * * @param {mat3} out mat3 receiving operation result * @param {ReadonlyQuat} q Quaternion to create matrix from * * @returns {mat3} out */ function fromQuat$1(out, q) { var x = q[0], y = q[1], z = q[2], w = q[3]; var x2 = x + x; var y2 = y + y; var z2 = z + z; var xx = x * x2; var yx = y * x2; var yy = y * y2; var zx = z * x2; var zy = z * y2; var zz = z * z2; var wx = w * x2; var wy = w * y2; var wz = w * z2; out[0] = 1 - yy - zz; out[3] = yx - wz; out[6] = zx + wy; out[1] = yx + wz; out[4] = 1 - xx - zz; out[7] = zy - wx; out[2] = zx - wy; out[5] = zy + wx; out[8] = 1 - xx - yy; return out; } /** * Calculates a 3x3 normal matrix (transpose inverse) from the 4x4 matrix * * @param {mat3} out mat3 receiving operation result * @param {ReadonlyMat4} a Mat4 to derive the normal matrix from * * @returns {mat3} out */ function normalFromMat4(out, a) { var a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3]; var a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7]; var a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11]; var a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15]; var b00 = a00 * a11 - a01 * a10; var b01 = a00 * a12 - a02 * a10; var b02 = a00 * a13 - a03 * a10; var b03 = a01 * a12 - a02 * a11; var b04 = a01 * a13 - a03 * a11; var b05 = a02 * a13 - a03 * a12; var b06 = a20 * a31 - a21 * a30; var b07 = a20 * a32 - a22 * a30; var b08 = a20 * a33 - a23 * a30; var b09 = a21 * a32 - a22 * a31; var b10 = a21 * a33 - a23 * a31; var b11 = a22 * a33 - a23 * a32; // Calculate the determinant var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06; if (!det) { return null; } det = 1.0 / det; out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det; out[1] = (a12 * b08 - a10 * b11 - a13 * b07) * det; out[2] = (a10 * b10 - a11 * b08 + a13 * b06) * det; out[3] = (a02 * b10 - a01 * b11 - a03 * b09) * det; out[4] = (a00 * b11 - a02 * b08 + a03 * b07) * det; out[5] = (a01 * b08 - a00 * b10 - a03 * b06) * det; out[6] = (a31 * b05 - a32 * b04 + a33 * b03) * det; out[7] = (a32 * b02 - a30 * b05 - a33 * b01) * det; out[8] = (a30 * b04 - a31 * b02 + a33 * b00) * det; return out; } /** * Generates a 2D projection matrix with the given bounds * * @param {mat3} out mat3 frustum matrix will be written into * @param {number} width Width of your gl context * @param {number} height Height of gl context * @returns {mat3} out */ function projection(out, width, height) { out[0] = 2 / width; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = -2 / height; out[5] = 0; out[6] = -1; out[7] = 1; out[8] = 1; return out; } /** * Returns a string representation of a mat3 * * @param {ReadonlyMat3} a matrix to represent as a string * @returns {String} string representation of the matrix */ function str$6(a) { return "mat3(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ", " + a[4] + ", " + a[5] + ", " + a[6] + ", " + a[7] + ", " + a[8] + ")"; } /** * Returns Frobenius norm of a mat3 * * @param {ReadonlyMat3} a the matrix to calculate Frobenius norm of * @returns {Number} Frobenius norm */ function frob$1(a) { return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], a[6], a[7], a[8]); } /** * Adds two mat3's * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the first operand * @param {ReadonlyMat3} b the second operand * @returns {mat3} out */ function add$6(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; out[4] = a[4] + b[4]; out[5] = a[5] + b[5]; out[6] = a[6] + b[6]; out[7] = a[7] + b[7]; out[8] = a[8] + b[8]; return out; } /** * Subtracts matrix b from matrix a * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the first operand * @param {ReadonlyMat3} b the second operand * @returns {mat3} out */ function subtract$4(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; out[3] = a[3] - b[3]; out[4] = a[4] - b[4]; out[5] = a[5] - b[5]; out[6] = a[6] - b[6]; out[7] = a[7] - b[7]; out[8] = a[8] - b[8]; return out; } /** * Multiply each element of the matrix by a scalar. * * @param {mat3} out the receiving matrix * @param {ReadonlyMat3} a the matrix to scale * @param {Number} b amount to scale the matrix's elements by * @returns {mat3} out */ function multiplyScalar$1(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; out[4] = a[4] * b; out[5] = a[5] * b; out[6] = a[6] * b; out[7] = a[7] * b; out[8] = a[8] * b; return out; } /** * Adds two mat3's after multiplying each element of the second operand by a scalar value. * * @param {mat3} out the receiving vector * @param {ReadonlyMat3} a the first operand * @param {ReadonlyMat3} b the second operand * @param {Number} scale the amount to scale b's elements by before adding * @returns {mat3} out */ function multiplyScalarAndAdd$1(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; out[3] = a[3] + b[3] * scale; out[4] = a[4] + b[4] * scale; out[5] = a[5] + b[5] * scale; out[6] = a[6] + b[6] * scale; out[7] = a[7] + b[7] * scale; out[8] = a[8] + b[8] * scale; return out; } /** * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyMat3} a The first matrix. * @param {ReadonlyMat3} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function exactEquals$6(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8]; } /** * Returns whether or not the matrices have approximately the same elements in the same position. * * @param {ReadonlyMat3} a The first matrix. * @param {ReadonlyMat3} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function equals$7(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5], a6 = a[6], a7 = a[7], a8 = a[8]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3], b4 = b[4], b5 = b[5], b6 = b[6], b7 = b[7], b8 = b[8]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8)); } /** * Alias for {@link mat3.multiply} * @function */ var mul$6 = multiply$6; /** * Alias for {@link mat3.subtract} * @function */ var sub$4 = subtract$4; var mat3 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$6, adjoint: adjoint$1, clone: clone$6, copy: copy$6, create: create$7, determinant: determinant$1, equals: equals$7, exactEquals: exactEquals$6, frob: frob$1, fromMat2d: fromMat2d, fromMat4: fromMat4$1, fromQuat: fromQuat$1, fromRotation: fromRotation$2, fromScaling: fromScaling$1, fromTranslation: fromTranslation$2, fromValues: fromValues$6, identity: identity$3, invert: invert$3, mul: mul$6, multiply: multiply$6, multiplyScalar: multiplyScalar$1, multiplyScalarAndAdd: multiplyScalarAndAdd$1, normalFromMat4: normalFromMat4, projection: projection, rotate: rotate$2, scale: scale$6, set: set$6, str: str$6, sub: sub$4, subtract: subtract$4, translate: translate$2, transpose: transpose$1 }); /** * 4x4 Matrix
Format: column-major, when typed out it looks like row-major
The matrices are being post multiplied. * @module mat4 */ /** * Creates a new identity mat4 * * @returns {mat4} a new 4x4 matrix */ function create$6() { var out = new ARRAY_TYPE(16); if (ARRAY_TYPE != Float32Array) { out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; } out[0] = 1; out[5] = 1; out[10] = 1; out[15] = 1; return out; } /** * Creates a new mat4 initialized with values from an existing matrix * * @param {ReadonlyMat4} a matrix to clone * @returns {mat4} a new 4x4 matrix */ function clone$5(a) { var out = new ARRAY_TYPE(16); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; out[8] = a[8]; out[9] = a[9]; out[10] = a[10]; out[11] = a[11]; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; return out; } /** * Copy the values from one mat4 to another * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the source matrix * @returns {mat4} out */ function copy$5(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; out[8] = a[8]; out[9] = a[9]; out[10] = a[10]; out[11] = a[11]; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; return out; } /** * Create a new mat4 with the given values * * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m02 Component in column 0, row 2 position (index 2) * @param {Number} m03 Component in column 0, row 3 position (index 3) * @param {Number} m10 Component in column 1, row 0 position (index 4) * @param {Number} m11 Component in column 1, row 1 position (index 5) * @param {Number} m12 Component in column 1, row 2 position (index 6) * @param {Number} m13 Component in column 1, row 3 position (index 7) * @param {Number} m20 Component in column 2, row 0 position (index 8) * @param {Number} m21 Component in column 2, row 1 position (index 9) * @param {Number} m22 Component in column 2, row 2 position (index 10) * @param {Number} m23 Component in column 2, row 3 position (index 11) * @param {Number} m30 Component in column 3, row 0 position (index 12) * @param {Number} m31 Component in column 3, row 1 position (index 13) * @param {Number} m32 Component in column 3, row 2 position (index 14) * @param {Number} m33 Component in column 3, row 3 position (index 15) * @returns {mat4} A new mat4 */ function fromValues$5(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) { var out = new ARRAY_TYPE(16); out[0] = m00; out[1] = m01; out[2] = m02; out[3] = m03; out[4] = m10; out[5] = m11; out[6] = m12; out[7] = m13; out[8] = m20; out[9] = m21; out[10] = m22; out[11] = m23; out[12] = m30; out[13] = m31; out[14] = m32; out[15] = m33; return out; } /** * Set the components of a mat4 to the given values * * @param {mat4} out the receiving matrix * @param {Number} m00 Component in column 0, row 0 position (index 0) * @param {Number} m01 Component in column 0, row 1 position (index 1) * @param {Number} m02 Component in column 0, row 2 position (index 2) * @param {Number} m03 Component in column 0, row 3 position (index 3) * @param {Number} m10 Component in column 1, row 0 position (index 4) * @param {Number} m11 Component in column 1, row 1 position (index 5) * @param {Number} m12 Component in column 1, row 2 position (index 6) * @param {Number} m13 Component in column 1, row 3 position (index 7) * @param {Number} m20 Component in column 2, row 0 position (index 8) * @param {Number} m21 Component in column 2, row 1 position (index 9) * @param {Number} m22 Component in column 2, row 2 position (index 10) * @param {Number} m23 Component in column 2, row 3 position (index 11) * @param {Number} m30 Component in column 3, row 0 position (index 12) * @param {Number} m31 Component in column 3, row 1 position (index 13) * @param {Number} m32 Component in column 3, row 2 position (index 14) * @param {Number} m33 Component in column 3, row 3 position (index 15) * @returns {mat4} out */ function set$5(out, m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) { out[0] = m00; out[1] = m01; out[2] = m02; out[3] = m03; out[4] = m10; out[5] = m11; out[6] = m12; out[7] = m13; out[8] = m20; out[9] = m21; out[10] = m22; out[11] = m23; out[12] = m30; out[13] = m31; out[14] = m32; out[15] = m33; return out; } /** * Set a mat4 to the identity matrix * * @param {mat4} out the receiving matrix * @returns {mat4} out */ function identity$2(out) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = 1; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = 1; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Transpose the values of a mat4 * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the source matrix * @returns {mat4} out */ function transpose(out, a) { // If we are transposing ourselves we can skip a few steps but have to cache some values if (out === a) { var a01 = a[1], a02 = a[2], a03 = a[3]; var a12 = a[6], a13 = a[7]; var a23 = a[11]; out[1] = a[4]; out[2] = a[8]; out[3] = a[12]; out[4] = a01; out[6] = a[9]; out[7] = a[13]; out[8] = a02; out[9] = a12; out[11] = a[14]; out[12] = a03; out[13] = a13; out[14] = a23; } else { out[0] = a[0]; out[1] = a[4]; out[2] = a[8]; out[3] = a[12]; out[4] = a[1]; out[5] = a[5]; out[6] = a[9]; out[7] = a[13]; out[8] = a[2]; out[9] = a[6]; out[10] = a[10]; out[11] = a[14]; out[12] = a[3]; out[13] = a[7]; out[14] = a[11]; out[15] = a[15]; } return out; } /** * Inverts a mat4 * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the source matrix * @returns {mat4} out */ function invert$2(out, a) { var a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3]; var a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7]; var a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11]; var a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15]; var b00 = a00 * a11 - a01 * a10; var b01 = a00 * a12 - a02 * a10; var b02 = a00 * a13 - a03 * a10; var b03 = a01 * a12 - a02 * a11; var b04 = a01 * a13 - a03 * a11; var b05 = a02 * a13 - a03 * a12; var b06 = a20 * a31 - a21 * a30; var b07 = a20 * a32 - a22 * a30; var b08 = a20 * a33 - a23 * a30; var b09 = a21 * a32 - a22 * a31; var b10 = a21 * a33 - a23 * a31; var b11 = a22 * a33 - a23 * a32; // Calculate the determinant var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06; if (!det) { return null; } det = 1.0 / det; out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det; out[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det; out[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det; out[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det; out[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det; out[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det; out[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det; out[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det; out[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det; out[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det; out[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det; out[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det; out[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det; out[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det; out[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det; out[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det; return out; } /** * Calculates the adjugate of a mat4 * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the source matrix * @returns {mat4} out */ function adjoint(out, a) { var a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3]; var a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7]; var a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11]; var a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15]; out[0] = a11 * (a22 * a33 - a23 * a32) - a21 * (a12 * a33 - a13 * a32) + a31 * (a12 * a23 - a13 * a22); out[1] = -(a01 * (a22 * a33 - a23 * a32) - a21 * (a02 * a33 - a03 * a32) + a31 * (a02 * a23 - a03 * a22)); out[2] = a01 * (a12 * a33 - a13 * a32) - a11 * (a02 * a33 - a03 * a32) + a31 * (a02 * a13 - a03 * a12); out[3] = -(a01 * (a12 * a23 - a13 * a22) - a11 * (a02 * a23 - a03 * a22) + a21 * (a02 * a13 - a03 * a12)); out[4] = -(a10 * (a22 * a33 - a23 * a32) - a20 * (a12 * a33 - a13 * a32) + a30 * (a12 * a23 - a13 * a22)); out[5] = a00 * (a22 * a33 - a23 * a32) - a20 * (a02 * a33 - a03 * a32) + a30 * (a02 * a23 - a03 * a22); out[6] = -(a00 * (a12 * a33 - a13 * a32) - a10 * (a02 * a33 - a03 * a32) + a30 * (a02 * a13 - a03 * a12)); out[7] = a00 * (a12 * a23 - a13 * a22) - a10 * (a02 * a23 - a03 * a22) + a20 * (a02 * a13 - a03 * a12); out[8] = a10 * (a21 * a33 - a23 * a31) - a20 * (a11 * a33 - a13 * a31) + a30 * (a11 * a23 - a13 * a21); out[9] = -(a00 * (a21 * a33 - a23 * a31) - a20 * (a01 * a33 - a03 * a31) + a30 * (a01 * a23 - a03 * a21)); out[10] = a00 * (a11 * a33 - a13 * a31) - a10 * (a01 * a33 - a03 * a31) + a30 * (a01 * a13 - a03 * a11); out[11] = -(a00 * (a11 * a23 - a13 * a21) - a10 * (a01 * a23 - a03 * a21) + a20 * (a01 * a13 - a03 * a11)); out[12] = -(a10 * (a21 * a32 - a22 * a31) - a20 * (a11 * a32 - a12 * a31) + a30 * (a11 * a22 - a12 * a21)); out[13] = a00 * (a21 * a32 - a22 * a31) - a20 * (a01 * a32 - a02 * a31) + a30 * (a01 * a22 - a02 * a21); out[14] = -(a00 * (a11 * a32 - a12 * a31) - a10 * (a01 * a32 - a02 * a31) + a30 * (a01 * a12 - a02 * a11)); out[15] = a00 * (a11 * a22 - a12 * a21) - a10 * (a01 * a22 - a02 * a21) + a20 * (a01 * a12 - a02 * a11); return out; } /** * Calculates the determinant of a mat4 * * @param {ReadonlyMat4} a the source matrix * @returns {Number} determinant of a */ function determinant(a) { var a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3]; var a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7]; var a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11]; var a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15]; var b00 = a00 * a11 - a01 * a10; var b01 = a00 * a12 - a02 * a10; var b02 = a00 * a13 - a03 * a10; var b03 = a01 * a12 - a02 * a11; var b04 = a01 * a13 - a03 * a11; var b05 = a02 * a13 - a03 * a12; var b06 = a20 * a31 - a21 * a30; var b07 = a20 * a32 - a22 * a30; var b08 = a20 * a33 - a23 * a30; var b09 = a21 * a32 - a22 * a31; var b10 = a21 * a33 - a23 * a31; var b11 = a22 * a33 - a23 * a32; // Calculate the determinant return b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06; } /** * Multiplies two mat4s * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the first operand * @param {ReadonlyMat4} b the second operand * @returns {mat4} out */ function multiply$5(out, a, b) { var a00 = a[0], a01 = a[1], a02 = a[2], a03 = a[3]; var a10 = a[4], a11 = a[5], a12 = a[6], a13 = a[7]; var a20 = a[8], a21 = a[9], a22 = a[10], a23 = a[11]; var a30 = a[12], a31 = a[13], a32 = a[14], a33 = a[15]; // Cache only the current line of the second matrix var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3]; out[0] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30; out[1] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31; out[2] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32; out[3] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33; b0 = b[4]; b1 = b[5]; b2 = b[6]; b3 = b[7]; out[4] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30; out[5] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31; out[6] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32; out[7] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33; b0 = b[8]; b1 = b[9]; b2 = b[10]; b3 = b[11]; out[8] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30; out[9] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31; out[10] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32; out[11] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33; b0 = b[12]; b1 = b[13]; b2 = b[14]; b3 = b[15]; out[12] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30; out[13] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31; out[14] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32; out[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33; return out; } /** * Translate a mat4 by the given vector * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to translate * @param {ReadonlyVec3} v vector to translate by * @returns {mat4} out */ function translate$1(out, a, v) { var x = v[0], y = v[1], z = v[2]; var a00, a01, a02, a03; var a10, a11, a12, a13; var a20, a21, a22, a23; if (a === out) { out[12] = a[0] * x + a[4] * y + a[8] * z + a[12]; out[13] = a[1] * x + a[5] * y + a[9] * z + a[13]; out[14] = a[2] * x + a[6] * y + a[10] * z + a[14]; out[15] = a[3] * x + a[7] * y + a[11] * z + a[15]; } else { a00 = a[0]; a01 = a[1]; a02 = a[2]; a03 = a[3]; a10 = a[4]; a11 = a[5]; a12 = a[6]; a13 = a[7]; a20 = a[8]; a21 = a[9]; a22 = a[10]; a23 = a[11]; out[0] = a00; out[1] = a01; out[2] = a02; out[3] = a03; out[4] = a10; out[5] = a11; out[6] = a12; out[7] = a13; out[8] = a20; out[9] = a21; out[10] = a22; out[11] = a23; out[12] = a00 * x + a10 * y + a20 * z + a[12]; out[13] = a01 * x + a11 * y + a21 * z + a[13]; out[14] = a02 * x + a12 * y + a22 * z + a[14]; out[15] = a03 * x + a13 * y + a23 * z + a[15]; } return out; } /** * Scales the mat4 by the dimensions in the given vec3 not using vectorization * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to scale * @param {ReadonlyVec3} v the vec3 to scale the matrix by * @returns {mat4} out **/ function scale$5(out, a, v) { var x = v[0], y = v[1], z = v[2]; out[0] = a[0] * x; out[1] = a[1] * x; out[2] = a[2] * x; out[3] = a[3] * x; out[4] = a[4] * y; out[5] = a[5] * y; out[6] = a[6] * y; out[7] = a[7] * y; out[8] = a[8] * z; out[9] = a[9] * z; out[10] = a[10] * z; out[11] = a[11] * z; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; return out; } /** * Rotates a mat4 by the given angle around the given axis * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @param {ReadonlyVec3} axis the axis to rotate around * @returns {mat4} out */ function rotate$1(out, a, rad, axis) { var x = axis[0], y = axis[1], z = axis[2]; var len = Math.hypot(x, y, z); var s, c, t; var a00, a01, a02, a03; var a10, a11, a12, a13; var a20, a21, a22, a23; var b00, b01, b02; var b10, b11, b12; var b20, b21, b22; if (len < EPSILON) { return null; } len = 1 / len; x *= len; y *= len; z *= len; s = Math.sin(rad); c = Math.cos(rad); t = 1 - c; a00 = a[0]; a01 = a[1]; a02 = a[2]; a03 = a[3]; a10 = a[4]; a11 = a[5]; a12 = a[6]; a13 = a[7]; a20 = a[8]; a21 = a[9]; a22 = a[10]; a23 = a[11]; // Construct the elements of the rotation matrix b00 = x * x * t + c; b01 = y * x * t + z * s; b02 = z * x * t - y * s; b10 = x * y * t - z * s; b11 = y * y * t + c; b12 = z * y * t + x * s; b20 = x * z * t + y * s; b21 = y * z * t - x * s; b22 = z * z * t + c; // Perform rotation-specific matrix multiplication out[0] = a00 * b00 + a10 * b01 + a20 * b02; out[1] = a01 * b00 + a11 * b01 + a21 * b02; out[2] = a02 * b00 + a12 * b01 + a22 * b02; out[3] = a03 * b00 + a13 * b01 + a23 * b02; out[4] = a00 * b10 + a10 * b11 + a20 * b12; out[5] = a01 * b10 + a11 * b11 + a21 * b12; out[6] = a02 * b10 + a12 * b11 + a22 * b12; out[7] = a03 * b10 + a13 * b11 + a23 * b12; out[8] = a00 * b20 + a10 * b21 + a20 * b22; out[9] = a01 * b20 + a11 * b21 + a21 * b22; out[10] = a02 * b20 + a12 * b21 + a22 * b22; out[11] = a03 * b20 + a13 * b21 + a23 * b22; if (a !== out) { // If the source and destination differ, copy the unchanged last row out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; } return out; } /** * Rotates a matrix by the given angle around the X axis * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function rotateX$3(out, a, rad) { var s = Math.sin(rad); var c = Math.cos(rad); var a10 = a[4]; var a11 = a[5]; var a12 = a[6]; var a13 = a[7]; var a20 = a[8]; var a21 = a[9]; var a22 = a[10]; var a23 = a[11]; if (a !== out) { // If the source and destination differ, copy the unchanged rows out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; } // Perform axis-specific matrix multiplication out[4] = a10 * c + a20 * s; out[5] = a11 * c + a21 * s; out[6] = a12 * c + a22 * s; out[7] = a13 * c + a23 * s; out[8] = a20 * c - a10 * s; out[9] = a21 * c - a11 * s; out[10] = a22 * c - a12 * s; out[11] = a23 * c - a13 * s; return out; } /** * Rotates a matrix by the given angle around the Y axis * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function rotateY$3(out, a, rad) { var s = Math.sin(rad); var c = Math.cos(rad); var a00 = a[0]; var a01 = a[1]; var a02 = a[2]; var a03 = a[3]; var a20 = a[8]; var a21 = a[9]; var a22 = a[10]; var a23 = a[11]; if (a !== out) { // If the source and destination differ, copy the unchanged rows out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; } // Perform axis-specific matrix multiplication out[0] = a00 * c - a20 * s; out[1] = a01 * c - a21 * s; out[2] = a02 * c - a22 * s; out[3] = a03 * c - a23 * s; out[8] = a00 * s + a20 * c; out[9] = a01 * s + a21 * c; out[10] = a02 * s + a22 * c; out[11] = a03 * s + a23 * c; return out; } /** * Rotates a matrix by the given angle around the Z axis * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to rotate * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function rotateZ$3(out, a, rad) { var s = Math.sin(rad); var c = Math.cos(rad); var a00 = a[0]; var a01 = a[1]; var a02 = a[2]; var a03 = a[3]; var a10 = a[4]; var a11 = a[5]; var a12 = a[6]; var a13 = a[7]; if (a !== out) { // If the source and destination differ, copy the unchanged last row out[8] = a[8]; out[9] = a[9]; out[10] = a[10]; out[11] = a[11]; out[12] = a[12]; out[13] = a[13]; out[14] = a[14]; out[15] = a[15]; } // Perform axis-specific matrix multiplication out[0] = a00 * c + a10 * s; out[1] = a01 * c + a11 * s; out[2] = a02 * c + a12 * s; out[3] = a03 * c + a13 * s; out[4] = a10 * c - a00 * s; out[5] = a11 * c - a01 * s; out[6] = a12 * c - a02 * s; out[7] = a13 * c - a03 * s; return out; } /** * Creates a matrix from a vector translation * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.translate(dest, dest, vec); * * @param {mat4} out mat4 receiving operation result * @param {ReadonlyVec3} v Translation vector * @returns {mat4} out */ function fromTranslation$1(out, v) { out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = 1; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = 1; out[11] = 0; out[12] = v[0]; out[13] = v[1]; out[14] = v[2]; out[15] = 1; return out; } /** * Creates a matrix from a vector scaling * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.scale(dest, dest, vec); * * @param {mat4} out mat4 receiving operation result * @param {ReadonlyVec3} v Scaling vector * @returns {mat4} out */ function fromScaling(out, v) { out[0] = v[0]; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = v[1]; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = v[2]; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Creates a matrix from a given angle around a given axis * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.rotate(dest, dest, rad, axis); * * @param {mat4} out mat4 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @param {ReadonlyVec3} axis the axis to rotate around * @returns {mat4} out */ function fromRotation$1(out, rad, axis) { var x = axis[0], y = axis[1], z = axis[2]; var len = Math.hypot(x, y, z); var s, c, t; if (len < EPSILON) { return null; } len = 1 / len; x *= len; y *= len; z *= len; s = Math.sin(rad); c = Math.cos(rad); t = 1 - c; // Perform rotation-specific matrix multiplication out[0] = x * x * t + c; out[1] = y * x * t + z * s; out[2] = z * x * t - y * s; out[3] = 0; out[4] = x * y * t - z * s; out[5] = y * y * t + c; out[6] = z * y * t + x * s; out[7] = 0; out[8] = x * z * t + y * s; out[9] = y * z * t - x * s; out[10] = z * z * t + c; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Creates a matrix from the given angle around the X axis * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.rotateX(dest, dest, rad); * * @param {mat4} out mat4 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function fromXRotation(out, rad) { var s = Math.sin(rad); var c = Math.cos(rad); // Perform axis-specific matrix multiplication out[0] = 1; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = c; out[6] = s; out[7] = 0; out[8] = 0; out[9] = -s; out[10] = c; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Creates a matrix from the given angle around the Y axis * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.rotateY(dest, dest, rad); * * @param {mat4} out mat4 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function fromYRotation(out, rad) { var s = Math.sin(rad); var c = Math.cos(rad); // Perform axis-specific matrix multiplication out[0] = c; out[1] = 0; out[2] = -s; out[3] = 0; out[4] = 0; out[5] = 1; out[6] = 0; out[7] = 0; out[8] = s; out[9] = 0; out[10] = c; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Creates a matrix from the given angle around the Z axis * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.rotateZ(dest, dest, rad); * * @param {mat4} out mat4 receiving operation result * @param {Number} rad the angle to rotate the matrix by * @returns {mat4} out */ function fromZRotation(out, rad) { var s = Math.sin(rad); var c = Math.cos(rad); // Perform axis-specific matrix multiplication out[0] = c; out[1] = s; out[2] = 0; out[3] = 0; out[4] = -s; out[5] = c; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = 1; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Creates a matrix from a quaternion rotation and vector translation * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.translate(dest, vec); * let quatMat = mat4.create(); * quat4.toMat4(quat, quatMat); * mat4.multiply(dest, quatMat); * * @param {mat4} out mat4 receiving operation result * @param {quat4} q Rotation quaternion * @param {ReadonlyVec3} v Translation vector * @returns {mat4} out */ function fromRotationTranslation$1(out, q, v) { // Quaternion math var x = q[0], y = q[1], z = q[2], w = q[3]; var x2 = x + x; var y2 = y + y; var z2 = z + z; var xx = x * x2; var xy = x * y2; var xz = x * z2; var yy = y * y2; var yz = y * z2; var zz = z * z2; var wx = w * x2; var wy = w * y2; var wz = w * z2; out[0] = 1 - (yy + zz); out[1] = xy + wz; out[2] = xz - wy; out[3] = 0; out[4] = xy - wz; out[5] = 1 - (xx + zz); out[6] = yz + wx; out[7] = 0; out[8] = xz + wy; out[9] = yz - wx; out[10] = 1 - (xx + yy); out[11] = 0; out[12] = v[0]; out[13] = v[1]; out[14] = v[2]; out[15] = 1; return out; } /** * Creates a new mat4 from a dual quat. * * @param {mat4} out Matrix * @param {ReadonlyQuat2} a Dual Quaternion * @returns {mat4} mat4 receiving operation result */ function fromQuat2(out, a) { var translation = new ARRAY_TYPE(3); var bx = -a[0], by = -a[1], bz = -a[2], bw = a[3], ax = a[4], ay = a[5], az = a[6], aw = a[7]; var magnitude = bx * bx + by * by + bz * bz + bw * bw; //Only scale if it makes sense if (magnitude > 0) { translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2 / magnitude; translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2 / magnitude; translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2 / magnitude; } else { translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2; translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2; translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2; } fromRotationTranslation$1(out, a, translation); return out; } /** * Returns the translation vector component of a transformation * matrix. If a matrix is built with fromRotationTranslation, * the returned vector will be the same as the translation vector * originally supplied. * @param {vec3} out Vector to receive translation component * @param {ReadonlyMat4} mat Matrix to be decomposed (input) * @return {vec3} out */ function getTranslation$1(out, mat) { out[0] = mat[12]; out[1] = mat[13]; out[2] = mat[14]; return out; } /** * Returns the scaling factor component of a transformation * matrix. If a matrix is built with fromRotationTranslationScale * with a normalized Quaternion paramter, the returned vector will be * the same as the scaling vector * originally supplied. * @param {vec3} out Vector to receive scaling factor component * @param {ReadonlyMat4} mat Matrix to be decomposed (input) * @return {vec3} out */ function getScaling(out, mat) { var m11 = mat[0]; var m12 = mat[1]; var m13 = mat[2]; var m21 = mat[4]; var m22 = mat[5]; var m23 = mat[6]; var m31 = mat[8]; var m32 = mat[9]; var m33 = mat[10]; out[0] = Math.hypot(m11, m12, m13); out[1] = Math.hypot(m21, m22, m23); out[2] = Math.hypot(m31, m32, m33); return out; } /** * Returns a quaternion representing the rotational component * of a transformation matrix. If a matrix is built with * fromRotationTranslation, the returned quaternion will be the * same as the quaternion originally supplied. * @param {quat} out Quaternion to receive the rotation component * @param {ReadonlyMat4} mat Matrix to be decomposed (input) * @return {quat} out */ function getRotation(out, mat) { var scaling = new ARRAY_TYPE(3); getScaling(scaling, mat); var is1 = 1 / scaling[0]; var is2 = 1 / scaling[1]; var is3 = 1 / scaling[2]; var sm11 = mat[0] * is1; var sm12 = mat[1] * is2; var sm13 = mat[2] * is3; var sm21 = mat[4] * is1; var sm22 = mat[5] * is2; var sm23 = mat[6] * is3; var sm31 = mat[8] * is1; var sm32 = mat[9] * is2; var sm33 = mat[10] * is3; var trace = sm11 + sm22 + sm33; var S = 0; if (trace > 0) { S = Math.sqrt(trace + 1.0) * 2; out[3] = 0.25 * S; out[0] = (sm23 - sm32) / S; out[1] = (sm31 - sm13) / S; out[2] = (sm12 - sm21) / S; } else if (sm11 > sm22 && sm11 > sm33) { S = Math.sqrt(1.0 + sm11 - sm22 - sm33) * 2; out[3] = (sm23 - sm32) / S; out[0] = 0.25 * S; out[1] = (sm12 + sm21) / S; out[2] = (sm31 + sm13) / S; } else if (sm22 > sm33) { S = Math.sqrt(1.0 + sm22 - sm11 - sm33) * 2; out[3] = (sm31 - sm13) / S; out[0] = (sm12 + sm21) / S; out[1] = 0.25 * S; out[2] = (sm23 + sm32) / S; } else { S = Math.sqrt(1.0 + sm33 - sm11 - sm22) * 2; out[3] = (sm12 - sm21) / S; out[0] = (sm31 + sm13) / S; out[1] = (sm23 + sm32) / S; out[2] = 0.25 * S; } return out; } /** * Creates a matrix from a quaternion rotation, vector translation and vector scale * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.translate(dest, vec); * let quatMat = mat4.create(); * quat4.toMat4(quat, quatMat); * mat4.multiply(dest, quatMat); * mat4.scale(dest, scale) * * @param {mat4} out mat4 receiving operation result * @param {quat4} q Rotation quaternion * @param {ReadonlyVec3} v Translation vector * @param {ReadonlyVec3} s Scaling vector * @returns {mat4} out */ function fromRotationTranslationScale(out, q, v, s) { // Quaternion math var x = q[0], y = q[1], z = q[2], w = q[3]; var x2 = x + x; var y2 = y + y; var z2 = z + z; var xx = x * x2; var xy = x * y2; var xz = x * z2; var yy = y * y2; var yz = y * z2; var zz = z * z2; var wx = w * x2; var wy = w * y2; var wz = w * z2; var sx = s[0]; var sy = s[1]; var sz = s[2]; out[0] = (1 - (yy + zz)) * sx; out[1] = (xy + wz) * sx; out[2] = (xz - wy) * sx; out[3] = 0; out[4] = (xy - wz) * sy; out[5] = (1 - (xx + zz)) * sy; out[6] = (yz + wx) * sy; out[7] = 0; out[8] = (xz + wy) * sz; out[9] = (yz - wx) * sz; out[10] = (1 - (xx + yy)) * sz; out[11] = 0; out[12] = v[0]; out[13] = v[1]; out[14] = v[2]; out[15] = 1; return out; } /** * Creates a matrix from a quaternion rotation, vector translation and vector scale, rotating and scaling around the given origin * This is equivalent to (but much faster than): * * mat4.identity(dest); * mat4.translate(dest, vec); * mat4.translate(dest, origin); * let quatMat = mat4.create(); * quat4.toMat4(quat, quatMat); * mat4.multiply(dest, quatMat); * mat4.scale(dest, scale) * mat4.translate(dest, negativeOrigin); * * @param {mat4} out mat4 receiving operation result * @param {quat4} q Rotation quaternion * @param {ReadonlyVec3} v Translation vector * @param {ReadonlyVec3} s Scaling vector * @param {ReadonlyVec3} o The origin vector around which to scale and rotate * @returns {mat4} out */ function fromRotationTranslationScaleOrigin(out, q, v, s, o) { // Quaternion math var x = q[0], y = q[1], z = q[2], w = q[3]; var x2 = x + x; var y2 = y + y; var z2 = z + z; var xx = x * x2; var xy = x * y2; var xz = x * z2; var yy = y * y2; var yz = y * z2; var zz = z * z2; var wx = w * x2; var wy = w * y2; var wz = w * z2; var sx = s[0]; var sy = s[1]; var sz = s[2]; var ox = o[0]; var oy = o[1]; var oz = o[2]; var out0 = (1 - (yy + zz)) * sx; var out1 = (xy + wz) * sx; var out2 = (xz - wy) * sx; var out4 = (xy - wz) * sy; var out5 = (1 - (xx + zz)) * sy; var out6 = (yz + wx) * sy; var out8 = (xz + wy) * sz; var out9 = (yz - wx) * sz; var out10 = (1 - (xx + yy)) * sz; out[0] = out0; out[1] = out1; out[2] = out2; out[3] = 0; out[4] = out4; out[5] = out5; out[6] = out6; out[7] = 0; out[8] = out8; out[9] = out9; out[10] = out10; out[11] = 0; out[12] = v[0] + ox - (out0 * ox + out4 * oy + out8 * oz); out[13] = v[1] + oy - (out1 * ox + out5 * oy + out9 * oz); out[14] = v[2] + oz - (out2 * ox + out6 * oy + out10 * oz); out[15] = 1; return out; } /** * Calculates a 4x4 matrix from the given quaternion * * @param {mat4} out mat4 receiving operation result * @param {ReadonlyQuat} q Quaternion to create matrix from * * @returns {mat4} out */ function fromQuat(out, q) { var x = q[0], y = q[1], z = q[2], w = q[3]; var x2 = x + x; var y2 = y + y; var z2 = z + z; var xx = x * x2; var yx = y * x2; var yy = y * y2; var zx = z * x2; var zy = z * y2; var zz = z * z2; var wx = w * x2; var wy = w * y2; var wz = w * z2; out[0] = 1 - yy - zz; out[1] = yx + wz; out[2] = zx - wy; out[3] = 0; out[4] = yx - wz; out[5] = 1 - xx - zz; out[6] = zy + wx; out[7] = 0; out[8] = zx + wy; out[9] = zy - wx; out[10] = 1 - xx - yy; out[11] = 0; out[12] = 0; out[13] = 0; out[14] = 0; out[15] = 1; return out; } /** * Generates a frustum matrix with the given bounds * * @param {mat4} out mat4 frustum matrix will be written into * @param {Number} left Left bound of the frustum * @param {Number} right Right bound of the frustum * @param {Number} bottom Bottom bound of the frustum * @param {Number} top Top bound of the frustum * @param {Number} near Near bound of the frustum * @param {Number} far Far bound of the frustum * @returns {mat4} out */ function frustum(out, left, right, bottom, top, near, far) { var rl = 1 / (right - left); var tb = 1 / (top - bottom); var nf = 1 / (near - far); out[0] = near * 2 * rl; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = near * 2 * tb; out[6] = 0; out[7] = 0; out[8] = (right + left) * rl; out[9] = (top + bottom) * tb; out[10] = (far + near) * nf; out[11] = -1; out[12] = 0; out[13] = 0; out[14] = far * near * 2 * nf; out[15] = 0; return out; } /** * Generates a perspective projection matrix with the given bounds. * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1], * which matches WebGL/OpenGL's clip volume. * Passing null/undefined/no value for far will generate infinite projection matrix. * * @param {mat4} out mat4 frustum matrix will be written into * @param {number} fovy Vertical field of view in radians * @param {number} aspect Aspect ratio. typically viewport width/height * @param {number} near Near bound of the frustum * @param {number} far Far bound of the frustum, can be null or Infinity * @returns {mat4} out */ function perspectiveNO(out, fovy, aspect, near, far) { var f = 1.0 / Math.tan(fovy / 2), nf; out[0] = f / aspect; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = f; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[11] = -1; out[12] = 0; out[13] = 0; out[15] = 0; if (far != null && far !== Infinity) { nf = 1 / (near - far); out[10] = (far + near) * nf; out[14] = 2 * far * near * nf; } else { out[10] = -1; out[14] = -2 * near; } return out; } /** * Alias for {@link mat4.perspectiveNO} * @function */ var perspective = perspectiveNO; /** * Generates a perspective projection matrix suitable for WebGPU with the given bounds. * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1], * which matches WebGPU/Vulkan/DirectX/Metal's clip volume. * Passing null/undefined/no value for far will generate infinite projection matrix. * * @param {mat4} out mat4 frustum matrix will be written into * @param {number} fovy Vertical field of view in radians * @param {number} aspect Aspect ratio. typically viewport width/height * @param {number} near Near bound of the frustum * @param {number} far Far bound of the frustum, can be null or Infinity * @returns {mat4} out */ function perspectiveZO(out, fovy, aspect, near, far) { var f = 1.0 / Math.tan(fovy / 2), nf; out[0] = f / aspect; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = f; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[11] = -1; out[12] = 0; out[13] = 0; out[15] = 0; if (far != null && far !== Infinity) { nf = 1 / (near - far); out[10] = far * nf; out[14] = far * near * nf; } else { out[10] = -1; out[14] = -near; } return out; } /** * Generates a perspective projection matrix with the given field of view. * This is primarily useful for generating projection matrices to be used * with the still experiemental WebVR API. * * @param {mat4} out mat4 frustum matrix will be written into * @param {Object} fov Object containing the following values: upDegrees, downDegrees, leftDegrees, rightDegrees * @param {number} near Near bound of the frustum * @param {number} far Far bound of the frustum * @returns {mat4} out */ function perspectiveFromFieldOfView(out, fov, near, far) { var upTan = Math.tan(fov.upDegrees * Math.PI / 180.0); var downTan = Math.tan(fov.downDegrees * Math.PI / 180.0); var leftTan = Math.tan(fov.leftDegrees * Math.PI / 180.0); var rightTan = Math.tan(fov.rightDegrees * Math.PI / 180.0); var xScale = 2.0 / (leftTan + rightTan); var yScale = 2.0 / (upTan + downTan); out[0] = xScale; out[1] = 0.0; out[2] = 0.0; out[3] = 0.0; out[4] = 0.0; out[5] = yScale; out[6] = 0.0; out[7] = 0.0; out[8] = -((leftTan - rightTan) * xScale * 0.5); out[9] = (upTan - downTan) * yScale * 0.5; out[10] = far / (near - far); out[11] = -1.0; out[12] = 0.0; out[13] = 0.0; out[14] = far * near / (near - far); out[15] = 0.0; return out; } /** * Generates a orthogonal projection matrix with the given bounds. * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1], * which matches WebGL/OpenGL's clip volume. * * @param {mat4} out mat4 frustum matrix will be written into * @param {number} left Left bound of the frustum * @param {number} right Right bound of the frustum * @param {number} bottom Bottom bound of the frustum * @param {number} top Top bound of the frustum * @param {number} near Near bound of the frustum * @param {number} far Far bound of the frustum * @returns {mat4} out */ function orthoNO(out, left, right, bottom, top, near, far) { var lr = 1 / (left - right); var bt = 1 / (bottom - top); var nf = 1 / (near - far); out[0] = -2 * lr; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = -2 * bt; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = 2 * nf; out[11] = 0; out[12] = (left + right) * lr; out[13] = (top + bottom) * bt; out[14] = (far + near) * nf; out[15] = 1; return out; } /** * Alias for {@link mat4.orthoNO} * @function */ var ortho = orthoNO; /** * Generates a orthogonal projection matrix with the given bounds. * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1], * which matches WebGPU/Vulkan/DirectX/Metal's clip volume. * * @param {mat4} out mat4 frustum matrix will be written into * @param {number} left Left bound of the frustum * @param {number} right Right bound of the frustum * @param {number} bottom Bottom bound of the frustum * @param {number} top Top bound of the frustum * @param {number} near Near bound of the frustum * @param {number} far Far bound of the frustum * @returns {mat4} out */ function orthoZO(out, left, right, bottom, top, near, far) { var lr = 1 / (left - right); var bt = 1 / (bottom - top); var nf = 1 / (near - far); out[0] = -2 * lr; out[1] = 0; out[2] = 0; out[3] = 0; out[4] = 0; out[5] = -2 * bt; out[6] = 0; out[7] = 0; out[8] = 0; out[9] = 0; out[10] = nf; out[11] = 0; out[12] = (left + right) * lr; out[13] = (top + bottom) * bt; out[14] = near * nf; out[15] = 1; return out; } /** * Generates a look-at matrix with the given eye position, focal point, and up axis. * If you want a matrix that actually makes an object look at another object, you should use targetTo instead. * * @param {mat4} out mat4 frustum matrix will be written into * @param {ReadonlyVec3} eye Position of the viewer * @param {ReadonlyVec3} center Point the viewer is looking at * @param {ReadonlyVec3} up vec3 pointing up * @returns {mat4} out */ function lookAt(out, eye, center, up) { var x0, x1, x2, y0, y1, y2, z0, z1, z2, len; var eyex = eye[0]; var eyey = eye[1]; var eyez = eye[2]; var upx = up[0]; var upy = up[1]; var upz = up[2]; var centerx = center[0]; var centery = center[1]; var centerz = center[2]; if (Math.abs(eyex - centerx) < EPSILON && Math.abs(eyey - centery) < EPSILON && Math.abs(eyez - centerz) < EPSILON) { return identity$2(out); } z0 = eyex - centerx; z1 = eyey - centery; z2 = eyez - centerz; len = 1 / Math.hypot(z0, z1, z2); z0 *= len; z1 *= len; z2 *= len; x0 = upy * z2 - upz * z1; x1 = upz * z0 - upx * z2; x2 = upx * z1 - upy * z0; len = Math.hypot(x0, x1, x2); if (!len) { x0 = 0; x1 = 0; x2 = 0; } else { len = 1 / len; x0 *= len; x1 *= len; x2 *= len; } y0 = z1 * x2 - z2 * x1; y1 = z2 * x0 - z0 * x2; y2 = z0 * x1 - z1 * x0; len = Math.hypot(y0, y1, y2); if (!len) { y0 = 0; y1 = 0; y2 = 0; } else { len = 1 / len; y0 *= len; y1 *= len; y2 *= len; } out[0] = x0; out[1] = y0; out[2] = z0; out[3] = 0; out[4] = x1; out[5] = y1; out[6] = z1; out[7] = 0; out[8] = x2; out[9] = y2; out[10] = z2; out[11] = 0; out[12] = -(x0 * eyex + x1 * eyey + x2 * eyez); out[13] = -(y0 * eyex + y1 * eyey + y2 * eyez); out[14] = -(z0 * eyex + z1 * eyey + z2 * eyez); out[15] = 1; return out; } /** * Generates a matrix that makes something look at something else. * * @param {mat4} out mat4 frustum matrix will be written into * @param {ReadonlyVec3} eye Position of the viewer * @param {ReadonlyVec3} center Point the viewer is looking at * @param {ReadonlyVec3} up vec3 pointing up * @returns {mat4} out */ function targetTo(out, eye, target, up) { var eyex = eye[0], eyey = eye[1], eyez = eye[2], upx = up[0], upy = up[1], upz = up[2]; var z0 = eyex - target[0], z1 = eyey - target[1], z2 = eyez - target[2]; var len = z0 * z0 + z1 * z1 + z2 * z2; if (len > 0) { len = 1 / Math.sqrt(len); z0 *= len; z1 *= len; z2 *= len; } var x0 = upy * z2 - upz * z1, x1 = upz * z0 - upx * z2, x2 = upx * z1 - upy * z0; len = x0 * x0 + x1 * x1 + x2 * x2; if (len > 0) { len = 1 / Math.sqrt(len); x0 *= len; x1 *= len; x2 *= len; } out[0] = x0; out[1] = x1; out[2] = x2; out[3] = 0; out[4] = z1 * x2 - z2 * x1; out[5] = z2 * x0 - z0 * x2; out[6] = z0 * x1 - z1 * x0; out[7] = 0; out[8] = z0; out[9] = z1; out[10] = z2; out[11] = 0; out[12] = eyex; out[13] = eyey; out[14] = eyez; out[15] = 1; return out; } /** * Returns a string representation of a mat4 * * @param {ReadonlyMat4} a matrix to represent as a string * @returns {String} string representation of the matrix */ function str$5(a) { return "mat4(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ", " + a[4] + ", " + a[5] + ", " + a[6] + ", " + a[7] + ", " + a[8] + ", " + a[9] + ", " + a[10] + ", " + a[11] + ", " + a[12] + ", " + a[13] + ", " + a[14] + ", " + a[15] + ")"; } /** * Returns Frobenius norm of a mat4 * * @param {ReadonlyMat4} a the matrix to calculate Frobenius norm of * @returns {Number} Frobenius norm */ function frob(a) { return Math.hypot(a[0], a[1], a[2], a[3], a[4], a[5], a[6], a[7], a[8], a[9], a[10], a[11], a[12], a[13], a[14], a[15]); } /** * Adds two mat4's * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the first operand * @param {ReadonlyMat4} b the second operand * @returns {mat4} out */ function add$5(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; out[4] = a[4] + b[4]; out[5] = a[5] + b[5]; out[6] = a[6] + b[6]; out[7] = a[7] + b[7]; out[8] = a[8] + b[8]; out[9] = a[9] + b[9]; out[10] = a[10] + b[10]; out[11] = a[11] + b[11]; out[12] = a[12] + b[12]; out[13] = a[13] + b[13]; out[14] = a[14] + b[14]; out[15] = a[15] + b[15]; return out; } /** * Subtracts matrix b from matrix a * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the first operand * @param {ReadonlyMat4} b the second operand * @returns {mat4} out */ function subtract$3(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; out[3] = a[3] - b[3]; out[4] = a[4] - b[4]; out[5] = a[5] - b[5]; out[6] = a[6] - b[6]; out[7] = a[7] - b[7]; out[8] = a[8] - b[8]; out[9] = a[9] - b[9]; out[10] = a[10] - b[10]; out[11] = a[11] - b[11]; out[12] = a[12] - b[12]; out[13] = a[13] - b[13]; out[14] = a[14] - b[14]; out[15] = a[15] - b[15]; return out; } /** * Multiply each element of the matrix by a scalar. * * @param {mat4} out the receiving matrix * @param {ReadonlyMat4} a the matrix to scale * @param {Number} b amount to scale the matrix's elements by * @returns {mat4} out */ function multiplyScalar(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; out[4] = a[4] * b; out[5] = a[5] * b; out[6] = a[6] * b; out[7] = a[7] * b; out[8] = a[8] * b; out[9] = a[9] * b; out[10] = a[10] * b; out[11] = a[11] * b; out[12] = a[12] * b; out[13] = a[13] * b; out[14] = a[14] * b; out[15] = a[15] * b; return out; } /** * Adds two mat4's after multiplying each element of the second operand by a scalar value. * * @param {mat4} out the receiving vector * @param {ReadonlyMat4} a the first operand * @param {ReadonlyMat4} b the second operand * @param {Number} scale the amount to scale b's elements by before adding * @returns {mat4} out */ function multiplyScalarAndAdd(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; out[3] = a[3] + b[3] * scale; out[4] = a[4] + b[4] * scale; out[5] = a[5] + b[5] * scale; out[6] = a[6] + b[6] * scale; out[7] = a[7] + b[7] * scale; out[8] = a[8] + b[8] * scale; out[9] = a[9] + b[9] * scale; out[10] = a[10] + b[10] * scale; out[11] = a[11] + b[11] * scale; out[12] = a[12] + b[12] * scale; out[13] = a[13] + b[13] * scale; out[14] = a[14] + b[14] * scale; out[15] = a[15] + b[15] * scale; return out; } /** * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyMat4} a The first matrix. * @param {ReadonlyMat4} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function exactEquals$5(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8] && a[9] === b[9] && a[10] === b[10] && a[11] === b[11] && a[12] === b[12] && a[13] === b[13] && a[14] === b[14] && a[15] === b[15]; } /** * Returns whether or not the matrices have approximately the same elements in the same position. * * @param {ReadonlyMat4} a The first matrix. * @param {ReadonlyMat4} b The second matrix. * @returns {Boolean} True if the matrices are equal, false otherwise. */ function equals$6(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var a4 = a[4], a5 = a[5], a6 = a[6], a7 = a[7]; var a8 = a[8], a9 = a[9], a10 = a[10], a11 = a[11]; var a12 = a[12], a13 = a[13], a14 = a[14], a15 = a[15]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3]; var b4 = b[4], b5 = b[5], b6 = b[6], b7 = b[7]; var b8 = b[8], b9 = b[9], b10 = b[10], b11 = b[11]; var b12 = b[12], b13 = b[13], b14 = b[14], b15 = b[15]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8)) && Math.abs(a9 - b9) <= EPSILON * Math.max(1.0, Math.abs(a9), Math.abs(b9)) && Math.abs(a10 - b10) <= EPSILON * Math.max(1.0, Math.abs(a10), Math.abs(b10)) && Math.abs(a11 - b11) <= EPSILON * Math.max(1.0, Math.abs(a11), Math.abs(b11)) && Math.abs(a12 - b12) <= EPSILON * Math.max(1.0, Math.abs(a12), Math.abs(b12)) && Math.abs(a13 - b13) <= EPSILON * Math.max(1.0, Math.abs(a13), Math.abs(b13)) && Math.abs(a14 - b14) <= EPSILON * Math.max(1.0, Math.abs(a14), Math.abs(b14)) && Math.abs(a15 - b15) <= EPSILON * Math.max(1.0, Math.abs(a15), Math.abs(b15)); } /** * Alias for {@link mat4.multiply} * @function */ var mul$5 = multiply$5; /** * Alias for {@link mat4.subtract} * @function */ var sub$3 = subtract$3; var mat4 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$5, adjoint: adjoint, clone: clone$5, copy: copy$5, create: create$6, determinant: determinant, equals: equals$6, exactEquals: exactEquals$5, frob: frob, fromQuat: fromQuat, fromQuat2: fromQuat2, fromRotation: fromRotation$1, fromRotationTranslation: fromRotationTranslation$1, fromRotationTranslationScale: fromRotationTranslationScale, fromRotationTranslationScaleOrigin: fromRotationTranslationScaleOrigin, fromScaling: fromScaling, fromTranslation: fromTranslation$1, fromValues: fromValues$5, fromXRotation: fromXRotation, fromYRotation: fromYRotation, fromZRotation: fromZRotation, frustum: frustum, getRotation: getRotation, getScaling: getScaling, getTranslation: getTranslation$1, identity: identity$2, invert: invert$2, lookAt: lookAt, mul: mul$5, multiply: multiply$5, multiplyScalar: multiplyScalar, multiplyScalarAndAdd: multiplyScalarAndAdd, ortho: ortho, orthoNO: orthoNO, orthoZO: orthoZO, perspective: perspective, perspectiveFromFieldOfView: perspectiveFromFieldOfView, perspectiveNO: perspectiveNO, perspectiveZO: perspectiveZO, rotate: rotate$1, rotateX: rotateX$3, rotateY: rotateY$3, rotateZ: rotateZ$3, scale: scale$5, set: set$5, str: str$5, sub: sub$3, subtract: subtract$3, targetTo: targetTo, translate: translate$1, transpose: transpose }); /** * 3 Dimensional Vector * @module vec3 */ /** * Creates a new, empty vec3 * * @returns {vec3} a new 3D vector */ function create$5() { var out = new ARRAY_TYPE(3); if (ARRAY_TYPE != Float32Array) { out[0] = 0; out[1] = 0; out[2] = 0; } return out; } /** * Creates a new vec3 initialized with values from an existing vector * * @param {ReadonlyVec3} a vector to clone * @returns {vec3} a new 3D vector */ function clone$4(a) { var out = new ARRAY_TYPE(3); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; return out; } /** * Calculates the length of a vec3 * * @param {ReadonlyVec3} a vector to calculate length of * @returns {Number} length of a */ function length$4(a) { var x = a[0]; var y = a[1]; var z = a[2]; return Math.hypot(x, y, z); } /** * Creates a new vec3 initialized with the given values * * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @returns {vec3} a new 3D vector */ function fromValues$4(x, y, z) { var out = new ARRAY_TYPE(3); out[0] = x; out[1] = y; out[2] = z; return out; } /** * Copy the values from one vec3 to another * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the source vector * @returns {vec3} out */ function copy$4(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; return out; } /** * Set the components of a vec3 to the given values * * @param {vec3} out the receiving vector * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @returns {vec3} out */ function set$4(out, x, y, z) { out[0] = x; out[1] = y; out[2] = z; return out; } /** * Adds two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function add$4(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; return out; } /** * Subtracts vector b from vector a * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function subtract$2(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; return out; } /** * Multiplies two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function multiply$4(out, a, b) { out[0] = a[0] * b[0]; out[1] = a[1] * b[1]; out[2] = a[2] * b[2]; return out; } /** * Divides two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function divide$2(out, a, b) { out[0] = a[0] / b[0]; out[1] = a[1] / b[1]; out[2] = a[2] / b[2]; return out; } /** * Math.ceil the components of a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to ceil * @returns {vec3} out */ function ceil$2(out, a) { out[0] = Math.ceil(a[0]); out[1] = Math.ceil(a[1]); out[2] = Math.ceil(a[2]); return out; } /** * Math.floor the components of a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to floor * @returns {vec3} out */ function floor$2(out, a) { out[0] = Math.floor(a[0]); out[1] = Math.floor(a[1]); out[2] = Math.floor(a[2]); return out; } /** * Returns the minimum of two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function min$2(out, a, b) { out[0] = Math.min(a[0], b[0]); out[1] = Math.min(a[1], b[1]); out[2] = Math.min(a[2], b[2]); return out; } /** * Returns the maximum of two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function max$2(out, a, b) { out[0] = Math.max(a[0], b[0]); out[1] = Math.max(a[1], b[1]); out[2] = Math.max(a[2], b[2]); return out; } /** * Math.round the components of a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to round * @returns {vec3} out */ function round$2(out, a) { out[0] = Math.round(a[0]); out[1] = Math.round(a[1]); out[2] = Math.round(a[2]); return out; } /** * Scales a vec3 by a scalar number * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the vector to scale * @param {Number} b amount to scale the vector by * @returns {vec3} out */ function scale$4(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; return out; } /** * Adds two vec3's after scaling the second operand by a scalar value * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @param {Number} scale the amount to scale b by before adding * @returns {vec3} out */ function scaleAndAdd$2(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; return out; } /** * Calculates the euclidian distance between two vec3's * * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {Number} distance between a and b */ function distance$2(a, b) { var x = b[0] - a[0]; var y = b[1] - a[1]; var z = b[2] - a[2]; return Math.hypot(x, y, z); } /** * Calculates the squared euclidian distance between two vec3's * * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {Number} squared distance between a and b */ function squaredDistance$2(a, b) { var x = b[0] - a[0]; var y = b[1] - a[1]; var z = b[2] - a[2]; return x * x + y * y + z * z; } /** * Calculates the squared length of a vec3 * * @param {ReadonlyVec3} a vector to calculate squared length of * @returns {Number} squared length of a */ function squaredLength$4(a) { var x = a[0]; var y = a[1]; var z = a[2]; return x * x + y * y + z * z; } /** * Negates the components of a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to negate * @returns {vec3} out */ function negate$2(out, a) { out[0] = -a[0]; out[1] = -a[1]; out[2] = -a[2]; return out; } /** * Returns the inverse of the components of a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to invert * @returns {vec3} out */ function inverse$2(out, a) { out[0] = 1.0 / a[0]; out[1] = 1.0 / a[1]; out[2] = 1.0 / a[2]; return out; } /** * Normalize a vec3 * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a vector to normalize * @returns {vec3} out */ function normalize$4(out, a) { var x = a[0]; var y = a[1]; var z = a[2]; var len = x * x + y * y + z * z; if (len > 0) { //TODO: evaluate use of glm_invsqrt here? len = 1 / Math.sqrt(len); } out[0] = a[0] * len; out[1] = a[1] * len; out[2] = a[2] * len; return out; } /** * Calculates the dot product of two vec3's * * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {Number} dot product of a and b */ function dot$5(a, b) { return a[0] * b[0] + a[1] * b[1] + a[2] * b[2]; } /** * Computes the cross product of two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @returns {vec3} out */ function cross$2(out, a, b) { var ax = a[0], ay = a[1], az = a[2]; var bx = b[0], by = b[1], bz = b[2]; out[0] = ay * bz - az * by; out[1] = az * bx - ax * bz; out[2] = ax * by - ay * bx; return out; } /** * Performs a linear interpolation between two vec3's * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {vec3} out */ function lerp$4(out, a, b, t) { var ax = a[0]; var ay = a[1]; var az = a[2]; out[0] = ax + t * (b[0] - ax); out[1] = ay + t * (b[1] - ay); out[2] = az + t * (b[2] - az); return out; } /** * Performs a hermite interpolation with two control points * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @param {ReadonlyVec3} c the third operand * @param {ReadonlyVec3} d the fourth operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {vec3} out */ function hermite(out, a, b, c, d, t) { var factorTimes2 = t * t; var factor1 = factorTimes2 * (2 * t - 3) + 1; var factor2 = factorTimes2 * (t - 2) + t; var factor3 = factorTimes2 * (t - 1); var factor4 = factorTimes2 * (3 - 2 * t); out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4; out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4; out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4; return out; } /** * Performs a bezier interpolation with two control points * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the first operand * @param {ReadonlyVec3} b the second operand * @param {ReadonlyVec3} c the third operand * @param {ReadonlyVec3} d the fourth operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {vec3} out */ function bezier(out, a, b, c, d, t) { var inverseFactor = 1 - t; var inverseFactorTimesTwo = inverseFactor * inverseFactor; var factorTimes2 = t * t; var factor1 = inverseFactorTimesTwo * inverseFactor; var factor2 = 3 * t * inverseFactorTimesTwo; var factor3 = 3 * factorTimes2 * inverseFactor; var factor4 = factorTimes2 * t; out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4; out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4; out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4; return out; } /** * Generates a random vector with the given scale * * @param {vec3} out the receiving vector * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned * @returns {vec3} out */ function random$3(out, scale) { scale = scale || 1.0; var r = RANDOM() * 2.0 * Math.PI; var z = RANDOM() * 2.0 - 1.0; var zScale = Math.sqrt(1.0 - z * z) * scale; out[0] = Math.cos(r) * zScale; out[1] = Math.sin(r) * zScale; out[2] = z * scale; return out; } /** * Transforms the vec3 with a mat4. * 4th vector component is implicitly '1' * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the vector to transform * @param {ReadonlyMat4} m matrix to transform with * @returns {vec3} out */ function transformMat4$2(out, a, m) { var x = a[0], y = a[1], z = a[2]; var w = m[3] * x + m[7] * y + m[11] * z + m[15]; w = w || 1.0; out[0] = (m[0] * x + m[4] * y + m[8] * z + m[12]) / w; out[1] = (m[1] * x + m[5] * y + m[9] * z + m[13]) / w; out[2] = (m[2] * x + m[6] * y + m[10] * z + m[14]) / w; return out; } /** * Transforms the vec3 with a mat3. * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the vector to transform * @param {ReadonlyMat3} m the 3x3 matrix to transform with * @returns {vec3} out */ function transformMat3$1(out, a, m) { var x = a[0], y = a[1], z = a[2]; out[0] = x * m[0] + y * m[3] + z * m[6]; out[1] = x * m[1] + y * m[4] + z * m[7]; out[2] = x * m[2] + y * m[5] + z * m[8]; return out; } /** * Transforms the vec3 with a quat * Can also be used for dual quaternions. (Multiply it with the real part) * * @param {vec3} out the receiving vector * @param {ReadonlyVec3} a the vector to transform * @param {ReadonlyQuat} q quaternion to transform with * @returns {vec3} out */ function transformQuat$1(out, a, q) { // benchmarks: https://jsperf.com/quaternion-transform-vec3-implementations-fixed var qx = q[0], qy = q[1], qz = q[2], qw = q[3]; var x = a[0], y = a[1], z = a[2]; // var qvec = [qx, qy, qz]; // var uv = vec3.cross([], qvec, a); var uvx = qy * z - qz * y, uvy = qz * x - qx * z, uvz = qx * y - qy * x; // var uuv = vec3.cross([], qvec, uv); var uuvx = qy * uvz - qz * uvy, uuvy = qz * uvx - qx * uvz, uuvz = qx * uvy - qy * uvx; // vec3.scale(uv, uv, 2 * w); var w2 = qw * 2; uvx *= w2; uvy *= w2; uvz *= w2; // vec3.scale(uuv, uuv, 2); uuvx *= 2; uuvy *= 2; uuvz *= 2; // return vec3.add(out, a, vec3.add(out, uv, uuv)); out[0] = x + uvx + uuvx; out[1] = y + uvy + uuvy; out[2] = z + uvz + uuvz; return out; } /** * Rotate a 3D vector around the x-axis * @param {vec3} out The receiving vec3 * @param {ReadonlyVec3} a The vec3 point to rotate * @param {ReadonlyVec3} b The origin of the rotation * @param {Number} rad The angle of rotation in radians * @returns {vec3} out */ function rotateX$2(out, a, b, rad) { var p = [], r = []; //Translate point to the origin p[0] = a[0] - b[0]; p[1] = a[1] - b[1]; p[2] = a[2] - b[2]; //perform rotation r[0] = p[0]; r[1] = p[1] * Math.cos(rad) - p[2] * Math.sin(rad); r[2] = p[1] * Math.sin(rad) + p[2] * Math.cos(rad); //translate to correct position out[0] = r[0] + b[0]; out[1] = r[1] + b[1]; out[2] = r[2] + b[2]; return out; } /** * Rotate a 3D vector around the y-axis * @param {vec3} out The receiving vec3 * @param {ReadonlyVec3} a The vec3 point to rotate * @param {ReadonlyVec3} b The origin of the rotation * @param {Number} rad The angle of rotation in radians * @returns {vec3} out */ function rotateY$2(out, a, b, rad) { var p = [], r = []; //Translate point to the origin p[0] = a[0] - b[0]; p[1] = a[1] - b[1]; p[2] = a[2] - b[2]; //perform rotation r[0] = p[2] * Math.sin(rad) + p[0] * Math.cos(rad); r[1] = p[1]; r[2] = p[2] * Math.cos(rad) - p[0] * Math.sin(rad); //translate to correct position out[0] = r[0] + b[0]; out[1] = r[1] + b[1]; out[2] = r[2] + b[2]; return out; } /** * Rotate a 3D vector around the z-axis * @param {vec3} out The receiving vec3 * @param {ReadonlyVec3} a The vec3 point to rotate * @param {ReadonlyVec3} b The origin of the rotation * @param {Number} rad The angle of rotation in radians * @returns {vec3} out */ function rotateZ$2(out, a, b, rad) { var p = [], r = []; //Translate point to the origin p[0] = a[0] - b[0]; p[1] = a[1] - b[1]; p[2] = a[2] - b[2]; //perform rotation r[0] = p[0] * Math.cos(rad) - p[1] * Math.sin(rad); r[1] = p[0] * Math.sin(rad) + p[1] * Math.cos(rad); r[2] = p[2]; //translate to correct position out[0] = r[0] + b[0]; out[1] = r[1] + b[1]; out[2] = r[2] + b[2]; return out; } /** * Get the angle between two 3D vectors * @param {ReadonlyVec3} a The first operand * @param {ReadonlyVec3} b The second operand * @returns {Number} The angle in radians */ function angle$1(a, b) { var ax = a[0], ay = a[1], az = a[2], bx = b[0], by = b[1], bz = b[2], mag1 = Math.sqrt(ax * ax + ay * ay + az * az), mag2 = Math.sqrt(bx * bx + by * by + bz * bz), mag = mag1 * mag2, cosine = mag && dot$5(a, b) / mag; return Math.acos(Math.min(Math.max(cosine, -1), 1)); } /** * Set the components of a vec3 to zero * * @param {vec3} out the receiving vector * @returns {vec3} out */ function zero$2(out) { out[0] = 0.0; out[1] = 0.0; out[2] = 0.0; return out; } /** * Returns a string representation of a vector * * @param {ReadonlyVec3} a vector to represent as a string * @returns {String} string representation of the vector */ function str$4(a) { return "vec3(" + a[0] + ", " + a[1] + ", " + a[2] + ")"; } /** * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyVec3} a The first vector. * @param {ReadonlyVec3} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function exactEquals$4(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2]; } /** * Returns whether or not the vectors have approximately the same elements in the same position. * * @param {ReadonlyVec3} a The first vector. * @param {ReadonlyVec3} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function equals$5(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2]; var b0 = b[0], b1 = b[1], b2 = b[2]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)); } /** * Alias for {@link vec3.subtract} * @function */ var sub$2 = subtract$2; /** * Alias for {@link vec3.multiply} * @function */ var mul$4 = multiply$4; /** * Alias for {@link vec3.divide} * @function */ var div$2 = divide$2; /** * Alias for {@link vec3.distance} * @function */ var dist$2 = distance$2; /** * Alias for {@link vec3.squaredDistance} * @function */ var sqrDist$2 = squaredDistance$2; /** * Alias for {@link vec3.length} * @function */ var len$4 = length$4; /** * Alias for {@link vec3.squaredLength} * @function */ var sqrLen$4 = squaredLength$4; /** * Perform some operation over an array of vec3s. * * @param {Array} a the array of vectors to iterate over * @param {Number} stride Number of elements between the start of each vec3. If 0 assumes tightly packed * @param {Number} offset Number of elements to skip at the beginning of the array * @param {Number} count Number of vec3s to iterate over. If 0 iterates over entire array * @param {Function} fn Function to call for each vector in the array * @param {Object} [arg] additional argument to pass to fn * @returns {Array} a * @function */ var forEach$2 = function () { var vec = create$5(); return function (a, stride, offset, count, fn, arg) { var i, l; if (!stride) { stride = 3; } if (!offset) { offset = 0; } if (count) { l = Math.min(count * stride + offset, a.length); } else { l = a.length; } for (i = offset; i < l; i += stride) { vec[0] = a[i]; vec[1] = a[i + 1]; vec[2] = a[i + 2]; fn(vec, vec, arg); a[i] = vec[0]; a[i + 1] = vec[1]; a[i + 2] = vec[2]; } return a; }; }(); var vec3 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$4, angle: angle$1, bezier: bezier, ceil: ceil$2, clone: clone$4, copy: copy$4, create: create$5, cross: cross$2, dist: dist$2, distance: distance$2, div: div$2, divide: divide$2, dot: dot$5, equals: equals$5, exactEquals: exactEquals$4, floor: floor$2, forEach: forEach$2, fromValues: fromValues$4, hermite: hermite, inverse: inverse$2, len: len$4, length: length$4, lerp: lerp$4, max: max$2, min: min$2, mul: mul$4, multiply: multiply$4, negate: negate$2, normalize: normalize$4, random: random$3, rotateX: rotateX$2, rotateY: rotateY$2, rotateZ: rotateZ$2, round: round$2, scale: scale$4, scaleAndAdd: scaleAndAdd$2, set: set$4, sqrDist: sqrDist$2, sqrLen: sqrLen$4, squaredDistance: squaredDistance$2, squaredLength: squaredLength$4, str: str$4, sub: sub$2, subtract: subtract$2, transformMat3: transformMat3$1, transformMat4: transformMat4$2, transformQuat: transformQuat$1, zero: zero$2 }); /** * 4 Dimensional Vector * @module vec4 */ /** * Creates a new, empty vec4 * * @returns {vec4} a new 4D vector */ function create$4() { var out = new ARRAY_TYPE(4); if (ARRAY_TYPE != Float32Array) { out[0] = 0; out[1] = 0; out[2] = 0; out[3] = 0; } return out; } /** * Creates a new vec4 initialized with values from an existing vector * * @param {ReadonlyVec4} a vector to clone * @returns {vec4} a new 4D vector */ function clone$3(a) { var out = new ARRAY_TYPE(4); out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; return out; } /** * Creates a new vec4 initialized with the given values * * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @param {Number} w W component * @returns {vec4} a new 4D vector */ function fromValues$3(x, y, z, w) { var out = new ARRAY_TYPE(4); out[0] = x; out[1] = y; out[2] = z; out[3] = w; return out; } /** * Copy the values from one vec4 to another * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the source vector * @returns {vec4} out */ function copy$3(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; return out; } /** * Set the components of a vec4 to the given values * * @param {vec4} out the receiving vector * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @param {Number} w W component * @returns {vec4} out */ function set$3(out, x, y, z, w) { out[0] = x; out[1] = y; out[2] = z; out[3] = w; return out; } /** * Adds two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function add$3(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; return out; } /** * Subtracts vector b from vector a * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function subtract$1(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; out[2] = a[2] - b[2]; out[3] = a[3] - b[3]; return out; } /** * Multiplies two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function multiply$3(out, a, b) { out[0] = a[0] * b[0]; out[1] = a[1] * b[1]; out[2] = a[2] * b[2]; out[3] = a[3] * b[3]; return out; } /** * Divides two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function divide$1(out, a, b) { out[0] = a[0] / b[0]; out[1] = a[1] / b[1]; out[2] = a[2] / b[2]; out[3] = a[3] / b[3]; return out; } /** * Math.ceil the components of a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to ceil * @returns {vec4} out */ function ceil$1(out, a) { out[0] = Math.ceil(a[0]); out[1] = Math.ceil(a[1]); out[2] = Math.ceil(a[2]); out[3] = Math.ceil(a[3]); return out; } /** * Math.floor the components of a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to floor * @returns {vec4} out */ function floor$1(out, a) { out[0] = Math.floor(a[0]); out[1] = Math.floor(a[1]); out[2] = Math.floor(a[2]); out[3] = Math.floor(a[3]); return out; } /** * Returns the minimum of two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function min$1(out, a, b) { out[0] = Math.min(a[0], b[0]); out[1] = Math.min(a[1], b[1]); out[2] = Math.min(a[2], b[2]); out[3] = Math.min(a[3], b[3]); return out; } /** * Returns the maximum of two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {vec4} out */ function max$1(out, a, b) { out[0] = Math.max(a[0], b[0]); out[1] = Math.max(a[1], b[1]); out[2] = Math.max(a[2], b[2]); out[3] = Math.max(a[3], b[3]); return out; } /** * Math.round the components of a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to round * @returns {vec4} out */ function round$1(out, a) { out[0] = Math.round(a[0]); out[1] = Math.round(a[1]); out[2] = Math.round(a[2]); out[3] = Math.round(a[3]); return out; } /** * Scales a vec4 by a scalar number * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the vector to scale * @param {Number} b amount to scale the vector by * @returns {vec4} out */ function scale$3(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; return out; } /** * Adds two vec4's after scaling the second operand by a scalar value * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @param {Number} scale the amount to scale b by before adding * @returns {vec4} out */ function scaleAndAdd$1(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; out[2] = a[2] + b[2] * scale; out[3] = a[3] + b[3] * scale; return out; } /** * Calculates the euclidian distance between two vec4's * * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {Number} distance between a and b */ function distance$1(a, b) { var x = b[0] - a[0]; var y = b[1] - a[1]; var z = b[2] - a[2]; var w = b[3] - a[3]; return Math.hypot(x, y, z, w); } /** * Calculates the squared euclidian distance between two vec4's * * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {Number} squared distance between a and b */ function squaredDistance$1(a, b) { var x = b[0] - a[0]; var y = b[1] - a[1]; var z = b[2] - a[2]; var w = b[3] - a[3]; return x * x + y * y + z * z + w * w; } /** * Calculates the length of a vec4 * * @param {ReadonlyVec4} a vector to calculate length of * @returns {Number} length of a */ function length$3(a) { var x = a[0]; var y = a[1]; var z = a[2]; var w = a[3]; return Math.hypot(x, y, z, w); } /** * Calculates the squared length of a vec4 * * @param {ReadonlyVec4} a vector to calculate squared length of * @returns {Number} squared length of a */ function squaredLength$3(a) { var x = a[0]; var y = a[1]; var z = a[2]; var w = a[3]; return x * x + y * y + z * z + w * w; } /** * Negates the components of a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to negate * @returns {vec4} out */ function negate$1(out, a) { out[0] = -a[0]; out[1] = -a[1]; out[2] = -a[2]; out[3] = -a[3]; return out; } /** * Returns the inverse of the components of a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to invert * @returns {vec4} out */ function inverse$1(out, a) { out[0] = 1.0 / a[0]; out[1] = 1.0 / a[1]; out[2] = 1.0 / a[2]; out[3] = 1.0 / a[3]; return out; } /** * Normalize a vec4 * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a vector to normalize * @returns {vec4} out */ function normalize$3(out, a) { var x = a[0]; var y = a[1]; var z = a[2]; var w = a[3]; var len = x * x + y * y + z * z + w * w; if (len > 0) { len = 1 / Math.sqrt(len); } out[0] = x * len; out[1] = y * len; out[2] = z * len; out[3] = w * len; return out; } /** * Calculates the dot product of two vec4's * * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @returns {Number} dot product of a and b */ function dot$4(a, b) { return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3]; } /** * Returns the cross-product of three vectors in a 4-dimensional space * * @param {ReadonlyVec4} result the receiving vector * @param {ReadonlyVec4} U the first vector * @param {ReadonlyVec4} V the second vector * @param {ReadonlyVec4} W the third vector * @returns {vec4} result */ function cross$1(out, u, v, w) { var A = v[0] * w[1] - v[1] * w[0], B = v[0] * w[2] - v[2] * w[0], C = v[0] * w[3] - v[3] * w[0], D = v[1] * w[2] - v[2] * w[1], E = v[1] * w[3] - v[3] * w[1], F = v[2] * w[3] - v[3] * w[2]; var G = u[0]; var H = u[1]; var I = u[2]; var J = u[3]; out[0] = H * F - I * E + J * D; out[1] = -(G * F) + I * C - J * B; out[2] = G * E - H * C + J * A; out[3] = -(G * D) + H * B - I * A; return out; } /** * Performs a linear interpolation between two vec4's * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the first operand * @param {ReadonlyVec4} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {vec4} out */ function lerp$3(out, a, b, t) { var ax = a[0]; var ay = a[1]; var az = a[2]; var aw = a[3]; out[0] = ax + t * (b[0] - ax); out[1] = ay + t * (b[1] - ay); out[2] = az + t * (b[2] - az); out[3] = aw + t * (b[3] - aw); return out; } /** * Generates a random vector with the given scale * * @param {vec4} out the receiving vector * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned * @returns {vec4} out */ function random$2(out, scale) { scale = scale || 1.0; // Marsaglia, George. Choosing a Point from the Surface of a // Sphere. Ann. Math. Statist. 43 (1972), no. 2, 645--646. // http://projecteuclid.org/euclid.aoms/1177692644; var v1, v2, v3, v4; var s1, s2; do { v1 = RANDOM() * 2 - 1; v2 = RANDOM() * 2 - 1; s1 = v1 * v1 + v2 * v2; } while (s1 >= 1); do { v3 = RANDOM() * 2 - 1; v4 = RANDOM() * 2 - 1; s2 = v3 * v3 + v4 * v4; } while (s2 >= 1); var d = Math.sqrt((1 - s1) / s2); out[0] = scale * v1; out[1] = scale * v2; out[2] = scale * v3 * d; out[3] = scale * v4 * d; return out; } /** * Transforms the vec4 with a mat4. * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the vector to transform * @param {ReadonlyMat4} m matrix to transform with * @returns {vec4} out */ function transformMat4$1(out, a, m) { var x = a[0], y = a[1], z = a[2], w = a[3]; out[0] = m[0] * x + m[4] * y + m[8] * z + m[12] * w; out[1] = m[1] * x + m[5] * y + m[9] * z + m[13] * w; out[2] = m[2] * x + m[6] * y + m[10] * z + m[14] * w; out[3] = m[3] * x + m[7] * y + m[11] * z + m[15] * w; return out; } /** * Transforms the vec4 with a quat * * @param {vec4} out the receiving vector * @param {ReadonlyVec4} a the vector to transform * @param {ReadonlyQuat} q quaternion to transform with * @returns {vec4} out */ function transformQuat(out, a, q) { var x = a[0], y = a[1], z = a[2]; var qx = q[0], qy = q[1], qz = q[2], qw = q[3]; // calculate quat * vec var ix = qw * x + qy * z - qz * y; var iy = qw * y + qz * x - qx * z; var iz = qw * z + qx * y - qy * x; var iw = -qx * x - qy * y - qz * z; // calculate result * inverse quat out[0] = ix * qw + iw * -qx + iy * -qz - iz * -qy; out[1] = iy * qw + iw * -qy + iz * -qx - ix * -qz; out[2] = iz * qw + iw * -qz + ix * -qy - iy * -qx; out[3] = a[3]; return out; } /** * Set the components of a vec4 to zero * * @param {vec4} out the receiving vector * @returns {vec4} out */ function zero$1(out) { out[0] = 0.0; out[1] = 0.0; out[2] = 0.0; out[3] = 0.0; return out; } /** * Returns a string representation of a vector * * @param {ReadonlyVec4} a vector to represent as a string * @returns {String} string representation of the vector */ function str$3(a) { return "vec4(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ")"; } /** * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyVec4} a The first vector. * @param {ReadonlyVec4} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function exactEquals$3(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3]; } /** * Returns whether or not the vectors have approximately the same elements in the same position. * * @param {ReadonlyVec4} a The first vector. * @param {ReadonlyVec4} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function equals$4(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)); } /** * Alias for {@link vec4.subtract} * @function */ var sub$1 = subtract$1; /** * Alias for {@link vec4.multiply} * @function */ var mul$3 = multiply$3; /** * Alias for {@link vec4.divide} * @function */ var div$1 = divide$1; /** * Alias for {@link vec4.distance} * @function */ var dist$1 = distance$1; /** * Alias for {@link vec4.squaredDistance} * @function */ var sqrDist$1 = squaredDistance$1; /** * Alias for {@link vec4.length} * @function */ var len$3 = length$3; /** * Alias for {@link vec4.squaredLength} * @function */ var sqrLen$3 = squaredLength$3; /** * Perform some operation over an array of vec4s. * * @param {Array} a the array of vectors to iterate over * @param {Number} stride Number of elements between the start of each vec4. If 0 assumes tightly packed * @param {Number} offset Number of elements to skip at the beginning of the array * @param {Number} count Number of vec4s to iterate over. If 0 iterates over entire array * @param {Function} fn Function to call for each vector in the array * @param {Object} [arg] additional argument to pass to fn * @returns {Array} a * @function */ var forEach$1 = function () { var vec = create$4(); return function (a, stride, offset, count, fn, arg) { var i, l; if (!stride) { stride = 4; } if (!offset) { offset = 0; } if (count) { l = Math.min(count * stride + offset, a.length); } else { l = a.length; } for (i = offset; i < l; i += stride) { vec[0] = a[i]; vec[1] = a[i + 1]; vec[2] = a[i + 2]; vec[3] = a[i + 3]; fn(vec, vec, arg); a[i] = vec[0]; a[i + 1] = vec[1]; a[i + 2] = vec[2]; a[i + 3] = vec[3]; } return a; }; }(); var vec4 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$3, ceil: ceil$1, clone: clone$3, copy: copy$3, create: create$4, cross: cross$1, dist: dist$1, distance: distance$1, div: div$1, divide: divide$1, dot: dot$4, equals: equals$4, exactEquals: exactEquals$3, floor: floor$1, forEach: forEach$1, fromValues: fromValues$3, inverse: inverse$1, len: len$3, length: length$3, lerp: lerp$3, max: max$1, min: min$1, mul: mul$3, multiply: multiply$3, negate: negate$1, normalize: normalize$3, random: random$2, round: round$1, scale: scale$3, scaleAndAdd: scaleAndAdd$1, set: set$3, sqrDist: sqrDist$1, sqrLen: sqrLen$3, squaredDistance: squaredDistance$1, squaredLength: squaredLength$3, str: str$3, sub: sub$1, subtract: subtract$1, transformMat4: transformMat4$1, transformQuat: transformQuat, zero: zero$1 }); /** * Quaternion * @module quat */ /** * Creates a new identity quat * * @returns {quat} a new quaternion */ function create$3() { var out = new ARRAY_TYPE(4); if (ARRAY_TYPE != Float32Array) { out[0] = 0; out[1] = 0; out[2] = 0; } out[3] = 1; return out; } /** * Set a quat to the identity quaternion * * @param {quat} out the receiving quaternion * @returns {quat} out */ function identity$1(out) { out[0] = 0; out[1] = 0; out[2] = 0; out[3] = 1; return out; } /** * Sets a quat from the given angle and rotation axis, * then returns it. * * @param {quat} out the receiving quaternion * @param {ReadonlyVec3} axis the axis around which to rotate * @param {Number} rad the angle in radians * @returns {quat} out **/ function setAxisAngle(out, axis, rad) { rad = rad * 0.5; var s = Math.sin(rad); out[0] = s * axis[0]; out[1] = s * axis[1]; out[2] = s * axis[2]; out[3] = Math.cos(rad); return out; } /** * Gets the rotation axis and angle for a given * quaternion. If a quaternion is created with * setAxisAngle, this method will return the same * values as providied in the original parameter list * OR functionally equivalent values. * Example: The quaternion formed by axis [0, 0, 1] and * angle -90 is the same as the quaternion formed by * [0, 0, 1] and 270. This method favors the latter. * @param {vec3} out_axis Vector receiving the axis of rotation * @param {ReadonlyQuat} q Quaternion to be decomposed * @return {Number} Angle, in radians, of the rotation */ function getAxisAngle(out_axis, q) { var rad = Math.acos(q[3]) * 2.0; var s = Math.sin(rad / 2.0); if (s > EPSILON) { out_axis[0] = q[0] / s; out_axis[1] = q[1] / s; out_axis[2] = q[2] / s; } else { // If s is zero, return any axis (no rotation - axis does not matter) out_axis[0] = 1; out_axis[1] = 0; out_axis[2] = 0; } return rad; } /** * Gets the angular distance between two unit quaternions * * @param {ReadonlyQuat} a Origin unit quaternion * @param {ReadonlyQuat} b Destination unit quaternion * @return {Number} Angle, in radians, between the two quaternions */ function getAngle(a, b) { var dotproduct = dot$3(a, b); return Math.acos(2 * dotproduct * dotproduct - 1); } /** * Multiplies two quat's * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @returns {quat} out */ function multiply$2(out, a, b) { var ax = a[0], ay = a[1], az = a[2], aw = a[3]; var bx = b[0], by = b[1], bz = b[2], bw = b[3]; out[0] = ax * bw + aw * bx + ay * bz - az * by; out[1] = ay * bw + aw * by + az * bx - ax * bz; out[2] = az * bw + aw * bz + ax * by - ay * bx; out[3] = aw * bw - ax * bx - ay * by - az * bz; return out; } /** * Rotates a quaternion by the given angle about the X axis * * @param {quat} out quat receiving operation result * @param {ReadonlyQuat} a quat to rotate * @param {number} rad angle (in radians) to rotate * @returns {quat} out */ function rotateX$1(out, a, rad) { rad *= 0.5; var ax = a[0], ay = a[1], az = a[2], aw = a[3]; var bx = Math.sin(rad), bw = Math.cos(rad); out[0] = ax * bw + aw * bx; out[1] = ay * bw + az * bx; out[2] = az * bw - ay * bx; out[3] = aw * bw - ax * bx; return out; } /** * Rotates a quaternion by the given angle about the Y axis * * @param {quat} out quat receiving operation result * @param {ReadonlyQuat} a quat to rotate * @param {number} rad angle (in radians) to rotate * @returns {quat} out */ function rotateY$1(out, a, rad) { rad *= 0.5; var ax = a[0], ay = a[1], az = a[2], aw = a[3]; var by = Math.sin(rad), bw = Math.cos(rad); out[0] = ax * bw - az * by; out[1] = ay * bw + aw * by; out[2] = az * bw + ax * by; out[3] = aw * bw - ay * by; return out; } /** * Rotates a quaternion by the given angle about the Z axis * * @param {quat} out quat receiving operation result * @param {ReadonlyQuat} a quat to rotate * @param {number} rad angle (in radians) to rotate * @returns {quat} out */ function rotateZ$1(out, a, rad) { rad *= 0.5; var ax = a[0], ay = a[1], az = a[2], aw = a[3]; var bz = Math.sin(rad), bw = Math.cos(rad); out[0] = ax * bw + ay * bz; out[1] = ay * bw - ax * bz; out[2] = az * bw + aw * bz; out[3] = aw * bw - az * bz; return out; } /** * Calculates the W component of a quat from the X, Y, and Z components. * Assumes that quaternion is 1 unit in length. * Any existing W component will be ignored. * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate W component of * @returns {quat} out */ function calculateW(out, a) { var x = a[0], y = a[1], z = a[2]; out[0] = x; out[1] = y; out[2] = z; out[3] = Math.sqrt(Math.abs(1.0 - x * x - y * y - z * z)); return out; } /** * Calculate the exponential of a unit quaternion. * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate the exponential of * @returns {quat} out */ function exp(out, a) { var x = a[0], y = a[1], z = a[2], w = a[3]; var r = Math.sqrt(x * x + y * y + z * z); var et = Math.exp(w); var s = r > 0 ? et * Math.sin(r) / r : 0; out[0] = x * s; out[1] = y * s; out[2] = z * s; out[3] = et * Math.cos(r); return out; } /** * Calculate the natural logarithm of a unit quaternion. * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate the exponential of * @returns {quat} out */ function ln(out, a) { var x = a[0], y = a[1], z = a[2], w = a[3]; var r = Math.sqrt(x * x + y * y + z * z); var t = r > 0 ? Math.atan2(r, w) / r : 0; out[0] = x * t; out[1] = y * t; out[2] = z * t; out[3] = 0.5 * Math.log(x * x + y * y + z * z + w * w); return out; } /** * Calculate the scalar power of a unit quaternion. * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate the exponential of * @param {Number} b amount to scale the quaternion by * @returns {quat} out */ function pow(out, a, b) { ln(out, a); scale$2(out, out, b); exp(out, out); return out; } /** * Performs a spherical linear interpolation between two quat * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {quat} out */ function slerp(out, a, b, t) { // benchmarks: // http://jsperf.com/quaternion-slerp-implementations var ax = a[0], ay = a[1], az = a[2], aw = a[3]; var bx = b[0], by = b[1], bz = b[2], bw = b[3]; var omega, cosom, sinom, scale0, scale1; // calc cosine cosom = ax * bx + ay * by + az * bz + aw * bw; // adjust signs (if necessary) if (cosom < 0.0) { cosom = -cosom; bx = -bx; by = -by; bz = -bz; bw = -bw; } // calculate coefficients if (1.0 - cosom > EPSILON) { // standard case (slerp) omega = Math.acos(cosom); sinom = Math.sin(omega); scale0 = Math.sin((1.0 - t) * omega) / sinom; scale1 = Math.sin(t * omega) / sinom; } else { // "from" and "to" quaternions are very close // ... so we can do a linear interpolation scale0 = 1.0 - t; scale1 = t; } // calculate final values out[0] = scale0 * ax + scale1 * bx; out[1] = scale0 * ay + scale1 * by; out[2] = scale0 * az + scale1 * bz; out[3] = scale0 * aw + scale1 * bw; return out; } /** * Generates a random unit quaternion * * @param {quat} out the receiving quaternion * @returns {quat} out */ function random$1(out) { // Implementation of http://planning.cs.uiuc.edu/node198.html // TODO: Calling random 3 times is probably not the fastest solution var u1 = RANDOM(); var u2 = RANDOM(); var u3 = RANDOM(); var sqrt1MinusU1 = Math.sqrt(1 - u1); var sqrtU1 = Math.sqrt(u1); out[0] = sqrt1MinusU1 * Math.sin(2.0 * Math.PI * u2); out[1] = sqrt1MinusU1 * Math.cos(2.0 * Math.PI * u2); out[2] = sqrtU1 * Math.sin(2.0 * Math.PI * u3); out[3] = sqrtU1 * Math.cos(2.0 * Math.PI * u3); return out; } /** * Calculates the inverse of a quat * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate inverse of * @returns {quat} out */ function invert$1(out, a) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3]; var dot = a0 * a0 + a1 * a1 + a2 * a2 + a3 * a3; var invDot = dot ? 1.0 / dot : 0; // TODO: Would be faster to return [0,0,0,0] immediately if dot == 0 out[0] = -a0 * invDot; out[1] = -a1 * invDot; out[2] = -a2 * invDot; out[3] = a3 * invDot; return out; } /** * Calculates the conjugate of a quat * If the quaternion is normalized, this function is faster than quat.inverse and produces the same result. * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quat to calculate conjugate of * @returns {quat} out */ function conjugate$1(out, a) { out[0] = -a[0]; out[1] = -a[1]; out[2] = -a[2]; out[3] = a[3]; return out; } /** * Creates a quaternion from the given 3x3 rotation matrix. * * NOTE: The resultant quaternion is not normalized, so you should be sure * to renormalize the quaternion yourself where necessary. * * @param {quat} out the receiving quaternion * @param {ReadonlyMat3} m rotation matrix * @returns {quat} out * @function */ function fromMat3(out, m) { // Algorithm in Ken Shoemake's article in 1987 SIGGRAPH course notes // article "Quaternion Calculus and Fast Animation". var fTrace = m[0] + m[4] + m[8]; var fRoot; if (fTrace > 0.0) { // |w| > 1/2, may as well choose w > 1/2 fRoot = Math.sqrt(fTrace + 1.0); // 2w out[3] = 0.5 * fRoot; fRoot = 0.5 / fRoot; // 1/(4w) out[0] = (m[5] - m[7]) * fRoot; out[1] = (m[6] - m[2]) * fRoot; out[2] = (m[1] - m[3]) * fRoot; } else { // |w| <= 1/2 var i = 0; if (m[4] > m[0]) i = 1; if (m[8] > m[i * 3 + i]) i = 2; var j = (i + 1) % 3; var k = (i + 2) % 3; fRoot = Math.sqrt(m[i * 3 + i] - m[j * 3 + j] - m[k * 3 + k] + 1.0); out[i] = 0.5 * fRoot; fRoot = 0.5 / fRoot; out[3] = (m[j * 3 + k] - m[k * 3 + j]) * fRoot; out[j] = (m[j * 3 + i] + m[i * 3 + j]) * fRoot; out[k] = (m[k * 3 + i] + m[i * 3 + k]) * fRoot; } return out; } /** * Creates a quaternion from the given euler angle x, y, z. * * @param {quat} out the receiving quaternion * @param {x} Angle to rotate around X axis in degrees. * @param {y} Angle to rotate around Y axis in degrees. * @param {z} Angle to rotate around Z axis in degrees. * @returns {quat} out * @function */ function fromEuler(out, x, y, z) { var halfToRad = 0.5 * Math.PI / 180.0; x *= halfToRad; y *= halfToRad; z *= halfToRad; var sx = Math.sin(x); var cx = Math.cos(x); var sy = Math.sin(y); var cy = Math.cos(y); var sz = Math.sin(z); var cz = Math.cos(z); out[0] = sx * cy * cz - cx * sy * sz; out[1] = cx * sy * cz + sx * cy * sz; out[2] = cx * cy * sz - sx * sy * cz; out[3] = cx * cy * cz + sx * sy * sz; return out; } /** * Returns a string representation of a quatenion * * @param {ReadonlyQuat} a vector to represent as a string * @returns {String} string representation of the vector */ function str$2(a) { return "quat(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ")"; } /** * Creates a new quat initialized with values from an existing quaternion * * @param {ReadonlyQuat} a quaternion to clone * @returns {quat} a new quaternion * @function */ var clone$2 = clone$3; /** * Creates a new quat initialized with the given values * * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @param {Number} w W component * @returns {quat} a new quaternion * @function */ var fromValues$2 = fromValues$3; /** * Copy the values from one quat to another * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the source quaternion * @returns {quat} out * @function */ var copy$2 = copy$3; /** * Set the components of a quat to the given values * * @param {quat} out the receiving quaternion * @param {Number} x X component * @param {Number} y Y component * @param {Number} z Z component * @param {Number} w W component * @returns {quat} out * @function */ var set$2 = set$3; /** * Adds two quat's * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @returns {quat} out * @function */ var add$2 = add$3; /** * Alias for {@link quat.multiply} * @function */ var mul$2 = multiply$2; /** * Scales a quat by a scalar number * * @param {quat} out the receiving vector * @param {ReadonlyQuat} a the vector to scale * @param {Number} b amount to scale the vector by * @returns {quat} out * @function */ var scale$2 = scale$3; /** * Calculates the dot product of two quat's * * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @returns {Number} dot product of a and b * @function */ var dot$3 = dot$4; /** * Performs a linear interpolation between two quat's * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {quat} out * @function */ var lerp$2 = lerp$3; /** * Calculates the length of a quat * * @param {ReadonlyQuat} a vector to calculate length of * @returns {Number} length of a */ var length$2 = length$3; /** * Alias for {@link quat.length} * @function */ var len$2 = length$2; /** * Calculates the squared length of a quat * * @param {ReadonlyQuat} a vector to calculate squared length of * @returns {Number} squared length of a * @function */ var squaredLength$2 = squaredLength$3; /** * Alias for {@link quat.squaredLength} * @function */ var sqrLen$2 = squaredLength$2; /** * Normalize a quat * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a quaternion to normalize * @returns {quat} out * @function */ var normalize$2 = normalize$3; /** * Returns whether or not the quaternions have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyQuat} a The first quaternion. * @param {ReadonlyQuat} b The second quaternion. * @returns {Boolean} True if the vectors are equal, false otherwise. */ var exactEquals$2 = exactEquals$3; /** * Returns whether or not the quaternions have approximately the same elements in the same position. * * @param {ReadonlyQuat} a The first vector. * @param {ReadonlyQuat} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ var equals$3 = equals$4; /** * Sets a quaternion to represent the shortest rotation from one * vector to another. * * Both vectors are assumed to be unit length. * * @param {quat} out the receiving quaternion. * @param {ReadonlyVec3} a the initial vector * @param {ReadonlyVec3} b the destination vector * @returns {quat} out */ var rotationTo = function () { var tmpvec3 = create$5(); var xUnitVec3 = fromValues$4(1, 0, 0); var yUnitVec3 = fromValues$4(0, 1, 0); return function (out, a, b) { var dot = dot$5(a, b); if (dot < -0.999999) { cross$2(tmpvec3, xUnitVec3, a); if (len$4(tmpvec3) < 0.000001) cross$2(tmpvec3, yUnitVec3, a); normalize$4(tmpvec3, tmpvec3); setAxisAngle(out, tmpvec3, Math.PI); return out; } else if (dot > 0.999999) { out[0] = 0; out[1] = 0; out[2] = 0; out[3] = 1; return out; } else { cross$2(tmpvec3, a, b); out[0] = tmpvec3[0]; out[1] = tmpvec3[1]; out[2] = tmpvec3[2]; out[3] = 1 + dot; return normalize$2(out, out); } }; }(); /** * Performs a spherical linear interpolation with two control points * * @param {quat} out the receiving quaternion * @param {ReadonlyQuat} a the first operand * @param {ReadonlyQuat} b the second operand * @param {ReadonlyQuat} c the third operand * @param {ReadonlyQuat} d the fourth operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {quat} out */ var sqlerp = function () { var temp1 = create$3(); var temp2 = create$3(); return function (out, a, b, c, d, t) { slerp(temp1, a, d, t); slerp(temp2, b, c, t); slerp(out, temp1, temp2, 2 * t * (1 - t)); return out; }; }(); /** * Sets the specified quaternion with values corresponding to the given * axes. Each axis is a vec3 and is expected to be unit length and * perpendicular to all other specified axes. * * @param {ReadonlyVec3} view the vector representing the viewing direction * @param {ReadonlyVec3} right the vector representing the local "right" direction * @param {ReadonlyVec3} up the vector representing the local "up" direction * @returns {quat} out */ var setAxes = function () { var matr = create$7(); return function (out, view, right, up) { matr[0] = right[0]; matr[3] = right[1]; matr[6] = right[2]; matr[1] = up[0]; matr[4] = up[1]; matr[7] = up[2]; matr[2] = -view[0]; matr[5] = -view[1]; matr[8] = -view[2]; return normalize$2(out, fromMat3(out, matr)); }; }(); var quat = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$2, calculateW: calculateW, clone: clone$2, conjugate: conjugate$1, copy: copy$2, create: create$3, dot: dot$3, equals: equals$3, exactEquals: exactEquals$2, exp: exp, fromEuler: fromEuler, fromMat3: fromMat3, fromValues: fromValues$2, getAngle: getAngle, getAxisAngle: getAxisAngle, identity: identity$1, invert: invert$1, len: len$2, length: length$2, lerp: lerp$2, ln: ln, mul: mul$2, multiply: multiply$2, normalize: normalize$2, pow: pow, random: random$1, rotateX: rotateX$1, rotateY: rotateY$1, rotateZ: rotateZ$1, rotationTo: rotationTo, scale: scale$2, set: set$2, setAxes: setAxes, setAxisAngle: setAxisAngle, slerp: slerp, sqlerp: sqlerp, sqrLen: sqrLen$2, squaredLength: squaredLength$2, str: str$2 }); /** * Dual Quaternion
* Format: [real, dual]
* Quaternion format: XYZW
* Make sure to have normalized dual quaternions, otherwise the functions may not work as intended.
* @module quat2 */ /** * Creates a new identity dual quat * * @returns {quat2} a new dual quaternion [real -> rotation, dual -> translation] */ function create$2() { var dq = new ARRAY_TYPE(8); if (ARRAY_TYPE != Float32Array) { dq[0] = 0; dq[1] = 0; dq[2] = 0; dq[4] = 0; dq[5] = 0; dq[6] = 0; dq[7] = 0; } dq[3] = 1; return dq; } /** * Creates a new quat initialized with values from an existing quaternion * * @param {ReadonlyQuat2} a dual quaternion to clone * @returns {quat2} new dual quaternion * @function */ function clone$1(a) { var dq = new ARRAY_TYPE(8); dq[0] = a[0]; dq[1] = a[1]; dq[2] = a[2]; dq[3] = a[3]; dq[4] = a[4]; dq[5] = a[5]; dq[6] = a[6]; dq[7] = a[7]; return dq; } /** * Creates a new dual quat initialized with the given values * * @param {Number} x1 X component * @param {Number} y1 Y component * @param {Number} z1 Z component * @param {Number} w1 W component * @param {Number} x2 X component * @param {Number} y2 Y component * @param {Number} z2 Z component * @param {Number} w2 W component * @returns {quat2} new dual quaternion * @function */ function fromValues$1(x1, y1, z1, w1, x2, y2, z2, w2) { var dq = new ARRAY_TYPE(8); dq[0] = x1; dq[1] = y1; dq[2] = z1; dq[3] = w1; dq[4] = x2; dq[5] = y2; dq[6] = z2; dq[7] = w2; return dq; } /** * Creates a new dual quat from the given values (quat and translation) * * @param {Number} x1 X component * @param {Number} y1 Y component * @param {Number} z1 Z component * @param {Number} w1 W component * @param {Number} x2 X component (translation) * @param {Number} y2 Y component (translation) * @param {Number} z2 Z component (translation) * @returns {quat2} new dual quaternion * @function */ function fromRotationTranslationValues(x1, y1, z1, w1, x2, y2, z2) { var dq = new ARRAY_TYPE(8); dq[0] = x1; dq[1] = y1; dq[2] = z1; dq[3] = w1; var ax = x2 * 0.5, ay = y2 * 0.5, az = z2 * 0.5; dq[4] = ax * w1 + ay * z1 - az * y1; dq[5] = ay * w1 + az * x1 - ax * z1; dq[6] = az * w1 + ax * y1 - ay * x1; dq[7] = -ax * x1 - ay * y1 - az * z1; return dq; } /** * Creates a dual quat from a quaternion and a translation * * @param {ReadonlyQuat2} dual quaternion receiving operation result * @param {ReadonlyQuat} q a normalized quaternion * @param {ReadonlyVec3} t tranlation vector * @returns {quat2} dual quaternion receiving operation result * @function */ function fromRotationTranslation(out, q, t) { var ax = t[0] * 0.5, ay = t[1] * 0.5, az = t[2] * 0.5, bx = q[0], by = q[1], bz = q[2], bw = q[3]; out[0] = bx; out[1] = by; out[2] = bz; out[3] = bw; out[4] = ax * bw + ay * bz - az * by; out[5] = ay * bw + az * bx - ax * bz; out[6] = az * bw + ax * by - ay * bx; out[7] = -ax * bx - ay * by - az * bz; return out; } /** * Creates a dual quat from a translation * * @param {ReadonlyQuat2} dual quaternion receiving operation result * @param {ReadonlyVec3} t translation vector * @returns {quat2} dual quaternion receiving operation result * @function */ function fromTranslation(out, t) { out[0] = 0; out[1] = 0; out[2] = 0; out[3] = 1; out[4] = t[0] * 0.5; out[5] = t[1] * 0.5; out[6] = t[2] * 0.5; out[7] = 0; return out; } /** * Creates a dual quat from a quaternion * * @param {ReadonlyQuat2} dual quaternion receiving operation result * @param {ReadonlyQuat} q the quaternion * @returns {quat2} dual quaternion receiving operation result * @function */ function fromRotation(out, q) { out[0] = q[0]; out[1] = q[1]; out[2] = q[2]; out[3] = q[3]; out[4] = 0; out[5] = 0; out[6] = 0; out[7] = 0; return out; } /** * Creates a new dual quat from a matrix (4x4) * * @param {quat2} out the dual quaternion * @param {ReadonlyMat4} a the matrix * @returns {quat2} dual quat receiving operation result * @function */ function fromMat4(out, a) { //TODO Optimize this var outer = create$3(); getRotation(outer, a); var t = new ARRAY_TYPE(3); getTranslation$1(t, a); fromRotationTranslation(out, outer, t); return out; } /** * Copy the values from one dual quat to another * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the source dual quaternion * @returns {quat2} out * @function */ function copy$1(out, a) { out[0] = a[0]; out[1] = a[1]; out[2] = a[2]; out[3] = a[3]; out[4] = a[4]; out[5] = a[5]; out[6] = a[6]; out[7] = a[7]; return out; } /** * Set a dual quat to the identity dual quaternion * * @param {quat2} out the receiving quaternion * @returns {quat2} out */ function identity(out) { out[0] = 0; out[1] = 0; out[2] = 0; out[3] = 1; out[4] = 0; out[5] = 0; out[6] = 0; out[7] = 0; return out; } /** * Set the components of a dual quat to the given values * * @param {quat2} out the receiving quaternion * @param {Number} x1 X component * @param {Number} y1 Y component * @param {Number} z1 Z component * @param {Number} w1 W component * @param {Number} x2 X component * @param {Number} y2 Y component * @param {Number} z2 Z component * @param {Number} w2 W component * @returns {quat2} out * @function */ function set$1(out, x1, y1, z1, w1, x2, y2, z2, w2) { out[0] = x1; out[1] = y1; out[2] = z1; out[3] = w1; out[4] = x2; out[5] = y2; out[6] = z2; out[7] = w2; return out; } /** * Gets the real part of a dual quat * @param {quat} out real part * @param {ReadonlyQuat2} a Dual Quaternion * @return {quat} real part */ var getReal = copy$2; /** * Gets the dual part of a dual quat * @param {quat} out dual part * @param {ReadonlyQuat2} a Dual Quaternion * @return {quat} dual part */ function getDual(out, a) { out[0] = a[4]; out[1] = a[5]; out[2] = a[6]; out[3] = a[7]; return out; } /** * Set the real component of a dual quat to the given quaternion * * @param {quat2} out the receiving quaternion * @param {ReadonlyQuat} q a quaternion representing the real part * @returns {quat2} out * @function */ var setReal = copy$2; /** * Set the dual component of a dual quat to the given quaternion * * @param {quat2} out the receiving quaternion * @param {ReadonlyQuat} q a quaternion representing the dual part * @returns {quat2} out * @function */ function setDual(out, q) { out[4] = q[0]; out[5] = q[1]; out[6] = q[2]; out[7] = q[3]; return out; } /** * Gets the translation of a normalized dual quat * @param {vec3} out translation * @param {ReadonlyQuat2} a Dual Quaternion to be decomposed * @return {vec3} translation */ function getTranslation(out, a) { var ax = a[4], ay = a[5], az = a[6], aw = a[7], bx = -a[0], by = -a[1], bz = -a[2], bw = a[3]; out[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2; out[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2; out[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2; return out; } /** * Translates a dual quat by the given vector * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to translate * @param {ReadonlyVec3} v vector to translate by * @returns {quat2} out */ function translate(out, a, v) { var ax1 = a[0], ay1 = a[1], az1 = a[2], aw1 = a[3], bx1 = v[0] * 0.5, by1 = v[1] * 0.5, bz1 = v[2] * 0.5, ax2 = a[4], ay2 = a[5], az2 = a[6], aw2 = a[7]; out[0] = ax1; out[1] = ay1; out[2] = az1; out[3] = aw1; out[4] = aw1 * bx1 + ay1 * bz1 - az1 * by1 + ax2; out[5] = aw1 * by1 + az1 * bx1 - ax1 * bz1 + ay2; out[6] = aw1 * bz1 + ax1 * by1 - ay1 * bx1 + az2; out[7] = -ax1 * bx1 - ay1 * by1 - az1 * bz1 + aw2; return out; } /** * Rotates a dual quat around the X axis * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to rotate * @param {number} rad how far should the rotation be * @returns {quat2} out */ function rotateX(out, a, rad) { var bx = -a[0], by = -a[1], bz = -a[2], bw = a[3], ax = a[4], ay = a[5], az = a[6], aw = a[7], ax1 = ax * bw + aw * bx + ay * bz - az * by, ay1 = ay * bw + aw * by + az * bx - ax * bz, az1 = az * bw + aw * bz + ax * by - ay * bx, aw1 = aw * bw - ax * bx - ay * by - az * bz; rotateX$1(out, a, rad); bx = out[0]; by = out[1]; bz = out[2]; bw = out[3]; out[4] = ax1 * bw + aw1 * bx + ay1 * bz - az1 * by; out[5] = ay1 * bw + aw1 * by + az1 * bx - ax1 * bz; out[6] = az1 * bw + aw1 * bz + ax1 * by - ay1 * bx; out[7] = aw1 * bw - ax1 * bx - ay1 * by - az1 * bz; return out; } /** * Rotates a dual quat around the Y axis * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to rotate * @param {number} rad how far should the rotation be * @returns {quat2} out */ function rotateY(out, a, rad) { var bx = -a[0], by = -a[1], bz = -a[2], bw = a[3], ax = a[4], ay = a[5], az = a[6], aw = a[7], ax1 = ax * bw + aw * bx + ay * bz - az * by, ay1 = ay * bw + aw * by + az * bx - ax * bz, az1 = az * bw + aw * bz + ax * by - ay * bx, aw1 = aw * bw - ax * bx - ay * by - az * bz; rotateY$1(out, a, rad); bx = out[0]; by = out[1]; bz = out[2]; bw = out[3]; out[4] = ax1 * bw + aw1 * bx + ay1 * bz - az1 * by; out[5] = ay1 * bw + aw1 * by + az1 * bx - ax1 * bz; out[6] = az1 * bw + aw1 * bz + ax1 * by - ay1 * bx; out[7] = aw1 * bw - ax1 * bx - ay1 * by - az1 * bz; return out; } /** * Rotates a dual quat around the Z axis * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to rotate * @param {number} rad how far should the rotation be * @returns {quat2} out */ function rotateZ(out, a, rad) { var bx = -a[0], by = -a[1], bz = -a[2], bw = a[3], ax = a[4], ay = a[5], az = a[6], aw = a[7], ax1 = ax * bw + aw * bx + ay * bz - az * by, ay1 = ay * bw + aw * by + az * bx - ax * bz, az1 = az * bw + aw * bz + ax * by - ay * bx, aw1 = aw * bw - ax * bx - ay * by - az * bz; rotateZ$1(out, a, rad); bx = out[0]; by = out[1]; bz = out[2]; bw = out[3]; out[4] = ax1 * bw + aw1 * bx + ay1 * bz - az1 * by; out[5] = ay1 * bw + aw1 * by + az1 * bx - ax1 * bz; out[6] = az1 * bw + aw1 * bz + ax1 * by - ay1 * bx; out[7] = aw1 * bw - ax1 * bx - ay1 * by - az1 * bz; return out; } /** * Rotates a dual quat by a given quaternion (a * q) * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to rotate * @param {ReadonlyQuat} q quaternion to rotate by * @returns {quat2} out */ function rotateByQuatAppend(out, a, q) { var qx = q[0], qy = q[1], qz = q[2], qw = q[3], ax = a[0], ay = a[1], az = a[2], aw = a[3]; out[0] = ax * qw + aw * qx + ay * qz - az * qy; out[1] = ay * qw + aw * qy + az * qx - ax * qz; out[2] = az * qw + aw * qz + ax * qy - ay * qx; out[3] = aw * qw - ax * qx - ay * qy - az * qz; ax = a[4]; ay = a[5]; az = a[6]; aw = a[7]; out[4] = ax * qw + aw * qx + ay * qz - az * qy; out[5] = ay * qw + aw * qy + az * qx - ax * qz; out[6] = az * qw + aw * qz + ax * qy - ay * qx; out[7] = aw * qw - ax * qx - ay * qy - az * qz; return out; } /** * Rotates a dual quat by a given quaternion (q * a) * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat} q quaternion to rotate by * @param {ReadonlyQuat2} a the dual quaternion to rotate * @returns {quat2} out */ function rotateByQuatPrepend(out, q, a) { var qx = q[0], qy = q[1], qz = q[2], qw = q[3], bx = a[0], by = a[1], bz = a[2], bw = a[3]; out[0] = qx * bw + qw * bx + qy * bz - qz * by; out[1] = qy * bw + qw * by + qz * bx - qx * bz; out[2] = qz * bw + qw * bz + qx * by - qy * bx; out[3] = qw * bw - qx * bx - qy * by - qz * bz; bx = a[4]; by = a[5]; bz = a[6]; bw = a[7]; out[4] = qx * bw + qw * bx + qy * bz - qz * by; out[5] = qy * bw + qw * by + qz * bx - qx * bz; out[6] = qz * bw + qw * bz + qx * by - qy * bx; out[7] = qw * bw - qx * bx - qy * by - qz * bz; return out; } /** * Rotates a dual quat around a given axis. Does the normalisation automatically * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the dual quaternion to rotate * @param {ReadonlyVec3} axis the axis to rotate around * @param {Number} rad how far the rotation should be * @returns {quat2} out */ function rotateAroundAxis(out, a, axis, rad) { //Special case for rad = 0 if (Math.abs(rad) < EPSILON) { return copy$1(out, a); } var axisLength = Math.hypot(axis[0], axis[1], axis[2]); rad = rad * 0.5; var s = Math.sin(rad); var bx = s * axis[0] / axisLength; var by = s * axis[1] / axisLength; var bz = s * axis[2] / axisLength; var bw = Math.cos(rad); var ax1 = a[0], ay1 = a[1], az1 = a[2], aw1 = a[3]; out[0] = ax1 * bw + aw1 * bx + ay1 * bz - az1 * by; out[1] = ay1 * bw + aw1 * by + az1 * bx - ax1 * bz; out[2] = az1 * bw + aw1 * bz + ax1 * by - ay1 * bx; out[3] = aw1 * bw - ax1 * bx - ay1 * by - az1 * bz; var ax = a[4], ay = a[5], az = a[6], aw = a[7]; out[4] = ax * bw + aw * bx + ay * bz - az * by; out[5] = ay * bw + aw * by + az * bx - ax * bz; out[6] = az * bw + aw * bz + ax * by - ay * bx; out[7] = aw * bw - ax * bx - ay * by - az * bz; return out; } /** * Adds two dual quat's * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the first operand * @param {ReadonlyQuat2} b the second operand * @returns {quat2} out * @function */ function add$1(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; out[2] = a[2] + b[2]; out[3] = a[3] + b[3]; out[4] = a[4] + b[4]; out[5] = a[5] + b[5]; out[6] = a[6] + b[6]; out[7] = a[7] + b[7]; return out; } /** * Multiplies two dual quat's * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a the first operand * @param {ReadonlyQuat2} b the second operand * @returns {quat2} out */ function multiply$1(out, a, b) { var ax0 = a[0], ay0 = a[1], az0 = a[2], aw0 = a[3], bx1 = b[4], by1 = b[5], bz1 = b[6], bw1 = b[7], ax1 = a[4], ay1 = a[5], az1 = a[6], aw1 = a[7], bx0 = b[0], by0 = b[1], bz0 = b[2], bw0 = b[3]; out[0] = ax0 * bw0 + aw0 * bx0 + ay0 * bz0 - az0 * by0; out[1] = ay0 * bw0 + aw0 * by0 + az0 * bx0 - ax0 * bz0; out[2] = az0 * bw0 + aw0 * bz0 + ax0 * by0 - ay0 * bx0; out[3] = aw0 * bw0 - ax0 * bx0 - ay0 * by0 - az0 * bz0; out[4] = ax0 * bw1 + aw0 * bx1 + ay0 * bz1 - az0 * by1 + ax1 * bw0 + aw1 * bx0 + ay1 * bz0 - az1 * by0; out[5] = ay0 * bw1 + aw0 * by1 + az0 * bx1 - ax0 * bz1 + ay1 * bw0 + aw1 * by0 + az1 * bx0 - ax1 * bz0; out[6] = az0 * bw1 + aw0 * bz1 + ax0 * by1 - ay0 * bx1 + az1 * bw0 + aw1 * bz0 + ax1 * by0 - ay1 * bx0; out[7] = aw0 * bw1 - ax0 * bx1 - ay0 * by1 - az0 * bz1 + aw1 * bw0 - ax1 * bx0 - ay1 * by0 - az1 * bz0; return out; } /** * Alias for {@link quat2.multiply} * @function */ var mul$1 = multiply$1; /** * Scales a dual quat by a scalar number * * @param {quat2} out the receiving dual quat * @param {ReadonlyQuat2} a the dual quat to scale * @param {Number} b amount to scale the dual quat by * @returns {quat2} out * @function */ function scale$1(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; out[2] = a[2] * b; out[3] = a[3] * b; out[4] = a[4] * b; out[5] = a[5] * b; out[6] = a[6] * b; out[7] = a[7] * b; return out; } /** * Calculates the dot product of two dual quat's (The dot product of the real parts) * * @param {ReadonlyQuat2} a the first operand * @param {ReadonlyQuat2} b the second operand * @returns {Number} dot product of a and b * @function */ var dot$2 = dot$3; /** * Performs a linear interpolation between two dual quats's * NOTE: The resulting dual quaternions won't always be normalized (The error is most noticeable when t = 0.5) * * @param {quat2} out the receiving dual quat * @param {ReadonlyQuat2} a the first operand * @param {ReadonlyQuat2} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {quat2} out */ function lerp$1(out, a, b, t) { var mt = 1 - t; if (dot$2(a, b) < 0) t = -t; out[0] = a[0] * mt + b[0] * t; out[1] = a[1] * mt + b[1] * t; out[2] = a[2] * mt + b[2] * t; out[3] = a[3] * mt + b[3] * t; out[4] = a[4] * mt + b[4] * t; out[5] = a[5] * mt + b[5] * t; out[6] = a[6] * mt + b[6] * t; out[7] = a[7] * mt + b[7] * t; return out; } /** * Calculates the inverse of a dual quat. If they are normalized, conjugate is cheaper * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a dual quat to calculate inverse of * @returns {quat2} out */ function invert(out, a) { var sqlen = squaredLength$1(a); out[0] = -a[0] / sqlen; out[1] = -a[1] / sqlen; out[2] = -a[2] / sqlen; out[3] = a[3] / sqlen; out[4] = -a[4] / sqlen; out[5] = -a[5] / sqlen; out[6] = -a[6] / sqlen; out[7] = a[7] / sqlen; return out; } /** * Calculates the conjugate of a dual quat * If the dual quaternion is normalized, this function is faster than quat2.inverse and produces the same result. * * @param {quat2} out the receiving quaternion * @param {ReadonlyQuat2} a quat to calculate conjugate of * @returns {quat2} out */ function conjugate(out, a) { out[0] = -a[0]; out[1] = -a[1]; out[2] = -a[2]; out[3] = a[3]; out[4] = -a[4]; out[5] = -a[5]; out[6] = -a[6]; out[7] = a[7]; return out; } /** * Calculates the length of a dual quat * * @param {ReadonlyQuat2} a dual quat to calculate length of * @returns {Number} length of a * @function */ var length$1 = length$2; /** * Alias for {@link quat2.length} * @function */ var len$1 = length$1; /** * Calculates the squared length of a dual quat * * @param {ReadonlyQuat2} a dual quat to calculate squared length of * @returns {Number} squared length of a * @function */ var squaredLength$1 = squaredLength$2; /** * Alias for {@link quat2.squaredLength} * @function */ var sqrLen$1 = squaredLength$1; /** * Normalize a dual quat * * @param {quat2} out the receiving dual quaternion * @param {ReadonlyQuat2} a dual quaternion to normalize * @returns {quat2} out * @function */ function normalize$1(out, a) { var magnitude = squaredLength$1(a); if (magnitude > 0) { magnitude = Math.sqrt(magnitude); var a0 = a[0] / magnitude; var a1 = a[1] / magnitude; var a2 = a[2] / magnitude; var a3 = a[3] / magnitude; var b0 = a[4]; var b1 = a[5]; var b2 = a[6]; var b3 = a[7]; var a_dot_b = a0 * b0 + a1 * b1 + a2 * b2 + a3 * b3; out[0] = a0; out[1] = a1; out[2] = a2; out[3] = a3; out[4] = (b0 - a0 * a_dot_b) / magnitude; out[5] = (b1 - a1 * a_dot_b) / magnitude; out[6] = (b2 - a2 * a_dot_b) / magnitude; out[7] = (b3 - a3 * a_dot_b) / magnitude; } return out; } /** * Returns a string representation of a dual quatenion * * @param {ReadonlyQuat2} a dual quaternion to represent as a string * @returns {String} string representation of the dual quat */ function str$1(a) { return "quat2(" + a[0] + ", " + a[1] + ", " + a[2] + ", " + a[3] + ", " + a[4] + ", " + a[5] + ", " + a[6] + ", " + a[7] + ")"; } /** * Returns whether or not the dual quaternions have exactly the same elements in the same position (when compared with ===) * * @param {ReadonlyQuat2} a the first dual quaternion. * @param {ReadonlyQuat2} b the second dual quaternion. * @returns {Boolean} true if the dual quaternions are equal, false otherwise. */ function exactEquals$1(a, b) { return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7]; } /** * Returns whether or not the dual quaternions have approximately the same elements in the same position. * * @param {ReadonlyQuat2} a the first dual quat. * @param {ReadonlyQuat2} b the second dual quat. * @returns {Boolean} true if the dual quats are equal, false otherwise. */ function equals$2(a, b) { var a0 = a[0], a1 = a[1], a2 = a[2], a3 = a[3], a4 = a[4], a5 = a[5], a6 = a[6], a7 = a[7]; var b0 = b[0], b1 = b[1], b2 = b[2], b3 = b[3], b4 = b[4], b5 = b[5], b6 = b[6], b7 = b[7]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)); } var quat2 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add$1, clone: clone$1, conjugate: conjugate, copy: copy$1, create: create$2, dot: dot$2, equals: equals$2, exactEquals: exactEquals$1, fromMat4: fromMat4, fromRotation: fromRotation, fromRotationTranslation: fromRotationTranslation, fromRotationTranslationValues: fromRotationTranslationValues, fromTranslation: fromTranslation, fromValues: fromValues$1, getDual: getDual, getReal: getReal, getTranslation: getTranslation, identity: identity, invert: invert, len: len$1, length: length$1, lerp: lerp$1, mul: mul$1, multiply: multiply$1, normalize: normalize$1, rotateAroundAxis: rotateAroundAxis, rotateByQuatAppend: rotateByQuatAppend, rotateByQuatPrepend: rotateByQuatPrepend, rotateX: rotateX, rotateY: rotateY, rotateZ: rotateZ, scale: scale$1, set: set$1, setDual: setDual, setReal: setReal, sqrLen: sqrLen$1, squaredLength: squaredLength$1, str: str$1, translate: translate }); /** * 2 Dimensional Vector * @module vec2 */ /** * Creates a new, empty vec2 * * @returns {vec2} a new 2D vector */ function create$1() { var out = new ARRAY_TYPE(2); if (ARRAY_TYPE != Float32Array) { out[0] = 0; out[1] = 0; } return out; } /** * Creates a new vec2 initialized with values from an existing vector * * @param {ReadonlyVec2} a vector to clone * @returns {vec2} a new 2D vector */ function clone(a) { var out = new ARRAY_TYPE(2); out[0] = a[0]; out[1] = a[1]; return out; } /** * Creates a new vec2 initialized with the given values * * @param {Number} x X component * @param {Number} y Y component * @returns {vec2} a new 2D vector */ function fromValues(x, y) { var out = new ARRAY_TYPE(2); out[0] = x; out[1] = y; return out; } /** * Copy the values from one vec2 to another * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the source vector * @returns {vec2} out */ function copy(out, a) { out[0] = a[0]; out[1] = a[1]; return out; } /** * Set the components of a vec2 to the given values * * @param {vec2} out the receiving vector * @param {Number} x X component * @param {Number} y Y component * @returns {vec2} out */ function set(out, x, y) { out[0] = x; out[1] = y; return out; } /** * Adds two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function add(out, a, b) { out[0] = a[0] + b[0]; out[1] = a[1] + b[1]; return out; } /** * Subtracts vector b from vector a * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function subtract(out, a, b) { out[0] = a[0] - b[0]; out[1] = a[1] - b[1]; return out; } /** * Multiplies two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function multiply(out, a, b) { out[0] = a[0] * b[0]; out[1] = a[1] * b[1]; return out; } /** * Divides two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function divide(out, a, b) { out[0] = a[0] / b[0]; out[1] = a[1] / b[1]; return out; } /** * Math.ceil the components of a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to ceil * @returns {vec2} out */ function ceil(out, a) { out[0] = Math.ceil(a[0]); out[1] = Math.ceil(a[1]); return out; } /** * Math.floor the components of a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to floor * @returns {vec2} out */ function floor(out, a) { out[0] = Math.floor(a[0]); out[1] = Math.floor(a[1]); return out; } /** * Returns the minimum of two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function min(out, a, b) { out[0] = Math.min(a[0], b[0]); out[1] = Math.min(a[1], b[1]); return out; } /** * Returns the maximum of two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec2} out */ function max(out, a, b) { out[0] = Math.max(a[0], b[0]); out[1] = Math.max(a[1], b[1]); return out; } /** * Math.round the components of a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to round * @returns {vec2} out */ function round(out, a) { out[0] = Math.round(a[0]); out[1] = Math.round(a[1]); return out; } /** * Scales a vec2 by a scalar number * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the vector to scale * @param {Number} b amount to scale the vector by * @returns {vec2} out */ function scale(out, a, b) { out[0] = a[0] * b; out[1] = a[1] * b; return out; } /** * Adds two vec2's after scaling the second operand by a scalar value * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @param {Number} scale the amount to scale b by before adding * @returns {vec2} out */ function scaleAndAdd(out, a, b, scale) { out[0] = a[0] + b[0] * scale; out[1] = a[1] + b[1] * scale; return out; } /** * Calculates the euclidian distance between two vec2's * * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {Number} distance between a and b */ function distance(a, b) { var x = b[0] - a[0], y = b[1] - a[1]; return Math.hypot(x, y); } /** * Calculates the squared euclidian distance between two vec2's * * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {Number} squared distance between a and b */ function squaredDistance(a, b) { var x = b[0] - a[0], y = b[1] - a[1]; return x * x + y * y; } /** * Calculates the length of a vec2 * * @param {ReadonlyVec2} a vector to calculate length of * @returns {Number} length of a */ function length(a) { var x = a[0], y = a[1]; return Math.hypot(x, y); } /** * Calculates the squared length of a vec2 * * @param {ReadonlyVec2} a vector to calculate squared length of * @returns {Number} squared length of a */ function squaredLength(a) { var x = a[0], y = a[1]; return x * x + y * y; } /** * Negates the components of a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to negate * @returns {vec2} out */ function negate(out, a) { out[0] = -a[0]; out[1] = -a[1]; return out; } /** * Returns the inverse of the components of a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to invert * @returns {vec2} out */ function inverse(out, a) { out[0] = 1.0 / a[0]; out[1] = 1.0 / a[1]; return out; } /** * Normalize a vec2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a vector to normalize * @returns {vec2} out */ function normalize(out, a) { var x = a[0], y = a[1]; var len = x * x + y * y; if (len > 0) { //TODO: evaluate use of glm_invsqrt here? len = 1 / Math.sqrt(len); } out[0] = a[0] * len; out[1] = a[1] * len; return out; } /** * Calculates the dot product of two vec2's * * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {Number} dot product of a and b */ function dot$1(a, b) { return a[0] * b[0] + a[1] * b[1]; } /** * Computes the cross product of two vec2's * Note that the cross product must by definition produce a 3D vector * * @param {vec3} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @returns {vec3} out */ function cross(out, a, b) { var z = a[0] * b[1] - a[1] * b[0]; out[0] = out[1] = 0; out[2] = z; return out; } /** * Performs a linear interpolation between two vec2's * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the first operand * @param {ReadonlyVec2} b the second operand * @param {Number} t interpolation amount, in the range [0-1], between the two inputs * @returns {vec2} out */ function lerp(out, a, b, t) { var ax = a[0], ay = a[1]; out[0] = ax + t * (b[0] - ax); out[1] = ay + t * (b[1] - ay); return out; } /** * Generates a random vector with the given scale * * @param {vec2} out the receiving vector * @param {Number} [scale] Length of the resulting vector. If ommitted, a unit vector will be returned * @returns {vec2} out */ function random(out, scale) { scale = scale || 1.0; var r = RANDOM() * 2.0 * Math.PI; out[0] = Math.cos(r) * scale; out[1] = Math.sin(r) * scale; return out; } /** * Transforms the vec2 with a mat2 * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the vector to transform * @param {ReadonlyMat2} m matrix to transform with * @returns {vec2} out */ function transformMat2(out, a, m) { var x = a[0], y = a[1]; out[0] = m[0] * x + m[2] * y; out[1] = m[1] * x + m[3] * y; return out; } /** * Transforms the vec2 with a mat2d * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the vector to transform * @param {ReadonlyMat2d} m matrix to transform with * @returns {vec2} out */ function transformMat2d(out, a, m) { var x = a[0], y = a[1]; out[0] = m[0] * x + m[2] * y + m[4]; out[1] = m[1] * x + m[3] * y + m[5]; return out; } /** * Transforms the vec2 with a mat3 * 3rd vector component is implicitly '1' * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the vector to transform * @param {ReadonlyMat3} m matrix to transform with * @returns {vec2} out */ function transformMat3(out, a, m) { var x = a[0], y = a[1]; out[0] = m[0] * x + m[3] * y + m[6]; out[1] = m[1] * x + m[4] * y + m[7]; return out; } /** * Transforms the vec2 with a mat4 * 3rd vector component is implicitly '0' * 4th vector component is implicitly '1' * * @param {vec2} out the receiving vector * @param {ReadonlyVec2} a the vector to transform * @param {ReadonlyMat4} m matrix to transform with * @returns {vec2} out */ function transformMat4(out, a, m) { var x = a[0]; var y = a[1]; out[0] = m[0] * x + m[4] * y + m[12]; out[1] = m[1] * x + m[5] * y + m[13]; return out; } /** * Rotate a 2D vector * @param {vec2} out The receiving vec2 * @param {ReadonlyVec2} a The vec2 point to rotate * @param {ReadonlyVec2} b The origin of the rotation * @param {Number} rad The angle of rotation in radians * @returns {vec2} out */ function rotate(out, a, b, rad) { //Translate point to the origin var p0 = a[0] - b[0], p1 = a[1] - b[1], sinC = Math.sin(rad), cosC = Math.cos(rad); //perform rotation and translate to correct position out[0] = p0 * cosC - p1 * sinC + b[0]; out[1] = p0 * sinC + p1 * cosC + b[1]; return out; } /** * Get the angle between two 2D vectors * @param {ReadonlyVec2} a The first operand * @param {ReadonlyVec2} b The second operand * @returns {Number} The angle in radians */ function angle(a, b) { var x1 = a[0], y1 = a[1], x2 = b[0], y2 = b[1], // mag is the product of the magnitudes of a and b mag = Math.sqrt(x1 * x1 + y1 * y1) * Math.sqrt(x2 * x2 + y2 * y2), // mag &&.. short circuits if mag == 0 cosine = mag && (x1 * x2 + y1 * y2) / mag; // Math.min(Math.max(cosine, -1), 1) clamps the cosine between -1 and 1 return Math.acos(Math.min(Math.max(cosine, -1), 1)); } /** * Set the components of a vec2 to zero * * @param {vec2} out the receiving vector * @returns {vec2} out */ function zero(out) { out[0] = 0.0; out[1] = 0.0; return out; } /** * Returns a string representation of a vector * * @param {ReadonlyVec2} a vector to represent as a string * @returns {String} string representation of the vector */ function str(a) { return "vec2(" + a[0] + ", " + a[1] + ")"; } /** * Returns whether or not the vectors exactly have the same elements in the same position (when compared with ===) * * @param {ReadonlyVec2} a The first vector. * @param {ReadonlyVec2} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function exactEquals(a, b) { return a[0] === b[0] && a[1] === b[1]; } /** * Returns whether or not the vectors have approximately the same elements in the same position. * * @param {ReadonlyVec2} a The first vector. * @param {ReadonlyVec2} b The second vector. * @returns {Boolean} True if the vectors are equal, false otherwise. */ function equals$1(a, b) { var a0 = a[0], a1 = a[1]; var b0 = b[0], b1 = b[1]; return Math.abs(a0 - b0) <= EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)); } /** * Alias for {@link vec2.length} * @function */ var len = length; /** * Alias for {@link vec2.subtract} * @function */ var sub = subtract; /** * Alias for {@link vec2.multiply} * @function */ var mul = multiply; /** * Alias for {@link vec2.divide} * @function */ var div = divide; /** * Alias for {@link vec2.distance} * @function */ var dist = distance; /** * Alias for {@link vec2.squaredDistance} * @function */ var sqrDist = squaredDistance; /** * Alias for {@link vec2.squaredLength} * @function */ var sqrLen = squaredLength; /** * Perform some operation over an array of vec2s. * * @param {Array} a the array of vectors to iterate over * @param {Number} stride Number of elements between the start of each vec2. If 0 assumes tightly packed * @param {Number} offset Number of elements to skip at the beginning of the array * @param {Number} count Number of vec2s to iterate over. If 0 iterates over entire array * @param {Function} fn Function to call for each vector in the array * @param {Object} [arg] additional argument to pass to fn * @returns {Array} a * @function */ var forEach = function () { var vec = create$1(); return function (a, stride, offset, count, fn, arg) { var i, l; if (!stride) { stride = 2; } if (!offset) { offset = 0; } if (count) { l = Math.min(count * stride + offset, a.length); } else { l = a.length; } for (i = offset; i < l; i += stride) { vec[0] = a[i]; vec[1] = a[i + 1]; fn(vec, vec, arg); a[i] = vec[0]; a[i + 1] = vec[1]; } return a; }; }(); var vec2 = /*#__PURE__*/Object.freeze({ __proto__: null, add: add, angle: angle, ceil: ceil, clone: clone, copy: copy, create: create$1, cross: cross, dist: dist, distance: distance, div: div, divide: divide, dot: dot$1, equals: equals$1, exactEquals: exactEquals, floor: floor, forEach: forEach, fromValues: fromValues, inverse: inverse, len: len, length: length, lerp: lerp, max: max, min: min, mul: mul, multiply: multiply, negate: negate, normalize: normalize, random: random, rotate: rotate, round: round, scale: scale, scaleAndAdd: scaleAndAdd, set: set, sqrDist: sqrDist, sqrLen: sqrLen, squaredDistance: squaredDistance, squaredLength: squaredLength, str: str, sub: sub, subtract: subtract, transformMat2: transformMat2, transformMat2d: transformMat2d, transformMat3: transformMat3, transformMat4: transformMat4, zero: zero }); /** * A style layer that defines a circle */ class CircleStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$9); } createBucket(parameters) { return new CircleBucket(parameters); } queryRadius(bucket) { const circleBucket = bucket; return getMaximumPaintValue('circle-radius', this, circleBucket) + getMaximumPaintValue('circle-stroke-width', this, circleBucket) + translateDistance(this.paint.get('circle-translate')); } queryIntersectsFeature(queryGeometry, feature, featureState, geometry, zoom, transform, pixelsToTileUnits, pixelPosMatrix) { const translatedPolygon = translate$4(queryGeometry, this.paint.get('circle-translate'), this.paint.get('circle-translate-anchor'), transform.angle, pixelsToTileUnits); const radius = this.paint.get('circle-radius').evaluate(feature, featureState); const stroke = this.paint.get('circle-stroke-width').evaluate(feature, featureState); const size = radius + stroke; // For pitch-alignment: map, compare feature geometry to query geometry in the plane of the tile // // Otherwise, compare geometry in the plane of the viewport // // A circle with fixed scaling relative to the viewport gets larger in tile space as it moves into the distance // // A circle with fixed scaling relative to the map gets smaller in viewport space as it moves into the distance const alignWithMap = this.paint.get('circle-pitch-alignment') === 'map'; const transformedPolygon = alignWithMap ? translatedPolygon : projectQueryGeometry$1(translatedPolygon, pixelPosMatrix); const transformedSize = alignWithMap ? size * pixelsToTileUnits : size; for (const ring of geometry) { for (const point of ring) { const transformedPoint = alignWithMap ? point : projectPoint(point, pixelPosMatrix); let adjustedSize = transformedSize; const projectedCenter = transformMat4$1([], [point.x, point.y, 0, 1], pixelPosMatrix); if (this.paint.get('circle-pitch-scale') === 'viewport' && this.paint.get('circle-pitch-alignment') === 'map') { adjustedSize *= projectedCenter[3] / transform.cameraToCenterDistance; } else if (this.paint.get('circle-pitch-scale') === 'map' && this.paint.get('circle-pitch-alignment') === 'viewport') { adjustedSize *= transform.cameraToCenterDistance / projectedCenter[3]; } if (polygonIntersectsBufferedPoint(transformedPolygon, transformedPoint, adjustedSize)) return true; } } return false; } } function projectPoint(p, pixelPosMatrix) { const point = transformMat4$1([], [p.x, p.y, 0, 1], pixelPosMatrix); return new Point$2(point[0] / point[3], point[1] / point[3]); } function projectQueryGeometry$1(queryGeometry, pixelPosMatrix) { return queryGeometry.map((p) => { return projectPoint(p, pixelPosMatrix); }); } class HeatmapBucket extends CircleBucket { } register('HeatmapBucket', HeatmapBucket, { omit: ['layers'] }); // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let paint$7; const getPaint$7 = () => paint$7 = paint$7 || new Properties({ "heatmap-radius": new DataDrivenProperty(v8Spec["paint_heatmap"]["heatmap-radius"]), "heatmap-weight": new DataDrivenProperty(v8Spec["paint_heatmap"]["heatmap-weight"]), "heatmap-intensity": new DataConstantProperty(v8Spec["paint_heatmap"]["heatmap-intensity"]), "heatmap-color": new ColorRampProperty(v8Spec["paint_heatmap"]["heatmap-color"]), "heatmap-opacity": new DataConstantProperty(v8Spec["paint_heatmap"]["heatmap-opacity"]), }); var properties$8 = ({ get paint() { return getPaint$7(); } }); function createImage(image, { width, height }, channels, data) { if (!data) { data = new Uint8Array(width * height * channels); } else if (data instanceof Uint8ClampedArray) { data = new Uint8Array(data.buffer); } else if (data.length !== width * height * channels) { throw new RangeError(`mismatched image size. expected: ${data.length} but got: ${width * height * channels}`); } image.width = width; image.height = height; image.data = data; return image; } function resizeImage(image, { width, height }, channels) { if (width === image.width && height === image.height) { return; } const newImage = createImage({}, { width, height }, channels); copyImage(image, newImage, { x: 0, y: 0 }, { x: 0, y: 0 }, { width: Math.min(image.width, width), height: Math.min(image.height, height) }, channels); image.width = width; image.height = height; image.data = newImage.data; } function copyImage(srcImg, dstImg, srcPt, dstPt, size, channels) { if (size.width === 0 || size.height === 0) { return dstImg; } if (size.width > srcImg.width || size.height > srcImg.height || srcPt.x > srcImg.width - size.width || srcPt.y > srcImg.height - size.height) { throw new RangeError('out of range source coordinates for image copy'); } if (size.width > dstImg.width || size.height > dstImg.height || dstPt.x > dstImg.width - size.width || dstPt.y > dstImg.height - size.height) { throw new RangeError('out of range destination coordinates for image copy'); } const srcData = srcImg.data; const dstData = dstImg.data; if (srcData === dstData) throw new Error('srcData equals dstData, so image is already copied'); for (let y = 0; y < size.height; y++) { const srcOffset = ((srcPt.y + y) * srcImg.width + srcPt.x) * channels; const dstOffset = ((dstPt.y + y) * dstImg.width + dstPt.x) * channels; for (let i = 0; i < size.width * channels; i++) { dstData[dstOffset + i] = srcData[srcOffset + i]; } } return dstImg; } /** * An image with alpha color value */ class AlphaImage { constructor(size, data) { createImage(this, size, 1, data); } resize(size) { resizeImage(this, size, 1); } clone() { return new AlphaImage({ width: this.width, height: this.height }, new Uint8Array(this.data)); } static copy(srcImg, dstImg, srcPt, dstPt, size) { copyImage(srcImg, dstImg, srcPt, dstPt, size, 1); } } /** * An object to store image data not premultiplied, because ImageData is not premultiplied. * UNPACK_PREMULTIPLY_ALPHA_WEBGL must be used when uploading to a texture. */ class RGBAImage { constructor(size, data) { createImage(this, size, 4, data); } resize(size) { resizeImage(this, size, 4); } replace(data, copy) { if (copy) { this.data.set(data); } else if (data instanceof Uint8ClampedArray) { this.data = new Uint8Array(data.buffer); } else { this.data = data; } } clone() { return new RGBAImage({ width: this.width, height: this.height }, new Uint8Array(this.data)); } static copy(srcImg, dstImg, srcPt, dstPt, size) { copyImage(srcImg, dstImg, srcPt, dstPt, size, 4); } } register('AlphaImage', AlphaImage); register('RGBAImage', RGBAImage); /** * Given an expression that should evaluate to a color ramp, * return a RGBA image representing that ramp expression. */ function renderColorRamp(params) { const evaluationGlobals = {}; const width = params.resolution || 256; const height = params.clips ? params.clips.length : 1; const image = params.image || new RGBAImage({ width, height }); if (!isPowerOfTwo(width)) throw new Error(`width is not a power of 2 - ${width}`); const renderPixel = (stride, index, progress) => { evaluationGlobals[params.evaluationKey] = progress; const pxColor = params.expression.evaluate(evaluationGlobals); // the colors are being unpremultiplied because Color uses // premultiplied values, and the Texture class expects unpremultiplied ones image.data[stride + index + 0] = Math.floor(pxColor.r * 255 / pxColor.a); image.data[stride + index + 1] = Math.floor(pxColor.g * 255 / pxColor.a); image.data[stride + index + 2] = Math.floor(pxColor.b * 255 / pxColor.a); image.data[stride + index + 3] = Math.floor(pxColor.a * 255); }; if (!params.clips) { for (let i = 0, j = 0; i < width; i++, j += 4) { const progress = i / (width - 1); renderPixel(0, j, progress); } } else { for (let clip = 0, stride = 0; clip < height; ++clip, stride += width * 4) { for (let i = 0, j = 0; i < width; i++, j += 4) { // Remap progress between clips const progress = i / (width - 1); const { start, end } = params.clips[clip]; const evaluationProgress = start * (1 - progress) + end * progress; renderPixel(stride, j, evaluationProgress); } } } return image; } const HEATMAP_FULL_RENDER_FBO_KEY = 'big-fb'; /** * A style layer that defines a heatmap */ class HeatmapStyleLayer extends StyleLayer { createBucket(options) { return new HeatmapBucket(options); } constructor(layer) { super(layer, properties$8); this.heatmapFbos = new Map(); // make sure color ramp texture is generated for default heatmap color too this._updateColorRamp(); } _handleSpecialPaintPropertyUpdate(name) { if (name === 'heatmap-color') { this._updateColorRamp(); } } _updateColorRamp() { const expression = this._transitionablePaint._values['heatmap-color'].value.expression; this.colorRamp = renderColorRamp({ expression, evaluationKey: 'heatmapDensity', image: this.colorRamp }); this.colorRampTexture = null; } resize() { if (this.heatmapFbos.has(HEATMAP_FULL_RENDER_FBO_KEY)) { this.heatmapFbos.delete(HEATMAP_FULL_RENDER_FBO_KEY); } } queryRadius() { return 0; } queryIntersectsFeature() { return false; } hasOffscreenPass() { return this.paint.get('heatmap-opacity') !== 0 && this.visibility !== 'none'; } } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let paint$6; const getPaint$6 = () => paint$6 = paint$6 || new Properties({ "hillshade-illumination-direction": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-illumination-direction"]), "hillshade-illumination-anchor": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-illumination-anchor"]), "hillshade-exaggeration": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-exaggeration"]), "hillshade-shadow-color": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-shadow-color"]), "hillshade-highlight-color": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-highlight-color"]), "hillshade-accent-color": new DataConstantProperty(v8Spec["paint_hillshade"]["hillshade-accent-color"]), }); var properties$7 = ({ get paint() { return getPaint$6(); } }); class HillshadeStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$7); } hasOffscreenPass() { return this.paint.get('hillshade-exaggeration') !== 0 && this.visibility !== 'none'; } } const layout$4 = createLayout([ { name: 'a_pos', components: 2, type: 'Int16' } ], 4); const { members: members$3, size: size$3, alignment: alignment$3 } = layout$4; function earcut(data, holeIndices, dim = 2) { const hasHoles = holeIndices && holeIndices.length; const outerLen = hasHoles ? holeIndices[0] * dim : data.length; let outerNode = linkedList(data, 0, outerLen, dim, true); const triangles = []; if (!outerNode || outerNode.next === outerNode.prev) return triangles; let minX, minY, invSize; if (hasHoles) outerNode = eliminateHoles(data, holeIndices, outerNode, dim); // if the shape is not too simple, we'll use z-order curve hash later; calculate polygon bbox if (data.length > 80 * dim) { minX = Infinity; minY = Infinity; let maxX = -Infinity; let maxY = -Infinity; for (let i = dim; i < outerLen; i += dim) { const x = data[i]; const y = data[i + 1]; if (x < minX) minX = x; if (y < minY) minY = y; if (x > maxX) maxX = x; if (y > maxY) maxY = y; } // minX, minY and invSize are later used to transform coords into integers for z-order calculation invSize = Math.max(maxX - minX, maxY - minY); invSize = invSize !== 0 ? 32767 / invSize : 0; } earcutLinked(outerNode, triangles, dim, minX, minY, invSize, 0); return triangles; } // create a circular doubly linked list from polygon points in the specified winding order function linkedList(data, start, end, dim, clockwise) { let last; if (clockwise === (signedArea$1(data, start, end, dim) > 0)) { for (let i = start; i < end; i += dim) last = insertNode(i / dim | 0, data[i], data[i + 1], last); } else { for (let i = end - dim; i >= start; i -= dim) last = insertNode(i / dim | 0, data[i], data[i + 1], last); } if (last && equals(last, last.next)) { removeNode(last); last = last.next; } return last; } // eliminate colinear or duplicate points function filterPoints(start, end) { if (!start) return start; if (!end) end = start; let p = start, again; do { again = false; if (!p.steiner && (equals(p, p.next) || area(p.prev, p, p.next) === 0)) { removeNode(p); p = end = p.prev; if (p === p.next) break; again = true; } else { p = p.next; } } while (again || p !== end); return end; } // main ear slicing loop which triangulates a polygon (given as a linked list) function earcutLinked(ear, triangles, dim, minX, minY, invSize, pass) { if (!ear) return; // interlink polygon nodes in z-order if (!pass && invSize) indexCurve(ear, minX, minY, invSize); let stop = ear; // iterate through ears, slicing them one by one while (ear.prev !== ear.next) { const prev = ear.prev; const next = ear.next; if (invSize ? isEarHashed(ear, minX, minY, invSize) : isEar(ear)) { triangles.push(prev.i, ear.i, next.i); // cut off the triangle removeNode(ear); // skipping the next vertex leads to less sliver triangles ear = next.next; stop = next.next; continue; } ear = next; // if we looped through the whole remaining polygon and can't find any more ears if (ear === stop) { // try filtering points and slicing again if (!pass) { earcutLinked(filterPoints(ear), triangles, dim, minX, minY, invSize, 1); // if this didn't work, try curing all small self-intersections locally } else if (pass === 1) { ear = cureLocalIntersections(filterPoints(ear), triangles); earcutLinked(ear, triangles, dim, minX, minY, invSize, 2); // as a last resort, try splitting the remaining polygon into two } else if (pass === 2) { splitEarcut(ear, triangles, dim, minX, minY, invSize); } break; } } } // check whether a polygon node forms a valid ear with adjacent nodes function isEar(ear) { const a = ear.prev, b = ear, c = ear.next; if (area(a, b, c) >= 0) return false; // reflex, can't be an ear // now make sure we don't have other points inside the potential ear const ax = a.x, bx = b.x, cx = c.x, ay = a.y, by = b.y, cy = c.y; // triangle bbox; min & max are calculated like this for speed const x0 = ax < bx ? (ax < cx ? ax : cx) : (bx < cx ? bx : cx), y0 = ay < by ? (ay < cy ? ay : cy) : (by < cy ? by : cy), x1 = ax > bx ? (ax > cx ? ax : cx) : (bx > cx ? bx : cx), y1 = ay > by ? (ay > cy ? ay : cy) : (by > cy ? by : cy); let p = c.next; while (p !== a) { if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 && pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false; p = p.next; } return true; } function isEarHashed(ear, minX, minY, invSize) { const a = ear.prev, b = ear, c = ear.next; if (area(a, b, c) >= 0) return false; // reflex, can't be an ear const ax = a.x, bx = b.x, cx = c.x, ay = a.y, by = b.y, cy = c.y; // triangle bbox; min & max are calculated like this for speed const x0 = ax < bx ? (ax < cx ? ax : cx) : (bx < cx ? bx : cx), y0 = ay < by ? (ay < cy ? ay : cy) : (by < cy ? by : cy), x1 = ax > bx ? (ax > cx ? ax : cx) : (bx > cx ? bx : cx), y1 = ay > by ? (ay > cy ? ay : cy) : (by > cy ? by : cy); // z-order range for the current triangle bbox; const minZ = zOrder(x0, y0, minX, minY, invSize), maxZ = zOrder(x1, y1, minX, minY, invSize); let p = ear.prevZ, n = ear.nextZ; // look for points inside the triangle in both directions while (p && p.z >= minZ && n && n.z <= maxZ) { if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 && p !== a && p !== c && pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false; p = p.prevZ; if (n.x >= x0 && n.x <= x1 && n.y >= y0 && n.y <= y1 && n !== a && n !== c && pointInTriangle(ax, ay, bx, by, cx, cy, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false; n = n.nextZ; } // look for remaining points in decreasing z-order while (p && p.z >= minZ) { if (p.x >= x0 && p.x <= x1 && p.y >= y0 && p.y <= y1 && p !== a && p !== c && pointInTriangle(ax, ay, bx, by, cx, cy, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false; p = p.prevZ; } // look for remaining points in increasing z-order while (n && n.z <= maxZ) { if (n.x >= x0 && n.x <= x1 && n.y >= y0 && n.y <= y1 && n !== a && n !== c && pointInTriangle(ax, ay, bx, by, cx, cy, n.x, n.y) && area(n.prev, n, n.next) >= 0) return false; n = n.nextZ; } return true; } // go through all polygon nodes and cure small local self-intersections function cureLocalIntersections(start, triangles) { let p = start; do { const a = p.prev, b = p.next.next; if (!equals(a, b) && intersects(a, p, p.next, b) && locallyInside(a, b) && locallyInside(b, a)) { triangles.push(a.i, p.i, b.i); // remove two nodes involved removeNode(p); removeNode(p.next); p = start = b; } p = p.next; } while (p !== start); return filterPoints(p); } // try splitting polygon into two and triangulate them independently function splitEarcut(start, triangles, dim, minX, minY, invSize) { // look for a valid diagonal that divides the polygon into two let a = start; do { let b = a.next.next; while (b !== a.prev) { if (a.i !== b.i && isValidDiagonal(a, b)) { // split the polygon in two by the diagonal let c = splitPolygon(a, b); // filter colinear points around the cuts a = filterPoints(a, a.next); c = filterPoints(c, c.next); // run earcut on each half earcutLinked(a, triangles, dim, minX, minY, invSize, 0); earcutLinked(c, triangles, dim, minX, minY, invSize, 0); return; } b = b.next; } a = a.next; } while (a !== start); } // link every hole into the outer loop, producing a single-ring polygon without holes function eliminateHoles(data, holeIndices, outerNode, dim) { const queue = []; for (let i = 0, len = holeIndices.length; i < len; i++) { const start = holeIndices[i] * dim; const end = i < len - 1 ? holeIndices[i + 1] * dim : data.length; const list = linkedList(data, start, end, dim, false); if (list === list.next) list.steiner = true; queue.push(getLeftmost(list)); } queue.sort(compareX); // process holes from left to right for (let i = 0; i < queue.length; i++) { outerNode = eliminateHole(queue[i], outerNode); } return outerNode; } function compareX(a, b) { return a.x - b.x; } // find a bridge between vertices that connects hole with an outer ring and and link it function eliminateHole(hole, outerNode) { const bridge = findHoleBridge(hole, outerNode); if (!bridge) { return outerNode; } const bridgeReverse = splitPolygon(bridge, hole); // filter collinear points around the cuts filterPoints(bridgeReverse, bridgeReverse.next); return filterPoints(bridge, bridge.next); } // David Eberly's algorithm for finding a bridge between hole and outer polygon function findHoleBridge(hole, outerNode) { let p = outerNode; const hx = hole.x; const hy = hole.y; let qx = -Infinity; let m; // find a segment intersected by a ray from the hole's leftmost point to the left; // segment's endpoint with lesser x will be potential connection point do { if (hy <= p.y && hy >= p.next.y && p.next.y !== p.y) { const x = p.x + (hy - p.y) * (p.next.x - p.x) / (p.next.y - p.y); if (x <= hx && x > qx) { qx = x; m = p.x < p.next.x ? p : p.next; if (x === hx) return m; // hole touches outer segment; pick leftmost endpoint } } p = p.next; } while (p !== outerNode); if (!m) return null; // look for points inside the triangle of hole point, segment intersection and endpoint; // if there are no points found, we have a valid connection; // otherwise choose the point of the minimum angle with the ray as connection point const stop = m; const mx = m.x; const my = m.y; let tanMin = Infinity; p = m; do { if (hx >= p.x && p.x >= mx && hx !== p.x && pointInTriangle(hy < my ? hx : qx, hy, mx, my, hy < my ? qx : hx, hy, p.x, p.y)) { const tan = Math.abs(hy - p.y) / (hx - p.x); // tangential if (locallyInside(p, hole) && (tan < tanMin || (tan === tanMin && (p.x > m.x || (p.x === m.x && sectorContainsSector(m, p)))))) { m = p; tanMin = tan; } } p = p.next; } while (p !== stop); return m; } // whether sector in vertex m contains sector in vertex p in the same coordinates function sectorContainsSector(m, p) { return area(m.prev, m, p.prev) < 0 && area(p.next, m, m.next) < 0; } // interlink polygon nodes in z-order function indexCurve(start, minX, minY, invSize) { let p = start; do { if (p.z === 0) p.z = zOrder(p.x, p.y, minX, minY, invSize); p.prevZ = p.prev; p.nextZ = p.next; p = p.next; } while (p !== start); p.prevZ.nextZ = null; p.prevZ = null; sortLinked(p); } // Simon Tatham's linked list merge sort algorithm // http://www.chiark.greenend.org.uk/~sgtatham/algorithms/listsort.html function sortLinked(list) { let numMerges; let inSize = 1; do { let p = list; let e; list = null; let tail = null; numMerges = 0; while (p) { numMerges++; let q = p; let pSize = 0; for (let i = 0; i < inSize; i++) { pSize++; q = q.nextZ; if (!q) break; } let qSize = inSize; while (pSize > 0 || (qSize > 0 && q)) { if (pSize !== 0 && (qSize === 0 || !q || p.z <= q.z)) { e = p; p = p.nextZ; pSize--; } else { e = q; q = q.nextZ; qSize--; } if (tail) tail.nextZ = e; else list = e; e.prevZ = tail; tail = e; } p = q; } tail.nextZ = null; inSize *= 2; } while (numMerges > 1); return list; } // z-order of a point given coords and inverse of the longer side of data bbox function zOrder(x, y, minX, minY, invSize) { // coords are transformed into non-negative 15-bit integer range x = (x - minX) * invSize | 0; y = (y - minY) * invSize | 0; x = (x | (x << 8)) & 0x00FF00FF; x = (x | (x << 4)) & 0x0F0F0F0F; x = (x | (x << 2)) & 0x33333333; x = (x | (x << 1)) & 0x55555555; y = (y | (y << 8)) & 0x00FF00FF; y = (y | (y << 4)) & 0x0F0F0F0F; y = (y | (y << 2)) & 0x33333333; y = (y | (y << 1)) & 0x55555555; return x | (y << 1); } // find the leftmost node of a polygon ring function getLeftmost(start) { let p = start, leftmost = start; do { if (p.x < leftmost.x || (p.x === leftmost.x && p.y < leftmost.y)) leftmost = p; p = p.next; } while (p !== start); return leftmost; } // check if a point lies within a convex triangle function pointInTriangle(ax, ay, bx, by, cx, cy, px, py) { return (cx - px) * (ay - py) >= (ax - px) * (cy - py) && (ax - px) * (by - py) >= (bx - px) * (ay - py) && (bx - px) * (cy - py) >= (cx - px) * (by - py); } // check if a diagonal between two polygon nodes is valid (lies in polygon interior) function isValidDiagonal(a, b) { return a.next.i !== b.i && a.prev.i !== b.i && !intersectsPolygon(a, b) && // dones't intersect other edges (locallyInside(a, b) && locallyInside(b, a) && middleInside(a, b) && // locally visible (area(a.prev, a, b.prev) || area(a, b.prev, b)) || // does not create opposite-facing sectors equals(a, b) && area(a.prev, a, a.next) > 0 && area(b.prev, b, b.next) > 0); // special zero-length case } // signed area of a triangle function area(p, q, r) { return (q.y - p.y) * (r.x - q.x) - (q.x - p.x) * (r.y - q.y); } // check if two points are equal function equals(p1, p2) { return p1.x === p2.x && p1.y === p2.y; } // check if two segments intersect function intersects(p1, q1, p2, q2) { const o1 = sign(area(p1, q1, p2)); const o2 = sign(area(p1, q1, q2)); const o3 = sign(area(p2, q2, p1)); const o4 = sign(area(p2, q2, q1)); if (o1 !== o2 && o3 !== o4) return true; // general case if (o1 === 0 && onSegment(p1, p2, q1)) return true; // p1, q1 and p2 are collinear and p2 lies on p1q1 if (o2 === 0 && onSegment(p1, q2, q1)) return true; // p1, q1 and q2 are collinear and q2 lies on p1q1 if (o3 === 0 && onSegment(p2, p1, q2)) return true; // p2, q2 and p1 are collinear and p1 lies on p2q2 if (o4 === 0 && onSegment(p2, q1, q2)) return true; // p2, q2 and q1 are collinear and q1 lies on p2q2 return false; } // for collinear points p, q, r, check if point q lies on segment pr function onSegment(p, q, r) { return q.x <= Math.max(p.x, r.x) && q.x >= Math.min(p.x, r.x) && q.y <= Math.max(p.y, r.y) && q.y >= Math.min(p.y, r.y); } function sign(num) { return num > 0 ? 1 : num < 0 ? -1 : 0; } // check if a polygon diagonal intersects any polygon segments function intersectsPolygon(a, b) { let p = a; do { if (p.i !== a.i && p.next.i !== a.i && p.i !== b.i && p.next.i !== b.i && intersects(p, p.next, a, b)) return true; p = p.next; } while (p !== a); return false; } // check if a polygon diagonal is locally inside the polygon function locallyInside(a, b) { return area(a.prev, a, a.next) < 0 ? area(a, b, a.next) >= 0 && area(a, a.prev, b) >= 0 : area(a, b, a.prev) < 0 || area(a, a.next, b) < 0; } // check if the middle point of a polygon diagonal is inside the polygon function middleInside(a, b) { let p = a; let inside = false; const px = (a.x + b.x) / 2; const py = (a.y + b.y) / 2; do { if (((p.y > py) !== (p.next.y > py)) && p.next.y !== p.y && (px < (p.next.x - p.x) * (py - p.y) / (p.next.y - p.y) + p.x)) inside = !inside; p = p.next; } while (p !== a); return inside; } // link two polygon vertices with a bridge; if the vertices belong to the same ring, it splits polygon into two; // if one belongs to the outer ring and another to a hole, it merges it into a single ring function splitPolygon(a, b) { const a2 = createNode(a.i, a.x, a.y), b2 = createNode(b.i, b.x, b.y), an = a.next, bp = b.prev; a.next = b; b.prev = a; a2.next = an; an.prev = a2; b2.next = a2; a2.prev = b2; bp.next = b2; b2.prev = bp; return b2; } // create a node and optionally link it with previous one (in a circular doubly linked list) function insertNode(i, x, y, last) { const p = createNode(i, x, y); if (!last) { p.prev = p; p.next = p; } else { p.next = last.next; p.prev = last; last.next.prev = p; last.next = p; } return p; } function removeNode(p) { p.next.prev = p.prev; p.prev.next = p.next; if (p.prevZ) p.prevZ.nextZ = p.nextZ; if (p.nextZ) p.nextZ.prevZ = p.prevZ; } function createNode(i, x, y) { return { i, // vertex index in coordinates array x, y, // vertex coordinates prev: null, // previous and next vertex nodes in a polygon ring next: null, z: 0, // z-order curve value prevZ: null, // previous and next nodes in z-order nextZ: null, steiner: false // indicates whether this is a steiner point }; } // return a percentage difference between the polygon area and its triangulation area; // used to verify correctness of triangulation function deviation(data, holeIndices, dim, triangles) { const hasHoles = holeIndices && holeIndices.length; const outerLen = hasHoles ? holeIndices[0] * dim : data.length; let polygonArea = Math.abs(signedArea$1(data, 0, outerLen, dim)); if (hasHoles) { for (let i = 0, len = holeIndices.length; i < len; i++) { const start = holeIndices[i] * dim; const end = i < len - 1 ? holeIndices[i + 1] * dim : data.length; polygonArea -= Math.abs(signedArea$1(data, start, end, dim)); } } let trianglesArea = 0; for (let i = 0; i < triangles.length; i += 3) { const a = triangles[i] * dim; const b = triangles[i + 1] * dim; const c = triangles[i + 2] * dim; trianglesArea += Math.abs( (data[a] - data[c]) * (data[b + 1] - data[a + 1]) - (data[a] - data[b]) * (data[c + 1] - data[a + 1])); } return polygonArea === 0 && trianglesArea === 0 ? 0 : Math.abs((trianglesArea - polygonArea) / polygonArea); } function signedArea$1(data, start, end, dim) { let sum = 0; for (let i = start, j = end - dim; i < end; i += dim) { sum += (data[j] - data[i]) * (data[i + 1] + data[j + 1]); j = i; } return sum; } // turn a polygon in a multi-dimensional array form (e.g. as in GeoJSON) into a form Earcut accepts function flatten(data) { const vertices = []; const holes = []; const dimensions = data[0][0].length; let holeIndex = 0; let prevLen = 0; for (const ring of data) { for (const p of ring) { for (let d = 0; d < dimensions; d++) vertices.push(p[d]); } if (prevLen) { holeIndex += prevLen; holes.push(holeIndex); } prevLen = ring.length; } return {vertices, holes, dimensions}; } function hasPattern(type, layers, options) { const patterns = options.patternDependencies; let hasPattern = false; for (const layer of layers) { const patternProperty = layer.paint.get(`${type}-pattern`); if (!patternProperty.isConstant()) { hasPattern = true; } const constantPattern = patternProperty.constantOr(null); if (constantPattern) { hasPattern = true; patterns[constantPattern.to] = true; patterns[constantPattern.from] = true; } } return hasPattern; } function addPatternDependencies(type, layers, patternFeature, zoom, options) { const patterns = options.patternDependencies; for (const layer of layers) { const patternProperty = layer.paint.get(`${type}-pattern`); const patternPropertyValue = patternProperty.value; if (patternPropertyValue.kind !== 'constant') { let min = patternPropertyValue.evaluate({ zoom: zoom - 1 }, patternFeature, {}, options.availableImages); let mid = patternPropertyValue.evaluate({ zoom }, patternFeature, {}, options.availableImages); let max = patternPropertyValue.evaluate({ zoom: zoom + 1 }, patternFeature, {}, options.availableImages); min = min && min.name ? min.name : min; mid = mid && mid.name ? mid.name : mid; max = max && max.name ? max.name : max; // add to patternDependencies patterns[min] = true; patterns[mid] = true; patterns[max] = true; // save for layout patternFeature.patterns[layer.id] = { min, mid, max }; } } return patternFeature; } const EARCUT_MAX_RINGS$1 = 500; class FillBucket { constructor(options) { this.zoom = options.zoom; this.overscaling = options.overscaling; this.layers = options.layers; this.layerIds = this.layers.map(layer => layer.id); this.index = options.index; this.hasPattern = false; this.patternFeatures = []; this.layoutVertexArray = new FillLayoutArray(); this.indexArray = new TriangleIndexArray(); this.indexArray2 = new LineIndexArray(); this.programConfigurations = new ProgramConfigurationSet(options.layers, options.zoom); this.segments = new SegmentVector(); this.segments2 = new SegmentVector(); this.stateDependentLayerIds = this.layers.filter((l) => l.isStateDependent()).map((l) => l.id); } populate(features, options, canonical) { this.hasPattern = hasPattern('fill', this.layers, options); const fillSortKey = this.layers[0].layout.get('fill-sort-key'); const sortFeaturesByKey = !fillSortKey.isConstant(); const bucketFeatures = []; for (const { feature, id, index, sourceLayerIndex } of features) { const needGeometry = this.layers[0]._featureFilter.needGeometry; const evaluationFeature = toEvaluationFeature(feature, needGeometry); if (!this.layers[0]._featureFilter.filter(new EvaluationParameters(this.zoom), evaluationFeature, canonical)) continue; const sortKey = sortFeaturesByKey ? fillSortKey.evaluate(evaluationFeature, {}, canonical, options.availableImages) : undefined; const bucketFeature = { id, properties: feature.properties, type: feature.type, sourceLayerIndex, index, geometry: needGeometry ? evaluationFeature.geometry : loadGeometry(feature), patterns: {}, sortKey }; bucketFeatures.push(bucketFeature); } if (sortFeaturesByKey) { bucketFeatures.sort((a, b) => a.sortKey - b.sortKey); } for (const bucketFeature of bucketFeatures) { const { geometry, index, sourceLayerIndex } = bucketFeature; if (this.hasPattern) { const patternFeature = addPatternDependencies('fill', this.layers, bucketFeature, this.zoom, options); // pattern features are added only once the pattern is loaded into the image atlas // so are stored during populate until later updated with positions by tile worker in addFeatures this.patternFeatures.push(patternFeature); } else { this.addFeature(bucketFeature, geometry, index, canonical, {}); } const feature = features[index].feature; options.featureIndex.insert(feature, geometry, index, sourceLayerIndex, this.index); } } update(states, vtLayer, imagePositions) { if (!this.stateDependentLayers.length) return; this.programConfigurations.updatePaintArrays(states, vtLayer, this.stateDependentLayers, imagePositions); } addFeatures(options, canonical, imagePositions) { for (const feature of this.patternFeatures) { this.addFeature(feature, feature.geometry, feature.index, canonical, imagePositions); } } isEmpty() { return this.layoutVertexArray.length === 0; } uploadPending() { return !this.uploaded || this.programConfigurations.needsUpload; } upload(context) { if (!this.uploaded) { this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, members$3); this.indexBuffer = context.createIndexBuffer(this.indexArray); this.indexBuffer2 = context.createIndexBuffer(this.indexArray2); } this.programConfigurations.upload(context); this.uploaded = true; } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.indexBuffer2.destroy(); this.programConfigurations.destroy(); this.segments.destroy(); this.segments2.destroy(); } addFeature(feature, geometry, index, canonical, imagePositions) { for (const polygon of classifyRings$1(geometry, EARCUT_MAX_RINGS$1)) { let numVertices = 0; for (const ring of polygon) { numVertices += ring.length; } const triangleSegment = this.segments.prepareSegment(numVertices, this.layoutVertexArray, this.indexArray); const triangleIndex = triangleSegment.vertexLength; const flattened = []; const holeIndices = []; for (const ring of polygon) { if (ring.length === 0) { continue; } if (ring !== polygon[0]) { holeIndices.push(flattened.length / 2); } const lineSegment = this.segments2.prepareSegment(ring.length, this.layoutVertexArray, this.indexArray2); const lineIndex = lineSegment.vertexLength; this.layoutVertexArray.emplaceBack(ring[0].x, ring[0].y); this.indexArray2.emplaceBack(lineIndex + ring.length - 1, lineIndex); flattened.push(ring[0].x); flattened.push(ring[0].y); for (let i = 1; i < ring.length; i++) { this.layoutVertexArray.emplaceBack(ring[i].x, ring[i].y); this.indexArray2.emplaceBack(lineIndex + i - 1, lineIndex + i); flattened.push(ring[i].x); flattened.push(ring[i].y); } lineSegment.vertexLength += ring.length; lineSegment.primitiveLength += ring.length; } const indices = earcut(flattened, holeIndices); for (let i = 0; i < indices.length; i += 3) { this.indexArray.emplaceBack(triangleIndex + indices[i], triangleIndex + indices[i + 1], triangleIndex + indices[i + 2]); } triangleSegment.vertexLength += numVertices; triangleSegment.primitiveLength += indices.length / 3; } this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length, feature, index, imagePositions, canonical); } } register('FillBucket', FillBucket, { omit: ['layers', 'patternFeatures'] }); // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let layout$3; const getLayout$2 = () => layout$3 = layout$3 || new Properties({ "fill-sort-key": new DataDrivenProperty(v8Spec["layout_fill"]["fill-sort-key"]), }); let paint$5; const getPaint$5 = () => paint$5 = paint$5 || new Properties({ "fill-antialias": new DataConstantProperty(v8Spec["paint_fill"]["fill-antialias"]), "fill-opacity": new DataDrivenProperty(v8Spec["paint_fill"]["fill-opacity"]), "fill-color": new DataDrivenProperty(v8Spec["paint_fill"]["fill-color"]), "fill-outline-color": new DataDrivenProperty(v8Spec["paint_fill"]["fill-outline-color"]), "fill-translate": new DataConstantProperty(v8Spec["paint_fill"]["fill-translate"]), "fill-translate-anchor": new DataConstantProperty(v8Spec["paint_fill"]["fill-translate-anchor"]), "fill-pattern": new CrossFadedDataDrivenProperty(v8Spec["paint_fill"]["fill-pattern"]), }); var properties$6 = ({ get paint() { return getPaint$5(); }, get layout() { return getLayout$2(); } }); class FillStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$6); } recalculate(parameters, availableImages) { super.recalculate(parameters, availableImages); const outlineColor = this.paint._values['fill-outline-color']; if (outlineColor.value.kind === 'constant' && outlineColor.value.value === undefined) { this.paint._values['fill-outline-color'] = this.paint._values['fill-color']; } } createBucket(parameters) { return new FillBucket(parameters); } queryRadius() { return translateDistance(this.paint.get('fill-translate')); } queryIntersectsFeature(queryGeometry, feature, featureState, geometry, zoom, transform, pixelsToTileUnits) { const translatedPolygon = translate$4(queryGeometry, this.paint.get('fill-translate'), this.paint.get('fill-translate-anchor'), transform.angle, pixelsToTileUnits); return polygonIntersectsMultiPolygon(translatedPolygon, geometry); } isTileClipped() { return true; } } const layout$2 = createLayout([ { name: 'a_pos', components: 2, type: 'Int16' }, { name: 'a_normal_ed', components: 4, type: 'Int16' }, ], 4); const centroidAttributes = createLayout([ { name: 'a_centroid', components: 2, type: 'Int16' } ], 4); const { members: members$2, size: size$2, alignment: alignment$2 } = layout$2; var vectorTile = {}; 'use strict'; var Point = pointGeometry; var vectortilefeature = VectorTileFeature$2; function VectorTileFeature$2(pbf, end, extent, keys, values) { // Public this.properties = {}; this.extent = extent; this.type = 0; // Private this._pbf = pbf; this._geometry = -1; this._keys = keys; this._values = values; pbf.readFields(readFeature, this, end); } function readFeature(tag, feature, pbf) { if (tag == 1) feature.id = pbf.readVarint(); else if (tag == 2) readTag(pbf, feature); else if (tag == 3) feature.type = pbf.readVarint(); else if (tag == 4) feature._geometry = pbf.pos; } function readTag(pbf, feature) { var end = pbf.readVarint() + pbf.pos; while (pbf.pos < end) { var key = feature._keys[pbf.readVarint()], value = feature._values[pbf.readVarint()]; feature.properties[key] = value; } } VectorTileFeature$2.types = ['Unknown', 'Point', 'LineString', 'Polygon']; VectorTileFeature$2.prototype.loadGeometry = function() { var pbf = this._pbf; pbf.pos = this._geometry; var end = pbf.readVarint() + pbf.pos, cmd = 1, length = 0, x = 0, y = 0, lines = [], line; while (pbf.pos < end) { if (length <= 0) { var cmdLen = pbf.readVarint(); cmd = cmdLen & 0x7; length = cmdLen >> 3; } length--; if (cmd === 1 || cmd === 2) { x += pbf.readSVarint(); y += pbf.readSVarint(); if (cmd === 1) { // moveTo if (line) lines.push(line); line = []; } line.push(new Point(x, y)); } else if (cmd === 7) { // Workaround for https://github.com/mapbox/mapnik-vector-tile/issues/90 if (line) { line.push(line[0].clone()); // closePolygon } } else { throw new Error('unknown command ' + cmd); } } if (line) lines.push(line); return lines; }; VectorTileFeature$2.prototype.bbox = function() { var pbf = this._pbf; pbf.pos = this._geometry; var end = pbf.readVarint() + pbf.pos, cmd = 1, length = 0, x = 0, y = 0, x1 = Infinity, x2 = -Infinity, y1 = Infinity, y2 = -Infinity; while (pbf.pos < end) { if (length <= 0) { var cmdLen = pbf.readVarint(); cmd = cmdLen & 0x7; length = cmdLen >> 3; } length--; if (cmd === 1 || cmd === 2) { x += pbf.readSVarint(); y += pbf.readSVarint(); if (x < x1) x1 = x; if (x > x2) x2 = x; if (y < y1) y1 = y; if (y > y2) y2 = y; } else if (cmd !== 7) { throw new Error('unknown command ' + cmd); } } return [x1, y1, x2, y2]; }; VectorTileFeature$2.prototype.toGeoJSON = function(x, y, z) { var size = this.extent * Math.pow(2, z), x0 = this.extent * x, y0 = this.extent * y, coords = this.loadGeometry(), type = VectorTileFeature$2.types[this.type], i, j; function project(line) { for (var j = 0; j < line.length; j++) { var p = line[j], y2 = 180 - (p.y + y0) * 360 / size; line[j] = [ (p.x + x0) * 360 / size - 180, 360 / Math.PI * Math.atan(Math.exp(y2 * Math.PI / 180)) - 90 ]; } } switch (this.type) { case 1: var points = []; for (i = 0; i < coords.length; i++) { points[i] = coords[i][0]; } coords = points; project(coords); break; case 2: for (i = 0; i < coords.length; i++) { project(coords[i]); } break; case 3: coords = classifyRings(coords); for (i = 0; i < coords.length; i++) { for (j = 0; j < coords[i].length; j++) { project(coords[i][j]); } } break; } if (coords.length === 1) { coords = coords[0]; } else { type = 'Multi' + type; } var result = { type: "Feature", geometry: { type: type, coordinates: coords }, properties: this.properties }; if ('id' in this) { result.id = this.id; } return result; }; // classifies an array of rings into polygons with outer rings and holes function classifyRings(rings) { var len = rings.length; if (len <= 1) return [rings]; var polygons = [], polygon, ccw; for (var i = 0; i < len; i++) { var area = signedArea(rings[i]); if (area === 0) continue; if (ccw === undefined) ccw = area < 0; if (ccw === area < 0) { if (polygon) polygons.push(polygon); polygon = [rings[i]]; } else { polygon.push(rings[i]); } } if (polygon) polygons.push(polygon); return polygons; } function signedArea(ring) { var sum = 0; for (var i = 0, len = ring.length, j = len - 1, p1, p2; i < len; j = i++) { p1 = ring[i]; p2 = ring[j]; sum += (p2.x - p1.x) * (p1.y + p2.y); } return sum; } var vectortilefeature$1 = /*@__PURE__*/getDefaultExportFromCjs$1(vectortilefeature); 'use strict'; var VectorTileFeature$1 = vectortilefeature; var vectortilelayer = VectorTileLayer$2; function VectorTileLayer$2(pbf, end) { // Public this.version = 1; this.name = null; this.extent = 4096; this.length = 0; // Private this._pbf = pbf; this._keys = []; this._values = []; this._features = []; pbf.readFields(readLayer, this, end); this.length = this._features.length; } function readLayer(tag, layer, pbf) { if (tag === 15) layer.version = pbf.readVarint(); else if (tag === 1) layer.name = pbf.readString(); else if (tag === 5) layer.extent = pbf.readVarint(); else if (tag === 2) layer._features.push(pbf.pos); else if (tag === 3) layer._keys.push(pbf.readString()); else if (tag === 4) layer._values.push(readValueMessage(pbf)); } function readValueMessage(pbf) { var value = null, end = pbf.readVarint() + pbf.pos; while (pbf.pos < end) { var tag = pbf.readVarint() >> 3; value = tag === 1 ? pbf.readString() : tag === 2 ? pbf.readFloat() : tag === 3 ? pbf.readDouble() : tag === 4 ? pbf.readVarint64() : tag === 5 ? pbf.readVarint() : tag === 6 ? pbf.readSVarint() : tag === 7 ? pbf.readBoolean() : null; } return value; } // return feature `i` from this layer as a `VectorTileFeature` VectorTileLayer$2.prototype.feature = function(i) { if (i < 0 || i >= this._features.length) throw new Error('feature index out of bounds'); this._pbf.pos = this._features[i]; var end = this._pbf.readVarint() + this._pbf.pos; return new VectorTileFeature$1(this._pbf, end, this.extent, this._keys, this._values); }; var vectortilelayer$1 = /*@__PURE__*/getDefaultExportFromCjs$1(vectortilelayer); 'use strict'; var VectorTileLayer$1 = vectortilelayer; var vectortile = VectorTile$1; function VectorTile$1(pbf, end) { this.layers = pbf.readFields(readTile, {}, end); } function readTile(tag, layers, pbf) { if (tag === 3) { var layer = new VectorTileLayer$1(pbf, pbf.readVarint() + pbf.pos); if (layer.length) layers[layer.name] = layer; } } var vectortile$1 = /*@__PURE__*/getDefaultExportFromCjs$1(vectortile); var VectorTile = vectorTile.VectorTile = vectortile; var VectorTileFeature = vectorTile.VectorTileFeature = vectortilefeature; var VectorTileLayer = vectorTile.VectorTileLayer = vectortilelayer; const vectorTileFeatureTypes$2 = vectorTile.VectorTileFeature.types; const EARCUT_MAX_RINGS = 500; const FACTOR = Math.pow(2, 13); function addVertex$1(vertexArray, x, y, nx, ny, nz, t, e) { vertexArray.emplaceBack( // a_pos x, y, // a_normal_ed: 3-component normal and 1-component edgedistance Math.floor(nx * FACTOR) * 2 + t, ny * FACTOR * 2, nz * FACTOR * 2, // edgedistance (used for wrapping patterns around extrusion sides) Math.round(e)); } class FillExtrusionBucket { constructor(options) { this.zoom = options.zoom; this.overscaling = options.overscaling; this.layers = options.layers; this.layerIds = this.layers.map(layer => layer.id); this.index = options.index; this.hasPattern = false; this.layoutVertexArray = new FillExtrusionLayoutArray(); this.centroidVertexArray = new PosArray(); this.indexArray = new TriangleIndexArray(); this.programConfigurations = new ProgramConfigurationSet(options.layers, options.zoom); this.segments = new SegmentVector(); this.stateDependentLayerIds = this.layers.filter((l) => l.isStateDependent()).map((l) => l.id); } populate(features, options, canonical) { this.features = []; this.hasPattern = hasPattern('fill-extrusion', this.layers, options); for (const { feature, id, index, sourceLayerIndex } of features) { const needGeometry = this.layers[0]._featureFilter.needGeometry; const evaluationFeature = toEvaluationFeature(feature, needGeometry); if (!this.layers[0]._featureFilter.filter(new EvaluationParameters(this.zoom), evaluationFeature, canonical)) continue; const bucketFeature = { id, sourceLayerIndex, index, geometry: needGeometry ? evaluationFeature.geometry : loadGeometry(feature), properties: feature.properties, type: feature.type, patterns: {} }; if (this.hasPattern) { this.features.push(addPatternDependencies('fill-extrusion', this.layers, bucketFeature, this.zoom, options)); } else { this.addFeature(bucketFeature, bucketFeature.geometry, index, canonical, {}); } options.featureIndex.insert(feature, bucketFeature.geometry, index, sourceLayerIndex, this.index, true); } } addFeatures(options, canonical, imagePositions) { for (const feature of this.features) { const { geometry } = feature; this.addFeature(feature, geometry, feature.index, canonical, imagePositions); } } update(states, vtLayer, imagePositions) { if (!this.stateDependentLayers.length) return; this.programConfigurations.updatePaintArrays(states, vtLayer, this.stateDependentLayers, imagePositions); } isEmpty() { return this.layoutVertexArray.length === 0 && this.centroidVertexArray.length === 0; } uploadPending() { return !this.uploaded || this.programConfigurations.needsUpload; } upload(context) { if (!this.uploaded) { this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, members$2); this.centroidVertexBuffer = context.createVertexBuffer(this.centroidVertexArray, centroidAttributes.members, true); this.indexBuffer = context.createIndexBuffer(this.indexArray); } this.programConfigurations.upload(context); this.uploaded = true; } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.programConfigurations.destroy(); this.segments.destroy(); this.centroidVertexBuffer.destroy(); } addFeature(feature, geometry, index, canonical, imagePositions) { for (const polygon of classifyRings$1(geometry, EARCUT_MAX_RINGS)) { const centroid = { x: 0, y: 0, vertexCount: 0 }; let numVertices = 0; for (const ring of polygon) { numVertices += ring.length; } let segment = this.segments.prepareSegment(4, this.layoutVertexArray, this.indexArray); for (const ring of polygon) { if (ring.length === 0) { continue; } if (isEntirelyOutside(ring)) { continue; } let edgeDistance = 0; for (let p = 0; p < ring.length; p++) { const p1 = ring[p]; if (p >= 1) { const p2 = ring[p - 1]; if (!isBoundaryEdge(p1, p2)) { if (segment.vertexLength + 4 > SegmentVector.MAX_VERTEX_ARRAY_LENGTH) { segment = this.segments.prepareSegment(4, this.layoutVertexArray, this.indexArray); } const perp = p1.sub(p2)._perp()._unit(); const dist = p2.dist(p1); if (edgeDistance + dist > 32768) edgeDistance = 0; addVertex$1(this.layoutVertexArray, p1.x, p1.y, perp.x, perp.y, 0, 0, edgeDistance); addVertex$1(this.layoutVertexArray, p1.x, p1.y, perp.x, perp.y, 0, 1, edgeDistance); centroid.x += 2 * p1.x; centroid.y += 2 * p1.y; centroid.vertexCount += 2; edgeDistance += dist; addVertex$1(this.layoutVertexArray, p2.x, p2.y, perp.x, perp.y, 0, 0, edgeDistance); addVertex$1(this.layoutVertexArray, p2.x, p2.y, perp.x, perp.y, 0, 1, edgeDistance); centroid.x += 2 * p2.x; centroid.y += 2 * p2.y; centroid.vertexCount += 2; const bottomRight = segment.vertexLength; // ┌──────┐ // │ 0 1 │ Counter-clockwise winding order. // │ │ Triangle 1: 0 => 2 => 1 // │ 2 3 │ Triangle 2: 1 => 2 => 3 // └──────┘ this.indexArray.emplaceBack(bottomRight, bottomRight + 2, bottomRight + 1); this.indexArray.emplaceBack(bottomRight + 1, bottomRight + 2, bottomRight + 3); segment.vertexLength += 4; segment.primitiveLength += 2; } } } } if (segment.vertexLength + numVertices > SegmentVector.MAX_VERTEX_ARRAY_LENGTH) { segment = this.segments.prepareSegment(numVertices, this.layoutVertexArray, this.indexArray); } //Only triangulate and draw the area of the feature if it is a polygon //Other feature types (e.g. LineString) do not have area, so triangulation is pointless / undefined if (vectorTileFeatureTypes$2[feature.type] !== 'Polygon') continue; const flattened = []; const holeIndices = []; const triangleIndex = segment.vertexLength; for (const ring of polygon) { if (ring.length === 0) { continue; } if (ring !== polygon[0]) { holeIndices.push(flattened.length / 2); } for (let i = 0; i < ring.length; i++) { const p = ring[i]; addVertex$1(this.layoutVertexArray, p.x, p.y, 0, 0, 1, 1, 0); centroid.x += p.x; centroid.y += p.y; centroid.vertexCount += 1; flattened.push(p.x); flattened.push(p.y); } } const indices = earcut(flattened, holeIndices); for (let j = 0; j < indices.length; j += 3) { // Counter-clockwise winding order. this.indexArray.emplaceBack(triangleIndex + indices[j], triangleIndex + indices[j + 2], triangleIndex + indices[j + 1]); } segment.primitiveLength += indices.length / 3; segment.vertexLength += numVertices; // remember polygon centroid to calculate elevation in GPU for (let i = 0; i < centroid.vertexCount; i++) { const averageX = Math.floor(centroid.x / centroid.vertexCount); const averageY = Math.floor(centroid.y / centroid.vertexCount); this.centroidVertexArray.emplaceBack(averageX, averageY); } } this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length, feature, index, imagePositions, canonical); } } register('FillExtrusionBucket', FillExtrusionBucket, { omit: ['layers', 'features'] }); function isBoundaryEdge(p1, p2) { return (p1.x === p2.x && (p1.x < 0 || p1.x > EXTENT)) || (p1.y === p2.y && (p1.y < 0 || p1.y > EXTENT)); } function isEntirelyOutside(ring) { return ring.every(p => p.x < 0) || ring.every(p => p.x > EXTENT) || ring.every(p => p.y < 0) || ring.every(p => p.y > EXTENT); } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let paint$4; const getPaint$4 = () => paint$4 = paint$4 || new Properties({ "fill-extrusion-opacity": new DataConstantProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-opacity"]), "fill-extrusion-color": new DataDrivenProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-color"]), "fill-extrusion-translate": new DataConstantProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-translate"]), "fill-extrusion-translate-anchor": new DataConstantProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-translate-anchor"]), "fill-extrusion-pattern": new CrossFadedDataDrivenProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-pattern"]), "fill-extrusion-height": new DataDrivenProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-height"]), "fill-extrusion-base": new DataDrivenProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-base"]), "fill-extrusion-vertical-gradient": new DataConstantProperty(v8Spec["paint_fill-extrusion"]["fill-extrusion-vertical-gradient"]), }); var properties$5 = ({ get paint() { return getPaint$4(); } }); class Point3D extends Point$2 { } class FillExtrusionStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$5); } createBucket(parameters) { return new FillExtrusionBucket(parameters); } queryRadius() { return translateDistance(this.paint.get('fill-extrusion-translate')); } is3D() { return true; } queryIntersectsFeature(queryGeometry, feature, featureState, geometry, zoom, transform, pixelsToTileUnits, pixelPosMatrix) { const translatedPolygon = translate$4(queryGeometry, this.paint.get('fill-extrusion-translate'), this.paint.get('fill-extrusion-translate-anchor'), transform.angle, pixelsToTileUnits); const height = this.paint.get('fill-extrusion-height').evaluate(feature, featureState); const base = this.paint.get('fill-extrusion-base').evaluate(feature, featureState); const projectedQueryGeometry = projectQueryGeometry(translatedPolygon, pixelPosMatrix, transform, 0); const projected = projectExtrusion(geometry, base, height, pixelPosMatrix); const projectedBase = projected[0]; const projectedTop = projected[1]; return checkIntersection(projectedBase, projectedTop, projectedQueryGeometry); } } function dot(a, b) { return a.x * b.x + a.y * b.y; } function getIntersectionDistance(projectedQueryGeometry, projectedFace) { if (projectedQueryGeometry.length === 1) { // For point queries calculate the z at which the point intersects the face // using barycentric coordinates. // Find the barycentric coordinates of the projected point within the first // triangle of the face, using only the xy plane. It doesn't matter if the // point is outside the first triangle because all the triangles in the face // are in the same plane. // // Check whether points are coincident and use other points if they are. let i = 0; const a = projectedFace[i++]; let b; while (!b || a.equals(b)) { b = projectedFace[i++]; if (!b) return Infinity; } // Loop until point `c` is not colinear with points `a` and `b`. for (; i < projectedFace.length; i++) { const c = projectedFace[i]; const p = projectedQueryGeometry[0]; const ab = b.sub(a); const ac = c.sub(a); const ap = p.sub(a); const dotABAB = dot(ab, ab); const dotABAC = dot(ab, ac); const dotACAC = dot(ac, ac); const dotAPAB = dot(ap, ab); const dotAPAC = dot(ap, ac); const denom = dotABAB * dotACAC - dotABAC * dotABAC; const v = (dotACAC * dotAPAB - dotABAC * dotAPAC) / denom; const w = (dotABAB * dotAPAC - dotABAC * dotAPAB) / denom; const u = 1 - v - w; // Use the barycentric weighting along with the original triangle z coordinates to get the point of intersection. const distance = a.z * u + b.z * v + c.z * w; if (isFinite(distance)) return distance; } return Infinity; } else { // The counts as closest is less clear when the query is a box. This // returns the distance to the nearest point on the face, whether it is // within the query or not. It could be more correct to return the // distance to the closest point within the query box but this would be // more complicated and expensive to calculate with little benefit. let closestDistance = Infinity; for (const p of projectedFace) { closestDistance = Math.min(closestDistance, p.z); } return closestDistance; } } function checkIntersection(projectedBase, projectedTop, projectedQueryGeometry) { let closestDistance = Infinity; if (polygonIntersectsMultiPolygon(projectedQueryGeometry, projectedTop)) { closestDistance = getIntersectionDistance(projectedQueryGeometry, projectedTop[0]); } for (let r = 0; r < projectedTop.length; r++) { const ringTop = projectedTop[r]; const ringBase = projectedBase[r]; for (let p = 0; p < ringTop.length - 1; p++) { const topA = ringTop[p]; const topB = ringTop[p + 1]; const baseA = ringBase[p]; const baseB = ringBase[p + 1]; const face = [topA, topB, baseB, baseA, topA]; if (polygonIntersectsPolygon(projectedQueryGeometry, face)) { closestDistance = Math.min(closestDistance, getIntersectionDistance(projectedQueryGeometry, face)); } } } return closestDistance === Infinity ? false : closestDistance; } /* * Project the geometry using matrix `m`. This is essentially doing * `vec4.transformMat4([], [p.x, p.y, z, 1], m)` but the multiplication * is inlined so that parts of the projection that are the same across * different points can only be done once. This produced a measurable * performance improvement. */ function projectExtrusion(geometry, zBase, zTop, m) { const projectedBase = []; const projectedTop = []; const baseXZ = m[8] * zBase; const baseYZ = m[9] * zBase; const baseZZ = m[10] * zBase; const baseWZ = m[11] * zBase; const topXZ = m[8] * zTop; const topYZ = m[9] * zTop; const topZZ = m[10] * zTop; const topWZ = m[11] * zTop; for (const r of geometry) { const ringBase = []; const ringTop = []; for (const p of r) { const x = p.x; const y = p.y; const sX = m[0] * x + m[4] * y + m[12]; const sY = m[1] * x + m[5] * y + m[13]; const sZ = m[2] * x + m[6] * y + m[14]; const sW = m[3] * x + m[7] * y + m[15]; const baseX = sX + baseXZ; const baseY = sY + baseYZ; const baseZ = sZ + baseZZ; const baseW = sW + baseWZ; const topX = sX + topXZ; const topY = sY + topYZ; const topZ = sZ + topZZ; const topW = sW + topWZ; const b = new Point$2(baseX / baseW, baseY / baseW); b.z = baseZ / baseW; ringBase.push(b); const t = new Point$2(topX / topW, topY / topW); t.z = topZ / topW; ringTop.push(t); } projectedBase.push(ringBase); projectedTop.push(ringTop); } return [projectedBase, projectedTop]; } function projectQueryGeometry(queryGeometry, pixelPosMatrix, transform, z) { const projectedQueryGeometry = []; for (const p of queryGeometry) { const v = [p.x, p.y, z, 1]; transformMat4$1(v, v, pixelPosMatrix); projectedQueryGeometry.push(new Point$2(v[0] / v[3], v[1] / v[3])); } return projectedQueryGeometry; } const lineLayoutAttributes = createLayout([ { name: 'a_pos_normal', components: 2, type: 'Int16' }, { name: 'a_data', components: 4, type: 'Uint8' } ], 4); const { members: members$1, size: size$1, alignment: alignment$1 } = lineLayoutAttributes; const lineLayoutAttributesExt = createLayout([ { name: 'a_uv_x', components: 1, type: 'Float32' }, { name: 'a_split_index', components: 1, type: 'Float32' }, ]); const { members, size, alignment } = lineLayoutAttributesExt; const vectorTileFeatureTypes$1 = vectorTile.VectorTileFeature.types; // NOTE ON EXTRUDE SCALE: // scale the extrusion vector so that the normal length is this value. // contains the "texture" normals (-1..1). this is distinct from the extrude // normals for line joins, because the x-value remains 0 for the texture // normal array, while the extrude normal actually moves the vertex to create // the acute/bevelled line join. const EXTRUDE_SCALE = 63; /* * Sharp corners cause dashed lines to tilt because the distance along the line * is the same at both the inner and outer corners. To improve the appearance of * dashed lines we add extra points near sharp corners so that a smaller part * of the line is tilted. * * COS_HALF_SHARP_CORNER controls how sharp a corner has to be for us to add an * extra vertex. The default is 75 degrees. * * The newly created vertices are placed SHARP_CORNER_OFFSET pixels from the corner. */ const COS_HALF_SHARP_CORNER = Math.cos(75 / 2 * (Math.PI / 180)); const SHARP_CORNER_OFFSET = 15; // Angle per triangle for approximating round line joins. const DEG_PER_TRIANGLE = 20; // The number of bits that is used to store the line distance in the buffer. const LINE_DISTANCE_BUFFER_BITS = 15; // We don't have enough bits for the line distance as we'd like to have, so // use this value to scale the line distance (in tile units) down to a smaller // value. This lets us store longer distances while sacrificing precision. const LINE_DISTANCE_SCALE = 1 / 2; // The maximum line distance, in tile units, that fits in the buffer. const MAX_LINE_DISTANCE = Math.pow(2, LINE_DISTANCE_BUFFER_BITS - 1) / LINE_DISTANCE_SCALE; /** * @internal * Line bucket class */ class LineBucket { constructor(options) { this.zoom = options.zoom; this.overscaling = options.overscaling; this.layers = options.layers; this.layerIds = this.layers.map(layer => layer.id); this.index = options.index; this.hasPattern = false; this.patternFeatures = []; this.lineClipsArray = []; this.gradients = {}; this.layers.forEach(layer => { this.gradients[layer.id] = {}; }); this.layoutVertexArray = new LineLayoutArray(); this.layoutVertexArray2 = new LineExtLayoutArray(); this.indexArray = new TriangleIndexArray(); this.programConfigurations = new ProgramConfigurationSet(options.layers, options.zoom); this.segments = new SegmentVector(); this.maxLineLength = 0; this.stateDependentLayerIds = this.layers.filter((l) => l.isStateDependent()).map((l) => l.id); } populate(features, options, canonical) { this.hasPattern = hasPattern('line', this.layers, options); const lineSortKey = this.layers[0].layout.get('line-sort-key'); const sortFeaturesByKey = !lineSortKey.isConstant(); const bucketFeatures = []; for (const { feature, id, index, sourceLayerIndex } of features) { const needGeometry = this.layers[0]._featureFilter.needGeometry; const evaluationFeature = toEvaluationFeature(feature, needGeometry); if (!this.layers[0]._featureFilter.filter(new EvaluationParameters(this.zoom), evaluationFeature, canonical)) continue; const sortKey = sortFeaturesByKey ? lineSortKey.evaluate(evaluationFeature, {}, canonical) : undefined; const bucketFeature = { id, properties: feature.properties, type: feature.type, sourceLayerIndex, index, geometry: needGeometry ? evaluationFeature.geometry : loadGeometry(feature), patterns: {}, sortKey }; bucketFeatures.push(bucketFeature); } if (sortFeaturesByKey) { bucketFeatures.sort((a, b) => { return (a.sortKey) - (b.sortKey); }); } for (const bucketFeature of bucketFeatures) { const { geometry, index, sourceLayerIndex } = bucketFeature; if (this.hasPattern) { const patternBucketFeature = addPatternDependencies('line', this.layers, bucketFeature, this.zoom, options); // pattern features are added only once the pattern is loaded into the image atlas // so are stored during populate until later updated with positions by tile worker in addFeatures this.patternFeatures.push(patternBucketFeature); } else { this.addFeature(bucketFeature, geometry, index, canonical, {}); } const feature = features[index].feature; options.featureIndex.insert(feature, geometry, index, sourceLayerIndex, this.index); } } update(states, vtLayer, imagePositions) { if (!this.stateDependentLayers.length) return; this.programConfigurations.updatePaintArrays(states, vtLayer, this.stateDependentLayers, imagePositions); } addFeatures(options, canonical, imagePositions) { for (const feature of this.patternFeatures) { this.addFeature(feature, feature.geometry, feature.index, canonical, imagePositions); } } isEmpty() { return this.layoutVertexArray.length === 0; } uploadPending() { return !this.uploaded || this.programConfigurations.needsUpload; } upload(context) { if (!this.uploaded) { if (this.layoutVertexArray2.length !== 0) { this.layoutVertexBuffer2 = context.createVertexBuffer(this.layoutVertexArray2, members); } this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, members$1); this.indexBuffer = context.createIndexBuffer(this.indexArray); } this.programConfigurations.upload(context); this.uploaded = true; } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.programConfigurations.destroy(); this.segments.destroy(); } lineFeatureClips(feature) { if (!!feature.properties && Object.prototype.hasOwnProperty.call(feature.properties, 'mapbox_clip_start') && Object.prototype.hasOwnProperty.call(feature.properties, 'mapbox_clip_end')) { const start = +feature.properties['mapbox_clip_start']; const end = +feature.properties['mapbox_clip_end']; return { start, end }; } } addFeature(feature, geometry, index, canonical, imagePositions) { const layout = this.layers[0].layout; const join = layout.get('line-join').evaluate(feature, {}); const cap = layout.get('line-cap'); const miterLimit = layout.get('line-miter-limit'); const roundLimit = layout.get('line-round-limit'); this.lineClips = this.lineFeatureClips(feature); for (const line of geometry) { this.addLine(line, feature, join, cap, miterLimit, roundLimit); } this.programConfigurations.populatePaintArrays(this.layoutVertexArray.length, feature, index, imagePositions, canonical); } addLine(vertices, feature, join, cap, miterLimit, roundLimit) { this.distance = 0; this.scaledDistance = 0; this.totalDistance = 0; if (this.lineClips) { this.lineClipsArray.push(this.lineClips); // Calculate the total distance, in tile units, of this tiled line feature for (let i = 0; i < vertices.length - 1; i++) { this.totalDistance += vertices[i].dist(vertices[i + 1]); } this.updateScaledDistance(); this.maxLineLength = Math.max(this.maxLineLength, this.totalDistance); } const isPolygon = vectorTileFeatureTypes$1[feature.type] === 'Polygon'; // If the line has duplicate vertices at the ends, adjust start/length to remove them. let len = vertices.length; while (len >= 2 && vertices[len - 1].equals(vertices[len - 2])) { len--; } let first = 0; while (first < len - 1 && vertices[first].equals(vertices[first + 1])) { first++; } // Ignore invalid geometry. if (len < (isPolygon ? 3 : 2)) return; if (join === 'bevel') miterLimit = 1.05; const sharpCornerOffset = this.overscaling <= 16 ? SHARP_CORNER_OFFSET * EXTENT / (512 * this.overscaling) : 0; // we could be more precise, but it would only save a negligible amount of space const segment = this.segments.prepareSegment(len * 10, this.layoutVertexArray, this.indexArray); let currentVertex; let prevVertex; let nextVertex; let prevNormal; let nextNormal; // the last two vertices added this.e1 = this.e2 = -1; if (isPolygon) { currentVertex = vertices[len - 2]; nextNormal = vertices[first].sub(currentVertex)._unit()._perp(); } for (let i = first; i < len; i++) { nextVertex = i === len - 1 ? (isPolygon ? vertices[first + 1] : undefined) : // if it's a polygon, treat the last vertex like the first vertices[i + 1]; // just the next vertex // if two consecutive vertices exist, skip the current one if (nextVertex && vertices[i].equals(nextVertex)) continue; if (nextNormal) prevNormal = nextNormal; if (currentVertex) prevVertex = currentVertex; currentVertex = vertices[i]; // Calculate the normal towards the next vertex in this line. In case // there is no next vertex, pretend that the line is continuing straight, // meaning that we are just using the previous normal. nextNormal = nextVertex ? nextVertex.sub(currentVertex)._unit()._perp() : prevNormal; // If we still don't have a previous normal, this is the beginning of a // non-closed line, so we're doing a straight "join". prevNormal = prevNormal || nextNormal; // Determine the normal of the join extrusion. It is the angle bisector // of the segments between the previous line and the next line. // In the case of 180° angles, the prev and next normals cancel each other out: // prevNormal + nextNormal = (0, 0), its magnitude is 0, so the unit vector would be // undefined. In that case, we're keeping the joinNormal at (0, 0), so that the cosHalfAngle // below will also become 0 and miterLength will become Infinity. let joinNormal = prevNormal.add(nextNormal); if (joinNormal.x !== 0 || joinNormal.y !== 0) { joinNormal._unit(); } /* joinNormal prevNormal * ↖ ↑ * .________. prevVertex * | * nextNormal ← | currentVertex * | * nextVertex ! * */ // calculate cosines of the angle (and its half) using dot product const cosAngle = prevNormal.x * nextNormal.x + prevNormal.y * nextNormal.y; const cosHalfAngle = joinNormal.x * nextNormal.x + joinNormal.y * nextNormal.y; // Calculate the length of the miter (the ratio of the miter to the width) // as the inverse of cosine of the angle between next and join normals const miterLength = cosHalfAngle !== 0 ? 1 / cosHalfAngle : Infinity; // approximate angle from cosine const approxAngle = 2 * Math.sqrt(2 - 2 * cosHalfAngle); const isSharpCorner = cosHalfAngle < COS_HALF_SHARP_CORNER && prevVertex && nextVertex; const lineTurnsLeft = prevNormal.x * nextNormal.y - prevNormal.y * nextNormal.x > 0; if (isSharpCorner && i > first) { const prevSegmentLength = currentVertex.dist(prevVertex); if (prevSegmentLength > 2 * sharpCornerOffset) { const newPrevVertex = currentVertex.sub(currentVertex.sub(prevVertex)._mult(sharpCornerOffset / prevSegmentLength)._round()); this.updateDistance(prevVertex, newPrevVertex); this.addCurrentVertex(newPrevVertex, prevNormal, 0, 0, segment); prevVertex = newPrevVertex; } } // The join if a middle vertex, otherwise the cap. const middleVertex = prevVertex && nextVertex; let currentJoin = middleVertex ? join : isPolygon ? 'butt' : cap; if (middleVertex && currentJoin === 'round') { if (miterLength < roundLimit) { currentJoin = 'miter'; } else if (miterLength <= 2) { currentJoin = 'fakeround'; } } if (currentJoin === 'miter' && miterLength > miterLimit) { currentJoin = 'bevel'; } if (currentJoin === 'bevel') { // The maximum extrude length is 128 / 63 = 2 times the width of the line // so if miterLength >= 2 we need to draw a different type of bevel here. if (miterLength > 2) currentJoin = 'flipbevel'; // If the miterLength is really small and the line bevel wouldn't be visible, // just draw a miter join to save a triangle. if (miterLength < miterLimit) currentJoin = 'miter'; } // Calculate how far along the line the currentVertex is if (prevVertex) this.updateDistance(prevVertex, currentVertex); if (currentJoin === 'miter') { joinNormal._mult(miterLength); this.addCurrentVertex(currentVertex, joinNormal, 0, 0, segment); } else if (currentJoin === 'flipbevel') { // miter is too big, flip the direction to make a beveled join if (miterLength > 100) { // Almost parallel lines joinNormal = nextNormal.mult(-1); } else { const bevelLength = miterLength * prevNormal.add(nextNormal).mag() / prevNormal.sub(nextNormal).mag(); joinNormal._perp()._mult(bevelLength * (lineTurnsLeft ? -1 : 1)); } this.addCurrentVertex(currentVertex, joinNormal, 0, 0, segment); this.addCurrentVertex(currentVertex, joinNormal.mult(-1), 0, 0, segment); } else if (currentJoin === 'bevel' || currentJoin === 'fakeround') { const offset = -Math.sqrt(miterLength * miterLength - 1); const offsetA = lineTurnsLeft ? offset : 0; const offsetB = lineTurnsLeft ? 0 : offset; // Close previous segment with a bevel if (prevVertex) { this.addCurrentVertex(currentVertex, prevNormal, offsetA, offsetB, segment); } if (currentJoin === 'fakeround') { // The join angle is sharp enough that a round join would be visible. // Bevel joins fill the gap between segments with a single pie slice triangle. // Create a round join by adding multiple pie slices. The join isn't actually round, but // it looks like it is at the sizes we render lines at. // pick the number of triangles for approximating round join by based on the angle between normals const n = Math.round((approxAngle * 180 / Math.PI) / DEG_PER_TRIANGLE); for (let m = 1; m < n; m++) { let t = m / n; if (t !== 0.5) { // approximate spherical interpolation https://observablehq.com/@mourner/approximating-geometric-slerp const t2 = t - 0.5; const A = 1.0904 + cosAngle * (-3.2452 + cosAngle * (3.55645 - cosAngle * 1.43519)); const B = 0.848013 + cosAngle * (-1.06021 + cosAngle * 0.215638); t = t + t * t2 * (t - 1) * (A * t2 * t2 + B); } const extrude = nextNormal.sub(prevNormal)._mult(t)._add(prevNormal)._unit()._mult(lineTurnsLeft ? -1 : 1); this.addHalfVertex(currentVertex, extrude.x, extrude.y, false, lineTurnsLeft, 0, segment); } } if (nextVertex) { // Start next segment this.addCurrentVertex(currentVertex, nextNormal, -offsetA, -offsetB, segment); } } else if (currentJoin === 'butt') { this.addCurrentVertex(currentVertex, joinNormal, 0, 0, segment); // butt cap } else if (currentJoin === 'square') { const offset = prevVertex ? 1 : -1; // closing or starting square cap this.addCurrentVertex(currentVertex, joinNormal, offset, offset, segment); } else if (currentJoin === 'round') { if (prevVertex) { // Close previous segment with butt this.addCurrentVertex(currentVertex, prevNormal, 0, 0, segment); // Add round cap or linejoin at end of segment this.addCurrentVertex(currentVertex, prevNormal, 1, 1, segment, true); } if (nextVertex) { // Add round cap before first segment this.addCurrentVertex(currentVertex, nextNormal, -1, -1, segment, true); // Start next segment with a butt this.addCurrentVertex(currentVertex, nextNormal, 0, 0, segment); } } if (isSharpCorner && i < len - 1) { const nextSegmentLength = currentVertex.dist(nextVertex); if (nextSegmentLength > 2 * sharpCornerOffset) { const newCurrentVertex = currentVertex.add(nextVertex.sub(currentVertex)._mult(sharpCornerOffset / nextSegmentLength)._round()); this.updateDistance(currentVertex, newCurrentVertex); this.addCurrentVertex(newCurrentVertex, nextNormal, 0, 0, segment); currentVertex = newCurrentVertex; } } } } /** * Add two vertices to the buffers. * * @param p - the line vertex to add buffer vertices for * @param normal - vertex normal * @param endLeft - extrude to shift the left vertex along the line * @param endRight - extrude to shift the left vertex along the line * @param segment - the segment object to add the vertex to * @param round - whether this is a round cap */ addCurrentVertex(p, normal, endLeft, endRight, segment, round = false) { // left and right extrude vectors, perpendicularly shifted by endLeft/endRight const leftX = normal.x + normal.y * endLeft; const leftY = normal.y - normal.x * endLeft; const rightX = -normal.x + normal.y * endRight; const rightY = -normal.y - normal.x * endRight; this.addHalfVertex(p, leftX, leftY, round, false, endLeft, segment); this.addHalfVertex(p, rightX, rightY, round, true, -endRight, segment); // There is a maximum "distance along the line" that we can store in the buffers. // When we get close to the distance, reset it to zero and add the vertex again with // a distance of zero. The max distance is determined by the number of bits we allocate // to `linesofar`. if (this.distance > MAX_LINE_DISTANCE / 2 && this.totalDistance === 0) { this.distance = 0; this.updateScaledDistance(); this.addCurrentVertex(p, normal, endLeft, endRight, segment, round); } } addHalfVertex({ x, y }, extrudeX, extrudeY, round, up, dir, segment) { const totalDistance = this.lineClips ? this.scaledDistance * (MAX_LINE_DISTANCE - 1) : this.scaledDistance; // scale down so that we can store longer distances while sacrificing precision. const linesofarScaled = totalDistance * LINE_DISTANCE_SCALE; this.layoutVertexArray.emplaceBack( // a_pos_normal // Encode round/up the least significant bits (x << 1) + (round ? 1 : 0), (y << 1) + (up ? 1 : 0), // a_data // add 128 to store a byte in an unsigned byte Math.round(EXTRUDE_SCALE * extrudeX) + 128, Math.round(EXTRUDE_SCALE * extrudeY) + 128, // Encode the -1/0/1 direction value into the first two bits of .z of a_data. // Combine it with the lower 6 bits of `linesofarScaled` (shifted by 2 bits to make // room for the direction value). The upper 8 bits of `linesofarScaled` are placed in // the `w` component. ((dir === 0 ? 0 : (dir < 0 ? -1 : 1)) + 1) | ((linesofarScaled & 0x3F) << 2), linesofarScaled >> 6); // Constructs a second vertex buffer with higher precision line progress if (this.lineClips) { const progressRealigned = this.scaledDistance - this.lineClips.start; const endClipRealigned = this.lineClips.end - this.lineClips.start; const uvX = progressRealigned / endClipRealigned; this.layoutVertexArray2.emplaceBack(uvX, this.lineClipsArray.length); } const e = segment.vertexLength++; if (this.e1 >= 0 && this.e2 >= 0) { this.indexArray.emplaceBack(this.e1, this.e2, e); segment.primitiveLength++; } if (up) { this.e2 = e; } else { this.e1 = e; } } updateScaledDistance() { // Knowing the ratio of the full linestring covered by this tiled feature, as well // as the total distance (in tile units) of this tiled feature, and the distance // (in tile units) of the current vertex, we can determine the relative distance // of this vertex along the full linestring feature and scale it to [0, 2^15) this.scaledDistance = this.lineClips ? this.lineClips.start + (this.lineClips.end - this.lineClips.start) * this.distance / this.totalDistance : this.distance; } updateDistance(prev, next) { this.distance += prev.dist(next); this.updateScaledDistance(); } } register('LineBucket', LineBucket, { omit: ['layers', 'patternFeatures'] }); // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let layout$1; const getLayout$1 = () => layout$1 = layout$1 || new Properties({ "line-cap": new DataConstantProperty(v8Spec["layout_line"]["line-cap"]), "line-join": new DataDrivenProperty(v8Spec["layout_line"]["line-join"]), "line-miter-limit": new DataConstantProperty(v8Spec["layout_line"]["line-miter-limit"]), "line-round-limit": new DataConstantProperty(v8Spec["layout_line"]["line-round-limit"]), "line-sort-key": new DataDrivenProperty(v8Spec["layout_line"]["line-sort-key"]), }); let paint$3; const getPaint$3 = () => paint$3 = paint$3 || new Properties({ "line-opacity": new DataDrivenProperty(v8Spec["paint_line"]["line-opacity"]), "line-color": new DataDrivenProperty(v8Spec["paint_line"]["line-color"]), "line-translate": new DataConstantProperty(v8Spec["paint_line"]["line-translate"]), "line-translate-anchor": new DataConstantProperty(v8Spec["paint_line"]["line-translate-anchor"]), "line-width": new DataDrivenProperty(v8Spec["paint_line"]["line-width"]), "line-gap-width": new DataDrivenProperty(v8Spec["paint_line"]["line-gap-width"]), "line-offset": new DataDrivenProperty(v8Spec["paint_line"]["line-offset"]), "line-blur": new DataDrivenProperty(v8Spec["paint_line"]["line-blur"]), "line-dasharray": new CrossFadedProperty(v8Spec["paint_line"]["line-dasharray"]), "line-pattern": new CrossFadedDataDrivenProperty(v8Spec["paint_line"]["line-pattern"]), "line-gradient": new ColorRampProperty(v8Spec["paint_line"]["line-gradient"]), }); var properties$4 = ({ get paint() { return getPaint$3(); }, get layout() { return getLayout$1(); } }); class LineFloorwidthProperty extends DataDrivenProperty { possiblyEvaluate(value, parameters) { parameters = new EvaluationParameters(Math.floor(parameters.zoom), { now: parameters.now, fadeDuration: parameters.fadeDuration, zoomHistory: parameters.zoomHistory, transition: parameters.transition }); return super.possiblyEvaluate(value, parameters); } evaluate(value, globals, feature, featureState) { globals = extend({}, globals, { zoom: Math.floor(globals.zoom) }); return super.evaluate(value, globals, feature, featureState); } } let lineFloorwidthProperty; class LineStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$4); this.gradientVersion = 0; if (!lineFloorwidthProperty) { lineFloorwidthProperty = new LineFloorwidthProperty(properties$4.paint.properties['line-width'].specification); lineFloorwidthProperty.useIntegerZoom = true; } } _handleSpecialPaintPropertyUpdate(name) { if (name === 'line-gradient') { const expression = this.gradientExpression(); if (isZoomExpression(expression)) { this.stepInterpolant = expression._styleExpression.expression instanceof Step; } else { this.stepInterpolant = false; } this.gradientVersion = (this.gradientVersion + 1) % Number.MAX_SAFE_INTEGER; } } gradientExpression() { return this._transitionablePaint._values['line-gradient'].value.expression; } recalculate(parameters, availableImages) { super.recalculate(parameters, availableImages); this.paint._values['line-floorwidth'] = lineFloorwidthProperty.possiblyEvaluate(this._transitioningPaint._values['line-width'].value, parameters); } createBucket(parameters) { return new LineBucket(parameters); } queryRadius(bucket) { const lineBucket = bucket; const width = getLineWidth(getMaximumPaintValue('line-width', this, lineBucket), getMaximumPaintValue('line-gap-width', this, lineBucket)); const offset = getMaximumPaintValue('line-offset', this, lineBucket); return width / 2 + Math.abs(offset) + translateDistance(this.paint.get('line-translate')); } queryIntersectsFeature(queryGeometry, feature, featureState, geometry, zoom, transform, pixelsToTileUnits) { const translatedPolygon = translate$4(queryGeometry, this.paint.get('line-translate'), this.paint.get('line-translate-anchor'), transform.angle, pixelsToTileUnits); const halfWidth = pixelsToTileUnits / 2 * getLineWidth(this.paint.get('line-width').evaluate(feature, featureState), this.paint.get('line-gap-width').evaluate(feature, featureState)); const lineOffset = this.paint.get('line-offset').evaluate(feature, featureState); if (lineOffset) { geometry = offsetLine(geometry, lineOffset * pixelsToTileUnits); } return polygonIntersectsBufferedMultiLine(translatedPolygon, geometry, halfWidth); } isTileClipped() { return true; } } function getLineWidth(lineWidth, lineGapWidth) { if (lineGapWidth > 0) { return lineGapWidth + 2 * lineWidth; } else { return lineWidth; } } const symbolLayoutAttributes = createLayout([ { name: 'a_pos_offset', components: 4, type: 'Int16' }, { name: 'a_data', components: 4, type: 'Uint16' }, { name: 'a_pixeloffset', components: 4, type: 'Int16' } ], 4); const dynamicLayoutAttributes = createLayout([ { name: 'a_projected_pos', components: 3, type: 'Float32' } ], 4); const placementOpacityAttributes = createLayout([ { name: 'a_fade_opacity', components: 1, type: 'Uint32' } ], 4); const collisionVertexAttributes = createLayout([ { name: 'a_placed', components: 2, type: 'Uint8' }, { name: 'a_shift', components: 2, type: 'Float32' }, { name: 'a_box_real', components: 2, type: 'Int16' }, ]); const collisionBox = createLayout([ // the box is centered around the anchor point { type: 'Int16', name: 'anchorPointX' }, { type: 'Int16', name: 'anchorPointY' }, // distances to the edges from the anchor { type: 'Int16', name: 'x1' }, { type: 'Int16', name: 'y1' }, { type: 'Int16', name: 'x2' }, { type: 'Int16', name: 'y2' }, // the index of the feature in the original vectortile { type: 'Uint32', name: 'featureIndex' }, // the source layer the feature appears in { type: 'Uint16', name: 'sourceLayerIndex' }, // the bucket the feature appears in { type: 'Uint16', name: 'bucketIndex' }, ]); const collisionBoxLayout = createLayout([ { name: 'a_pos', components: 2, type: 'Int16' }, { name: 'a_anchor_pos', components: 2, type: 'Int16' }, { name: 'a_extrude', components: 2, type: 'Int16' } ], 4); const collisionCircleLayout = createLayout([ { name: 'a_pos', components: 2, type: 'Float32' }, { name: 'a_radius', components: 1, type: 'Float32' }, { name: 'a_flags', components: 2, type: 'Int16' } ], 4); const quadTriangle = createLayout([ { name: 'triangle', components: 3, type: 'Uint16' }, ]); const placement = createLayout([ { type: 'Int16', name: 'anchorX' }, { type: 'Int16', name: 'anchorY' }, { type: 'Uint16', name: 'glyphStartIndex' }, { type: 'Uint16', name: 'numGlyphs' }, { type: 'Uint32', name: 'vertexStartIndex' }, { type: 'Uint32', name: 'lineStartIndex' }, { type: 'Uint32', name: 'lineLength' }, { type: 'Uint16', name: 'segment' }, { type: 'Uint16', name: 'lowerSize' }, { type: 'Uint16', name: 'upperSize' }, { type: 'Float32', name: 'lineOffsetX' }, { type: 'Float32', name: 'lineOffsetY' }, { type: 'Uint8', name: 'writingMode' }, { type: 'Uint8', name: 'placedOrientation' }, { type: 'Uint8', name: 'hidden' }, { type: 'Uint32', name: 'crossTileID' }, { type: 'Int16', name: 'associatedIconIndex' } ]); const symbolInstance = createLayout([ { type: 'Int16', name: 'anchorX' }, { type: 'Int16', name: 'anchorY' }, { type: 'Int16', name: 'rightJustifiedTextSymbolIndex' }, { type: 'Int16', name: 'centerJustifiedTextSymbolIndex' }, { type: 'Int16', name: 'leftJustifiedTextSymbolIndex' }, { type: 'Int16', name: 'verticalPlacedTextSymbolIndex' }, { type: 'Int16', name: 'placedIconSymbolIndex' }, { type: 'Int16', name: 'verticalPlacedIconSymbolIndex' }, { type: 'Uint16', name: 'key' }, { type: 'Uint16', name: 'textBoxStartIndex' }, { type: 'Uint16', name: 'textBoxEndIndex' }, { type: 'Uint16', name: 'verticalTextBoxStartIndex' }, { type: 'Uint16', name: 'verticalTextBoxEndIndex' }, { type: 'Uint16', name: 'iconBoxStartIndex' }, { type: 'Uint16', name: 'iconBoxEndIndex' }, { type: 'Uint16', name: 'verticalIconBoxStartIndex' }, { type: 'Uint16', name: 'verticalIconBoxEndIndex' }, { type: 'Uint16', name: 'featureIndex' }, { type: 'Uint16', name: 'numHorizontalGlyphVertices' }, { type: 'Uint16', name: 'numVerticalGlyphVertices' }, { type: 'Uint16', name: 'numIconVertices' }, { type: 'Uint16', name: 'numVerticalIconVertices' }, { type: 'Uint16', name: 'useRuntimeCollisionCircles' }, { type: 'Uint32', name: 'crossTileID' }, { type: 'Float32', name: 'textBoxScale' }, { type: 'Float32', name: 'collisionCircleDiameter' }, { type: 'Uint16', name: 'textAnchorOffsetStartIndex' }, { type: 'Uint16', name: 'textAnchorOffsetEndIndex' } ]); const glyphOffset = createLayout([ { type: 'Float32', name: 'offsetX' } ]); const lineVertex = createLayout([ { type: 'Int16', name: 'x' }, { type: 'Int16', name: 'y' }, { type: 'Int16', name: 'tileUnitDistanceFromAnchor' } ]); const textAnchorOffset = createLayout([ { type: 'Uint16', name: 'textAnchor' }, { type: 'Float32', components: 2, name: 'textOffset' } ]); function transformTextInternal(text, layer, feature) { const transform = layer.layout.get('text-transform').evaluate(feature, {}); if (transform === 'uppercase') { text = text.toLocaleUpperCase(); } else if (transform === 'lowercase') { text = text.toLocaleLowerCase(); } if (rtlWorkerPlugin.applyArabicShaping) { text = rtlWorkerPlugin.applyArabicShaping(text); } return text; } function transformText(text, layer, feature) { text.sections.forEach(section => { section.text = transformTextInternal(section.text, layer, feature); }); return text; } function mergeLines(features) { const leftIndex = {}; const rightIndex = {}; const mergedFeatures = []; let mergedIndex = 0; function add(k) { mergedFeatures.push(features[k]); mergedIndex++; } function mergeFromRight(leftKey, rightKey, geom) { const i = rightIndex[leftKey]; delete rightIndex[leftKey]; rightIndex[rightKey] = i; mergedFeatures[i].geometry[0].pop(); mergedFeatures[i].geometry[0] = mergedFeatures[i].geometry[0].concat(geom[0]); return i; } function mergeFromLeft(leftKey, rightKey, geom) { const i = leftIndex[rightKey]; delete leftIndex[rightKey]; leftIndex[leftKey] = i; mergedFeatures[i].geometry[0].shift(); mergedFeatures[i].geometry[0] = geom[0].concat(mergedFeatures[i].geometry[0]); return i; } function getKey(text, geom, onRight) { const point = onRight ? geom[0][geom[0].length - 1] : geom[0][0]; return `${text}:${point.x}:${point.y}`; } for (let k = 0; k < features.length; k++) { const feature = features[k]; const geom = feature.geometry; const text = feature.text ? feature.text.toString() : null; if (!text) { add(k); continue; } const leftKey = getKey(text, geom), rightKey = getKey(text, geom, true); if ((leftKey in rightIndex) && (rightKey in leftIndex) && (rightIndex[leftKey] !== leftIndex[rightKey])) { // found lines with the same text adjacent to both ends of the current line, merge all three const j = mergeFromLeft(leftKey, rightKey, geom); const i = mergeFromRight(leftKey, rightKey, mergedFeatures[j].geometry); delete leftIndex[leftKey]; delete rightIndex[rightKey]; rightIndex[getKey(text, mergedFeatures[i].geometry, true)] = i; mergedFeatures[j].geometry = null; } else if (leftKey in rightIndex) { // found mergeable line adjacent to the start of the current line, merge mergeFromRight(leftKey, rightKey, geom); } else if (rightKey in leftIndex) { // found mergeable line adjacent to the end of the current line, merge mergeFromLeft(leftKey, rightKey, geom); } else { // no adjacent lines, add as a new item add(k); leftIndex[leftKey] = mergedIndex - 1; rightIndex[rightKey] = mergedIndex - 1; } } return mergedFeatures.filter((f) => f.geometry); } const verticalizedCharacterMap = { '!': '︕', '#': '＃', '$': '＄', '%': '％', '&': '＆', '(': '︵', ')': '︶', '*': '＊', '+': '＋', ',': '︐', '-': '︲', '.': '・', '/': '／', ':': '︓', ';': '︔', '<': '︿', '=': '＝', '>': '﹀', '?': '︖', '@': '＠', '[': '﹇', '\\': '＼', ']': '﹈', '^': '＾', '_': '︳', '`': '｀', '{': '︷', '|': '―', '}': '︸', '~': '～', '¢': '￠', '£': '￡', '¥': '￥', '¦': '￤', '¬': '￢', '¯': '￣', '–': '︲', '—': '︱', '‘': '﹃', '’': '﹄', '“': '﹁', '”': '﹂', '…': '︙', '‧': '・', '₩': '￦', '、': '︑', '。': '︒', '〈': '︿', '〉': '﹀', '《': '︽', '》': '︾', '「': '﹁', '」': '﹂', '『': '﹃', '』': '﹄', '【': '︻', '】': '︼', '〔': '︹', '〕': '︺', '〖': '︗', '〗': '︘', '！': '︕', '（': '︵', '）': '︶', '，': '︐', '－': '︲', '．': '・', '：': '︓', '；': '︔', '＜': '︿', '＞': '﹀', '？': '︖', '［': '﹇', '］': '﹈', '＿': '︳', '｛': '︷', '｜': '―', '｝': '︸', '｟': '︵', '｠': '︶', '｡': '︒', '｢': '﹁', '｣': '﹂' }; function verticalizePunctuation(input) { let output = ''; for (let i = 0; i < input.length; i++) { const nextCharCode = input.charCodeAt(i + 1) || null; const prevCharCode = input.charCodeAt(i - 1) || null; const canReplacePunctuation = ((!nextCharCode || !charHasRotatedVerticalOrientation(nextCharCode) || verticalizedCharacterMap[input[i + 1]]) && (!prevCharCode || !charHasRotatedVerticalOrientation(prevCharCode) || verticalizedCharacterMap[input[i - 1]])); if (canReplacePunctuation && verticalizedCharacterMap[input[i]]) { output += verticalizedCharacterMap[input[i]]; } else { output += input[i]; } } return output; } // ONE_EM constant used to go between "em" units used in style spec and "points" used internally for layout var ONE_EM = 24; var ieee754$1 = {}; /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh */ var read = ieee754$1.read = function (buffer, offset, isLE, mLen, nBytes) { var e, m; var eLen = (nBytes * 8) - mLen - 1; var eMax = (1 << eLen) - 1; var eBias = eMax >> 1; var nBits = -7; var i = isLE ? (nBytes - 1) : 0; var d = isLE ? -1 : 1; var s = buffer[offset + i]; i += d; e = s & ((1 << (-nBits)) - 1); s >>= (-nBits); nBits += eLen; for (; nBits > 0; e = (e * 256) + buffer[offset + i], i += d, nBits -= 8) {} m = e & ((1 << (-nBits)) - 1); e >>= (-nBits); nBits += mLen; for (; nBits > 0; m = (m * 256) + buffer[offset + i], i += d, nBits -= 8) {} if (e === 0) { e = 1 - eBias; } else if (e === eMax) { return m ? NaN : ((s ? -1 : 1) * Infinity) } else { m = m + Math.pow(2, mLen); e = e - eBias; } return (s ? -1 : 1) * m * Math.pow(2, e - mLen) }; var write = ieee754$1.write = function (buffer, value, offset, isLE, mLen, nBytes) { var e, m, c; var eLen = (nBytes * 8) - mLen - 1; var eMax = (1 << eLen) - 1; var eBias = eMax >> 1; var rt = (mLen === 23 ? Math.pow(2, -24) - Math.pow(2, -77) : 0); var i = isLE ? 0 : (nBytes - 1); var d = isLE ? 1 : -1; var s = value < 0 || (value === 0 && 1 / value < 0) ? 1 : 0; value = Math.abs(value); if (isNaN(value) || value === Infinity) { m = isNaN(value) ? 1 : 0; e = eMax; } else { e = Math.floor(Math.log(value) / Math.LN2); if (value * (c = Math.pow(2, -e)) < 1) { e--; c *= 2; } if (e + eBias >= 1) { value += rt / c; } else { value += rt * Math.pow(2, 1 - eBias); } if (value * c >= 2) { e++; c /= 2; } if (e + eBias >= eMax) { m = 0; e = eMax; } else if (e + eBias >= 1) { m = ((value * c) - 1) * Math.pow(2, mLen); e = e + eBias; } else { m = value * Math.pow(2, eBias - 1) * Math.pow(2, mLen); e = 0; } } for (; mLen >= 8; buffer[offset + i] = m & 0xff, i += d, m /= 256, mLen -= 8) {} e = (e << mLen) | m; eLen += mLen; for (; eLen > 0; buffer[offset + i] = e & 0xff, i += d, e /= 256, eLen -= 8) {} buffer[offset + i - d] |= s * 128; }; 'use strict'; var pbf = Pbf; var ieee754 = ieee754$1; function Pbf(buf) { this.buf = ArrayBuffer.isView && ArrayBuffer.isView(buf) ? buf : new Uint8Array(buf || 0); this.pos = 0; this.type = 0; this.length = this.buf.length; } Pbf.Varint = 0; // varint: int32, int64, uint32, uint64, sint32, sint64, bool, enum Pbf.Fixed64 = 1; // 64-bit: double, fixed64, sfixed64 Pbf.Bytes = 2; // length-delimited: string, bytes, embedded messages, packed repeated fields Pbf.Fixed32 = 5; // 32-bit: float, fixed32, sfixed32 var SHIFT_LEFT_32 = (1 << 16) * (1 << 16), SHIFT_RIGHT_32 = 1 / SHIFT_LEFT_32; // Threshold chosen based on both benchmarking and knowledge about browser string // data structures (which currently switch structure types at 12 bytes or more) var TEXT_DECODER_MIN_LENGTH = 12; var utf8TextDecoder = typeof TextDecoder === 'undefined' ? null : new TextDecoder('utf-8'); Pbf.prototype = { destroy: function() { this.buf = null; }, // === READING ================================================================= readFields: function(readField, result, end) { end = end || this.length; while (this.pos < end) { var val = this.readVarint(), tag = val >> 3, startPos = this.pos; this.type = val & 0x7; readField(tag, result, this); if (this.pos === startPos) this.skip(val); } return result; }, readMessage: function(readField, result) { return this.readFields(readField, result, this.readVarint() + this.pos); }, readFixed32: function() { var val = readUInt32(this.buf, this.pos); this.pos += 4; return val; }, readSFixed32: function() { var val = readInt32(this.buf, this.pos); this.pos += 4; return val; }, // 64-bit int handling is based on github.com/dpw/node-buffer-more-ints (MIT-licensed) readFixed64: function() { var val = readUInt32(this.buf, this.pos) + readUInt32(this.buf, this.pos + 4) * SHIFT_LEFT_32; this.pos += 8; return val; }, readSFixed64: function() { var val = readUInt32(this.buf, this.pos) + readInt32(this.buf, this.pos + 4) * SHIFT_LEFT_32; this.pos += 8; return val; }, readFloat: function() { var val = ieee754.read(this.buf, this.pos, true, 23, 4); this.pos += 4; return val; }, readDouble: function() { var val = ieee754.read(this.buf, this.pos, true, 52, 8); this.pos += 8; return val; }, readVarint: function(isSigned) { var buf = this.buf, val, b; b = buf[this.pos++]; val = b & 0x7f; if (b < 0x80) return val; b = buf[this.pos++]; val |= (b & 0x7f) << 7; if (b < 0x80) return val; b = buf[this.pos++]; val |= (b & 0x7f) << 14; if (b < 0x80) return val; b = buf[this.pos++]; val |= (b & 0x7f) << 21; if (b < 0x80) return val; b = buf[this.pos]; val |= (b & 0x0f) << 28; return readVarintRemainder(val, isSigned, this); }, readVarint64: function() { // for compatibility with v2.0.1 return this.readVarint(true); }, readSVarint: function() { var num = this.readVarint(); return num % 2 === 1 ? (num + 1) / -2 : num / 2; // zigzag encoding }, readBoolean: function() { return Boolean(this.readVarint()); }, readString: function() { var end = this.readVarint() + this.pos; var pos = this.pos; this.pos = end; if (end - pos >= TEXT_DECODER_MIN_LENGTH && utf8TextDecoder) { // longer strings are fast with the built-in browser TextDecoder API return readUtf8TextDecoder(this.buf, pos, end); } // short strings are fast with our custom implementation return readUtf8(this.buf, pos, end); }, readBytes: function() { var end = this.readVarint() + this.pos, buffer = this.buf.subarray(this.pos, end); this.pos = end; return buffer; }, // verbose for performance reasons; doesn't affect gzipped size readPackedVarint: function(arr, isSigned) { if (this.type !== Pbf.Bytes) return arr.push(this.readVarint(isSigned)); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readVarint(isSigned)); return arr; }, readPackedSVarint: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readSVarint()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readSVarint()); return arr; }, readPackedBoolean: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readBoolean()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readBoolean()); return arr; }, readPackedFloat: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readFloat()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readFloat()); return arr; }, readPackedDouble: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readDouble()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readDouble()); return arr; }, readPackedFixed32: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readFixed32()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readFixed32()); return arr; }, readPackedSFixed32: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readSFixed32()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readSFixed32()); return arr; }, readPackedFixed64: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readFixed64()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readFixed64()); return arr; }, readPackedSFixed64: function(arr) { if (this.type !== Pbf.Bytes) return arr.push(this.readSFixed64()); var end = readPackedEnd(this); arr = arr || []; while (this.pos < end) arr.push(this.readSFixed64()); return arr; }, skip: function(val) { var type = val & 0x7; if (type === Pbf.Varint) while (this.buf[this.pos++] > 0x7f) {} else if (type === Pbf.Bytes) this.pos = this.readVarint() + this.pos; else if (type === Pbf.Fixed32) this.pos += 4; else if (type === Pbf.Fixed64) this.pos += 8; else throw new Error('Unimplemented type: ' + type); }, // === WRITING ================================================================= writeTag: function(tag, type) { this.writeVarint((tag << 3) | type); }, realloc: function(min) { var length = this.length || 16; while (length < this.pos + min) length *= 2; if (length !== this.length) { var buf = new Uint8Array(length); buf.set(this.buf); this.buf = buf; this.length = length; } }, finish: function() { this.length = this.pos; this.pos = 0; return this.buf.subarray(0, this.length); }, writeFixed32: function(val) { this.realloc(4); writeInt32(this.buf, val, this.pos); this.pos += 4; }, writeSFixed32: function(val) { this.realloc(4); writeInt32(this.buf, val, this.pos); this.pos += 4; }, writeFixed64: function(val) { this.realloc(8); writeInt32(this.buf, val & -1, this.pos); writeInt32(this.buf, Math.floor(val * SHIFT_RIGHT_32), this.pos + 4); this.pos += 8; }, writeSFixed64: function(val) { this.realloc(8); writeInt32(this.buf, val & -1, this.pos); writeInt32(this.buf, Math.floor(val * SHIFT_RIGHT_32), this.pos + 4); this.pos += 8; }, writeVarint: function(val) { val = +val || 0; if (val > 0xfffffff || val < 0) { writeBigVarint(val, this); return; } this.realloc(4); this.buf[this.pos++] = val & 0x7f | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return; this.buf[this.pos++] = ((val >>>= 7) & 0x7f) | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return; this.buf[this.pos++] = ((val >>>= 7) & 0x7f) | (val > 0x7f ? 0x80 : 0); if (val <= 0x7f) return; this.buf[this.pos++] = (val >>> 7) & 0x7f; }, writeSVarint: function(val) { this.writeVarint(val < 0 ? -val * 2 - 1 : val * 2); }, writeBoolean: function(val) { this.writeVarint(Boolean(val)); }, writeString: function(str) { str = String(str); this.realloc(str.length * 4); this.pos++; // reserve 1 byte for short string length var startPos = this.pos; // write the string directly to the buffer and see how much was written this.pos = writeUtf8(this.buf, str, this.pos); var len = this.pos - startPos; if (len >= 0x80) makeRoomForExtraLength(startPos, len, this); // finally, write the message length in the reserved place and restore the position this.pos = startPos - 1; this.writeVarint(len); this.pos += len; }, writeFloat: function(val) { this.realloc(4); ieee754.write(this.buf, val, this.pos, true, 23, 4); this.pos += 4; }, writeDouble: function(val) { this.realloc(8); ieee754.write(this.buf, val, this.pos, true, 52, 8); this.pos += 8; }, writeBytes: function(buffer) { var len = buffer.length; this.writeVarint(len); this.realloc(len); for (var i = 0; i < len; i++) this.buf[this.pos++] = buffer[i]; }, writeRawMessage: function(fn, obj) { this.pos++; // reserve 1 byte for short message length // write the message directly to the buffer and see how much was written var startPos = this.pos; fn(obj, this); var len = this.pos - startPos; if (len >= 0x80) makeRoomForExtraLength(startPos, len, this); // finally, write the message length in the reserved place and restore the position this.pos = startPos - 1; this.writeVarint(len); this.pos += len; }, writeMessage: function(tag, fn, obj) { this.writeTag(tag, Pbf.Bytes); this.writeRawMessage(fn, obj); }, writePackedVarint: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedVarint, arr); }, writePackedSVarint: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSVarint, arr); }, writePackedBoolean: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedBoolean, arr); }, writePackedFloat: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFloat, arr); }, writePackedDouble: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedDouble, arr); }, writePackedFixed32: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFixed32, arr); }, writePackedSFixed32: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSFixed32, arr); }, writePackedFixed64: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedFixed64, arr); }, writePackedSFixed64: function(tag, arr) { if (arr.length) this.writeMessage(tag, writePackedSFixed64, arr); }, writeBytesField: function(tag, buffer) { this.writeTag(tag, Pbf.Bytes); this.writeBytes(buffer); }, writeFixed32Field: function(tag, val) { this.writeTag(tag, Pbf.Fixed32); this.writeFixed32(val); }, writeSFixed32Field: function(tag, val) { this.writeTag(tag, Pbf.Fixed32); this.writeSFixed32(val); }, writeFixed64Field: function(tag, val) { this.writeTag(tag, Pbf.Fixed64); this.writeFixed64(val); }, writeSFixed64Field: function(tag, val) { this.writeTag(tag, Pbf.Fixed64); this.writeSFixed64(val); }, writeVarintField: function(tag, val) { this.writeTag(tag, Pbf.Varint); this.writeVarint(val); }, writeSVarintField: function(tag, val) { this.writeTag(tag, Pbf.Varint); this.writeSVarint(val); }, writeStringField: function(tag, str) { this.writeTag(tag, Pbf.Bytes); this.writeString(str); }, writeFloatField: function(tag, val) { this.writeTag(tag, Pbf.Fixed32); this.writeFloat(val); }, writeDoubleField: function(tag, val) { this.writeTag(tag, Pbf.Fixed64); this.writeDouble(val); }, writeBooleanField: function(tag, val) { this.writeVarintField(tag, Boolean(val)); } }; function readVarintRemainder(l, s, p) { var buf = p.buf, h, b; b = buf[p.pos++]; h = (b & 0x70) >> 4; if (b < 0x80) return toNum(l, h, s); b = buf[p.pos++]; h |= (b & 0x7f) << 3; if (b < 0x80) return toNum(l, h, s); b = buf[p.pos++]; h |= (b & 0x7f) << 10; if (b < 0x80) return toNum(l, h, s); b = buf[p.pos++]; h |= (b & 0x7f) << 17; if (b < 0x80) return toNum(l, h, s); b = buf[p.pos++]; h |= (b & 0x7f) << 24; if (b < 0x80) return toNum(l, h, s); b = buf[p.pos++]; h |= (b & 0x01) << 31; if (b < 0x80) return toNum(l, h, s); throw new Error('Expected varint not more than 10 bytes'); } function readPackedEnd(pbf) { return pbf.type === Pbf.Bytes ? pbf.readVarint() + pbf.pos : pbf.pos + 1; } function toNum(low, high, isSigned) { if (isSigned) { return high * 0x100000000 + (low >>> 0); } return ((high >>> 0) * 0x100000000) + (low >>> 0); } function writeBigVarint(val, pbf) { var low, high; if (val >= 0) { low = (val % 0x100000000) | 0; high = (val / 0x100000000) | 0; } else { low = ~(-val % 0x100000000); high = ~(-val / 0x100000000); if (low ^ 0xffffffff) { low = (low + 1) | 0; } else { low = 0; high = (high + 1) | 0; } } if (val >= 0x10000000000000000 || val < -0x10000000000000000) { throw new Error('Given varint doesn\'t fit into 10 bytes'); } pbf.realloc(10); writeBigVarintLow(low, high, pbf); writeBigVarintHigh(high, pbf); } function writeBigVarintLow(low, high, pbf) { pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7; pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7; pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7; pbf.buf[pbf.pos++] = low & 0x7f | 0x80; low >>>= 7; pbf.buf[pbf.pos] = low & 0x7f; } function writeBigVarintHigh(high, pbf) { var lsb = (high & 0x07) << 4; pbf.buf[pbf.pos++] |= lsb | ((high >>>= 3) ? 0x80 : 0); if (!high) return; pbf.buf[pbf.pos++] = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return; pbf.buf[pbf.pos++] = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return; pbf.buf[pbf.pos++] = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return; pbf.buf[pbf.pos++] = high & 0x7f | ((high >>>= 7) ? 0x80 : 0); if (!high) return; pbf.buf[pbf.pos++] = high & 0x7f; } function makeRoomForExtraLength(startPos, len, pbf) { var extraLen = len <= 0x3fff ? 1 : len <= 0x1fffff ? 2 : len <= 0xfffffff ? 3 : Math.floor(Math.log(len) / (Math.LN2 * 7)); // if 1 byte isn't enough for encoding message length, shift the data to the right pbf.realloc(extraLen); for (var i = pbf.pos - 1; i >= startPos; i--) pbf.buf[i + extraLen] = pbf.buf[i]; } function writePackedVarint(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeVarint(arr[i]); } function writePackedSVarint(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeSVarint(arr[i]); } function writePackedFloat(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeFloat(arr[i]); } function writePackedDouble(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeDouble(arr[i]); } function writePackedBoolean(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeBoolean(arr[i]); } function writePackedFixed32(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeFixed32(arr[i]); } function writePackedSFixed32(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeSFixed32(arr[i]); } function writePackedFixed64(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeFixed64(arr[i]); } function writePackedSFixed64(arr, pbf) { for (var i = 0; i < arr.length; i++) pbf.writeSFixed64(arr[i]); } // Buffer code below from https://github.com/feross/buffer, MIT-licensed function readUInt32(buf, pos) { return ((buf[pos]) | (buf[pos + 1] << 8) | (buf[pos + 2] << 16)) + (buf[pos + 3] * 0x1000000); } function writeInt32(buf, val, pos) { buf[pos] = val; buf[pos + 1] = (val >>> 8); buf[pos + 2] = (val >>> 16); buf[pos + 3] = (val >>> 24); } function readInt32(buf, pos) { return ((buf[pos]) | (buf[pos + 1] << 8) | (buf[pos + 2] << 16)) + (buf[pos + 3] << 24); } function readUtf8(buf, pos, end) { var str = ''; var i = pos; while (i < end) { var b0 = buf[i]; var c = null; // codepoint var bytesPerSequence = b0 > 0xEF ? 4 : b0 > 0xDF ? 3 : b0 > 0xBF ? 2 : 1; if (i + bytesPerSequence > end) break; var b1, b2, b3; if (bytesPerSequence === 1) { if (b0 < 0x80) { c = b0; } } else if (bytesPerSequence === 2) { b1 = buf[i + 1]; if ((b1 & 0xC0) === 0x80) { c = (b0 & 0x1F) << 0x6 | (b1 & 0x3F); if (c <= 0x7F) { c = null; } } } else if (bytesPerSequence === 3) { b1 = buf[i + 1]; b2 = buf[i + 2]; if ((b1 & 0xC0) === 0x80 && (b2 & 0xC0) === 0x80) { c = (b0 & 0xF) << 0xC | (b1 & 0x3F) << 0x6 | (b2 & 0x3F); if (c <= 0x7FF || (c >= 0xD800 && c <= 0xDFFF)) { c = null; } } } else if (bytesPerSequence === 4) { b1 = buf[i + 1]; b2 = buf[i + 2]; b3 = buf[i + 3]; if ((b1 & 0xC0) === 0x80 && (b2 & 0xC0) === 0x80 && (b3 & 0xC0) === 0x80) { c = (b0 & 0xF) << 0x12 | (b1 & 0x3F) << 0xC | (b2 & 0x3F) << 0x6 | (b3 & 0x3F); if (c <= 0xFFFF || c >= 0x110000) { c = null; } } } if (c === null) { c = 0xFFFD; bytesPerSequence = 1; } else if (c > 0xFFFF) { c -= 0x10000; str += String.fromCharCode(c >>> 10 & 0x3FF | 0xD800); c = 0xDC00 | c & 0x3FF; } str += String.fromCharCode(c); i += bytesPerSequence; } return str; } function readUtf8TextDecoder(buf, pos, end) { return utf8TextDecoder.decode(buf.subarray(pos, end)); } function writeUtf8(buf, str, pos) { for (var i = 0, c, lead; i < str.length; i++) { c = str.charCodeAt(i); // code point if (c > 0xD7FF && c < 0xE000) { if (lead) { if (c < 0xDC00) { buf[pos++] = 0xEF; buf[pos++] = 0xBF; buf[pos++] = 0xBD; lead = c; continue; } else { c = lead - 0xD800 << 10 | c - 0xDC00 | 0x10000; lead = null; } } else { if (c > 0xDBFF || (i + 1 === str.length)) { buf[pos++] = 0xEF; buf[pos++] = 0xBF; buf[pos++] = 0xBD; } else { lead = c; } continue; } } else if (lead) { buf[pos++] = 0xEF; buf[pos++] = 0xBF; buf[pos++] = 0xBD; lead = null; } if (c < 0x80) { buf[pos++] = c; } else { if (c < 0x800) { buf[pos++] = c >> 0x6 | 0xC0; } else { if (c < 0x10000) { buf[pos++] = c >> 0xC | 0xE0; } else { buf[pos++] = c >> 0x12 | 0xF0; buf[pos++] = c >> 0xC & 0x3F | 0x80; } buf[pos++] = c >> 0x6 & 0x3F | 0x80; } buf[pos++] = c & 0x3F | 0x80; } } return pos; } var Protobuf = /*@__PURE__*/getDefaultExportFromCjs$1(pbf); const border$1 = 3; function readFontstacks(tag, glyphs, pbf) { if (tag === 1) { pbf.readMessage(readFontstack, glyphs); } } function readFontstack(tag, glyphs, pbf) { if (tag === 3) { const { id, bitmap, width, height, left, top, advance } = pbf.readMessage(readGlyph, {}); glyphs.push({ id, bitmap: new AlphaImage({ width: width + 2 * border$1, height: height + 2 * border$1 }, bitmap), metrics: { width, height, left, top, advance } }); } } function readGlyph(tag, glyph, pbf) { if (tag === 1) glyph.id = pbf.readVarint(); else if (tag === 2) glyph.bitmap = pbf.readBytes(); else if (tag === 3) glyph.width = pbf.readVarint(); else if (tag === 4) glyph.height = pbf.readVarint(); else if (tag === 5) glyph.left = pbf.readSVarint(); else if (tag === 6) glyph.top = pbf.readSVarint(); else if (tag === 7) glyph.advance = pbf.readVarint(); } function parseGlyphPbf(data) { return new Protobuf(data).readFields(readFontstacks, []); } const GLYPH_PBF_BORDER = border$1; function potpack(boxes) { // calculate total box area and maximum box width let area = 0; let maxWidth = 0; for (const box of boxes) { area += box.w * box.h; maxWidth = Math.max(maxWidth, box.w); } // sort the boxes for insertion by height, descending boxes.sort((a, b) => b.h - a.h); // aim for a squarish resulting container, // slightly adjusted for sub-100% space utilization const startWidth = Math.max(Math.ceil(Math.sqrt(area / 0.95)), maxWidth); // start with a single empty space, unbounded at the bottom const spaces = [{x: 0, y: 0, w: startWidth, h: Infinity}]; let width = 0; let height = 0; for (const box of boxes) { // look through spaces backwards so that we check smaller spaces first for (let i = spaces.length - 1; i >= 0; i--) { const space = spaces[i]; // look for empty spaces that can accommodate the current box if (box.w > space.w || box.h > space.h) continue; // found the space; add the box to its top-left corner // |-------|-------| // | box | | // |_______| | // | space | // |_______________| box.x = space.x; box.y = space.y; height = Math.max(height, box.y + box.h); width = Math.max(width, box.x + box.w); if (box.w === space.w && box.h === space.h) { // space matches the box exactly; remove it const last = spaces.pop(); if (i < spaces.length) spaces[i] = last; } else if (box.h === space.h) { // space matches the box height; update it accordingly // |-------|---------------| // | box | updated space | // |_______|_______________| space.x += box.w; space.w -= box.w; } else if (box.w === space.w) { // space matches the box width; update it accordingly // |---------------| // | box | // |_______________| // | updated space | // |_______________| space.y += box.h; space.h -= box.h; } else { // otherwise the box splits the space into two spaces // |-------|-----------| // | box | new space | // |_______|___________| // | updated space | // |___________________| spaces.push({ x: space.x + box.w, y: space.y, w: space.w - box.w, h: box.h }); space.y += box.h; space.h -= box.h; } break; } } return { w: width, // container width h: height, // container height fill: (area / (width * height)) || 0 // space utilization }; } /* eslint-disable key-spacing */ const IMAGE_PADDING = 1; class ImagePosition { constructor(paddedRect, { pixelRatio, version, stretchX, stretchY, content, textFitWidth, textFitHeight }) { this.paddedRect = paddedRect; this.pixelRatio = pixelRatio; this.stretchX = stretchX; this.stretchY = stretchY; this.content = content; this.version = version; this.textFitWidth = textFitWidth; this.textFitHeight = textFitHeight; } get tl() { return [ this.paddedRect.x + IMAGE_PADDING, this.paddedRect.y + IMAGE_PADDING ]; } get br() { return [ this.paddedRect.x + this.paddedRect.w - IMAGE_PADDING, this.paddedRect.y + this.paddedRect.h - IMAGE_PADDING ]; } get tlbr() { return this.tl.concat(this.br); } get displaySize() { return [ (this.paddedRect.w - IMAGE_PADDING * 2) / this.pixelRatio, (this.paddedRect.h - IMAGE_PADDING * 2) / this.pixelRatio ]; } } /** * A class holding all the images */ class ImageAtlas { constructor(icons, patterns) { const iconPositions = {}, patternPositions = {}; this.haveRenderCallbacks = []; const bins = []; this.addImages(icons, iconPositions, bins); this.addImages(patterns, patternPositions, bins); const { w, h } = potpack(bins); const image = new RGBAImage({ width: w || 1, height: h || 1 }); for (const id in icons) { const src = icons[id]; const bin = iconPositions[id].paddedRect; RGBAImage.copy(src.data, image, { x: 0, y: 0 }, { x: bin.x + IMAGE_PADDING, y: bin.y + IMAGE_PADDING }, src.data); } for (const id in patterns) { const src = patterns[id]; const bin = patternPositions[id].paddedRect; const x = bin.x + IMAGE_PADDING, y = bin.y + IMAGE_PADDING, w = src.data.width, h = src.data.height; RGBAImage.copy(src.data, image, { x: 0, y: 0 }, { x, y }, src.data); // Add 1 pixel wrapped padding on each side of the image. RGBAImage.copy(src.data, image, { x: 0, y: h - 1 }, { x, y: y - 1 }, { width: w, height: 1 }); // T RGBAImage.copy(src.data, image, { x: 0, y: 0 }, { x, y: y + h }, { width: w, height: 1 }); // B RGBAImage.copy(src.data, image, { x: w - 1, y: 0 }, { x: x - 1, y }, { width: 1, height: h }); // L RGBAImage.copy(src.data, image, { x: 0, y: 0 }, { x: x + w, y }, { width: 1, height: h }); // R } this.image = image; this.iconPositions = iconPositions; this.patternPositions = patternPositions; } addImages(images, positions, bins) { for (const id in images) { const src = images[id]; const bin = { x: 0, y: 0, w: src.data.width + 2 * IMAGE_PADDING, h: src.data.height + 2 * IMAGE_PADDING, }; bins.push(bin); positions[id] = new ImagePosition(bin, src); if (src.hasRenderCallback) { this.haveRenderCallbacks.push(id); } } } patchUpdatedImages(imageManager, texture) { imageManager.dispatchRenderCallbacks(this.haveRenderCallbacks); for (const name in imageManager.updatedImages) { this.patchUpdatedImage(this.iconPositions[name], imageManager.getImage(name), texture); this.patchUpdatedImage(this.patternPositions[name], imageManager.getImage(name), texture); } } patchUpdatedImage(position, image, texture) { if (!position || !image) return; if (position.version === image.version) return; position.version = image.version; const [x, y] = position.tl; texture.update(image.data, undefined, { x, y }); } } register('ImagePosition', ImagePosition); register('ImageAtlas', ImageAtlas); var WritingMode; (function (WritingMode) { WritingMode[WritingMode["none"] = 0] = "none"; WritingMode[WritingMode["horizontal"] = 1] = "horizontal"; WritingMode[WritingMode["vertical"] = 2] = "vertical"; WritingMode[WritingMode["horizontalOnly"] = 3] = "horizontalOnly"; })(WritingMode || (WritingMode = {})); const SHAPING_DEFAULT_OFFSET = -17; function isEmpty(positionedLines) { for (const line of positionedLines) { if (line.positionedGlyphs.length !== 0) { return false; } } return true; } // Max number of images in label is 6401 U+E000–U+F8FF that covers // Basic Multilingual Plane Unicode Private Use Area (PUA). const PUAbegin = 0xE000; const PUAend = 0xF8FF; class SectionOptions { constructor() { this.scale = 1.0; this.fontStack = ''; this.imageName = null; } static forText(scale, fontStack) { const textOptions = new SectionOptions(); textOptions.scale = scale || 1; textOptions.fontStack = fontStack; return textOptions; } static forImage(imageName) { const imageOptions = new SectionOptions(); imageOptions.imageName = imageName; return imageOptions; } } class TaggedString { constructor() { this.text = ''; this.sectionIndex = []; this.sections = []; this.imageSectionID = null; } static fromFeature(text, defaultFontStack) { const result = new TaggedString(); for (let i = 0; i < text.sections.length; i++) { const section = text.sections[i]; if (!section.image) { result.addTextSection(section, defaultFontStack); } else { result.addImageSection(section); } } return result; } length() { return this.text.length; } getSection(index) { return this.sections[this.sectionIndex[index]]; } getSectionIndex(index) { return this.sectionIndex[index]; } getCharCode(index) { return this.text.charCodeAt(index); } verticalizePunctuation() { this.text = verticalizePunctuation(this.text); } trim() { let beginningWhitespace = 0; for (let i = 0; i < this.text.length && whitespace[this.text.charCodeAt(i)]; i++) { beginningWhitespace++; } let trailingWhitespace = this.text.length; for (let i = this.text.length - 1; i >= 0 && i >= beginningWhitespace && whitespace[this.text.charCodeAt(i)]; i--) { trailingWhitespace--; } this.text = this.text.substring(beginningWhitespace, trailingWhitespace); this.sectionIndex = this.sectionIndex.slice(beginningWhitespace, trailingWhitespace); } substring(start, end) { const substring = new TaggedString(); substring.text = this.text.substring(start, end); substring.sectionIndex = this.sectionIndex.slice(start, end); substring.sections = this.sections; return substring; } toString() { return this.text; } getMaxScale() { return this.sectionIndex.reduce((max, index) => Math.max(max, this.sections[index].scale), 0); } addTextSection(section, defaultFontStack) { this.text += section.text; this.sections.push(SectionOptions.forText(section.scale, section.fontStack || defaultFontStack)); const index = this.sections.length - 1; for (let i = 0; i < section.text.length; ++i) { this.sectionIndex.push(index); } } addImageSection(section) { const imageName = section.image ? section.image.name : ''; if (imageName.length === 0) { warnOnce('Can\'t add FormattedSection with an empty image.'); return; } const nextImageSectionCharCode = this.getNextImageSectionCharCode(); if (!nextImageSectionCharCode) { warnOnce(`Reached maximum number of images ${PUAend - PUAbegin + 2}`); return; } this.text += String.fromCharCode(nextImageSectionCharCode); this.sections.push(SectionOptions.forImage(imageName)); this.sectionIndex.push(this.sections.length - 1); } getNextImageSectionCharCode() { if (!this.imageSectionID) { this.imageSectionID = PUAbegin; return this.imageSectionID; } if (this.imageSectionID >= PUAend) return null; return ++this.imageSectionID; } } function breakLines(input, lineBreakPoints) { const lines = []; const text = input.text; let start = 0; for (const lineBreak of lineBreakPoints) { lines.push(input.substring(start, lineBreak)); start = lineBreak; } if (start < text.length) { lines.push(input.substring(start, text.length)); } return lines; } function shapeText(text, glyphMap, glyphPositions, imagePositions, defaultFontStack, maxWidth, lineHeight, textAnchor, textJustify, spacing, translate, writingMode, allowVerticalPlacement, layoutTextSize, layoutTextSizeThisZoom) { const logicalInput = TaggedString.fromFeature(text, defaultFontStack); if (writingMode === WritingMode.vertical) { logicalInput.verticalizePunctuation(); } let lines; const { processBidirectionalText, processStyledBidirectionalText } = rtlWorkerPlugin; if (processBidirectionalText && logicalInput.sections.length === 1) { // Bidi doesn't have to be style-aware lines = []; const untaggedLines = processBidirectionalText(logicalInput.toString(), determineLineBreaks(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize)); for (const line of untaggedLines) { const taggedLine = new TaggedString(); taggedLine.text = line; taggedLine.sections = logicalInput.sections; for (let i = 0; i < line.length; i++) { taggedLine.sectionIndex.push(0); } lines.push(taggedLine); } } else if (processStyledBidirectionalText) { // Need version of mapbox-gl-rtl-text with style support for combining RTL text // with formatting lines = []; const processedLines = processStyledBidirectionalText(logicalInput.text, logicalInput.sectionIndex, determineLineBreaks(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize)); for (const line of processedLines) { const taggedLine = new TaggedString(); taggedLine.text = line[0]; taggedLine.sectionIndex = line[1]; taggedLine.sections = logicalInput.sections; lines.push(taggedLine); } } else { lines = breakLines(logicalInput, determineLineBreaks(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize)); } const positionedLines = []; const shaping = { positionedLines, text: logicalInput.toString(), top: translate[1], bottom: translate[1], left: translate[0], right: translate[0], writingMode, iconsInText: false, verticalizable: false }; shapeLines(shaping, glyphMap, glyphPositions, imagePositions, lines, lineHeight, textAnchor, textJustify, writingMode, spacing, allowVerticalPlacement, layoutTextSizeThisZoom); if (isEmpty(positionedLines)) return false; return shaping; } // using computed properties due to https://github.com/facebook/flow/issues/380 /* eslint no-useless-computed-key: 0 */ const whitespace = { [0x09]: true, // tab [0x0a]: true, // newline [0x0b]: true, // vertical tab [0x0c]: true, // form feed [0x0d]: true, // carriage return [0x20]: true, // space }; const breakable = { [0x0a]: true, // newline [0x20]: true, // space [0x26]: true, // ampersand [0x29]: true, // right parenthesis [0x2b]: true, // plus sign [0x2d]: true, // hyphen-minus [0x2f]: true, // solidus [0xad]: true, // soft hyphen [0xb7]: true, // middle dot [0x200b]: true, // zero-width space [0x2010]: true, // hyphen [0x2013]: true, // en dash [0x2027]: true // interpunct // Many other characters may be reasonable breakpoints // Consider "neutral orientation" characters at scriptDetection.charHasNeutralVerticalOrientation // See https://github.com/mapbox/mapbox-gl-js/issues/3658 }; // Allow breaks depending on the following character const breakableBefore = { [0x28]: true, // left parenthesis }; function getGlyphAdvance(codePoint, section, glyphMap, imagePositions, spacing, layoutTextSize) { if (!section.imageName) { const positions = glyphMap[section.fontStack]; const glyph = positions && positions[codePoint]; if (!glyph) return 0; return glyph.metrics.advance * section.scale + spacing; } else { const imagePosition = imagePositions[section.imageName]; if (!imagePosition) return 0; return imagePosition.displaySize[0] * section.scale * ONE_EM / layoutTextSize + spacing; } } function determineAverageLineWidth(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize) { let totalWidth = 0; for (let index = 0; index < logicalInput.length(); index++) { const section = logicalInput.getSection(index); totalWidth += getGlyphAdvance(logicalInput.getCharCode(index), section, glyphMap, imagePositions, spacing, layoutTextSize); } const lineCount = Math.max(1, Math.ceil(totalWidth / maxWidth)); return totalWidth / lineCount; } function calculateBadness(lineWidth, targetWidth, penalty, isLastBreak) { const raggedness = Math.pow(lineWidth - targetWidth, 2); if (isLastBreak) { // Favor finals lines shorter than average over longer than average if (lineWidth < targetWidth) { return raggedness / 2; } else { return raggedness * 2; } } return raggedness + Math.abs(penalty) * penalty; } function calculatePenalty(codePoint, nextCodePoint, penalizableIdeographicBreak) { let penalty = 0; // Force break on newline if (codePoint === 0x0a) { penalty -= 10000; } // Penalize breaks between characters that allow ideographic breaking because // they are less preferable than breaks at spaces (or zero width spaces). if (penalizableIdeographicBreak) { penalty += 150; } // Penalize open parenthesis at end of line if (codePoint === 0x28 || codePoint === 0xff08) { penalty += 50; } // Penalize close parenthesis at beginning of line if (nextCodePoint === 0x29 || nextCodePoint === 0xff09) { penalty += 50; } return penalty; } function evaluateBreak(breakIndex, breakX, targetWidth, potentialBreaks, penalty, isLastBreak) { // We could skip evaluating breaks where the line length (breakX - priorBreak.x) > maxWidth // ...but in fact we allow lines longer than maxWidth (if there's no break points) // ...and when targetWidth and maxWidth are close, strictly enforcing maxWidth can give // more lopsided results. let bestPriorBreak = null; let bestBreakBadness = calculateBadness(breakX, targetWidth, penalty, isLastBreak); for (const potentialBreak of potentialBreaks) { const lineWidth = breakX - potentialBreak.x; const breakBadness = calculateBadness(lineWidth, targetWidth, penalty, isLastBreak) + potentialBreak.badness; if (breakBadness <= bestBreakBadness) { bestPriorBreak = potentialBreak; bestBreakBadness = breakBadness; } } return { index: breakIndex, x: breakX, priorBreak: bestPriorBreak, badness: bestBreakBadness }; } function leastBadBreaks(lastLineBreak) { if (!lastLineBreak) { return []; } return leastBadBreaks(lastLineBreak.priorBreak).concat(lastLineBreak.index); } function determineLineBreaks(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize) { if (!logicalInput) return []; const potentialLineBreaks = []; const targetWidth = determineAverageLineWidth(logicalInput, spacing, maxWidth, glyphMap, imagePositions, layoutTextSize); const hasServerSuggestedBreakpoints = logicalInput.text.indexOf('\u200b') >= 0; let currentX = 0; for (let i = 0; i < logicalInput.length(); i++) { const section = logicalInput.getSection(i); const codePoint = logicalInput.getCharCode(i); if (!whitespace[codePoint]) currentX += getGlyphAdvance(codePoint, section, glyphMap, imagePositions, spacing, layoutTextSize); // Ideographic characters, spaces, and word-breaking punctuation that often appear without // surrounding spaces. if ((i < logicalInput.length() - 1)) { const ideographicBreak = charAllowsIdeographicBreaking(codePoint); if (breakable[codePoint] || ideographicBreak || section.imageName || (i !== logicalInput.length() - 2 && breakableBefore[logicalInput.getCharCode(i + 1)])) { potentialLineBreaks.push(evaluateBreak(i + 1, currentX, targetWidth, potentialLineBreaks, calculatePenalty(codePoint, logicalInput.getCharCode(i + 1), ideographicBreak && hasServerSuggestedBreakpoints), false)); } } } return leastBadBreaks(evaluateBreak(logicalInput.length(), currentX, targetWidth, potentialLineBreaks, 0, true)); } function getAnchorAlignment(anchor) { let horizontalAlign = 0.5, verticalAlign = 0.5; switch (anchor) { case 'right': case 'top-right': case 'bottom-right': horizontalAlign = 1; break; case 'left': case 'top-left': case 'bottom-left': horizontalAlign = 0; break; } switch (anchor) { case 'bottom': case 'bottom-right': case 'bottom-left': verticalAlign = 1; break; case 'top': case 'top-right': case 'top-left': verticalAlign = 0; break; } return { horizontalAlign, verticalAlign }; } function shapeLines(shaping, glyphMap, glyphPositions, imagePositions, lines, lineHeight, textAnchor, textJustify, writingMode, spacing, allowVerticalPlacement, layoutTextSizeThisZoom) { let x = 0; let y = SHAPING_DEFAULT_OFFSET; let maxLineLength = 0; let maxLineHeight = 0; const justify = textJustify === 'right' ? 1 : textJustify === 'left' ? 0 : 0.5; let lineIndex = 0; for (const line of lines) { line.trim(); const lineMaxScale = line.getMaxScale(); const maxLineOffset = (lineMaxScale - 1) * ONE_EM; const positionedLine = { positionedGlyphs: [], lineOffset: 0 }; shaping.positionedLines[lineIndex] = positionedLine; const positionedGlyphs = positionedLine.positionedGlyphs; let lineOffset = 0.0; if (!line.length()) { y += lineHeight; // Still need a line feed after empty line ++lineIndex; continue; } for (let i = 0; i < line.length(); i++) { const section = line.getSection(i); const sectionIndex = line.getSectionIndex(i); const codePoint = line.getCharCode(i); let baselineOffset = 0.0; let metrics = null; let rect = null; let imageName = null; let verticalAdvance = ONE_EM; const vertical = !(writingMode === WritingMode.horizontal || // Don't verticalize glyphs that have no upright orientation if vertical placement is disabled. (!allowVerticalPlacement && !charHasUprightVerticalOrientation(codePoint)) || // If vertical placement is enabled, don't verticalize glyphs that // are from complex text layout script, or whitespaces. (allowVerticalPlacement && (whitespace[codePoint] || charInComplexShapingScript(codePoint)))); if (!section.imageName) { const positions = glyphPositions[section.fontStack]; const glyphPosition = positions && positions[codePoint]; if (glyphPosition && glyphPosition.rect) { rect = glyphPosition.rect; metrics = glyphPosition.metrics; } else { const glyphs = glyphMap[section.fontStack]; const glyph = glyphs && glyphs[codePoint]; if (!glyph) continue; metrics = glyph.metrics; } // We don't know the baseline, but since we're laying out // at 24 points, we can calculate how much it will move when // we scale up or down. baselineOffset = (lineMaxScale - section.scale) * ONE_EM; } else { const imagePosition = imagePositions[section.imageName]; if (!imagePosition) continue; imageName = section.imageName; shaping.iconsInText = shaping.iconsInText || true; rect = imagePosition.paddedRect; const size = imagePosition.displaySize; // If needed, allow to set scale factor for an image using // alias "image-scale" that could be alias for "font-scale" // when FormattedSection is an image section. section.scale = section.scale * ONE_EM / layoutTextSizeThisZoom; metrics = { width: size[0], height: size[1], left: IMAGE_PADDING, top: -GLYPH_PBF_BORDER, advance: vertical ? size[1] : size[0] }; // Difference between one EM and an image size. // Aligns bottom of an image to a baseline level. const imageOffset = ONE_EM - size[1] * section.scale; baselineOffset = maxLineOffset + imageOffset; verticalAdvance = metrics.advance; // Difference between height of an image and one EM at max line scale. // Pushes current line down if an image size is over 1 EM at max line scale. const offset = vertical ? size[0] * section.scale - ONE_EM * lineMaxScale : size[1] * section.scale - ONE_EM * lineMaxScale; if (offset > 0 && offset > lineOffset) { lineOffset = offset; } } if (!vertical) { positionedGlyphs.push({ glyph: codePoint, imageName, x, y: y + baselineOffset, vertical, scale: section.scale, fontStack: section.fontStack, sectionIndex, metrics, rect }); x += metrics.advance * section.scale + spacing; } else { shaping.verticalizable = true; positionedGlyphs.push({ glyph: codePoint, imageName, x, y: y + baselineOffset, vertical, scale: section.scale, fontStack: section.fontStack, sectionIndex, metrics, rect }); x += verticalAdvance * section.scale + spacing; } } // Only justify if we placed at least one glyph if (positionedGlyphs.length !== 0) { const lineLength = x - spacing; maxLineLength = Math.max(lineLength, maxLineLength); justifyLine(positionedGlyphs, 0, positionedGlyphs.length - 1, justify, lineOffset); } x = 0; const currentLineHeight = lineHeight * lineMaxScale + lineOffset; positionedLine.lineOffset = Math.max(lineOffset, maxLineOffset); y += currentLineHeight; maxLineHeight = Math.max(currentLineHeight, maxLineHeight); ++lineIndex; } // Calculate the bounding box and justify / align text block. const height = y - SHAPING_DEFAULT_OFFSET; const { horizontalAlign, verticalAlign } = getAnchorAlignment(textAnchor); align(shaping.positionedLines, justify, horizontalAlign, verticalAlign, maxLineLength, maxLineHeight, lineHeight, height, lines.length); shaping.top += -verticalAlign * height; shaping.bottom = shaping.top + height; shaping.left += -horizontalAlign * maxLineLength; shaping.right = shaping.left + maxLineLength; } // justify right = 1, left = 0, center = 0.5 function justifyLine(positionedGlyphs, start, end, justify, lineOffset) { if (!justify && !lineOffset) return; const lastPositionedGlyph = positionedGlyphs[end]; const lastAdvance = lastPositionedGlyph.metrics.advance * lastPositionedGlyph.scale; const lineIndent = (positionedGlyphs[end].x + lastAdvance) * justify; for (let j = start; j <= end; j++) { positionedGlyphs[j].x -= lineIndent; positionedGlyphs[j].y += lineOffset; } } function align(positionedLines, justify, horizontalAlign, verticalAlign, maxLineLength, maxLineHeight, lineHeight, blockHeight, lineCount) { const shiftX = (justify - horizontalAlign) * maxLineLength; let shiftY = 0; if (maxLineHeight !== lineHeight) { shiftY = -blockHeight * verticalAlign - SHAPING_DEFAULT_OFFSET; } else { shiftY = (-verticalAlign * lineCount + 0.5) * lineHeight; } for (const line of positionedLines) { for (const positionedGlyph of line.positionedGlyphs) { positionedGlyph.x += shiftX; positionedGlyph.y += shiftY; } } } function shapeIcon(image, iconOffset, iconAnchor) { const { horizontalAlign, verticalAlign } = getAnchorAlignment(iconAnchor); const dx = iconOffset[0]; const dy = iconOffset[1]; const x1 = dx - image.displaySize[0] * horizontalAlign; const x2 = x1 + image.displaySize[0]; const y1 = dy - image.displaySize[1] * verticalAlign; const y2 = y1 + image.displaySize[1]; return { image, top: y1, bottom: y2, left: x1, right: x2 }; } /** * Called after a PositionedIcon has already been run through fitIconToText, * but needs further adjustment to apply textFitWidth and textFitHeight. * @param shapedIcon - The icon that will be adjusted. * @returns Extents of the shapedIcon with text fit adjustments if necessary. */ function applyTextFit(shapedIcon) { var _a, _b; // Assume shapedIcon.image is set or this wouldn't be called. // Size of the icon after it was adjusted using stretchX and Y let iconLeft = shapedIcon.left; let iconTop = shapedIcon.top; let iconWidth = shapedIcon.right - iconLeft; let iconHeight = shapedIcon.bottom - iconTop; // Size of the original content area const contentWidth = shapedIcon.image.content[2] - shapedIcon.image.content[0]; const contentHeight = shapedIcon.image.content[3] - shapedIcon.image.content[1]; const textFitWidth = (_a = shapedIcon.image.textFitWidth) !== null && _a !== void 0 ? _a : "stretchOrShrink" /* TextFit.stretchOrShrink */; const textFitHeight = (_b = shapedIcon.image.textFitHeight) !== null && _b !== void 0 ? _b : "stretchOrShrink" /* TextFit.stretchOrShrink */; const contentAspectRatio = contentWidth / contentHeight; // Scale to the proportional axis first note that height takes precedence if // both axes are set to proportional. if (textFitHeight === "proportional" /* TextFit.proportional */) { if ((textFitWidth === "stretchOnly" /* TextFit.stretchOnly */ && iconWidth / iconHeight < contentAspectRatio) || textFitWidth === "proportional" /* TextFit.proportional */) { // Push the width of the icon back out to match the content aspect ratio const newIconWidth = Math.ceil(iconHeight * contentAspectRatio); iconLeft *= newIconWidth / iconWidth; iconWidth = newIconWidth; } } else if (textFitWidth === "proportional" /* TextFit.proportional */) { if (textFitHeight === "stretchOnly" /* TextFit.stretchOnly */ && contentAspectRatio !== 0 && iconWidth / iconHeight > contentAspectRatio) { // Push the height of the icon back out to match the content aspect ratio const newIconHeight = Math.ceil(iconWidth / contentAspectRatio); iconTop *= newIconHeight / iconHeight; iconHeight = newIconHeight; } } else { // If neither textFitHeight nor textFitWidth are proportional then // there is no effect since the content rectangle should be precisely // matched to the content } return { x1: iconLeft, y1: iconTop, x2: iconLeft + iconWidth, y2: iconTop + iconHeight }; } function fitIconToText(shapedIcon, shapedText, textFit, padding, iconOffset, fontScale) { const image = shapedIcon.image; let collisionPadding; if (image.content) { const content = image.content; const pixelRatio = image.pixelRatio || 1; collisionPadding = [ content[0] / pixelRatio, content[1] / pixelRatio, image.displaySize[0] - content[2] / pixelRatio, image.displaySize[1] - content[3] / pixelRatio ]; } // We don't respect the icon-anchor, because icon-text-fit is set. Instead, // the icon will be centered on the text, then stretched in the given // dimensions. const textLeft = shapedText.left * fontScale; const textRight = shapedText.right * fontScale; let top, right, bottom, left; if (textFit === 'width' || textFit === 'both') { // Stretched horizontally to the text width left = iconOffset[0] + textLeft - padding[3]; right = iconOffset[0] + textRight + padding[1]; } else { // Centered on the text left = iconOffset[0] + (textLeft + textRight - image.displaySize[0]) / 2; right = left + image.displaySize[0]; } const textTop = shapedText.top * fontScale; const textBottom = shapedText.bottom * fontScale; if (textFit === 'height' || textFit === 'both') { // Stretched vertically to the text height top = iconOffset[1] + textTop - padding[0]; bottom = iconOffset[1] + textBottom + padding[2]; } else { // Centered on the text top = iconOffset[1] + (textTop + textBottom - image.displaySize[1]) / 2; bottom = top + image.displaySize[1]; } return { image, top, right, bottom, left, collisionPadding }; } const MAX_GLYPH_ICON_SIZE = 255; const SIZE_PACK_FACTOR = 128; const MAX_PACKED_SIZE = MAX_GLYPH_ICON_SIZE * SIZE_PACK_FACTOR; // For {text,icon}-size, get the bucket-level data that will be needed by // the painter to set symbol-size-related uniforms function getSizeData(tileZoom, value) { const { expression } = value; if (expression.kind === 'constant') { const layoutSize = expression.evaluate(new EvaluationParameters(tileZoom + 1)); return { kind: 'constant', layoutSize }; } else if (expression.kind === 'source') { return { kind: 'source' }; } else { const { zoomStops, interpolationType } = expression; // calculate covering zoom stops for zoom-dependent values let lower = 0; while (lower < zoomStops.length && zoomStops[lower] <= tileZoom) lower++; lower = Math.max(0, lower - 1); let upper = lower; while (upper < zoomStops.length && zoomStops[upper] < tileZoom + 1) upper++; upper = Math.min(zoomStops.length - 1, upper); const minZoom = zoomStops[lower]; const maxZoom = zoomStops[upper]; // We'd like to be able to use CameraExpression or CompositeExpression in these // return types rather than ExpressionSpecification, but the former are not // transferrable across Web Worker boundaries. if (expression.kind === 'composite') { return { kind: 'composite', minZoom, maxZoom, interpolationType }; } // for camera functions, also save off the function values // evaluated at the covering zoom levels const minSize = expression.evaluate(new EvaluationParameters(minZoom)); const maxSize = expression.evaluate(new EvaluationParameters(maxZoom)); return { kind: 'camera', minZoom, maxZoom, minSize, maxSize, interpolationType }; } } function evaluateSizeForFeature(sizeData, { uSize, uSizeT }, { lowerSize, upperSize }) { if (sizeData.kind === 'source') { return lowerSize / SIZE_PACK_FACTOR; } else if (sizeData.kind === 'composite') { return interpolate.number(lowerSize / SIZE_PACK_FACTOR, upperSize / SIZE_PACK_FACTOR, uSizeT); } return uSize; } function evaluateSizeForZoom(sizeData, zoom) { let uSizeT = 0; let uSize = 0; if (sizeData.kind === 'constant') { uSize = sizeData.layoutSize; } else if (sizeData.kind !== 'source') { const { interpolationType, minZoom, maxZoom } = sizeData; // Even though we could get the exact value of the camera function // at z = tr.zoom, we intentionally do not: instead, we interpolate // between the camera function values at a pair of zoom stops covering // [tileZoom, tileZoom + 1] in order to be consistent with this // restriction on composite functions const t = !interpolationType ? 0 : clamp$1(Interpolate.interpolationFactor(interpolationType, zoom, minZoom, maxZoom), 0, 1); if (sizeData.kind === 'camera') { uSize = interpolate.number(sizeData.minSize, sizeData.maxSize, t); } else { uSizeT = t; } } return { uSizeT, uSize }; } function getOverlapMode(layout, overlapProp, allowOverlapProp) { let result = 'never'; const overlap = layout.get(overlapProp); if (overlap) { // if -overlap is set, use it result = overlap; } else if (layout.get(allowOverlapProp)) { // fall back to -allow-overlap, with false='never', true='always' result = 'always'; } return result; } const vectorTileFeatureTypes = vectorTile.VectorTileFeature.types; // Opacity arrays are frequently updated but don't contain a lot of information, so we pack them // tight. Each Uint32 is actually four duplicate Uint8s for the four corners of a glyph // 7 bits are for the current opacity, and the lowest bit is the target opacity // actually defined in symbol_attributes.js // const placementOpacityAttributes = [ // { name: 'a_fade_opacity', components: 1, type: 'Uint32' } // ]; const shaderOpacityAttributes = [ { name: 'a_fade_opacity', components: 1, type: 'Uint8', offset: 0 } ]; function addVertex(array, anchorX, anchorY, ox, oy, tx, ty, sizeVertex, isSDF, pixelOffsetX, pixelOffsetY, minFontScaleX, minFontScaleY) { const aSizeX = sizeVertex ? Math.min(MAX_PACKED_SIZE, Math.round(sizeVertex[0])) : 0; const aSizeY = sizeVertex ? Math.min(MAX_PACKED_SIZE, Math.round(sizeVertex[1])) : 0; array.emplaceBack( // a_pos_offset anchorX, anchorY, Math.round(ox * 32), Math.round(oy * 32), // a_data tx, // x coordinate of symbol on glyph atlas texture ty, // y coordinate of symbol on glyph atlas texture (aSizeX << 1) + (isSDF ? 1 : 0), aSizeY, pixelOffsetX * 16, pixelOffsetY * 16, minFontScaleX * 256, minFontScaleY * 256); } function addDynamicAttributes(dynamicLayoutVertexArray, p, angle) { dynamicLayoutVertexArray.emplaceBack(p.x, p.y, angle); dynamicLayoutVertexArray.emplaceBack(p.x, p.y, angle); dynamicLayoutVertexArray.emplaceBack(p.x, p.y, angle); dynamicLayoutVertexArray.emplaceBack(p.x, p.y, angle); } function containsRTLText(formattedText) { for (const section of formattedText.sections) { if (stringContainsRTLText(section.text)) { return true; } } return false; } class SymbolBuffers { constructor(programConfigurations) { this.layoutVertexArray = new SymbolLayoutArray(); this.indexArray = new TriangleIndexArray(); this.programConfigurations = programConfigurations; this.segments = new SegmentVector(); this.dynamicLayoutVertexArray = new SymbolDynamicLayoutArray(); this.opacityVertexArray = new SymbolOpacityArray(); this.hasVisibleVertices = false; this.placedSymbolArray = new PlacedSymbolArray(); } isEmpty() { return this.layoutVertexArray.length === 0 && this.indexArray.length === 0 && this.dynamicLayoutVertexArray.length === 0 && this.opacityVertexArray.length === 0; } upload(context, dynamicIndexBuffer, upload, update) { if (this.isEmpty()) { return; } if (upload) { this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, symbolLayoutAttributes.members); this.indexBuffer = context.createIndexBuffer(this.indexArray, dynamicIndexBuffer); this.dynamicLayoutVertexBuffer = context.createVertexBuffer(this.dynamicLayoutVertexArray, dynamicLayoutAttributes.members, true); this.opacityVertexBuffer = context.createVertexBuffer(this.opacityVertexArray, shaderOpacityAttributes, true); // This is a performance hack so that we can write to opacityVertexArray with uint32s // even though the shaders read uint8s this.opacityVertexBuffer.itemSize = 1; } if (upload || update) { this.programConfigurations.upload(context); } } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.programConfigurations.destroy(); this.segments.destroy(); this.dynamicLayoutVertexBuffer.destroy(); this.opacityVertexBuffer.destroy(); } } register('SymbolBuffers', SymbolBuffers); class CollisionBuffers { constructor(LayoutArray, layoutAttributes, IndexArray) { this.layoutVertexArray = new LayoutArray(); this.layoutAttributes = layoutAttributes; this.indexArray = new IndexArray(); this.segments = new SegmentVector(); this.collisionVertexArray = new CollisionVertexArray(); } upload(context) { this.layoutVertexBuffer = context.createVertexBuffer(this.layoutVertexArray, this.layoutAttributes); this.indexBuffer = context.createIndexBuffer(this.indexArray); this.collisionVertexBuffer = context.createVertexBuffer(this.collisionVertexArray, collisionVertexAttributes.members, true); } destroy() { if (!this.layoutVertexBuffer) return; this.layoutVertexBuffer.destroy(); this.indexBuffer.destroy(); this.segments.destroy(); this.collisionVertexBuffer.destroy(); } } register('CollisionBuffers', CollisionBuffers); /** * @internal * Unlike other buckets, which simply implement #addFeature with type-specific * logic for (essentially) triangulating feature geometries, SymbolBucket * requires specialized behavior: * * 1. WorkerTile#parse(), the logical owner of the bucket creation process, * calls SymbolBucket#populate(), which resolves text and icon tokens on * each feature, adds each glyphs and symbols needed to the passed-in * collections options.glyphDependencies and options.iconDependencies, and * stores the feature data for use in subsequent step (this.features). * * 2. WorkerTile asynchronously requests from the main thread all of the glyphs * and icons needed (by this bucket and any others). When glyphs and icons * have been received, the WorkerTile creates a CollisionIndex and invokes: * * 3. performSymbolLayout(bucket, stacks, icons) perform texts shaping and * layout on a Symbol Bucket. This step populates: * `this.symbolInstances`: metadata on generated symbols * `this.collisionBoxArray`: collision data for use by foreground * `this.text`: SymbolBuffers for text symbols * `this.icons`: SymbolBuffers for icons * `this.iconCollisionBox`: Debug SymbolBuffers for icon collision boxes * `this.textCollisionBox`: Debug SymbolBuffers for text collision boxes * The results are sent to the foreground for rendering * * 4. placement.ts is run on the foreground, * and uses the CollisionIndex along with current camera settings to determine * which symbols can actually show on the map. Collided symbols are hidden * using a dynamic "OpacityVertexArray". */ class SymbolBucket { constructor(options) { this.collisionBoxArray = options.collisionBoxArray; this.zoom = options.zoom; this.overscaling = options.overscaling; this.layers = options.layers; this.layerIds = this.layers.map(layer => layer.id); this.index = options.index; this.pixelRatio = options.pixelRatio; this.sourceLayerIndex = options.sourceLayerIndex; this.hasPattern = false; this.hasRTLText = false; this.sortKeyRanges = []; this.collisionCircleArray = []; this.placementInvProjMatrix = identity$2([]); this.placementViewportMatrix = identity$2([]); const layer = this.layers[0]; const unevaluatedLayoutValues = layer._unevaluatedLayout._values; this.textSizeData = getSizeData(this.zoom, unevaluatedLayoutValues['text-size']); this.iconSizeData = getSizeData(this.zoom, unevaluatedLayoutValues['icon-size']); const layout = this.layers[0].layout; const sortKey = layout.get('symbol-sort-key'); const zOrder = layout.get('symbol-z-order'); this.canOverlap = getOverlapMode(layout, 'text-overlap', 'text-allow-overlap') !== 'never' || getOverlapMode(layout, 'icon-overlap', 'icon-allow-overlap') !== 'never' || layout.get('text-ignore-placement') || layout.get('icon-ignore-placement'); this.sortFeaturesByKey = zOrder !== 'viewport-y' && !sortKey.isConstant(); const zOrderByViewportY = zOrder === 'viewport-y' || (zOrder === 'auto' && !this.sortFeaturesByKey); this.sortFeaturesByY = zOrderByViewportY && this.canOverlap; if (layout.get('symbol-placement') === 'point') { this.writingModes = layout.get('text-writing-mode').map(wm => WritingMode[wm]); } this.stateDependentLayerIds = this.layers.filter((l) => l.isStateDependent()).map((l) => l.id); this.sourceID = options.sourceID; } createArrays() { this.text = new SymbolBuffers(new ProgramConfigurationSet(this.layers, this.zoom, property => /^text/.test(property))); this.icon = new SymbolBuffers(new ProgramConfigurationSet(this.layers, this.zoom, property => /^icon/.test(property))); this.glyphOffsetArray = new GlyphOffsetArray(); this.lineVertexArray = new SymbolLineVertexArray(); this.symbolInstances = new SymbolInstanceArray(); this.textAnchorOffsets = new TextAnchorOffsetArray(); } calculateGlyphDependencies(text, stack, textAlongLine, allowVerticalPlacement, doesAllowVerticalWritingMode) { for (let i = 0; i < text.length; i++) { stack[text.charCodeAt(i)] = true; if ((textAlongLine || allowVerticalPlacement) && doesAllowVerticalWritingMode) { const verticalChar = verticalizedCharacterMap[text.charAt(i)]; if (verticalChar) { stack[verticalChar.charCodeAt(0)] = true; } } } } populate(features, options, canonical) { const layer = this.layers[0]; const layout = layer.layout; const textFont = layout.get('text-font'); const textField = layout.get('text-field'); const iconImage = layout.get('icon-image'); const hasText = (textField.value.kind !== 'constant' || (textField.value.value instanceof Formatted && !textField.value.value.isEmpty()) || textField.value.value.toString().length > 0) && (textFont.value.kind !== 'constant' || textFont.value.value.length > 0); // we should always resolve the icon-image value if the property was defined in the style // this allows us to fire the styleimagemissing event if image evaluation returns null // the only way to distinguish between null returned from a coalesce statement with no valid images // and null returned because icon-image wasn't defined is to check whether or not iconImage.parameters is an empty object const hasIcon = iconImage.value.kind !== 'constant' || !!iconImage.value.value || Object.keys(iconImage.parameters).length > 0; const symbolSortKey = layout.get('symbol-sort-key'); this.features = []; if (!hasText && !hasIcon) { return; } const icons = options.iconDependencies; const stacks = options.glyphDependencies; const availableImages = options.availableImages; const globalProperties = new EvaluationParameters(this.zoom); for (const { feature, id, index, sourceLayerIndex } of features) { const needGeometry = layer._featureFilter.needGeometry; const evaluationFeature = toEvaluationFeature(feature, needGeometry); if (!layer._featureFilter.filter(globalProperties, evaluationFeature, canonical)) { continue; } if (!needGeometry) evaluationFeature.geometry = loadGeometry(feature); let text; if (hasText) { // Expression evaluation will automatically coerce to Formatted // but plain string token evaluation skips that pathway so do the // conversion here. const resolvedTokens = layer.getValueAndResolveTokens('text-field', evaluationFeature, canonical, availableImages); const formattedText = Formatted.factory(resolvedTokens); // on this instance: if hasRTLText is already true, all future calls to containsRTLText can be skipped. const bucketHasRTLText = this.hasRTLText = (this.hasRTLText || containsRTLText(formattedText)); if (!bucketHasRTLText || // non-rtl text so can proceed safely rtlWorkerPlugin.getRTLTextPluginStatus() === 'unavailable' || // We don't intend to lazy-load the rtl text plugin, so proceed with incorrect shaping bucketHasRTLText && rtlWorkerPlugin.isParsed() // Use the rtlText plugin to shape text ) { text = transformText(formattedText, layer, evaluationFeature); } } let icon; if (hasIcon) { // Expression evaluation will automatically coerce to Image // but plain string token evaluation skips that pathway so do the // conversion here. const resolvedTokens = layer.getValueAndResolveTokens('icon-image', evaluationFeature, canonical, availableImages); if (resolvedTokens instanceof ResolvedImage) { icon = resolvedTokens; } else { icon = ResolvedImage.fromString(resolvedTokens); } } if (!text && !icon) { continue; } const sortKey = this.sortFeaturesByKey ? symbolSortKey.evaluate(evaluationFeature, {}, canonical) : undefined; const symbolFeature = { id, text, icon, index, sourceLayerIndex, geometry: evaluationFeature.geometry, properties: feature.properties, type: vectorTileFeatureTypes[feature.type], sortKey }; this.features.push(symbolFeature); if (icon) { icons[icon.name] = true; } if (text) { const fontStack = textFont.evaluate(evaluationFeature, {}, canonical).join(','); const textAlongLine = layout.get('text-rotation-alignment') !== 'viewport' && layout.get('symbol-placement') !== 'point'; this.allowVerticalPlacement = this.writingModes && this.writingModes.indexOf(WritingMode.vertical) >= 0; for (const section of text.sections) { if (!section.image) { const doesAllowVerticalWritingMode = allowsVerticalWritingMode(text.toString()); const sectionFont = section.fontStack || fontStack; const sectionStack = stacks[sectionFont] = stacks[sectionFont] || {}; this.calculateGlyphDependencies(section.text, sectionStack, textAlongLine, this.allowVerticalPlacement, doesAllowVerticalWritingMode); } else { // Add section image to the list of dependencies. icons[section.image.name] = true; } } } } if (layout.get('symbol-placement') === 'line') { // Merge adjacent lines with the same text to improve labelling. // It's better to place labels on one long line than on many short segments. this.features = mergeLines(this.features); } if (this.sortFeaturesByKey) { this.features.sort((a, b) => { // a.sortKey is always a number when sortFeaturesByKey is true return a.sortKey - b.sortKey; }); } } update(states, vtLayer, imagePositions) { if (!this.stateDependentLayers.length) return; this.text.programConfigurations.updatePaintArrays(states, vtLayer, this.layers, imagePositions); this.icon.programConfigurations.updatePaintArrays(states, vtLayer, this.layers, imagePositions); } isEmpty() { // When the bucket encounters only rtl-text but the plugin isn't loaded, no symbol instances will be created. // In order for the bucket to be serialized, and not discarded as an empty bucket both checks are necessary. return this.symbolInstances.length === 0 && !this.hasRTLText; } uploadPending() { return !this.uploaded || this.text.programConfigurations.needsUpload || this.icon.programConfigurations.needsUpload; } upload(context) { if (!this.uploaded && this.hasDebugData()) { this.textCollisionBox.upload(context); this.iconCollisionBox.upload(context); } this.text.upload(context, this.sortFeaturesByY, !this.uploaded, this.text.programConfigurations.needsUpload); this.icon.upload(context, this.sortFeaturesByY, !this.uploaded, this.icon.programConfigurations.needsUpload); this.uploaded = true; } destroyDebugData() { this.textCollisionBox.destroy(); this.iconCollisionBox.destroy(); } destroy() { this.text.destroy(); this.icon.destroy(); if (this.hasDebugData()) { this.destroyDebugData(); } } addToLineVertexArray(anchor, line) { const lineStartIndex = this.lineVertexArray.length; if (anchor.segment !== undefined) { let sumForwardLength = anchor.dist(line[anchor.segment + 1]); let sumBackwardLength = anchor.dist(line[anchor.segment]); const vertices = {}; for (let i = anchor.segment + 1; i < line.length; i++) { vertices[i] = { x: line[i].x, y: line[i].y, tileUnitDistanceFromAnchor: sumForwardLength }; if (i < line.length - 1) { sumForwardLength += line[i + 1].dist(line[i]); } } for (let i = anchor.segment || 0; i >= 0; i--) { vertices[i] = { x: line[i].x, y: line[i].y, tileUnitDistanceFromAnchor: sumBackwardLength }; if (i > 0) { sumBackwardLength += line[i - 1].dist(line[i]); } } for (let i = 0; i < line.length; i++) { const vertex = vertices[i]; this.lineVertexArray.emplaceBack(vertex.x, vertex.y, vertex.tileUnitDistanceFromAnchor); } } return { lineStartIndex, lineLength: this.lineVertexArray.length - lineStartIndex }; } addSymbols(arrays, quads, sizeVertex, lineOffset, alongLine, feature, writingMode, labelAnchor, lineStartIndex, lineLength, associatedIconIndex, canonical) { const indexArray = arrays.indexArray; const layoutVertexArray = arrays.layoutVertexArray; const segment = arrays.segments.prepareSegment(4 * quads.length, layoutVertexArray, indexArray, this.canOverlap ? feature.sortKey : undefined); const glyphOffsetArrayStart = this.glyphOffsetArray.length; const vertexStartIndex = segment.vertexLength; const angle = (this.allowVerticalPlacement && writingMode === WritingMode.vertical) ? Math.PI / 2 : 0; const sections = feature.text && feature.text.sections; for (let i = 0; i < quads.length; i++) { const { tl, tr, bl, br, tex, pixelOffsetTL, pixelOffsetBR, minFontScaleX, minFontScaleY, glyphOffset, isSDF, sectionIndex } = quads[i]; const index = segment.vertexLength; const y = glyphOffset[1]; addVertex(layoutVertexArray, labelAnchor.x, labelAnchor.y, tl.x, y + tl.y, tex.x, tex.y, sizeVertex, isSDF, pixelOffsetTL.x, pixelOffsetTL.y, minFontScaleX, minFontScaleY); addVertex(layoutVertexArray, labelAnchor.x, labelAnchor.y, tr.x, y + tr.y, tex.x + tex.w, tex.y, sizeVertex, isSDF, pixelOffsetBR.x, pixelOffsetTL.y, minFontScaleX, minFontScaleY); addVertex(layoutVertexArray, labelAnchor.x, labelAnchor.y, bl.x, y + bl.y, tex.x, tex.y + tex.h, sizeVertex, isSDF, pixelOffsetTL.x, pixelOffsetBR.y, minFontScaleX, minFontScaleY); addVertex(layoutVertexArray, labelAnchor.x, labelAnchor.y, br.x, y + br.y, tex.x + tex.w, tex.y + tex.h, sizeVertex, isSDF, pixelOffsetBR.x, pixelOffsetBR.y, minFontScaleX, minFontScaleY); addDynamicAttributes(arrays.dynamicLayoutVertexArray, labelAnchor, angle); indexArray.emplaceBack(index, index + 1, index + 2); indexArray.emplaceBack(index + 1, index + 2, index + 3); segment.vertexLength += 4; segment.primitiveLength += 2; this.glyphOffsetArray.emplaceBack(glyphOffset[0]); if (i === quads.length - 1 || sectionIndex !== quads[i + 1].sectionIndex) { arrays.programConfigurations.populatePaintArrays(layoutVertexArray.length, feature, feature.index, {}, canonical, sections && sections[sectionIndex]); } } arrays.placedSymbolArray.emplaceBack(labelAnchor.x, labelAnchor.y, glyphOffsetArrayStart, this.glyphOffsetArray.length - glyphOffsetArrayStart, vertexStartIndex, lineStartIndex, lineLength, labelAnchor.segment, sizeVertex ? sizeVertex[0] : 0, sizeVertex ? sizeVertex[1] : 0, lineOffset[0], lineOffset[1], writingMode, // placedOrientation is null initially; will be updated to horizontal(1)/vertical(2) if placed 0, false, // The crossTileID is only filled/used on the foreground for dynamic text anchors 0, associatedIconIndex); } _addCollisionDebugVertex(layoutVertexArray, collisionVertexArray, point, anchorX, anchorY, extrude) { collisionVertexArray.emplaceBack(0, 0); return layoutVertexArray.emplaceBack( // pos point.x, point.y, // a_anchor_pos anchorX, anchorY, // extrude Math.round(extrude.x), Math.round(extrude.y)); } addCollisionDebugVertices(x1, y1, x2, y2, arrays, boxAnchorPoint, symbolInstance) { const segment = arrays.segments.prepareSegment(4, arrays.layoutVertexArray, arrays.indexArray); const index = segment.vertexLength; const layoutVertexArray = arrays.layoutVertexArray; const collisionVertexArray = arrays.collisionVertexArray; const anchorX = symbolInstance.anchorX; const anchorY = symbolInstance.anchorY; this._addCollisionDebugVertex(layoutVertexArray, collisionVertexArray, boxAnchorPoint, anchorX, anchorY, new Point$2(x1, y1)); this._addCollisionDebugVertex(layoutVertexArray, collisionVertexArray, boxAnchorPoint, anchorX, anchorY, new Point$2(x2, y1)); this._addCollisionDebugVertex(layoutVertexArray, collisionVertexArray, boxAnchorPoint, anchorX, anchorY, new Point$2(x2, y2)); this._addCollisionDebugVertex(layoutVertexArray, collisionVertexArray, boxAnchorPoint, anchorX, anchorY, new Point$2(x1, y2)); segment.vertexLength += 4; const indexArray = arrays.indexArray; indexArray.emplaceBack(index, index + 1); indexArray.emplaceBack(index + 1, index + 2); indexArray.emplaceBack(index + 2, index + 3); indexArray.emplaceBack(index + 3, index); segment.primitiveLength += 4; } addDebugCollisionBoxes(startIndex, endIndex, symbolInstance, isText) { for (let b = startIndex; b < endIndex; b++) { const box = this.collisionBoxArray.get(b); const x1 = box.x1; const y1 = box.y1; const x2 = box.x2; const y2 = box.y2; this.addCollisionDebugVertices(x1, y1, x2, y2, isText ? this.textCollisionBox : this.iconCollisionBox, box.anchorPoint, symbolInstance); } } generateCollisionDebugBuffers() { if (this.hasDebugData()) { this.destroyDebugData(); } this.textCollisionBox = new CollisionBuffers(CollisionBoxLayoutArray, collisionBoxLayout.members, LineIndexArray); this.iconCollisionBox = new CollisionBuffers(CollisionBoxLayoutArray, collisionBoxLayout.members, LineIndexArray); for (let i = 0; i < this.symbolInstances.length; i++) { const symbolInstance = this.symbolInstances.get(i); this.addDebugCollisionBoxes(symbolInstance.textBoxStartIndex, symbolInstance.textBoxEndIndex, symbolInstance, true); this.addDebugCollisionBoxes(symbolInstance.verticalTextBoxStartIndex, symbolInstance.verticalTextBoxEndIndex, symbolInstance, true); this.addDebugCollisionBoxes(symbolInstance.iconBoxStartIndex, symbolInstance.iconBoxEndIndex, symbolInstance, false); this.addDebugCollisionBoxes(symbolInstance.verticalIconBoxStartIndex, symbolInstance.verticalIconBoxEndIndex, symbolInstance, false); } } // These flat arrays are meant to be quicker to iterate over than the source // CollisionBoxArray _deserializeCollisionBoxesForSymbol(collisionBoxArray, textStartIndex, textEndIndex, verticalTextStartIndex, verticalTextEndIndex, iconStartIndex, iconEndIndex, verticalIconStartIndex, verticalIconEndIndex) { const collisionArrays = {}; for (let k = textStartIndex; k < textEndIndex; k++) { const box = collisionBoxArray.get(k); collisionArrays.textBox = { x1: box.x1, y1: box.y1, x2: box.x2, y2: box.y2, anchorPointX: box.anchorPointX, anchorPointY: box.anchorPointY }; collisionArrays.textFeatureIndex = box.featureIndex; break; // Only one box allowed per instance } for (let k = verticalTextStartIndex; k < verticalTextEndIndex; k++) { const box = collisionBoxArray.get(k); collisionArrays.verticalTextBox = { x1: box.x1, y1: box.y1, x2: box.x2, y2: box.y2, anchorPointX: box.anchorPointX, anchorPointY: box.anchorPointY }; collisionArrays.verticalTextFeatureIndex = box.featureIndex; break; // Only one box allowed per instance } for (let k = iconStartIndex; k < iconEndIndex; k++) { // An icon can only have one box now, so this indexing is a bit vestigial... const box = collisionBoxArray.get(k); collisionArrays.iconBox = { x1: box.x1, y1: box.y1, x2: box.x2, y2: box.y2, anchorPointX: box.anchorPointX, anchorPointY: box.anchorPointY }; collisionArrays.iconFeatureIndex = box.featureIndex; break; // Only one box allowed per instance } for (let k = verticalIconStartIndex; k < verticalIconEndIndex; k++) { // An icon can only have one box now, so this indexing is a bit vestigial... const box = collisionBoxArray.get(k); collisionArrays.verticalIconBox = { x1: box.x1, y1: box.y1, x2: box.x2, y2: box.y2, anchorPointX: box.anchorPointX, anchorPointY: box.anchorPointY }; collisionArrays.verticalIconFeatureIndex = box.featureIndex; break; // Only one box allowed per instance } return collisionArrays; } deserializeCollisionBoxes(collisionBoxArray) { this.collisionArrays = []; for (let i = 0; i < this.symbolInstances.length; i++) { const symbolInstance = this.symbolInstances.get(i); this.collisionArrays.push(this._deserializeCollisionBoxesForSymbol(collisionBoxArray, symbolInstance.textBoxStartIndex, symbolInstance.textBoxEndIndex, symbolInstance.verticalTextBoxStartIndex, symbolInstance.verticalTextBoxEndIndex, symbolInstance.iconBoxStartIndex, symbolInstance.iconBoxEndIndex, symbolInstance.verticalIconBoxStartIndex, symbolInstance.verticalIconBoxEndIndex)); } } hasTextData() { return this.text.segments.get().length > 0; } hasIconData() { return this.icon.segments.get().length > 0; } hasDebugData() { return this.textCollisionBox && this.iconCollisionBox; } hasTextCollisionBoxData() { return this.hasDebugData() && this.textCollisionBox.segments.get().length > 0; } hasIconCollisionBoxData() { return this.hasDebugData() && this.iconCollisionBox.segments.get().length > 0; } addIndicesForPlacedSymbol(iconOrText, placedSymbolIndex) { const placedSymbol = iconOrText.placedSymbolArray.get(placedSymbolIndex); const endIndex = placedSymbol.vertexStartIndex + placedSymbol.numGlyphs * 4; for (let vertexIndex = placedSymbol.vertexStartIndex; vertexIndex < endIndex; vertexIndex += 4) { iconOrText.indexArray.emplaceBack(vertexIndex, vertexIndex + 1, vertexIndex + 2); iconOrText.indexArray.emplaceBack(vertexIndex + 1, vertexIndex + 2, vertexIndex + 3); } } getSortedSymbolIndexes(angle) { if (this.sortedAngle === angle && this.symbolInstanceIndexes !== undefined) { return this.symbolInstanceIndexes; } const sin = Math.sin(angle); const cos = Math.cos(angle); const rotatedYs = []; const featureIndexes = []; const result = []; for (let i = 0; i < this.symbolInstances.length; ++i) { result.push(i); const symbolInstance = this.symbolInstances.get(i); rotatedYs.push(Math.round(sin * symbolInstance.anchorX + cos * symbolInstance.anchorY) | 0); featureIndexes.push(symbolInstance.featureIndex); } result.sort((aIndex, bIndex) => { return (rotatedYs[aIndex] - rotatedYs[bIndex]) || (featureIndexes[bIndex] - featureIndexes[aIndex]); }); return result; } addToSortKeyRanges(symbolInstanceIndex, sortKey) { const last = this.sortKeyRanges[this.sortKeyRanges.length - 1]; if (last && last.sortKey === sortKey) { last.symbolInstanceEnd = symbolInstanceIndex + 1; } else { this.sortKeyRanges.push({ sortKey, symbolInstanceStart: symbolInstanceIndex, symbolInstanceEnd: symbolInstanceIndex + 1 }); } } sortFeatures(angle) { if (!this.sortFeaturesByY) return; if (this.sortedAngle === angle) return; // The current approach to sorting doesn't sort across segments so don't try. // Sorting within segments separately seemed not to be worth the complexity. if (this.text.segments.get().length > 1 || this.icon.segments.get().length > 1) return; // If the symbols are allowed to overlap sort them by their vertical screen position. // The index array buffer is rewritten to reference the (unchanged) vertices in the // sorted order. // To avoid sorting the actual symbolInstance array we sort an array of indexes. this.symbolInstanceIndexes = this.getSortedSymbolIndexes(angle); this.sortedAngle = angle; this.text.indexArray.clear(); this.icon.indexArray.clear(); this.featureSortOrder = []; for (const i of this.symbolInstanceIndexes) { const symbolInstance = this.symbolInstances.get(i); this.featureSortOrder.push(symbolInstance.featureIndex); [ symbolInstance.rightJustifiedTextSymbolIndex, symbolInstance.centerJustifiedTextSymbolIndex, symbolInstance.leftJustifiedTextSymbolIndex ].forEach((index, i, array) => { // Only add a given index the first time it shows up, // to avoid duplicate opacity entries when multiple justifications // share the same glyphs. if (index >= 0 && array.indexOf(index) === i) { this.addIndicesForPlacedSymbol(this.text, index); } }); if (symbolInstance.verticalPlacedTextSymbolIndex >= 0) { this.addIndicesForPlacedSymbol(this.text, symbolInstance.verticalPlacedTextSymbolIndex); } if (symbolInstance.placedIconSymbolIndex >= 0) { this.addIndicesForPlacedSymbol(this.icon, symbolInstance.placedIconSymbolIndex); } if (symbolInstance.verticalPlacedIconSymbolIndex >= 0) { this.addIndicesForPlacedSymbol(this.icon, symbolInstance.verticalPlacedIconSymbolIndex); } } if (this.text.indexBuffer) this.text.indexBuffer.updateData(this.text.indexArray); if (this.icon.indexBuffer) this.icon.indexBuffer.updateData(this.icon.indexArray); } } register('SymbolBucket', SymbolBucket, { omit: ['layers', 'collisionBoxArray', 'features', 'compareText'] }); // this constant is based on the size of StructArray indexes used in a symbol // bucket--namely, glyphOffsetArrayStart // eg the max valid UInt16 is 65,535 // See https://github.com/mapbox/mapbox-gl-js/issues/2907 for motivation // lineStartIndex and textBoxStartIndex could potentially be concerns // but we expect there to be many fewer boxes/lines than glyphs SymbolBucket.MAX_GLYPHS = 65535; SymbolBucket.addDynamicAttributes = addDynamicAttributes; /** * Replace tokens in a string template with values in an object * * @param properties - a key/value relationship between tokens and replacements * @param text - the template string * @returns the template with tokens replaced */ function resolveTokens(properties, text) { return text.replace(/{([^{}]+)}/g, (match, key) => { return properties && key in properties ? String(properties[key]) : ''; }); } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let layout; const getLayout = () => layout = layout || new Properties({ "symbol-placement": new DataConstantProperty(v8Spec["layout_symbol"]["symbol-placement"]), "symbol-spacing": new DataConstantProperty(v8Spec["layout_symbol"]["symbol-spacing"]), "symbol-avoid-edges": new DataConstantProperty(v8Spec["layout_symbol"]["symbol-avoid-edges"]), "symbol-sort-key": new DataDrivenProperty(v8Spec["layout_symbol"]["symbol-sort-key"]), "symbol-z-order": new DataConstantProperty(v8Spec["layout_symbol"]["symbol-z-order"]), "icon-allow-overlap": new DataConstantProperty(v8Spec["layout_symbol"]["icon-allow-overlap"]), "icon-overlap": new DataConstantProperty(v8Spec["layout_symbol"]["icon-overlap"]), "icon-ignore-placement": new DataConstantProperty(v8Spec["layout_symbol"]["icon-ignore-placement"]), "icon-optional": new DataConstantProperty(v8Spec["layout_symbol"]["icon-optional"]), "icon-rotation-alignment": new DataConstantProperty(v8Spec["layout_symbol"]["icon-rotation-alignment"]), "icon-size": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-size"]), "icon-text-fit": new DataConstantProperty(v8Spec["layout_symbol"]["icon-text-fit"]), "icon-text-fit-padding": new DataConstantProperty(v8Spec["layout_symbol"]["icon-text-fit-padding"]), "icon-image": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-image"]), "icon-rotate": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-rotate"]), "icon-padding": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-padding"]), "icon-keep-upright": new DataConstantProperty(v8Spec["layout_symbol"]["icon-keep-upright"]), "icon-offset": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-offset"]), "icon-anchor": new DataDrivenProperty(v8Spec["layout_symbol"]["icon-anchor"]), "icon-pitch-alignment": new DataConstantProperty(v8Spec["layout_symbol"]["icon-pitch-alignment"]), "text-pitch-alignment": new DataConstantProperty(v8Spec["layout_symbol"]["text-pitch-alignment"]), "text-rotation-alignment": new DataConstantProperty(v8Spec["layout_symbol"]["text-rotation-alignment"]), "text-field": new DataDrivenProperty(v8Spec["layout_symbol"]["text-field"]), "text-font": new DataDrivenProperty(v8Spec["layout_symbol"]["text-font"]), "text-size": new DataDrivenProperty(v8Spec["layout_symbol"]["text-size"]), "text-max-width": new DataDrivenProperty(v8Spec["layout_symbol"]["text-max-width"]), "text-line-height": new DataConstantProperty(v8Spec["layout_symbol"]["text-line-height"]), "text-letter-spacing": new DataDrivenProperty(v8Spec["layout_symbol"]["text-letter-spacing"]), "text-justify": new DataDrivenProperty(v8Spec["layout_symbol"]["text-justify"]), "text-radial-offset": new DataDrivenProperty(v8Spec["layout_symbol"]["text-radial-offset"]), "text-variable-anchor": new DataConstantProperty(v8Spec["layout_symbol"]["text-variable-anchor"]), "text-variable-anchor-offset": new DataDrivenProperty(v8Spec["layout_symbol"]["text-variable-anchor-offset"]), "text-anchor": new DataDrivenProperty(v8Spec["layout_symbol"]["text-anchor"]), "text-max-angle": new DataConstantProperty(v8Spec["layout_symbol"]["text-max-angle"]), "text-writing-mode": new DataConstantProperty(v8Spec["layout_symbol"]["text-writing-mode"]), "text-rotate": new DataDrivenProperty(v8Spec["layout_symbol"]["text-rotate"]), "text-padding": new DataConstantProperty(v8Spec["layout_symbol"]["text-padding"]), "text-keep-upright": new DataConstantProperty(v8Spec["layout_symbol"]["text-keep-upright"]), "text-transform": new DataDrivenProperty(v8Spec["layout_symbol"]["text-transform"]), "text-offset": new DataDrivenProperty(v8Spec["layout_symbol"]["text-offset"]), "text-allow-overlap": new DataConstantProperty(v8Spec["layout_symbol"]["text-allow-overlap"]), "text-overlap": new DataConstantProperty(v8Spec["layout_symbol"]["text-overlap"]), "text-ignore-placement": new DataConstantProperty(v8Spec["layout_symbol"]["text-ignore-placement"]), "text-optional": new DataConstantProperty(v8Spec["layout_symbol"]["text-optional"]), }); let paint$2; const getPaint$2 = () => paint$2 = paint$2 || new Properties({ "icon-opacity": new DataDrivenProperty(v8Spec["paint_symbol"]["icon-opacity"]), "icon-color": new DataDrivenProperty(v8Spec["paint_symbol"]["icon-color"]), "icon-halo-color": new DataDrivenProperty(v8Spec["paint_symbol"]["icon-halo-color"]), "icon-halo-width": new DataDrivenProperty(v8Spec["paint_symbol"]["icon-halo-width"]), "icon-halo-blur": new DataDrivenProperty(v8Spec["paint_symbol"]["icon-halo-blur"]), "icon-translate": new DataConstantProperty(v8Spec["paint_symbol"]["icon-translate"]), "icon-translate-anchor": new DataConstantProperty(v8Spec["paint_symbol"]["icon-translate-anchor"]), "text-opacity": new DataDrivenProperty(v8Spec["paint_symbol"]["text-opacity"]), "text-color": new DataDrivenProperty(v8Spec["paint_symbol"]["text-color"], { runtimeType: ColorType, getOverride: (o) => o.textColor, hasOverride: (o) => !!o.textColor }), "text-halo-color": new DataDrivenProperty(v8Spec["paint_symbol"]["text-halo-color"]), "text-halo-width": new DataDrivenProperty(v8Spec["paint_symbol"]["text-halo-width"]), "text-halo-blur": new DataDrivenProperty(v8Spec["paint_symbol"]["text-halo-blur"]), "text-translate": new DataConstantProperty(v8Spec["paint_symbol"]["text-translate"]), "text-translate-anchor": new DataConstantProperty(v8Spec["paint_symbol"]["text-translate-anchor"]), }); var properties$3 = ({ get paint() { return getPaint$2(); }, get layout() { return getLayout(); } }); // This is an internal expression class. It is only used in GL JS and // has GL JS dependencies which can break the standalone style-spec module class FormatSectionOverride { constructor(defaultValue) { if (defaultValue.property.overrides === undefined) throw new Error('overrides must be provided to instantiate FormatSectionOverride class'); this.type = defaultValue.property.overrides ? defaultValue.property.overrides.runtimeType : NullType; this.defaultValue = defaultValue; } evaluate(ctx) { if (ctx.formattedSection) { const overrides = this.defaultValue.property.overrides; if (overrides && overrides.hasOverride(ctx.formattedSection)) { return overrides.getOverride(ctx.formattedSection); } } if (ctx.feature && ctx.featureState) { return this.defaultValue.evaluate(ctx.feature, ctx.featureState); } return this.defaultValue.property.specification.default; } eachChild(fn) { if (!this.defaultValue.isConstant()) { const expr = this.defaultValue.value; fn(expr._styleExpression.expression); } } // Cannot be statically evaluated, as the output depends on the evaluation context. outputDefined() { return false; } serialize() { return null; } } register('FormatSectionOverride', FormatSectionOverride, { omit: ['defaultValue'] }); class SymbolStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$3); } recalculate(parameters, availableImages) { super.recalculate(parameters, availableImages); if (this.layout.get('icon-rotation-alignment') === 'auto') { if (this.layout.get('symbol-placement') !== 'point') { this.layout._values['icon-rotation-alignment'] = 'map'; } else { this.layout._values['icon-rotation-alignment'] = 'viewport'; } } if (this.layout.get('text-rotation-alignment') === 'auto') { if (this.layout.get('symbol-placement') !== 'point') { this.layout._values['text-rotation-alignment'] = 'map'; } else { this.layout._values['text-rotation-alignment'] = 'viewport'; } } // If unspecified, `*-pitch-alignment` inherits `*-rotation-alignment` if (this.layout.get('text-pitch-alignment') === 'auto') { this.layout._values['text-pitch-alignment'] = this.layout.get('text-rotation-alignment') === 'map' ? 'map' : 'viewport'; } if (this.layout.get('icon-pitch-alignment') === 'auto') { this.layout._values['icon-pitch-alignment'] = this.layout.get('icon-rotation-alignment'); } if (this.layout.get('symbol-placement') === 'point') { const writingModes = this.layout.get('text-writing-mode'); if (writingModes) { // remove duplicates, preserving order const deduped = []; for (const m of writingModes) { if (deduped.indexOf(m) < 0) deduped.push(m); } this.layout._values['text-writing-mode'] = deduped; } else { this.layout._values['text-writing-mode'] = ['horizontal']; } } this._setPaintOverrides(); } getValueAndResolveTokens(name, feature, canonical, availableImages) { const value = this.layout.get(name).evaluate(feature, {}, canonical, availableImages); const unevaluated = this._unevaluatedLayout._values[name]; if (!unevaluated.isDataDriven() && !isExpression(unevaluated.value) && value) { return resolveTokens(feature.properties, value); } return value; } createBucket(parameters) { return new SymbolBucket(parameters); } queryRadius() { return 0; } queryIntersectsFeature() { throw new Error('Should take a different path in FeatureIndex'); } _setPaintOverrides() { for (const overridable of properties$3.paint.overridableProperties) { if (!SymbolStyleLayer.hasPaintOverride(this.layout, overridable)) { continue; } const overridden = this.paint.get(overridable); const override = new FormatSectionOverride(overridden); const styleExpression = new StyleExpression(override, overridden.property.specification); let expression = null; if (overridden.value.kind === 'constant' || overridden.value.kind === 'source') { expression = new ZoomConstantExpression('source', styleExpression); } else { expression = new ZoomDependentExpression('composite', styleExpression, overridden.value.zoomStops); } this.paint._values[overridable] = new PossiblyEvaluatedPropertyValue(overridden.property, expression, overridden.parameters); } } _handleOverridablePaintPropertyUpdate(name, oldValue, newValue) { if (!this.layout || oldValue.isDataDriven() || newValue.isDataDriven()) { return false; } return SymbolStyleLayer.hasPaintOverride(this.layout, name); } static hasPaintOverride(layout, propertyName) { const textField = layout.get('text-field'); const property = properties$3.paint.properties[propertyName]; let hasOverrides = false; const checkSections = (sections) => { for (const section of sections) { if (property.overrides && property.overrides.hasOverride(section)) { hasOverrides = true; return; } } }; if (textField.value.kind === 'constant' && textField.value.value instanceof Formatted) { checkSections(textField.value.value.sections); } else if (textField.value.kind === 'source') { const checkExpression = (expression) => { if (hasOverrides) return; if (expression instanceof Literal && typeOf(expression.value) === FormattedType) { const formatted = expression.value; checkSections(formatted.sections); } else if (expression instanceof FormatExpression) { checkSections(expression.sections); } else { expression.eachChild(checkExpression); } }; const expr = textField.value; if (expr._styleExpression) { checkExpression(expr._styleExpression.expression); } } return hasOverrides; } } function getIconPadding(layout, feature, canonical, pixelRatio = 1) { // Support text-padding in addition to icon-padding? Unclear how to apply asymmetric text-padding to the radius for collision circles. const result = layout.get('icon-padding').evaluate(feature, {}, canonical); const values = result && result.values; return [ values[0] * pixelRatio, values[1] * pixelRatio, values[2] * pixelRatio, values[3] * pixelRatio, ]; } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let paint$1; const getPaint$1 = () => paint$1 = paint$1 || new Properties({ "background-color": new DataConstantProperty(v8Spec["paint_background"]["background-color"]), "background-pattern": new CrossFadedProperty(v8Spec["paint_background"]["background-pattern"]), "background-opacity": new DataConstantProperty(v8Spec["paint_background"]["background-opacity"]), }); var properties$2 = ({ get paint() { return getPaint$1(); } }); class BackgroundStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$2); } } // This file is generated. Edit build/generate-style-code.ts, then run 'npm run codegen'. /* eslint-disable */ let paint; const getPaint = () => paint = paint || new Properties({ "raster-opacity": new DataConstantProperty(v8Spec["paint_raster"]["raster-opacity"]), "raster-hue-rotate": new DataConstantProperty(v8Spec["paint_raster"]["raster-hue-rotate"]), "raster-brightness-min": new DataConstantProperty(v8Spec["paint_raster"]["raster-brightness-min"]), "raster-brightness-max": new DataConstantProperty(v8Spec["paint_raster"]["raster-brightness-max"]), "raster-saturation": new DataConstantProperty(v8Spec["paint_raster"]["raster-saturation"]), "raster-contrast": new DataConstantProperty(v8Spec["paint_raster"]["raster-contrast"]), "raster-resampling": new DataConstantProperty(v8Spec["paint_raster"]["raster-resampling"]), "raster-fade-duration": new DataConstantProperty(v8Spec["paint_raster"]["raster-fade-duration"]), }); var properties$1 = ({ get paint() { return getPaint(); } }); class RasterStyleLayer extends StyleLayer { constructor(layer) { super(layer, properties$1); } } function validateCustomStyleLayer(layerObject) { const errors = []; const id = layerObject.id; if (id === undefined) { errors.push({ message: `layers.${id}: missing required property "id"` }); } if (layerObject.render === undefined) { errors.push({ message: `layers.${id}: missing required method "render"` }); } if (layerObject.renderingMode && layerObject.renderingMode !== '2d' && layerObject.renderingMode !== '3d') { errors.push({ message: `layers.${id}: property "renderingMode" must be either "2d" or "3d"` }); } return errors; } class CustomStyleLayer extends StyleLayer { constructor(implementation) { super(implementation, {}); this.onAdd = (map) => { if (this.implementation.onAdd) { this.implementation.onAdd(map, map.painter.context.gl); } }; this.onRemove = (map) => { if (this.implementation.onRemove) { this.implementation.onRemove(map, map.painter.context.gl); } }; this.implementation = implementation; } is3D() { return this.implementation.renderingMode === '3d'; } hasOffscreenPass() { return this.implementation.prerender !== undefined; } recalculate() { } updateTransitions() { } hasTransition() { return false; } serialize() { throw new Error('Custom layers cannot be serialized'); } } function createStyleLayer(layer) { if (layer.type === 'custom') { return new CustomStyleLayer(layer); } switch (layer.type) { case 'background': return new BackgroundStyleLayer(layer); case 'circle': return new CircleStyleLayer(layer); case 'fill': return new FillStyleLayer(layer); case 'fill-extrusion': return new FillExtrusionStyleLayer(layer); case 'heatmap': return new HeatmapStyleLayer(layer); case 'hillshade': return new HillshadeStyleLayer(layer); case 'line': return new LineStyleLayer(layer); case 'raster': return new RasterStyleLayer(layer); case 'symbol': return new SymbolStyleLayer(layer); } } /** * Takes a SpriteSpecification value and returns it in its array form. If `undefined` is passed as an input value, an * empty array is returned. * duplicated entries with identical id/url will be removed in returned array * @param sprite - optional sprite to coerce * @returns an empty array in case `undefined` is passed; id-url pairs otherwise */ function coerceSpriteToArray(sprite) { const resultArray = []; if (typeof sprite === 'string') { resultArray.push({ id: 'default', url: sprite }); } else if (sprite && sprite.length > 0) { const dedupArray = []; for (const { id, url } of sprite) { const key = `${id}${url}`; if (dedupArray.indexOf(key) === -1) { dedupArray.push(key); resultArray.push({ id, url }); } } } return resultArray; } function normalizeSpriteURL(url, format, extension) { const split = url.split('?'); split[0] += `${format}${extension}`; return split.join('?'); } function loadSprite(originalSprite, requestManager, pixelRatio, abortController) { return __awaiter(this, void 0, void 0, function* () { const spriteArray = coerceSpriteToArray(originalSprite); const format = pixelRatio > 1 ? '@2x' : ''; const jsonsMap = {}; const imagesMap = {}; for (const { id, url } of spriteArray) { const jsonRequestParameters = requestManager.transformRequest(normalizeSpriteURL(url, format, '.json'), "SpriteJSON" /* ResourceType.SpriteJSON */); jsonsMap[id] = getJSON(jsonRequestParameters, abortController); const imageRequestParameters = requestManager.transformRequest(normalizeSpriteURL(url, format, '.png'), "SpriteImage" /* ResourceType.SpriteImage */); imagesMap[id] = ImageRequest.getImage(imageRequestParameters, abortController); } yield Promise.all([...Object.values(jsonsMap), ...Object.values(imagesMap)]); return doOnceCompleted(jsonsMap, imagesMap); }); } /** * @param jsonsMap - JSON data map * @param imagesMap - image data map */ function doOnceCompleted(jsonsMap, imagesMap) { return __awaiter(this, void 0, void 0, function* () { const result = {}; for (const spriteName in jsonsMap) { result[spriteName] = {}; const context = browser.getImageCanvasContext((yield imagesMap[spriteName]).data); const json = (yield jsonsMap[spriteName]).data; for (const id in json) { const { width, height, x, y, sdf, pixelRatio, stretchX, stretchY, content, textFitWidth, textFitHeight } = json[id]; const spriteData = { width, height, x, y, context }; result[spriteName][id] = { data: null, pixelRatio, sdf, stretchX, stretchY, content, textFitWidth, textFitHeight, spriteData }; } } return result; }); } /** * @internal * A `Texture` GL related object */ class Texture { constructor(context, image, format, options) { this.context = context; this.format = format; this.texture = context.gl.createTexture(); this.update(image, options); } update(image, options, position) { const { width, height } = image; const resize = (!this.size || this.size[0] !== width || this.size[1] !== height) && !position; const { context } = this; const { gl } = context; this.useMipmap = Boolean(options && options.useMipmap); gl.bindTexture(gl.TEXTURE_2D, this.texture); context.pixelStoreUnpackFlipY.set(false); context.pixelStoreUnpack.set(1); context.pixelStoreUnpackPremultiplyAlpha.set(this.format === gl.RGBA && (!options || options.premultiply !== false)); if (resize) { this.size = [width, height]; if (image instanceof HTMLImageElement || image instanceof HTMLCanvasElement || image instanceof HTMLVideoElement || image instanceof ImageData || isImageBitmap(image)) { gl.texImage2D(gl.TEXTURE_2D, 0, this.format, this.format, gl.UNSIGNED_BYTE, image); } else { gl.texImage2D(gl.TEXTURE_2D, 0, this.format, width, height, 0, this.format, gl.UNSIGNED_BYTE, image.data); } } else { const { x, y } = position || { x: 0, y: 0 }; if (image instanceof HTMLImageElement || image instanceof HTMLCanvasElement || image instanceof HTMLVideoElement || image instanceof ImageData || isImageBitmap(image)) { gl.texSubImage2D(gl.TEXTURE_2D, 0, x, y, gl.RGBA, gl.UNSIGNED_BYTE, image); } else { gl.texSubImage2D(gl.TEXTURE_2D, 0, x, y, width, height, gl.RGBA, gl.UNSIGNED_BYTE, image.data); } } if (this.useMipmap && this.isSizePowerOfTwo()) { gl.generateMipmap(gl.TEXTURE_2D); } } bind(filter, wrap, minFilter) { const { context } = this; const { gl } = context; gl.bindTexture(gl.TEXTURE_2D, this.texture); if (minFilter === gl.LINEAR_MIPMAP_NEAREST && !this.isSizePowerOfTwo()) { minFilter = gl.LINEAR; } if (filter !== this.filter) { gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, filter); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, minFilter || filter); this.filter = filter; } if (wrap !== this.wrap) { gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, wrap); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, wrap); this.wrap = wrap; } } isSizePowerOfTwo() { return this.size[0] === this.size[1] && (Math.log(this.size[0]) / Math.LN2) % 1 === 0; } destroy() { const { gl } = this.context; gl.deleteTexture(this.texture); this.texture = null; } } function renderStyleImage(image) { const { userImage } = image; if (userImage && userImage.render) { const updated = userImage.render(); if (updated) { image.data.replace(new Uint8Array(userImage.data.buffer)); return true; } } return false; } /* eslint-disable key-spacing */ /** * When copied into the atlas texture, image data is padded by one pixel on each side. Icon * images are padded with fully transparent pixels, while pattern images are padded with a * copy of the image data wrapped from the opposite side. In both cases, this ensures the * correct behavior of GL_LINEAR texture sampling mode. */ const padding = 1; /** * ImageManager does three things: * * 1. Tracks requests for icon images from tile workers and sends responses when the requests are fulfilled. * 2. Builds a texture atlas for pattern images. * 3. Rerenders renderable images once per frame * * These are disparate responsibilities and should eventually be handled by different classes. When we implement * data-driven support for `*-pattern`, we'll likely use per-bucket pattern atlases, and that would be a good time * to refactor this. */ class ImageManager extends Evented { constructor() { super(); this.images = {}; this.updatedImages = {}; this.callbackDispatchedThisFrame = {}; this.loaded = false; this.requestors = []; this.patterns = {}; this.atlasImage = new RGBAImage({ width: 1, height: 1 }); this.dirty = true; } isLoaded() { return this.loaded; } setLoaded(loaded) { if (this.loaded === loaded) { return; } this.loaded = loaded; if (loaded) { for (const { ids, promiseResolve } of this.requestors) { promiseResolve(this._getImagesForIds(ids)); } this.requestors = []; } } getImage(id) { const image = this.images[id]; // Extract sprite image data on demand if (image && !image.data && image.spriteData) { const spriteData = image.spriteData; image.data = new RGBAImage({ width: spriteData.width, height: spriteData.height }, spriteData.context.getImageData(spriteData.x, spriteData.y, spriteData.width, spriteData.height).data); image.spriteData = null; } return image; } addImage(id, image) { if (this.images[id]) throw new Error(`Image id ${id} already exist, use updateImage instead`); if (this._validate(id, image)) { this.images[id] = image; } } _validate(id, image) { let valid = true; const data = image.data || image.spriteData; if (!this._validateStretch(image.stretchX, data && data.width)) { this.fire(new ErrorEvent(new Error(`Image "${id}" has invalid "stretchX" value`))); valid = false; } if (!this._validateStretch(image.stretchY, data && data.height)) { this.fire(new ErrorEvent(new Error(`Image "${id}" has invalid "stretchY" value`))); valid = false; } if (!this._validateContent(image.content, image)) { this.fire(new ErrorEvent(new Error(`Image "${id}" has invalid "content" value`))); valid = false; } return valid; } _validateStretch(stretch, size) { if (!stretch) return true; let last = 0; for (const part of stretch) { if (part[0] < last || part[1] < part[0] || size < part[1]) return false; last = part[1]; } return true; } _validateContent(content, image) { if (!content) return true; if (content.length !== 4) return false; const spriteData = image.spriteData; const width = (spriteData && spriteData.width) || image.data.width; const height = (spriteData && spriteData.height) || image.data.height; if (content[0] < 0 || width < content[0]) return false; if (content[1] < 0 || height < content[1]) return false; if (content[2] < 0 || width < content[2]) return false; if (content[3] < 0 || height < content[3]) return false; if (content[2] < content[0]) return false; if (content[3] < content[1]) return false; return true; } updateImage(id, image, validate = true) { const oldImage = this.getImage(id); if (validate && (oldImage.data.width !== image.data.width || oldImage.data.height !== image.data.height)) { throw new Error(`size mismatch between old image (${oldImage.data.width}x${oldImage.data.height}) and new image (${image.data.width}x${image.data.height}).`); } image.version = oldImage.version + 1; this.images[id] = image; this.updatedImages[id] = true; } removeImage(id) { const image = this.images[id]; delete this.images[id]; delete this.patterns[id]; if (image.userImage && image.userImage.onRemove) { image.userImage.onRemove(); } } listImages() { return Object.keys(this.images); } getImages(ids) { return new Promise((resolve, _reject) => { // If the sprite has been loaded, or if all the icon dependencies are already present // (i.e. if they've been added via runtime styling), then notify the requestor immediately. // Otherwise, delay notification until the sprite is loaded. At that point, if any of the // dependencies are still unavailable, we'll just assume they are permanently missing. let hasAllDependencies = true; if (!this.isLoaded()) { for (const id of ids) { if (!this.images[id]) { hasAllDependencies = false; } } } if (this.isLoaded() || hasAllDependencies) { resolve(this._getImagesForIds(ids)); } else { this.requestors.push({ ids, promiseResolve: resolve }); } }); } _getImagesForIds(ids) { const response = {}; for (const id of ids) { let image = this.getImage(id); if (!image) { this.fire(new Event('styleimagemissing', { id })); //Try to acquire image again in case styleimagemissing has populated it image = this.getImage(id); } if (image) { // Clone the image so that our own copy of its ArrayBuffer doesn't get transferred. response[id] = { data: image.data.clone(), pixelRatio: image.pixelRatio, sdf: image.sdf, version: image.version, stretchX: image.stretchX, stretchY: image.stretchY, content: image.content, textFitWidth: image.textFitWidth, textFitHeight: image.textFitHeight, hasRenderCallback: Boolean(image.userImage && image.userImage.render) }; } else { warnOnce(`Image "${id}" could not be loaded. Please make sure you have added the image with map.addImage() or a "sprite" property in your style. You can provide missing images by listening for the "styleimagemissing" map event.`); } } return response; } // Pattern stuff getPixelSize() { const { width, height } = this.atlasImage; return { width, height }; } getPattern(id) { const pattern = this.patterns[id]; const image = this.getImage(id); if (!image) { return null; } if (pattern && pattern.position.version === image.version) { return pattern.position; } if (!pattern) { const w = image.data.width + padding * 2; const h = image.data.height + padding * 2; const bin = { w, h, x: 0, y: 0 }; const position = new ImagePosition(bin, image); this.patterns[id] = { bin, position }; } else { pattern.position.version = image.version; } this._updatePatternAtlas(); return this.patterns[id].position; } bind(context) { const gl = context.gl; if (!this.atlasTexture) { this.atlasTexture = new Texture(context, this.atlasImage, gl.RGBA); } else if (this.dirty) { this.atlasTexture.update(this.atlasImage); this.dirty = false; } this.atlasTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); } _updatePatternAtlas() { const bins = []; for (const id in this.patterns) { bins.push(this.patterns[id].bin); } const { w, h } = potpack(bins); const dst = this.atlasImage; dst.resize({ width: w || 1, height: h || 1 }); for (const id in this.patterns) { const { bin } = this.patterns[id]; const x = bin.x + padding; const y = bin.y + padding; const src = this.getImage(id).data; const w = src.width; const h = src.height; RGBAImage.copy(src, dst, { x: 0, y: 0 }, { x, y }, { width: w, height: h }); // Add 1 pixel wrapped padding on each side of the image. RGBAImage.copy(src, dst, { x: 0, y: h - 1 }, { x, y: y - 1 }, { width: w, height: 1 }); // T RGBAImage.copy(src, dst, { x: 0, y: 0 }, { x, y: y + h }, { width: w, height: 1 }); // B RGBAImage.copy(src, dst, { x: w - 1, y: 0 }, { x: x - 1, y }, { width: 1, height: h }); // L RGBAImage.copy(src, dst, { x: 0, y: 0 }, { x: x + w, y }, { width: 1, height: h }); // R } this.dirty = true; } beginFrame() { this.callbackDispatchedThisFrame = {}; } dispatchRenderCallbacks(ids) { for (const id of ids) { // the callback for the image was already dispatched for a different frame if (this.callbackDispatchedThisFrame[id]) continue; this.callbackDispatchedThisFrame[id] = true; const image = this.getImage(id); if (!image) warnOnce(`Image with ID: "${id}" was not found`); const updated = renderStyleImage(image); if (updated) { this.updateImage(id, image); } } } } function loadGlyphRange(fontstack, range, urlTemplate, requestManager) { return __awaiter(this, void 0, void 0, function* () { const begin = range * 256; const end = begin + 255; const request = requestManager.transformRequest(urlTemplate.replace('{fontstack}', fontstack).replace('{range}', `${begin}-${end}`), "Glyphs" /* ResourceType.Glyphs */); const response = yield getArrayBuffer(request, new AbortController()); if (!response || !response.data) { throw new Error(`Could not load glyph range. range: ${range}, ${begin}-${end}`); } const glyphs = {}; for (const glyph of parseGlyphPbf(response.data)) { glyphs[glyph.id] = glyph; } return glyphs; }); } const INF = 1e20; class TinySDF { constructor({ fontSize = 24, buffer = 3, radius = 8, cutoff = 0.25, fontFamily = 'sans-serif', fontWeight = 'normal', fontStyle = 'normal' } = {}) { this.buffer = buffer; this.cutoff = cutoff; this.radius = radius; // make the canvas size big enough to both have the specified buffer around the glyph // for "halo", and account for some glyphs possibly being larger than their font size const size = this.size = fontSize + buffer * 4; const canvas = this._createCanvas(size); const ctx = this.ctx = canvas.getContext('2d', {willReadFrequently: true}); ctx.font = `${fontStyle} ${fontWeight} ${fontSize}px ${fontFamily}`; ctx.textBaseline = 'alphabetic'; ctx.textAlign = 'left'; // Necessary so that RTL text doesn't have different alignment ctx.fillStyle = 'black'; // temporary arrays for the distance transform this.gridOuter = new Float64Array(size * size); this.gridInner = new Float64Array(size * size); this.f = new Float64Array(size); this.z = new Float64Array(size + 1); this.v = new Uint16Array(size); } _createCanvas(size) { const canvas = document.createElement('canvas'); canvas.width = canvas.height = size; return canvas; } draw(char) { const { width: glyphAdvance, actualBoundingBoxAscent, actualBoundingBoxDescent, actualBoundingBoxLeft, actualBoundingBoxRight } = this.ctx.measureText(char); // The integer/pixel part of the top alignment is encoded in metrics.glyphTop // The remainder is implicitly encoded in the rasterization const glyphTop = Math.ceil(actualBoundingBoxAscent); const glyphLeft = 0; // If the glyph overflows the canvas size, it will be clipped at the bottom/right const glyphWidth = Math.max(0, Math.min(this.size - this.buffer, Math.ceil(actualBoundingBoxRight - actualBoundingBoxLeft))); const glyphHeight = Math.min(this.size - this.buffer, glyphTop + Math.ceil(actualBoundingBoxDescent)); const width = glyphWidth + 2 * this.buffer; const height = glyphHeight + 2 * this.buffer; const len = Math.max(width * height, 0); const data = new Uint8ClampedArray(len); const glyph = {data, width, height, glyphWidth, glyphHeight, glyphTop, glyphLeft, glyphAdvance}; if (glyphWidth === 0 || glyphHeight === 0) return glyph; const {ctx, buffer, gridInner, gridOuter} = this; ctx.clearRect(buffer, buffer, glyphWidth, glyphHeight); ctx.fillText(char, buffer, buffer + glyphTop); const imgData = ctx.getImageData(buffer, buffer, glyphWidth, glyphHeight); // Initialize grids outside the glyph range to alpha 0 gridOuter.fill(INF, 0, len); gridInner.fill(0, 0, len); for (let y = 0; y < glyphHeight; y++) { for (let x = 0; x < glyphWidth; x++) { const a = imgData.data[4 * (y * glyphWidth + x) + 3] / 255; // alpha value if (a === 0) continue; // empty pixels const j = (y + buffer) * width + x + buffer; if (a === 1) { // fully drawn pixels gridOuter[j] = 0; gridInner[j] = INF; } else { // aliased pixels const d = 0.5 - a; gridOuter[j] = d > 0 ? d * d : 0; gridInner[j] = d < 0 ? d * d : 0; } } } edt(gridOuter, 0, 0, width, height, width, this.f, this.v, this.z); edt(gridInner, buffer, buffer, glyphWidth, glyphHeight, width, this.f, this.v, this.z); for (let i = 0; i < len; i++) { const d = Math.sqrt(gridOuter[i]) - Math.sqrt(gridInner[i]); data[i] = Math.round(255 - 255 * (d / this.radius + this.cutoff)); } return glyph; } } // 2D Euclidean squared distance transform by Felzenszwalb & Huttenlocher https://cs.brown.edu/~pff/papers/dt-final.pdf function edt(data, x0, y0, width, height, gridSize, f, v, z) { for (let x = x0; x < x0 + width; x++) edt1d(data, y0 * gridSize + x, gridSize, height, f, v, z); for (let y = y0; y < y0 + height; y++) edt1d(data, y * gridSize + x0, 1, width, f, v, z); } // 1D squared distance transform function edt1d(grid, offset, stride, length, f, v, z) { v[0] = 0; z[0] = -INF; z[1] = INF; f[0] = grid[offset]; for (let q = 1, k = 0, s = 0; q < length; q++) { f[q] = grid[offset + q * stride]; const q2 = q * q; do { const r = v[k]; s = (f[q] - f[r] + q2 - r * r) / (q - r) / 2; } while (s <= z[k] && --k > -1); k++; v[k] = q; z[k] = s; z[k + 1] = INF; } for (let q = 0, k = 0; q < length; q++) { while (z[k + 1] < q) k++; const r = v[k]; const qr = q - r; grid[offset + q * stride] = f[r] + qr * qr; } } class GlyphManager { constructor(requestManager, localIdeographFontFamily) { this.requestManager = requestManager; this.localIdeographFontFamily = localIdeographFontFamily; this.entries = {}; } setURL(url) { this.url = url; } getGlyphs(glyphs) { return __awaiter(this, void 0, void 0, function* () { const glyphsPromises = []; for (const stack in glyphs) { for (const id of glyphs[stack]) { glyphsPromises.push(this._getAndCacheGlyphsPromise(stack, id)); } } const updatedGlyphs = yield Promise.all(glyphsPromises); const result = {}; for (const { stack, id, glyph } of updatedGlyphs) { if (!result[stack]) { result[stack] = {}; } // Clone the glyph so that our own copy of its ArrayBuffer doesn't get transferred. result[stack][id] = glyph && { id: glyph.id, bitmap: glyph.bitmap.clone(), metrics: glyph.metrics }; } return result; }); } _getAndCacheGlyphsPromise(stack, id) { return __awaiter(this, void 0, void 0, function* () { let entry = this.entries[stack]; if (!entry) { entry = this.entries[stack] = { glyphs: {}, requests: {}, ranges: {} }; } let glyph = entry.glyphs[id]; if (glyph !== undefined) { return { stack, id, glyph }; } glyph = this._tinySDF(entry, stack, id); if (glyph) { entry.glyphs[id] = glyph; return { stack, id, glyph }; } const range = Math.floor(id / 256); if (range * 256 > 65535) { throw new Error('glyphs > 65535 not supported'); } if (entry.ranges[range]) { return { stack, id, glyph }; } if (!this.url) { throw new Error('glyphsUrl is not set'); } if (!entry.requests[range]) { const promise = GlyphManager.loadGlyphRange(stack, range, this.url, this.requestManager); entry.requests[range] = promise; } const response = yield entry.requests[range]; for (const id in response) { if (!this._doesCharSupportLocalGlyph(+id)) { entry.glyphs[+id] = response[+id]; } } entry.ranges[range] = true; return { stack, id, glyph: response[id] || null }; }); } _doesCharSupportLocalGlyph(id) { // The CJK Unified Ideographs blocks and Hangul Syllables blocks are // spread across many glyph PBFs and are typically accessed very // randomly. Preferring local rendering for these blocks reduces // wasteful bandwidth consumption. For visual consistency within CJKV // text, also include any other CJKV or siniform ideograph or hangul, // hiragana, or katakana character. return !!this.localIdeographFontFamily && /\p{Ideo}|\p{sc=Hang}|\p{sc=Hira}|\p{sc=Kana}/u.test(String.fromCodePoint(id)); } _tinySDF(entry, stack, id) { const fontFamily = this.localIdeographFontFamily; if (!fontFamily) { return; } if (!this._doesCharSupportLocalGlyph(id)) { return; } // Client-generated glyphs are rendered at 2x texture scale, // because CJK glyphs are more detailed than others. const textureScale = 2; let tinySDF = entry.tinySDF; if (!tinySDF) { let fontWeight = '400'; if (/bold/i.test(stack)) { fontWeight = '900'; } else if (/medium/i.test(stack)) { fontWeight = '500'; } else if (/light/i.test(stack)) { fontWeight = '200'; } tinySDF = entry.tinySDF = new GlyphManager.TinySDF({ fontSize: 24 * textureScale, buffer: 3 * textureScale, radius: 8 * textureScale, cutoff: 0.25, fontFamily, fontWeight }); } const char = tinySDF.draw(String.fromCharCode(id)); /** * TinySDF's "top" is the distance from the alphabetic baseline to the top of the glyph. * Server-generated fonts specify "top" relative to an origin above the em box (the origin * comes from FreeType, but I'm unclear on exactly how it's derived) * ref: https://github.com/mapbox/sdf-glyph-foundry * * Server fonts don't yet include baseline information, so we can't line up exactly with them * (and they don't line up with each other) * ref: https://github.com/mapbox/node-fontnik/pull/160 * * To approximately align TinySDF glyphs with server-provided glyphs, we use this baseline adjustment * factor calibrated to be in between DIN Pro and Arial Unicode (but closer to Arial Unicode) */ const topAdjustment = 27.5; const leftAdjustment = 0.5; return { id, bitmap: new AlphaImage({ width: char.width || 30 * textureScale, height: char.height || 30 * textureScale }, char.data), metrics: { width: char.glyphWidth / textureScale || 24, height: char.glyphHeight / textureScale || 24, left: (char.glyphLeft / textureScale + leftAdjustment) || 0, top: char.glyphTop / textureScale - topAdjustment || -8, advance: char.glyphAdvance / textureScale || 24, isDoubleResolution: true } }; } } // exposed as statics to enable stubbing in unit tests GlyphManager.loadGlyphRange = loadGlyphRange; GlyphManager.TinySDF = TinySDF; class LightPositionProperty { constructor() { this.specification = v8Spec.light.position; } possiblyEvaluate(value, parameters) { return sphericalToCartesian(value.expression.evaluate(parameters)); } interpolate(a, b, t) { return { x: interpolate.number(a.x, b.x, t), y: interpolate.number(a.y, b.y, t), z: interpolate.number(a.z, b.z, t), }; } } const TRANSITION_SUFFIX$1 = '-transition'; let lightProperties; /* * Represents the light used to light extruded features. */ class Light extends Evented { constructor(lightOptions) { super(); lightProperties = lightProperties || new Properties({ 'anchor': new DataConstantProperty(v8Spec.light.anchor), 'position': new LightPositionProperty(), 'color': new DataConstantProperty(v8Spec.light.color), 'intensity': new DataConstantProperty(v8Spec.light.intensity), }); this._transitionable = new Transitionable(lightProperties); this.setLight(lightOptions); this._transitioning = this._transitionable.untransitioned(); } getLight() { return this._transitionable.serialize(); } setLight(light, options = {}) { if (this._validate(validateLight, light, options)) { return; } for (const name in light) { const value = light[name]; if (name.endsWith(TRANSITION_SUFFIX$1)) { this._transitionable.setTransition(name.slice(0, -TRANSITION_SUFFIX$1.length), value); } else { this._transitionable.setValue(name, value); } } } updateTransitions(parameters) { this._transitioning = this._transitionable.transitioned(parameters, this._transitioning); } hasTransition() { return this._transitioning.hasTransition(); } recalculate(parameters) { this.properties = this._transitioning.possiblyEvaluate(parameters); } _validate(validate, value, options) { if (options && options.validate === false) { return false; } return emitValidationErrors$1(this, validate.call(validateStyle, { value, // Workaround for https://github.com/mapbox/mapbox-gl-js/issues/2407 style: { glyphs: true, sprite: true }, styleSpec: v8Spec })); } } const properties = new Properties({ 'sky-color': new DataConstantProperty(v8Spec.sky['sky-color']), 'horizon-color': new DataConstantProperty(v8Spec.sky['horizon-color']), 'fog-color': new DataConstantProperty(v8Spec.sky['fog-color']), 'fog-ground-blend': new DataConstantProperty(v8Spec.sky['fog-ground-blend']), 'horizon-fog-blend': new DataConstantProperty(v8Spec.sky['horizon-fog-blend']), 'sky-horizon-blend': new DataConstantProperty(v8Spec.sky['sky-horizon-blend']), 'atmosphere-blend': new DataConstantProperty(v8Spec.sky['atmosphere-blend']) }); const TRANSITION_SUFFIX = '-transition'; class Sky extends Evented { constructor(sky) { super(); this._transitionable = new Transitionable(properties); this.setSky(sky); this._transitioning = this._transitionable.untransitioned(); this.recalculate(new EvaluationParameters(0)); } setSky(sky, options = {}) { if (this._validate(validateSky, sky, options)) return; if (!sky) { sky = { 'sky-color': 'transparent', 'horizon-color': 'transparent', 'fog-color': 'transparent', 'fog-ground-blend': 1, 'atmosphere-blend': 0, }; } for (const name in sky) { const value = sky[name]; if (name.endsWith(TRANSITION_SUFFIX)) { this._transitionable.setTransition(name.slice(0, -TRANSITION_SUFFIX.length), value); } else { this._transitionable.setValue(name, value); } } } getSky() { return this._transitionable.serialize(); } updateTransitions(parameters) { this._transitioning = this._transitionable.transitioned(parameters, this._transitioning); } hasTransition() { return this._transitioning.hasTransition(); } recalculate(parameters) { this.properties = this._transitioning.possiblyEvaluate(parameters); } _validate(validate, value, options = {}) { if ((options === null || options === void 0 ? void 0 : options.validate) === false) { return false; } return emitValidationErrors$1(this, validate.call(validateStyle, extend({ value, // Workaround for https://github.com/mapbox/mapbox-gl-js/issues/2407 style: { glyphs: true, sprite: true }, styleSpec: v8Spec }))); } /** * Currently fog is a very simple implementation, and should only used * to create an atmosphere near the horizon. * But because the fog is drawn from the far-clipping-plane to * map-center, and because the fog does nothing know about the horizon, * this method does a fadeout in respect of pitch. So, when the horizon * gets out of view, which is at about pitch 70, this methods calculates * the corresponding opacity values. Below pitch 60 the fog is completely * invisible. */ calculateFogBlendOpacity(pitch) { if (pitch < 60) return 0; // disable if (pitch < 70) return (pitch - 60) / 10; // fade in return 1; } } /** * @internal * A LineAtlas lets us reuse rendered dashed lines * by writing many of them to a texture and then fetching their positions * using {@link LineAtlas#getDash}. * * @param width - the width * @param height - the height */ class LineAtlas { constructor(width, height) { this.width = width; this.height = height; this.nextRow = 0; this.data = new Uint8Array(this.width * this.height); this.dashEntry = {}; } /** * Get or create a dash line pattern. * * @param dasharray - the key (represented by numbers) to get the dash texture * @param round - whether to add circle caps in between dash segments * @returns position of dash texture in {@link DashEntry} */ getDash(dasharray, round) { const key = dasharray.join(',') + String(round); if (!this.dashEntry[key]) { this.dashEntry[key] = this.addDash(dasharray, round); } return this.dashEntry[key]; } getDashRanges(dasharray, lineAtlasWidth, stretch) { // If dasharray has an odd length, both the first and last parts // are dashes and should be joined seamlessly. const oddDashArray = dasharray.length % 2 === 1; const ranges = []; let left = oddDashArray ? -dasharray[dasharray.length - 1] * stretch : 0; let right = dasharray[0] * stretch; let isDash = true; ranges.push({ left, right, isDash, zeroLength: dasharray[0] === 0 }); let currentDashLength = dasharray[0]; for (let i = 1; i < dasharray.length; i++) { isDash = !isDash; const dashLength = dasharray[i]; left = currentDashLength * stretch; currentDashLength += dashLength; right = currentDashLength * stretch; ranges.push({ left, right, isDash, zeroLength: dashLength === 0 }); } return ranges; } addRoundDash(ranges, stretch, n) { const halfStretch = stretch / 2; for (let y = -n; y <= n; y++) { const row = this.nextRow + n + y; const index = this.width * row; let currIndex = 0; let range = ranges[currIndex]; for (let x = 0; x < this.width; x++) { if (x / range.right > 1) { range = ranges[++currIndex]; } const distLeft = Math.abs(x - range.left); const distRight = Math.abs(x - range.right); const minDist = Math.min(distLeft, distRight); let signedDistance; const distMiddle = y / n * (halfStretch + 1); if (range.isDash) { const distEdge = halfStretch - Math.abs(distMiddle); signedDistance = Math.sqrt(minDist * minDist + distEdge * distEdge); } else { signedDistance = halfStretch - Math.sqrt(minDist * minDist + distMiddle * distMiddle); } this.data[index + x] = Math.max(0, Math.min(255, signedDistance + 128)); } } } addRegularDash(ranges) { // Collapse any zero-length range // Collapse neighbouring same-type parts into a single part for (let i = ranges.length - 1; i >= 0; --i) { const part = ranges[i]; const next = ranges[i + 1]; if (part.zeroLength) { ranges.splice(i, 1); } else if (next && next.isDash === part.isDash) { next.left = part.left; ranges.splice(i, 1); } } // Combine the first and last parts if possible const first = ranges[0]; const last = ranges[ranges.length - 1]; if (first.isDash === last.isDash) { first.left = last.left - this.width; last.right = first.right + this.width; } const index = this.width * this.nextRow; let currIndex = 0; let range = ranges[currIndex]; for (let x = 0; x < this.width; x++) { if (x / range.right > 1) { range = ranges[++currIndex]; } const distLeft = Math.abs(x - range.left); const distRight = Math.abs(x - range.right); const minDist = Math.min(distLeft, distRight); const signedDistance = range.isDash ? minDist : -minDist; this.data[index + x] = Math.max(0, Math.min(255, signedDistance + 128)); } } addDash(dasharray, round) { const n = round ? 7 : 0; const height = 2 * n + 1; if (this.nextRow + height > this.height) { warnOnce('LineAtlas out of space'); return null; } let length = 0; for (let i = 0; i < dasharray.length; i++) { length += dasharray[i]; } if (length !== 0) { const stretch = this.width / length; const ranges = this.getDashRanges(dasharray, this.width, stretch); if (round) { this.addRoundDash(ranges, stretch, n); } else { this.addRegularDash(ranges); } } const dashEntry = { y: (this.nextRow + n + 0.5) / this.height, height: 2 * n / this.height, width: length }; this.nextRow += height; this.dirty = true; return dashEntry; } bind(context) { const gl = context.gl; if (!this.texture) { this.texture = gl.createTexture(); gl.bindTexture(gl.TEXTURE_2D, this.texture); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.REPEAT); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.REPEAT); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR); gl.texImage2D(gl.TEXTURE_2D, 0, gl.ALPHA, this.width, this.height, 0, gl.ALPHA, gl.UNSIGNED_BYTE, this.data); } else { gl.bindTexture(gl.TEXTURE_2D, this.texture); if (this.dirty) { this.dirty = false; gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, this.width, this.height, gl.ALPHA, gl.UNSIGNED_BYTE, this.data); } } } } /** * Invokes the wrapped function in a non-blocking way when trigger() is called. * Invocation requests are ignored until the function was actually invoked. */ class ThrottledInvoker { constructor(methodToThrottle) { this._methodToThrottle = methodToThrottle; this._triggered = false; if (typeof MessageChannel !== 'undefined') { this._channel = new MessageChannel(); this._channel.port2.onmessage = () => { this._triggered = false; this._methodToThrottle(); }; } } trigger() { if (this._triggered) { return; } this._triggered = true; if (this._channel) { this._channel.port1.postMessage(true); } else { setTimeout(() => { this._triggered = false; this._methodToThrottle(); }, 0); } } remove() { delete this._channel; this._methodToThrottle = () => { }; } } /** * An implementation of the [Actor design pattern](https://en.wikipedia.org/wiki/Actor_model) * that maintains the relationship between asynchronous tasks and the objects * that spin them off - in this case, tasks like parsing parts of styles, * owned by the styles */ class Actor { /** * @param target - The target * @param mapId - A unique identifier for the Map instance using this Actor. */ constructor(target, mapId) { this.target = target; this.mapId = mapId; this.resolveRejects = {}; this.tasks = {}; this.taskQueue = []; this.abortControllers = {}; this.messageHandlers = {}; this.invoker = new ThrottledInvoker(() => this.process()); this.subscription = subscribe(this.target, 'message', (message) => this.receive(message), false); this.globalScope = isWorker(self) ? target : window; } registerMessageHandler(type, handler) { this.messageHandlers[type] = handler; } /** * Sends a message from a main-thread map to a Worker or from a Worker back to * a main-thread map instance. * @param message - the message to send * @param abortController - an optional AbortController to abort the request * @returns a promise that will be resolved with the response data */ sendAsync(message, abortController) { return new Promise((resolve, reject) => { // We're using a string ID instead of numbers because they are being used as object keys // anyway, and thus stringified implicitly. We use random IDs because an actor may receive // message from multiple other actors which could run in different execution context. A // linearly increasing ID could produce collisions. const id = Math.round((Math.random() * 1e18)).toString(36).substring(0, 10); this.resolveRejects[id] = { resolve, reject }; if (abortController) { abortController.signal.addEventListener('abort', () => { delete this.resolveRejects[id]; const cancelMessage = { id, type: '', origin: location.origin, targetMapId: message.targetMapId, sourceMapId: this.mapId }; this.target.postMessage(cancelMessage); // In case of abort the current behavior is to keep the promise pending. }, { once: true }); } const buffers = []; const messageToPost = Object.assign(Object.assign({}, message), { id, sourceMapId: this.mapId, origin: location.origin, data: serialize(message.data, buffers) }); this.target.postMessage(messageToPost, { transfer: buffers }); }); } receive(message) { const data = message.data; const id = data.id; if (data.origin !== 'file://' && location.origin !== 'file://' && data.origin !== 'resource://android' && location.origin !== 'resource://android' && data.origin !== location.origin) { return; } if (data.targetMapId && this.mapId !== data.targetMapId) { return; } if (data.type === '') { // Remove the original request from the queue. This is only possible if it // hasn't been kicked off yet. The id will remain in the queue, but because // there is no associated task, it will be dropped once it's time to execute it. delete this.tasks[id]; const abortController = this.abortControllers[id]; delete this.abortControllers[id]; if (abortController) { abortController.abort(); } return; } if (isWorker(self) || data.mustQueue) { // In workers, store the tasks that we need to process before actually processing them. This // is necessary because we want to keep receiving messages, and in particular, // messages. Some tasks may take a while in the worker thread, so before // executing the next task in our queue, postMessage preempts this and // messages can be processed. We're using a MessageChannel object to get throttle the // process() flow to one at a time. this.tasks[id] = data; this.taskQueue.push(id); this.invoker.trigger(); return; } // In the main thread, process messages immediately so that other work does not slip in // between getting partial data back from workers. this.processTask(id, data); } process() { if (this.taskQueue.length === 0) { return; } const id = this.taskQueue.shift(); const task = this.tasks[id]; delete this.tasks[id]; // Schedule another process call if we know there's more to process _before_ invoking the // current task. This is necessary so that processing continues even if the current task // doesn't execute successfully. if (this.taskQueue.length > 0) { this.invoker.trigger(); } if (!task) { // If the task ID doesn't have associated task data anymore, it was canceled. return; } this.processTask(id, task); } processTask(id, task) { return __awaiter(this, void 0, void 0, function* () { if (task.type === '') { // The `completeTask` function in the counterpart actor has been called, and we are now // resolving or rejecting the promise in the originating actor, if there is one. const resolveReject = this.resolveRejects[id]; delete this.resolveRejects[id]; if (!resolveReject) { // If we get a response, but don't have a resolve or reject, the request was canceled. return; } if (task.error) { resolveReject.reject(deserialize$1(task.error)); } else { resolveReject.resolve(deserialize$1(task.data)); } return; } if (!this.messageHandlers[task.type]) { this.completeTask(id, new Error(`Could not find a registered handler for ${task.type}, map ID: ${this.mapId}, available handlers: ${Object.keys(this.messageHandlers).join(', ')}`)); return; } const params = deserialize$1(task.data); const abortController = new AbortController(); this.abortControllers[id] = abortController; try { const data = yield this.messageHandlers[task.type](task.sourceMapId, params, abortController); this.completeTask(id, null, data); } catch (err) { this.completeTask(id, err); } }); } completeTask(id, err, data) { const buffers = []; delete this.abortControllers[id]; const responseMessage = { id, type: '', sourceMapId: this.mapId, origin: location.origin, error: err ? serialize(err) : null, data: serialize(data, buffers) }; this.target.postMessage(responseMessage, { transfer: buffers }); } remove() { this.invoker.remove(); this.subscription.unsubscribe(); } } function workerFactory() { return new Worker(config.WORKER_URL); } const PRELOAD_POOL_ID = 'maplibre_preloaded_worker_pool'; /** * Constructs a worker pool. */ class WorkerPool { constructor() { this.active = {}; } acquire(mapId) { if (!this.workers) { // Lazily look up the value of getWorkerCount so that // client code has had a chance to set it. this.workers = []; while (this.workers.length < WorkerPool.workerCount) { this.workers.push(workerFactory()); } } this.active[mapId] = true; return this.workers.slice(); } release(mapId) { delete this.active[mapId]; if (this.numActive() === 0) { this.workers.forEach((w) => { w.terminate(); }); this.workers = null; } } isPreloaded() { return !!this.active[PRELOAD_POOL_ID]; } numActive() { return Object.keys(this.active).length; } } // Based on results from A/B testing: https://github.com/maplibre/maplibre-gl-js/pull/2354 const availableLogicalProcessors = Math.floor(browser.hardwareConcurrency / 2); WorkerPool.workerCount = isSafari(globalThis) ? Math.max(Math.min(availableLogicalProcessors, 3), 1) : 1; let globalWorkerPool; /** * Creates (if necessary) and returns the single, global WorkerPool instance * to be shared across each Map */ function getGlobalWorkerPool() { if (!globalWorkerPool) { globalWorkerPool = new WorkerPool(); } return globalWorkerPool; } /** * Initializes resources like WebWorkers that can be shared across maps to lower load * times in some situations. `setWorkerUrl()` and `setWorkerCount()`, if being * used, must be set before `prewarm()` is called to have an effect. * * By default, the lifecycle of these resources is managed automatically, and they are * lazily initialized when a Map is first created. By invoking `prewarm()`, these * resources will be created ahead of time, and will not be cleared when the last Map * is removed from the page. This allows them to be re-used by new Map instances that * are created later. They can be manually cleared by calling * `clearPrewarmedResources()`. This is only necessary if your web page remains * active but stops using maps altogether. * * This is primarily useful when using GL-JS maps in a single page app, wherein a user * would navigate between various views that can cause Map instances to constantly be * created and destroyed. * * @example * ```ts * prewarm() * ``` */ function prewarm() { const workerPool = getGlobalWorkerPool(); workerPool.acquire(PRELOAD_POOL_ID); } /** * Clears up resources that have previously been created by `prewarm()`. * Note that this is typically not necessary. You should only call this function * if you expect the user of your app to not return to a Map view at any point * in your application. * * @example * ```ts * clearPrewarmedResources() * ``` */ function clearPrewarmedResources() { const pool = globalWorkerPool; if (pool) { // Remove the pool only if all maps that referenced the preloaded global worker pool have been removed. if (pool.isPreloaded() && pool.numActive() === 1) { pool.release(PRELOAD_POOL_ID); globalWorkerPool = null; } else { console.warn('Could not clear WebWorkers since there are active Map instances that still reference it. The pre-warmed WebWorker pool can only be cleared when all map instances have been removed with map.remove()'); } } } /** * Responsible for sending messages from a {@link Source} to an associated * {@link WorkerSource}. */ class Dispatcher { constructor(workerPool, mapId) { this.workerPool = workerPool; this.actors = []; this.currentActor = 0; this.id = mapId; const workers = this.workerPool.acquire(mapId); for (let i = 0; i < workers.length; i++) { const worker = workers[i]; const actor = new Actor(worker, mapId); actor.name = `Worker ${i}`; this.actors.push(actor); } if (!this.actors.length) throw new Error('No actors found'); } /** * Broadcast a message to all Workers. */ broadcast(type, data) { const promises = []; for (const actor of this.actors) { promises.push(actor.sendAsync({ type, data })); } return Promise.all(promises); } /** * Acquires an actor to dispatch messages to. The actors are distributed in round-robin fashion. * @returns An actor object backed by a web worker for processing messages. */ getActor() { this.currentActor = (this.currentActor + 1) % this.actors.length; return this.actors[this.currentActor]; } remove(mapRemoved = true) { this.actors.forEach((actor) => { actor.remove(); }); this.actors = []; if (mapRemoved) this.workerPool.release(this.id); } registerMessageHandler(type, handler) { for (const actor of this.actors) { actor.registerMessageHandler(type, handler); } } } let globalDispatcher; function getGlobalDispatcher() { if (!globalDispatcher) { globalDispatcher = new Dispatcher(getGlobalWorkerPool(), GLOBAL_DISPATCHER_ID); globalDispatcher.registerMessageHandler("GR" /* MessageType.getResource */, (_mapId, params, abortController) => { return makeRequest(params, abortController); }); } return globalDispatcher; } /* * Returns a matrix that can be used to convert from tile coordinates to viewport pixel coordinates. */ function getPixelPosMatrix(transform, tileID) { const t = create$6(); translate$1(t, t, [1, 1, 0]); scale$5(t, t, [transform.width * 0.5, transform.height * 0.5, 1]); return multiply$5(t, t, transform.calculatePosMatrix(tileID.toUnwrapped())); } function queryIncludes3DLayer(layers, styleLayers, sourceID) { if (layers) { for (const layerID of layers) { const layer = styleLayers[layerID]; if (layer && layer.source === sourceID && layer.type === 'fill-extrusion') { return true; } } } else { for (const key in styleLayers) { const layer = styleLayers[key]; if (layer.source === sourceID && layer.type === 'fill-extrusion') { return true; } } } return false; } function queryRenderedFeatures(sourceCache, styleLayers, serializedLayers, queryGeometry, params, transform) { const has3DLayer = queryIncludes3DLayer(params && params.layers, styleLayers, sourceCache.id); const maxPitchScaleFactor = transform.maxPitchScaleFactor(); const tilesIn = sourceCache.tilesIn(queryGeometry, maxPitchScaleFactor, has3DLayer); tilesIn.sort(sortTilesIn); const renderedFeatureLayers = []; for (const tileIn of tilesIn) { renderedFeatureLayers.push({ wrappedTileID: tileIn.tileID.wrapped().key, queryResults: tileIn.tile.queryRenderedFeatures(styleLayers, serializedLayers, sourceCache._state, tileIn.queryGeometry, tileIn.cameraQueryGeometry, tileIn.scale, params, transform, maxPitchScaleFactor, getPixelPosMatrix(sourceCache.transform, tileIn.tileID)) }); } const result = mergeRenderedFeatureLayers(renderedFeatureLayers); // Merge state from SourceCache into the results for (const layerID in result) { result[layerID].forEach((featureWrapper) => { const feature = featureWrapper.feature; const state = sourceCache.getFeatureState(feature.layer['source-layer'], feature.id); feature.source = feature.layer.source; if (feature.layer['source-layer']) { feature.sourceLayer = feature.layer['source-layer']; } feature.state = state; }); } return result; } function queryRenderedSymbols(styleLayers, serializedLayers, sourceCaches, queryGeometry, params, collisionIndex, retainedQueryData) { const result = {}; const renderedSymbols = collisionIndex.queryRenderedSymbols(queryGeometry); const bucketQueryData = []; for (const bucketInstanceId of Object.keys(renderedSymbols).map(Number)) { bucketQueryData.push(retainedQueryData[bucketInstanceId]); } bucketQueryData.sort(sortTilesIn); for (const queryData of bucketQueryData) { const bucketSymbols = queryData.featureIndex.lookupSymbolFeatures(renderedSymbols[queryData.bucketInstanceId], serializedLayers, queryData.bucketIndex, queryData.sourceLayerIndex, params.filter, params.layers, params.availableImages, styleLayers); for (const layerID in bucketSymbols) { const resultFeatures = result[layerID] = result[layerID] || []; const layerSymbols = bucketSymbols[layerID]; layerSymbols.sort((a, b) => { // Match topDownFeatureComparator from FeatureIndex, but using // most recent sorting of features from bucket.sortFeatures const featureSortOrder = queryData.featureSortOrder; if (featureSortOrder) { // queryRenderedSymbols documentation says we'll return features in // "top-to-bottom" rendering order (aka last-to-first). // Actually there can be multiple symbol instances per feature, so // we sort each feature based on the first matching symbol instance. const sortedA = featureSortOrder.indexOf(a.featureIndex); const sortedB = featureSortOrder.indexOf(b.featureIndex); return sortedB - sortedA; } else { // Bucket hasn't been re-sorted based on angle, so use the // reverse of the order the features appeared in the data. return b.featureIndex - a.featureIndex; } }); for (const symbolFeature of layerSymbols) { resultFeatures.push(symbolFeature); } } } // Merge state from SourceCache into the results for (const layerName in result) { result[layerName].forEach((featureWrapper) => { const feature = featureWrapper.feature; const layer = styleLayers[layerName]; const sourceCache = sourceCaches[layer.source]; const state = sourceCache.getFeatureState(feature.layer['source-layer'], feature.id); feature.source = feature.layer.source; if (feature.layer['source-layer']) { feature.sourceLayer = feature.layer['source-layer']; } feature.state = state; }); } return result; } function querySourceFeatures(sourceCache, params) { const tiles = sourceCache.getRenderableIds().map((id) => { return sourceCache.getTileByID(id); }); const result = []; const dataTiles = {}; for (let i = 0; i < tiles.length; i++) { const tile = tiles[i]; const dataID = tile.tileID.canonical.key; if (!dataTiles[dataID]) { dataTiles[dataID] = true; tile.querySourceFeatures(result, params); } } return result; } function sortTilesIn(a, b) { const idA = a.tileID; const idB = b.tileID; return (idA.overscaledZ - idB.overscaledZ) || (idA.canonical.y - idB.canonical.y) || (idA.wrap - idB.wrap) || (idA.canonical.x - idB.canonical.x); } function mergeRenderedFeatureLayers(tiles) { // Merge results from all tiles, but if two tiles share the same // wrapped ID, don't duplicate features between the two tiles const result = {}; const wrappedIDLayerMap = {}; for (const tile of tiles) { const queryResults = tile.queryResults; const wrappedID = tile.wrappedTileID; const wrappedIDLayers = wrappedIDLayerMap[wrappedID] = wrappedIDLayerMap[wrappedID] || {}; for (const layerID in queryResults) { const tileFeatures = queryResults[layerID]; const wrappedIDFeatures = wrappedIDLayers[layerID] = wrappedIDLayers[layerID] || {}; const resultFeatures = result[layerID] = result[layerID] || []; for (const tileFeature of tileFeatures) { if (!wrappedIDFeatures[tileFeature.featureIndex]) { wrappedIDFeatures[tileFeature.featureIndex] = true; resultFeatures.push(tileFeature); } } } } return result; } function loadTileJson(options, requestManager, abortController) { return __awaiter(this, void 0, void 0, function* () { let tileJSON = options; if (options.url) { const response = yield getJSON(requestManager.transformRequest(options.url, "Source" /* ResourceType.Source */), abortController); tileJSON = response.data; } else { yield browser.frameAsync(abortController); } if (!tileJSON) { return null; } const result = pick( // explicit source options take precedence over TileJSON extend(tileJSON, options), ['tiles', 'minzoom', 'maxzoom', 'attribution', 'bounds', 'scheme', 'tileSize', 'encoding']); if ('vector_layers' in tileJSON && tileJSON.vector_layers) { result.vectorLayerIds = tileJSON.vector_layers.map((layer) => { return layer.id; }); } return result; }); } /* * Approximate radius of the earth in meters. * Uses the WGS-84 approximation. The radius at the equator is ~6378137 and at the poles is ~6356752. https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84 * 6371008.8 is one published "average radius" see https://en.wikipedia.org/wiki/Earth_radius#Mean_radius, or ftp://athena.fsv.cvut.cz/ZFG/grs80-Moritz.pdf p.4 */ const earthRadius = 6371008.8; /** * A `LngLat` object represents a given longitude and latitude coordinate, measured in degrees. * These coordinates are based on the [WGS84 (EPSG:4326) standard](https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84). * * MapLibre GL JS uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match the * [GeoJSON specification](https://tools.ietf.org/html/rfc7946). * * Note that any MapLibre GL JS method that accepts a `LngLat` object as an argument or option * can also accept an `Array` of two numbers and will perform an implicit conversion. * This flexible type is documented as {@link LngLatLike}. * * @group Geography and Geometry * * @example * ```ts * let ll = new LngLat(-123.9749, 40.7736); * ll.lng; // = -123.9749 * ``` * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js/docs/examples/mouse-position/) * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/) * @see [Create a timeline animation](https://maplibre.org/maplibre-gl-js/docs/examples/timeline-animation/) */ class LngLat { /** * @param lng - Longitude, measured in degrees. * @param lat - Latitude, measured in degrees. */ constructor(lng, lat) { if (isNaN(lng) || isNaN(lat)) { throw new Error(`Invalid LngLat object: (${lng}, ${lat})`); } this.lng = +lng; this.lat = +lat; if (this.lat > 90 || this.lat < -90) { throw new Error('Invalid LngLat latitude value: must be between -90 and 90'); } } /** * Returns a new `LngLat` object whose longitude is wrapped to the range (-180, 180). * * @returns The wrapped `LngLat` object. * @example * ```ts * let ll = new LngLat(286.0251, 40.7736); * let wrapped = ll.wrap(); * wrapped.lng; // = -73.9749 * ``` */ wrap() { return new LngLat(wrap(this.lng, -180, 180), this.lat); } /** * Returns the coordinates represented as an array of two numbers. * * @returns The coordinates represented as an array of longitude and latitude. * @example * ```ts * let ll = new LngLat(-73.9749, 40.7736); * ll.toArray(); // = [-73.9749, 40.7736] * ``` */ toArray() { return [this.lng, this.lat]; } /** * Returns the coordinates represent as a string. * * @returns The coordinates represented as a string of the format `'LngLat(lng, lat)'`. * @example * ```ts * let ll = new LngLat(-73.9749, 40.7736); * ll.toString(); // = "LngLat(-73.9749, 40.7736)" * ``` */ toString() { return `LngLat(${this.lng}, ${this.lat})`; } /** * Returns the approximate distance between a pair of coordinates in meters * Uses the Haversine Formula (from R.W. Sinnott, "Virtues of the Haversine", Sky and Telescope, vol. 68, no. 2, 1984, p. 159) * * @param lngLat - coordinates to compute the distance to * @returns Distance in meters between the two coordinates. * @example * ```ts * let new_york = new LngLat(-74.0060, 40.7128); * let los_angeles = new LngLat(-118.2437, 34.0522); * new_york.distanceTo(los_angeles); // = 3935751.690893987, "true distance" using a non-spherical approximation is ~3966km * ``` */ distanceTo(lngLat) { const rad = Math.PI / 180; const lat1 = this.lat * rad; const lat2 = lngLat.lat * rad; const a = Math.sin(lat1) * Math.sin(lat2) + Math.cos(lat1) * Math.cos(lat2) * Math.cos((lngLat.lng - this.lng) * rad); const maxMeters = earthRadius * Math.acos(Math.min(a, 1)); return maxMeters; } /** * Converts an array of two numbers or an object with `lng` and `lat` or `lon` and `lat` properties * to a `LngLat` object. * * If a `LngLat` object is passed in, the function returns it unchanged. * * @param input - An array of two numbers or object to convert, or a `LngLat` object to return. * @returns A new `LngLat` object, if a conversion occurred, or the original `LngLat` object. * @example * ```ts * let arr = [-73.9749, 40.7736]; * let ll = LngLat.convert(arr); * ll; // = LngLat {lng: -73.9749, lat: 40.7736} * ``` */ static convert(input) { if (input instanceof LngLat) { return input; } if (Array.isArray(input) && (input.length === 2 || input.length === 3)) { return new LngLat(Number(input[0]), Number(input[1])); } if (!Array.isArray(input) && typeof input === 'object' && input !== null) { return new LngLat( // flow can't refine this to have one of lng or lat, so we have to cast to any Number('lng' in input ? input.lng : input.lon), Number(input.lat)); } throw new Error('`LngLatLike` argument must be specified as a LngLat instance, an object {lng: , lat: }, an object {lon: , lat: }, or an array of [, ]'); } } /** * A `LngLatBounds` object represents a geographical bounding box, * defined by its southwest and northeast points in longitude and latitude. * * If no arguments are provided to the constructor, a `null` bounding box is created. * * Note that any Mapbox GL method that accepts a `LngLatBounds` object as an argument or option * can also accept an `Array` of two {@link LngLatLike} constructs and will perform an implicit conversion. * This flexible type is documented as {@link LngLatBoundsLike}. * * @group Geography and Geometry * * @example * ```ts * let sw = new LngLat(-73.9876, 40.7661); * let ne = new LngLat(-73.9397, 40.8002); * let llb = new LngLatBounds(sw, ne); * ``` */ class LngLatBounds { /** * @param sw - The southwest corner of the bounding box. * OR array of 4 numbers in the order of west, south, east, north * OR array of 2 LngLatLike: [sw,ne] * @param ne - The northeast corner of the bounding box. * @example * ```ts * let sw = new LngLat(-73.9876, 40.7661); * let ne = new LngLat(-73.9397, 40.8002); * let llb = new LngLatBounds(sw, ne); * ``` * OR * ```ts * let llb = new LngLatBounds([-73.9876, 40.7661, -73.9397, 40.8002]); * ``` * OR * ```ts * let llb = new LngLatBounds([sw, ne]); * ``` */ constructor(sw, ne) { if (!sw) { // noop } else if (ne) { this.setSouthWest(sw).setNorthEast(ne); } else if (Array.isArray(sw)) { if (sw.length === 4) { // 4 element array: west, south, east, north this.setSouthWest([sw[0], sw[1]]).setNorthEast([sw[2], sw[3]]); } else { this.setSouthWest(sw[0]).setNorthEast(sw[1]); } } } /** * Set the northeast corner of the bounding box * * @param ne - a {@link LngLatLike} object describing the northeast corner of the bounding box. */ setNorthEast(ne) { this._ne = ne instanceof LngLat ? new LngLat(ne.lng, ne.lat) : LngLat.convert(ne); return this; } /** * Set the southwest corner of the bounding box * * @param sw - a {@link LngLatLike} object describing the southwest corner of the bounding box. */ setSouthWest(sw) { this._sw = sw instanceof LngLat ? new LngLat(sw.lng, sw.lat) : LngLat.convert(sw); return this; } /** * Extend the bounds to include a given LngLatLike or LngLatBoundsLike. * * @param obj - object to extend to */ extend(obj) { const sw = this._sw, ne = this._ne; let sw2, ne2; if (obj instanceof LngLat) { sw2 = obj; ne2 = obj; } else if (obj instanceof LngLatBounds) { sw2 = obj._sw; ne2 = obj._ne; if (!sw2 || !ne2) return this; } else { if (Array.isArray(obj)) { if (obj.length === 4 || obj.every(Array.isArray)) { const lngLatBoundsObj = obj; return this.extend(LngLatBounds.convert(lngLatBoundsObj)); } else { const lngLatObj = obj; return this.extend(LngLat.convert(lngLatObj)); } } else if (obj && ('lng' in obj || 'lon' in obj) && 'lat' in obj) { return this.extend(LngLat.convert(obj)); } return this; } if (!sw && !ne) { this._sw = new LngLat(sw2.lng, sw2.lat); this._ne = new LngLat(ne2.lng, ne2.lat); } else { sw.lng = Math.min(sw2.lng, sw.lng); sw.lat = Math.min(sw2.lat, sw.lat); ne.lng = Math.max(ne2.lng, ne.lng); ne.lat = Math.max(ne2.lat, ne.lat); } return this; } /** * Returns the geographical coordinate equidistant from the bounding box's corners. * * @returns The bounding box's center. * @example * ```ts * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]); * llb.getCenter(); // = LngLat {lng: -73.96365, lat: 40.78315} * ``` */ getCenter() { return new LngLat((this._sw.lng + this._ne.lng) / 2, (this._sw.lat + this._ne.lat) / 2); } /** * Returns the southwest corner of the bounding box. * * @returns The southwest corner of the bounding box. */ getSouthWest() { return this._sw; } /** * Returns the northeast corner of the bounding box. * * @returns The northeast corner of the bounding box. */ getNorthEast() { return this._ne; } /** * Returns the northwest corner of the bounding box. * * @returns The northwest corner of the bounding box. */ getNorthWest() { return new LngLat(this.getWest(), this.getNorth()); } /** * Returns the southeast corner of the bounding box. * * @returns The southeast corner of the bounding box. */ getSouthEast() { return new LngLat(this.getEast(), this.getSouth()); } /** * Returns the west edge of the bounding box. * * @returns The west edge of the bounding box. */ getWest() { return this._sw.lng; } /** * Returns the south edge of the bounding box. * * @returns The south edge of the bounding box. */ getSouth() { return this._sw.lat; } /** * Returns the east edge of the bounding box. * * @returns The east edge of the bounding box. */ getEast() { return this._ne.lng; } /** * Returns the north edge of the bounding box. * * @returns The north edge of the bounding box. */ getNorth() { return this._ne.lat; } /** * Returns the bounding box represented as an array. * * @returns The bounding box represented as an array, consisting of the * southwest and northeast coordinates of the bounding represented as arrays of numbers. * @example * ```ts * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]); * llb.toArray(); // = [[-73.9876, 40.7661], [-73.9397, 40.8002]] * ``` */ toArray() { return [this._sw.toArray(), this._ne.toArray()]; } /** * Return the bounding box represented as a string. * * @returns The bounding box represents as a string of the format * `'LngLatBounds(LngLat(lng, lat), LngLat(lng, lat))'`. * @example * ```ts * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]); * llb.toString(); // = "LngLatBounds(LngLat(-73.9876, 40.7661), LngLat(-73.9397, 40.8002))" * ``` */ toString() { return `LngLatBounds(${this._sw.toString()}, ${this._ne.toString()})`; } /** * Check if the bounding box is an empty/`null`-type box. * * @returns True if bounds have been defined, otherwise false. */ isEmpty() { return !(this._sw && this._ne); } /** * Check if the point is within the bounding box. * * @param lnglat - geographic point to check against. * @returns `true` if the point is within the bounding box. * @example * ```ts * let llb = new LngLatBounds( * new LngLat(-73.9876, 40.7661), * new LngLat(-73.9397, 40.8002) * ); * * let ll = new LngLat(-73.9567, 40.7789); * * console.log(llb.contains(ll)); // = true * ``` */ contains(lnglat) { const { lng, lat } = LngLat.convert(lnglat); const containsLatitude = this._sw.lat <= lat && lat <= this._ne.lat; let containsLongitude = this._sw.lng <= lng && lng <= this._ne.lng; if (this._sw.lng > this._ne.lng) { // wrapped coordinates containsLongitude = this._sw.lng >= lng && lng >= this._ne.lng; } return containsLatitude && containsLongitude; } /** * Converts an array to a `LngLatBounds` object. * * If a `LngLatBounds` object is passed in, the function returns it unchanged. * * Internally, the function calls `LngLat#convert` to convert arrays to `LngLat` values. * * @param input - An array of two coordinates to convert, or a `LngLatBounds` object to return. * @returns A new `LngLatBounds` object, if a conversion occurred, or the original `LngLatBounds` object. * @example * ```ts * let arr = [[-73.9876, 40.7661], [-73.9397, 40.8002]]; * let llb = LngLatBounds.convert(arr); // = LngLatBounds {_sw: LngLat {lng: -73.9876, lat: 40.7661}, _ne: LngLat {lng: -73.9397, lat: 40.8002}} * ``` */ static convert(input) { if (input instanceof LngLatBounds) return input; if (!input) return input; return new LngLatBounds(input); } /** * Returns a `LngLatBounds` from the coordinates extended by a given `radius`. The returned `LngLatBounds` completely contains the `radius`. * * @param center - center coordinates of the new bounds. * @param radius - Distance in meters from the coordinates to extend the bounds. * @returns A new `LngLatBounds` object representing the coordinates extended by the `radius`. * @example * ```ts * let center = new LngLat(-73.9749, 40.7736); * LngLatBounds.fromLngLat(100).toArray(); // = [[-73.97501862141328, 40.77351016847229], [-73.97478137858673, 40.77368983152771]] * ``` */ static fromLngLat(center, radius = 0) { const earthCircumferenceInMetersAtEquator = 40075017; const latAccuracy = 360 * radius / earthCircumferenceInMetersAtEquator, lngAccuracy = latAccuracy / Math.cos((Math.PI / 180) * center.lat); return new LngLatBounds(new LngLat(center.lng - lngAccuracy, center.lat - latAccuracy), new LngLat(center.lng + lngAccuracy, center.lat + latAccuracy)); } /** * Adjusts the given bounds to handle the case where the bounds cross the 180th meridian (antimeridian). * * @returns The adjusted LngLatBounds * @example * ```ts * let bounds = new LngLatBounds([175.813127, -20.157768], [-178. 340903, -15.449124]); * let adjustedBounds = bounds.adjustAntiMeridian(); * // adjustedBounds will be: [[175.813127, -20.157768], [181.659097, -15.449124]] * ``` */ adjustAntiMeridian() { const sw = new LngLat(this._sw.lng, this._sw.lat); const ne = new LngLat(this._ne.lng, this._ne.lat); if (sw.lng > ne.lng) { return new LngLatBounds(sw, new LngLat(ne.lng + 360, ne.lat)); } return new LngLatBounds(sw, ne); } } /* * The average circumference of the world in meters. */ const earthCircumference = 2 * Math.PI * earthRadius; // meters /* * The circumference at a line of latitude in meters. */ function circumferenceAtLatitude(latitude) { return earthCircumference * Math.cos(latitude * Math.PI / 180); } function mercatorXfromLng(lng) { return (180 + lng) / 360; } function mercatorYfromLat(lat) { return (180 - (180 / Math.PI * Math.log(Math.tan(Math.PI / 4 + lat * Math.PI / 360)))) / 360; } function mercatorZfromAltitude(altitude, lat) { return altitude / circumferenceAtLatitude(lat); } function lngFromMercatorX(x) { return x * 360 - 180; } function latFromMercatorY(y) { const y2 = 180 - y * 360; return 360 / Math.PI * Math.atan(Math.exp(y2 * Math.PI / 180)) - 90; } function altitudeFromMercatorZ(z, y) { return z * circumferenceAtLatitude(latFromMercatorY(y)); } /** * Determine the Mercator scale factor for a given latitude, see * https://en.wikipedia.org/wiki/Mercator_projection#Scale_factor * * At the equator the scale factor will be 1, which increases at higher latitudes. * * @param lat - Latitude * @returns scale factor */ function mercatorScale(lat) { return 1 / Math.cos(lat * Math.PI / 180); } /** * A `MercatorCoordinate` object represents a projected three dimensional position. * * `MercatorCoordinate` uses the web mercator projection ([EPSG:3857](https://epsg.io/3857)) with slightly different units: * * - the size of 1 unit is the width of the projected world instead of the "mercator meter" * - the origin of the coordinate space is at the north-west corner instead of the middle * * For example, `MercatorCoordinate(0, 0, 0)` is the north-west corner of the mercator world and * `MercatorCoordinate(1, 1, 0)` is the south-east corner. If you are familiar with * [vector tiles](https://github.com/mapbox/vector-tile-spec) it may be helpful to think * of the coordinate space as the `0/0/0` tile with an extent of `1`. * * The `z` dimension of `MercatorCoordinate` is conformal. A cube in the mercator coordinate space would be rendered as a cube. * * @group Geography and Geometry * * @example * ```ts * let nullIsland = new MercatorCoordinate(0.5, 0.5, 0); * ``` * @see [Add a custom style layer](https://maplibre.org/maplibre-gl-js/docs/examples/custom-style-layer/) */ class MercatorCoordinate { /** * @param x - The x component of the position. * @param y - The y component of the position. * @param z - The z component of the position. */ constructor(x, y, z = 0) { this.x = +x; this.y = +y; this.z = +z; } /** * Project a `LngLat` to a `MercatorCoordinate`. * * @param lngLatLike - The location to project. * @param altitude - The altitude in meters of the position. * @returns The projected mercator coordinate. * @example * ```ts * let coord = MercatorCoordinate.fromLngLat({ lng: 0, lat: 0}, 0); * coord; // MercatorCoordinate(0.5, 0.5, 0) * ``` */ static fromLngLat(lngLatLike, altitude = 0) { const lngLat = LngLat.convert(lngLatLike); return new MercatorCoordinate(mercatorXfromLng(lngLat.lng), mercatorYfromLat(lngLat.lat), mercatorZfromAltitude(altitude, lngLat.lat)); } /** * Returns the `LngLat` for the coordinate. * * @returns The `LngLat` object. * @example * ```ts * let coord = new MercatorCoordinate(0.5, 0.5, 0); * let lngLat = coord.toLngLat(); // LngLat(0, 0) * ``` */ toLngLat() { return new LngLat(lngFromMercatorX(this.x), latFromMercatorY(this.y)); } /** * Returns the altitude in meters of the coordinate. * * @returns The altitude in meters. * @example * ```ts * let coord = new MercatorCoordinate(0, 0, 0.02); * coord.toAltitude(); // 6914.281956295339 * ``` */ toAltitude() { return altitudeFromMercatorZ(this.z, this.y); } /** * Returns the distance of 1 meter in `MercatorCoordinate` units at this latitude. * * For coordinates in real world units using meters, this naturally provides the scale * to transform into `MercatorCoordinate`s. * * @returns Distance of 1 meter in `MercatorCoordinate` units. */ meterInMercatorCoordinateUnits() { // 1 meter / circumference at equator in meters * Mercator projection scale factor at this latitude return 1 / earthCircumference * mercatorScale(latFromMercatorY(this.y)); } } class TileBounds { constructor(bounds, minzoom, maxzoom) { this.bounds = LngLatBounds.convert(this.validateBounds(bounds)); this.minzoom = minzoom || 0; this.maxzoom = maxzoom || 24; } validateBounds(bounds) { // make sure the bounds property contains valid longitude and latitudes if (!Array.isArray(bounds) || bounds.length !== 4) return [-180, -90, 180, 90]; return [Math.max(-180, bounds[0]), Math.max(-90, bounds[1]), Math.min(180, bounds[2]), Math.min(90, bounds[3])]; } contains(tileID) { const worldSize = Math.pow(2, tileID.z); const level = { minX: Math.floor(mercatorXfromLng(this.bounds.getWest()) * worldSize), minY: Math.floor(mercatorYfromLat(this.bounds.getNorth()) * worldSize), maxX: Math.ceil(mercatorXfromLng(this.bounds.getEast()) * worldSize), maxY: Math.ceil(mercatorYfromLat(this.bounds.getSouth()) * worldSize) }; const hit = tileID.x >= level.minX && tileID.x < level.maxX && tileID.y >= level.minY && tileID.y < level.maxY; return hit; } } /** * A source containing vector tiles in [Mapbox Vector Tile format](https://docs.mapbox.com/vector-tiles/reference/). * (See the [Style Specification](https://maplibre.org/maplibre-style-spec/) for detailed documentation of options.) * * @group Sources * * @example * ```ts * map.addSource('some id', { * type: 'vector', * url: 'https://demotiles.maplibre.org/tiles/tiles.json' * }); * ``` * * @example * ```ts * map.addSource('some id', { * type: 'vector', * tiles: ['https://d25uarhxywzl1j.cloudfront.net/v0.1/{z}/{x}/{y}.mvt'], * minzoom: 6, * maxzoom: 14 * }); * ``` * * @example * ```ts * map.getSource('some id').setUrl("https://demotiles.maplibre.org/tiles/tiles.json"); * ``` * * @example * ```ts * map.getSource('some id').setTiles(['https://d25uarhxywzl1j.cloudfront.net/v0.1/{z}/{x}/{y}.mvt']); * ``` * @see [Add a vector tile source](https://maplibre.org/maplibre-gl-js/docs/examples/vector-source/) */ class VectorTileSource extends Evented { constructor(id, options, dispatcher, eventedParent) { super(); this.id = id; this.dispatcher = dispatcher; this.type = 'vector'; this.minzoom = 0; this.maxzoom = 22; this.scheme = 'xyz'; this.tileSize = 512; this.reparseOverscaled = true; this.isTileClipped = true; this._loaded = false; extend(this, pick(options, ['url', 'scheme', 'tileSize', 'promoteId'])); this._options = extend({ type: 'vector' }, options); this._collectResourceTiming = options.collectResourceTiming; if (this.tileSize !== 512) { throw new Error('vector tile sources must have a tileSize of 512'); } this.setEventedParent(eventedParent); } load() { return __awaiter(this, void 0, void 0, function* () { this._loaded = false; this.fire(new Event('dataloading', { dataType: 'source' })); this._tileJSONRequest = new AbortController(); try { const tileJSON = yield loadTileJson(this._options, this.map._requestManager, this._tileJSONRequest); this._tileJSONRequest = null; this._loaded = true; this.map.style.sourceCaches[this.id].clearTiles(); if (tileJSON) { extend(this, tileJSON); if (tileJSON.bounds) this.tileBounds = new TileBounds(tileJSON.bounds, this.minzoom, this.maxzoom); // `content` is included here to prevent a race condition where `Style#_updateSources` is called // before the TileJSON arrives. this makes sure the tiles needed are loaded once TileJSON arrives // ref: https://github.com/mapbox/mapbox-gl-js/pull/4347#discussion_r104418088 this.fire(new Event('data', { dataType: 'source', sourceDataType: 'metadata' })); this.fire(new Event('data', { dataType: 'source', sourceDataType: 'content' })); } } catch (err) { this._tileJSONRequest = null; this.fire(new ErrorEvent(err)); } }); } loaded() { return this._loaded; } hasTile(tileID) { return !this.tileBounds || this.tileBounds.contains(tileID.canonical); } onAdd(map) { this.map = map; this.load(); } setSourceProperty(callback) { if (this._tileJSONRequest) { this._tileJSONRequest.abort(); } callback(); this.load(); } /** * Sets the source `tiles` property and re-renders the map. * * @param tiles - An array of one or more tile source URLs, as in the TileJSON spec. */ setTiles(tiles) { this.setSourceProperty(() => { this._options.tiles = tiles; }); return this; } /** * Sets the source `url` property and re-renders the map. * * @param url - A URL to a TileJSON resource. Supported protocols are `http:` and `https:`. */ setUrl(url) { this.setSourceProperty(() => { this.url = url; this._options.url = url; }); return this; } onRemove() { if (this._tileJSONRequest) { this._tileJSONRequest.abort(); this._tileJSONRequest = null; } } serialize() { return extend({}, this._options); } loadTile(tile) { return __awaiter(this, void 0, void 0, function* () { const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme); const params = { request: this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */), uid: tile.uid, tileID: tile.tileID, zoom: tile.tileID.overscaledZ, tileSize: this.tileSize * tile.tileID.overscaleFactor(), type: this.type, source: this.id, pixelRatio: this.map.getPixelRatio(), showCollisionBoxes: this.map.showCollisionBoxes, promoteId: this.promoteId }; params.request.collectResourceTiming = this._collectResourceTiming; let messageType = "RT" /* MessageType.reloadTile */; if (!tile.actor || tile.state === 'expired') { tile.actor = this.dispatcher.getActor(); messageType = "LT" /* MessageType.loadTile */; } else if (tile.state === 'loading') { return new Promise((resolve, reject) => { tile.reloadPromise = { resolve, reject }; }); } tile.abortController = new AbortController(); try { const data = yield tile.actor.sendAsync({ type: messageType, data: params }, tile.abortController); delete tile.abortController; if (tile.aborted) { return; } this._afterTileLoadWorkerResponse(tile, data); } catch (err) { delete tile.abortController; if (tile.aborted) { return; } if (err && err.status !== 404) { throw err; } this._afterTileLoadWorkerResponse(tile, null); } }); } _afterTileLoadWorkerResponse(tile, data) { if (data && data.resourceTiming) { tile.resourceTiming = data.resourceTiming; } if (data && this.map._refreshExpiredTiles) { tile.setExpiryData(data); } tile.loadVectorData(data, this.map.painter); if (tile.reloadPromise) { const reloadPromise = tile.reloadPromise; tile.reloadPromise = null; this.loadTile(tile).then(reloadPromise.resolve).catch(reloadPromise.reject); } } abortTile(tile) { return __awaiter(this, void 0, void 0, function* () { if (tile.abortController) { tile.abortController.abort(); delete tile.abortController; } if (tile.actor) { yield tile.actor.sendAsync({ type: "AT" /* MessageType.abortTile */, data: { uid: tile.uid, type: this.type, source: this.id } }); } }); } unloadTile(tile) { return __awaiter(this, void 0, void 0, function* () { tile.unloadVectorData(); if (tile.actor) { yield tile.actor.sendAsync({ type: "RMT" /* MessageType.removeTile */, data: { uid: tile.uid, type: this.type, source: this.id } }); } }); } hasTransition() { return false; } } /** * A source containing raster tiles (See the [Style Specification](https://maplibre.org/maplibre-style-spec/) for detailed documentation of options.) * * @group Sources * * @example * ```ts * map.addSource('raster-source', { * 'type': 'raster', * 'tiles': ['https://tiles.stadiamaps.com/tiles/stamen_watercolor/{z}/{x}/{y}.jpg'], * 'tileSize': 256, * }); * ``` * * @example * ```ts * map.addSource('wms-test-source', { * 'type': 'raster', * // use the tiles option to specify a WMS tile source URL * 'tiles': [ * 'https://img.nj.gov/imagerywms/Natural2015?bbox={bbox-epsg-3857}&format=image/png&service=WMS&version=1.1.1&request=GetMap&srs=EPSG:3857&transparent=true&width=256&height=256&layers=Natural2015' * ], * 'tileSize': 256 * }); * ``` * @see [Add a raster tile source](https://maplibre.org/maplibre-gl-js/docs/examples/map-tiles/) * @see [Add a WMS source](https://maplibre.org/maplibre-gl-js/docs/examples/wms/) * @see [Display a satellite map](https://maplibre.org/maplibre-gl-js/docs/examples/satellite-map/) */ class RasterTileSource extends Evented { constructor(id, options, dispatcher, eventedParent) { super(); this.id = id; this.dispatcher = dispatcher; this.setEventedParent(eventedParent); this.type = 'raster'; this.minzoom = 0; this.maxzoom = 22; this.roundZoom = true; this.scheme = 'xyz'; this.tileSize = 512; this._loaded = false; this._options = extend({ type: 'raster' }, options); extend(this, pick(options, ['url', 'scheme', 'tileSize'])); } load() { return __awaiter(this, void 0, void 0, function* () { this._loaded = false; this.fire(new Event('dataloading', { dataType: 'source' })); this._tileJSONRequest = new AbortController(); try { const tileJSON = yield loadTileJson(this._options, this.map._requestManager, this._tileJSONRequest); this._tileJSONRequest = null; this._loaded = true; if (tileJSON) { extend(this, tileJSON); if (tileJSON.bounds) this.tileBounds = new TileBounds(tileJSON.bounds, this.minzoom, this.maxzoom); // `content` is included here to prevent a race condition where `Style#_updateSources` is called // before the TileJSON arrives. this makes sure the tiles needed are loaded once TileJSON arrives // ref: https://github.com/mapbox/mapbox-gl-js/pull/4347#discussion_r104418088 this.fire(new Event('data', { dataType: 'source', sourceDataType: 'metadata' })); this.fire(new Event('data', { dataType: 'source', sourceDataType: 'content' })); } } catch (err) { this._tileJSONRequest = null; this.fire(new ErrorEvent(err)); } }); } loaded() { return this._loaded; } onAdd(map) { this.map = map; this.load(); } onRemove() { if (this._tileJSONRequest) { this._tileJSONRequest.abort(); this._tileJSONRequest = null; } } setSourceProperty(callback) { if (this._tileJSONRequest) { this._tileJSONRequest.abort(); this._tileJSONRequest = null; } callback(); this.load(); } /** * Sets the source `tiles` property and re-renders the map. * * @param tiles - An array of one or more tile source URLs, as in the raster tiles spec (See the [Style Specification](https://maplibre.org/maplibre-style-spec/) */ setTiles(tiles) { this.setSourceProperty(() => { this._options.tiles = tiles; }); return this; } /** * Sets the source `url` property and re-renders the map. * * @param url - A URL to a TileJSON resource. Supported protocols are `http:` and `https:`. */ setUrl(url) { this.setSourceProperty(() => { this.url = url; this._options.url = url; }); return this; } serialize() { return extend({}, this._options); } hasTile(tileID) { return !this.tileBounds || this.tileBounds.contains(tileID.canonical); } loadTile(tile) { return __awaiter(this, void 0, void 0, function* () { const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme); tile.abortController = new AbortController(); try { const response = yield ImageRequest.getImage(this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */), tile.abortController, this.map._refreshExpiredTiles); delete tile.abortController; if (tile.aborted) { tile.state = 'unloaded'; return; } if (response && response.data) { if (this.map._refreshExpiredTiles && response.cacheControl && response.expires) { tile.setExpiryData({ cacheControl: response.cacheControl, expires: response.expires }); } const context = this.map.painter.context; const gl = context.gl; const img = response.data; tile.texture = this.map.painter.getTileTexture(img.width); if (tile.texture) { tile.texture.update(img, { useMipmap: true }); } else { tile.texture = new Texture(context, img, gl.RGBA, { useMipmap: true }); tile.texture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE, gl.LINEAR_MIPMAP_NEAREST); } tile.state = 'loaded'; } } catch (err) { delete tile.abortController; if (tile.aborted) { tile.state = 'unloaded'; } else if (err) { tile.state = 'errored'; throw err; } } }); } abortTile(tile) { return __awaiter(this, void 0, void 0, function* () { if (tile.abortController) { tile.abortController.abort(); delete tile.abortController; } }); } unloadTile(tile) { return __awaiter(this, void 0, void 0, function* () { if (tile.texture) { this.map.painter.saveTileTexture(tile.texture); } }); } hasTransition() { return false; } } /** * getURL * * @param {String} baseUrl Base url of the WMS server * @param {String} layer Layer name * @param {Number} x Tile coordinate x * @param {Number} y Tile coordinate y * @param {Number} z Tile zoom * @param {Object} [options] * @param {String} [options.format='image/png'] * @param {String} [options.service='WMS'] * @param {String} [options.version='1.1.1'] * @param {String} [options.request='GetMap'] * @param {String} [options.srs='EPSG:3857'] * @param {Number} [options.width='256'] * @param {Number} [options.height='256'] * @returns {String} url * @example * var baseUrl = 'http://geodata.state.nj.us/imagerywms/Natural2015'; * var layer = 'Natural2015'; * var url = whoots.getURL(baseUrl, layer, 154308, 197167, 19); */ function getURL(baseUrl, layer, x, y, z, options) { options = options || {}; var url = baseUrl + '?' + [ 'bbox=' + getTileBBox(x, y, z), 'format=' + (options.format || 'image/png'), 'service=' + (options.service || 'WMS'), 'version=' + (options.version || '1.1.1'), 'request=' + (options.request || 'GetMap'), 'srs=' + (options.srs || 'EPSG:3857'), 'width=' + (options.width || 256), 'height=' + (options.height || 256), 'layers=' + layer ].join('&'); return url; } /** * getTileBBox * * @param {Number} x Tile coordinate x * @param {Number} y Tile coordinate y * @param {Number} z Tile zoom * @returns {String} String of the bounding box */ function getTileBBox(x, y, z) { // for Google/OSM tile scheme we need to alter the y y = (Math.pow(2, z) - y - 1); var min = getMercCoords(x * 256, y * 256, z), max = getMercCoords((x + 1) * 256, (y + 1) * 256, z); return min[0] + ',' + min[1] + ',' + max[0] + ',' + max[1]; } /** * getMercCoords * * @param {Number} x Pixel coordinate x * @param {Number} y Pixel coordinate y * @param {Number} z Tile zoom * @returns {Array} [x, y] */ function getMercCoords(x, y, z) { var resolution = (2 * Math.PI * 6378137 / 256) / Math.pow(2, z), merc_x = (x * resolution - 2 * Math.PI * 6378137 / 2.0), merc_y = (y * resolution - 2 * Math.PI * 6378137 / 2.0); return [merc_x, merc_y]; } /** * Returns true if a given tile zoom (Z), X, and Y are in the bounds of the world. * Zoom bounds are the minimum zoom (inclusive) through the maximum zoom (inclusive). * X and Y bounds are 0 (inclusive) to their respective zoom-dependent maxima (exclusive). * * @param zoom - the tile zoom (Z) * @param x - the tile X * @param y - the tile Y * @returns `true` if a given tile zoom, X, and Y are in the bounds of the world. */ function isInBoundsForTileZoomXY(zoom, x, y) { return !(zoom < MIN_TILE_ZOOM || zoom > MAX_TILE_ZOOM || y < 0 || y >= Math.pow(2, zoom) || x < 0 || x >= Math.pow(2, zoom)); } /** * Returns true if a given zoom and `LngLat` are in the bounds of the world. * Does not wrap `LngLat` when checking if in bounds. * Zoom bounds are the minimum zoom (inclusive) through the maximum zoom (inclusive). * `LngLat` bounds are the mercator world's north-west corner (inclusive) to its south-east corner (exclusive). * * @param zoom - the tile zoom (Z) * @param LngLat - the `LngLat` object containing the longitude and latitude * @returns `true` if a given zoom and `LngLat` are in the bounds of the world. */ function isInBoundsForZoomLngLat(zoom, lnglat) { const { x, y } = MercatorCoordinate.fromLngLat(lnglat); return !(zoom < MIN_TILE_ZOOM || zoom > MAX_TILE_ZOOM || y < 0 || y >= 1 || x < 0 || x >= 1); } /** * A canonical way to define a tile ID */ class CanonicalTileID { constructor(z, x, y) { if (!isInBoundsForTileZoomXY(z, x, y)) { throw new Error(`x=${x}, y=${y}, z=${z} outside of bounds. 0<=x<${Math.pow(2, z)}, 0<=y<${Math.pow(2, z)} ${MIN_TILE_ZOOM}<=z<=${MAX_TILE_ZOOM} `); } this.z = z; this.x = x; this.y = y; this.key = calculateKey(0, z, z, x, y); } equals(id) { return this.z === id.z && this.x === id.x && this.y === id.y; } // given a list of urls, choose a url template and return a tile URL url(urls, pixelRatio, scheme) { const bbox = getTileBBox(this.x, this.y, this.z); const quadkey = getQuadkey(this.z, this.x, this.y); return urls[(this.x + this.y) % urls.length] .replace(/{prefix}/g, (this.x % 16).toString(16) + (this.y % 16).toString(16)) .replace(/{z}/g, String(this.z)) .replace(/{x}/g, String(this.x)) .replace(/{y}/g, String(scheme === 'tms' ? (Math.pow(2, this.z) - this.y - 1) : this.y)) .replace(/{ratio}/g, pixelRatio > 1 ? '@2x' : '') .replace(/{quadkey}/g, quadkey) .replace(/{bbox-epsg-3857}/g, bbox); } isChildOf(parent) { const dz = this.z - parent.z; return dz > 0 && parent.x === (this.x >> dz) && parent.y === (this.y >> dz); } getTilePoint(coord) { const tilesAtZoom = Math.pow(2, this.z); return new Point$2((coord.x * tilesAtZoom - this.x) * EXTENT, (coord.y * tilesAtZoom - this.y) * EXTENT); } toString() { return `${this.z}/${this.x}/${this.y}`; } } /** * @internal * An unwrapped tile identifier */ class UnwrappedTileID { constructor(wrap, canonical) { this.wrap = wrap; this.canonical = canonical; this.key = calculateKey(wrap, canonical.z, canonical.z, canonical.x, canonical.y); } } /** * An overscaled tile identifier */ class OverscaledTileID { constructor(overscaledZ, wrap, z, x, y) { if (overscaledZ < z) throw new Error(`overscaledZ should be >= z; overscaledZ = ${overscaledZ}; z = ${z}`); this.overscaledZ = overscaledZ; this.wrap = wrap; this.canonical = new CanonicalTileID(z, +x, +y); this.key = calculateKey(wrap, overscaledZ, z, x, y); } clone() { return new OverscaledTileID(this.overscaledZ, this.wrap, this.canonical.z, this.canonical.x, this.canonical.y); } equals(id) { return this.overscaledZ === id.overscaledZ && this.wrap === id.wrap && this.canonical.equals(id.canonical); } scaledTo(targetZ) { if (targetZ > this.overscaledZ) throw new Error(`targetZ > this.overscaledZ; targetZ = ${targetZ}; overscaledZ = ${this.overscaledZ}`); const zDifference = this.canonical.z - targetZ; if (targetZ > this.canonical.z) { return new OverscaledTileID(targetZ, this.wrap, this.canonical.z, this.canonical.x, this.canonical.y); } else { return new OverscaledTileID(targetZ, this.wrap, targetZ, this.canonical.x >> zDifference, this.canonical.y >> zDifference); } } /* * calculateScaledKey is an optimization: * when withWrap == true, implements the same as this.scaledTo(z).key, * when withWrap == false, implements the same as this.scaledTo(z).wrapped().key. */ calculateScaledKey(targetZ, withWrap) { if (targetZ > this.overscaledZ) throw new Error(`targetZ > this.overscaledZ; targetZ = ${targetZ}; overscaledZ = ${this.overscaledZ}`); const zDifference = this.canonical.z - targetZ; if (targetZ > this.canonical.z) { return calculateKey(this.wrap * +withWrap, targetZ, this.canonical.z, this.canonical.x, this.canonical.y); } else { return calculateKey(this.wrap * +withWrap, targetZ, targetZ, this.canonical.x >> zDifference, this.canonical.y >> zDifference); } } isChildOf(parent) { if (parent.wrap !== this.wrap) { // We can't be a child if we're in a different world copy return false; } const zDifference = this.canonical.z - parent.canonical.z; // We're first testing for z == 0, to avoid a 32 bit shift, which is undefined. return parent.overscaledZ === 0 || (parent.overscaledZ < this.overscaledZ && parent.canonical.x === (this.canonical.x >> zDifference) && parent.canonical.y === (this.canonical.y >> zDifference)); } children(sourceMaxZoom) { if (this.overscaledZ >= sourceMaxZoom) { // return a single tile coord representing a an overscaled tile return [new OverscaledTileID(this.overscaledZ + 1, this.wrap, this.canonical.z, this.canonical.x, this.canonical.y)]; } const z = this.canonical.z + 1; const x = this.canonical.x * 2; const y = this.canonical.y * 2; return [ new OverscaledTileID(z, this.wrap, z, x, y), new OverscaledTileID(z, this.wrap, z, x + 1, y), new OverscaledTileID(z, this.wrap, z, x, y + 1), new OverscaledTileID(z, this.wrap, z, x + 1, y + 1) ]; } isLessThan(rhs) { if (this.wrap < rhs.wrap) return true; if (this.wrap > rhs.wrap) return false; if (this.overscaledZ < rhs.overscaledZ) return true; if (this.overscaledZ > rhs.overscaledZ) return false; if (this.canonical.x < rhs.canonical.x) return true; if (this.canonical.x > rhs.canonical.x) return false; if (this.canonical.y < rhs.canonical.y) return true; return false; } wrapped() { return new OverscaledTileID(this.overscaledZ, 0, this.canonical.z, this.canonical.x, this.canonical.y); } unwrapTo(wrap) { return new OverscaledTileID(this.overscaledZ, wrap, this.canonical.z, this.canonical.x, this.canonical.y); } overscaleFactor() { return Math.pow(2, this.overscaledZ - this.canonical.z); } toUnwrapped() { return new UnwrappedTileID(this.wrap, this.canonical); } toString() { return `${this.overscaledZ}/${this.canonical.x}/${this.canonical.y}`; } getTilePoint(coord) { return this.canonical.getTilePoint(new MercatorCoordinate(coord.x - this.wrap, coord.y)); } } function calculateKey(wrap, overscaledZ, z, x, y) { wrap *= 2; if (wrap < 0) wrap = wrap * -1 - 1; const dim = 1 << z; return (dim * dim * wrap + dim * y + x).toString(36) + z.toString(36) + overscaledZ.toString(36); } function getQuadkey(z, x, y) { let quadkey = '', mask; for (let i = z; i > 0; i--) { mask = 1 << (i - 1); quadkey += ((x & mask ? 1 : 0) + (y & mask ? 2 : 0)); } return quadkey; } register('CanonicalTileID', CanonicalTileID); register('OverscaledTileID', OverscaledTileID, { omit: ['posMatrix'] }); /** * DEMData is a data structure for decoding, backfilling, and storing elevation data for processing in the hillshade shaders * data can be populated either from a pngraw image tile or from serialized data sent back from a worker. When data is initially * loaded from a image tile, we decode the pixel values using the appropriate decoding formula, but we store the * elevation data as an Int32 value. we add 65536 (2^16) to eliminate negative values and enable the use of * integer overflow when creating the texture used in the hillshadePrepare step. * * DEMData also handles the backfilling of data from a tile's neighboring tiles. This is necessary because we use a pixel's 8 * surrounding pixel values to compute the slope at that pixel, and we cannot accurately calculate the slope at pixels on a * tile's edge without backfilling from neighboring tiles. */ class DEMData { /** * Constructs a `DEMData` object * @param uid - the tile's unique id * @param data - RGBAImage data has uniform 1px padding on all sides: square tile edge size defines stride // and dim is calculated as stride - 2. * @param encoding - the encoding type of the data * @param redFactor - the red channel factor used to unpack the data, used for `custom` encoding only * @param greenFactor - the green channel factor used to unpack the data, used for `custom` encoding only * @param blueFactor - the blue channel factor used to unpack the data, used for `custom` encoding only * @param baseShift - the base shift used to unpack the data, used for `custom` encoding only */ constructor(uid, data, encoding, redFactor = 1.0, greenFactor = 1.0, blueFactor = 1.0, baseShift = 0.0) { this.uid = uid; if (data.height !== data.width) throw new RangeError('DEM tiles must be square'); if (encoding && !['mapbox', 'terrarium', 'custom'].includes(encoding)) { warnOnce(`"${encoding}" is not a valid encoding type. Valid types include "mapbox", "terrarium" and "custom".`); return; } this.stride = data.height; const dim = this.dim = data.height - 2; this.data = new Uint32Array(data.data.buffer); switch (encoding) { case 'terrarium': // unpacking formula for mapzen terrarium: // https://aws.amazon.com/public-datasets/terrain/ this.redFactor = 256.0; this.greenFactor = 1.0; this.blueFactor = 1.0 / 256.0; this.baseShift = 32768.0; break; case 'custom': this.redFactor = redFactor; this.greenFactor = greenFactor; this.blueFactor = blueFactor; this.baseShift = baseShift; break; case 'mapbox': default: // unpacking formula for mapbox.terrain-rgb: // https://www.mapbox.com/help/access-elevation-data/#mapbox-terrain-rgb this.redFactor = 6553.6; this.greenFactor = 25.6; this.blueFactor = 0.1; this.baseShift = 10000.0; break; } // in order to avoid flashing seams between tiles, here we are initially populating a 1px border of pixels around the image // with the data of the nearest pixel from the image. this data is eventually replaced when the tile's neighboring // tiles are loaded and the accurate data can be backfilled using DEMData#backfillBorder for (let x = 0; x < dim; x++) { // left vertical border this.data[this._idx(-1, x)] = this.data[this._idx(0, x)]; // right vertical border this.data[this._idx(dim, x)] = this.data[this._idx(dim - 1, x)]; // left horizontal border this.data[this._idx(x, -1)] = this.data[this._idx(x, 0)]; // right horizontal border this.data[this._idx(x, dim)] = this.data[this._idx(x, dim - 1)]; } // corners this.data[this._idx(-1, -1)] = this.data[this._idx(0, 0)]; this.data[this._idx(dim, -1)] = this.data[this._idx(dim - 1, 0)]; this.data[this._idx(-1, dim)] = this.data[this._idx(0, dim - 1)]; this.data[this._idx(dim, dim)] = this.data[this._idx(dim - 1, dim - 1)]; // calculate min/max values this.min = Number.MAX_SAFE_INTEGER; this.max = Number.MIN_SAFE_INTEGER; for (let x = 0; x < dim; x++) { for (let y = 0; y < dim; y++) { const ele = this.get(x, y); if (ele > this.max) this.max = ele; if (ele < this.min) this.min = ele; } } } get(x, y) { const pixels = new Uint8Array(this.data.buffer); const index = this._idx(x, y) * 4; return this.unpack(pixels[index], pixels[index + 1], pixels[index + 2]); } getUnpackVector() { return [this.redFactor, this.greenFactor, this.blueFactor, this.baseShift]; } _idx(x, y) { if (x < -1 || x >= this.dim + 1 || y < -1 || y >= this.dim + 1) throw new RangeError('out of range source coordinates for DEM data'); return (y + 1) * this.stride + (x + 1); } unpack(r, g, b) { return (r * this.redFactor + g * this.greenFactor + b * this.blueFactor - this.baseShift); } getPixels() { return new RGBAImage({ width: this.stride, height: this.stride }, new Uint8Array(this.data.buffer)); } backfillBorder(borderTile, dx, dy) { if (this.dim !== borderTile.dim) throw new Error('dem dimension mismatch'); let xMin = dx * this.dim, xMax = dx * this.dim + this.dim, yMin = dy * this.dim, yMax = dy * this.dim + this.dim; switch (dx) { case -1: xMin = xMax - 1; break; case 1: xMax = xMin + 1; break; } switch (dy) { case -1: yMin = yMax - 1; break; case 1: yMax = yMin + 1; break; } const ox = -dx * this.dim; const oy = -dy * this.dim; for (let y = yMin; y < yMax; y++) { for (let x = xMin; x < xMax; x++) { this.data[this._idx(x, y)] = borderTile.data[this._idx(x + ox, y + oy)]; } } } } register('DEMData', DEMData); /** * A source containing raster DEM tiles (See the [Style Specification](https://maplibre.org/maplibre-style-spec/) for detailed documentation of options.) * This source can be used to show hillshading and 3D terrain * * @group Sources * * @example * ```ts * map.addSource('raster-dem-source', { * type: 'raster-dem', * url: 'https://demotiles.maplibre.org/terrain-tiles/tiles.json', * tileSize: 256 * }); * ``` * @see [3D Terrain](https://maplibre.org/maplibre-gl-js/docs/examples/3d-terrain/) */ class RasterDEMTileSource extends RasterTileSource { constructor(id, options, dispatcher, eventedParent) { super(id, options, dispatcher, eventedParent); this.type = 'raster-dem'; this.maxzoom = 22; this._options = extend({ type: 'raster-dem' }, options); this.encoding = options.encoding || 'mapbox'; this.redFactor = options.redFactor; this.greenFactor = options.greenFactor; this.blueFactor = options.blueFactor; this.baseShift = options.baseShift; } loadTile(tile) { return __awaiter(this, void 0, void 0, function* () { const url = tile.tileID.canonical.url(this.tiles, this.map.getPixelRatio(), this.scheme); const request = this.map._requestManager.transformRequest(url, "Tile" /* ResourceType.Tile */); tile.neighboringTiles = this._getNeighboringTiles(tile.tileID); tile.abortController = new AbortController(); try { const response = yield ImageRequest.getImage(request, tile.abortController, this.map._refreshExpiredTiles); delete tile.abortController; if (tile.aborted) { tile.state = 'unloaded'; return; } if (response && response.data) { const img = response.data; if (this.map._refreshExpiredTiles && response.cacheControl && response.expires) { tile.setExpiryData({ cacheControl: response.cacheControl, expires: response.expires }); } const transfer = isImageBitmap(img) && offscreenCanvasSupported(); const rawImageData = transfer ? img : yield this.readImageNow(img); const params = { type: this.type, uid: tile.uid, source: this.id, rawImageData, encoding: this.encoding, redFactor: this.redFactor, greenFactor: this.greenFactor, blueFactor: this.blueFactor, baseShift: this.baseShift }; if (!tile.actor || tile.state === 'expired') { tile.actor = this.dispatcher.getActor(); /* eslint-disable require-atomic-updates */ const data = yield tile.actor.sendAsync({ type: "LDT" /* MessageType.loadDEMTile */, data: params }); tile.dem = data; tile.needsHillshadePrepare = true; tile.needsTerrainPrepare = true; tile.state = 'loaded'; /* eslint-enable require-atomic-updates */ } } } catch (err) { delete tile.abortController; if (tile.aborted) { tile.state = 'unloaded'; } else if (err) { tile.state = 'errored'; throw err; } } }); } readImageNow(img) { return __awaiter(this, void 0, void 0, function* () { if (typeof VideoFrame !== 'undefined' && isOffscreenCanvasDistorted()) { const width = img.width + 2; const height = img.height + 2; try { return new RGBAImage({ width, height }, yield readImageUsingVideoFrame(img, -1, -1, width, height)); } catch (e) { // fall-back to browser canvas decoding } } return browser.getImageData(img, 1); }); } _getNeighboringTiles(tileID) { const canonical = tileID.canonical; const dim = Math.pow(2, canonical.z); const px = (canonical.x - 1 + dim) % dim; const pxw = canonical.x === 0 ? tileID.wrap - 1 : tileID.wrap; const nx = (canonical.x + 1 + dim) % dim; const nxw = canonical.x + 1 === dim ? tileID.wrap + 1 : tileID.wrap; const neighboringTiles = {}; // add adjacent tiles neighboringTiles[new OverscaledTileID(tileID.overscaledZ, pxw, canonical.z, px, canonical.y).key] = { backfilled: false }; neighboringTiles[new OverscaledTileID(tileID.overscaledZ, nxw, canonical.z, nx, canonical.y).key] = { backfilled: false }; // Add upper neighboringTiles if (canonical.y > 0) { neighboringTiles[new OverscaledTileID(tileID.overscaledZ, pxw, canonical.z, px, canonical.y - 1).key] = { backfilled: false }; neighboringTiles[new OverscaledTileID(tileID.overscaledZ, tileID.wrap, canonical.z, canonical.x, canonical.y - 1).key] = { backfilled: false }; neighboringTiles[new OverscaledTileID(tileID.overscaledZ, nxw, canonical.z, nx, canonical.y - 1).key] = { backfilled: false }; } // Add lower neighboringTiles if (canonical.y + 1 < dim) { neighboringTiles[new OverscaledTileID(tileID.overscaledZ, pxw, canonical.z, px, canonical.y + 1).key] = { backfilled: false }; neighboringTiles[new OverscaledTileID(tileID.overscaledZ, tileID.wrap, canonical.z, canonical.x, canonical.y + 1).key] = { backfilled: false }; neighboringTiles[new OverscaledTileID(tileID.overscaledZ, nxw, canonical.z, nx, canonical.y + 1).key] = { backfilled: false }; } return neighboringTiles; } unloadTile(tile) { return __awaiter(this, void 0, void 0, function* () { if (tile.demTexture) this.map.painter.saveTileTexture(tile.demTexture); if (tile.fbo) { tile.fbo.destroy(); delete tile.fbo; } if (tile.dem) delete tile.dem; delete tile.neighboringTiles; tile.state = 'unloaded'; if (tile.actor) { yield tile.actor.sendAsync({ type: "RDT" /* MessageType.removeDEMTile */, data: { type: this.type, uid: tile.uid, source: this.id } }); } }); } } /** * A source containing GeoJSON. * (See the [Style Specification](https://maplibre.org/maplibre-style-spec/#sources-geojson) for detailed documentation of options.) * * @group Sources * * @example * ```ts * map.addSource('some id', { * type: 'geojson', * data: 'https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_10m_ports.geojson' * }); * ``` * * @example * ```ts * map.addSource('some id', { * type: 'geojson', * data: { * "type": "FeatureCollection", * "features": [{ * "type": "Feature", * "properties": {}, * "geometry": { * "type": "Point", * "coordinates": [ * -76.53063297271729, * 39.18174077994108 * ] * } * }] * } * }); * ``` * * @example * ```ts * map.getSource('some id').setData({ * "type": "FeatureCollection", * "features": [{ * "type": "Feature", * "properties": { "name": "Null Island" }, * "geometry": { * "type": "Point", * "coordinates": [ 0, 0 ] * } * }] * }); * ``` * @see [Draw GeoJSON points](https://maplibre.org/maplibre-gl-js/docs/examples/geojson-markers/) * @see [Add a GeoJSON line](https://maplibre.org/maplibre-gl-js/docs/examples/geojson-line/) * @see [Create a heatmap from points](https://maplibre.org/maplibre-gl-js/docs/examples/heatmap-layer/) * @see [Create and style clusters](https://maplibre.org/maplibre-gl-js/docs/examples/cluster/) */ class GeoJSONSource extends Evented { /** @internal */ constructor(id, options, dispatcher, eventedParent) { super(); this.id = id; // `type` is a property rather than a constant to make it easy for 3rd // parties to use GeoJSONSource to build their own source types. this.type = 'geojson'; this.minzoom = 0; this.maxzoom = 18; this.tileSize = 512; this.isTileClipped = true; this.reparseOverscaled = true; this._removed = false; this._pendingLoads = 0; this.actor = dispatcher.getActor(); this.setEventedParent(eventedParent); this._data = options.data; this._options = extend({}, options); this._collectResourceTiming = options.collectResourceTiming; if (options.maxzoom !== undefined) this.maxzoom = options.maxzoom; if (options.type) this.type = options.type; if (options.attribution) this.attribution = options.attribution; this.promoteId = options.promoteId; const scale = EXTENT / this.tileSize; if (options.clusterMaxZoom !== undefined && this.maxzoom <= options.clusterMaxZoom) { warnOnce(`The maxzoom value "${this.maxzoom}" is expected to be greater than the clusterMaxZoom value "${options.clusterMaxZoom}".`); } // sent to the worker, along with `url: ...` or `data: literal geojson`, // so that it can load/parse/index the geojson data // extending with `options.workerOptions` helps to make it easy for // third-party sources to hack/reuse GeoJSONSource. this.workerOptions = extend({ source: this.id, cluster: options.cluster || false, geojsonVtOptions: { buffer: (options.buffer !== undefined ? options.buffer : 128) * scale, tolerance: (options.tolerance !== undefined ? options.tolerance : 0.375) * scale, extent: EXTENT, maxZoom: this.maxzoom, lineMetrics: options.lineMetrics || false, generateId: options.generateId || false }, superclusterOptions: { maxZoom: options.clusterMaxZoom !== undefined ? options.clusterMaxZoom : this.maxzoom - 1, minPoints: Math.max(2, options.clusterMinPoints || 2), extent: EXTENT, radius: (options.clusterRadius || 50) * scale, log: false, generateId: options.generateId || false }, clusterProperties: options.clusterProperties, filter: options.filter }, options.workerOptions); // send the promoteId to the worker to have more flexible updates, but only if it is a string if (typeof this.promoteId === 'string') { this.workerOptions.promoteId = this.promoteId; } } load() { return __awaiter(this, void 0, void 0, function* () { yield this._updateWorkerData(); }); } onAdd(map) { this.map = map; this.load(); } /** * Sets the GeoJSON data and re-renders the map. * * @param data - A GeoJSON data object or a URL to one. The latter is preferable in the case of large GeoJSON files. */ setData(data) { this._data = data; this._updateWorkerData(); return this; } /** * Updates the source's GeoJSON, and re-renders the map. * * For sources with lots of features, this method can be used to make updates more quickly. * * This approach requires unique IDs for every feature in the source. The IDs can either be specified on the feature, * or by using the promoteId option to specify which property should be used as the ID. * * It is an error to call updateData on a source that did not have unique IDs for each of its features already. * * Updates are applied on a best-effort basis, updating an ID that does not exist will not result in an error. * * @param diff - The changes that need to be applied. */ updateData(diff) { this._updateWorkerData(diff); return this; } /** * Allows to get the source's actual GeoJSON data. * * @returns a promise which resolves to the source's actual GeoJSON data */ getData() { return __awaiter(this, void 0, void 0, function* () { const options = extend({ type: this.type }, this.workerOptions); return this.actor.sendAsync({ type: "GD" /* MessageType.getData */, data: options }); }); } /** * To disable/enable clustering on the source options * @param options - The options to set * @example * ```ts * map.getSource('some id').setClusterOptions({cluster: false}); * map.getSource('some id').setClusterOptions({cluster: false, clusterRadius: 50, clusterMaxZoom: 14}); * ``` */ setClusterOptions(options) { this.workerOptions.cluster = options.cluster; if (options) { if (options.clusterRadius !== undefined) this.workerOptions.superclusterOptions.radius = options.clusterRadius; if (options.clusterMaxZoom !== undefined) this.workerOptions.superclusterOptions.maxZoom = options.clusterMaxZoom; } this._updateWorkerData(); return this; } /** * For clustered sources, fetches the zoom at which the given cluster expands. * * @param clusterId - The value of the cluster's `cluster_id` property. * @returns a promise that is resolved with the zoom number */ getClusterExpansionZoom(clusterId) { return this.actor.sendAsync({ type: "GCEZ" /* MessageType.getClusterExpansionZoom */, data: { type: this.type, clusterId, source: this.id } }); } /** * For clustered sources, fetches the children of the given cluster on the next zoom level (as an array of GeoJSON features). * * @param clusterId - The value of the cluster's `cluster_id` property. * @returns a promise that is resolved when the features are retrieved */ getClusterChildren(clusterId) { return this.actor.sendAsync({ type: "GCC" /* MessageType.getClusterChildren */, data: { type: this.type, clusterId, source: this.id } }); } /** * For clustered sources, fetches the original points that belong to the cluster (as an array of GeoJSON features). * * @param clusterId - The value of the cluster's `cluster_id` property. * @param limit - The maximum number of features to return. * @param offset - The number of features to skip (e.g. for pagination). * @returns a promise that is resolved when the features are retrieved * @example * Retrieve cluster leaves on click * ```ts * map.on('click', 'clusters', (e) => { * let features = map.queryRenderedFeatures(e.point, { * layers: ['clusters'] * }); * * let clusterId = features[0].properties.cluster_id; * let pointCount = features[0].properties.point_count; * let clusterSource = map.getSource('clusters'); * * const features = await clusterSource.getClusterLeaves(clusterId, pointCount); * // Print cluster leaves in the console * console.log('Cluster leaves:', features); * }); * ``` */ getClusterLeaves(clusterId, limit, offset) { return this.actor.sendAsync({ type: "GCL" /* MessageType.getClusterLeaves */, data: { type: this.type, source: this.id, clusterId, limit, offset } }); } /** * Responsible for invoking WorkerSource's geojson.loadData target, which * handles loading the geojson data and preparing to serve it up as tiles, * using geojson-vt or supercluster as appropriate. * @param diff - the diff object */ _updateWorkerData(diff) { return __awaiter(this, void 0, void 0, function* () { const options = extend({ type: this.type }, this.workerOptions); if (diff) { options.dataDiff = diff; } else if (typeof this._data === 'string') { options.request = this.map._requestManager.transformRequest(browser.resolveURL(this._data), "Source" /* ResourceType.Source */); options.request.collectResourceTiming = this._collectResourceTiming; } else { options.data = JSON.stringify(this._data); } this._pendingLoads++; this.fire(new Event('dataloading', { dataType: 'source' })); try { const result = yield this.actor.sendAsync({ type: "LD" /* MessageType.loadData */, data: options }); this._pendingLoads--; if (this._removed || result.abandoned) { this.fire(new Event('dataabort', { dataType: 'source' })); return; } let resourceTiming = null; if (result.resourceTiming && result.resourceTiming[this.id]) { resourceTiming = result.resourceTiming[this.id].slice(0); } const data = { dataType: 'source' }; if (this._collectResourceTiming && resourceTiming && resourceTiming.length > 0) { extend(data, { resourceTiming }); } // although GeoJSON sources contain no metadata, we fire this event to let the SourceCache // know its ok to start requesting tiles. this.fire(new Event('data', Object.assign(Object.assign({}, data), { sourceDataType: 'metadata' }))); this.fire(new Event('data', Object.assign(Object.assign({}, data), { sourceDataType: 'content' }))); } catch (err) { this._pendingLoads--; if (this._removed) { this.fire(new Event('dataabort', { dataType: 'source' })); return; } this.fire(new ErrorEvent(err)); } }); } loaded() { return this._pendingLoads === 0; } loadTile(tile) { return __awaiter(this, void 0, void 0, function* () { const message = !tile.actor ? "LT" /* MessageType.loadTile */ : "RT" /* MessageType.reloadTile */; tile.actor = this.actor; const params = { type: this.type, uid: tile.uid, tileID: tile.tileID, zoom: tile.tileID.overscaledZ, maxZoom: this.maxzoom, tileSize: this.tileSize, source: this.id, pixelRatio: this.map.getPixelRatio(), showCollisionBoxes: this.map.showCollisionBoxes, promoteId: this.promoteId }; tile.abortController = new AbortController(); const data = yield this.actor.sendAsync({ type: message, data: params }, tile.abortController); delete tile.abortController; tile.unloadVectorData(); if (!tile.aborted) { tile.loadVectorData(data, this.map.painter, message === "RT" /* MessageType.reloadTile */); } }); } abortTile(tile) { return __awaiter(this, void 0, void 0, function* () { if (tile.abortController) { tile.abortController.abort(); delete tile.abortController; } tile.aborted = true; }); } unloadTile(tile) { return __awaiter(this, void 0, void 0, function* () { tile.unloadVectorData(); yield this.actor.sendAsync({ type: "RMT" /* MessageType.removeTile */, data: { uid: tile.uid, type: this.type, source: this.id } }); }); } onRemove() { this._removed = true; this.actor.sendAsync({ type: "RS" /* MessageType.removeSource */, data: { type: this.type, source: this.id } }); } serialize() { return extend({}, this._options, { type: this.type, data: this._data }); } hasTransition() { return false; } } var rasterBoundsAttributes = createLayout([ { name: 'a_pos', type: 'Int16', components: 2 }, { name: 'a_texture_pos', type: 'Int16', components: 2 } ]); /** * A data source containing an image. * (See the [Style Specification](https://maplibre.org/maplibre-style-spec/#sources-image) for detailed documentation of options.) * * @group Sources * * @example * ```ts * // add to map * map.addSource('some id', { * type: 'image', * url: 'https://www.maplibre.org/images/foo.png', * coordinates: [ * [-76.54, 39.18], * [-76.52, 39.18], * [-76.52, 39.17], * [-76.54, 39.17] * ] * }); * * // update coordinates * let mySource = map.getSource('some id'); * mySource.setCoordinates([ * [-76.54335737228394, 39.18579907229748], * [-76.52803659439087, 39.1838364847587], * [-76.5295386314392, 39.17683392507606], * [-76.54520273208618, 39.17876344106642] * ]); * * // update url and coordinates simultaneously * mySource.updateImage({ * url: 'https://www.maplibre.org/images/bar.png', * coordinates: [ * [-76.54335737228394, 39.18579907229748], * [-76.52803659439087, 39.1838364847587], * [-76.5295386314392, 39.17683392507606], * [-76.54520273208618, 39.17876344106642] * ] * }) * * map.removeSource('some id'); // remove * ``` */ class ImageSource extends Evented { /** @internal */ constructor(id, options, dispatcher, eventedParent) { super(); this.id = id; this.dispatcher = dispatcher; this.coordinates = options.coordinates; this.type = 'image'; this.minzoom = 0; this.maxzoom = 22; this.tileSize = 512; this.tiles = {}; this._loaded = false; this.setEventedParent(eventedParent); this.options = options; } load(newCoordinates) { return __awaiter(this, void 0, void 0, function* () { this._loaded = false; this.fire(new Event('dataloading', { dataType: 'source' })); this.url = this.options.url; this._request = new AbortController(); try { const image = yield ImageRequest.getImage(this.map._requestManager.transformRequest(this.url, "Image" /* ResourceType.Image */), this._request); this._request = null; this._loaded = true; if (image && image.data) { this.image = image.data; if (newCoordinates) { this.coordinates = newCoordinates; } this._finishLoading(); } } catch (err) { this._request = null; this._loaded = true; this.fire(new ErrorEvent(err)); } }); } loaded() { return this._loaded; } /** * Updates the image URL and, optionally, the coordinates. To avoid having the image flash after changing, * set the `raster-fade-duration` paint property on the raster layer to 0. * * @param options - The options object. */ updateImage(options) { if (!options.url) { return this; } if (this._request) { this._request.abort(); this._request = null; } this.options.url = options.url; this.load(options.coordinates).finally(() => { this.texture = null; }); return this; } _finishLoading() { if (this.map) { this.setCoordinates(this.coordinates); this.fire(new Event('data', { dataType: 'source', sourceDataType: 'metadata' })); } } onAdd(map) { this.map = map; this.load(); } onRemove() { if (this._request) { this._request.abort(); this._request = null; } } /** * Sets the image's coordinates and re-renders the map. * * @param coordinates - Four geographical coordinates, * represented as arrays of longitude and latitude numbers, which define the corners of the image. * The coordinates start at the top left corner of the image and proceed in clockwise order. * They do not have to represent a rectangle. */ setCoordinates(coordinates) { this.coordinates = coordinates; // Calculate which mercator tile is suitable for rendering the video in // and create a buffer with the corner coordinates. These coordinates // may be outside the tile, because raster tiles aren't clipped when rendering. // transform the geo coordinates into (zoom 0) tile space coordinates const cornerCoords = coordinates.map(MercatorCoordinate.fromLngLat); // Compute the coordinates of the tile we'll use to hold this image's // render data this.tileID = getCoordinatesCenterTileID(cornerCoords); // Constrain min/max zoom to our tile's zoom level in order to force // SourceCache to request this tile (no matter what the map's zoom // level) this.minzoom = this.maxzoom = this.tileID.z; // Transform the corner coordinates into the coordinate space of our // tile. const tileCoords = cornerCoords.map((coord) => this.tileID.getTilePoint(coord)._round()); this._boundsArray = new RasterBoundsArray(); this._boundsArray.emplaceBack(tileCoords[0].x, tileCoords[0].y, 0, 0); this._boundsArray.emplaceBack(tileCoords[1].x, tileCoords[1].y, EXTENT, 0); this._boundsArray.emplaceBack(tileCoords[3].x, tileCoords[3].y, 0, EXTENT); this._boundsArray.emplaceBack(tileCoords[2].x, tileCoords[2].y, EXTENT, EXTENT); if (this.boundsBuffer) { this.boundsBuffer.destroy(); delete this.boundsBuffer; } this.fire(new Event('data', { dataType: 'source', sourceDataType: 'content' })); return this; } prepare() { if (Object.keys(this.tiles).length === 0 || !this.image) { return; } const context = this.map.painter.context; const gl = context.gl; if (!this.boundsBuffer) { this.boundsBuffer = context.createVertexBuffer(this._boundsArray, rasterBoundsAttributes.members); } if (!this.boundsSegments) { this.boundsSegments = SegmentVector.simpleSegment(0, 0, 4, 2); } if (!this.texture) { this.texture = new Texture(context, this.image, gl.RGBA); this.texture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); } let newTilesLoaded = false; for (const w in this.tiles) { const tile = this.tiles[w]; if (tile.state !== 'loaded') { tile.state = 'loaded'; tile.texture = this.texture; newTilesLoaded = true; } } if (newTilesLoaded) { this.fire(new Event('data', { dataType: 'source', sourceDataType: 'idle', sourceId: this.id })); } } loadTile(tile) { return __awaiter(this, void 0, void 0, function* () { // We have a single tile -- whose coordinates are this.tileID -- that // covers the image we want to render. If that's the one being // requested, set it up with the image; otherwise, mark the tile as // `errored` to indicate that we have no data for it. // If the world wraps, we may have multiple "wrapped" copies of the // single tile. if (this.tileID && this.tileID.equals(tile.tileID.canonical)) { this.tiles[String(tile.tileID.wrap)] = tile; tile.buckets = {}; } else { tile.state = 'errored'; } }); } serialize() { return { type: 'image', url: this.options.url, coordinates: this.coordinates }; } hasTransition() { return false; } } /** * Given a list of coordinates, get their center as a coordinate. * * @returns centerpoint * @internal */ function getCoordinatesCenterTileID(coords) { let minX = Infinity; let minY = Infinity; let maxX = -Infinity; let maxY = -Infinity; for (const coord of coords) { minX = Math.min(minX, coord.x); minY = Math.min(minY, coord.y); maxX = Math.max(maxX, coord.x); maxY = Math.max(maxY, coord.y); } const dx = maxX - minX; const dy = maxY - minY; const dMax = Math.max(dx, dy); const zoom = Math.max(0, Math.floor(-Math.log(dMax) / Math.LN2)); const tilesAtZoom = Math.pow(2, zoom); return new CanonicalTileID(zoom, Math.floor((minX + maxX) / 2 * tilesAtZoom), Math.floor((minY + maxY) / 2 * tilesAtZoom)); } /** * A data source containing video. * (See the [Style Specification](https://maplibre.org/maplibre-style-spec/#sources-video) for detailed documentation of options.) * * @group Sources * * @example * ```ts * // add to map * map.addSource('some id', { * type: 'video', * url: [ * 'https://www.mapbox.com/blog/assets/baltimore-smoke.mp4', * 'https://www.mapbox.com/blog/assets/baltimore-smoke.webm' * ], * coordinates: [ * [-76.54, 39.18], * [-76.52, 39.18], * [-76.52, 39.17], * [-76.54, 39.17] * ] * }); * * // update * let mySource = map.getSource('some id'); * mySource.setCoordinates([ * [-76.54335737228394, 39.18579907229748], * [-76.52803659439087, 39.1838364847587], * [-76.5295386314392, 39.17683392507606], * [-76.54520273208618, 39.17876344106642] * ]); * * map.removeSource('some id'); // remove * ``` * @see [Add a video](https://maplibre.org/maplibre-gl-js/docs/examples/video-on-a-map/) * * Note that when rendered as a raster layer, the layer's `raster-fade-duration` property will cause the video to fade in. * This happens when playback is started, paused and resumed, or when the video's coordinates are updated. To avoid this behavior, * set the layer's `raster-fade-duration` property to `0`. */ class VideoSource extends ImageSource { constructor(id, options, dispatcher, eventedParent) { super(id, options, dispatcher, eventedParent); this.roundZoom = true; this.type = 'video'; this.options = options; } load() { return __awaiter(this, void 0, void 0, function* () { this._loaded = false; const options = this.options; this.urls = []; for (const url of options.urls) { this.urls.push(this.map._requestManager.transformRequest(url, "Source" /* ResourceType.Source */).url); } try { const video = yield getVideo(this.urls); this._loaded = true; if (!video) { return; } this.video = video; this.video.loop = true; // Start repainting when video starts playing. hasTransition() will then return // true to trigger additional frames as long as the videos continues playing. this.video.addEventListener('playing', () => { this.map.triggerRepaint(); }); if (this.map) { this.video.play(); } this._finishLoading(); } catch (err) { this.fire(new ErrorEvent(err)); } }); } /** * Pauses the video. */ pause() { if (this.video) { this.video.pause(); } } /** * Plays the video. */ play() { if (this.video) { this.video.play(); } } /** * Sets playback to a timestamp, in seconds. */ seek(seconds) { if (this.video) { const seekableRange = this.video.seekable; if (seconds < seekableRange.start(0) || seconds > seekableRange.end(0)) { this.fire(new ErrorEvent(new ValidationError(`sources.${this.id}`, null, `Playback for this video can be set only between the ${seekableRange.start(0)} and ${seekableRange.end(0)}-second mark.`))); } else this.video.currentTime = seconds; } } /** * Returns the HTML `video` element. * * @returns The HTML `video` element. */ getVideo() { return this.video; } onAdd(map) { if (this.map) return; this.map = map; this.load(); if (this.video) { this.video.play(); this.setCoordinates(this.coordinates); } } /** * Sets the video's coordinates and re-renders the map. */ prepare() { if (Object.keys(this.tiles).length === 0 || this.video.readyState < 2) { return; // not enough data for current position } const context = this.map.painter.context; const gl = context.gl; if (!this.boundsBuffer) { this.boundsBuffer = context.createVertexBuffer(this._boundsArray, rasterBoundsAttributes.members); } if (!this.boundsSegments) { this.boundsSegments = SegmentVector.simpleSegment(0, 0, 4, 2); } if (!this.texture) { this.texture = new Texture(context, this.video, gl.RGBA); this.texture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); } else if (!this.video.paused) { this.texture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, gl.RGBA, gl.UNSIGNED_BYTE, this.video); } let newTilesLoaded = false; for (const w in this.tiles) { const tile = this.tiles[w]; if (tile.state !== 'loaded') { tile.state = 'loaded'; tile.texture = this.texture; newTilesLoaded = true; } } if (newTilesLoaded) { this.fire(new Event('data', { dataType: 'source', sourceDataType: 'idle', sourceId: this.id })); } } serialize() { return { type: 'video', urls: this.urls, coordinates: this.coordinates }; } hasTransition() { return this.video && !this.video.paused; } } /** * A data source containing the contents of an HTML canvas. See {@link CanvasSourceSpecification} for detailed documentation of options. * * @group Sources * * @example * ```ts * // add to map * map.addSource('some id', { * type: 'canvas', * canvas: 'idOfMyHTMLCanvas', * animate: true, * coordinates: [ * [-76.54, 39.18], * [-76.52, 39.18], * [-76.52, 39.17], * [-76.54, 39.17] * ] * }); * * // update * let mySource = map.getSource('some id'); * mySource.setCoordinates([ * [-76.54335737228394, 39.18579907229748], * [-76.52803659439087, 39.1838364847587], * [-76.5295386314392, 39.17683392507606], * [-76.54520273208618, 39.17876344106642] * ]); * * map.removeSource('some id'); // remove * ``` */ class CanvasSource extends ImageSource { /** @internal */ constructor(id, options, dispatcher, eventedParent) { super(id, options, dispatcher, eventedParent); // We build in some validation here, since canvas sources aren't included in the style spec: if (!options.coordinates) { this.fire(new ErrorEvent(new ValidationError(`sources.${id}`, null, 'missing required property "coordinates"'))); } else if (!Array.isArray(options.coordinates) || options.coordinates.length !== 4 || options.coordinates.some(c => !Array.isArray(c) || c.length !== 2 || c.some(l => typeof l !== 'number'))) { this.fire(new ErrorEvent(new ValidationError(`sources.${id}`, null, '"coordinates" property must be an array of 4 longitude/latitude array pairs'))); } if (options.animate && typeof options.animate !== 'boolean') { this.fire(new ErrorEvent(new ValidationError(`sources.${id}`, null, 'optional "animate" property must be a boolean value'))); } if (!options.canvas) { this.fire(new ErrorEvent(new ValidationError(`sources.${id}`, null, 'missing required property "canvas"'))); } else if (typeof options.canvas !== 'string' && !(options.canvas instanceof HTMLCanvasElement)) { this.fire(new ErrorEvent(new ValidationError(`sources.${id}`, null, '"canvas" must be either a string representing the ID of the canvas element from which to read, or an HTMLCanvasElement instance'))); } this.options = options; this.animate = options.animate !== undefined ? options.animate : true; } load() { return __awaiter(this, void 0, void 0, function* () { this._loaded = true; if (!this.canvas) { this.canvas = (this.options.canvas instanceof HTMLCanvasElement) ? this.options.canvas : document.getElementById(this.options.canvas); // cast to HTMLCanvasElement in else of ternary // should we do a safety check and throw if it's not actually HTMLCanvasElement? } this.width = this.canvas.width; this.height = this.canvas.height; if (this._hasInvalidDimensions()) { this.fire(new ErrorEvent(new Error('Canvas dimensions cannot be less than or equal to zero.'))); return; } this.play = function () { this._playing = true; this.map.triggerRepaint(); }; this.pause = function () { if (this._playing) { this.prepare(); this._playing = false; } }; this._finishLoading(); }); } /** * Returns the HTML `canvas` element. * * @returns The HTML `canvas` element. */ getCanvas() { return this.canvas; } onAdd(map) { this.map = map; this.load(); if (this.canvas) { if (this.animate) this.play(); } } onRemove() { this.pause(); } prepare() { let resize = false; if (this.canvas.width !== this.width) { this.width = this.canvas.width; resize = true; } if (this.canvas.height !== this.height) { this.height = this.canvas.height; resize = true; } if (this._hasInvalidDimensions()) return; if (Object.keys(this.tiles).length === 0) return; // not enough data for current position const context = this.map.painter.context; const gl = context.gl; if (!this.boundsBuffer) { this.boundsBuffer = context.createVertexBuffer(this._boundsArray, rasterBoundsAttributes.members); } if (!this.boundsSegments) { this.boundsSegments = SegmentVector.simpleSegment(0, 0, 4, 2); } if (!this.texture) { this.texture = new Texture(context, this.canvas, gl.RGBA, { premultiply: true }); } else if (resize || this._playing) { this.texture.update(this.canvas, { premultiply: true }); } let newTilesLoaded = false; for (const w in this.tiles) { const tile = this.tiles[w]; if (tile.state !== 'loaded') { tile.state = 'loaded'; tile.texture = this.texture; newTilesLoaded = true; } } if (newTilesLoaded) { this.fire(new Event('data', { dataType: 'source', sourceDataType: 'idle', sourceId: this.id })); } } serialize() { return { type: 'canvas', coordinates: this.coordinates }; } hasTransition() { return this._playing; } _hasInvalidDimensions() { for (const x of [this.canvas.width, this.canvas.height]) { if (isNaN(x) || x <= 0) return true; } return false; } } const registeredSources = {}; /** * Creates a tiled data source instance given an options object. * * @param id - The id for the source. Must not be used by any existing source. * @param specification - Source options, specific to the source type (except for `options.type`, which is always required). * @param source - A source definition object compliant with * [`maplibre-gl-style-spec`](https://maplibre.org/maplibre-style-spec/#sources) or, for a third-party source type, * with that type's requirements. * @param dispatcher - A {@link Dispatcher} instance, which can be used to send messages to the workers. * @returns a newly created source */ const create = (id, specification, dispatcher, eventedParent) => { const Class = getSourceType(specification.type); const source = new Class(id, specification, dispatcher, eventedParent); if (source.id !== id) { throw new Error(`Expected Source id to be ${id} instead of ${source.id}`); } return source; }; const getSourceType = (name) => { switch (name) { case 'geojson': return GeoJSONSource; case 'image': return ImageSource; case 'raster': return RasterTileSource; case 'raster-dem': return RasterDEMTileSource; case 'vector': return VectorTileSource; case 'video': return VideoSource; case 'canvas': return CanvasSource; } return registeredSources[name]; }; const setSourceType = (name, type) => { registeredSources[name] = type; }; /** * Adds a custom source type, making it available for use with {@link Map#addSource}. * @param name - The name of the source type; source definition objects use this name in the `{type: ...}` field. * @param SourceType - A {@link SourceClass} - which is a constructor for the `Source` interface. * @returns a promise that is resolved when the source type is ready or rejected with an error. */ const addSourceType = (name, SourceType) => __awaiter(void 0, void 0, void 0, function* () { if (getSourceType(name)) { throw new Error(`A source type called "${name}" already exists.`); } setSourceType(name, SourceType); }); function deserialize(input, style) { const output = {}; // Guard against the case where the map's style has been set to null while // this bucket has been parsing. if (!style) return output; for (const bucket of input) { const layers = bucket.layerIds .map((id) => style.getLayer(id)) .filter(Boolean); if (layers.length === 0) { continue; } // look up StyleLayer objects from layer ids (since we don't // want to waste time serializing/copying them from the worker) bucket.layers = layers; if (bucket.stateDependentLayerIds) { bucket.stateDependentLayers = bucket.stateDependentLayerIds.map((lId) => layers.filter((l) => l.id === lId)[0]); } for (const layer of layers) { output[layer.id] = bucket; } } return output; } class DictionaryCoder { constructor(strings) { this._stringToNumber = {}; this._numberToString = []; for (let i = 0; i < strings.length; i++) { const string = strings[i]; this._stringToNumber[string] = i; this._numberToString[i] = string; } } encode(string) { return this._stringToNumber[string]; } decode(n) { if (n >= this._numberToString.length) throw new Error(`Out of bounds. Index requested n=${n} can't be >= this._numberToString.length ${this._numberToString.length}`); return this._numberToString[n]; } } /** * A geojson feature */ class GeoJSONFeature { constructor(vectorTileFeature, z, x, y, id) { this.type = 'Feature'; this._vectorTileFeature = vectorTileFeature; vectorTileFeature._z = z; vectorTileFeature._x = x; vectorTileFeature._y = y; this.properties = vectorTileFeature.properties; this.id = id; } get geometry() { if (this._geometry === undefined) { this._geometry = this._vectorTileFeature.toGeoJSON(this._vectorTileFeature._x, this._vectorTileFeature._y, this._vectorTileFeature._z).geometry; } return this._geometry; } set geometry(g) { this._geometry = g; } toJSON() { const json = { geometry: this.geometry }; for (const i in this) { if (i === '_geometry' || i === '_vectorTileFeature') continue; json[i] = (this)[i]; } return json; } } /** * An in memory index class to allow fast interaction with features */ class FeatureIndex { constructor(tileID, promoteId) { this.tileID = tileID; this.x = tileID.canonical.x; this.y = tileID.canonical.y; this.z = tileID.canonical.z; this.grid = new TransferableGridIndex(EXTENT, 16, 0); this.grid3D = new TransferableGridIndex(EXTENT, 16, 0); this.featureIndexArray = new FeatureIndexArray(); this.promoteId = promoteId; } insert(feature, geometry, featureIndex, sourceLayerIndex, bucketIndex, is3D) { const key = this.featureIndexArray.length; this.featureIndexArray.emplaceBack(featureIndex, sourceLayerIndex, bucketIndex); const grid = is3D ? this.grid3D : this.grid; for (let r = 0; r < geometry.length; r++) { const ring = geometry[r]; const bbox = [Infinity, Infinity, -Infinity, -Infinity]; for (let i = 0; i < ring.length; i++) { const p = ring[i]; bbox[0] = Math.min(bbox[0], p.x); bbox[1] = Math.min(bbox[1], p.y); bbox[2] = Math.max(bbox[2], p.x); bbox[3] = Math.max(bbox[3], p.y); } if (bbox[0] < EXTENT && bbox[1] < EXTENT && bbox[2] >= 0 && bbox[3] >= 0) { grid.insert(key, bbox[0], bbox[1], bbox[2], bbox[3]); } } } loadVTLayers() { if (!this.vtLayers) { this.vtLayers = new vectorTile.VectorTile(new Protobuf(this.rawTileData)).layers; this.sourceLayerCoder = new DictionaryCoder(this.vtLayers ? Object.keys(this.vtLayers).sort() : ['_geojsonTileLayer']); } return this.vtLayers; } // Finds non-symbol features in this tile at a particular position. query(args, styleLayers, serializedLayers, sourceFeatureState) { this.loadVTLayers(); const params = args.params || {}, pixelsToTileUnits = EXTENT / args.tileSize / args.scale, filter = createFilter(params.filter); const queryGeometry = args.queryGeometry; const queryPadding = args.queryPadding * pixelsToTileUnits; const bounds = getBounds(queryGeometry); const matching = this.grid.query(bounds.minX - queryPadding, bounds.minY - queryPadding, bounds.maxX + queryPadding, bounds.maxY + queryPadding); const cameraBounds = getBounds(args.cameraQueryGeometry); const matching3D = this.grid3D.query(cameraBounds.minX - queryPadding, cameraBounds.minY - queryPadding, cameraBounds.maxX + queryPadding, cameraBounds.maxY + queryPadding, (bx1, by1, bx2, by2) => { return polygonIntersectsBox(args.cameraQueryGeometry, bx1 - queryPadding, by1 - queryPadding, bx2 + queryPadding, by2 + queryPadding); }); for (const key of matching3D) { matching.push(key); } matching.sort(topDownFeatureComparator); const result = {}; let previousIndex; for (let k = 0; k < matching.length; k++) { const index = matching[k]; // don't check the same feature more than once if (index === previousIndex) continue; previousIndex = index; const match = this.featureIndexArray.get(index); let featureGeometry = null; this.loadMatchingFeature(result, match.bucketIndex, match.sourceLayerIndex, match.featureIndex, filter, params.layers, params.availableImages, styleLayers, serializedLayers, sourceFeatureState, (feature, styleLayer, featureState) => { if (!featureGeometry) { featureGeometry = loadGeometry(feature); } return styleLayer.queryIntersectsFeature(queryGeometry, feature, featureState, featureGeometry, this.z, args.transform, pixelsToTileUnits, args.pixelPosMatrix); }); } return result; } loadMatchingFeature(result, bucketIndex, sourceLayerIndex, featureIndex, filter, filterLayerIDs, availableImages, styleLayers, serializedLayers, sourceFeatureState, intersectionTest) { const layerIDs = this.bucketLayerIDs[bucketIndex]; if (filterLayerIDs && !arraysIntersect(filterLayerIDs, layerIDs)) return; const sourceLayerName = this.sourceLayerCoder.decode(sourceLayerIndex); const sourceLayer = this.vtLayers[sourceLayerName]; const feature = sourceLayer.feature(featureIndex); if (filter.needGeometry) { const evaluationFeature = toEvaluationFeature(feature, true); if (!filter.filter(new EvaluationParameters(this.tileID.overscaledZ), evaluationFeature, this.tileID.canonical)) { return; } } else if (!filter.filter(new EvaluationParameters(this.tileID.overscaledZ), feature)) { return; } const id = this.getId(feature, sourceLayerName); for (let l = 0; l < layerIDs.length; l++) { const layerID = layerIDs[l]; if (filterLayerIDs && filterLayerIDs.indexOf(layerID) < 0) { continue; } const styleLayer = styleLayers[layerID]; if (!styleLayer) continue; let featureState = {}; if (id && sourceFeatureState) { // `feature-state` expression evaluation requires feature state to be available featureState = sourceFeatureState.getState(styleLayer.sourceLayer || '_geojsonTileLayer', id); } const serializedLayer = extend({}, serializedLayers[layerID]); serializedLayer.paint = evaluateProperties(serializedLayer.paint, styleLayer.paint, feature, featureState, availableImages); serializedLayer.layout = evaluateProperties(serializedLayer.layout, styleLayer.layout, feature, featureState, availableImages); const intersectionZ = !intersectionTest || intersectionTest(feature, styleLayer, featureState); if (!intersectionZ) { // Only applied for non-symbol features continue; } const geojsonFeature = new GeoJSONFeature(feature, this.z, this.x, this.y, id); geojsonFeature.layer = serializedLayer; let layerResult = result[layerID]; if (layerResult === undefined) { layerResult = result[layerID] = []; } layerResult.push({ featureIndex, feature: geojsonFeature, intersectionZ }); } } // Given a set of symbol indexes that have already been looked up, // return a matching set of GeoJSONFeatures lookupSymbolFeatures(symbolFeatureIndexes, serializedLayers, bucketIndex, sourceLayerIndex, filterSpec, filterLayerIDs, availableImages, styleLayers) { const result = {}; this.loadVTLayers(); const filter = createFilter(filterSpec); for (const symbolFeatureIndex of symbolFeatureIndexes) { this.loadMatchingFeature(result, bucketIndex, sourceLayerIndex, symbolFeatureIndex, filter, filterLayerIDs, availableImages, styleLayers, serializedLayers); } return result; } hasLayer(id) { for (const layerIDs of this.bucketLayerIDs) { for (const layerID of layerIDs) { if (id === layerID) return true; } } return false; } getId(feature, sourceLayerId) { let id = feature.id; if (this.promoteId) { const propName = typeof this.promoteId === 'string' ? this.promoteId : this.promoteId[sourceLayerId]; id = feature.properties[propName]; if (typeof id === 'boolean') id = Number(id); } return id; } } register('FeatureIndex', FeatureIndex, { omit: ['rawTileData', 'sourceLayerCoder'] }); function evaluateProperties(serializedProperties, styleLayerProperties, feature, featureState, availableImages) { return mapObject(serializedProperties, (property, key) => { const prop = styleLayerProperties instanceof PossiblyEvaluated ? styleLayerProperties.get(key) : null; return prop && prop.evaluate ? prop.evaluate(feature, featureState, availableImages) : prop; }); } function getBounds(geometry) { let minX = Infinity; let minY = Infinity; let maxX = -Infinity; let maxY = -Infinity; for (const p of geometry) { minX = Math.min(minX, p.x); minY = Math.min(minY, p.y); maxX = Math.max(maxX, p.x); maxY = Math.max(maxY, p.y); } return { minX, minY, maxX, maxY }; } function topDownFeatureComparator(a, b) { return b - a; } const RTLPluginLoadedEventName = 'RTLPluginLoaded'; class RTLMainThreadPlugin extends Evented { constructor() { super(...arguments); this.status = 'unavailable'; this.url = null; this.dispatcher = getGlobalDispatcher(); } /** Sync RTL plugin state by broadcasting a message to the worker */ _syncState(statusToSend) { this.status = statusToSend; return this.dispatcher.broadcast("SRPS" /* MessageType.syncRTLPluginState */, { pluginStatus: statusToSend, pluginURL: this.url }) .catch((e) => { this.status = 'error'; throw e; }); } /** This one is exposed to outside */ getRTLTextPluginStatus() { return this.status; } clearRTLTextPlugin() { this.status = 'unavailable'; this.url = null; } setRTLTextPlugin(url_1) { return __awaiter(this, arguments, void 0, function* (url, deferred = false) { if (this.url) { // error throw new Error('setRTLTextPlugin cannot be called multiple times.'); } this.url = browser.resolveURL(url); if (!this.url) { throw new Error(`requested url ${url} is invalid`); } if (this.status === 'unavailable') { // from initial state: if (deferred) { this.status = 'deferred'; // fire and forget: in this case it does not need wait for the broadcasting result // it is important to sync the deferred status once because // symbol_bucket will be checking it in worker this._syncState(this.status); } else { return this._requestImport(); } } else if (this.status === 'requested') { return this._requestImport(); } }); } /** Send a message to worker which will import the RTL plugin script */ _requestImport() { return __awaiter(this, void 0, void 0, function* () { // all errors/exceptions will be handled by _syncState yield this._syncState('loading'); this.status = 'loaded'; this.fire(new Event(RTLPluginLoadedEventName)); }); } /** Start a lazy loading process of RTL plugin */ lazyLoad() { if (this.status === 'unavailable') { this.status = 'requested'; } else if (this.status === 'deferred') { this._requestImport(); } } } let rtlMainThreadPlugin = null; function rtlMainThreadPluginFactory() { if (!rtlMainThreadPlugin) { rtlMainThreadPlugin = new RTLMainThreadPlugin(); } return rtlMainThreadPlugin; } const CLOCK_SKEW_RETRY_TIMEOUT = 30000; /** * A tile object is the combination of a Coordinate, which defines * its place, as well as a unique ID and data tracking for its content */ class Tile { /** * @param tileID - the tile ID * @param size - The tile size */ constructor(tileID, size) { this.timeAdded = 0; this.fadeEndTime = 0; this.tileID = tileID; this.uid = uniqueId(); this.uses = 0; this.tileSize = size; this.buckets = {}; this.expirationTime = null; this.queryPadding = 0; this.hasSymbolBuckets = false; this.hasRTLText = false; this.dependencies = {}; this.rtt = []; this.rttCoords = {}; // Counts the number of times a response was already expired when // received. We're using this to add a delay when making a new request // so we don't have to keep retrying immediately in case of a server // serving expired tiles. this.expiredRequestCount = 0; this.state = 'loading'; } registerFadeDuration(duration) { const fadeEndTime = duration + this.timeAdded; if (fadeEndTime < this.fadeEndTime) { return; } this.fadeEndTime = fadeEndTime; } wasRequested() { return this.state === 'errored' || this.state === 'loaded' || this.state === 'reloading'; } clearTextures(painter) { if (this.demTexture) painter.saveTileTexture(this.demTexture); this.demTexture = null; } /** * Given a data object with a 'buffers' property, load it into * this tile's elementGroups and buffers properties and set loaded * to true. If the data is null, like in the case of an empty * GeoJSON tile, no-op but still set loaded to true. * @param data - The data from the worker * @param painter - the painter * @param justReloaded - `true` to just reload */ loadVectorData(data, painter, justReloaded) { if (this.hasData()) { this.unloadVectorData(); } this.state = 'loaded'; // empty GeoJSON tile if (!data) { this.collisionBoxArray = new CollisionBoxArray(); return; } if (data.featureIndex) { this.latestFeatureIndex = data.featureIndex; if (data.rawTileData) { // Only vector tiles have rawTileData, and they won't update it for // 'reloadTile' this.latestRawTileData = data.rawTileData; this.latestFeatureIndex.rawTileData = data.rawTileData; } else if (this.latestRawTileData) { // If rawTileData hasn't updated, hold onto a pointer to the last // one we received this.latestFeatureIndex.rawTileData = this.latestRawTileData; } } this.collisionBoxArray = data.collisionBoxArray; this.buckets = deserialize(data.buckets, painter.style); this.hasSymbolBuckets = false; for (const id in this.buckets) { const bucket = this.buckets[id]; if (bucket instanceof SymbolBucket) { this.hasSymbolBuckets = true; if (justReloaded) { bucket.justReloaded = true; } else { break; } } } this.hasRTLText = false; if (this.hasSymbolBuckets) { for (const id in this.buckets) { const bucket = this.buckets[id]; if (bucket instanceof SymbolBucket) { if (bucket.hasRTLText) { this.hasRTLText = true; rtlMainThreadPluginFactory().lazyLoad(); break; } } } } this.queryPadding = 0; for (const id in this.buckets) { const bucket = this.buckets[id]; this.queryPadding = Math.max(this.queryPadding, painter.style.getLayer(id).queryRadius(bucket)); } if (data.imageAtlas) { this.imageAtlas = data.imageAtlas; } if (data.glyphAtlasImage) { this.glyphAtlasImage = data.glyphAtlasImage; } } /** * Release any data or WebGL resources referenced by this tile. */ unloadVectorData() { for (const id in this.buckets) { this.buckets[id].destroy(); } this.buckets = {}; if (this.imageAtlasTexture) { this.imageAtlasTexture.destroy(); } if (this.imageAtlas) { this.imageAtlas = null; } if (this.glyphAtlasTexture) { this.glyphAtlasTexture.destroy(); } this.latestFeatureIndex = null; this.state = 'unloaded'; } getBucket(layer) { return this.buckets[layer.id]; } upload(context) { for (const id in this.buckets) { const bucket = this.buckets[id]; if (bucket.uploadPending()) { bucket.upload(context); } } const gl = context.gl; if (this.imageAtlas && !this.imageAtlas.uploaded) { this.imageAtlasTexture = new Texture(context, this.imageAtlas.image, gl.RGBA); this.imageAtlas.uploaded = true; } if (this.glyphAtlasImage) { this.glyphAtlasTexture = new Texture(context, this.glyphAtlasImage, gl.ALPHA); this.glyphAtlasImage = null; } } prepare(imageManager) { if (this.imageAtlas) { this.imageAtlas.patchUpdatedImages(imageManager, this.imageAtlasTexture); } } // Queries non-symbol features rendered for this tile. // Symbol features are queried globally queryRenderedFeatures(layers, serializedLayers, sourceFeatureState, queryGeometry, cameraQueryGeometry, scale, params, transform, maxPitchScaleFactor, pixelPosMatrix) { if (!this.latestFeatureIndex || !this.latestFeatureIndex.rawTileData) return {}; return this.latestFeatureIndex.query({ queryGeometry, cameraQueryGeometry, scale, tileSize: this.tileSize, pixelPosMatrix, transform, params, queryPadding: this.queryPadding * maxPitchScaleFactor }, layers, serializedLayers, sourceFeatureState); } querySourceFeatures(result, params) { const featureIndex = this.latestFeatureIndex; if (!featureIndex || !featureIndex.rawTileData) return; const vtLayers = featureIndex.loadVTLayers(); const sourceLayer = params && params.sourceLayer ? params.sourceLayer : ''; const layer = vtLayers._geojsonTileLayer || vtLayers[sourceLayer]; if (!layer) return; const filter = createFilter(params && params.filter); const { z, x, y } = this.tileID.canonical; const coord = { z, x, y }; for (let i = 0; i < layer.length; i++) { const feature = layer.feature(i); if (filter.needGeometry) { const evaluationFeature = toEvaluationFeature(feature, true); if (!filter.filter(new EvaluationParameters(this.tileID.overscaledZ), evaluationFeature, this.tileID.canonical)) continue; } else if (!filter.filter(new EvaluationParameters(this.tileID.overscaledZ), feature)) { continue; } const id = featureIndex.getId(feature, sourceLayer); const geojsonFeature = new GeoJSONFeature(feature, z, x, y, id); geojsonFeature.tile = coord; result.push(geojsonFeature); } } hasData() { return this.state === 'loaded' || this.state === 'reloading' || this.state === 'expired'; } patternsLoaded() { return this.imageAtlas && !!Object.keys(this.imageAtlas.patternPositions).length; } setExpiryData(data) { const prior = this.expirationTime; if (data.cacheControl) { const parsedCC = parseCacheControl(data.cacheControl); if (parsedCC['max-age']) this.expirationTime = Date.now() + parsedCC['max-age'] * 1000; } else if (data.expires) { this.expirationTime = new Date(data.expires).getTime(); } if (this.expirationTime) { const now = Date.now(); let isExpired = false; if (this.expirationTime > now) { isExpired = false; } else if (!prior) { isExpired = true; } else if (this.expirationTime < prior) { // Expiring date is going backwards: // fall back to exponential backoff isExpired = true; } else { const delta = this.expirationTime - prior; if (!delta) { // Server is serving the same expired resource over and over: fall // back to exponential backoff. isExpired = true; } else { // Assume that either the client or the server clock is wrong and // try to interpolate a valid expiration date (from the client POV) // observing a minimum timeout. this.expirationTime = now + Math.max(delta, CLOCK_SKEW_RETRY_TIMEOUT); } } if (isExpired) { this.expiredRequestCount++; this.state = 'expired'; } else { this.expiredRequestCount = 0; } } } getExpiryTimeout() { if (this.expirationTime) { if (this.expiredRequestCount) { return 1000 * (1 << Math.min(this.expiredRequestCount - 1, 31)); } else { // Max value for `setTimeout` implementations is a 32 bit integer; cap this accordingly return Math.min(this.expirationTime - new Date().getTime(), Math.pow(2, 31) - 1); } } } setFeatureState(states, painter) { if (!this.latestFeatureIndex || !this.latestFeatureIndex.rawTileData || Object.keys(states).length === 0) { return; } const vtLayers = this.latestFeatureIndex.loadVTLayers(); for (const id in this.buckets) { if (!painter.style.hasLayer(id)) continue; const bucket = this.buckets[id]; // Buckets are grouped by common source-layer const sourceLayerId = bucket.layers[0]['sourceLayer'] || '_geojsonTileLayer'; const sourceLayer = vtLayers[sourceLayerId]; const sourceLayerStates = states[sourceLayerId]; if (!sourceLayer || !sourceLayerStates || Object.keys(sourceLayerStates).length === 0) continue; bucket.update(sourceLayerStates, sourceLayer, this.imageAtlas && this.imageAtlas.patternPositions || {}); const layer = painter && painter.style && painter.style.getLayer(id); if (layer) { this.queryPadding = Math.max(this.queryPadding, layer.queryRadius(bucket)); } } } holdingForFade() { return this.symbolFadeHoldUntil !== undefined; } symbolFadeFinished() { return !this.symbolFadeHoldUntil || this.symbolFadeHoldUntil < browser.now(); } clearFadeHold() { this.symbolFadeHoldUntil = undefined; } setHoldDuration(duration) { this.symbolFadeHoldUntil = browser.now() + duration; } setDependencies(namespace, dependencies) { const index = {}; for (const dep of dependencies) { index[dep] = true; } this.dependencies[namespace] = index; } hasDependency(namespaces, keys) { for (const namespace of namespaces) { const dependencies = this.dependencies[namespace]; if (dependencies) { for (const key of keys) { if (dependencies[key]) { return true; } } } } return false; } } /** * @internal * A [least-recently-used cache](https://en.wikipedia.org/wiki/Cache_algorithms) * with hash lookup made possible by keeping a list of keys in parallel to * an array of dictionary of values */ class TileCache { /** * @param max - number of permitted values * @param onRemove - callback called with items when they expire */ constructor(max, onRemove) { this.max = max; this.onRemove = onRemove; this.reset(); } /** * Clear the cache * * @returns this cache */ reset() { for (const key in this.data) { for (const removedData of this.data[key]) { if (removedData.timeout) clearTimeout(removedData.timeout); this.onRemove(removedData.value); } } this.data = {}; this.order = []; return this; } /** * Add a key, value combination to the cache, trimming its size if this pushes * it over max length. * * @param tileID - lookup key for the item * @param data - tile data * * @returns this cache */ add(tileID, data, expiryTimeout) { const key = tileID.wrapped().key; if (this.data[key] === undefined) { this.data[key] = []; } const dataWrapper = { value: data, timeout: undefined }; if (expiryTimeout !== undefined) { dataWrapper.timeout = setTimeout(() => { this.remove(tileID, dataWrapper); }, expiryTimeout); } this.data[key].push(dataWrapper); this.order.push(key); if (this.order.length > this.max) { const removedData = this._getAndRemoveByKey(this.order[0]); if (removedData) this.onRemove(removedData); } return this; } /** * Determine whether the value attached to `key` is present * * @param tileID - the key to be looked-up * @returns whether the cache has this value */ has(tileID) { return tileID.wrapped().key in this.data; } /** * Get the value attached to a specific key and remove data from cache. * If the key is not found, returns `null` * * @param tileID - the key to look up * @returns the tile data, or null if it isn't found */ getAndRemove(tileID) { if (!this.has(tileID)) { return null; } return this._getAndRemoveByKey(tileID.wrapped().key); } /* * Get and remove the value with the specified key. */ _getAndRemoveByKey(key) { const data = this.data[key].shift(); if (data.timeout) clearTimeout(data.timeout); if (this.data[key].length === 0) { delete this.data[key]; } this.order.splice(this.order.indexOf(key), 1); return data.value; } /* * Get the value with the specified (wrapped tile) key. */ getByKey(key) { const data = this.data[key]; return data ? data[0].value : null; } /** * Get the value attached to a specific key without removing data * from the cache. If the key is not found, returns `null` * * @param tileID - the key to look up * @returns the tile data, or null if it isn't found */ get(tileID) { if (!this.has(tileID)) { return null; } const data = this.data[tileID.wrapped().key][0]; return data.value; } /** * Remove a key/value combination from the cache. * * @param tileID - the key for the pair to delete * @param value - If a value is provided, remove that exact version of the value. * @returns this cache */ remove(tileID, value) { if (!this.has(tileID)) { return this; } const key = tileID.wrapped().key; const dataIndex = value === undefined ? 0 : this.data[key].indexOf(value); const data = this.data[key][dataIndex]; this.data[key].splice(dataIndex, 1); if (data.timeout) clearTimeout(data.timeout); if (this.data[key].length === 0) { delete this.data[key]; } this.onRemove(data.value); this.order.splice(this.order.indexOf(key), 1); return this; } /** * Change the max size of the cache. * * @param max - the max size of the cache * @returns this cache */ setMaxSize(max) { this.max = max; while (this.order.length > this.max) { const removedData = this._getAndRemoveByKey(this.order[0]); if (removedData) this.onRemove(removedData); } return this; } /** * Remove entries that do not pass a filter function. Used for removing * stale tiles from the cache. * * @param filterFn - Determines whether the tile is filtered. If the supplied function returns false, the tile will be filtered out. */ filter(filterFn) { const removed = []; for (const key in this.data) { for (const entry of this.data[key]) { if (!filterFn(entry.value)) { removed.push(entry); } } } for (const r of removed) { this.remove(r.value.tileID, r); } } } /** * @internal * SourceFeatureState manages the state and pending changes * to features in a source, separated by source layer. * stateChanges and deletedStates batch all changes to the tile (updates and removes, respectively) * between coalesce() events. addFeatureState() and removeFeatureState() also update their counterpart's * list of changes, such that coalesce() can apply the proper state changes while agnostic to the order of operations. * In deletedStates, all null's denote complete removal of state at that scope */ class SourceFeatureState { constructor() { this.state = {}; this.stateChanges = {}; this.deletedStates = {}; } updateState(sourceLayer, featureId, newState) { const feature = String(featureId); this.stateChanges[sourceLayer] = this.stateChanges[sourceLayer] || {}; this.stateChanges[sourceLayer][feature] = this.stateChanges[sourceLayer][feature] || {}; extend(this.stateChanges[sourceLayer][feature], newState); if (this.deletedStates[sourceLayer] === null) { this.deletedStates[sourceLayer] = {}; for (const ft in this.state[sourceLayer]) { if (ft !== feature) this.deletedStates[sourceLayer][ft] = null; } } else { const featureDeletionQueued = this.deletedStates[sourceLayer] && this.deletedStates[sourceLayer][feature] === null; if (featureDeletionQueued) { this.deletedStates[sourceLayer][feature] = {}; for (const prop in this.state[sourceLayer][feature]) { if (!newState[prop]) this.deletedStates[sourceLayer][feature][prop] = null; } } else { for (const key in newState) { const deletionInQueue = this.deletedStates[sourceLayer] && this.deletedStates[sourceLayer][feature] && this.deletedStates[sourceLayer][feature][key] === null; if (deletionInQueue) delete this.deletedStates[sourceLayer][feature][key]; } } } } removeFeatureState(sourceLayer, featureId, key) { const sourceLayerDeleted = this.deletedStates[sourceLayer] === null; if (sourceLayerDeleted) return; const feature = String(featureId); this.deletedStates[sourceLayer] = this.deletedStates[sourceLayer] || {}; if (key && featureId !== undefined) { if (this.deletedStates[sourceLayer][feature] !== null) { this.deletedStates[sourceLayer][feature] = this.deletedStates[sourceLayer][feature] || {}; this.deletedStates[sourceLayer][feature][key] = null; } } else if (featureId !== undefined) { const updateInQueue = this.stateChanges[sourceLayer] && this.stateChanges[sourceLayer][feature]; if (updateInQueue) { this.deletedStates[sourceLayer][feature] = {}; for (key in this.stateChanges[sourceLayer][feature]) this.deletedStates[sourceLayer][feature][key] = null; } else { this.deletedStates[sourceLayer][feature] = null; } } else { this.deletedStates[sourceLayer] = null; } } getState(sourceLayer, featureId) { const feature = String(featureId); const base = this.state[sourceLayer] || {}; const changes = this.stateChanges[sourceLayer] || {}; const reconciledState = extend({}, base[feature], changes[feature]); //return empty object if the whole source layer is awaiting deletion if (this.deletedStates[sourceLayer] === null) return {}; else if (this.deletedStates[sourceLayer]) { const featureDeletions = this.deletedStates[sourceLayer][featureId]; if (featureDeletions === null) return {}; for (const prop in featureDeletions) delete reconciledState[prop]; } return reconciledState; } initializeTileState(tile, painter) { tile.setFeatureState(this.state, painter); } coalesceChanges(tiles, painter) { //track changes with full state objects, but only for features that got modified const featuresChanged = {}; for (const sourceLayer in this.stateChanges) { this.state[sourceLayer] = this.state[sourceLayer] || {}; const layerStates = {}; for (const feature in this.stateChanges[sourceLayer]) { if (!this.state[sourceLayer][feature]) this.state[sourceLayer][feature] = {}; extend(this.state[sourceLayer][feature], this.stateChanges[sourceLayer][feature]); layerStates[feature] = this.state[sourceLayer][feature]; } featuresChanged[sourceLayer] = layerStates; } for (const sourceLayer in this.deletedStates) { this.state[sourceLayer] = this.state[sourceLayer] || {}; const layerStates = {}; if (this.deletedStates[sourceLayer] === null) { for (const ft in this.state[sourceLayer]) { layerStates[ft] = {}; this.state[sourceLayer][ft] = {}; } } else { for (const feature in this.deletedStates[sourceLayer]) { const deleteWholeFeatureState = this.deletedStates[sourceLayer][feature] === null; if (deleteWholeFeatureState) this.state[sourceLayer][feature] = {}; else { for (const key of Object.keys(this.deletedStates[sourceLayer][feature])) { delete this.state[sourceLayer][feature][key]; } } layerStates[feature] = this.state[sourceLayer][feature]; } } featuresChanged[sourceLayer] = featuresChanged[sourceLayer] || {}; extend(featuresChanged[sourceLayer], layerStates); } this.stateChanges = {}; this.deletedStates = {}; if (Object.keys(featuresChanged).length === 0) return; for (const id in tiles) { const tile = tiles[id]; tile.setFeatureState(featuresChanged, painter); } } } /** * @internal * `SourceCache` is responsible for * * - creating an instance of `Source` * - forwarding events from `Source` * - caching tiles loaded from an instance of `Source` * - loading the tiles needed to render a given viewport * - unloading the cached tiles not needed to render a given viewport */ class SourceCache extends Evented { constructor(id, options, dispatcher) { super(); this.id = id; this.dispatcher = dispatcher; this.on('data', (e) => this._dataHandler(e)); this.on('dataloading', () => { this._sourceErrored = false; }); this.on('error', () => { // Only set _sourceErrored if the source does not have pending loads. this._sourceErrored = this._source.loaded(); }); this._source = create(id, options, dispatcher, this); this._tiles = {}; this._cache = new TileCache(0, (tile) => this._unloadTile(tile)); this._timers = {}; this._cacheTimers = {}; this._maxTileCacheSize = null; this._maxTileCacheZoomLevels = null; this._loadedParentTiles = {}; this._coveredTiles = {}; this._state = new SourceFeatureState(); this._didEmitContent = false; this._updated = false; } onAdd(map) { this.map = map; this._maxTileCacheSize = map ? map._maxTileCacheSize : null; this._maxTileCacheZoomLevels = map ? map._maxTileCacheZoomLevels : null; if (this._source && this._source.onAdd) { this._source.onAdd(map); } } onRemove(map) { this.clearTiles(); if (this._source && this._source.onRemove) { this._source.onRemove(map); } } /** * Return true if no tile data is pending, tiles will not change unless * an additional API call is received. */ loaded() { if (this._sourceErrored) { return true; } if (!this._sourceLoaded) { return false; } if (!this._source.loaded()) { return false; } if ((this.used !== undefined || this.usedForTerrain !== undefined) && !this.used && !this.usedForTerrain) { return true; } // do not consider as loaded if the update hasn't been called yet (we do not know if we will have any tiles to fetch) if (!this._updated) { return false; } for (const t in this._tiles) { const tile = this._tiles[t]; if (tile.state !== 'loaded' && tile.state !== 'errored') return false; } return true; } getSource() { return this._source; } pause() { this._paused = true; } resume() { if (!this._paused) return; const shouldReload = this._shouldReloadOnResume; this._paused = false; this._shouldReloadOnResume = false; if (shouldReload) this.reload(); if (this.transform) this.update(this.transform, this.terrain); } _loadTile(tile, id, state) { return __awaiter(this, void 0, void 0, function* () { try { yield this._source.loadTile(tile); this._tileLoaded(tile, id, state); } catch (err) { tile.state = 'errored'; if (err.status !== 404) { this._source.fire(new ErrorEvent(err, { tile })); } else { // continue to try loading parent/children tiles if a tile doesn't exist (404) this.update(this.transform, this.terrain); } } }); } _unloadTile(tile) { if (this._source.unloadTile) this._source.unloadTile(tile); } _abortTile(tile) { if (this._source.abortTile) this._source.abortTile(tile); this._source.fire(new Event('dataabort', { tile, coord: tile.tileID, dataType: 'source' })); } serialize() { return this._source.serialize(); } prepare(context) { if (this._source.prepare) { this._source.prepare(); } this._state.coalesceChanges(this._tiles, this.map ? this.map.painter : null); for (const i in this._tiles) { const tile = this._tiles[i]; tile.upload(context); tile.prepare(this.map.style.imageManager); } } /** * Return all tile ids ordered with z-order, and cast to numbers */ getIds() { return Object.values(this._tiles).map((tile) => tile.tileID).sort(compareTileId).map(id => id.key); } getRenderableIds(symbolLayer) { const renderables = []; for (const id in this._tiles) { if (this._isIdRenderable(id, symbolLayer)) renderables.push(this._tiles[id]); } if (symbolLayer) { return renderables.sort((a_, b_) => { const a = a_.tileID; const b = b_.tileID; const rotatedA = (new Point$2(a.canonical.x, a.canonical.y))._rotate(this.transform.angle); const rotatedB = (new Point$2(b.canonical.x, b.canonical.y))._rotate(this.transform.angle); return a.overscaledZ - b.overscaledZ || rotatedB.y - rotatedA.y || rotatedB.x - rotatedA.x; }).map(tile => tile.tileID.key); } return renderables.map(tile => tile.tileID).sort(compareTileId).map(id => id.key); } hasRenderableParent(tileID) { const parentTile = this.findLoadedParent(tileID, 0); if (parentTile) { return this._isIdRenderable(parentTile.tileID.key); } return false; } _isIdRenderable(id, symbolLayer) { return this._tiles[id] && this._tiles[id].hasData() && !this._coveredTiles[id] && (symbolLayer || !this._tiles[id].holdingForFade()); } reload() { if (this._paused) { this._shouldReloadOnResume = true; return; } this._cache.reset(); for (const i in this._tiles) { if (this._tiles[i].state !== 'errored') this._reloadTile(i, 'reloading'); } } _reloadTile(id, state) { return __awaiter(this, void 0, void 0, function* () { const tile = this._tiles[id]; // this potentially does not address all underlying // issues https://github.com/mapbox/mapbox-gl-js/issues/4252 // - hard to tell without repro steps if (!tile) return; // The difference between "loading" tiles and "reloading" or "expired" // tiles is that "reloading"/"expired" tiles are "renderable". // Therefore, a "loading" tile cannot become a "reloading" tile without // first becoming a "loaded" tile. if (tile.state !== 'loading') { tile.state = state; } yield this._loadTile(tile, id, state); }); } _tileLoaded(tile, id, previousState) { tile.timeAdded = browser.now(); if (previousState === 'expired') tile.refreshedUponExpiration = true; this._setTileReloadTimer(id, tile); if (this.getSource().type === 'raster-dem' && tile.dem) this._backfillDEM(tile); this._state.initializeTileState(tile, this.map ? this.map.painter : null); if (!tile.aborted) { this._source.fire(new Event('data', { dataType: 'source', tile, coord: tile.tileID })); } } /** * For raster terrain source, backfill DEM to eliminate visible tile boundaries */ _backfillDEM(tile) { const renderables = this.getRenderableIds(); for (let i = 0; i < renderables.length; i++) { const borderId = renderables[i]; if (tile.neighboringTiles && tile.neighboringTiles[borderId]) { const borderTile = this.getTileByID(borderId); fillBorder(tile, borderTile); fillBorder(borderTile, tile); } } function fillBorder(tile, borderTile) { tile.needsHillshadePrepare = true; tile.needsTerrainPrepare = true; let dx = borderTile.tileID.canonical.x - tile.tileID.canonical.x; const dy = borderTile.tileID.canonical.y - tile.tileID.canonical.y; const dim = Math.pow(2, tile.tileID.canonical.z); const borderId = borderTile.tileID.key; if (dx === 0 && dy === 0) return; if (Math.abs(dy) > 1) { return; } if (Math.abs(dx) > 1) { // Adjust the delta coordinate for world wraparound. if (Math.abs(dx + dim) === 1) { dx += dim; } else if (Math.abs(dx - dim) === 1) { dx -= dim; } } if (!borderTile.dem || !tile.dem) return; tile.dem.backfillBorder(borderTile.dem, dx, dy); if (tile.neighboringTiles && tile.neighboringTiles[borderId]) tile.neighboringTiles[borderId].backfilled = true; } } /** * Get a specific tile by TileID */ getTile(tileID) { return this.getTileByID(tileID.key); } /** * Get a specific tile by id */ getTileByID(id) { return this._tiles[id]; } /** * For a given set of tiles, retain children that are loaded and have a zoom * between `zoom` (exclusive) and `maxCoveringZoom` (inclusive) */ _retainLoadedChildren(idealTiles, zoom, maxCoveringZoom, retain) { for (const id in this._tiles) { let tile = this._tiles[id]; // only consider renderable tiles up to maxCoveringZoom if (retain[id] || !tile.hasData() || tile.tileID.overscaledZ <= zoom || tile.tileID.overscaledZ > maxCoveringZoom) continue; // loop through parents and retain the topmost loaded one if found let topmostLoadedID = tile.tileID; while (tile && tile.tileID.overscaledZ > zoom + 1) { const parentID = tile.tileID.scaledTo(tile.tileID.overscaledZ - 1); tile = this._tiles[parentID.key]; if (tile && tile.hasData()) { topmostLoadedID = parentID; } } // loop through ancestors of the topmost loaded child to see if there's one that needed it let tileID = topmostLoadedID; while (tileID.overscaledZ > zoom) { tileID = tileID.scaledTo(tileID.overscaledZ - 1); if (idealTiles[tileID.key]) { // found a parent that needed a loaded child; retain that child retain[topmostLoadedID.key] = topmostLoadedID; break; } } } } /** * Find a loaded parent of the given tile (up to minCoveringZoom) */ findLoadedParent(tileID, minCoveringZoom) { if (tileID.key in this._loadedParentTiles) { const parent = this._loadedParentTiles[tileID.key]; if (parent && parent.tileID.overscaledZ >= minCoveringZoom) { return parent; } else { return null; } } for (let z = tileID.overscaledZ - 1; z >= minCoveringZoom; z--) { const parentTileID = tileID.scaledTo(z); const tile = this._getLoadedTile(parentTileID); if (tile) { return tile; } } } /** * Find a loaded sibling of the given tile */ findLoadedSibling(tileID) { // If a tile with this ID already exists, return it return this._getLoadedTile(tileID); } _getLoadedTile(tileID) { const tile = this._tiles[tileID.key]; if (tile && tile.hasData()) { return tile; } // TileCache ignores wrap in lookup. const cachedTile = this._cache.getByKey(tileID.wrapped().key); return cachedTile; } /** * Resizes the tile cache based on the current viewport's size * or the maxTileCacheSize option passed during map creation * * Larger viewports use more tiles and need larger caches. Larger viewports * are more likely to be found on devices with more memory and on pages where * the map is more important. */ updateCacheSize(transform) { const widthInTiles = Math.ceil(transform.width / this._source.tileSize) + 1; const heightInTiles = Math.ceil(transform.height / this._source.tileSize) + 1; const approxTilesInView = widthInTiles * heightInTiles; const commonZoomRange = this._maxTileCacheZoomLevels === null ? config.MAX_TILE_CACHE_ZOOM_LEVELS : this._maxTileCacheZoomLevels; const viewDependentMaxSize = Math.floor(approxTilesInView * commonZoomRange); const maxSize = typeof this._maxTileCacheSize === 'number' ? Math.min(this._maxTileCacheSize, viewDependentMaxSize) : viewDependentMaxSize; this._cache.setMaxSize(maxSize); } handleWrapJump(lng) { // On top of the regular z/x/y values, TileIDs have a `wrap` value that specify // which cppy of the world the tile belongs to. For example, at `lng: 10` you // might render z/x/y/0 while at `lng: 370` you would render z/x/y/1. // // When lng values get wrapped (going from `lng: 370` to `long: 10`) you expect // to see the same thing on the screen (370 degrees and 10 degrees is the same // place in the world) but all the TileIDs will have different wrap values. // // In order to make this transition seamless, we calculate the rounded difference of // "worlds" between the last frame and the current frame. If the map panned by // a world, then we can assign all the tiles new TileIDs with updated wrap values. // For example, assign z/x/y/1 a new id: z/x/y/0. It is the same tile, just rendered // in a different position. // // This enables us to reuse the tiles at more ideal locations and prevent flickering. const prevLng = this._prevLng === undefined ? lng : this._prevLng; const lngDifference = lng - prevLng; const worldDifference = lngDifference / 360; const wrapDelta = Math.round(worldDifference); this._prevLng = lng; if (wrapDelta) { const tiles = {}; for (const key in this._tiles) { const tile = this._tiles[key]; tile.tileID = tile.tileID.unwrapTo(tile.tileID.wrap + wrapDelta); tiles[tile.tileID.key] = tile; } this._tiles = tiles; // Reset tile reload timers for (const id in this._timers) { clearTimeout(this._timers[id]); delete this._timers[id]; } for (const id in this._tiles) { const tile = this._tiles[id]; this._setTileReloadTimer(id, tile); } } } _updateCoveredAndRetainedTiles(retain, minCoveringZoom, maxCoveringZoom, zoom, idealTileIDs, terrain) { const tilesForFading = {}; const fadingTiles = {}; const ids = Object.keys(retain); const now = browser.now(); for (const id of ids) { const tileID = retain[id]; const tile = this._tiles[id]; // when fadeEndTime is 0, the tile is created but registerFadeDuration // has not been called, therefore must be kept in fadingTiles dictionary // for next round of rendering if (!tile || (tile.fadeEndTime !== 0 && tile.fadeEndTime <= now)) { continue; } // if the tile is loaded but still fading in, find parents to cross-fade with it const parentTile = this.findLoadedParent(tileID, minCoveringZoom); const siblingTile = this.findLoadedSibling(tileID); const fadeTileRef = parentTile || siblingTile || null; if (fadeTileRef) { this._addTile(fadeTileRef.tileID); tilesForFading[fadeTileRef.tileID.key] = fadeTileRef.tileID; } fadingTiles[id] = tileID; } // for tiles that are still fading in, also find children to cross-fade with this._retainLoadedChildren(fadingTiles, zoom, maxCoveringZoom, retain); for (const id in tilesForFading) { if (!retain[id]) { // If a tile is only needed for fading, mark it as covered so that it isn't rendered on it's own. this._coveredTiles[id] = true; retain[id] = tilesForFading[id]; } } // disable fading logic in terrain3D mode to avoid rendering two tiles on the same place if (terrain) { const idealRasterTileIDs = {}; const missingTileIDs = {}; for (const tileID of idealTileIDs) { if (this._tiles[tileID.key].hasData()) idealRasterTileIDs[tileID.key] = tileID; else missingTileIDs[tileID.key] = tileID; } // search for a complete set of children for each missing tile for (const key in missingTileIDs) { const children = missingTileIDs[key].children(this._source.maxzoom); if (this._tiles[children[0].key] && this._tiles[children[1].key] && this._tiles[children[2].key] && this._tiles[children[3].key]) { idealRasterTileIDs[children[0].key] = retain[children[0].key] = children[0]; idealRasterTileIDs[children[1].key] = retain[children[1].key] = children[1]; idealRasterTileIDs[children[2].key] = retain[children[2].key] = children[2]; idealRasterTileIDs[children[3].key] = retain[children[3].key] = children[3]; delete missingTileIDs[key]; } } // search for parent or sibling for each missing tile for (const key in missingTileIDs) { const tileID = missingTileIDs[key]; const parentTile = this.findLoadedParent(tileID, this._source.minzoom); const siblingTile = this.findLoadedSibling(tileID); const fadeTileRef = parentTile || siblingTile || null; if (fadeTileRef) { idealRasterTileIDs[fadeTileRef.tileID.key] = retain[fadeTileRef.tileID.key] = fadeTileRef.tileID; // remove idealTiles which would be rendered twice for (const key in idealRasterTileIDs) { if (idealRasterTileIDs[key].isChildOf(fadeTileRef.tileID)) delete idealRasterTileIDs[key]; } } } // cover all tiles which are not needed for (const key in this._tiles) { if (!idealRasterTileIDs[key]) this._coveredTiles[key] = true; } } } /** * Removes tiles that are outside the viewport and adds new tiles that * are inside the viewport. */ update(transform, terrain) { if (!this._sourceLoaded || this._paused) { return; } this.transform = transform; this.terrain = terrain; this.updateCacheSize(transform); this.handleWrapJump(this.transform.center.lng); // Covered is a list of retained tiles who's areas are fully covered by other, // better, retained tiles. They are not drawn separately. this._coveredTiles = {}; let idealTileIDs; if (!this.used && !this.usedForTerrain) { idealTileIDs = []; } else if (this._source.tileID) { idealTileIDs = transform.getVisibleUnwrappedCoordinates(this._source.tileID) .map((unwrapped) => new OverscaledTileID(unwrapped.canonical.z, unwrapped.wrap, unwrapped.canonical.z, unwrapped.canonical.x, unwrapped.canonical.y)); } else { idealTileIDs = transform.coveringTiles({ tileSize: this.usedForTerrain ? this.tileSize : this._source.tileSize, minzoom: this._source.minzoom, maxzoom: this._source.maxzoom, roundZoom: this.usedForTerrain ? false : this._source.roundZoom, reparseOverscaled: this._source.reparseOverscaled, terrain }); if (this._source.hasTile) { idealTileIDs = idealTileIDs.filter((coord) => this._source.hasTile(coord)); } } // Determine the overzooming/underzooming amounts. const zoom = transform.coveringZoomLevel(this._source); const minCoveringZoom = Math.max(zoom - SourceCache.maxOverzooming, this._source.minzoom); const maxCoveringZoom = Math.max(zoom + SourceCache.maxUnderzooming, this._source.minzoom); // When sourcecache is used for terrain also load parent tiles to avoid flickering when zooming out if (this.usedForTerrain) { const parents = {}; for (const tileID of idealTileIDs) { if (tileID.canonical.z > this._source.minzoom) { const parent = tileID.scaledTo(tileID.canonical.z - 1); parents[parent.key] = parent; // load very low zoom to calculate tile visibility in transform.coveringTiles and high zoomlevels correct const parent2 = tileID.scaledTo(Math.max(this._source.minzoom, Math.min(tileID.canonical.z, 5))); parents[parent2.key] = parent2; } } idealTileIDs = idealTileIDs.concat(Object.values(parents)); } const noPendingDataEmissions = idealTileIDs.length === 0 && !this._updated && this._didEmitContent; this._updated = true; // if we won't have any tiles to fetch and content is already emitted // there will be no more data emissions, so we need to emit the event with isSourceLoaded = true if (noPendingDataEmissions) { this.fire(new Event('data', { sourceDataType: 'idle', dataType: 'source', sourceId: this.id })); } // Retain is a list of tiles that we shouldn't delete, even if they are not // the most ideal tile for the current viewport. This may include tiles like // parent or child tiles that are *already* loaded. const retain = this._updateRetainedTiles(idealTileIDs, zoom); if (isRasterType(this._source.type)) { this._updateCoveredAndRetainedTiles(retain, minCoveringZoom, maxCoveringZoom, zoom, idealTileIDs, terrain); } for (const retainedId in retain) { // Make sure retained tiles always clear any existing fade holds // so that if they're removed again their fade timer starts fresh. this._tiles[retainedId].clearFadeHold(); } // Remove the tiles we don't need anymore. const remove = keysDifference(this._tiles, retain); for (const tileID of remove) { const tile = this._tiles[tileID]; if (tile.hasSymbolBuckets && !tile.holdingForFade()) { tile.setHoldDuration(this.map._fadeDuration); } else if (!tile.hasSymbolBuckets || tile.symbolFadeFinished()) { this._removeTile(tileID); } } // Construct caches of loaded parents & siblings this._updateLoadedParentTileCache(); this._updateLoadedSiblingTileCache(); } releaseSymbolFadeTiles() { for (const id in this._tiles) { if (this._tiles[id].holdingForFade()) { this._removeTile(id); } } } _updateRetainedTiles(idealTileIDs, zoom) { var _a; const retain = {}; const checked = {}; const minCoveringZoom = Math.max(zoom - SourceCache.maxOverzooming, this._source.minzoom); const maxCoveringZoom = Math.max(zoom + SourceCache.maxUnderzooming, this._source.minzoom); const missingTiles = {}; for (const tileID of idealTileIDs) { const tile = this._addTile(tileID); // retain the tile even if it's not loaded because it's an ideal tile. retain[tileID.key] = tileID; if (tile.hasData()) continue; if (zoom < this._source.maxzoom) { // save missing tiles that potentially have loaded children missingTiles[tileID.key] = tileID; } } // retain any loaded children of ideal tiles up to maxCoveringZoom this._retainLoadedChildren(missingTiles, zoom, maxCoveringZoom, retain); for (const tileID of idealTileIDs) { let tile = this._tiles[tileID.key]; if (tile.hasData()) continue; // The tile we require is not yet loaded or does not exist; // Attempt to find children that fully cover it. if (zoom + 1 > this._source.maxzoom) { // We're looking for an overzoomed child tile. const childCoord = tileID.children(this._source.maxzoom)[0]; const childTile = this.getTile(childCoord); if (!!childTile && childTile.hasData()) { retain[childCoord.key] = childCoord; continue; // tile is covered by overzoomed child } } else { // check if all 4 immediate children are loaded (i.e. the missing ideal tile is covered) const children = tileID.children(this._source.maxzoom); if (retain[children[0].key] && retain[children[1].key] && retain[children[2].key] && retain[children[3].key]) continue; // tile is covered by children } // We couldn't find child tiles that entirely cover the ideal tile; look for parents now. // As we ascend up the tile pyramid of the ideal tile, we check whether the parent // tile has been previously requested (and errored because we only loop over tiles with no data) // in order to determine if we need to request its parent. let parentWasRequested = tile.wasRequested(); for (let overscaledZ = tileID.overscaledZ - 1; overscaledZ >= minCoveringZoom; --overscaledZ) { const parentId = tileID.scaledTo(overscaledZ); // Break parent tile ascent if this route has been previously checked by another child. if (checked[parentId.key]) break; checked[parentId.key] = true; tile = this.getTile(parentId); if (!tile && parentWasRequested) { tile = this._addTile(parentId); } if (tile) { const hasData = tile.hasData(); if (hasData || !((_a = this.map) === null || _a === void 0 ? void 0 : _a.cancelPendingTileRequestsWhileZooming) || parentWasRequested) { retain[parentId.key] = parentId; } // Save the current values, since they're the parent of the next iteration // of the parent tile ascent loop. parentWasRequested = tile.wasRequested(); if (hasData) break; } } } return retain; } _updateLoadedParentTileCache() { this._loadedParentTiles = {}; for (const tileKey in this._tiles) { const path = []; let parentTile; let currentId = this._tiles[tileKey].tileID; // Find the closest loaded ancestor by traversing the tile tree towards the root and // caching results along the way while (currentId.overscaledZ > 0) { // Do we have a cached result from previous traversals? if (currentId.key in this._loadedParentTiles) { parentTile = this._loadedParentTiles[currentId.key]; break; } path.push(currentId.key); // Is the parent loaded? const parentId = currentId.scaledTo(currentId.overscaledZ - 1); parentTile = this._getLoadedTile(parentId); if (parentTile) { break; } currentId = parentId; } // Cache the result of this traversal to all newly visited tiles for (const key of path) { this._loadedParentTiles[key] = parentTile; } } } /** * Update the cache of loaded sibling tiles * * Sibling tiles are tiles that share the same zoom level and * x/y position but have different wrap values * Maintaining sibling tile cache allows fading from old to new tiles * of the same position and zoom level */ _updateLoadedSiblingTileCache() { this._loadedSiblingTiles = {}; for (const tileKey in this._tiles) { const currentId = this._tiles[tileKey].tileID; const siblingTile = this._getLoadedTile(currentId); this._loadedSiblingTiles[currentId.key] = siblingTile; } } /** * Add a tile, given its coordinate, to the pyramid. */ _addTile(tileID) { let tile = this._tiles[tileID.key]; if (tile) return tile; tile = this._cache.getAndRemove(tileID); if (tile) { this._setTileReloadTimer(tileID.key, tile); // set the tileID because the cached tile could have had a different wrap value tile.tileID = tileID; this._state.initializeTileState(tile, this.map ? this.map.painter : null); if (this._cacheTimers[tileID.key]) { clearTimeout(this._cacheTimers[tileID.key]); delete this._cacheTimers[tileID.key]; this._setTileReloadTimer(tileID.key, tile); } } const cached = tile; if (!tile) { tile = new Tile(tileID, this._source.tileSize * tileID.overscaleFactor()); this._loadTile(tile, tileID.key, tile.state); } tile.uses++; this._tiles[tileID.key] = tile; if (!cached) { this._source.fire(new Event('dataloading', { tile, coord: tile.tileID, dataType: 'source' })); } return tile; } _setTileReloadTimer(id, tile) { if (id in this._timers) { clearTimeout(this._timers[id]); delete this._timers[id]; } const expiryTimeout = tile.getExpiryTimeout(); if (expiryTimeout) { this._timers[id] = setTimeout(() => { this._reloadTile(id, 'expired'); delete this._timers[id]; }, expiryTimeout); } } /** * Remove a tile, given its id, from the pyramid */ _removeTile(id) { const tile = this._tiles[id]; if (!tile) return; tile.uses--; delete this._tiles[id]; if (this._timers[id]) { clearTimeout(this._timers[id]); delete this._timers[id]; } if (tile.uses > 0) return; if (tile.hasData() && tile.state !== 'reloading') { this._cache.add(tile.tileID, tile, tile.getExpiryTimeout()); } else { tile.aborted = true; this._abortTile(tile); this._unloadTile(tile); } } /** @internal */ _dataHandler(e) { const eventSourceDataType = e.sourceDataType; if (e.dataType === 'source' && eventSourceDataType === 'metadata') { this._sourceLoaded = true; } // for sources with mutable data, this event fires when the underlying data // to a source is changed. (i.e. GeoJSONSource#setData and ImageSource#serCoordinates) if (this._sourceLoaded && !this._paused && e.dataType === 'source' && eventSourceDataType === 'content') { this.reload(); if (this.transform) { this.update(this.transform, this.terrain); } this._didEmitContent = true; } } /** * Remove all tiles from this pyramid */ clearTiles() { this._shouldReloadOnResume = false; this._paused = false; for (const id in this._tiles) this._removeTile(id); this._cache.reset(); } /** * Search through our current tiles and attempt to find the tiles that * cover the given bounds. * @param pointQueryGeometry - coordinates of the corners of bounding rectangle * @returns result items have `{tile, minX, maxX, minY, maxY}`, where min/max bounding values are the given bounds transformed in into the coordinate space of this tile. */ tilesIn(pointQueryGeometry, maxPitchScaleFactor, has3DLayer) { const tileResults = []; const transform = this.transform; if (!transform) return tileResults; const cameraPointQueryGeometry = has3DLayer ? transform.getCameraQueryGeometry(pointQueryGeometry) : pointQueryGeometry; const queryGeometry = pointQueryGeometry.map((p) => transform.pointCoordinate(p, this.terrain)); const cameraQueryGeometry = cameraPointQueryGeometry.map((p) => transform.pointCoordinate(p, this.terrain)); const ids = this.getIds(); let minX = Infinity; let minY = Infinity; let maxX = -Infinity; let maxY = -Infinity; for (const p of cameraQueryGeometry) { minX = Math.min(minX, p.x); minY = Math.min(minY, p.y); maxX = Math.max(maxX, p.x); maxY = Math.max(maxY, p.y); } for (let i = 0; i < ids.length; i++) { const tile = this._tiles[ids[i]]; if (tile.holdingForFade()) { // Tiles held for fading are covered by tiles that are closer to ideal continue; } const tileID = tile.tileID; const scale = Math.pow(2, transform.zoom - tile.tileID.overscaledZ); const queryPadding = maxPitchScaleFactor * tile.queryPadding * EXTENT / tile.tileSize / scale; const tileSpaceBounds = [ tileID.getTilePoint(new MercatorCoordinate(minX, minY)), tileID.getTilePoint(new MercatorCoordinate(maxX, maxY)) ]; if (tileSpaceBounds[0].x - queryPadding < EXTENT && tileSpaceBounds[0].y - queryPadding < EXTENT && tileSpaceBounds[1].x + queryPadding >= 0 && tileSpaceBounds[1].y + queryPadding >= 0) { const tileSpaceQueryGeometry = queryGeometry.map((c) => tileID.getTilePoint(c)); const tileSpaceCameraQueryGeometry = cameraQueryGeometry.map((c) => tileID.getTilePoint(c)); tileResults.push({ tile, tileID, queryGeometry: tileSpaceQueryGeometry, cameraQueryGeometry: tileSpaceCameraQueryGeometry, scale }); } } return tileResults; } getVisibleCoordinates(symbolLayer) { const coords = this.getRenderableIds(symbolLayer).map((id) => this._tiles[id].tileID); for (const coord of coords) { coord.posMatrix = this.transform.calculatePosMatrix(coord.toUnwrapped()); } return coords; } hasTransition() { if (this._source.hasTransition()) { return true; } if (isRasterType(this._source.type)) { const now = browser.now(); for (const id in this._tiles) { const tile = this._tiles[id]; if (tile.fadeEndTime >= now) { return true; } } } return false; } /** * Set the value of a particular state for a feature */ setFeatureState(sourceLayer, featureId, state) { sourceLayer = sourceLayer || '_geojsonTileLayer'; this._state.updateState(sourceLayer, featureId, state); } /** * Resets the value of a particular state key for a feature */ removeFeatureState(sourceLayer, featureId, key) { sourceLayer = sourceLayer || '_geojsonTileLayer'; this._state.removeFeatureState(sourceLayer, featureId, key); } /** * Get the entire state object for a feature */ getFeatureState(sourceLayer, featureId) { sourceLayer = sourceLayer || '_geojsonTileLayer'; return this._state.getState(sourceLayer, featureId); } /** * Sets the set of keys that the tile depends on. This allows tiles to * be reloaded when their dependencies change. */ setDependencies(tileKey, namespace, dependencies) { const tile = this._tiles[tileKey]; if (tile) { tile.setDependencies(namespace, dependencies); } } /** * Reloads all tiles that depend on the given keys. */ reloadTilesForDependencies(namespaces, keys) { for (const id in this._tiles) { const tile = this._tiles[id]; if (tile.hasDependency(namespaces, keys)) { this._reloadTile(id, 'reloading'); } } this._cache.filter(tile => !tile.hasDependency(namespaces, keys)); } } SourceCache.maxOverzooming = 10; SourceCache.maxUnderzooming = 3; function compareTileId(a, b) { // Different copies of the world are sorted based on their distance to the center. // Wrap values are converted to unsigned distances by reserving odd number for copies // with negative wrap and even numbers for copies with positive wrap. const aWrap = Math.abs(a.wrap * 2) - +(a.wrap < 0); const bWrap = Math.abs(b.wrap * 2) - +(b.wrap < 0); return a.overscaledZ - b.overscaledZ || bWrap - aWrap || b.canonical.y - a.canonical.y || b.canonical.x - a.canonical.x; } function isRasterType(type) { return type === 'raster' || type === 'image' || type === 'video'; } /** * Returns the part of a multiline that intersects with the provided rectangular box. * * @param lines - the lines to check * @param x1 - the left edge of the box * @param y1 - the top edge of the box * @param x2 - the right edge of the box * @param y2 - the bottom edge of the box * @returns lines */ function clipLine(lines, x1, y1, x2, y2) { const clippedLines = []; for (let l = 0; l < lines.length; l++) { const line = lines[l]; let clippedLine; for (let i = 0; i < line.length - 1; i++) { let p0 = line[i]; let p1 = line[i + 1]; if (p0.x < x1 && p1.x < x1) { continue; } else if (p0.x < x1) { p0 = new Point$2(x1, p0.y + (p1.y - p0.y) * ((x1 - p0.x) / (p1.x - p0.x)))._round(); } else if (p1.x < x1) { p1 = new Point$2(x1, p0.y + (p1.y - p0.y) * ((x1 - p0.x) / (p1.x - p0.x)))._round(); } if (p0.y < y1 && p1.y < y1) { continue; } else if (p0.y < y1) { p0 = new Point$2(p0.x + (p1.x - p0.x) * ((y1 - p0.y) / (p1.y - p0.y)), y1)._round(); } else if (p1.y < y1) { p1 = new Point$2(p0.x + (p1.x - p0.x) * ((y1 - p0.y) / (p1.y - p0.y)), y1)._round(); } if (p0.x >= x2 && p1.x >= x2) { continue; } else if (p0.x >= x2) { p0 = new Point$2(x2, p0.y + (p1.y - p0.y) * ((x2 - p0.x) / (p1.x - p0.x)))._round(); } else if (p1.x >= x2) { p1 = new Point$2(x2, p0.y + (p1.y - p0.y) * ((x2 - p0.x) / (p1.x - p0.x)))._round(); } if (p0.y >= y2 && p1.y >= y2) { continue; } else if (p0.y >= y2) { p0 = new Point$2(p0.x + (p1.x - p0.x) * ((y2 - p0.y) / (p1.y - p0.y)), y2)._round(); } else if (p1.y >= y2) { p1 = new Point$2(p0.x + (p1.x - p0.x) * ((y2 - p0.y) / (p1.y - p0.y)), y2)._round(); } if (!clippedLine || !p0.equals(clippedLine[clippedLine.length - 1])) { clippedLine = [p0]; clippedLines.push(clippedLine); } clippedLine.push(p1); } } return clippedLines; } class PathInterpolator { constructor(points_, padding_) { this.reset(points_, padding_); } reset(points_, padding_) { this.points = points_ || []; // Compute cumulative distance from first point to every other point in the segment. // Last entry in the array is total length of the path this._distances = [0.0]; for (let i = 1; i < this.points.length; i++) { this._distances[i] = this._distances[i - 1] + this.points[i].dist(this.points[i - 1]); } this.length = this._distances[this._distances.length - 1]; this.padding = Math.min(padding_ || 0, this.length * 0.5); this.paddedLength = this.length - this.padding * 2.0; } lerp(t) { if (this.points.length === 1) { return this.points[0]; } t = clamp$1(t, 0, 1); // Find the correct segment [p0, p1] where p0 <= x < p1 let currentIndex = 1; let distOfCurrentIdx = this._distances[currentIndex]; const distToTarget = t * this.paddedLength + this.padding; while (distOfCurrentIdx < distToTarget && currentIndex < this._distances.length) { distOfCurrentIdx = this._distances[++currentIndex]; } // Interpolate between the two points of the segment const idxOfPrevPoint = currentIndex - 1; const distOfPrevIdx = this._distances[idxOfPrevPoint]; const segmentLength = distOfCurrentIdx - distOfPrevIdx; const segmentT = segmentLength > 0 ? (distToTarget - distOfPrevIdx) / segmentLength : 0; return this.points[idxOfPrevPoint].mult(1.0 - segmentT).add(this.points[currentIndex].mult(segmentT)); } } function overlapAllowed(overlapA, overlapB) { let allowed = true; if (overlapA === 'always') { // symbol A using 'always' overlap - allowed to overlap anything. } else if (overlapA === 'never' || overlapB === 'never') { // symbol A using 'never' overlap - can't overlap anything // symbol A using 'cooperative' overlap - can overlap 'always' or 'cooperative' symbol; can't overlap 'never' allowed = false; } return allowed; } /** * @internal * GridIndex is a data structure for testing the intersection of * circles and rectangles in a 2d plane. * It is optimized for rapid insertion and querying. * GridIndex splits the plane into a set of "cells" and keeps track * of which geometries intersect with each cell. At query time, * full geometry comparisons are only done for items that share * at least one cell. As long as the geometries are relatively * uniformly distributed across the plane, this greatly reduces * the number of comparisons necessary. */ class GridIndex { constructor(width, height, cellSize) { const boxCells = this.boxCells = []; const circleCells = this.circleCells = []; // More cells -> fewer geometries to check per cell, but items tend // to be split across more cells. // Sweet spot allows most small items to fit in one cell this.xCellCount = Math.ceil(width / cellSize); this.yCellCount = Math.ceil(height / cellSize); for (let i = 0; i < this.xCellCount * this.yCellCount; i++) { boxCells.push([]); circleCells.push([]); } this.circleKeys = []; this.boxKeys = []; this.bboxes = []; this.circles = []; this.width = width; this.height = height; this.xScale = this.xCellCount / width; this.yScale = this.yCellCount / height; this.boxUid = 0; this.circleUid = 0; } keysLength() { return this.boxKeys.length + this.circleKeys.length; } insert(key, x1, y1, x2, y2) { this._forEachCell(x1, y1, x2, y2, this._insertBoxCell, this.boxUid++); this.boxKeys.push(key); this.bboxes.push(x1); this.bboxes.push(y1); this.bboxes.push(x2); this.bboxes.push(y2); } insertCircle(key, x, y, radius) { // Insert circle into grid for all cells in the circumscribing square // It's more than necessary (by a factor of 4/PI), but fast to insert this._forEachCell(x - radius, y - radius, x + radius, y + radius, this._insertCircleCell, this.circleUid++); this.circleKeys.push(key); this.circles.push(x); this.circles.push(y); this.circles.push(radius); } _insertBoxCell(x1, y1, x2, y2, cellIndex, uid) { this.boxCells[cellIndex].push(uid); } _insertCircleCell(x1, y1, x2, y2, cellIndex, uid) { this.circleCells[cellIndex].push(uid); } _query(x1, y1, x2, y2, hitTest, overlapMode, predicate) { if (x2 < 0 || x1 > this.width || y2 < 0 || y1 > this.height) { return []; } const result = []; if (x1 <= 0 && y1 <= 0 && this.width <= x2 && this.height <= y2) { if (hitTest) { // Covers the entire grid, so collides with everything return [{ key: null, x1, y1, x2, y2 }]; } for (let boxUid = 0; boxUid < this.boxKeys.length; boxUid++) { result.push({ key: this.boxKeys[boxUid], x1: this.bboxes[boxUid * 4], y1: this.bboxes[boxUid * 4 + 1], x2: this.bboxes[boxUid * 4 + 2], y2: this.bboxes[boxUid * 4 + 3] }); } for (let circleUid = 0; circleUid < this.circleKeys.length; circleUid++) { const x = this.circles[circleUid * 3]; const y = this.circles[circleUid * 3 + 1]; const radius = this.circles[circleUid * 3 + 2]; result.push({ key: this.circleKeys[circleUid], x1: x - radius, y1: y - radius, x2: x + radius, y2: y + radius }); } } else { const queryArgs = { hitTest, overlapMode, seenUids: { box: {}, circle: {} } }; this._forEachCell(x1, y1, x2, y2, this._queryCell, result, queryArgs, predicate); } return result; } query(x1, y1, x2, y2) { return this._query(x1, y1, x2, y2, false, null); } hitTest(x1, y1, x2, y2, overlapMode, predicate) { return this._query(x1, y1, x2, y2, true, overlapMode, predicate).length > 0; } hitTestCircle(x, y, radius, overlapMode, predicate) { // Insert circle into grid for all cells in the circumscribing square // It's more than necessary (by a factor of 4/PI), but fast to insert const x1 = x - radius; const x2 = x + radius; const y1 = y - radius; const y2 = y + radius; if (x2 < 0 || x1 > this.width || y2 < 0 || y1 > this.height) { return false; } // Box query early exits if the bounding box is larger than the grid, but we don't do // the equivalent calculation for circle queries because early exit is less likely // and the calculation is more expensive const result = []; const queryArgs = { hitTest: true, overlapMode, circle: { x, y, radius }, seenUids: { box: {}, circle: {} } }; this._forEachCell(x1, y1, x2, y2, this._queryCellCircle, result, queryArgs, predicate); return result.length > 0; } _queryCell(x1, y1, x2, y2, cellIndex, result, queryArgs, predicate) { const { seenUids, hitTest, overlapMode } = queryArgs; const boxCell = this.boxCells[cellIndex]; if (boxCell !== null) { const bboxes = this.bboxes; for (const boxUid of boxCell) { if (!seenUids.box[boxUid]) { seenUids.box[boxUid] = true; const offset = boxUid * 4; const key = this.boxKeys[boxUid]; if ((x1 <= bboxes[offset + 2]) && (y1 <= bboxes[offset + 3]) && (x2 >= bboxes[offset + 0]) && (y2 >= bboxes[offset + 1]) && (!predicate || predicate(key))) { if (!hitTest || !overlapAllowed(overlapMode, key.overlapMode)) { result.push({ key, x1: bboxes[offset], y1: bboxes[offset + 1], x2: bboxes[offset + 2], y2: bboxes[offset + 3] }); if (hitTest) { // true return value stops the query after first match return true; } } } } } } const circleCell = this.circleCells[cellIndex]; if (circleCell !== null) { const circles = this.circles; for (const circleUid of circleCell) { if (!seenUids.circle[circleUid]) { seenUids.circle[circleUid] = true; const offset = circleUid * 3; const key = this.circleKeys[circleUid]; if (this._circleAndRectCollide(circles[offset], circles[offset + 1], circles[offset + 2], x1, y1, x2, y2) && (!predicate || predicate(key))) { if (!hitTest || !overlapAllowed(overlapMode, key.overlapMode)) { const x = circles[offset]; const y = circles[offset + 1]; const radius = circles[offset + 2]; result.push({ key, x1: x - radius, y1: y - radius, x2: x + radius, y2: y + radius }); if (hitTest) { // true return value stops the query after first match return true; } } } } } } // false return to continue query return false; } _queryCellCircle(x1, y1, x2, y2, cellIndex, result, queryArgs, predicate) { const { circle, seenUids, overlapMode } = queryArgs; const boxCell = this.boxCells[cellIndex]; if (boxCell !== null) { const bboxes = this.bboxes; for (const boxUid of boxCell) { if (!seenUids.box[boxUid]) { seenUids.box[boxUid] = true; const offset = boxUid * 4; const key = this.boxKeys[boxUid]; if (this._circleAndRectCollide(circle.x, circle.y, circle.radius, bboxes[offset + 0], bboxes[offset + 1], bboxes[offset + 2], bboxes[offset + 3]) && (!predicate || predicate(key)) && !overlapAllowed(overlapMode, key.overlapMode)) { result.push(true); return true; } } } } const circleCell = this.circleCells[cellIndex]; if (circleCell !== null) { const circles = this.circles; for (const circleUid of circleCell) { if (!seenUids.circle[circleUid]) { seenUids.circle[circleUid] = true; const offset = circleUid * 3; const key = this.circleKeys[circleUid]; if (this._circlesCollide(circles[offset], circles[offset + 1], circles[offset + 2], circle.x, circle.y, circle.radius) && (!predicate || predicate(key)) && !overlapAllowed(overlapMode, key.overlapMode)) { result.push(true); return true; } } } } } _forEachCell(x1, y1, x2, y2, fn, arg1, arg2, predicate) { const cx1 = this._convertToXCellCoord(x1); const cy1 = this._convertToYCellCoord(y1); const cx2 = this._convertToXCellCoord(x2); const cy2 = this._convertToYCellCoord(y2); for (let x = cx1; x <= cx2; x++) { for (let y = cy1; y <= cy2; y++) { const cellIndex = this.xCellCount * y + x; if (fn.call(this, x1, y1, x2, y2, cellIndex, arg1, arg2, predicate)) return; } } } _convertToXCellCoord(x) { return Math.max(0, Math.min(this.xCellCount - 1, Math.floor(x * this.xScale))); } _convertToYCellCoord(y) { return Math.max(0, Math.min(this.yCellCount - 1, Math.floor(y * this.yScale))); } _circlesCollide(x1, y1, r1, x2, y2, r2) { const dx = x2 - x1; const dy = y2 - y1; const bothRadii = r1 + r2; return (bothRadii * bothRadii) > (dx * dx + dy * dy); } _circleAndRectCollide(circleX, circleY, radius, x1, y1, x2, y2) { const halfRectWidth = (x2 - x1) / 2; const distX = Math.abs(circleX - (x1 + halfRectWidth)); if (distX > (halfRectWidth + radius)) { return false; } const halfRectHeight = (y2 - y1) / 2; const distY = Math.abs(circleY - (y1 + halfRectHeight)); if (distY > (halfRectHeight + radius)) { return false; } if (distX <= halfRectWidth || distY <= halfRectHeight) { return true; } const dx = distX - halfRectWidth; const dy = distY - halfRectHeight; return (dx * dx + dy * dy <= (radius * radius)); } } /* * # Overview of coordinate spaces * * ## Tile coordinate spaces * Each label has an anchor. Some labels have corresponding line geometries. * The points for both anchors and lines are stored in tile units. Each tile has it's own * coordinate space going from (0, 0) at the top left to (EXTENT, EXTENT) at the bottom right. * * ## Clip space (GL coordinate space) * At the end of everything, the vertex shader needs to produce a position in clip space, * which is (-1, 1) at the top left and (1, -1) in the bottom right. * In the depth buffer, values are between 0 (near plane) to 1 (far plane). * * ## Map pixel coordinate spaces * Each tile has a pixel coordinate space. It's just the tile units scaled so that one unit is * whatever counts as 1 pixel at the current zoom. * This space is used for pitch-alignment=map, rotation-alignment=map * * ## Rotated map pixel coordinate spaces * Like the above, but rotated so axis of the space are aligned with the viewport instead of the tile. * This space is used for pitch-alignment=map, rotation-alignment=viewport * * ## Viewport pixel coordinate space * (0, 0) is at the top left of the canvas and (pixelWidth, pixelHeight) is at the bottom right corner * of the canvas. This space is used for pitch-alignment=viewport * * * # Vertex projection * It goes roughly like this: * 1. project the anchor and line from tile units into the correct label coordinate space * - map pixel space pitch-alignment=map rotation-alignment=map * - rotated map pixel space pitch-alignment=map rotation-alignment=viewport * - viewport pixel space pitch-alignment=viewport rotation-alignment=* * 2. if the label follows a line, find the point along the line that is the correct distance from the anchor. * 3. add the glyph's corner offset to the point from step 3 * 4. convert from the label coordinate space to clip space * * For horizontal labels we want to do step 1 in the shader for performance reasons (no cpu work). * This is what `u_label_plane_matrix` is used for. * For labels aligned with lines we have to steps 1 and 2 on the cpu since we need access to the line geometry. * This is what `updateLineLabels(...)` does. * Since the conversion is handled on the cpu we just set `u_label_plane_matrix` to an identity matrix. * * Steps 3 and 4 are done in the shaders for all labels. */ /* * Returns a matrix for converting from tile units to the correct label coordinate space. */ function getLabelPlaneMatrix(posMatrix, pitchWithMap, rotateWithMap, transform, pixelsToTileUnits) { const m = create$6(); if (pitchWithMap) { scale$5(m, m, [1 / pixelsToTileUnits, 1 / pixelsToTileUnits, 1]); if (!rotateWithMap) { rotateZ$3(m, m, transform.angle); } } else { multiply$5(m, transform.labelPlaneMatrix, posMatrix); } return m; } /* * Returns a matrix for converting from the correct label coordinate space to clip space. */ function getGlCoordMatrix(posMatrix, pitchWithMap, rotateWithMap, transform, pixelsToTileUnits) { if (pitchWithMap) { const m = clone$5(posMatrix); scale$5(m, m, [pixelsToTileUnits, pixelsToTileUnits, 1]); if (!rotateWithMap) { rotateZ$3(m, m, -transform.angle); } return m; } else { return transform.glCoordMatrix; } } function project(x, y, matrix, getElevation) { let pos; if (getElevation) { // slow because of handle z-index pos = [x, y, getElevation(x, y), 1]; transformMat4$1(pos, pos, matrix); } else { // fast because of ignore z-index pos = [x, y, 0, 1]; xyTransformMat4(pos, pos, matrix); } const w = pos[3]; return { point: new Point$2(pos[0] / w, pos[1] / w), signedDistanceFromCamera: w, isOccluded: false }; } function getPerspectiveRatio(cameraToCenterDistance, signedDistanceFromCamera) { return 0.5 + 0.5 * (cameraToCenterDistance / signedDistanceFromCamera); } function isVisible(p, clippingBuffer) { const inPaddedViewport = (p.x >= -clippingBuffer[0] && p.x <= clippingBuffer[0] && p.y >= -clippingBuffer[1] && p.y <= clippingBuffer[1]); return inPaddedViewport; } /* * Update the `dynamicLayoutVertexBuffer` for the buffer with the correct glyph positions for the current map view. * This is only run on labels that are aligned with lines. Horizontal labels are handled entirely in the shader. */ function updateLineLabels(bucket, posMatrix, painter, isText, labelPlaneMatrix, glCoordMatrix, pitchWithMap, keepUpright, rotateToLine, projection, unwrappedTileID, viewportWidth, viewportHeight, translation, getElevation) { const sizeData = isText ? bucket.textSizeData : bucket.iconSizeData; const partiallyEvaluatedSize = evaluateSizeForZoom(sizeData, painter.transform.zoom); const clippingBuffer = [256 / painter.width * 2 + 1, 256 / painter.height * 2 + 1]; const dynamicLayoutVertexArray = isText ? bucket.text.dynamicLayoutVertexArray : bucket.icon.dynamicLayoutVertexArray; dynamicLayoutVertexArray.clear(); const lineVertexArray = bucket.lineVertexArray; const placedSymbols = isText ? bucket.text.placedSymbolArray : bucket.icon.placedSymbolArray; const aspectRatio = painter.transform.width / painter.transform.height; let useVertical = false; for (let s = 0; s < placedSymbols.length; s++) { const symbol = placedSymbols.get(s); // Don't do calculations for vertical glyphs unless the previous symbol was horizontal // and we determined that vertical glyphs were necessary. // Also don't do calculations for symbols that are collided and fully faded out if (symbol.hidden || symbol.writingMode === WritingMode.vertical && !useVertical) { hideGlyphs(symbol.numGlyphs, dynamicLayoutVertexArray); continue; } // Awkward... but we're counting on the paired "vertical" symbol coming immediately after its horizontal counterpart useVertical = false; const anchorPos = project(symbol.anchorX, symbol.anchorY, posMatrix, getElevation); // Don't bother calculating the correct point for invisible labels. if (!isVisible(anchorPos.point, clippingBuffer)) { hideGlyphs(symbol.numGlyphs, dynamicLayoutVertexArray); continue; } const cameraToAnchorDistance = anchorPos.signedDistanceFromCamera; const perspectiveRatio = getPerspectiveRatio(painter.transform.cameraToCenterDistance, cameraToAnchorDistance); const fontSize = evaluateSizeForFeature(sizeData, partiallyEvaluatedSize, symbol); const pitchScaledFontSize = pitchWithMap ? fontSize / perspectiveRatio : fontSize * perspectiveRatio; const tileAnchorPoint = new Point$2(symbol.anchorX, symbol.anchorY); const projectionCache = { projections: {}, offsets: {}, cachedAnchorPoint: undefined, anyProjectionOccluded: false }; const projectionContext = { getElevation, labelPlaneMatrix, lineVertexArray, pitchWithMap, projectionCache, projection, tileAnchorPoint, unwrappedTileID, width: viewportWidth, height: viewportHeight, translation }; const placeUnflipped = placeGlyphsAlongLine(projectionContext, symbol, pitchScaledFontSize, false /*unflipped*/, keepUpright, posMatrix, glCoordMatrix, bucket.glyphOffsetArray, dynamicLayoutVertexArray, aspectRatio, rotateToLine); useVertical = placeUnflipped.useVertical; if (placeUnflipped.notEnoughRoom || useVertical || (placeUnflipped.needsFlipping && placeGlyphsAlongLine(projectionContext, symbol, pitchScaledFontSize, true /*flipped*/, keepUpright, posMatrix, glCoordMatrix, bucket.glyphOffsetArray, dynamicLayoutVertexArray, aspectRatio, rotateToLine).notEnoughRoom)) { hideGlyphs(symbol.numGlyphs, dynamicLayoutVertexArray); } } if (isText) { bucket.text.dynamicLayoutVertexBuffer.updateData(dynamicLayoutVertexArray); } else { bucket.icon.dynamicLayoutVertexBuffer.updateData(dynamicLayoutVertexArray); } } /* * Place the first and last glyph of a line label, projected to the label plane. * This function is called both during collision detection (to determine the label's size) * and during line label rendering (to make sure the label fits on the line geometry with * the current camera position, which may differ from the position used during collision detection). * * Calling this function has the effect of populating the "projectionCache" with all projected * vertex locations the label will need, making future calls to placeGlyphAlongLine (for all the * intermediate glyphs) much cheaper. * * Returns null if the label can't fit on the geometry */ function placeFirstAndLastGlyph(fontScale, glyphOffsetArray, lineOffsetX, lineOffsetY, flip, symbol, rotateToLine, projectionContext) { const glyphEndIndex = symbol.glyphStartIndex + symbol.numGlyphs; const lineStartIndex = symbol.lineStartIndex; const lineEndIndex = symbol.lineStartIndex + symbol.lineLength; const firstGlyphOffset = glyphOffsetArray.getoffsetX(symbol.glyphStartIndex); const lastGlyphOffset = glyphOffsetArray.getoffsetX(glyphEndIndex - 1); const firstPlacedGlyph = placeGlyphAlongLine(fontScale * firstGlyphOffset, lineOffsetX, lineOffsetY, flip, symbol.segment, lineStartIndex, lineEndIndex, projectionContext, rotateToLine); if (!firstPlacedGlyph) return null; const lastPlacedGlyph = placeGlyphAlongLine(fontScale * lastGlyphOffset, lineOffsetX, lineOffsetY, flip, symbol.segment, lineStartIndex, lineEndIndex, projectionContext, rotateToLine); if (!lastPlacedGlyph) return null; if (projectionContext.projectionCache.anyProjectionOccluded) { return null; } return { first: firstPlacedGlyph, last: lastPlacedGlyph }; } function requiresOrientationChange(writingMode, firstPoint, lastPoint, aspectRatio) { if (writingMode === WritingMode.horizontal) { // On top of choosing whether to flip, choose whether to render this version of the glyphs or the alternate // vertical glyphs. We can't just filter out vertical glyphs in the horizontal range because the horizontal // and vertical versions can have slightly different projections which could lead to angles where both or // neither showed. const rise = Math.abs(lastPoint.y - firstPoint.y); const run = Math.abs(lastPoint.x - firstPoint.x) * aspectRatio; if (rise > run) { return { useVertical: true }; } } if (writingMode === WritingMode.vertical ? firstPoint.y < lastPoint.y : firstPoint.x > lastPoint.x) { // Includes "horizontalOnly" case for labels without vertical glyphs return { needsFlipping: true }; } return null; } /* * Place first and last glyph along the line projected to label plane, and if they fit * iterate through all the intermediate glyphs, calculating their label plane positions * from the projected line. * * Finally, add resulting glyph position calculations to dynamicLayoutVertexArray for * upload to the GPU */ function placeGlyphsAlongLine(projectionContext, symbol, fontSize, flip, keepUpright, posMatrix, glCoordMatrix, glyphOffsetArray, dynamicLayoutVertexArray, aspectRatio, rotateToLine) { const fontScale = fontSize / 24; const lineOffsetX = symbol.lineOffsetX * fontScale; const lineOffsetY = symbol.lineOffsetY * fontScale; let placedGlyphs; if (symbol.numGlyphs > 1) { const glyphEndIndex = symbol.glyphStartIndex + symbol.numGlyphs; const lineStartIndex = symbol.lineStartIndex; const lineEndIndex = symbol.lineStartIndex + symbol.lineLength; // Place the first and the last glyph in the label first, so we can figure out // the overall orientation of the label and determine whether it needs to be flipped in keepUpright mode const firstAndLastGlyph = placeFirstAndLastGlyph(fontScale, glyphOffsetArray, lineOffsetX, lineOffsetY, flip, symbol, rotateToLine, projectionContext); if (!firstAndLastGlyph) { return { notEnoughRoom: true }; } const firstPoint = project(firstAndLastGlyph.first.point.x, firstAndLastGlyph.first.point.y, glCoordMatrix, projectionContext.getElevation).point; const lastPoint = project(firstAndLastGlyph.last.point.x, firstAndLastGlyph.last.point.y, glCoordMatrix, projectionContext.getElevation).point; if (keepUpright && !flip) { const orientationChange = requiresOrientationChange(symbol.writingMode, firstPoint, lastPoint, aspectRatio); if (orientationChange) { return orientationChange; } } placedGlyphs = [firstAndLastGlyph.first]; for (let glyphIndex = symbol.glyphStartIndex + 1; glyphIndex < glyphEndIndex - 1; glyphIndex++) { // Since first and last glyph fit on the line, we're sure that the rest of the glyphs can be placed placedGlyphs.push(placeGlyphAlongLine(fontScale * glyphOffsetArray.getoffsetX(glyphIndex), lineOffsetX, lineOffsetY, flip, symbol.segment, lineStartIndex, lineEndIndex, projectionContext, rotateToLine)); } placedGlyphs.push(firstAndLastGlyph.last); } else { // Only a single glyph to place // So, determine whether to flip based on projected angle of the line segment it's on if (keepUpright && !flip) { const a = project(projectionContext.tileAnchorPoint.x, projectionContext.tileAnchorPoint.y, posMatrix, projectionContext.getElevation).point; const tileVertexIndex = (symbol.lineStartIndex + symbol.segment + 1); const tileSegmentEnd = new Point$2(projectionContext.lineVertexArray.getx(tileVertexIndex), projectionContext.lineVertexArray.gety(tileVertexIndex)); const projectedVertex = project(tileSegmentEnd.x, tileSegmentEnd.y, posMatrix, projectionContext.getElevation); // We know the anchor will be in the viewport, but the end of the line segment may be // behind the plane of the camera, in which case we can use a point at any arbitrary (closer) // point on the segment. const b = (projectedVertex.signedDistanceFromCamera > 0) ? projectedVertex.point : projectTruncatedLineSegmentToLabelPlane(projectionContext.tileAnchorPoint, tileSegmentEnd, a, 1, posMatrix, projectionContext); const orientationChange = requiresOrientationChange(symbol.writingMode, a, b, aspectRatio); if (orientationChange) { return orientationChange; } } const singleGlyph = placeGlyphAlongLine(fontScale * glyphOffsetArray.getoffsetX(symbol.glyphStartIndex), lineOffsetX, lineOffsetY, flip, symbol.segment, symbol.lineStartIndex, symbol.lineStartIndex + symbol.lineLength, projectionContext, rotateToLine); if (!singleGlyph || projectionContext.projectionCache.anyProjectionOccluded) return { notEnoughRoom: true }; placedGlyphs = [singleGlyph]; } for (const glyph of placedGlyphs) { addDynamicAttributes(dynamicLayoutVertexArray, glyph.point, glyph.angle); } return {}; } /** * Takes a line and direction from `previousTilePoint` to `currentTilePoint`, * projects it to *label plane*, * and returns a projected point along this projected line that is `minimumLength` distance away from `previousProjectedPoint`. * @param previousTilePoint - Line start point, in tile coordinates. * @param currentTilePoint - Line end point, in tile coordinates. * @param previousProjectedPoint - Projection of `previousTilePoint` into *label plane*. * @param minimumLength - Distance in the projected space along the line for the returned point. * @param projectionMatrix - Matrix to use during projection. * @param projectionContext - Projection context, used only for terrain's `getElevation`. */ function projectTruncatedLineSegmentToLabelPlane(previousTilePoint, currentTilePoint, previousProjectedPoint, minimumLength, projectionMatrix, projectionContext) { return _projectTruncatedLineSegment(previousTilePoint, currentTilePoint, previousProjectedPoint, minimumLength, projectionMatrix, projectionContext); } /** * Takes a line and direction from `previousTilePoint` to `currentTilePoint`, * projects it to *viewport*, * and returns a projected point along this projected line that is `minimumLength` distance away from `previousProjectedPoint`. * @param previousTilePoint - Line start point, in tile coordinates. * @param currentTilePoint - Line end point, in tile coordinates. * @param previousProjectedPoint - Projection of `previousTilePoint` into *viewport*. * @param minimumLength - Distance in the projected space along the line for the returned point. * @param projectionContext - Projection context, used for terrain's `getElevation`, and either the `labelPlaneMatrix` or the map's special projection (mostly for globe). */ function projectTruncatedLineSegmentToViewport(previousTilePoint, currentTilePoint, previousProjectedPoint, minimumLength, projectionContext) { return _projectTruncatedLineSegment(previousTilePoint, currentTilePoint, previousProjectedPoint, minimumLength, undefined, projectionContext); } /** * Do not use directly, use {@link projectTruncatedLineSegmentToLabelPlane} or {@link projectTruncatedLineSegmentToViewport} instead, * depending on the target space. * * Projects a "virtual" vertex along a line segment. * If `projectionMatrix` is not undefined, does a simple projection using this matrix. * Otherwise, either projects to label plane using the `labelPlaneMatrix` * or projects to viewport using the special map projection (mostly for globe) by calling {@link projectTileCoordinatesToViewport}. */ function _projectTruncatedLineSegment(previousTilePoint, currentTilePoint, previousProjectedPoint, minimumLength, projectionMatrix, projectionContext) { // We are assuming "previousTilePoint" won't project to a point within one unit of the camera plane // If it did, that would mean our label extended all the way out from within the viewport to a (very distant) // point near the plane of the camera. We wouldn't be able to render the label anyway once it crossed the // plane of the camera. const unitVertexToBeProjected = previousTilePoint.add(previousTilePoint.sub(currentTilePoint)._unit()); const projectedUnitVertex = projectionMatrix !== undefined ? project(unitVertexToBeProjected.x, unitVertexToBeProjected.y, projectionMatrix, projectionContext.getElevation).point : projectTileCoordinatesToViewport(unitVertexToBeProjected.x, unitVertexToBeProjected.y, projectionContext).point; const projectedUnitSegment = previousProjectedPoint.sub(projectedUnitVertex); return previousProjectedPoint.add(projectedUnitSegment._mult(minimumLength / projectedUnitSegment.mag())); } /** * Transform a vertex from tile coordinates to label plane coordinates * @param index - index of vertex to project * @param projectionContext - necessary data to project a vertex * @returns the vertex projected to the label plane */ function projectLineVertexToViewport(index, projectionContext, syntheticVertexArgs) { const cache = projectionContext.projectionCache; if (cache.projections[index]) { return cache.projections[index]; } const currentVertex = new Point$2(projectionContext.lineVertexArray.getx(index), projectionContext.lineVertexArray.gety(index)); const projection = projectTileCoordinatesToViewport(currentVertex.x, currentVertex.y, projectionContext); if (projection.signedDistanceFromCamera > 0) { cache.projections[index] = projection.point; cache.anyProjectionOccluded = cache.anyProjectionOccluded || projection.isOccluded; return projection.point; } // The vertex is behind the plane of the camera, so we can't project it // Instead, we'll create a vertex along the line that's far enough to include the glyph const previousLineVertexIndex = index - syntheticVertexArgs.direction; const previousTilePoint = syntheticVertexArgs.distanceFromAnchor === 0 ? projectionContext.tileAnchorPoint : new Point$2(projectionContext.lineVertexArray.getx(previousLineVertexIndex), projectionContext.lineVertexArray.gety(previousLineVertexIndex)); // Don't cache because the new vertex might not be far enough out for future glyphs on the same segment const minimumLength = syntheticVertexArgs.absOffsetX - syntheticVertexArgs.distanceFromAnchor + 1; return projectTruncatedLineSegmentToViewport(previousTilePoint, currentVertex, syntheticVertexArgs.previousVertex, minimumLength, projectionContext); } function projectTileCoordinatesToViewport(x, y, projectionContext) { const translatedX = x + projectionContext.translation[0]; const translatedY = y + projectionContext.translation[1]; let projection; if (!projectionContext.pitchWithMap && projectionContext.projection.useSpecialProjectionForSymbols) { projection = projectionContext.projection.projectTileCoordinates(translatedX, translatedY, projectionContext.unwrappedTileID, projectionContext.getElevation); projection.point.x = (projection.point.x * 0.5 + 0.5) * projectionContext.width; projection.point.y = (-projection.point.y * 0.5 + 0.5) * projectionContext.height; } else { projection = project(translatedX, translatedY, projectionContext.labelPlaneMatrix, projectionContext.getElevation); projection.isOccluded = false; } return projection; } /** * Calculate the normal vector for a line segment * @param segmentVector - will be mutated as a tiny optimization * @param offset - magnitude of resulting vector * @param direction - direction of line traversal * @returns a normal vector from the segment, with magnitude equal to offset amount */ function transformToOffsetNormal(segmentVector, offset, direction) { return segmentVector._unit()._perp()._mult(offset * direction); } /** * Construct offset line segments for the current segment and the next segment, then extend/shrink * the segments until they intersect. If the segments are parallel, then they will touch with no modification. * * @param index - Index of the current vertex * @param prevToCurrentOffsetNormal - Normal vector of the line segment from the previous vertex to the current vertex * @param currentVertex - Current (non-offset) vertex projected to the label plane * @param lineStartIndex - Beginning index for the line this label is on * @param lineEndIndex - End index for the line this label is on * @param offsetPreviousVertex - The previous vertex projected to the label plane, and then offset along the previous segments normal * @param lineOffsetY - Magnitude of the offset * @param projectionContext - Necessary data for tile-to-label-plane projection * @returns The point at which the current and next line segments intersect, once offset and extended/shrunk to their meeting point */ function findOffsetIntersectionPoint(index, prevToCurrentOffsetNormal, currentVertex, lineStartIndex, lineEndIndex, offsetPreviousVertex, lineOffsetY, projectionContext, syntheticVertexArgs) { if (projectionContext.projectionCache.offsets[index]) { return projectionContext.projectionCache.offsets[index]; } const offsetCurrentVertex = currentVertex.add(prevToCurrentOffsetNormal); if (index + syntheticVertexArgs.direction < lineStartIndex || index + syntheticVertexArgs.direction >= lineEndIndex) { // This is the end of the line, no intersection to calculate projectionContext.projectionCache.offsets[index] = offsetCurrentVertex; return offsetCurrentVertex; } // Offset the vertices for the next segment const nextVertex = projectLineVertexToViewport(index + syntheticVertexArgs.direction, projectionContext, syntheticVertexArgs); const currentToNextOffsetNormal = transformToOffsetNormal(nextVertex.sub(currentVertex), lineOffsetY, syntheticVertexArgs.direction); const offsetNextSegmentBegin = currentVertex.add(currentToNextOffsetNormal); const offsetNextSegmentEnd = nextVertex.add(currentToNextOffsetNormal); // find the intersection of these two lines // if the lines are parallel, offsetCurrent/offsetNextBegin will touch projectionContext.projectionCache.offsets[index] = findLineIntersection(offsetPreviousVertex, offsetCurrentVertex, offsetNextSegmentBegin, offsetNextSegmentEnd) || offsetCurrentVertex; return projectionContext.projectionCache.offsets[index]; } /* * Place a single glyph along its line, projected into the label plane, by iterating outward * from the anchor point until the distance traversed in the label plane equals the glyph's * offsetX. Returns null if the glyph can't fit on the line geometry. */ function placeGlyphAlongLine(offsetX, lineOffsetX, lineOffsetY, flip, anchorSegment, lineStartIndex, lineEndIndex, projectionContext, rotateToLine) { const combinedOffsetX = flip ? offsetX - lineOffsetX : offsetX + lineOffsetX; let direction = combinedOffsetX > 0 ? 1 : -1; let angle = 0; if (flip) { // The label needs to be flipped to keep text upright. // Iterate in the reverse direction. direction *= -1; angle = Math.PI; } if (direction < 0) angle += Math.PI; let currentIndex = direction > 0 ? lineStartIndex + anchorSegment : lineStartIndex + anchorSegment + 1; // Project anchor point to proper label plane and cache it let anchorPoint; if (projectionContext.projectionCache.cachedAnchorPoint) { anchorPoint = projectionContext.projectionCache.cachedAnchorPoint; } else { anchorPoint = projectTileCoordinatesToViewport(projectionContext.tileAnchorPoint.x, projectionContext.tileAnchorPoint.y, projectionContext).point; projectionContext.projectionCache.cachedAnchorPoint = anchorPoint; } let currentVertex = anchorPoint; let previousVertex = anchorPoint; // offsetPrev and intersectionPoint are analogous to previousVertex and currentVertex // but if there's a line offset they are calculated in parallel as projection happens let offsetIntersectionPoint; let offsetPreviousVertex; let distanceFromAnchor = 0; let currentSegmentDistance = 0; const absOffsetX = Math.abs(combinedOffsetX); const pathVertices = []; let currentLineSegment; while (distanceFromAnchor + currentSegmentDistance <= absOffsetX) { currentIndex += direction; // offset does not fit on the projected line if (currentIndex < lineStartIndex || currentIndex >= lineEndIndex) return null; // accumulate values from last iteration distanceFromAnchor += currentSegmentDistance; previousVertex = currentVertex; offsetPreviousVertex = offsetIntersectionPoint; const syntheticVertexArgs = { absOffsetX, direction, distanceFromAnchor, previousVertex }; // find next vertex in viewport space currentVertex = projectLineVertexToViewport(currentIndex, projectionContext, syntheticVertexArgs); if (lineOffsetY === 0) { // Store vertices for collision detection and update current segment geometry pathVertices.push(previousVertex); currentLineSegment = currentVertex.sub(previousVertex); } else { // Calculate the offset for this section let prevToCurrentOffsetNormal; const prevToCurrent = currentVertex.sub(previousVertex); if (prevToCurrent.mag() === 0) { // We are starting with our anchor point directly on the vertex, so look one vertex ahead // to calculate a normal const nextVertex = projectLineVertexToViewport(currentIndex + direction, projectionContext, syntheticVertexArgs); prevToCurrentOffsetNormal = transformToOffsetNormal(nextVertex.sub(currentVertex), lineOffsetY, direction); } else { prevToCurrentOffsetNormal = transformToOffsetNormal(prevToCurrent, lineOffsetY, direction); } // Initialize offsetPrev on our first iteration, after that it will be pre-calculated if (!offsetPreviousVertex) offsetPreviousVertex = previousVertex.add(prevToCurrentOffsetNormal); offsetIntersectionPoint = findOffsetIntersectionPoint(currentIndex, prevToCurrentOffsetNormal, currentVertex, lineStartIndex, lineEndIndex, offsetPreviousVertex, lineOffsetY, projectionContext, syntheticVertexArgs); pathVertices.push(offsetPreviousVertex); currentLineSegment = offsetIntersectionPoint.sub(offsetPreviousVertex); } currentSegmentDistance = currentLineSegment.mag(); } // The point is on the current segment. Interpolate to find it. const segmentInterpolationT = (absOffsetX - distanceFromAnchor) / currentSegmentDistance; const p = currentLineSegment._mult(segmentInterpolationT)._add(offsetPreviousVertex || previousVertex); const segmentAngle = angle + Math.atan2(currentVertex.y - previousVertex.y, currentVertex.x - previousVertex.x); pathVertices.push(p); return { point: p, angle: rotateToLine ? segmentAngle : 0.0, path: pathVertices }; } const hiddenGlyphAttributes = new Float32Array([-Infinity, -Infinity, 0, -Infinity, -Infinity, 0, -Infinity, -Infinity, 0, -Infinity, -Infinity, 0]); // Hide them by moving them offscreen. We still need to add them to the buffer // because the dynamic buffer is paired with a static buffer that doesn't get updated. function hideGlyphs(num, dynamicLayoutVertexArray) { for (let i = 0; i < num; i++) { const offset = dynamicLayoutVertexArray.length; dynamicLayoutVertexArray.resize(offset + 4); // Since all hidden glyphs have the same attributes, we can build up the array faster with a single call to Float32Array.set // for each set of four vertices, instead of calling addDynamicAttributes for each vertex. dynamicLayoutVertexArray.float32.set(hiddenGlyphAttributes, offset * 3); } } // For line label layout, we're not using z output and our w input is always 1 // This custom matrix transformation ignores those components to make projection faster function xyTransformMat4(out, a, m) { const x = a[0], y = a[1]; out[0] = m[0] * x + m[4] * y + m[12]; out[1] = m[1] * x + m[5] * y + m[13]; out[3] = m[3] * x + m[7] * y + m[15]; return out; } // When a symbol crosses the edge that causes it to be included in // collision detection, it will cause changes in the symbols around // it. This constant specifies how many pixels to pad the edge of // the viewport for collision detection so that the bulk of the changes // occur offscreen. Making this constant greater increases label // stability, but it's expensive. const viewportPadding = 100; /** * @internal * A collision index used to prevent symbols from overlapping. It keep tracks of * where previous symbols have been placed and is used to check if a new * symbol overlaps with any previously added symbols. * * There are two steps to insertion: first placeCollisionBox/Circles checks if * there's room for a symbol, then insertCollisionBox/Circles actually puts the * symbol in the index. The two step process allows paired symbols to be inserted * together even if they overlap. */ class CollisionIndex { constructor(transform, projection, grid = new GridIndex(transform.width + 2 * viewportPadding, transform.height + 2 * viewportPadding, 25), ignoredGrid = new GridIndex(transform.width + 2 * viewportPadding, transform.height + 2 * viewportPadding, 25)) { this.transform = transform; this.mapProjection = projection; this.grid = grid; this.ignoredGrid = ignoredGrid; this.pitchFactor = Math.cos(transform._pitch) * transform.cameraToCenterDistance; this.screenRightBoundary = transform.width + viewportPadding; this.screenBottomBoundary = transform.height + viewportPadding; this.gridRightBoundary = transform.width + 2 * viewportPadding; this.gridBottomBoundary = transform.height + 2 * viewportPadding; this.perspectiveRatioCutoff = 0.6; } placeCollisionBox(collisionBox, overlapMode, textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translation, collisionGroupPredicate, getElevation, shift) { const x = collisionBox.anchorPointX + translation[0]; const y = collisionBox.anchorPointY + translation[1]; const projectedPoint = this.projectAndGetPerspectiveRatio(posMatrix, x, y, unwrappedTileID, getElevation); const tileToViewport = textPixelRatio * projectedPoint.perspectiveRatio; let projectedBox; if (!pitchWithMap && !rotateWithMap) { // Fast path for common symbols const pointX = projectedPoint.point.x + (shift ? shift.x * tileToViewport : 0); const pointY = projectedPoint.point.y + (shift ? shift.y * tileToViewport : 0); projectedBox = { allPointsOccluded: false, box: [ pointX + collisionBox.x1 * tileToViewport, pointY + collisionBox.y1 * tileToViewport, pointX + collisionBox.x2 * tileToViewport, pointY + collisionBox.y2 * tileToViewport, ] }; } else { projectedBox = this._projectCollisionBox(collisionBox, tileToViewport, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translation, projectedPoint, getElevation, shift); } const [tlX, tlY, brX, brY] = projectedBox.box; const projectionOccluded = this.mapProjection.useSpecialProjectionForSymbols ? (pitchWithMap ? projectedBox.allPointsOccluded : this.mapProjection.isOccluded(x, y, unwrappedTileID)) : false; if (projectionOccluded || projectedPoint.perspectiveRatio < this.perspectiveRatioCutoff || !this.isInsideGrid(tlX, tlY, brX, brY) || (overlapMode !== 'always' && this.grid.hitTest(tlX, tlY, brX, brY, overlapMode, collisionGroupPredicate))) { return { box: [tlX, tlY, brX, brY], placeable: false, offscreen: false }; } return { box: [tlX, tlY, brX, brY], placeable: true, offscreen: this.isOffscreen(tlX, tlY, brX, brY) }; } placeCollisionCircles(overlapMode, symbol, lineVertexArray, glyphOffsetArray, fontSize, posMatrix, unwrappedTileID, labelPlaneMatrix, labelToScreenMatrix, showCollisionCircles, pitchWithMap, collisionGroupPredicate, circlePixelDiameter, textPixelPadding, translation, getElevation) { const placedCollisionCircles = []; const tileUnitAnchorPoint = new Point$2(symbol.anchorX, symbol.anchorY); const perspectiveRatio = this.getPerspectiveRatio(posMatrix, tileUnitAnchorPoint.x, tileUnitAnchorPoint.y, unwrappedTileID, getElevation); const labelPlaneFontSize = pitchWithMap ? fontSize / perspectiveRatio : fontSize * perspectiveRatio; const labelPlaneFontScale = labelPlaneFontSize / ONE_EM; const projectionCache = { projections: {}, offsets: {}, cachedAnchorPoint: undefined, anyProjectionOccluded: false }; const lineOffsetX = symbol.lineOffsetX * labelPlaneFontScale; const lineOffsetY = symbol.lineOffsetY * labelPlaneFontScale; const projectionContext = { getElevation, labelPlaneMatrix, lineVertexArray, pitchWithMap, projectionCache, projection: this.mapProjection, tileAnchorPoint: tileUnitAnchorPoint, unwrappedTileID, width: this.transform.width, height: this.transform.height, translation }; const firstAndLastGlyph = placeFirstAndLastGlyph(labelPlaneFontScale, glyphOffsetArray, lineOffsetX, lineOffsetY, /*flip*/ false, symbol, false, projectionContext); let collisionDetected = false; let inGrid = false; let entirelyOffscreen = true; if (firstAndLastGlyph) { const radius = circlePixelDiameter * 0.5 * perspectiveRatio + textPixelPadding; const screenPlaneMin = new Point$2(-viewportPadding, -viewportPadding); const screenPlaneMax = new Point$2(this.screenRightBoundary, this.screenBottomBoundary); const interpolator = new PathInterpolator(); // Construct a projected path from projected line vertices. Anchor points are ignored and removed const first = firstAndLastGlyph.first; const last = firstAndLastGlyph.last; let projectedPath = []; for (let i = first.path.length - 1; i >= 1; i--) { projectedPath.push(first.path[i]); } for (let i = 1; i < last.path.length; i++) { projectedPath.push(last.path[i]); } // Tolerate a slightly longer distance than one diameter between two adjacent circles const circleDist = radius * 2.5; // The path might need to be converted into screen space if a pitched map is used as the label space if (labelToScreenMatrix) { const screenSpacePath = this.projectPathToScreenSpace(projectedPath, projectionContext, labelToScreenMatrix); // Do not try to place collision circles if even one of the points is behind the camera. // This is a plausible scenario with big camera pitch angles if (screenSpacePath.some(point => point.signedDistanceFromCamera <= 0)) { projectedPath = []; } else { projectedPath = screenSpacePath.map(p => p.point); } } let segments = []; if (projectedPath.length > 0) { // Quickly check if the path is fully inside or outside of the padded collision region. // For overlapping paths we'll only create collision circles for the visible segments const minPoint = projectedPath[0].clone(); const maxPoint = projectedPath[0].clone(); for (let i = 1; i < projectedPath.length; i++) { minPoint.x = Math.min(minPoint.x, projectedPath[i].x); minPoint.y = Math.min(minPoint.y, projectedPath[i].y); maxPoint.x = Math.max(maxPoint.x, projectedPath[i].x); maxPoint.y = Math.max(maxPoint.y, projectedPath[i].y); } if (minPoint.x >= screenPlaneMin.x && maxPoint.x <= screenPlaneMax.x && minPoint.y >= screenPlaneMin.y && maxPoint.y <= screenPlaneMax.y) { // Quad fully visible segments = [projectedPath]; } else if (maxPoint.x < screenPlaneMin.x || minPoint.x > screenPlaneMax.x || maxPoint.y < screenPlaneMin.y || minPoint.y > screenPlaneMax.y) { // Not visible segments = []; } else { segments = clipLine([projectedPath], screenPlaneMin.x, screenPlaneMin.y, screenPlaneMax.x, screenPlaneMax.y); } } for (const seg of segments) { // interpolate positions for collision circles. Add a small padding to both ends of the segment interpolator.reset(seg, radius * 0.25); let numCircles = 0; if (interpolator.length <= 0.5 * radius) { numCircles = 1; } else { numCircles = Math.ceil(interpolator.paddedLength / circleDist) + 1; } for (let i = 0; i < numCircles; i++) { const t = i / Math.max(numCircles - 1, 1); const circlePosition = interpolator.lerp(t); // add viewport padding to the position and perform initial collision check const centerX = circlePosition.x + viewportPadding; const centerY = circlePosition.y + viewportPadding; placedCollisionCircles.push(centerX, centerY, radius, 0); const x1 = centerX - radius; const y1 = centerY - radius; const x2 = centerX + radius; const y2 = centerY + radius; entirelyOffscreen = entirelyOffscreen && this.isOffscreen(x1, y1, x2, y2); inGrid = inGrid || this.isInsideGrid(x1, y1, x2, y2); if (overlapMode !== 'always' && this.grid.hitTestCircle(centerX, centerY, radius, overlapMode, collisionGroupPredicate)) { // Don't early exit if we're showing the debug circles because we still want to calculate // which circles are in use collisionDetected = true; if (!showCollisionCircles) { return { circles: [], offscreen: false, collisionDetected }; } } } } } return { circles: ((!showCollisionCircles && collisionDetected) || !inGrid || perspectiveRatio < this.perspectiveRatioCutoff) ? [] : placedCollisionCircles, offscreen: entirelyOffscreen, collisionDetected }; } projectPathToScreenSpace(projectedPath, projectionContext, labelToScreenMatrix) { return projectedPath.map(p => project(p.x, p.y, labelToScreenMatrix, projectionContext.getElevation)); } /** * Because the geometries in the CollisionIndex are an approximation of the shape of * symbols on the map, we use the CollisionIndex to look up the symbol part of * `queryRenderedFeatures`. */ queryRenderedSymbols(viewportQueryGeometry) { if (viewportQueryGeometry.length === 0 || (this.grid.keysLength() === 0 && this.ignoredGrid.keysLength() === 0)) { return {}; } const query = []; let minX = Infinity; let minY = Infinity; let maxX = -Infinity; let maxY = -Infinity; for (const point of viewportQueryGeometry) { const gridPoint = new Point$2(point.x + viewportPadding, point.y + viewportPadding); minX = Math.min(minX, gridPoint.x); minY = Math.min(minY, gridPoint.y); maxX = Math.max(maxX, gridPoint.x); maxY = Math.max(maxY, gridPoint.y); query.push(gridPoint); } const features = this.grid.query(minX, minY, maxX, maxY) .concat(this.ignoredGrid.query(minX, minY, maxX, maxY)); const seenFeatures = {}; const result = {}; for (const feature of features) { const featureKey = feature.key; // Skip already seen features. if (seenFeatures[featureKey.bucketInstanceId] === undefined) { seenFeatures[featureKey.bucketInstanceId] = {}; } if (seenFeatures[featureKey.bucketInstanceId][featureKey.featureIndex]) { continue; } // Check if query intersects with the feature box // "Collision Circles" for line labels are treated as boxes here // Since there's no actual collision taking place, the circle vs. square // distinction doesn't matter as much, and box geometry is easier // to work with. const bbox = [ new Point$2(feature.x1, feature.y1), new Point$2(feature.x2, feature.y1), new Point$2(feature.x2, feature.y2), new Point$2(feature.x1, feature.y2) ]; if (!polygonIntersectsPolygon(query, bbox)) { continue; } seenFeatures[featureKey.bucketInstanceId][featureKey.featureIndex] = true; if (result[featureKey.bucketInstanceId] === undefined) { result[featureKey.bucketInstanceId] = []; } result[featureKey.bucketInstanceId].push(featureKey.featureIndex); } return result; } insertCollisionBox(collisionBox, overlapMode, ignorePlacement, bucketInstanceId, featureIndex, collisionGroupID) { const grid = ignorePlacement ? this.ignoredGrid : this.grid; const key = { bucketInstanceId, featureIndex, collisionGroupID, overlapMode }; grid.insert(key, collisionBox[0], collisionBox[1], collisionBox[2], collisionBox[3]); } insertCollisionCircles(collisionCircles, overlapMode, ignorePlacement, bucketInstanceId, featureIndex, collisionGroupID) { const grid = ignorePlacement ? this.ignoredGrid : this.grid; const key = { bucketInstanceId, featureIndex, collisionGroupID, overlapMode }; for (let k = 0; k < collisionCircles.length; k += 4) { grid.insertCircle(key, collisionCircles[k], collisionCircles[k + 1], collisionCircles[k + 2]); } } projectAndGetPerspectiveRatio(posMatrix, x, y, _unwrappedTileID, getElevation) { // The code here is duplicated from "projection.ts" for performance. // Code here is subject to change once globe is merged. let pos; if (getElevation) { // slow because of handle z-index pos = [x, y, getElevation(x, y), 1]; transformMat4$1(pos, pos, posMatrix); } else { // fast because of ignore z-index pos = [x, y, 0, 1]; xyTransformMat4(pos, pos, posMatrix); } const w = pos[3]; return { point: new Point$2((((pos[0] / w + 1) / 2) * this.transform.width) + viewportPadding, (((-pos[1] / w + 1) / 2) * this.transform.height) + viewportPadding), // See perspective ratio comment in symbol_sdf.vertex // We're doing collision detection in viewport space so we need // to scale down boxes in the distance perspectiveRatio: 0.5 + 0.5 * (this.transform.cameraToCenterDistance / w), isOccluded: false, signedDistanceFromCamera: w }; } getPerspectiveRatio(posMatrix, x, y, unwrappedTileID, getElevation) { // We don't care about the actual projected point, just its W component. const projected = this.mapProjection.useSpecialProjectionForSymbols ? this.mapProjection.projectTileCoordinates(x, y, unwrappedTileID, getElevation) : project(x, y, posMatrix, getElevation); return 0.5 + 0.5 * (this.transform.cameraToCenterDistance / projected.signedDistanceFromCamera); } isOffscreen(x1, y1, x2, y2) { return x2 < viewportPadding || x1 >= this.screenRightBoundary || y2 < viewportPadding || y1 > this.screenBottomBoundary; } isInsideGrid(x1, y1, x2, y2) { return x2 >= 0 && x1 < this.gridRightBoundary && y2 >= 0 && y1 < this.gridBottomBoundary; } /* * Returns a matrix for transforming collision shapes to viewport coordinate space. * Use this function to render e.g. collision circles on the screen. * example transformation: clipPos = glCoordMatrix * viewportMatrix * circle_pos */ getViewportMatrix() { const m = identity$2([]); translate$1(m, m, [-viewportPadding, -viewportPadding, 0.0]); return m; } /** * Applies all layout+paint properties of the given box in order to find as good approximation of its screen-space bounding box as possible. */ _projectCollisionBox(collisionBox, tileToViewport, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translation, projectedPoint, getElevation, shift) { // These vectors are valid both for screen space viewport-rotation-aligned texts and for pitch-align: map texts that are map-rotation-aligned. let vecEast = new Point$2(1, 0); let vecSouth = new Point$2(0, 1); const translatedAnchor = new Point$2(collisionBox.anchorPointX + translation[0], collisionBox.anchorPointY + translation[1]); if (rotateWithMap && !pitchWithMap) { // Handles screen space texts that are always aligned east-west. const projectedEast = this.projectAndGetPerspectiveRatio(posMatrix, translatedAnchor.x + 1, translatedAnchor.y, unwrappedTileID, getElevation).point; const toEast = projectedEast.sub(projectedPoint.point).unit(); const angle = Math.atan(toEast.y / toEast.x) + (toEast.x < 0 ? Math.PI : 0); const sin = Math.sin(angle); const cos = Math.cos(angle); vecEast = new Point$2(cos, sin); vecSouth = new Point$2(-sin, cos); } else if (!rotateWithMap && pitchWithMap) { // Handles pitch-align: map texts that are always aligned with the viewport's X axis. const angle = -this.transform.angle; const sin = Math.sin(angle); const cos = Math.cos(angle); vecEast = new Point$2(cos, sin); vecSouth = new Point$2(-sin, cos); } // Configuration for screen space offsets let basePoint = projectedPoint.point; let distanceMultiplier = tileToViewport; if (pitchWithMap) { // Configuration for tile space (map-pitch-aligned) offsets basePoint = translatedAnchor; const zoomFraction = this.transform.zoom - Math.floor(this.transform.zoom); distanceMultiplier = Math.pow(2, -zoomFraction); distanceMultiplier *= this.mapProjection.getPitchedTextCorrection(this.transform, translatedAnchor, unwrappedTileID); // This next correction can't be applied when variable anchors are in use. if (!shift) { // Shader applies a perspective size correction, we need to apply the same correction. // For non-pitchWithMap texts, this is handled above by multiplying `textPixelRatio` with `projectedPoint.perspectiveRatio`, // which is equivalent to the non-pitchWithMap branch of the GLSL code. // Here, we compute and apply the pitchWithMap branch. // See the computation of `perspective_ratio` in the symbol vertex shaders for the GLSL code. const distanceRatio = projectedPoint.signedDistanceFromCamera / this.transform.cameraToCenterDistance; const perspectiveRatio = clamp$1(0.5 + 0.5 * distanceRatio, 0.0, 4.0); // Same clamp as what is used in the shader. distanceMultiplier *= perspectiveRatio; } } if (shift) { // Variable anchors are in use basePoint = basePoint.add(vecEast.mult(shift.x * distanceMultiplier)).add(vecSouth.mult(shift.y * distanceMultiplier)); } const offsetXmin = collisionBox.x1 * distanceMultiplier; const offsetXmax = collisionBox.x2 * distanceMultiplier; const offsetXhalf = (offsetXmin + offsetXmax) / 2; const offsetYmin = collisionBox.y1 * distanceMultiplier; const offsetYmax = collisionBox.y2 * distanceMultiplier; const offsetYhalf = (offsetYmin + offsetYmax) / 2; // 0--1--2 // | | // 7 3 // | | // 6--5--4 const offsetsArray = [ { offsetX: offsetXmin, offsetY: offsetYmin }, { offsetX: offsetXhalf, offsetY: offsetYmin }, { offsetX: offsetXmax, offsetY: offsetYmin }, { offsetX: offsetXmax, offsetY: offsetYhalf }, { offsetX: offsetXmax, offsetY: offsetYmax }, { offsetX: offsetXhalf, offsetY: offsetYmax }, { offsetX: offsetXmin, offsetY: offsetYmax }, { offsetX: offsetXmin, offsetY: offsetYhalf } ]; let points = []; for (const { offsetX, offsetY } of offsetsArray) { points.push(new Point$2(basePoint.x + vecEast.x * offsetX + vecSouth.x * offsetY, basePoint.y + vecEast.y * offsetX + vecSouth.y * offsetY)); } // Is any point of the collision shape visible on the globe (on beyond horizon)? let anyPointVisible = false; if (pitchWithMap) { const projected = points.map(p => this.projectAndGetPerspectiveRatio(posMatrix, p.x, p.y, unwrappedTileID, getElevation)); // Is at least one of the projected points NOT behind the horizon? anyPointVisible = projected.some(p => !p.isOccluded); points = projected.map(p => p.point); } else { // Labels that are not pitchWithMap cannot ever hide behind the horizon. anyPointVisible = true; } return { box: getAABB(points), allPointsOccluded: !anyPointVisible }; } } class Anchor extends Point$2 { constructor(x, y, angle, segment) { super(x, y); this.angle = angle; if (segment !== undefined) { this.segment = segment; } } clone() { return new Anchor(this.x, this.y, this.angle, this.segment); } } register('Anchor', Anchor); /** * Labels placed around really sharp angles aren't readable. Check if any * part of the potential label has a combined angle that is too big. * * @param line - The line to check * @param anchor - The point on the line around which the label is anchored. * @param labelLength - The length of the label in geometry units. * @param windowSize - The check fails if the combined angles within a part of the line that is `windowSize` long is too big. * @param maxAngle - The maximum combined angle that any window along the label is allowed to have. * * @returns whether the label should be placed */ function checkMaxAngle(line, anchor, labelLength, windowSize, maxAngle) { // horizontal labels and labels with length 0 always pass if (anchor.segment === undefined || labelLength === 0) return true; let p = anchor; let index = anchor.segment + 1; let anchorDistance = 0; // move backwards along the line to the first segment the label appears on while (anchorDistance > -labelLength / 2) { index--; // there isn't enough room for the label after the beginning of the line if (index < 0) return false; anchorDistance -= line[index].dist(p); p = line[index]; } anchorDistance += line[index].dist(line[index + 1]); index++; // store recent corners and their total angle difference const recentCorners = []; let recentAngleDelta = 0; // move forwards by the length of the label and check angles along the way while (anchorDistance < labelLength / 2) { const prev = line[index - 1]; const current = line[index]; const next = line[index + 1]; // there isn't enough room for the label before the end of the line if (!next) return false; let angleDelta = prev.angleTo(current) - current.angleTo(next); // restrict angle to -pi..pi range angleDelta = Math.abs(((angleDelta + 3 * Math.PI) % (Math.PI * 2)) - Math.PI); recentCorners.push({ distance: anchorDistance, angleDelta }); recentAngleDelta += angleDelta; // remove corners that are far enough away from the list of recent anchors while (anchorDistance - recentCorners[0].distance > windowSize) { recentAngleDelta -= recentCorners.shift().angleDelta; } // the sum of angles within the window area exceeds the maximum allowed value. check fails. if (recentAngleDelta > maxAngle) return false; index++; anchorDistance += current.dist(next); } // no part of the line had an angle greater than the maximum allowed. check passes. return true; } function getLineLength(line) { let lineLength = 0; for (let k = 0; k < line.length - 1; k++) { lineLength += line[k].dist(line[k + 1]); } return lineLength; } function getAngleWindowSize(shapedText, glyphSize, boxScale) { return shapedText ? 3 / 5 * glyphSize * boxScale : 0; } function getShapedLabelLength(shapedText, shapedIcon) { return Math.max(shapedText ? shapedText.right - shapedText.left : 0, shapedIcon ? shapedIcon.right - shapedIcon.left : 0); } function getCenterAnchor(line, maxAngle, shapedText, shapedIcon, glyphSize, boxScale) { 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.number(a.x, b.x, t), y = interpolate.number(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, spacing, maxAngle, shapedText, shapedIcon, glyphSize, boxScale, overscaling, tileExtent) { // Resample a line to get anchor points for labels and check that each // potential label passes text-max-angle check and has enough room 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.number(a.x, b.x, t), y = interpolate.number(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; } // If you have a 10px icon that isn't perfectly aligned to the pixel grid it will cover 11 actual // pixels. The quad needs to be padded to account for this, otherwise they'll look slightly clipped // on one edge in some cases. const border = IMAGE_PADDING; /** * Create the quads used for rendering an icon. */ function getIconQuads(shapedIcon, iconRotate, isSDFIcon, hasIconTextFit) { const quads = []; const image = shapedIcon.image; const pixelRatio = image.pixelRatio; const imageWidth = image.paddedRect.w - 2 * border; const imageHeight = image.paddedRect.h - 2 * border; let icon = { x1: shapedIcon.left, y1: shapedIcon.top, x2: shapedIcon.right, y2: shapedIcon.bottom }; const stretchX = image.stretchX || [[0, imageWidth]]; const stretchY = image.stretchY || [[0, imageHeight]]; const reduceRanges = (sum, range) => sum + range[1] - range[0]; const stretchWidth = stretchX.reduce(reduceRanges, 0); const stretchHeight = stretchY.reduce(reduceRanges, 0); const fixedWidth = imageWidth - stretchWidth; const fixedHeight = imageHeight - stretchHeight; let stretchOffsetX = 0; let stretchContentWidth = stretchWidth; let stretchOffsetY = 0; let stretchContentHeight = stretchHeight; let fixedOffsetX = 0; let fixedContentWidth = fixedWidth; let fixedOffsetY = 0; let fixedContentHeight = fixedHeight; if (image.content && hasIconTextFit) { const content = image.content; const contentWidth = content[2] - content[0]; const contentHeight = content[3] - content[1]; // Constrict content area to fit target aspect ratio if (image.textFitWidth || image.textFitHeight) { icon = applyTextFit(shapedIcon); } stretchOffsetX = sumWithinRange(stretchX, 0, content[0]); stretchOffsetY = sumWithinRange(stretchY, 0, content[1]); stretchContentWidth = sumWithinRange(stretchX, content[0], content[2]); stretchContentHeight = sumWithinRange(stretchY, content[1], content[3]); fixedOffsetX = content[0] - stretchOffsetX; fixedOffsetY = content[1] - stretchOffsetY; fixedContentWidth = contentWidth - stretchContentWidth; fixedContentHeight = contentHeight - stretchContentHeight; } const iconLeft = icon.x1; const iconTop = icon.y1; const iconWidth = icon.x2 - iconLeft; const iconHeight = icon.y2 - iconTop; const makeBox = (left, top, right, bottom) => { const leftEm = getEmOffset(left.stretch - stretchOffsetX, stretchContentWidth, iconWidth, iconLeft); const leftPx = getPxOffset(left.fixed - fixedOffsetX, fixedContentWidth, left.stretch, stretchWidth); const topEm = getEmOffset(top.stretch - stretchOffsetY, stretchContentHeight, iconHeight, iconTop); const topPx = getPxOffset(top.fixed - fixedOffsetY, fixedContentHeight, top.stretch, stretchHeight); const rightEm = getEmOffset(right.stretch - stretchOffsetX, stretchContentWidth, iconWidth, iconLeft); const rightPx = getPxOffset(right.fixed - fixedOffsetX, fixedContentWidth, right.stretch, stretchWidth); const bottomEm = getEmOffset(bottom.stretch - stretchOffsetY, stretchContentHeight, iconHeight, iconTop); const bottomPx = getPxOffset(bottom.fixed - fixedOffsetY, fixedContentHeight, bottom.stretch, stretchHeight); const tl = new Point$2(leftEm, topEm); const tr = new Point$2(rightEm, topEm); const br = new Point$2(rightEm, bottomEm); const bl = new Point$2(leftEm, bottomEm); const pixelOffsetTL = new Point$2(leftPx / pixelRatio, topPx / pixelRatio); const pixelOffsetBR = new Point$2(rightPx / pixelRatio, bottomPx / pixelRatio); const angle = iconRotate * Math.PI / 180; if (angle) { const sin = Math.sin(angle), cos = Math.cos(angle), matrix = [cos, -sin, sin, cos]; tl._matMult(matrix); tr._matMult(matrix); bl._matMult(matrix); br._matMult(matrix); } const x1 = left.stretch + left.fixed; const x2 = right.stretch + right.fixed; const y1 = top.stretch + top.fixed; const y2 = bottom.stretch + bottom.fixed; const subRect = { x: image.paddedRect.x + border + x1, y: image.paddedRect.y + border + y1, w: x2 - x1, h: y2 - y1 }; const minFontScaleX = fixedContentWidth / pixelRatio / iconWidth; const minFontScaleY = fixedContentHeight / pixelRatio / iconHeight; // Icon quad is padded, so texture coordinates also need to be padded. return { tl, tr, bl, br, tex: subRect, writingMode: undefined, glyphOffset: [0, 0], sectionIndex: 0, pixelOffsetTL, pixelOffsetBR, minFontScaleX, minFontScaleY, isSDF: isSDFIcon }; }; if (!hasIconTextFit || (!image.stretchX && !image.stretchY)) { quads.push(makeBox({ fixed: 0, stretch: -1 }, { fixed: 0, stretch: -1 }, { fixed: 0, stretch: imageWidth + 1 }, { fixed: 0, stretch: imageHeight + 1 })); } else { const xCuts = stretchZonesToCuts(stretchX, fixedWidth, stretchWidth); const yCuts = stretchZonesToCuts(stretchY, fixedHeight, stretchHeight); for (let xi = 0; xi < xCuts.length - 1; xi++) { const x1 = xCuts[xi]; const x2 = xCuts[xi + 1]; for (let yi = 0; yi < yCuts.length - 1; yi++) { const y1 = yCuts[yi]; const y2 = yCuts[yi + 1]; quads.push(makeBox(x1, y1, x2, y2)); } } } return quads; } function sumWithinRange(ranges, min, max) { let sum = 0; for (const range of ranges) { sum += Math.max(min, Math.min(max, range[1])) - Math.max(min, Math.min(max, range[0])); } return sum; } function stretchZonesToCuts(stretchZones, fixedSize, stretchSize) { const cuts = [{ fixed: -border, stretch: 0 }]; for (const [c1, c2] of stretchZones) { const last = cuts[cuts.length - 1]; cuts.push({ fixed: c1 - last.stretch, stretch: last.stretch }); cuts.push({ fixed: c1 - last.stretch, stretch: last.stretch + (c2 - c1) }); } cuts.push({ fixed: fixedSize + border, stretch: stretchSize }); return cuts; } function getEmOffset(stretchOffset, stretchSize, iconSize, iconOffset) { return stretchOffset / stretchSize * iconSize + iconOffset; } function getPxOffset(fixedOffset, fixedSize, stretchOffset, stretchSize) { return fixedOffset - fixedSize * stretchOffset / stretchSize; } /** * Create the quads used for rendering a text label. */ function getGlyphQuads(anchor, shaping, textOffset, layer, alongLine, feature, imageMap, allowVerticalPlacement) { const textRotate = layer.layout.get('text-rotate').evaluate(feature, {}) * Math.PI / 180; const quads = []; for (const line of shaping.positionedLines) { for (const positionedGlyph of line.positionedGlyphs) { if (!positionedGlyph.rect) continue; const textureRect = positionedGlyph.rect || {}; // The rects have an additional buffer that is not included in their size. const glyphPadding = 1.0; let rectBuffer = GLYPH_PBF_BORDER + glyphPadding; let isSDF = true; let pixelRatio = 1.0; let lineOffset = 0.0; const rotateVerticalGlyph = (alongLine || allowVerticalPlacement) && positionedGlyph.vertical; const halfAdvance = positionedGlyph.metrics.advance * positionedGlyph.scale / 2; // Align images and scaled glyphs in the middle of a vertical line. if (allowVerticalPlacement && shaping.verticalizable) { const scaledGlyphOffset = (positionedGlyph.scale - 1) * ONE_EM; const imageOffset = (ONE_EM - positionedGlyph.metrics.width * positionedGlyph.scale) / 2; lineOffset = line.lineOffset / 2 - (positionedGlyph.imageName ? -imageOffset : scaledGlyphOffset); } if (positionedGlyph.imageName) { const image = imageMap[positionedGlyph.imageName]; isSDF = image.sdf; pixelRatio = image.pixelRatio; rectBuffer = IMAGE_PADDING / pixelRatio; } const glyphOffset = alongLine ? [positionedGlyph.x + halfAdvance, positionedGlyph.y] : [0, 0]; let builtInOffset = alongLine ? [0, 0] : [positionedGlyph.x + halfAdvance + textOffset[0], positionedGlyph.y + textOffset[1] - lineOffset]; let verticalizedLabelOffset = [0, 0]; if (rotateVerticalGlyph) { // Vertical POI labels that are rotated 90deg CW and whose glyphs must preserve upright orientation // need to be rotated 90deg CCW. After a quad is rotated, it is translated to the original built-in offset. verticalizedLabelOffset = builtInOffset; builtInOffset = [0, 0]; } const textureScale = positionedGlyph.metrics.isDoubleResolution ? 2 : 1; const x1 = (positionedGlyph.metrics.left - rectBuffer) * positionedGlyph.scale - halfAdvance + builtInOffset[0]; const y1 = (-positionedGlyph.metrics.top - rectBuffer) * positionedGlyph.scale + builtInOffset[1]; const x2 = x1 + textureRect.w / textureScale * positionedGlyph.scale / pixelRatio; const y2 = y1 + textureRect.h / textureScale * positionedGlyph.scale / pixelRatio; const tl = new Point$2(x1, y1); const tr = new Point$2(x2, y1); const bl = new Point$2(x1, y2); const br = new Point$2(x2, y2); if (rotateVerticalGlyph) { // Vertical-supporting glyphs are laid out in 24x24 point boxes (1 square em) // In horizontal orientation, the y values for glyphs are below the midline // and we use a "yOffset" of -17 to pull them up to the middle. // By rotating counter-clockwise around the point at the center of the left // edge of a 24x24 layout box centered below the midline, we align the center // of the glyphs with the horizontal midline, so the yOffset is no longer // necessary, but we also pull the glyph to the left along the x axis. // The y coordinate includes baseline yOffset, thus needs to be accounted // for when glyph is rotated and translated. const center = new Point$2(-halfAdvance, halfAdvance - SHAPING_DEFAULT_OFFSET); const verticalRotation = -Math.PI / 2; // xHalfWidthOffsetCorrection is a difference between full-width and half-width // advance, should be 0 for full-width glyphs and will pull up half-width glyphs. const xHalfWidthOffsetCorrection = ONE_EM / 2 - halfAdvance; const yImageOffsetCorrection = positionedGlyph.imageName ? xHalfWidthOffsetCorrection : 0.0; const halfWidthOffsetCorrection = new Point$2(5 - SHAPING_DEFAULT_OFFSET - xHalfWidthOffsetCorrection, -yImageOffsetCorrection); const verticalOffsetCorrection = new Point$2(...verticalizedLabelOffset); tl._rotateAround(verticalRotation, center)._add(halfWidthOffsetCorrection)._add(verticalOffsetCorrection); tr._rotateAround(verticalRotation, center)._add(halfWidthOffsetCorrection)._add(verticalOffsetCorrection); bl._rotateAround(verticalRotation, center)._add(halfWidthOffsetCorrection)._add(verticalOffsetCorrection); br._rotateAround(verticalRotation, center)._add(halfWidthOffsetCorrection)._add(verticalOffsetCorrection); } if (textRotate) { const sin = Math.sin(textRotate), cos = Math.cos(textRotate), matrix = [cos, -sin, sin, cos]; tl._matMult(matrix); tr._matMult(matrix); bl._matMult(matrix); br._matMult(matrix); } const pixelOffsetTL = new Point$2(0, 0); const pixelOffsetBR = new Point$2(0, 0); const minFontScaleX = 0; const minFontScaleY = 0; quads.push({ tl, tr, bl, br, tex: textureRect, writingMode: shaping.writingMode, glyphOffset, sectionIndex: positionedGlyph.sectionIndex, isSDF, pixelOffsetTL, pixelOffsetBR, minFontScaleX, minFontScaleY }); } } return quads; } /** * A CollisionFeature represents the area of the tile covered by a single label. * It is used with CollisionIndex to check if the label overlaps with any * previous labels. A CollisionFeature is mostly just a set of CollisionBox * objects. */ class CollisionFeature { /** * Create a CollisionFeature, adding its collision box data to the given collisionBoxArray in the process. * For line aligned labels a collision circle diameter is computed instead. * * @param anchor - The point along the line around which the label is anchored. * @param shaped - The text or icon shaping results. * @param boxScale - A magic number used to convert from glyph metrics units to geometry units. * @param padding - The amount of padding to add around the label edges. * @param alignLine - Whether the label is aligned with the line or the viewport. */ constructor(collisionBoxArray, anchor, featureIndex, sourceLayerIndex, bucketIndex, shaped, boxScale, padding, alignLine, rotate) { var _a; this.boxStartIndex = collisionBoxArray.length; if (alignLine) { // Compute height of the shape in glyph metrics and apply collision padding. // Note that the pixel based 'text-padding' is applied at runtime let top = shaped.top; let bottom = shaped.bottom; const collisionPadding = shaped.collisionPadding; if (collisionPadding) { top -= collisionPadding[1]; bottom += collisionPadding[3]; } let height = bottom - top; if (height > 0) { // set minimum box height to avoid very many small labels height = Math.max(10, height); this.circleDiameter = height; } } else { const icon = ((_a = shaped.image) === null || _a === void 0 ? void 0 : _a.content) && (shaped.image.textFitWidth || shaped.image.textFitHeight) ? applyTextFit(shaped) : { x1: shaped.left, y1: shaped.top, x2: shaped.right, y2: shaped.bottom }; // margin is in CSS order: [top, right, bottom, left] icon.y1 = icon.y1 * boxScale - padding[0]; icon.y2 = icon.y2 * boxScale + padding[2]; icon.x1 = icon.x1 * boxScale - padding[3]; icon.x2 = icon.x2 * boxScale + padding[1]; const collisionPadding = shaped.collisionPadding; if (collisionPadding) { icon.x1 -= collisionPadding[0] * boxScale; icon.y1 -= collisionPadding[1] * boxScale; icon.x2 += collisionPadding[2] * boxScale; icon.y2 += collisionPadding[3] * boxScale; } if (rotate) { // Account for *-rotate in point collision boxes // See https://github.com/mapbox/mapbox-gl-js/issues/6075 // Doesn't account for icon-text-fit const tl = new Point$2(icon.x1, icon.y1); const tr = new Point$2(icon.x2, icon.y1); const bl = new Point$2(icon.x1, icon.y2); const br = new Point$2(icon.x2, icon.y2); const rotateRadians = rotate * Math.PI / 180; tl._rotate(rotateRadians); tr._rotate(rotateRadians); bl._rotate(rotateRadians); br._rotate(rotateRadians); // Collision features require an "on-axis" geometry, // so take the envelope of the rotated geometry // (may be quite large for wide labels rotated 45 degrees) icon.x1 = Math.min(tl.x, tr.x, bl.x, br.x); icon.x2 = Math.max(tl.x, tr.x, bl.x, br.x); icon.y1 = Math.min(tl.y, tr.y, bl.y, br.y); icon.y2 = Math.max(tl.y, tr.y, bl.y, br.y); } collisionBoxArray.emplaceBack(anchor.x, anchor.y, icon.x1, icon.y1, icon.x2, icon.y2, featureIndex, sourceLayerIndex, bucketIndex); } this.boxEndIndex = collisionBoxArray.length; } } class TinyQueue { constructor(data = [], compare = (a, b) => (a < b ? -1 : a > b ? 1 : 0)) { this.data = data; this.length = this.data.length; this.compare = compare; if (this.length > 0) { for (let i = (this.length >> 1) - 1; i >= 0; i--) this._down(i); } } push(item) { this.data.push(item); this._up(this.length++); } pop() { if (this.length === 0) return undefined; const top = this.data[0]; const bottom = this.data.pop(); if (--this.length > 0) { this.data[0] = bottom; this._down(0); } return top; } peek() { return this.data[0]; } _up(pos) { const {data, compare} = this; const item = data[pos]; while (pos > 0) { const parent = (pos - 1) >> 1; const current = data[parent]; if (compare(item, current) >= 0) break; data[pos] = current; pos = parent; } data[pos] = item; } _down(pos) { const {data, compare} = this; const halfLength = this.length >> 1; const item = data[pos]; while (pos < halfLength) { let bestChild = (pos << 1) + 1; // initially it is the left child const right = bestChild + 1; if (right < this.length && compare(data[right], data[bestChild]) < 0) { bestChild = right; } if (compare(data[bestChild], item) >= 0) break; data[pos] = data[bestChild]; pos = bestChild; } data[pos] = item; } } /** * Finds an approximation of a polygon's Pole Of Inaccessibility https://en.wikipedia.org/wiki/Pole_of_inaccessibility * This is a copy of https://github.com/mapbox/polylabel adapted to use Points * * @param polygonRings - first item in array is the outer ring followed optionally by the list of holes, should be an element of the result of util/classify_rings * @param precision - Specified in input coordinate units. If 0 returns after first run, if `> 0` repeatedly narrows the search space until the radius of the area searched for the best pole is less than precision * @param debug - Print some statistics to the console during execution * @returns Pole of Inaccessibility. */ function findPoleOfInaccessibility(polygonRings, precision = 1, debug = false) { // find the bounding box of the outer ring let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity; const outerRing = polygonRings[0]; for (let i = 0; i < outerRing.length; i++) { const p = outerRing[i]; if (!i || p.x < minX) minX = p.x; if (!i || p.y < minY) minY = p.y; if (!i || p.x > maxX) maxX = p.x; if (!i || p.y > maxY) maxY = p.y; } const width = maxX - minX; const height = maxY - minY; const cellSize = Math.min(width, height); let h = cellSize / 2; // a priority queue of cells in order of their "potential" (max distance to polygon) const cellQueue = new TinyQueue([], compareMax); if (cellSize === 0) return new Point$2(minX, minY); // cover polygon with initial cells for (let x = minX; x < maxX; x += cellSize) { for (let y = minY; y < maxY; y += cellSize) { cellQueue.push(new Cell(x + h, y + h, h, polygonRings)); } } // take centroid as the first best guess let bestCell = getCentroidCell(polygonRings); let numProbes = cellQueue.length; while (cellQueue.length) { // pick the most promising cell from the queue const cell = cellQueue.pop(); // update the best cell if we found a better one if (cell.d > bestCell.d || !bestCell.d) { bestCell = cell; if (debug) console.log('found best %d after %d probes', Math.round(1e4 * cell.d) / 1e4, numProbes); } // do not drill down further if there's no chance of a better solution if (cell.max - bestCell.d <= precision) continue; // split the cell into four cells h = cell.h / 2; cellQueue.push(new Cell(cell.p.x - h, cell.p.y - h, h, polygonRings)); cellQueue.push(new Cell(cell.p.x + h, cell.p.y - h, h, polygonRings)); cellQueue.push(new Cell(cell.p.x - h, cell.p.y + h, h, polygonRings)); cellQueue.push(new Cell(cell.p.x + h, cell.p.y + h, h, polygonRings)); numProbes += 4; } if (debug) { console.log(`num probes: ${numProbes}`); console.log(`best distance: ${bestCell.d}`); } return bestCell.p; } function compareMax(a, b) { return b.max - a.max; } function Cell(x, y, h, polygon) { this.p = new Point$2(x, y); this.h = h; // half the cell size this.d = pointToPolygonDist(this.p, polygon); // distance from cell center to polygon this.max = this.d + this.h * Math.SQRT2; // max distance to polygon within a cell } // signed distance from point to polygon outline (negative if point is outside) function pointToPolygonDist(p, polygon) { let inside = false; let minDistSq = Infinity; for (let k = 0; k < polygon.length; k++) { const ring = polygon[k]; for (let i = 0, len = ring.length, j = len - 1; i < len; j = i++) { const a = ring[i]; const b = ring[j]; if ((a.y > p.y !== b.y > p.y) && (p.x < (b.x - a.x) * (p.y - a.y) / (b.y - a.y) + a.x)) inside = !inside; minDistSq = Math.min(minDistSq, distToSegmentSquared(p, a, b)); } } return (inside ? 1 : -1) * Math.sqrt(minDistSq); } // get polygon centroid function getCentroidCell(polygon) { let area = 0; let x = 0; let y = 0; const points = polygon[0]; for (let i = 0, len = points.length, j = len - 1; i < len; j = i++) { const a = points[i]; const b = points[j]; const f = a.x * b.y - b.x * a.y; x += (a.x + b.x) * f; y += (a.y + b.y) * f; area += f * 3; } return new Cell(x / area, y / area, 0, polygon); } var TextAnchorEnum; (function (TextAnchorEnum) { TextAnchorEnum[TextAnchorEnum["center"] = 1] = "center"; TextAnchorEnum[TextAnchorEnum["left"] = 2] = "left"; TextAnchorEnum[TextAnchorEnum["right"] = 3] = "right"; TextAnchorEnum[TextAnchorEnum["top"] = 4] = "top"; TextAnchorEnum[TextAnchorEnum["bottom"] = 5] = "bottom"; TextAnchorEnum[TextAnchorEnum["top-left"] = 6] = "top-left"; TextAnchorEnum[TextAnchorEnum["top-right"] = 7] = "top-right"; TextAnchorEnum[TextAnchorEnum["bottom-left"] = 8] = "bottom-left"; TextAnchorEnum[TextAnchorEnum["bottom-right"] = 9] = "bottom-right"; })(TextAnchorEnum || (TextAnchorEnum = {})); // The radial offset is to the edge of the text box // In the horizontal direction, the edge of the text box is where glyphs start // But in the vertical direction, the glyphs appear to "start" at the baseline // We don't actually load baseline data, but we assume an offset of ONE_EM - 17 // (see "yOffset" in shaping.js) const baselineOffset = 7; const INVALID_TEXT_OFFSET = Number.POSITIVE_INFINITY; function evaluateVariableOffset(anchor, offset) { function fromRadialOffset(anchor, radialOffset) { let x = 0, y = 0; if (radialOffset < 0) radialOffset = 0; // Ignore negative offset. // solve for r where r^2 + r^2 = radialOffset^2 const hypotenuse = radialOffset / Math.SQRT2; switch (anchor) { case 'top-right': case 'top-left': y = hypotenuse - baselineOffset; break; case 'bottom-right': case 'bottom-left': y = -hypotenuse + baselineOffset; break; case 'bottom': y = -radialOffset + baselineOffset; break; case 'top': y = radialOffset - baselineOffset; break; } switch (anchor) { case 'top-right': case 'bottom-right': x = -hypotenuse; break; case 'top-left': case 'bottom-left': x = hypotenuse; break; case 'left': x = radialOffset; break; case 'right': x = -radialOffset; break; } return [x, y]; } function fromTextOffset(anchor, offsetX, offsetY) { let x = 0, y = 0; // Use absolute offset values. offsetX = Math.abs(offsetX); offsetY = Math.abs(offsetY); switch (anchor) { case 'top-right': case 'top-left': case 'top': y = offsetY - baselineOffset; break; case 'bottom-right': case 'bottom-left': case 'bottom': y = -offsetY + baselineOffset; break; } switch (anchor) { case 'top-right': case 'bottom-right': case 'right': x = -offsetX; break; case 'top-left': case 'bottom-left': case 'left': x = offsetX; break; } return [x, y]; } return (offset[1] !== INVALID_TEXT_OFFSET) ? fromTextOffset(anchor, offset[0], offset[1]) : fromRadialOffset(anchor, offset[0]); } // Helper to support both text-variable-anchor and text-variable-anchor-offset. Offset values converted from EMs to PXs function getTextVariableAnchorOffset(layer, feature, canonical) { var _a; const layout = layer.layout; // If style specifies text-variable-anchor-offset, just return it const variableAnchorOffset = (_a = layout.get('text-variable-anchor-offset')) === null || _a === void 0 ? void 0 : _a.evaluate(feature, {}, canonical); if (variableAnchorOffset) { const sourceValues = variableAnchorOffset.values; const destValues = []; // Convert offsets from EM to PX, and apply baseline shift for (let i = 0; i < sourceValues.length; i += 2) { const anchor = destValues[i] = sourceValues[i]; const offset = sourceValues[i + 1].map(t => t * ONE_EM); if (anchor.startsWith('top')) { offset[1] -= baselineOffset; } else if (anchor.startsWith('bottom')) { offset[1] += baselineOffset; } destValues[i + 1] = offset; } return new VariableAnchorOffsetCollection(destValues); } // If style specifies text-variable-anchor, convert to the new format const variableAnchor = layout.get('text-variable-anchor'); if (variableAnchor) { let textOffset; const unevaluatedLayout = layer._unevaluatedLayout; // The style spec says don't use `text-offset` and `text-radial-offset` together // but doesn't actually specify what happens if you use both. We go with the radial offset. if (unevaluatedLayout.getValue('text-radial-offset') !== undefined) { textOffset = [layout.get('text-radial-offset').evaluate(feature, {}, canonical) * ONE_EM, INVALID_TEXT_OFFSET]; } else { textOffset = layout.get('text-offset').evaluate(feature, {}, canonical).map(t => t * ONE_EM); } const anchorOffsets = []; for (const anchor of variableAnchor) { anchorOffsets.push(anchor, evaluateVariableOffset(anchor, textOffset)); } return new VariableAnchorOffsetCollection(anchorOffsets); } return null; } function performSymbolLayout(args) { args.bucket.createArrays(); const tileSize = 512 * args.bucket.overscaling; args.bucket.tilePixelRatio = EXTENT / tileSize; args.bucket.compareText = {}; args.bucket.iconsNeedLinear = false; const layer = args.bucket.layers[0]; const layout = layer.layout; const unevaluatedLayoutValues = layer._unevaluatedLayout._values; const sizes = { // Filled in below, if *SizeData.kind is 'composite' // compositeIconSizes: undefined, // compositeTextSizes: undefined, layoutIconSize: unevaluatedLayoutValues['icon-size'].possiblyEvaluate(new EvaluationParameters(args.bucket.zoom + 1), args.canonical), layoutTextSize: unevaluatedLayoutValues['text-size'].possiblyEvaluate(new EvaluationParameters(args.bucket.zoom + 1), args.canonical), textMaxSize: unevaluatedLayoutValues['text-size'].possiblyEvaluate(new EvaluationParameters(18)) }; if (args.bucket.textSizeData.kind === 'composite') { const { minZoom, maxZoom } = args.bucket.textSizeData; sizes.compositeTextSizes = [ unevaluatedLayoutValues['text-size'].possiblyEvaluate(new EvaluationParameters(minZoom), args.canonical), unevaluatedLayoutValues['text-size'].possiblyEvaluate(new EvaluationParameters(maxZoom), args.canonical) ]; } if (args.bucket.iconSizeData.kind === 'composite') { const { minZoom, maxZoom } = args.bucket.iconSizeData; sizes.compositeIconSizes = [ unevaluatedLayoutValues['icon-size'].possiblyEvaluate(new EvaluationParameters(minZoom), args.canonical), unevaluatedLayoutValues['icon-size'].possiblyEvaluate(new EvaluationParameters(maxZoom), args.canonical) ]; } const lineHeight = layout.get('text-line-height') * ONE_EM; const textAlongLine = layout.get('text-rotation-alignment') !== 'viewport' && layout.get('symbol-placement') !== 'point'; const keepUpright = layout.get('text-keep-upright'); const textSize = layout.get('text-size'); for (const feature of args.bucket.features) { const fontstack = layout.get('text-font').evaluate(feature, {}, args.canonical).join(','); const layoutTextSizeThisZoom = textSize.evaluate(feature, {}, args.canonical); const layoutTextSize = sizes.layoutTextSize.evaluate(feature, {}, args.canonical); const layoutIconSize = sizes.layoutIconSize.evaluate(feature, {}, args.canonical); const shapedTextOrientations = { horizontal: {}, vertical: undefined }; const text = feature.text; let textOffset = [0, 0]; if (text) { const unformattedText = text.toString(); const spacing = layout.get('text-letter-spacing').evaluate(feature, {}, args.canonical) * ONE_EM; const spacingIfAllowed = allowsLetterSpacing(unformattedText) ? spacing : 0; const textAnchor = layout.get('text-anchor').evaluate(feature, {}, args.canonical); const variableAnchorOffset = getTextVariableAnchorOffset(layer, feature, args.canonical); if (!variableAnchorOffset) { const radialOffset = layout.get('text-radial-offset').evaluate(feature, {}, args.canonical); // Layers with variable anchors use the `text-radial-offset` property and the [x, y] offset vector // is calculated at placement time instead of layout time if (radialOffset) { // The style spec says don't use `text-offset` and `text-radial-offset` together // but doesn't actually specify what happens if you use both. We go with the radial offset. textOffset = evaluateVariableOffset(textAnchor, [radialOffset * ONE_EM, INVALID_TEXT_OFFSET]); } else { textOffset = layout.get('text-offset').evaluate(feature, {}, args.canonical).map(t => t * ONE_EM); } } let textJustify = textAlongLine ? 'center' : layout.get('text-justify').evaluate(feature, {}, args.canonical); const symbolPlacement = layout.get('symbol-placement'); const maxWidth = symbolPlacement === 'point' ? layout.get('text-max-width').evaluate(feature, {}, args.canonical) * ONE_EM : Infinity; const addVerticalShapingForPointLabelIfNeeded = () => { if (args.bucket.allowVerticalPlacement && allowsVerticalWritingMode(unformattedText)) { // Vertical POI label placement is meant to be used for scripts that support vertical // writing mode, thus, default left justification is used. If Latin // scripts would need to be supported, this should take into account other justifications. shapedTextOrientations.vertical = shapeText(text, args.glyphMap, args.glyphPositions, args.imagePositions, fontstack, maxWidth, lineHeight, textAnchor, 'left', spacingIfAllowed, textOffset, WritingMode.vertical, true, layoutTextSize, layoutTextSizeThisZoom); } }; // If this layer uses text-variable-anchor, generate shapings for all justification possibilities. if (!textAlongLine && variableAnchorOffset) { const justifications = new Set(); if (textJustify === 'auto') { for (let i = 0; i < variableAnchorOffset.values.length; i += 2) { justifications.add(getAnchorJustification(variableAnchorOffset.values[i])); } } else { justifications.add(textJustify); } let singleLine = false; for (const justification of justifications) { if (shapedTextOrientations.horizontal[justification]) continue; if (singleLine) { // If the shaping for the first justification was only a single line, we // can re-use it for the other justifications shapedTextOrientations.horizontal[justification] = shapedTextOrientations.horizontal[0]; } else { // If using text-variable-anchor for the layer, we use a center anchor for all shapings and apply // the offsets for the anchor in the placement step. const shaping = shapeText(text, args.glyphMap, args.glyphPositions, args.imagePositions, fontstack, maxWidth, lineHeight, 'center', justification, spacingIfAllowed, textOffset, WritingMode.horizontal, false, layoutTextSize, layoutTextSizeThisZoom); if (shaping) { shapedTextOrientations.horizontal[justification] = shaping; singleLine = shaping.positionedLines.length === 1; } } } addVerticalShapingForPointLabelIfNeeded(); } else { if (textJustify === 'auto') { textJustify = getAnchorJustification(textAnchor); } // Horizontal point or line label. const shaping = shapeText(text, args.glyphMap, args.glyphPositions, args.imagePositions, fontstack, maxWidth, lineHeight, textAnchor, textJustify, spacingIfAllowed, textOffset, WritingMode.horizontal, false, layoutTextSize, layoutTextSizeThisZoom); if (shaping) shapedTextOrientations.horizontal[textJustify] = shaping; // Vertical point label (if allowVerticalPlacement is enabled). addVerticalShapingForPointLabelIfNeeded(); // Verticalized line label. if (allowsVerticalWritingMode(unformattedText) && textAlongLine && keepUpright) { shapedTextOrientations.vertical = shapeText(text, args.glyphMap, args.glyphPositions, args.imagePositions, fontstack, maxWidth, lineHeight, textAnchor, textJustify, spacingIfAllowed, textOffset, WritingMode.vertical, false, layoutTextSize, layoutTextSizeThisZoom); } } } let shapedIcon; let isSDFIcon = false; if (feature.icon && feature.icon.name) { const image = args.imageMap[feature.icon.name]; if (image) { shapedIcon = shapeIcon(args.imagePositions[feature.icon.name], layout.get('icon-offset').evaluate(feature, {}, args.canonical), layout.get('icon-anchor').evaluate(feature, {}, args.canonical)); // null/undefined SDF property treated same as default (false) isSDFIcon = !!image.sdf; if (args.bucket.sdfIcons === undefined) { args.bucket.sdfIcons = isSDFIcon; } else if (args.bucket.sdfIcons !== isSDFIcon) { warnOnce('Style sheet warning: Cannot mix SDF and non-SDF icons in one buffer'); } if (image.pixelRatio !== args.bucket.pixelRatio) { args.bucket.iconsNeedLinear = true; } else if (layout.get('icon-rotate').constantOr(1) !== 0) { args.bucket.iconsNeedLinear = true; } } } const shapedText = getDefaultHorizontalShaping(shapedTextOrientations.horizontal) || shapedTextOrientations.vertical; args.bucket.iconsInText = shapedText ? shapedText.iconsInText : false; if (shapedText || shapedIcon) { addFeature(args.bucket, feature, shapedTextOrientations, shapedIcon, args.imageMap, sizes, layoutTextSize, layoutIconSize, textOffset, isSDFIcon, args.canonical); } } if (args.showCollisionBoxes) { args.bucket.generateCollisionDebugBuffers(); } } // Choose the justification that matches the direction of the TextAnchor function getAnchorJustification(anchor) { switch (anchor) { case 'right': case 'top-right': case 'bottom-right': return 'right'; case 'left': case 'top-left': case 'bottom-left': return 'left'; } return 'center'; } /** * Given a feature and its shaped text and icon data, add a 'symbol * instance' for each _possible_ placement of the symbol feature. * (At render timePlaceSymbols#place() selects which of these instances to * show or hide based on collisions with symbols in other layers.) */ function addFeature(bucket, feature, shapedTextOrientations, shapedIcon, imageMap, sizes, layoutTextSize, layoutIconSize, textOffset, isSDFIcon, canonical) { // To reduce the number of labels that jump around when zooming we need // to use a text-size value that is the same for all zoom levels. // bucket calculates text-size at a high zoom level so that all tiles can // use the same value when calculating anchor positions. let textMaxSize = sizes.textMaxSize.evaluate(feature, {}); if (textMaxSize === undefined) { textMaxSize = layoutTextSize; } const layout = bucket.layers[0].layout; const iconOffset = layout.get('icon-offset').evaluate(feature, {}, canonical); const defaultHorizontalShaping = getDefaultHorizontalShaping(shapedTextOrientations.horizontal); const glyphSize = 24, fontScale = layoutTextSize / glyphSize, textBoxScale = bucket.tilePixelRatio * fontScale, textMaxBoxScale = bucket.tilePixelRatio * textMaxSize / glyphSize, iconBoxScale = bucket.tilePixelRatio * layoutIconSize, symbolMinDistance = bucket.tilePixelRatio * layout.get('symbol-spacing'), textPadding = layout.get('text-padding') * bucket.tilePixelRatio, iconPadding = getIconPadding(layout, feature, canonical, bucket.tilePixelRatio), textMaxAngle = layout.get('text-max-angle') / 180 * Math.PI, textAlongLine = layout.get('text-rotation-alignment') !== 'viewport' && layout.get('symbol-placement') !== 'point', iconAlongLine = layout.get('icon-rotation-alignment') === 'map' && layout.get('symbol-placement') !== 'point', symbolPlacement = layout.get('symbol-placement'), textRepeatDistance = symbolMinDistance / 2; const iconTextFit = layout.get('icon-text-fit'); let verticallyShapedIcon; // Adjust shaped icon size when icon-text-fit is used. if (shapedIcon && iconTextFit !== 'none') { if (bucket.allowVerticalPlacement && shapedTextOrientations.vertical) { verticallyShapedIcon = fitIconToText(shapedIcon, shapedTextOrientations.vertical, iconTextFit, layout.get('icon-text-fit-padding'), iconOffset, fontScale); } if (defaultHorizontalShaping) { shapedIcon = fitIconToText(shapedIcon, defaultHorizontalShaping, iconTextFit, layout.get('icon-text-fit-padding'), iconOffset, fontScale); } } const addSymbolAtAnchor = (line, anchor) => { if (anchor.x < 0 || anchor.x >= EXTENT || anchor.y < 0 || anchor.y >= EXTENT) { // Symbol layers are drawn across tile boundaries, We filter out symbols // outside our tile boundaries (which may be included in vector tile buffers) // to prevent double-drawing symbols. return; } addSymbol(bucket, anchor, line, shapedTextOrientations, shapedIcon, imageMap, verticallyShapedIcon, bucket.layers[0], bucket.collisionBoxArray, feature.index, feature.sourceLayerIndex, bucket.index, textBoxScale, [textPadding, textPadding, textPadding, textPadding], textAlongLine, textOffset, iconBoxScale, iconPadding, iconAlongLine, iconOffset, feature, sizes, isSDFIcon, canonical, layoutTextSize); }; if (symbolPlacement === 'line') { for (const line of clipLine(feature.geometry, 0, 0, EXTENT, EXTENT)) { const anchors = getAnchors(line, symbolMinDistance, textMaxAngle, shapedTextOrientations.vertical || defaultHorizontalShaping, shapedIcon, glyphSize, textMaxBoxScale, bucket.overscaling, EXTENT); for (const anchor of anchors) { const shapedText = defaultHorizontalShaping; if (!shapedText || !anchorIsTooClose(bucket, shapedText.text, textRepeatDistance, anchor)) { addSymbolAtAnchor(line, anchor); } } } } else if (symbolPlacement === 'line-center') { // No clipping, multiple lines per feature are allowed // "lines" with only one point are ignored as in clipLines for (const line of feature.geometry) { if (line.length > 1) { const anchor = getCenterAnchor(line, textMaxAngle, shapedTextOrientations.vertical || defaultHorizontalShaping, shapedIcon, glyphSize, textMaxBoxScale); if (anchor) { addSymbolAtAnchor(line, anchor); } } } } else if (feature.type === 'Polygon') { for (const polygon of classifyRings$1(feature.geometry, 0)) { // 16 here represents 2 pixels const poi = findPoleOfInaccessibility(polygon, 16); addSymbolAtAnchor(polygon[0], new Anchor(poi.x, poi.y, 0)); } } else if (feature.type === 'LineString') { // https://github.com/mapbox/mapbox-gl-js/issues/3808 for (const line of feature.geometry) { addSymbolAtAnchor(line, new Anchor(line[0].x, line[0].y, 0)); } } else if (feature.type === 'Point') { for (const points of feature.geometry) { for (const point of points) { addSymbolAtAnchor([point], new Anchor(point.x, point.y, 0)); } } } } function addTextVariableAnchorOffsets(textAnchorOffsets, variableAnchorOffset) { const startIndex = textAnchorOffsets.length; const values = variableAnchorOffset === null || variableAnchorOffset === void 0 ? void 0 : variableAnchorOffset.values; if ((values === null || values === void 0 ? void 0 : values.length) > 0) { for (let i = 0; i < values.length; i += 2) { const anchor = TextAnchorEnum[values[i]]; const offset = values[i + 1]; textAnchorOffsets.emplaceBack(anchor, offset[0], offset[1]); } } return [startIndex, textAnchorOffsets.length]; } function addTextVertices(bucket, anchor, shapedText, imageMap, layer, textAlongLine, feature, textOffset, lineArray, writingMode, placementTypes, placedTextSymbolIndices, placedIconIndex, sizes, canonical) { const glyphQuads = getGlyphQuads(anchor, shapedText, textOffset, layer, textAlongLine, feature, imageMap, bucket.allowVerticalPlacement); const sizeData = bucket.textSizeData; let textSizeData = null; if (sizeData.kind === 'source') { textSizeData = [ SIZE_PACK_FACTOR * layer.layout.get('text-size').evaluate(feature, {}) ]; if (textSizeData[0] > MAX_PACKED_SIZE) { warnOnce(`${bucket.layerIds[0]}: Value for "text-size" is >= ${MAX_GLYPH_ICON_SIZE}. Reduce your "text-size".`); } } else if (sizeData.kind === 'composite') { textSizeData = [ SIZE_PACK_FACTOR * sizes.compositeTextSizes[0].evaluate(feature, {}, canonical), SIZE_PACK_FACTOR * sizes.compositeTextSizes[1].evaluate(feature, {}, canonical) ]; if (textSizeData[0] > MAX_PACKED_SIZE || textSizeData[1] > MAX_PACKED_SIZE) { warnOnce(`${bucket.layerIds[0]}: Value for "text-size" is >= ${MAX_GLYPH_ICON_SIZE}. Reduce your "text-size".`); } } bucket.addSymbols(bucket.text, glyphQuads, textSizeData, textOffset, textAlongLine, feature, writingMode, anchor, lineArray.lineStartIndex, lineArray.lineLength, placedIconIndex, canonical); // The placedSymbolArray is used at render time in drawTileSymbols // These indices allow access to the array at collision detection time for (const placementType of placementTypes) { placedTextSymbolIndices[placementType] = bucket.text.placedSymbolArray.length - 1; } return glyphQuads.length * 4; } function getDefaultHorizontalShaping(horizontalShaping) { // We don't care which shaping we get because this is used for collision purposes // and all the justifications have the same collision box for (const justification in horizontalShaping) { return horizontalShaping[justification]; } return null; } /** * Add a single label & icon placement. */ function addSymbol(bucket, anchor, line, shapedTextOrientations, shapedIcon, imageMap, verticallyShapedIcon, layer, collisionBoxArray, featureIndex, sourceLayerIndex, bucketIndex, textBoxScale, textPadding, textAlongLine, textOffset, iconBoxScale, iconPadding, iconAlongLine, iconOffset, feature, sizes, isSDFIcon, canonical, layoutTextSize) { const lineArray = bucket.addToLineVertexArray(anchor, line); let textCollisionFeature, iconCollisionFeature, verticalTextCollisionFeature, verticalIconCollisionFeature; let numIconVertices = 0; let numVerticalIconVertices = 0; let numHorizontalGlyphVertices = 0; let numVerticalGlyphVertices = 0; let placedIconSymbolIndex = -1; let verticalPlacedIconSymbolIndex = -1; const placedTextSymbolIndices = {}; let key = murmur3$1(''); if (bucket.allowVerticalPlacement && shapedTextOrientations.vertical) { const textRotation = layer.layout.get('text-rotate').evaluate(feature, {}, canonical); const verticalTextRotation = textRotation + 90.0; const verticalShaping = shapedTextOrientations.vertical; verticalTextCollisionFeature = new CollisionFeature(collisionBoxArray, anchor, featureIndex, sourceLayerIndex, bucketIndex, verticalShaping, textBoxScale, textPadding, textAlongLine, verticalTextRotation); if (verticallyShapedIcon) { verticalIconCollisionFeature = new CollisionFeature(collisionBoxArray, anchor, featureIndex, sourceLayerIndex, bucketIndex, verticallyShapedIcon, iconBoxScale, iconPadding, textAlongLine, verticalTextRotation); } } //Place icon first, so text can have a reference to its index in the placed symbol array. //Text symbols can lazily shift at render-time because of variable anchor placement. //If the style specifies an `icon-text-fit` then the icon would have to shift along with it. // For more info check `updateVariableAnchors` in `draw_symbol.js` . if (shapedIcon) { const iconRotate = layer.layout.get('icon-rotate').evaluate(feature, {}); const hasIconTextFit = layer.layout.get('icon-text-fit') !== 'none'; const iconQuads = getIconQuads(shapedIcon, iconRotate, isSDFIcon, hasIconTextFit); const verticalIconQuads = verticallyShapedIcon ? getIconQuads(verticallyShapedIcon, iconRotate, isSDFIcon, hasIconTextFit) : undefined; iconCollisionFeature = new CollisionFeature(collisionBoxArray, anchor, featureIndex, sourceLayerIndex, bucketIndex, shapedIcon, iconBoxScale, iconPadding, /*align boxes to line*/ false, iconRotate); numIconVertices = iconQuads.length * 4; const sizeData = bucket.iconSizeData; let iconSizeData = null; if (sizeData.kind === 'source') { iconSizeData = [ SIZE_PACK_FACTOR * layer.layout.get('icon-size').evaluate(feature, {}) ]; if (iconSizeData[0] > MAX_PACKED_SIZE) { warnOnce(`${bucket.layerIds[0]}: Value for "icon-size" is >= ${MAX_GLYPH_ICON_SIZE}. Reduce your "icon-size".`); } } else if (sizeData.kind === 'composite') { iconSizeData = [ SIZE_PACK_FACTOR * sizes.compositeIconSizes[0].evaluate(feature, {}, canonical), SIZE_PACK_FACTOR * sizes.compositeIconSizes[1].evaluate(feature, {}, canonical) ]; if (iconSizeData[0] > MAX_PACKED_SIZE || iconSizeData[1] > MAX_PACKED_SIZE) { warnOnce(`${bucket.layerIds[0]}: Value for "icon-size" is >= ${MAX_GLYPH_ICON_SIZE}. Reduce your "icon-size".`); } } bucket.addSymbols(bucket.icon, iconQuads, iconSizeData, iconOffset, iconAlongLine, feature, WritingMode.none, anchor, lineArray.lineStartIndex, lineArray.lineLength, // The icon itself does not have an associated symbol since the text isn't placed yet -1, canonical); placedIconSymbolIndex = bucket.icon.placedSymbolArray.length - 1; if (verticalIconQuads) { numVerticalIconVertices = verticalIconQuads.length * 4; bucket.addSymbols(bucket.icon, verticalIconQuads, iconSizeData, iconOffset, iconAlongLine, feature, WritingMode.vertical, anchor, lineArray.lineStartIndex, lineArray.lineLength, // The icon itself does not have an associated symbol since the text isn't placed yet -1, canonical); verticalPlacedIconSymbolIndex = bucket.icon.placedSymbolArray.length - 1; } } const justifications = Object.keys(shapedTextOrientations.horizontal); for (const justification of justifications) { const shaping = shapedTextOrientations.horizontal[justification]; if (!textCollisionFeature) { key = murmur3$1(shaping.text); const textRotate = layer.layout.get('text-rotate').evaluate(feature, {}, canonical); // As a collision approximation, we can use either the vertical or any of the horizontal versions of the feature // We're counting on all versions having similar dimensions textCollisionFeature = new CollisionFeature(collisionBoxArray, anchor, featureIndex, sourceLayerIndex, bucketIndex, shaping, textBoxScale, textPadding, textAlongLine, textRotate); } const singleLine = shaping.positionedLines.length === 1; numHorizontalGlyphVertices += addTextVertices(bucket, anchor, shaping, imageMap, layer, textAlongLine, feature, textOffset, lineArray, shapedTextOrientations.vertical ? WritingMode.horizontal : WritingMode.horizontalOnly, singleLine ? justifications : [justification], placedTextSymbolIndices, placedIconSymbolIndex, sizes, canonical); if (singleLine) { break; } } if (shapedTextOrientations.vertical) { numVerticalGlyphVertices += addTextVertices(bucket, anchor, shapedTextOrientations.vertical, imageMap, layer, textAlongLine, feature, textOffset, lineArray, WritingMode.vertical, ['vertical'], placedTextSymbolIndices, verticalPlacedIconSymbolIndex, sizes, canonical); } const textBoxStartIndex = textCollisionFeature ? textCollisionFeature.boxStartIndex : bucket.collisionBoxArray.length; const textBoxEndIndex = textCollisionFeature ? textCollisionFeature.boxEndIndex : bucket.collisionBoxArray.length; const verticalTextBoxStartIndex = verticalTextCollisionFeature ? verticalTextCollisionFeature.boxStartIndex : bucket.collisionBoxArray.length; const verticalTextBoxEndIndex = verticalTextCollisionFeature ? verticalTextCollisionFeature.boxEndIndex : bucket.collisionBoxArray.length; const iconBoxStartIndex = iconCollisionFeature ? iconCollisionFeature.boxStartIndex : bucket.collisionBoxArray.length; const iconBoxEndIndex = iconCollisionFeature ? iconCollisionFeature.boxEndIndex : bucket.collisionBoxArray.length; const verticalIconBoxStartIndex = verticalIconCollisionFeature ? verticalIconCollisionFeature.boxStartIndex : bucket.collisionBoxArray.length; const verticalIconBoxEndIndex = verticalIconCollisionFeature ? verticalIconCollisionFeature.boxEndIndex : bucket.collisionBoxArray.length; // Check if runtime collision circles should be used for any of the collision features. // It is enough to choose the tallest feature shape as circles are always placed on a line. // All measurements are in glyph metrics and later converted into pixels using proper font size "layoutTextSize" let collisionCircleDiameter = -1; const getCollisionCircleHeight = (feature, prevHeight) => { if (feature && feature.circleDiameter) return Math.max(feature.circleDiameter, prevHeight); return prevHeight; }; collisionCircleDiameter = getCollisionCircleHeight(textCollisionFeature, collisionCircleDiameter); collisionCircleDiameter = getCollisionCircleHeight(verticalTextCollisionFeature, collisionCircleDiameter); collisionCircleDiameter = getCollisionCircleHeight(iconCollisionFeature, collisionCircleDiameter); collisionCircleDiameter = getCollisionCircleHeight(verticalIconCollisionFeature, collisionCircleDiameter); const useRuntimeCollisionCircles = (collisionCircleDiameter > -1) ? 1 : 0; // Convert circle collision height into pixels if (useRuntimeCollisionCircles) collisionCircleDiameter *= layoutTextSize / ONE_EM; if (bucket.glyphOffsetArray.length >= SymbolBucket.MAX_GLYPHS) warnOnce('Too many glyphs being rendered in a tile. See https://github.com/mapbox/mapbox-gl-js/issues/2907'); if (feature.sortKey !== undefined) { bucket.addToSortKeyRanges(bucket.symbolInstances.length, feature.sortKey); } const variableAnchorOffset = getTextVariableAnchorOffset(layer, feature, canonical); const [textAnchorOffsetStartIndex, textAnchorOffsetEndIndex] = addTextVariableAnchorOffsets(bucket.textAnchorOffsets, variableAnchorOffset); bucket.symbolInstances.emplaceBack(anchor.x, anchor.y, placedTextSymbolIndices.right >= 0 ? placedTextSymbolIndices.right : -1, placedTextSymbolIndices.center >= 0 ? placedTextSymbolIndices.center : -1, placedTextSymbolIndices.left >= 0 ? placedTextSymbolIndices.left : -1, placedTextSymbolIndices.vertical || -1, placedIconSymbolIndex, verticalPlacedIconSymbolIndex, key, textBoxStartIndex, textBoxEndIndex, verticalTextBoxStartIndex, verticalTextBoxEndIndex, iconBoxStartIndex, iconBoxEndIndex, verticalIconBoxStartIndex, verticalIconBoxEndIndex, featureIndex, numHorizontalGlyphVertices, numVerticalGlyphVertices, numIconVertices, numVerticalIconVertices, useRuntimeCollisionCircles, 0, textBoxScale, collisionCircleDiameter, textAnchorOffsetStartIndex, textAnchorOffsetEndIndex); } function anchorIsTooClose(bucket, text, repeatDistance, anchor) { const compareText = bucket.compareText; if (!(text in compareText)) { compareText[text] = []; } else { const otherAnchors = compareText[text]; for (let k = otherAnchors.length - 1; k >= 0; k--) { if (anchor.dist(otherAnchors[k]) < repeatDistance) { // If it's within repeatDistance of one anchor, stop looking return true; } } } // If anchor is not within repeatDistance of any other anchor, add to array compareText[text].push(anchor); return false; } /** * Converts a pixel value at a the given zoom level to tile units. * * The shaders mostly calculate everything in tile units so style * properties need to be converted from pixels to tile units using this. * * For example, a translation by 30 pixels at zoom 6.5 will be a * translation by pixelsToTileUnits(30, 6.5) tile units. * * @returns value in tile units */ function pixelsToTileUnits(tile, pixelValue, z) { return pixelValue * (EXTENT / (tile.tileSize * Math.pow(2, z - tile.tileID.overscaledZ))); } class OpacityState { constructor(prevState, increment, placed, skipFade) { if (prevState) { this.opacity = Math.max(0, Math.min(1, prevState.opacity + (prevState.placed ? increment : -increment))); } else { this.opacity = (skipFade && placed) ? 1 : 0; } this.placed = placed; } isHidden() { return this.opacity === 0 && !this.placed; } } class JointOpacityState { constructor(prevState, increment, placedText, placedIcon, skipFade) { this.text = new OpacityState(prevState ? prevState.text : null, increment, placedText, skipFade); this.icon = new OpacityState(prevState ? prevState.icon : null, increment, placedIcon, skipFade); } isHidden() { return this.text.isHidden() && this.icon.isHidden(); } } class JointPlacement { constructor(text, icon, skipFade) { this.text = text; this.icon = icon; this.skipFade = skipFade; } } class CollisionCircleArray { constructor() { this.invProjMatrix = create$6(); this.viewportMatrix = create$6(); this.circles = []; } } class RetainedQueryData { constructor(bucketInstanceId, featureIndex, sourceLayerIndex, bucketIndex, tileID) { this.bucketInstanceId = bucketInstanceId; this.featureIndex = featureIndex; this.sourceLayerIndex = sourceLayerIndex; this.bucketIndex = bucketIndex; this.tileID = tileID; } } class CollisionGroups { constructor(crossSourceCollisions) { this.crossSourceCollisions = crossSourceCollisions; this.maxGroupID = 0; this.collisionGroups = {}; } get(sourceID) { // The predicate/groupID mechanism allows for arbitrary grouping, // but the current interface defines one source == one group when // crossSourceCollisions == true. if (!this.crossSourceCollisions) { if (!this.collisionGroups[sourceID]) { const nextGroupID = ++this.maxGroupID; this.collisionGroups[sourceID] = { ID: nextGroupID, predicate: (key) => { return key.collisionGroupID === nextGroupID; } }; } return this.collisionGroups[sourceID]; } else { return { ID: 0, predicate: null }; } } } function calculateVariableLayoutShift(anchor, width, height, textOffset, textBoxScale) { const { horizontalAlign, verticalAlign } = getAnchorAlignment(anchor); const shiftX = -(horizontalAlign - 0.5) * width; const shiftY = -(verticalAlign - 0.5) * height; return new Point$2(shiftX + textOffset[0] * textBoxScale, shiftY + textOffset[1] * textBoxScale); } class Placement { constructor(transform, projection, terrain, fadeDuration, crossSourceCollisions, prevPlacement) { this.transform = transform.clone(); this.terrain = terrain; this.collisionIndex = new CollisionIndex(this.transform, projection); this.placements = {}; this.opacities = {}; this.variableOffsets = {}; this.stale = false; this.commitTime = 0; this.fadeDuration = fadeDuration; this.retainedQueryData = {}; this.collisionGroups = new CollisionGroups(crossSourceCollisions); this.collisionCircleArrays = {}; this.collisionBoxArrays = new Map(); this.prevPlacement = prevPlacement; if (prevPlacement) { prevPlacement.prevPlacement = undefined; // Only hold on to one placement back } this.placedOrientations = {}; } _getTerrainElevationFunc(tileID) { const terrain = this.terrain; return terrain ? (x, y) => terrain.getElevation(tileID, x, y) : null; } getBucketParts(results, styleLayer, tile, sortAcrossTiles) { const symbolBucket = tile.getBucket(styleLayer); const bucketFeatureIndex = tile.latestFeatureIndex; if (!symbolBucket || !bucketFeatureIndex || styleLayer.id !== symbolBucket.layerIds[0]) return; const collisionBoxArray = tile.collisionBoxArray; const layout = symbolBucket.layers[0].layout; const paint = symbolBucket.layers[0].paint; const scale = Math.pow(2, this.transform.zoom - tile.tileID.overscaledZ); const textPixelRatio = tile.tileSize / EXTENT; const unwrappedTileID = tile.tileID.toUnwrapped(); const posMatrix = this.transform.calculatePosMatrix(unwrappedTileID); const pitchWithMap = layout.get('text-pitch-alignment') === 'map'; const rotateWithMap = layout.get('text-rotation-alignment') === 'map'; const pixelsToTiles = pixelsToTileUnits(tile, 1, this.transform.zoom); const translationText = this.collisionIndex.mapProjection.translatePosition(this.transform, tile, paint.get('text-translate'), paint.get('text-translate-anchor')); const translationIcon = this.collisionIndex.mapProjection.translatePosition(this.transform, tile, paint.get('icon-translate'), paint.get('icon-translate-anchor')); const textLabelPlaneMatrix = getLabelPlaneMatrix(posMatrix, pitchWithMap, rotateWithMap, this.transform, pixelsToTiles); let labelToScreenMatrix = null; if (pitchWithMap) { const glMatrix = getGlCoordMatrix(posMatrix, pitchWithMap, rotateWithMap, this.transform, pixelsToTiles); labelToScreenMatrix = multiply$5([], this.transform.labelPlaneMatrix, glMatrix); } // As long as this placement lives, we have to hold onto this bucket's // matching FeatureIndex/data for querying purposes this.retainedQueryData[symbolBucket.bucketInstanceId] = new RetainedQueryData(symbolBucket.bucketInstanceId, bucketFeatureIndex, symbolBucket.sourceLayerIndex, symbolBucket.index, tile.tileID); const parameters = { bucket: symbolBucket, layout, translationText, translationIcon, posMatrix, unwrappedTileID, textLabelPlaneMatrix, labelToScreenMatrix, scale, textPixelRatio, holdingForFade: tile.holdingForFade(), collisionBoxArray, partiallyEvaluatedTextSize: evaluateSizeForZoom(symbolBucket.textSizeData, this.transform.zoom), collisionGroup: this.collisionGroups.get(symbolBucket.sourceID) }; if (sortAcrossTiles) { for (const range of symbolBucket.sortKeyRanges) { const { sortKey, symbolInstanceStart, symbolInstanceEnd } = range; results.push({ sortKey, symbolInstanceStart, symbolInstanceEnd, parameters }); } } else { results.push({ symbolInstanceStart: 0, symbolInstanceEnd: symbolBucket.symbolInstances.length, parameters }); } } attemptAnchorPlacement(textAnchorOffset, textBox, width, height, textBoxScale, rotateWithMap, pitchWithMap, textPixelRatio, posMatrix, unwrappedTileID, collisionGroup, textOverlapMode, symbolInstance, bucket, orientation, translationText, translationIcon, iconBox, getElevation) { const anchor = TextAnchorEnum[textAnchorOffset.textAnchor]; const textOffset = [textAnchorOffset.textOffset0, textAnchorOffset.textOffset1]; const shift = calculateVariableLayoutShift(anchor, width, height, textOffset, textBoxScale); const placedGlyphBoxes = this.collisionIndex.placeCollisionBox(textBox, textOverlapMode, textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translationText, collisionGroup.predicate, getElevation, shift); if (iconBox) { const placedIconBoxes = this.collisionIndex.placeCollisionBox(iconBox, textOverlapMode, textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translationIcon, collisionGroup.predicate, getElevation, shift); if (!placedIconBoxes.placeable) return; } if (placedGlyphBoxes.placeable) { let prevAnchor; // If this label was placed in the previous placement, record the anchor position // to allow us to animate the transition if (this.prevPlacement && this.prevPlacement.variableOffsets[symbolInstance.crossTileID] && this.prevPlacement.placements[symbolInstance.crossTileID] && this.prevPlacement.placements[symbolInstance.crossTileID].text) { prevAnchor = this.prevPlacement.variableOffsets[symbolInstance.crossTileID].anchor; } if (symbolInstance.crossTileID === 0) throw new Error('symbolInstance.crossTileID can\'t be 0'); this.variableOffsets[symbolInstance.crossTileID] = { textOffset, width, height, anchor, textBoxScale, prevAnchor }; this.markUsedJustification(bucket, anchor, symbolInstance, orientation); if (bucket.allowVerticalPlacement) { this.markUsedOrientation(bucket, orientation, symbolInstance); this.placedOrientations[symbolInstance.crossTileID] = orientation; } return { shift, placedGlyphBoxes }; } } placeLayerBucketPart(bucketPart, seenCrossTileIDs, showCollisionBoxes) { const { bucket, layout, translationText, translationIcon, posMatrix, unwrappedTileID, textLabelPlaneMatrix, labelToScreenMatrix, textPixelRatio, holdingForFade, collisionBoxArray, partiallyEvaluatedTextSize, collisionGroup } = bucketPart.parameters; const textOptional = layout.get('text-optional'); const iconOptional = layout.get('icon-optional'); const textOverlapMode = getOverlapMode(layout, 'text-overlap', 'text-allow-overlap'); const textAlwaysOverlap = textOverlapMode === 'always'; const iconOverlapMode = getOverlapMode(layout, 'icon-overlap', 'icon-allow-overlap'); const iconAlwaysOverlap = iconOverlapMode === 'always'; const rotateWithMap = layout.get('text-rotation-alignment') === 'map'; const pitchWithMap = layout.get('text-pitch-alignment') === 'map'; const hasIconTextFit = layout.get('icon-text-fit') !== 'none'; const zOrderByViewportY = layout.get('symbol-z-order') === 'viewport-y'; // This logic is similar to the "defaultOpacityState" logic below in updateBucketOpacities // If we know a symbol is always supposed to show, force it to be marked visible even if // it wasn't placed into the collision index (because some or all of it was outside the range // of the collision grid). // There is a subtle edge case here we're accepting: // Symbol A has text-allow-overlap: true, icon-allow-overlap: true, icon-optional: false // A's icon is outside the grid, so doesn't get placed // A's text would be inside grid, but doesn't get placed because of icon-optional: false // We still show A because of the allow-overlap settings. // Symbol B has allow-overlap: false, and gets placed where A's text would be // On panning in, there is a short period when Symbol B and Symbol A will overlap // This is the reverse of our normal policy of "fade in on pan", but should look like any other // collision and hopefully not be too noticeable. // See https://github.com/mapbox/mapbox-gl-js/issues/7172 const alwaysShowText = textAlwaysOverlap && (iconAlwaysOverlap || !bucket.hasIconData() || iconOptional); const alwaysShowIcon = iconAlwaysOverlap && (textAlwaysOverlap || !bucket.hasTextData() || textOptional); if (!bucket.collisionArrays && collisionBoxArray) { bucket.deserializeCollisionBoxes(collisionBoxArray); } const tileID = this.retainedQueryData[bucket.bucketInstanceId].tileID; const getElevation = this._getTerrainElevationFunc(tileID); const placeSymbol = (symbolInstance, collisionArrays, symbolIndex) => { var _a, _b; if (seenCrossTileIDs[symbolInstance.crossTileID]) return; if (holdingForFade) { // Mark all symbols from this tile as "not placed", but don't add to seenCrossTileIDs, because we don't // know yet if we have a duplicate in a parent tile that _should_ be placed. this.placements[symbolInstance.crossTileID] = new JointPlacement(false, false, false); return; } let placeText = false; let placeIcon = false; let offscreen = true; let shift = null; let placed = { box: null, placeable: false, offscreen: null }; let placedVerticalText = { box: null, placeable: false, offscreen: null }; let placedGlyphBoxes = null; let placedGlyphCircles = null; let placedIconBoxes = null; let textFeatureIndex = 0; let verticalTextFeatureIndex = 0; let iconFeatureIndex = 0; if (collisionArrays.textFeatureIndex) { textFeatureIndex = collisionArrays.textFeatureIndex; } else if (symbolInstance.useRuntimeCollisionCircles) { textFeatureIndex = symbolInstance.featureIndex; } if (collisionArrays.verticalTextFeatureIndex) { verticalTextFeatureIndex = collisionArrays.verticalTextFeatureIndex; } const textBox = collisionArrays.textBox; if (textBox) { const updatePreviousOrientationIfNotPlaced = (isPlaced) => { let previousOrientation = WritingMode.horizontal; if (bucket.allowVerticalPlacement && !isPlaced && this.prevPlacement) { const prevPlacedOrientation = this.prevPlacement.placedOrientations[symbolInstance.crossTileID]; if (prevPlacedOrientation) { this.placedOrientations[symbolInstance.crossTileID] = prevPlacedOrientation; previousOrientation = prevPlacedOrientation; this.markUsedOrientation(bucket, previousOrientation, symbolInstance); } } return previousOrientation; }; const placeTextForPlacementModes = (placeHorizontalFn, placeVerticalFn) => { if (bucket.allowVerticalPlacement && symbolInstance.numVerticalGlyphVertices > 0 && collisionArrays.verticalTextBox) { for (const placementMode of bucket.writingModes) { if (placementMode === WritingMode.vertical) { placed = placeVerticalFn(); placedVerticalText = placed; } else { placed = placeHorizontalFn(); } if (placed && placed.placeable) break; } } else { placed = placeHorizontalFn(); } }; const textAnchorOffsetStart = symbolInstance.textAnchorOffsetStartIndex; const textAnchorOffsetEnd = symbolInstance.textAnchorOffsetEndIndex; // If start+end indices match, text-variable-anchor is not in play. if (textAnchorOffsetEnd === textAnchorOffsetStart) { const placeBox = (collisionTextBox, orientation) => { const placedFeature = this.collisionIndex.placeCollisionBox(collisionTextBox, textOverlapMode, textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translationText, collisionGroup.predicate, getElevation); if (placedFeature && placedFeature.placeable) { this.markUsedOrientation(bucket, orientation, symbolInstance); this.placedOrientations[symbolInstance.crossTileID] = orientation; } return placedFeature; }; const placeHorizontal = () => { return placeBox(textBox, WritingMode.horizontal); }; const placeVertical = () => { const verticalTextBox = collisionArrays.verticalTextBox; if (bucket.allowVerticalPlacement && symbolInstance.numVerticalGlyphVertices > 0 && verticalTextBox) { return placeBox(verticalTextBox, WritingMode.vertical); } return { box: null, offscreen: null }; }; placeTextForPlacementModes(placeHorizontal, placeVertical); updatePreviousOrientationIfNotPlaced(placed && placed.placeable); } else { // If this symbol was in the last placement, prefer placement using same anchor, if it's still available let prevAnchor = TextAnchorEnum[(_b = (_a = this.prevPlacement) === null || _a === void 0 ? void 0 : _a.variableOffsets[symbolInstance.crossTileID]) === null || _b === void 0 ? void 0 : _b.anchor]; const placeBoxForVariableAnchors = (collisionTextBox, collisionIconBox, orientation) => { const width = collisionTextBox.x2 - collisionTextBox.x1; const height = collisionTextBox.y2 - collisionTextBox.y1; const textBoxScale = symbolInstance.textBoxScale; const variableIconBox = hasIconTextFit && (iconOverlapMode === 'never') ? collisionIconBox : null; let placedBox = null; let placementPasses = (textOverlapMode === 'never') ? 1 : 2; let overlapMode = 'never'; if (prevAnchor) { placementPasses++; } for (let pass = 0; pass < placementPasses; pass++) { for (let i = textAnchorOffsetStart; i < textAnchorOffsetEnd; i++) { const textAnchorOffset = bucket.textAnchorOffsets.get(i); if (prevAnchor && textAnchorOffset.textAnchor !== prevAnchor) { continue; } const result = this.attemptAnchorPlacement(textAnchorOffset, collisionTextBox, width, height, textBoxScale, rotateWithMap, pitchWithMap, textPixelRatio, posMatrix, unwrappedTileID, collisionGroup, overlapMode, symbolInstance, bucket, orientation, translationText, translationIcon, variableIconBox, getElevation); if (result) { placedBox = result.placedGlyphBoxes; if (placedBox && placedBox.placeable) { placeText = true; shift = result.shift; return placedBox; } } } if (prevAnchor) { prevAnchor = null; } else { overlapMode = textOverlapMode; } } if (showCollisionBoxes && !placedBox) { // No box was successfully placed // Generate bounds for a fake centered box, so that we can at least display something for collision debug. const placedFakeGlyphBox = this.collisionIndex.placeCollisionBox(textBox, 'always', // Skips expensive collision check with already placed boxes textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translationText, collisionGroup.predicate, getElevation, new Point$2(0, 0)); placedBox = { box: placedFakeGlyphBox.box, offscreen: false, placeable: false }; } return placedBox; }; const placeHorizontal = () => { return placeBoxForVariableAnchors(textBox, collisionArrays.iconBox, WritingMode.horizontal); }; const placeVertical = () => { const verticalTextBox = collisionArrays.verticalTextBox; const wasPlaced = placed && placed.placeable; if (bucket.allowVerticalPlacement && !wasPlaced && symbolInstance.numVerticalGlyphVertices > 0 && verticalTextBox) { return placeBoxForVariableAnchors(verticalTextBox, collisionArrays.verticalIconBox, WritingMode.vertical); } return { box: null, occluded: true, offscreen: null }; }; placeTextForPlacementModes(placeHorizontal, placeVertical); if (placed) { placeText = placed.placeable; offscreen = placed.offscreen; } const prevOrientation = updatePreviousOrientationIfNotPlaced(placed && placed.placeable); // If we didn't get placed, we still need to copy our position from the last placement for // fade animations if (!placeText && this.prevPlacement) { const prevOffset = this.prevPlacement.variableOffsets[symbolInstance.crossTileID]; if (prevOffset) { this.variableOffsets[symbolInstance.crossTileID] = prevOffset; this.markUsedJustification(bucket, prevOffset.anchor, symbolInstance, prevOrientation); } } } } placedGlyphBoxes = placed; placeText = placedGlyphBoxes && placedGlyphBoxes.placeable; offscreen = placedGlyphBoxes && placedGlyphBoxes.offscreen; if (symbolInstance.useRuntimeCollisionCircles) { const placedSymbol = bucket.text.placedSymbolArray.get(symbolInstance.centerJustifiedTextSymbolIndex); const fontSize = evaluateSizeForFeature(bucket.textSizeData, partiallyEvaluatedTextSize, placedSymbol); const textPixelPadding = layout.get('text-padding'); const circlePixelDiameter = symbolInstance.collisionCircleDiameter; placedGlyphCircles = this.collisionIndex.placeCollisionCircles(textOverlapMode, placedSymbol, bucket.lineVertexArray, bucket.glyphOffsetArray, fontSize, posMatrix, unwrappedTileID, textLabelPlaneMatrix, labelToScreenMatrix, showCollisionBoxes, pitchWithMap, collisionGroup.predicate, circlePixelDiameter, textPixelPadding, translationText, getElevation); if (placedGlyphCircles.circles.length && placedGlyphCircles.collisionDetected && !showCollisionBoxes) { warnOnce('Collisions detected, but collision boxes are not shown'); } // If text-overlap is set to 'always', force "placedCircles" to true // In theory there should always be at least one circle placed // in this case, but for now quirks in text-anchor // and text-offset may prevent that from being true. placeText = textAlwaysOverlap || (placedGlyphCircles.circles.length > 0 && !placedGlyphCircles.collisionDetected); offscreen = offscreen && placedGlyphCircles.offscreen; } if (collisionArrays.iconFeatureIndex) { iconFeatureIndex = collisionArrays.iconFeatureIndex; } if (collisionArrays.iconBox) { const placeIconFeature = iconBox => { return this.collisionIndex.placeCollisionBox(iconBox, iconOverlapMode, textPixelRatio, posMatrix, unwrappedTileID, pitchWithMap, rotateWithMap, translationIcon, collisionGroup.predicate, getElevation, (hasIconTextFit && shift) ? shift : undefined); }; if (placedVerticalText && placedVerticalText.placeable && collisionArrays.verticalIconBox) { placedIconBoxes = placeIconFeature(collisionArrays.verticalIconBox); placeIcon = placedIconBoxes.placeable; } else { placedIconBoxes = placeIconFeature(collisionArrays.iconBox); placeIcon = placedIconBoxes.placeable; } offscreen = offscreen && placedIconBoxes.offscreen; } const iconWithoutText = textOptional || (symbolInstance.numHorizontalGlyphVertices === 0 && symbolInstance.numVerticalGlyphVertices === 0); const textWithoutIcon = iconOptional || symbolInstance.numIconVertices === 0; // Combine the scales for icons and text. if (!iconWithoutText && !textWithoutIcon) { placeIcon = placeText = placeIcon && placeText; } else if (!textWithoutIcon) { placeText = placeIcon && placeText; } else if (!iconWithoutText) { placeIcon = placeIcon && placeText; } const hasTextBox = placeText && placedGlyphBoxes.placeable; const hasIconBox = placeIcon && placedIconBoxes.placeable; if (hasTextBox) { if (placedVerticalText && placedVerticalText.placeable && verticalTextFeatureIndex) { this.collisionIndex.insertCollisionBox(placedGlyphBoxes.box, textOverlapMode, layout.get('text-ignore-placement'), bucket.bucketInstanceId, verticalTextFeatureIndex, collisionGroup.ID); } else { this.collisionIndex.insertCollisionBox(placedGlyphBoxes.box, textOverlapMode, layout.get('text-ignore-placement'), bucket.bucketInstanceId, textFeatureIndex, collisionGroup.ID); } } if (hasIconBox) { this.collisionIndex.insertCollisionBox(placedIconBoxes.box, iconOverlapMode, layout.get('icon-ignore-placement'), bucket.bucketInstanceId, iconFeatureIndex, collisionGroup.ID); } if (placedGlyphCircles) { if (placeText) { this.collisionIndex.insertCollisionCircles(placedGlyphCircles.circles, textOverlapMode, layout.get('text-ignore-placement'), bucket.bucketInstanceId, textFeatureIndex, collisionGroup.ID); } } if (showCollisionBoxes) { this.storeCollisionData(bucket.bucketInstanceId, symbolIndex, collisionArrays, placedGlyphBoxes, placedIconBoxes, placedGlyphCircles); } if (symbolInstance.crossTileID === 0) throw new Error('symbolInstance.crossTileID can\'t be 0'); if (bucket.bucketInstanceId === 0) throw new Error('bucket.bucketInstanceId can\'t be 0'); this.placements[symbolInstance.crossTileID] = new JointPlacement(placeText || alwaysShowText, placeIcon || alwaysShowIcon, offscreen || bucket.justReloaded); seenCrossTileIDs[symbolInstance.crossTileID] = true; }; if (zOrderByViewportY) { if (bucketPart.symbolInstanceStart !== 0) throw new Error('bucket.bucketInstanceId should be 0'); const symbolIndexes = bucket.getSortedSymbolIndexes(this.transform.angle); for (let i = symbolIndexes.length - 1; i >= 0; --i) { const symbolIndex = symbolIndexes[i]; placeSymbol(bucket.symbolInstances.get(symbolIndex), bucket.collisionArrays[symbolIndex], symbolIndex); } } else { for (let i = bucketPart.symbolInstanceStart; i < bucketPart.symbolInstanceEnd; i++) { placeSymbol(bucket.symbolInstances.get(i), bucket.collisionArrays[i], i); } } if (showCollisionBoxes && bucket.bucketInstanceId in this.collisionCircleArrays) { const circleArray = this.collisionCircleArrays[bucket.bucketInstanceId]; // Store viewport and inverse projection matrices per bucket invert$2(circleArray.invProjMatrix, posMatrix); circleArray.viewportMatrix = this.collisionIndex.getViewportMatrix(); } bucket.justReloaded = false; } storeCollisionData(bucketInstanceId, symbolIndex, collisionArrays, placedGlyphBoxes, placedIconBoxes, placedGlyphCircles) { if (collisionArrays.textBox || collisionArrays.iconBox) { // Store the actually used collision box for debug draw let boxArray; if (this.collisionBoxArrays.has(bucketInstanceId)) { boxArray = this.collisionBoxArrays.get(bucketInstanceId); } else { boxArray = new Map(); this.collisionBoxArrays.set(bucketInstanceId, boxArray); } let realCollisionBox; if (boxArray.has(symbolIndex)) { realCollisionBox = boxArray.get(symbolIndex); } else { realCollisionBox = { text: null, icon: null }; boxArray.set(symbolIndex, realCollisionBox); } if (collisionArrays.textBox) { realCollisionBox.text = placedGlyphBoxes.box; } if (collisionArrays.iconBox) { realCollisionBox.icon = placedIconBoxes.box; } } if (placedGlyphCircles) { let circleArray = this.collisionCircleArrays[bucketInstanceId]; // Group collision circles together by bucket. Circles can't be pushed forward for rendering yet as the symbol placement // for a bucket is not guaranteed to be complete before the commit-function has been called if (circleArray === undefined) circleArray = this.collisionCircleArrays[bucketInstanceId] = new CollisionCircleArray(); for (let i = 0; i < placedGlyphCircles.circles.length; i += 4) { circleArray.circles.push(placedGlyphCircles.circles[i + 0]); // x circleArray.circles.push(placedGlyphCircles.circles[i + 1]); // y circleArray.circles.push(placedGlyphCircles.circles[i + 2]); // radius circleArray.circles.push(placedGlyphCircles.collisionDetected ? 1 : 0); // collisionDetected-flag } } } markUsedJustification(bucket, placedAnchor, symbolInstance, orientation) { const justifications = { 'left': symbolInstance.leftJustifiedTextSymbolIndex, 'center': symbolInstance.centerJustifiedTextSymbolIndex, 'right': symbolInstance.rightJustifiedTextSymbolIndex }; let autoIndex; if (orientation === WritingMode.vertical) { autoIndex = symbolInstance.verticalPlacedTextSymbolIndex; } else { autoIndex = justifications[getAnchorJustification(placedAnchor)]; } const indexes = [ symbolInstance.leftJustifiedTextSymbolIndex, symbolInstance.centerJustifiedTextSymbolIndex, symbolInstance.rightJustifiedTextSymbolIndex, symbolInstance.verticalPlacedTextSymbolIndex ]; for (const index of indexes) { if (index >= 0) { if (autoIndex >= 0 && index !== autoIndex) { // There are multiple justifications and this one isn't it: shift offscreen bucket.text.placedSymbolArray.get(index).crossTileID = 0; } else { // Either this is the chosen justification or the justification is hardwired: use this one bucket.text.placedSymbolArray.get(index).crossTileID = symbolInstance.crossTileID; } } } } markUsedOrientation(bucket, orientation, symbolInstance) { const horizontal = (orientation === WritingMode.horizontal || orientation === WritingMode.horizontalOnly) ? orientation : 0; const vertical = orientation === WritingMode.vertical ? orientation : 0; const horizontalIndexes = [ symbolInstance.leftJustifiedTextSymbolIndex, symbolInstance.centerJustifiedTextSymbolIndex, symbolInstance.rightJustifiedTextSymbolIndex ]; for (const index of horizontalIndexes) { bucket.text.placedSymbolArray.get(index).placedOrientation = horizontal; } if (symbolInstance.verticalPlacedTextSymbolIndex) { bucket.text.placedSymbolArray.get(symbolInstance.verticalPlacedTextSymbolIndex).placedOrientation = vertical; } } commit(now) { this.commitTime = now; this.zoomAtLastRecencyCheck = this.transform.zoom; const prevPlacement = this.prevPlacement; let placementChanged = false; this.prevZoomAdjustment = prevPlacement ? prevPlacement.zoomAdjustment(this.transform.zoom) : 0; const increment = prevPlacement ? prevPlacement.symbolFadeChange(now) : 1; const prevOpacities = prevPlacement ? prevPlacement.opacities : {}; const prevOffsets = prevPlacement ? prevPlacement.variableOffsets : {}; const prevOrientations = prevPlacement ? prevPlacement.placedOrientations : {}; // add the opacities from the current placement, and copy their current values from the previous placement for (const crossTileID in this.placements) { const jointPlacement = this.placements[crossTileID]; const prevOpacity = prevOpacities[crossTileID]; if (prevOpacity) { this.opacities[crossTileID] = new JointOpacityState(prevOpacity, increment, jointPlacement.text, jointPlacement.icon); placementChanged = placementChanged || jointPlacement.text !== prevOpacity.text.placed || jointPlacement.icon !== prevOpacity.icon.placed; } else { this.opacities[crossTileID] = new JointOpacityState(null, increment, jointPlacement.text, jointPlacement.icon, jointPlacement.skipFade); placementChanged = placementChanged || jointPlacement.text || jointPlacement.icon; } } // copy and update values from the previous placement that aren't in the current placement but haven't finished fading for (const crossTileID in prevOpacities) { const prevOpacity = prevOpacities[crossTileID]; if (!this.opacities[crossTileID]) { const jointOpacity = new JointOpacityState(prevOpacity, increment, false, false); if (!jointOpacity.isHidden()) { this.opacities[crossTileID] = jointOpacity; placementChanged = placementChanged || prevOpacity.text.placed || prevOpacity.icon.placed; } } } for (const crossTileID in prevOffsets) { if (!this.variableOffsets[crossTileID] && this.opacities[crossTileID] && !this.opacities[crossTileID].isHidden()) { this.variableOffsets[crossTileID] = prevOffsets[crossTileID]; } } for (const crossTileID in prevOrientations) { if (!this.placedOrientations[crossTileID] && this.opacities[crossTileID] && !this.opacities[crossTileID].isHidden()) { this.placedOrientations[crossTileID] = prevOrientations[crossTileID]; } } // this.lastPlacementChangeTime is the time of the last commit() that // resulted in a placement change -- in other words, the start time of // the last symbol fade animation if (prevPlacement && prevPlacement.lastPlacementChangeTime === undefined) { throw new Error('Last placement time for previous placement is not defined'); } if (placementChanged) { this.lastPlacementChangeTime = now; } else if (typeof this.lastPlacementChangeTime !== 'number') { this.lastPlacementChangeTime = prevPlacement ? prevPlacement.lastPlacementChangeTime : now; } } updateLayerOpacities(styleLayer, tiles) { const seenCrossTileIDs = {}; for (const tile of tiles) { const symbolBucket = tile.getBucket(styleLayer); if (symbolBucket && tile.latestFeatureIndex && styleLayer.id === symbolBucket.layerIds[0]) { this.updateBucketOpacities(symbolBucket, tile.tileID, seenCrossTileIDs, tile.collisionBoxArray); } } } updateBucketOpacities(bucket, tileID, seenCrossTileIDs, collisionBoxArray) { if (bucket.hasTextData()) { bucket.text.opacityVertexArray.clear(); bucket.text.hasVisibleVertices = false; } if (bucket.hasIconData()) { bucket.icon.opacityVertexArray.clear(); bucket.icon.hasVisibleVertices = false; } if (bucket.hasIconCollisionBoxData()) bucket.iconCollisionBox.collisionVertexArray.clear(); if (bucket.hasTextCollisionBoxData()) bucket.textCollisionBox.collisionVertexArray.clear(); const layer = bucket.layers[0]; const layout = layer.layout; const duplicateOpacityState = new JointOpacityState(null, 0, false, false, true); const textAllowOverlap = layout.get('text-allow-overlap'); const iconAllowOverlap = layout.get('icon-allow-overlap'); const hasVariablePlacement = layer._unevaluatedLayout.hasValue('text-variable-anchor') || layer._unevaluatedLayout.hasValue('text-variable-anchor-offset'); const rotateWithMap = layout.get('text-rotation-alignment') === 'map'; const pitchWithMap = layout.get('text-pitch-alignment') === 'map'; const hasIconTextFit = layout.get('icon-text-fit') !== 'none'; // If allow-overlap is true, we can show symbols before placement runs on them // But we have to wait for placement if we potentially depend on a paired icon/text // with allow-overlap: false. // See https://github.com/mapbox/mapbox-gl-js/issues/7032 const defaultOpacityState = new JointOpacityState(null, 0, textAllowOverlap && (iconAllowOverlap || !bucket.hasIconData() || layout.get('icon-optional')), iconAllowOverlap && (textAllowOverlap || !bucket.hasTextData() || layout.get('text-optional')), true); if (!bucket.collisionArrays && collisionBoxArray && ((bucket.hasIconCollisionBoxData() || bucket.hasTextCollisionBoxData()))) { bucket.deserializeCollisionBoxes(collisionBoxArray); } const addOpacities = (iconOrText, numVertices, opacity) => { for (let i = 0; i < numVertices / 4; i++) { iconOrText.opacityVertexArray.emplaceBack(opacity); } iconOrText.hasVisibleVertices = iconOrText.hasVisibleVertices || (opacity !== PACKED_HIDDEN_OPACITY); }; const boxArrays = this.collisionBoxArrays.get(bucket.bucketInstanceId); for (let s = 0; s < bucket.symbolInstances.length; s++) { const symbolInstance = bucket.symbolInstances.get(s); const { numHorizontalGlyphVertices, numVerticalGlyphVertices, crossTileID } = symbolInstance; const isDuplicate = seenCrossTileIDs[crossTileID]; let opacityState = this.opacities[crossTileID]; if (isDuplicate) { opacityState = duplicateOpacityState; } else if (!opacityState) { opacityState = defaultOpacityState; // store the state so that future placements use it as a starting point this.opacities[crossTileID] = opacityState; } seenCrossTileIDs[crossTileID] = true; const hasText = numHorizontalGlyphVertices > 0 || numVerticalGlyphVertices > 0; const hasIcon = symbolInstance.numIconVertices > 0; const placedOrientation = this.placedOrientations[symbolInstance.crossTileID]; const horizontalHidden = placedOrientation === WritingMode.vertical; const verticalHidden = placedOrientation === WritingMode.horizontal || placedOrientation === WritingMode.horizontalOnly; if (hasText) { const packedOpacity = packOpacity(opacityState.text); // Vertical text fades in/out on collision the same way as corresponding // horizontal text. Switch between vertical/horizontal should be instantaneous const horizontalOpacity = horizontalHidden ? PACKED_HIDDEN_OPACITY : packedOpacity; addOpacities(bucket.text, numHorizontalGlyphVertices, horizontalOpacity); const verticalOpacity = verticalHidden ? PACKED_HIDDEN_OPACITY : packedOpacity; addOpacities(bucket.text, numVerticalGlyphVertices, verticalOpacity); // If this label is completely faded, mark it so that we don't have to calculate // its position at render time. If this layer has variable placement, shift the various // symbol instances appropriately so that symbols from buckets that have yet to be placed // offset appropriately. const symbolHidden = opacityState.text.isHidden(); [ symbolInstance.rightJustifiedTextSymbolIndex, symbolInstance.centerJustifiedTextSymbolIndex, symbolInstance.leftJustifiedTextSymbolIndex ].forEach(index => { if (index >= 0) { bucket.text.placedSymbolArray.get(index).hidden = symbolHidden || horizontalHidden ? 1 : 0; } }); if (symbolInstance.verticalPlacedTextSymbolIndex >= 0) { bucket.text.placedSymbolArray.get(symbolInstance.verticalPlacedTextSymbolIndex).hidden = symbolHidden || verticalHidden ? 1 : 0; } const prevOffset = this.variableOffsets[symbolInstance.crossTileID]; if (prevOffset) { this.markUsedJustification(bucket, prevOffset.anchor, symbolInstance, placedOrientation); } const prevOrientation = this.placedOrientations[symbolInstance.crossTileID]; if (prevOrientation) { this.markUsedJustification(bucket, 'left', symbolInstance, prevOrientation); this.markUsedOrientation(bucket, prevOrientation, symbolInstance); } } if (hasIcon) { const packedOpacity = packOpacity(opacityState.icon); const useHorizontal = !(hasIconTextFit && symbolInstance.verticalPlacedIconSymbolIndex && horizontalHidden); if (symbolInstance.placedIconSymbolIndex >= 0) { const horizontalOpacity = useHorizontal ? packedOpacity : PACKED_HIDDEN_OPACITY; addOpacities(bucket.icon, symbolInstance.numIconVertices, horizontalOpacity); bucket.icon.placedSymbolArray.get(symbolInstance.placedIconSymbolIndex).hidden = opacityState.icon.isHidden(); } if (symbolInstance.verticalPlacedIconSymbolIndex >= 0) { const verticalOpacity = !useHorizontal ? packedOpacity : PACKED_HIDDEN_OPACITY; addOpacities(bucket.icon, symbolInstance.numVerticalIconVertices, verticalOpacity); bucket.icon.placedSymbolArray.get(symbolInstance.verticalPlacedIconSymbolIndex).hidden = opacityState.icon.isHidden(); } } const realBoxes = (boxArrays && boxArrays.has(s)) ? boxArrays.get(s) : { text: null, icon: null }; if (bucket.hasIconCollisionBoxData() || bucket.hasTextCollisionBoxData()) { const collisionArrays = bucket.collisionArrays[s]; if (collisionArrays) { let shift = new Point$2(0, 0); if (collisionArrays.textBox || collisionArrays.verticalTextBox) { let used = true; if (hasVariablePlacement) { const variableOffset = this.variableOffsets[crossTileID]; if (variableOffset) { // This will show either the currently placed position or the last // successfully placed position (so you can visualize what collision // just made the symbol disappear, and the most likely place for the // symbol to come back) shift = calculateVariableLayoutShift(variableOffset.anchor, variableOffset.width, variableOffset.height, variableOffset.textOffset, variableOffset.textBoxScale); if (rotateWithMap) { shift._rotate(pitchWithMap ? this.transform.angle : -this.transform.angle); } } else { // No offset -> this symbol hasn't been placed since coming on-screen // No single box is particularly meaningful and all of them would be too noisy // Use the center box just to show something's there, but mark it "not used" used = false; } } if (collisionArrays.textBox || collisionArrays.verticalTextBox) { let hidden; if (collisionArrays.textBox) { hidden = horizontalHidden; } if (collisionArrays.verticalTextBox) { hidden = verticalHidden; } updateCollisionVertices(bucket.textCollisionBox.collisionVertexArray, opacityState.text.placed, !used || hidden, realBoxes.text, shift.x, shift.y); } } if (collisionArrays.iconBox || collisionArrays.verticalIconBox) { const verticalIconUsed = Boolean(!verticalHidden && collisionArrays.verticalIconBox); let hidden; if (collisionArrays.iconBox) { hidden = verticalIconUsed; } if (collisionArrays.verticalIconBox) { hidden = !verticalIconUsed; } updateCollisionVertices(bucket.iconCollisionBox.collisionVertexArray, opacityState.icon.placed, hidden, realBoxes.icon, hasIconTextFit ? shift.x : 0, hasIconTextFit ? shift.y : 0); } } } } bucket.sortFeatures(this.transform.angle); if (this.retainedQueryData[bucket.bucketInstanceId]) { this.retainedQueryData[bucket.bucketInstanceId].featureSortOrder = bucket.featureSortOrder; } if (bucket.hasTextData() && bucket.text.opacityVertexBuffer) { bucket.text.opacityVertexBuffer.updateData(bucket.text.opacityVertexArray); } if (bucket.hasIconData() && bucket.icon.opacityVertexBuffer) { bucket.icon.opacityVertexBuffer.updateData(bucket.icon.opacityVertexArray); } if (bucket.hasIconCollisionBoxData() && bucket.iconCollisionBox.collisionVertexBuffer) { bucket.iconCollisionBox.collisionVertexBuffer.updateData(bucket.iconCollisionBox.collisionVertexArray); } if (bucket.hasTextCollisionBoxData() && bucket.textCollisionBox.collisionVertexBuffer) { bucket.textCollisionBox.collisionVertexBuffer.updateData(bucket.textCollisionBox.collisionVertexArray); } if (bucket.text.opacityVertexArray.length !== bucket.text.layoutVertexArray.length / 4) throw new Error(`bucket.text.opacityVertexArray.length (= ${bucket.text.opacityVertexArray.length}) !== bucket.text.layoutVertexArray.length (= ${bucket.text.layoutVertexArray.length}) / 4`); if (bucket.icon.opacityVertexArray.length !== bucket.icon.layoutVertexArray.length / 4) throw new Error(`bucket.icon.opacityVertexArray.length (= ${bucket.icon.opacityVertexArray.length}) !== bucket.icon.layoutVertexArray.length (= ${bucket.icon.layoutVertexArray.length}) / 4`); // Push generated collision circles to the bucket for debug rendering if (bucket.bucketInstanceId in this.collisionCircleArrays) { const instance = this.collisionCircleArrays[bucket.bucketInstanceId]; bucket.placementInvProjMatrix = instance.invProjMatrix; bucket.placementViewportMatrix = instance.viewportMatrix; bucket.collisionCircleArray = instance.circles; delete this.collisionCircleArrays[bucket.bucketInstanceId]; } } symbolFadeChange(now) { return this.fadeDuration === 0 ? 1 : ((now - this.commitTime) / this.fadeDuration + this.prevZoomAdjustment); } zoomAdjustment(zoom) { // When zooming out quickly, labels can overlap each other. This // adjustment is used to reduce the interval between placement calculations // and to reduce the fade duration when zooming out quickly. Discovering the // collisions more quickly and fading them more quickly reduces the unwanted effect. return Math.max(0, (this.transform.zoom - zoom) / 1.5); } hasTransitions(now) { return this.stale || now - this.lastPlacementChangeTime < this.fadeDuration; } stillRecent(now, zoom) { // The adjustment makes placement more frequent when zooming. // This condition applies the adjustment only after the map has // stopped zooming. This avoids adding extra jank while zooming. const durationAdjustment = this.zoomAtLastRecencyCheck === zoom ? (1 - this.zoomAdjustment(zoom)) : 1; this.zoomAtLastRecencyCheck = zoom; return this.commitTime + this.fadeDuration * durationAdjustment > now; } setStale() { this.stale = true; } } function updateCollisionVertices(collisionVertexArray, placed, notUsed, realBox, shiftX, shiftY) { if (!realBox || realBox.length === 0) { realBox = [0, 0, 0, 0]; } const tlX = realBox[0] - viewportPadding; const tlY = realBox[1] - viewportPadding; const brX = realBox[2] - viewportPadding; const brY = realBox[3] - viewportPadding; collisionVertexArray.emplaceBack(placed ? 1 : 0, notUsed ? 1 : 0, shiftX || 0, shiftY || 0, tlX, tlY); collisionVertexArray.emplaceBack(placed ? 1 : 0, notUsed ? 1 : 0, shiftX || 0, shiftY || 0, brX, tlY); collisionVertexArray.emplaceBack(placed ? 1 : 0, notUsed ? 1 : 0, shiftX || 0, shiftY || 0, brX, brY); collisionVertexArray.emplaceBack(placed ? 1 : 0, notUsed ? 1 : 0, shiftX || 0, shiftY || 0, tlX, brY); } // All four vertices for a glyph will have the same opacity state // So we pack the opacity into a uint8, and then repeat it four times // to make a single uint32 that we can upload for each glyph in the // label. const shift25 = Math.pow(2, 25); const shift24 = Math.pow(2, 24); const shift17 = Math.pow(2, 17); const shift16 = Math.pow(2, 16); const shift9 = Math.pow(2, 9); const shift8 = Math.pow(2, 8); const shift1 = Math.pow(2, 1); function packOpacity(opacityState) { if (opacityState.opacity === 0 && !opacityState.placed) { return 0; } else if (opacityState.opacity === 1 && opacityState.placed) { return 4294967295; } const targetBit = opacityState.placed ? 1 : 0; const opacityBits = Math.floor(opacityState.opacity * 127); return opacityBits * shift25 + targetBit * shift24 + opacityBits * shift17 + targetBit * shift16 + opacityBits * shift9 + targetBit * shift8 + opacityBits * shift1 + targetBit; } const PACKED_HIDDEN_OPACITY = 0; function createProjection() { return { isOccluded(_x, _y, _t) { return false; }, getPitchedTextCorrection(_transform, _anchor, _tile) { return 1.0; }, get useSpecialProjectionForSymbols() { return false; }, projectTileCoordinates(_x, _y, _t, _ele) { // This function should only be used when useSpecialProjectionForSymbols is set to true. throw new Error('Not implemented.'); }, translatePosition(transform, tile, translate, translateAnchor) { return translatePosition(transform, tile, translate, translateAnchor); }, getCircleRadiusCorrection(_) { return 1.0; } }; } /** * Returns a translation in tile units that correctly incorporates the view angle and the *-translate and *-translate-anchor properties. * @param inViewportPixelUnitsUnits - True when the units accepted by the matrix are in viewport pixels instead of tile units. * * Temporarily imported from globe branch. */ function translatePosition(transform, tile, translate, translateAnchor, inViewportPixelUnitsUnits = false) { if (!translate[0] && !translate[1]) return [0, 0]; const angle = inViewportPixelUnitsUnits ? (translateAnchor === 'map' ? transform.angle : 0) : (translateAnchor === 'viewport' ? -transform.angle : 0); if (angle) { const sinA = Math.sin(angle); const cosA = Math.cos(angle); translate = [ translate[0] * cosA - translate[1] * sinA, translate[0] * sinA + translate[1] * cosA ]; } return [ inViewportPixelUnitsUnits ? translate[0] : pixelsToTileUnits(tile, translate[0], transform.zoom), inViewportPixelUnitsUnits ? translate[1] : pixelsToTileUnits(tile, translate[1], transform.zoom) ]; } class LayerPlacement { constructor(styleLayer) { this._sortAcrossTiles = styleLayer.layout.get('symbol-z-order') !== 'viewport-y' && !styleLayer.layout.get('symbol-sort-key').isConstant(); this._currentTileIndex = 0; this._currentPartIndex = 0; this._seenCrossTileIDs = {}; this._bucketParts = []; } continuePlacement(tiles, placement, showCollisionBoxes, styleLayer, shouldPausePlacement) { const bucketParts = this._bucketParts; while (this._currentTileIndex < tiles.length) { const tile = tiles[this._currentTileIndex]; placement.getBucketParts(bucketParts, styleLayer, tile, this._sortAcrossTiles); this._currentTileIndex++; if (shouldPausePlacement()) { return true; } } if (this._sortAcrossTiles) { this._sortAcrossTiles = false; bucketParts.sort((a, b) => a.sortKey - b.sortKey); } while (this._currentPartIndex < bucketParts.length) { const bucketPart = bucketParts[this._currentPartIndex]; placement.placeLayerBucketPart(bucketPart, this._seenCrossTileIDs, showCollisionBoxes); this._currentPartIndex++; if (shouldPausePlacement()) { return true; } } return false; } } class PauseablePlacement { constructor(transform, terrain, order, forceFullPlacement, showCollisionBoxes, fadeDuration, crossSourceCollisions, prevPlacement) { this.placement = new Placement(transform, createProjection(), terrain, fadeDuration, crossSourceCollisions, prevPlacement); this._currentPlacementIndex = order.length - 1; this._forceFullPlacement = forceFullPlacement; this._showCollisionBoxes = showCollisionBoxes; this._done = false; } isDone() { return this._done; } continuePlacement(order, layers, layerTiles) { const startTime = browser.now(); const shouldPausePlacement = () => { return this._forceFullPlacement ? false : (browser.now() - startTime) > 2; }; while (this._currentPlacementIndex >= 0) { const layerId = order[this._currentPlacementIndex]; const layer = layers[layerId]; const placementZoom = this.placement.collisionIndex.transform.zoom; if (layer.type === 'symbol' && (!layer.minzoom || layer.minzoom <= placementZoom) && (!layer.maxzoom || layer.maxzoom > placementZoom)) { if (!this._inProgressLayer) { this._inProgressLayer = new LayerPlacement(layer); } const pausePlacement = this._inProgressLayer.continuePlacement(layerTiles[layer.source], this.placement, this._showCollisionBoxes, layer, shouldPausePlacement); if (pausePlacement) { // We didn't finish placing all layers within 2ms, // but we can keep rendering with a partial placement // We'll resume here on the next frame return; } delete this._inProgressLayer; } this._currentPlacementIndex--; } this._done = true; } commit(now) { this.placement.commit(now); return this.placement; } } const ARRAY_TYPES = [ Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, Float32Array, Float64Array ]; /** @typedef {Int8ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor} TypedArrayConstructor */ const VERSION = 1; // serialized format version const HEADER_SIZE = 8; class KDBush { /** * Creates an index from raw `ArrayBuffer` data. * @param {ArrayBuffer} data */ static from(data) { if (!(data instanceof ArrayBuffer)) { throw new Error('Data must be an instance of ArrayBuffer.'); } const [magic, versionAndType] = new Uint8Array(data, 0, 2); if (magic !== 0xdb) { throw new Error('Data does not appear to be in a KDBush format.'); } const version = versionAndType >> 4; if (version !== VERSION) { throw new Error(`Got v${version} data when expected v${VERSION}.`); } const ArrayType = ARRAY_TYPES[versionAndType & 0x0f]; if (!ArrayType) { throw new Error('Unrecognized array type.'); } const [nodeSize] = new Uint16Array(data, 2, 1); const [numItems] = new Uint32Array(data, 4, 1); return new KDBush(numItems, nodeSize, ArrayType, data); } /** * Creates an index that will hold a given number of items. * @param {number} numItems * @param {number} [nodeSize=64] Size of the KD-tree node (64 by default). * @param {TypedArrayConstructor} [ArrayType=Float64Array] The array type used for coordinates storage (`Float64Array` by default). * @param {ArrayBuffer} [data] (For internal use only) */ constructor(numItems, nodeSize = 64, ArrayType = Float64Array, data) { if (isNaN(numItems) || numItems < 0) throw new Error(`Unpexpected numItems value: ${numItems}.`); this.numItems = +numItems; this.nodeSize = Math.min(Math.max(+nodeSize, 2), 65535); this.ArrayType = ArrayType; this.IndexArrayType = numItems < 65536 ? Uint16Array : Uint32Array; const arrayTypeIndex = ARRAY_TYPES.indexOf(this.ArrayType); const coordsByteSize = numItems * 2 * this.ArrayType.BYTES_PER_ELEMENT; const idsByteSize = numItems * this.IndexArrayType.BYTES_PER_ELEMENT; const padCoords = (8 - idsByteSize % 8) % 8; if (arrayTypeIndex < 0) { throw new Error(`Unexpected typed array class: ${ArrayType}.`); } if (data && (data instanceof ArrayBuffer)) { // reconstruct an index from a buffer this.data = data; this.ids = new this.IndexArrayType(this.data, HEADER_SIZE, numItems); this.coords = new this.ArrayType(this.data, HEADER_SIZE + idsByteSize + padCoords, numItems * 2); this._pos = numItems * 2; this._finished = true; } else { // initialize a new index this.data = new ArrayBuffer(HEADER_SIZE + coordsByteSize + idsByteSize + padCoords); this.ids = new this.IndexArrayType(this.data, HEADER_SIZE, numItems); this.coords = new this.ArrayType(this.data, HEADER_SIZE + idsByteSize + padCoords, numItems * 2); this._pos = 0; this._finished = false; // set header new Uint8Array(this.data, 0, 2).set([0xdb, (VERSION << 4) + arrayTypeIndex]); new Uint16Array(this.data, 2, 1)[0] = nodeSize; new Uint32Array(this.data, 4, 1)[0] = numItems; } } /** * Add a point to the index. * @param {number} x * @param {number} y * @returns {number} An incremental index associated with the added item (starting from `0`). */ add(x, y) { const index = this._pos >> 1; this.ids[index] = index; this.coords[this._pos++] = x; this.coords[this._pos++] = y; return index; } /** * Perform indexing of the added points. */ finish() { const numAdded = this._pos >> 1; if (numAdded !== this.numItems) { throw new Error(`Added ${numAdded} items when expected ${this.numItems}.`); } // kd-sort both arrays for efficient search sort(this.ids, this.coords, this.nodeSize, 0, this.numItems - 1, 0); this._finished = true; return this; } /** * Search the index for items within a given bounding box. * @param {number} minX * @param {number} minY * @param {number} maxX * @param {number} maxY * @returns {number[]} An array of indices correponding to the found items. */ range(minX, minY, maxX, maxY) { if (!this._finished) throw new Error('Data not yet indexed - call index.finish().'); const {ids, coords, nodeSize} = this; const stack = [0, ids.length - 1, 0]; const result = []; // recursively search for items in range in the kd-sorted arrays while (stack.length) { const axis = stack.pop() || 0; const right = stack.pop() || 0; const left = stack.pop() || 0; // if we reached "tree node", search linearly if (right - left <= nodeSize) { for (let i = left; i <= right; i++) { const x = coords[2 * i]; const y = coords[2 * i + 1]; if (x >= minX && x <= maxX && y >= minY && y <= maxY) result.push(ids[i]); } continue; } // otherwise find the middle index const m = (left + right) >> 1; // include the middle item if it's in range const x = coords[2 * m]; const y = coords[2 * m + 1]; if (x >= minX && x <= maxX && y >= minY && y <= maxY) result.push(ids[m]); // queue search in halves that intersect the query if (axis === 0 ? minX <= x : minY <= y) { stack.push(left); stack.push(m - 1); stack.push(1 - axis); } if (axis === 0 ? maxX >= x : maxY >= y) { stack.push(m + 1); stack.push(right); stack.push(1 - axis); } } return result; } /** * Search the index for items within a given radius. * @param {number} qx * @param {number} qy * @param {number} r Query radius. * @returns {number[]} An array of indices correponding to the found items. */ within(qx, qy, r) { if (!this._finished) throw new Error('Data not yet indexed - call index.finish().'); const {ids, coords, nodeSize} = this; const stack = [0, ids.length - 1, 0]; const result = []; const r2 = r * r; // recursively search for items within radius in the kd-sorted arrays while (stack.length) { const axis = stack.pop() || 0; const right = stack.pop() || 0; const left = stack.pop() || 0; // if we reached "tree node", search linearly if (right - left <= nodeSize) { for (let i = left; i <= right; i++) { if (sqDist(coords[2 * i], coords[2 * i + 1], qx, qy) <= r2) result.push(ids[i]); } continue; } // otherwise find the middle index const m = (left + right) >> 1; // include the middle item if it's in range const x = coords[2 * m]; const y = coords[2 * m + 1]; if (sqDist(x, y, qx, qy) <= r2) result.push(ids[m]); // queue search in halves that intersect the query if (axis === 0 ? qx - r <= x : qy - r <= y) { stack.push(left); stack.push(m - 1); stack.push(1 - axis); } if (axis === 0 ? qx + r >= x : qy + r >= y) { stack.push(m + 1); stack.push(right); stack.push(1 - axis); } } return result; } } /** * @param {Uint16Array | Uint32Array} ids * @param {InstanceType} coords * @param {number} nodeSize * @param {number} left * @param {number} right * @param {number} axis */ function sort(ids, coords, nodeSize, left, right, axis) { if (right - left <= nodeSize) return; const m = (left + right) >> 1; // middle index // sort ids and coords around the middle index so that the halves lie // either left/right or top/bottom correspondingly (taking turns) select(ids, coords, m, left, right, axis); // recursively kd-sort first half and second half on the opposite axis sort(ids, coords, nodeSize, left, m - 1, 1 - axis); sort(ids, coords, nodeSize, m + 1, right, 1 - axis); } /** * Custom Floyd-Rivest selection algorithm: sort ids and coords so that * [left..k-1] items are smaller than k-th item (on either x or y axis) * @param {Uint16Array | Uint32Array} ids * @param {InstanceType} coords * @param {number} k * @param {number} left * @param {number} right * @param {number} axis */ function select(ids, coords, k, left, right, axis) { while (right > left) { if (right - left > 600) { const n = right - left + 1; const m = k - left + 1; const z = Math.log(n); const s = 0.5 * Math.exp(2 * z / 3); const sd = 0.5 * Math.sqrt(z * s * (n - s) / n) * (m - n / 2 < 0 ? -1 : 1); const newLeft = Math.max(left, Math.floor(k - m * s / n + sd)); const newRight = Math.min(right, Math.floor(k + (n - m) * s / n + sd)); select(ids, coords, k, newLeft, newRight, axis); } const t = coords[2 * k + axis]; let i = left; let j = right; swapItem(ids, coords, left, k); if (coords[2 * right + axis] > t) swapItem(ids, coords, left, right); while (i < j) { swapItem(ids, coords, i, j); i++; j--; while (coords[2 * i + axis] < t) i++; while (coords[2 * j + axis] > t) j--; } if (coords[2 * left + axis] === t) swapItem(ids, coords, left, j); else { j++; swapItem(ids, coords, j, right); } if (j <= k) left = j + 1; if (k <= j) right = j - 1; } } /** * @param {Uint16Array | Uint32Array} ids * @param {InstanceType} coords * @param {number} i * @param {number} j */ function swapItem(ids, coords, i, j) { swap(ids, i, j); swap(coords, 2 * i, 2 * j); swap(coords, 2 * i + 1, 2 * j + 1); } /** * @param {InstanceType} arr * @param {number} i * @param {number} j */ function swap(arr, i, j) { const tmp = arr[i]; arr[i] = arr[j]; arr[j] = tmp; } /** * @param {number} ax * @param {number} ay * @param {number} bx * @param {number} by */ function sqDist(ax, ay, bx, by) { const dx = ax - bx; const dy = ay - by; return dx * dx + dy * dy; } /* 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; const KDBUSH_THRESHHOLD = 128; class TileLayerIndex { constructor(tileID, symbolInstances, bucketInstanceId) { this.tileID = tileID; this.bucketInstanceId = bucketInstanceId; this._symbolsByKey = {}; // group the symbolInstances by key const symbolInstancesByKey = new Map(); for (let i = 0; i < symbolInstances.length; i++) { const symbolInstance = symbolInstances.get(i); const key = symbolInstance.key; const instances = symbolInstancesByKey.get(key); if (instances) { // This tile may have multiple symbol instances with the same key // Store each one along with its coordinates instances.push(symbolInstance); } else { symbolInstancesByKey.set(key, [symbolInstance]); } } // index the SymbolInstances in this each bucket for (const [key, symbols] of symbolInstancesByKey) { const positions = symbols.map(symbolInstance => ({ x: Math.floor(symbolInstance.anchorX * roundingFactor), y: Math.floor(symbolInstance.anchorY * roundingFactor) })); const crossTileIDs = symbols.map(v => v.crossTileID); const entry = { positions, crossTileIDs }; // once we get too many symbols for a given key, it becomes much faster to index it before queries if (entry.positions.length > KDBUSH_THRESHHOLD) { const index = new KDBush(entry.positions.length, 16, Uint16Array); for (const { x, y } of entry.positions) index.add(x, y); index.finish(); // clear all references to the original positions data delete entry.positions; entry.index = index; } this._symbolsByKey[key] = entry; } } // Converts the coordinates of the input symbol instance into coordinates that be can compared // against other symbols in this index. Coordinates are: // (1) local-tile-based (so after correction we get x,y values relative to our local anchorX/Y) // (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, childTileID) { const { x: localX, y: localY, z: localZ } = this.tileID.canonical; const { x, y, z } = childTileID.canonical; const zDifference = z - localZ; const scale = roundingFactor / Math.pow(2, zDifference); const xWorld = (x * EXTENT + symbolInstance.anchorX) * scale; const yWorld = (y * EXTENT + symbolInstance.anchorY) * scale; const xOffset = localX * EXTENT * roundingFactor; const yOffset = localY * EXTENT * roundingFactor; const result = { x: Math.floor(xWorld - xOffset), y: Math.floor(yWorld - yOffset) }; return result; } findMatches(symbolInstances, newTileID, zoomCrossTileIDs) { 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 entry = this._symbolsByKey[symbolInstance.key]; if (!entry) { // No symbol with this key in this bucket continue; } const scaledSymbolCoord = this.getScaledCoordinates(symbolInstance, newTileID); if (entry.index) { // 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) const indexes = entry.index.range(scaledSymbolCoord.x - tolerance, scaledSymbolCoord.y - tolerance, scaledSymbolCoord.x + tolerance, scaledSymbolCoord.y + tolerance).sort(); for (const i of indexes) { const crossTileID = entry.crossTileIDs[i]; if (!zoomCrossTileIDs[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[crossTileID] = true; symbolInstance.crossTileID = crossTileID; break; } } } else if (entry.positions) { for (let i = 0; i < entry.positions.length; i++) { const thisTileSymbol = entry.positions[i]; const crossTileID = entry.crossTileIDs[i]; // 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.x - scaledSymbolCoord.x) <= tolerance && Math.abs(thisTileSymbol.y - scaledSymbolCoord.y) <= tolerance && !zoomCrossTileIDs[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[crossTileID] = true; symbolInstance.crossTileID = crossTileID; break; } } } } } getCrossTileIDsLists() { return Object.values(this._symbolsByKey).map(({ crossTileIDs }) => crossTileIDs); } } class CrossTileIDs { constructor() { this.maxCrossTileID = 0; } generate() { return ++this.maxCrossTileID; } } class CrossTileSymbolLayerIndex { 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) { 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, bucket, 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, removedBucket) { for (const crossTileIDs of removedBucket.getCrossTileIDsLists()) { for (const crossTileID of crossTileIDs) { delete this.usedCrossTileIDs[zoom][crossTileID]; } } } removeStaleBuckets(currentIDs) { 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 { constructor() { this.layerIndexes = {}; this.crossTileIDs = new CrossTileIDs(); this.maxBucketInstanceId = 0; this.bucketsInCurrentPlacement = {}; } addLayer(styleLayer, tiles, lng) { 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); 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) { const usedLayerMap = {}; usedLayers.forEach((usedLayer) => { usedLayerMap[usedLayer] = true; }); for (const layerId in this.layerIndexes) { if (!usedLayerMap[layerId]) { delete this.layerIndexes[layerId]; } } } } // We're skipping validation errors with the `source.canvas` identifier in order // to continue to allow canvas sources to be added at runtime/updated in // smart setStyle (see https://github.com/mapbox/mapbox-gl-js/pull/6424): const emitValidationErrors = (evented, errors) => emitValidationErrors$1(evented, errors && errors.filter(error => error.identifier !== 'source.canvas')); const empty = emptyStyle(); /** * The Style base class */ class Style extends Evented { constructor(map, options = {}) { super(); this._rtlPluginLoaded = () => { for (const id in this.sourceCaches) { const sourceType = this.sourceCaches[id].getSource().type; if (sourceType === 'vector' || sourceType === 'geojson') { // Non-vector sources don't have any symbols buckets to reload when the RTL text plugin loads // They also load more quickly, so they're more likely to have already displaying tiles // that would be unnecessarily booted by the plugin load event this.sourceCaches[id].reload(); // Should be a no-op if the plugin loads before any tiles load } } }; this.map = map; this.dispatcher = new Dispatcher(getGlobalWorkerPool(), map._getMapId()); this.dispatcher.registerMessageHandler("GG" /* MessageType.getGlyphs */, (mapId, params) => { return this.getGlyphs(mapId, params); }); this.dispatcher.registerMessageHandler("GI" /* MessageType.getImages */, (mapId, params) => { return this.getImages(mapId, params); }); this.imageManager = new ImageManager(); this.imageManager.setEventedParent(this); this.glyphManager = new GlyphManager(map._requestManager, options.localIdeographFontFamily); this.lineAtlas = new LineAtlas(256, 512); this.crossTileSymbolIndex = new CrossTileSymbolIndex(); this._spritesImagesIds = {}; this._layers = {}; this._order = []; this.sourceCaches = {}; this.zoomHistory = new ZoomHistory(); this._loaded = false; this._availableImages = []; this._resetUpdates(); this.dispatcher.broadcast("SR" /* MessageType.setReferrer */, getReferrer()); rtlMainThreadPluginFactory().on(RTLPluginLoadedEventName, this._rtlPluginLoaded); this.on('data', (event) => { if (event.dataType !== 'source' || event.sourceDataType !== 'metadata') { return; } const sourceCache = this.sourceCaches[event.sourceId]; if (!sourceCache) { return; } const source = sourceCache.getSource(); if (!source || !source.vectorLayerIds) { return; } for (const layerId in this._layers) { const layer = this._layers[layerId]; if (layer.source === source.id) { this._validateLayer(layer); } } }); } loadURL(url, options = {}, previousStyle) { this.fire(new Event('dataloading', { dataType: 'style' })); options.validate = typeof options.validate === 'boolean' ? options.validate : true; const request = this.map._requestManager.transformRequest(url, "Style" /* ResourceType.Style */); this._loadStyleRequest = new AbortController(); const abortController = this._loadStyleRequest; getJSON(request, this._loadStyleRequest).then((response) => { this._loadStyleRequest = null; this._load(response.data, options, previousStyle); }).catch((error) => { this._loadStyleRequest = null; if (error && !abortController.signal.aborted) { // ignore abort this.fire(new ErrorEvent(error)); } }); } loadJSON(json, options = {}, previousStyle) { this.fire(new Event('dataloading', { dataType: 'style' })); this._frameRequest = new AbortController(); browser.frameAsync(this._frameRequest).then(() => { this._frameRequest = null; options.validate = options.validate !== false; this._load(json, options, previousStyle); }).catch(() => { }); // ignore abort } loadEmpty() { this.fire(new Event('dataloading', { dataType: 'style' })); this._load(empty, { validate: false }); } _load(json, options, previousStyle) { var _a; const nextState = options.transformStyle ? options.transformStyle(previousStyle, json) : json; if (options.validate && emitValidationErrors(this, validateStyle(nextState))) { return; } this._loaded = true; this.stylesheet = nextState; for (const id in nextState.sources) { this.addSource(id, nextState.sources[id], { validate: false }); } if (nextState.sprite) { this._loadSprite(nextState.sprite); } else { this.imageManager.setLoaded(true); } this.glyphManager.setURL(nextState.glyphs); this._createLayers(); this.light = new Light(this.stylesheet.light); this.sky = new Sky(this.stylesheet.sky); this.map.setTerrain((_a = this.stylesheet.terrain) !== null && _a !== void 0 ? _a : null); this.fire(new Event('data', { dataType: 'style' })); this.fire(new Event('style.load')); } _createLayers() { const dereferencedLayers = derefLayers(this.stylesheet.layers); // Broadcast layers to workers first, so that expensive style processing (createStyleLayer) // can happen in parallel on both main and worker threads. this.dispatcher.broadcast("SL" /* MessageType.setLayers */, dereferencedLayers); this._order = dereferencedLayers.map((layer) => layer.id); this._layers = {}; // reset serialization field, to be populated only when needed this._serializedLayers = null; for (const layer of dereferencedLayers) { const styledLayer = createStyleLayer(layer); styledLayer.setEventedParent(this, { layer: { id: layer.id } }); this._layers[layer.id] = styledLayer; } } _loadSprite(sprite, isUpdate = false, completion = undefined) { this.imageManager.setLoaded(false); this._spriteRequest = new AbortController(); let err; loadSprite(sprite, this.map._requestManager, this.map.getPixelRatio(), this._spriteRequest).then((images) => { this._spriteRequest = null; if (images) { for (const spriteId in images) { this._spritesImagesIds[spriteId] = []; // remove old sprite's loaded images (for the same sprite id) that are not in new sprite const imagesToRemove = this._spritesImagesIds[spriteId] ? this._spritesImagesIds[spriteId].filter(id => !(id in images)) : []; for (const id of imagesToRemove) { this.imageManager.removeImage(id); this._changedImages[id] = true; } for (const id in images[spriteId]) { // don't prefix images of the "default" sprite const imageId = spriteId === 'default' ? id : `${spriteId}:${id}`; // save all the sprite's images' ids to be able to delete them in `removeSprite` this._spritesImagesIds[spriteId].push(imageId); if (imageId in this.imageManager.images) { this.imageManager.updateImage(imageId, images[spriteId][id], false); } else { this.imageManager.addImage(imageId, images[spriteId][id]); } if (isUpdate) { this._changedImages[imageId] = true; } } } } }).catch((error) => { this._spriteRequest = null; err = error; this.fire(new ErrorEvent(err)); }).finally(() => { this.imageManager.setLoaded(true); this._availableImages = this.imageManager.listImages(); if (isUpdate) { this._changed = true; } this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages); this.fire(new Event('data', { dataType: 'style' })); if (completion) { completion(err); } }); } _unloadSprite() { for (const id of Object.values(this._spritesImagesIds).flat()) { this.imageManager.removeImage(id); this._changedImages[id] = true; } this._spritesImagesIds = {}; this._availableImages = this.imageManager.listImages(); this._changed = true; this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages); this.fire(new Event('data', { dataType: 'style' })); } _validateLayer(layer) { const sourceCache = this.sourceCaches[layer.source]; if (!sourceCache) { return; } const sourceLayer = layer.sourceLayer; if (!sourceLayer) { return; } const source = sourceCache.getSource(); if (source.type === 'geojson' || (source.vectorLayerIds && source.vectorLayerIds.indexOf(sourceLayer) === -1)) { this.fire(new ErrorEvent(new Error(`Source layer "${sourceLayer}" ` + `does not exist on source "${source.id}" ` + `as specified by style layer "${layer.id}".`))); } } loaded() { if (!this._loaded) return false; if (Object.keys(this._updatedSources).length) return false; for (const id in this.sourceCaches) if (!this.sourceCaches[id].loaded()) return false; if (!this.imageManager.isLoaded()) return false; return true; } /** * @hidden * take an array of string IDs, and based on this._layers, generate an array of LayerSpecification * @param ids - an array of string IDs, for which serialized layers will be generated. If omitted, all serialized layers will be returned * @param returnClose - if true, return a clone of the layer object * @returns generated result */ _serializeByIds(ids, returnClone = false) { const serializedLayersDictionary = this._serializedAllLayers(); if (!ids || ids.length === 0) { return returnClone ? Object.values(clone$9(serializedLayersDictionary)) : Object.values(serializedLayersDictionary); } const serializedLayers = []; for (const id of ids) { // this check will skip all custom layers if (serializedLayersDictionary[id]) { const toPush = returnClone ? clone$9(serializedLayersDictionary[id]) : serializedLayersDictionary[id]; serializedLayers.push(toPush); } } return serializedLayers; } /** * @hidden * Lazy initialization of this._serializedLayers dictionary and return it * @returns this._serializedLayers dictionary */ _serializedAllLayers() { let serializedLayers = this._serializedLayers; if (serializedLayers) { return serializedLayers; } serializedLayers = this._serializedLayers = {}; const allLayerIds = Object.keys(this._layers); for (const layerId of allLayerIds) { const layer = this._layers[layerId]; if (layer.type !== 'custom') { serializedLayers[layerId] = layer.serialize(); } } return serializedLayers; } hasTransitions() { if (this.light && this.light.hasTransition()) { return true; } if (this.sky && this.sky.hasTransition()) { return true; } for (const id in this.sourceCaches) { if (this.sourceCaches[id].hasTransition()) { return true; } } for (const id in this._layers) { if (this._layers[id].hasTransition()) { return true; } } return false; } _checkLoaded() { if (!this._loaded) { throw new Error('Style is not done loading.'); } } /** * @internal * Apply queued style updates in a batch and recalculate zoom-dependent paint properties. */ update(parameters) { if (!this._loaded) { return; } const changed = this._changed; if (changed) { const updatedIds = Object.keys(this._updatedLayers); const removedIds = Object.keys(this._removedLayers); if (updatedIds.length || removedIds.length) { this._updateWorkerLayers(updatedIds, removedIds); } for (const id in this._updatedSources) { const action = this._updatedSources[id]; if (action === 'reload') { this._reloadSource(id); } else if (action === 'clear') { this._clearSource(id); } else { throw new Error(`Invalid action ${action}`); } } this._updateTilesForChangedImages(); this._updateTilesForChangedGlyphs(); for (const id in this._updatedPaintProps) { this._layers[id].updateTransitions(parameters); } this.light.updateTransitions(parameters); this.sky.updateTransitions(parameters); this._resetUpdates(); } const sourcesUsedBefore = {}; // save 'used' status to sourcesUsedBefore object and reset all sourceCaches 'used' field to false for (const sourceCacheId in this.sourceCaches) { const sourceCache = this.sourceCaches[sourceCacheId]; // sourceCache.used could be undefined, and sourcesUsedBefore[sourceCacheId] is also 'undefined' sourcesUsedBefore[sourceCacheId] = sourceCache.used; sourceCache.used = false; } // loop all layers and find layers that are not hidden at parameters.zoom // and set used to true in sourceCaches dictionary for the sources of these layers for (const layerId of this._order) { const layer = this._layers[layerId]; layer.recalculate(parameters, this._availableImages); if (!layer.isHidden(parameters.zoom) && layer.source) { this.sourceCaches[layer.source].used = true; } } // cross check sourcesUsedBefore against updated this.sourceCaches dictionary // if "used" field is different fire visibility event for (const sourcesUsedBeforeId in sourcesUsedBefore) { const sourceCache = this.sourceCaches[sourcesUsedBeforeId]; // (undefine !== false) will evaluate to true and fire an useless visibility event // need force "falsy" values to boolean to avoid the case above if (!!sourcesUsedBefore[sourcesUsedBeforeId] !== !!sourceCache.used) { sourceCache.fire(new Event('data', { sourceDataType: 'visibility', dataType: 'source', sourceId: sourcesUsedBeforeId })); } } this.light.recalculate(parameters); this.sky.recalculate(parameters); this.z = parameters.zoom; if (changed) { this.fire(new Event('data', { dataType: 'style' })); } } /* * Apply any queued image changes. */ _updateTilesForChangedImages() { const changedImages = Object.keys(this._changedImages); if (changedImages.length) { for (const name in this.sourceCaches) { this.sourceCaches[name].reloadTilesForDependencies(['icons', 'patterns'], changedImages); } this._changedImages = {}; } } _updateTilesForChangedGlyphs() { if (this._glyphsDidChange) { for (const name in this.sourceCaches) { this.sourceCaches[name].reloadTilesForDependencies(['glyphs'], ['']); } this._glyphsDidChange = false; } } _updateWorkerLayers(updatedIds, removedIds) { this.dispatcher.broadcast("UL" /* MessageType.updateLayers */, { layers: this._serializeByIds(updatedIds, false), removedIds }); } _resetUpdates() { this._changed = false; this._updatedLayers = {}; this._removedLayers = {}; this._updatedSources = {}; this._updatedPaintProps = {}; this._changedImages = {}; this._glyphsDidChange = false; } /** * Update this style's state to match the given style JSON, performing only * the necessary mutations. * * May throw an Error ('Unimplemented: METHOD') if the mapbox-gl-style-spec * diff algorithm produces an operation that is not supported. * * @returns true if any changes were made; false otherwise */ setState(nextState, options = {}) { var _a; this._checkLoaded(); const serializedStyle = this.serialize(); nextState = options.transformStyle ? options.transformStyle(serializedStyle, nextState) : nextState; const validate = (_a = options.validate) !== null && _a !== void 0 ? _a : true; if (validate && emitValidationErrors(this, validateStyle(nextState))) return false; nextState = clone$9(nextState); nextState.layers = derefLayers(nextState.layers); const changes = diffStyles(serializedStyle, nextState); const operations = this._getOperationsToPerform(changes); if (operations.unimplemented.length > 0) { throw new Error(`Unimplemented: ${operations.unimplemented.join(', ')}.`); } if (operations.operations.length === 0) { return false; } for (const styleChangeOperation of operations.operations) { styleChangeOperation(); } this.stylesheet = nextState; // reset serialization field, to be populated only when needed this._serializedLayers = null; return true; } _getOperationsToPerform(diff) { const operations = []; const unimplemented = []; for (const op of diff) { switch (op.command) { case 'setCenter': case 'setZoom': case 'setBearing': case 'setPitch': continue; case 'addLayer': operations.push(() => this.addLayer.apply(this, op.args)); break; case 'removeLayer': operations.push(() => this.removeLayer.apply(this, op.args)); break; case 'setPaintProperty': operations.push(() => this.setPaintProperty.apply(this, op.args)); break; case 'setLayoutProperty': operations.push(() => this.setLayoutProperty.apply(this, op.args)); break; case 'setFilter': operations.push(() => this.setFilter.apply(this, op.args)); break; case 'addSource': operations.push(() => this.addSource.apply(this, op.args)); break; case 'removeSource': operations.push(() => this.removeSource.apply(this, op.args)); break; case 'setLayerZoomRange': operations.push(() => this.setLayerZoomRange.apply(this, op.args)); break; case 'setLight': operations.push(() => this.setLight.apply(this, op.args)); break; case 'setGeoJSONSourceData': operations.push(() => this.setGeoJSONSourceData.apply(this, op.args)); break; case 'setGlyphs': operations.push(() => this.setGlyphs.apply(this, op.args)); break; case 'setSprite': operations.push(() => this.setSprite.apply(this, op.args)); break; case 'setSky': operations.push(() => this.setSky.apply(this, op.args)); break; case 'setTerrain': operations.push(() => this.map.setTerrain.apply(this, op.args)); break; case 'setTransition': operations.push(() => { }); break; default: unimplemented.push(op.command); break; } } return { operations, unimplemented }; } addImage(id, image) { if (this.getImage(id)) { return this.fire(new ErrorEvent(new Error(`An image named "${id}" already exists.`))); } this.imageManager.addImage(id, image); this._afterImageUpdated(id); } updateImage(id, image) { this.imageManager.updateImage(id, image); } getImage(id) { return this.imageManager.getImage(id); } removeImage(id) { if (!this.getImage(id)) { return this.fire(new ErrorEvent(new Error(`An image named "${id}" does not exist.`))); } this.imageManager.removeImage(id); this._afterImageUpdated(id); } _afterImageUpdated(id) { this._availableImages = this.imageManager.listImages(); this._changedImages[id] = true; this._changed = true; this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages); this.fire(new Event('data', { dataType: 'style' })); } listImages() { this._checkLoaded(); return this.imageManager.listImages(); } addSource(id, source, options = {}) { this._checkLoaded(); if (this.sourceCaches[id] !== undefined) { throw new Error(`Source "${id}" already exists.`); } if (!source.type) { throw new Error(`The type property must be defined, but only the following properties were given: ${Object.keys(source).join(', ')}.`); } const builtIns = ['vector', 'raster', 'geojson', 'video', 'image']; const shouldValidate = builtIns.indexOf(source.type) >= 0; if (shouldValidate && this._validate(validateStyle.source, `sources.${id}`, source, null, options)) return; if (this.map && this.map._collectResourceTiming) source.collectResourceTiming = true; const sourceCache = this.sourceCaches[id] = new SourceCache(id, source, this.dispatcher); sourceCache.style = this; sourceCache.setEventedParent(this, () => ({ isSourceLoaded: sourceCache.loaded(), source: sourceCache.serialize(), sourceId: id })); sourceCache.onAdd(this.map); this._changed = true; } /** * Remove a source from this stylesheet, given its id. * @param id - id of the source to remove * @throws if no source is found with the given ID */ removeSource(id) { this._checkLoaded(); if (this.sourceCaches[id] === undefined) { throw new Error('There is no source with this ID'); } for (const layerId in this._layers) { if (this._layers[layerId].source === id) { return this.fire(new ErrorEvent(new Error(`Source "${id}" cannot be removed while layer "${layerId}" is using it.`))); } } const sourceCache = this.sourceCaches[id]; delete this.sourceCaches[id]; delete this._updatedSources[id]; sourceCache.fire(new Event('data', { sourceDataType: 'metadata', dataType: 'source', sourceId: id })); sourceCache.setEventedParent(null); sourceCache.onRemove(this.map); this._changed = true; } /** * Set the data of a GeoJSON source, given its id. * @param id - id of the source * @param data - GeoJSON source */ setGeoJSONSourceData(id, data) { this._checkLoaded(); if (this.sourceCaches[id] === undefined) throw new Error(`There is no source with this ID=${id}`); const geojsonSource = this.sourceCaches[id].getSource(); if (geojsonSource.type !== 'geojson') throw new Error(`geojsonSource.type is ${geojsonSource.type}, which is !== 'geojson`); geojsonSource.setData(data); this._changed = true; } /** * Get a source by ID. * @param id - ID of the desired source * @returns source */ getSource(id) { return this.sourceCaches[id] && this.sourceCaches[id].getSource(); } /** * Add a layer to the map style. The layer will be inserted before the layer with * ID `before`, or appended if `before` is omitted. * @param layerObject - The style layer to add. * @param before - ID of an existing layer to insert before * @param options - Style setter options. */ addLayer(layerObject, before, options = {}) { this._checkLoaded(); const id = layerObject.id; if (this.getLayer(id)) { this.fire(new ErrorEvent(new Error(`Layer "${id}" already exists on this map.`))); return; } let layer; if (layerObject.type === 'custom') { if (emitValidationErrors(this, validateCustomStyleLayer(layerObject))) return; layer = createStyleLayer(layerObject); } else { if ('source' in layerObject && typeof layerObject.source === 'object') { this.addSource(id, layerObject.source); layerObject = clone$9(layerObject); layerObject = extend(layerObject, { source: id }); } // this layer is not in the style.layers array, so we pass an impossible array index if (this._validate(validateStyle.layer, `layers.${id}`, layerObject, { arrayIndex: -1 }, options)) return; layer = createStyleLayer(layerObject); this._validateLayer(layer); layer.setEventedParent(this, { layer: { id } }); } const index = before ? this._order.indexOf(before) : this._order.length; if (before && index === -1) { this.fire(new ErrorEvent(new Error(`Cannot add layer "${id}" before non-existing layer "${before}".`))); return; } this._order.splice(index, 0, id); this._layerOrderChanged = true; this._layers[id] = layer; if (this._removedLayers[id] && layer.source && layer.type !== 'custom') { // If, in the current batch, we have already removed this layer // and we are now re-adding it with a different `type`, then we // need to clear (rather than just reload) the underlying source's // tiles. Otherwise, tiles marked 'reloading' will have buckets / // buffers that are set up for the _previous_ version of this // layer, causing, e.g.: // https://github.com/mapbox/mapbox-gl-js/issues/3633 const removed = this._removedLayers[id]; delete this._removedLayers[id]; if (removed.type !== layer.type) { this._updatedSources[layer.source] = 'clear'; } else { this._updatedSources[layer.source] = 'reload'; this.sourceCaches[layer.source].pause(); } } this._updateLayer(layer); if (layer.onAdd) { layer.onAdd(this.map); } } /** * Moves a layer to a different z-position. The layer will be inserted before the layer with * ID `before`, or appended if `before` is omitted. * @param id - ID of the layer to move * @param before - ID of an existing layer to insert before */ moveLayer(id, before) { this._checkLoaded(); this._changed = true; const layer = this._layers[id]; if (!layer) { this.fire(new ErrorEvent(new Error(`The layer '${id}' does not exist in the map's style and cannot be moved.`))); return; } if (id === before) { return; } const index = this._order.indexOf(id); this._order.splice(index, 1); const newIndex = before ? this._order.indexOf(before) : this._order.length; if (before && newIndex === -1) { this.fire(new ErrorEvent(new Error(`Cannot move layer "${id}" before non-existing layer "${before}".`))); return; } this._order.splice(newIndex, 0, id); this._layerOrderChanged = true; } /** * Remove the layer with the given id from the style. * A {@link ErrorEvent} event will be fired if no such layer exists. * * @param id - id of the layer to remove */ removeLayer(id) { this._checkLoaded(); const layer = this._layers[id]; if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot remove non-existing layer "${id}".`))); return; } layer.setEventedParent(null); const index = this._order.indexOf(id); this._order.splice(index, 1); this._layerOrderChanged = true; this._changed = true; this._removedLayers[id] = layer; delete this._layers[id]; if (this._serializedLayers) { delete this._serializedLayers[id]; } delete this._updatedLayers[id]; delete this._updatedPaintProps[id]; if (layer.onRemove) { layer.onRemove(this.map); } } /** * Return the style layer object with the given `id`. * * @param id - id of the desired layer * @returns a layer, if one with the given `id` exists */ getLayer(id) { return this._layers[id]; } /** * Return the ids of all layers currently in the style, including custom layers, in order. * * @returns ids of layers, in order */ getLayersOrder() { return [...this._order]; } /** * Checks if a specific layer is present within the style. * * @param id - the id of the desired layer * @returns a boolean specifying if the given layer is present */ hasLayer(id) { return id in this._layers; } setLayerZoomRange(layerId, minzoom, maxzoom) { this._checkLoaded(); const layer = this.getLayer(layerId); if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot set the zoom range of non-existing layer "${layerId}".`))); return; } if (layer.minzoom === minzoom && layer.maxzoom === maxzoom) return; if (minzoom != null) { layer.minzoom = minzoom; } if (maxzoom != null) { layer.maxzoom = maxzoom; } this._updateLayer(layer); } setFilter(layerId, filter, options = {}) { this._checkLoaded(); const layer = this.getLayer(layerId); if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot filter non-existing layer "${layerId}".`))); return; } if (deepEqual$1(layer.filter, filter)) { return; } if (filter === null || filter === undefined) { layer.filter = undefined; this._updateLayer(layer); return; } if (this._validate(validateStyle.filter, `layers.${layer.id}.filter`, filter, null, options)) { return; } layer.filter = clone$9(filter); this._updateLayer(layer); } /** * Get a layer's filter object * @param layer - the layer to inspect * @returns the layer's filter, if any */ getFilter(layer) { return clone$9(this.getLayer(layer).filter); } setLayoutProperty(layerId, name, value, options = {}) { this._checkLoaded(); const layer = this.getLayer(layerId); if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot style non-existing layer "${layerId}".`))); return; } if (deepEqual$1(layer.getLayoutProperty(name), value)) return; layer.setLayoutProperty(name, value, options); this._updateLayer(layer); } /** * Get a layout property's value from a given layer * @param layerId - the layer to inspect * @param name - the name of the layout property * @returns the property value */ getLayoutProperty(layerId, name) { const layer = this.getLayer(layerId); if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot get style of non-existing layer "${layerId}".`))); return; } return layer.getLayoutProperty(name); } setPaintProperty(layerId, name, value, options = {}) { this._checkLoaded(); const layer = this.getLayer(layerId); if (!layer) { this.fire(new ErrorEvent(new Error(`Cannot style non-existing layer "${layerId}".`))); return; } if (deepEqual$1(layer.getPaintProperty(name), value)) return; const requiresRelayout = layer.setPaintProperty(name, value, options); if (requiresRelayout) { this._updateLayer(layer); } this._changed = true; this._updatedPaintProps[layerId] = true; // reset serialization field, to be populated only when needed this._serializedLayers = null; } getPaintProperty(layer, name) { return this.getLayer(layer).getPaintProperty(name); } setFeatureState(target, state) { this._checkLoaded(); const sourceId = target.source; const sourceLayer = target.sourceLayer; const sourceCache = this.sourceCaches[sourceId]; if (sourceCache === undefined) { this.fire(new ErrorEvent(new Error(`The source '${sourceId}' does not exist in the map's style.`))); return; } const sourceType = sourceCache.getSource().type; if (sourceType === 'geojson' && sourceLayer) { this.fire(new ErrorEvent(new Error('GeoJSON sources cannot have a sourceLayer parameter.'))); return; } if (sourceType === 'vector' && !sourceLayer) { this.fire(new ErrorEvent(new Error('The sourceLayer parameter must be provided for vector source types.'))); return; } if (target.id === undefined) { this.fire(new ErrorEvent(new Error('The feature id parameter must be provided.'))); } sourceCache.setFeatureState(sourceLayer, target.id, state); } removeFeatureState(target, key) { this._checkLoaded(); const sourceId = target.source; const sourceCache = this.sourceCaches[sourceId]; if (sourceCache === undefined) { this.fire(new ErrorEvent(new Error(`The source '${sourceId}' does not exist in the map's style.`))); return; } const sourceType = sourceCache.getSource().type; const sourceLayer = sourceType === 'vector' ? target.sourceLayer : undefined; if (sourceType === 'vector' && !sourceLayer) { this.fire(new ErrorEvent(new Error('The sourceLayer parameter must be provided for vector source types.'))); return; } if (key && (typeof target.id !== 'string' && typeof target.id !== 'number')) { this.fire(new ErrorEvent(new Error('A feature id is required to remove its specific state property.'))); return; } sourceCache.removeFeatureState(sourceLayer, target.id, key); } getFeatureState(target) { this._checkLoaded(); const sourceId = target.source; const sourceLayer = target.sourceLayer; const sourceCache = this.sourceCaches[sourceId]; if (sourceCache === undefined) { this.fire(new ErrorEvent(new Error(`The source '${sourceId}' does not exist in the map's style.`))); return; } const sourceType = sourceCache.getSource().type; if (sourceType === 'vector' && !sourceLayer) { this.fire(new ErrorEvent(new Error('The sourceLayer parameter must be provided for vector source types.'))); return; } if (target.id === undefined) { this.fire(new ErrorEvent(new Error('The feature id parameter must be provided.'))); } return sourceCache.getFeatureState(sourceLayer, target.id); } getTransition() { return extend({ duration: 300, delay: 0 }, this.stylesheet && this.stylesheet.transition); } serialize() { // We return undefined before we're loaded, following the pattern of Map.getStyle() before // the Style object is initialized. // Internally, Style._validate() calls Style.serialize() but callers are responsible for // calling Style._checkLoaded() first if their validation requires the style to be loaded. if (!this._loaded) return; const sources = mapObject(this.sourceCaches, (source) => source.serialize()); const layers = this._serializeByIds(this._order, true); const terrain = this.map.getTerrain() || undefined; const myStyleSheet = this.stylesheet; return filterObject({ version: myStyleSheet.version, name: myStyleSheet.name, metadata: myStyleSheet.metadata, light: myStyleSheet.light, sky: myStyleSheet.sky, center: myStyleSheet.center, zoom: myStyleSheet.zoom, bearing: myStyleSheet.bearing, pitch: myStyleSheet.pitch, sprite: myStyleSheet.sprite, glyphs: myStyleSheet.glyphs, transition: myStyleSheet.transition, sources, layers, terrain }, (value) => { return value !== undefined; }); } _updateLayer(layer) { this._updatedLayers[layer.id] = true; if (layer.source && !this._updatedSources[layer.source] && //Skip for raster layers (https://github.com/mapbox/mapbox-gl-js/issues/7865) this.sourceCaches[layer.source].getSource().type !== 'raster') { this._updatedSources[layer.source] = 'reload'; this.sourceCaches[layer.source].pause(); } // upon updating, serialized layer dictionary should be reset. // When needed, it will be populated with the correct copy again. this._serializedLayers = null; this._changed = true; } _flattenAndSortRenderedFeatures(sourceResults) { // Feature order is complicated. // The order between features in two 2D layers is always determined by layer order. // The order between features in two 3D layers is always determined by depth. // The order between a feature in a 2D layer and a 3D layer is tricky: // Most often layer order determines the feature order in this case. If // a line layer is above a extrusion layer the line feature will be rendered // above the extrusion. If the line layer is below the extrusion layer, // it will be rendered below it. // // There is a weird case though. // You have layers in this order: extrusion_layer_a, line_layer, extrusion_layer_b // Each layer has a feature that overlaps the other features. // The feature in extrusion_layer_a is closer than the feature in extrusion_layer_b so it is rendered above. // The feature in line_layer is rendered above extrusion_layer_a. // This means that that the line_layer feature is above the extrusion_layer_b feature despite // it being in an earlier layer. const isLayer3D = layerId => this._layers[layerId].type === 'fill-extrusion'; const layerIndex = {}; const features3D = []; for (let l = this._order.length - 1; l >= 0; l--) { const layerId = this._order[l]; if (isLayer3D(layerId)) { layerIndex[layerId] = l; for (const sourceResult of sourceResults) { const layerFeatures = sourceResult[layerId]; if (layerFeatures) { for (const featureWrapper of layerFeatures) { features3D.push(featureWrapper); } } } } } features3D.sort((a, b) => { return b.intersectionZ - a.intersectionZ; }); const features = []; for (let l = this._order.length - 1; l >= 0; l--) { const layerId = this._order[l]; if (isLayer3D(layerId)) { // add all 3D features that are in or above the current layer for (let i = features3D.length - 1; i >= 0; i--) { const topmost3D = features3D[i].feature; if (layerIndex[topmost3D.layer.id] < l) break; features.push(topmost3D); features3D.pop(); } } else { for (const sourceResult of sourceResults) { const layerFeatures = sourceResult[layerId]; if (layerFeatures) { for (const featureWrapper of layerFeatures) { features.push(featureWrapper.feature); } } } } } return features; } queryRenderedFeatures(queryGeometry, params, transform) { if (params && params.filter) { this._validate(validateStyle.filter, 'queryRenderedFeatures.filter', params.filter, null, params); } const includedSources = {}; if (params && params.layers) { if (!Array.isArray(params.layers)) { this.fire(new ErrorEvent(new Error('parameters.layers must be an Array.'))); return []; } for (const layerId of params.layers) { const layer = this._layers[layerId]; if (!layer) { // this layer is not in the style.layers array this.fire(new ErrorEvent(new Error(`The layer '${layerId}' does not exist in the map's style and cannot be queried for features.`))); return []; } includedSources[layer.source] = true; } } const sourceResults = []; params.availableImages = this._availableImages; // LayerSpecification is serialized StyleLayer, and this casting is safe. const serializedLayers = this._serializedAllLayers(); for (const id in this.sourceCaches) { if (params.layers && !includedSources[id]) continue; sourceResults.push(queryRenderedFeatures(this.sourceCaches[id], this._layers, serializedLayers, queryGeometry, params, transform)); } if (this.placement) { // If a placement has run, query against its CollisionIndex // for symbol results, and treat it as an extra source to merge sourceResults.push(queryRenderedSymbols(this._layers, serializedLayers, this.sourceCaches, queryGeometry, params, this.placement.collisionIndex, this.placement.retainedQueryData)); } return this._flattenAndSortRenderedFeatures(sourceResults); } querySourceFeatures(sourceID, params) { if (params && params.filter) { this._validate(validateStyle.filter, 'querySourceFeatures.filter', params.filter, null, params); } const sourceCache = this.sourceCaches[sourceID]; return sourceCache ? querySourceFeatures(sourceCache, params) : []; } getLight() { return this.light.getLight(); } setLight(lightOptions, options = {}) { this._checkLoaded(); const light = this.light.getLight(); let _update = false; for (const key in lightOptions) { if (!deepEqual$1(lightOptions[key], light[key])) { _update = true; break; } } if (!_update) return; const parameters = { now: browser.now(), transition: extend({ duration: 300, delay: 0 }, this.stylesheet.transition) }; this.light.setLight(lightOptions, options); this.light.updateTransitions(parameters); } getSky() { var _a; return (_a = this.stylesheet) === null || _a === void 0 ? void 0 : _a.sky; } setSky(skyOptions, options = {}) { const sky = this.getSky(); let update = false; if (!skyOptions && !sky) return; if (skyOptions && !sky) { update = true; } else if (!skyOptions && sky) { update = true; } else { for (const key in skyOptions) { if (!deepEqual$1(skyOptions[key], sky[key])) { update = true; break; } } } if (!update) return; const parameters = { now: browser.now(), transition: extend({ duration: 300, delay: 0 }, this.stylesheet.transition) }; this.stylesheet.sky = skyOptions; this.sky.setSky(skyOptions, options); this.sky.updateTransitions(parameters); } _validate(validate, key, value, props, options = {}) { if (options && options.validate === false) { return false; } return emitValidationErrors(this, validate.call(validateStyle, extend({ key, style: this.serialize(), value, styleSpec: v8Spec }, props))); } _remove(mapRemoved = true) { if (this._frameRequest) { this._frameRequest.abort(); this._frameRequest = null; } if (this._loadStyleRequest) { this._loadStyleRequest.abort(); this._loadStyleRequest = null; } if (this._spriteRequest) { this._spriteRequest.abort(); this._spriteRequest = null; } rtlMainThreadPluginFactory().off(RTLPluginLoadedEventName, this._rtlPluginLoaded); for (const layerId in this._layers) { const layer = this._layers[layerId]; layer.setEventedParent(null); } for (const id in this.sourceCaches) { const sourceCache = this.sourceCaches[id]; sourceCache.setEventedParent(null); sourceCache.onRemove(this.map); } this.imageManager.setEventedParent(null); this.setEventedParent(null); if (mapRemoved) { this.dispatcher.broadcast("RM" /* MessageType.removeMap */, undefined); } this.dispatcher.remove(mapRemoved); } _clearSource(id) { this.sourceCaches[id].clearTiles(); } _reloadSource(id) { this.sourceCaches[id].resume(); this.sourceCaches[id].reload(); } _updateSources(transform) { for (const id in this.sourceCaches) { this.sourceCaches[id].update(transform, this.map.terrain); } } _generateCollisionBoxes() { for (const id in this.sourceCaches) { this._reloadSource(id); } } _updatePlacement(transform, showCollisionBoxes, fadeDuration, crossSourceCollisions, forceFullPlacement = false) { let symbolBucketsChanged = false; let placementCommitted = false; const layerTiles = {}; for (const layerID of this._order) { const styleLayer = this._layers[layerID]; if (styleLayer.type !== 'symbol') continue; if (!layerTiles[styleLayer.source]) { const sourceCache = this.sourceCaches[styleLayer.source]; layerTiles[styleLayer.source] = sourceCache.getRenderableIds(true) .map((id) => sourceCache.getTileByID(id)) .sort((a, b) => (b.tileID.overscaledZ - a.tileID.overscaledZ) || (a.tileID.isLessThan(b.tileID) ? -1 : 1)); } const layerBucketsChanged = this.crossTileSymbolIndex.addLayer(styleLayer, layerTiles[styleLayer.source], transform.center.lng); symbolBucketsChanged = symbolBucketsChanged || layerBucketsChanged; } this.crossTileSymbolIndex.pruneUnusedLayers(this._order); // Anything that changes our "in progress" layer and tile indices requires us // to start over. When we start over, we do a full placement instead of incremental // to prevent starvation. // We need to restart placement to keep layer indices in sync. // Also force full placement when fadeDuration === 0 to ensure that newly loaded // tiles will fully display symbols in their first frame forceFullPlacement = forceFullPlacement || this._layerOrderChanged || fadeDuration === 0; if (forceFullPlacement || !this.pauseablePlacement || (this.pauseablePlacement.isDone() && !this.placement.stillRecent(browser.now(), transform.zoom))) { this.pauseablePlacement = new PauseablePlacement(transform, this.map.terrain, this._order, forceFullPlacement, showCollisionBoxes, fadeDuration, crossSourceCollisions, this.placement); this._layerOrderChanged = false; } if (this.pauseablePlacement.isDone()) { // the last placement finished running, but the next one hasn’t // started yet because of the `stillRecent` check immediately // above, so mark it stale to ensure that we request another // render frame this.placement.setStale(); } else { this.pauseablePlacement.continuePlacement(this._order, this._layers, layerTiles); if (this.pauseablePlacement.isDone()) { this.placement = this.pauseablePlacement.commit(browser.now()); placementCommitted = true; } if (symbolBucketsChanged) { // since the placement gets split over multiple frames it is possible // these buckets were processed before they were changed and so the // placement is already stale while it is in progress this.pauseablePlacement.placement.setStale(); } } if (placementCommitted || symbolBucketsChanged) { for (const layerID of this._order) { const styleLayer = this._layers[layerID]; if (styleLayer.type !== 'symbol') continue; this.placement.updateLayerOpacities(styleLayer, layerTiles[styleLayer.source]); } } // needsRender is false when we have just finished a placement that didn't change the visibility of any symbols const needsRerender = !this.pauseablePlacement.isDone() || this.placement.hasTransitions(browser.now()); return needsRerender; } _releaseSymbolFadeTiles() { for (const id in this.sourceCaches) { this.sourceCaches[id].releaseSymbolFadeTiles(); } } // Callbacks from web workers getImages(mapId, params) { return __awaiter(this, void 0, void 0, function* () { const images = yield this.imageManager.getImages(params.icons); // Apply queued image changes before setting the tile's dependencies so that the tile // is not reloaded unnecessarily. Without this forced update the reload could happen in cases // like this one: // - icons contains "my-image" // - imageManager.getImages(...) triggers `onstyleimagemissing` // - the user adds "my-image" within the callback // - addImage adds "my-image" to this._changedImages // - the next frame triggers a reload of this tile even though it already has the latest version this._updateTilesForChangedImages(); const sourceCache = this.sourceCaches[params.source]; if (sourceCache) { sourceCache.setDependencies(params.tileID.key, params.type, params.icons); } return images; }); } getGlyphs(mapId, params) { return __awaiter(this, void 0, void 0, function* () { const glypgs = yield this.glyphManager.getGlyphs(params.stacks); const sourceCache = this.sourceCaches[params.source]; if (sourceCache) { // we are not setting stacks as dependencies since for now // we just need to know which tiles have glyph dependencies sourceCache.setDependencies(params.tileID.key, params.type, ['']); } return glypgs; }); } getGlyphsUrl() { return this.stylesheet.glyphs || null; } setGlyphs(glyphsUrl, options = {}) { this._checkLoaded(); if (glyphsUrl && this._validate(validateStyle.glyphs, 'glyphs', glyphsUrl, null, options)) { return; } this._glyphsDidChange = true; this.stylesheet.glyphs = glyphsUrl; this.glyphManager.entries = {}; this.glyphManager.setURL(glyphsUrl); } /** * Add a sprite. * * @param id - The id of the desired sprite * @param url - The url to load the desired sprite from * @param options - The style setter options * @param completion - The completion handler */ addSprite(id, url, options = {}, completion) { this._checkLoaded(); const spriteToAdd = [{ id, url }]; const updatedSprite = [ ...coerceSpriteToArray(this.stylesheet.sprite), ...spriteToAdd ]; if (this._validate(validateStyle.sprite, 'sprite', updatedSprite, null, options)) return; this.stylesheet.sprite = updatedSprite; this._loadSprite(spriteToAdd, true, completion); } /** * Remove a sprite by its id. When the last sprite is removed, the whole `this.stylesheet.sprite` object becomes * `undefined`. This falsy `undefined` value later prevents attempts to load the sprite when it's absent. * * @param id - the id of the sprite to remove */ removeSprite(id) { this._checkLoaded(); const internalSpriteRepresentation = coerceSpriteToArray(this.stylesheet.sprite); if (!internalSpriteRepresentation.find(sprite => sprite.id === id)) { this.fire(new ErrorEvent(new Error(`Sprite "${id}" doesn't exists on this map.`))); return; } if (this._spritesImagesIds[id]) { for (const imageId of this._spritesImagesIds[id]) { this.imageManager.removeImage(imageId); this._changedImages[imageId] = true; } } internalSpriteRepresentation.splice(internalSpriteRepresentation.findIndex(sprite => sprite.id === id), 1); this.stylesheet.sprite = internalSpriteRepresentation.length > 0 ? internalSpriteRepresentation : undefined; delete this._spritesImagesIds[id]; this._availableImages = this.imageManager.listImages(); this._changed = true; this.dispatcher.broadcast("SI" /* MessageType.setImages */, this._availableImages); this.fire(new Event('data', { dataType: 'style' })); } /** * Get the current sprite value. * * @returns empty array when no sprite is set; id-url pairs otherwise */ getSprite() { return coerceSpriteToArray(this.stylesheet.sprite); } /** * Set a new value for the style's sprite. * * @param sprite - new sprite value * @param options - style setter options * @param completion - the completion handler */ setSprite(sprite, options = {}, completion) { this._checkLoaded(); if (sprite && this._validate(validateStyle.sprite, 'sprite', sprite, null, options)) { return; } this.stylesheet.sprite = sprite; if (sprite) { this._loadSprite(sprite, true, completion); } else { this._unloadSprite(); if (completion) { completion(null); } } } } var posAttributes = createLayout([ { name: 'a_pos', type: 'Int16', components: 2 } ]); // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var preludeFrag = '#ifdef GL_ES\nprecision mediump float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif\n'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var preludeVert = '#ifdef GL_ES\nprecision highp float;\n#else\n#if !defined(lowp)\n#define lowp\n#endif\n#if !defined(mediump)\n#define mediump\n#endif\n#if !defined(highp)\n#define highp\n#endif\n#endif\nvec2 unpack_float(const float packedValue) {int packedIntValue=int(packedValue);int v0=packedIntValue/256;return vec2(v0,packedIntValue-v0*256);}vec2 unpack_opacity(const float packedOpacity) {int intOpacity=int(packedOpacity)/2;return vec2(float(intOpacity)/127.0,mod(packedOpacity,2.0));}vec4 decode_color(const vec2 encodedColor) {return vec4(unpack_float(encodedColor[0])/255.0,unpack_float(encodedColor[1])/255.0\n);}float unpack_mix_vec2(const vec2 packedValue,const float t) {return mix(packedValue[0],packedValue[1],t);}vec4 unpack_mix_color(const vec4 packedColors,const float t) {vec4 minColor=decode_color(vec2(packedColors[0],packedColors[1]));vec4 maxColor=decode_color(vec2(packedColors[2],packedColors[3]));return mix(minColor,maxColor,t);}vec2 get_pattern_pos(const vec2 pixel_coord_upper,const vec2 pixel_coord_lower,const vec2 pattern_size,const float tile_units_to_pixels,const vec2 pos) {vec2 offset=mod(mod(mod(pixel_coord_upper,pattern_size)*256.0,pattern_size)*256.0+pixel_coord_lower,pattern_size);return (tile_units_to_pixels*pos+offset)/pattern_size;}\n#ifdef TERRAIN3D\nuniform sampler2D u_terrain;uniform float u_terrain_dim;uniform mat4 u_terrain_matrix;uniform vec4 u_terrain_unpack;uniform float u_terrain_exaggeration;uniform highp sampler2D u_depth;\n#endif\nconst highp vec4 bitSh=vec4(256.*256.*256.,256.*256.,256.,1.);const highp vec4 bitShifts=vec4(1.)/bitSh;highp float unpack(highp vec4 color) {return dot(color,bitShifts);}highp float depthOpacity(vec3 frag) {\n#ifdef TERRAIN3D\nhighp float d=unpack(texture2D(u_depth,frag.xy*0.5+0.5))+0.0001-frag.z;return 1.0-max(0.0,min(1.0,-d*500.0));\n#else\nreturn 1.0;\n#endif\n}float calculate_visibility(vec4 pos) {\n#ifdef TERRAIN3D\nvec3 frag=pos.xyz/pos.w;highp float d=depthOpacity(frag);if (d > 0.95) return 1.0;return (d+depthOpacity(frag+vec3(0.0,0.01,0.0)))/2.0;\n#else\nreturn 1.0;\n#endif\n}float ele(vec2 pos) {\n#ifdef TERRAIN3D\nvec4 rgb=(texture2D(u_terrain,pos)*255.0)*u_terrain_unpack;return rgb.r+rgb.g+rgb.b-u_terrain_unpack.a;\n#else\nreturn 0.0;\n#endif\n}float get_elevation(vec2 pos) {\n#ifdef TERRAIN3D\nvec2 coord=(u_terrain_matrix*vec4(pos,0.0,1.0)).xy*u_terrain_dim+1.0;vec2 f=fract(coord);vec2 c=(floor(coord)+0.5)/(u_terrain_dim+2.0);float d=1.0/(u_terrain_dim+2.0);float tl=ele(c);float tr=ele(c+vec2(d,0.0));float bl=ele(c+vec2(0.0,d));float br=ele(c+vec2(d,d));float elevation=mix(mix(tl,tr,f.x),mix(bl,br,f.x),f.y);return elevation*u_terrain_exaggeration;\n#else\nreturn 0.0;\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var backgroundFrag = 'uniform vec4 u_color;uniform float u_opacity;void main() {gl_FragColor=u_color*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var backgroundVert = 'attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var backgroundPatternFrag = 'uniform vec2 u_pattern_tl_a;uniform vec2 u_pattern_br_a;uniform vec2 u_pattern_tl_b;uniform vec2 u_pattern_br_b;uniform vec2 u_texsize;uniform float u_mix;uniform float u_opacity;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(u_pattern_tl_a/u_texsize,u_pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(u_pattern_tl_b/u_texsize,u_pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_mix)*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var backgroundPatternVert = 'uniform mat4 u_matrix;uniform vec2 u_pattern_size_a;uniform vec2 u_pattern_size_b;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_scale_a;uniform float u_scale_b;uniform float u_tile_units_to_pixels;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_a*u_pattern_size_a,u_tile_units_to_pixels,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,u_scale_b*u_pattern_size_b,u_tile_units_to_pixels,a_pos);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var circleFrag = 'varying vec3 v_data;varying float v_visibility;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define mediump float radius\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define highp vec4 stroke_color\n#pragma mapbox: define mediump float stroke_width\n#pragma mapbox: define lowp float stroke_opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize mediump float radius\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize highp vec4 stroke_color\n#pragma mapbox: initialize mediump float stroke_width\n#pragma mapbox: initialize lowp float stroke_opacity\nvec2 extrude=v_data.xy;float extrude_length=length(extrude);lowp float antialiasblur=v_data.z;float antialiased_blur=-max(blur,antialiasblur);float opacity_t=smoothstep(0.0,antialiased_blur,extrude_length-1.0);float color_t=stroke_width < 0.01 ? 0.0 : smoothstep(antialiased_blur,0.0,extrude_length-radius/(radius+stroke_width));gl_FragColor=v_visibility*opacity_t*mix(color*opacity,stroke_color*stroke_opacity,color_t);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var circleVert = 'uniform mat4 u_matrix;uniform bool u_scale_with_map;uniform bool u_pitch_with_map;uniform vec2 u_extrude_scale;uniform lowp float u_device_pixel_ratio;uniform highp float u_camera_to_center_distance;attribute vec2 a_pos;varying vec3 v_data;varying float v_visibility;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define mediump float radius\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define highp vec4 stroke_color\n#pragma mapbox: define mediump float stroke_width\n#pragma mapbox: define lowp float stroke_opacity\nvoid main(void) {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize mediump float radius\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize highp vec4 stroke_color\n#pragma mapbox: initialize mediump float stroke_width\n#pragma mapbox: initialize lowp float stroke_opacity\nvec2 extrude=vec2(mod(a_pos,2.0)*2.0-1.0);vec2 circle_center=floor(a_pos*0.5);float ele=get_elevation(circle_center);v_visibility=calculate_visibility(u_matrix*vec4(circle_center,ele,1.0));if (u_pitch_with_map) {vec2 corner_position=circle_center;if (u_scale_with_map) {corner_position+=extrude*(radius+stroke_width)*u_extrude_scale;} else {vec4 projected_center=u_matrix*vec4(circle_center,0,1);corner_position+=extrude*(radius+stroke_width)*u_extrude_scale*(projected_center.w/u_camera_to_center_distance);}gl_Position=u_matrix*vec4(corner_position,ele,1);} else {gl_Position=u_matrix*vec4(circle_center,ele,1);if (u_scale_with_map) {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*u_camera_to_center_distance;} else {gl_Position.xy+=extrude*(radius+stroke_width)*u_extrude_scale*gl_Position.w;}}lowp float antialiasblur=1.0/u_device_pixel_ratio/(radius+stroke_width);v_data=vec3(extrude.x,extrude.y,antialiasblur);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var clippingMaskFrag = 'void main() {gl_FragColor=vec4(1.0);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var clippingMaskVert = 'attribute vec2 a_pos;uniform mat4 u_matrix;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var heatmapFrag = 'uniform highp float u_intensity;varying vec2 v_extrude;\n#pragma mapbox: define highp float weight\n#define GAUSS_COEF 0.3989422804014327\nvoid main() {\n#pragma mapbox: initialize highp float weight\nfloat d=-0.5*3.0*3.0*dot(v_extrude,v_extrude);float val=weight*u_intensity*GAUSS_COEF*exp(d);gl_FragColor=vec4(val,1.0,1.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var heatmapVert = 'uniform mat4 u_matrix;uniform float u_extrude_scale;uniform float u_opacity;uniform float u_intensity;attribute vec2 a_pos;varying vec2 v_extrude;\n#pragma mapbox: define highp float weight\n#pragma mapbox: define mediump float radius\nconst highp float ZERO=1.0/255.0/16.0;\n#define GAUSS_COEF 0.3989422804014327\nvoid main(void) {\n#pragma mapbox: initialize highp float weight\n#pragma mapbox: initialize mediump float radius\nvec2 unscaled_extrude=vec2(mod(a_pos,2.0)*2.0-1.0);float S=sqrt(-2.0*log(ZERO/weight/u_intensity/GAUSS_COEF))/3.0;v_extrude=S*unscaled_extrude;vec2 extrude=v_extrude*radius*u_extrude_scale;vec4 pos=vec4(floor(a_pos*0.5)+extrude,get_elevation(floor(a_pos*0.5)),1);gl_Position=u_matrix*pos;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var heatmapTextureFrag = 'uniform sampler2D u_image;uniform sampler2D u_color_ramp;uniform float u_opacity;varying vec2 v_pos;void main() {float t=texture2D(u_image,v_pos).r;vec4 color=texture2D(u_color_ramp,vec2(t,0.5));gl_FragColor=color*u_opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(0.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var heatmapTextureVert = 'uniform mat4 u_matrix;uniform vec2 u_world;attribute vec2 a_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos*u_world,0,1);v_pos.x=a_pos.x;v_pos.y=1.0-a_pos.y;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var collisionBoxFrag = 'varying float v_placed;varying float v_notUsed;void main() {float alpha=0.5;gl_FragColor=vec4(1.0,0.0,0.0,1.0)*alpha;if (v_placed > 0.5) {gl_FragColor=vec4(0.0,0.0,1.0,0.5)*alpha;}if (v_notUsed > 0.5) {gl_FragColor*=.1;}}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var collisionBoxVert = 'attribute vec2 a_anchor_pos;attribute vec2 a_placed;attribute vec2 a_box_real;uniform mat4 u_matrix;uniform vec2 u_pixel_extrude_scale;varying float v_placed;varying float v_notUsed;vec4 projectTileWithElevation(vec2 posInTile,float elevation) {return u_matrix*vec4(posInTile,elevation,1.0);}void main() {gl_Position=projectTileWithElevation(a_anchor_pos,get_elevation(a_anchor_pos));gl_Position.xy=((a_box_real+0.5)*u_pixel_extrude_scale*2.0-1.0)*vec2(1.0,-1.0)*gl_Position.w;if (gl_Position.z/gl_Position.w < 1.1) {gl_Position.z=0.5;}v_placed=a_placed.x;v_notUsed=a_placed.y;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var collisionCircleFrag = 'varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;void main() {float alpha=0.5*min(v_perspective_ratio,1.0);float stroke_radius=0.9*max(v_perspective_ratio,1.0);float distance_to_center=length(v_extrude);float distance_to_edge=abs(distance_to_center-v_radius);float opacity_t=smoothstep(-stroke_radius,0.0,-distance_to_edge);vec4 color=mix(vec4(0.0,0.0,1.0,0.5),vec4(1.0,0.0,0.0,1.0),v_collision);gl_FragColor=color*alpha*opacity_t;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var collisionCircleVert = 'attribute vec2 a_pos;attribute float a_radius;attribute vec2 a_flags;uniform mat4 u_matrix;uniform mat4 u_inv_matrix;uniform vec2 u_viewport_size;uniform float u_camera_to_center_distance;varying float v_radius;varying vec2 v_extrude;varying float v_perspective_ratio;varying float v_collision;vec3 toTilePosition(vec2 screenPos) {vec4 rayStart=u_inv_matrix*vec4(screenPos,-1.0,1.0);vec4 rayEnd =u_inv_matrix*vec4(screenPos, 1.0,1.0);rayStart.xyz/=rayStart.w;rayEnd.xyz /=rayEnd.w;highp float t=(0.0-rayStart.z)/(rayEnd.z-rayStart.z);return mix(rayStart.xyz,rayEnd.xyz,t);}void main() {vec2 quadCenterPos=a_pos;float radius=a_radius;float collision=a_flags.x;float vertexIdx=a_flags.y;vec2 quadVertexOffset=vec2(mix(-1.0,1.0,float(vertexIdx >=2.0)),mix(-1.0,1.0,float(vertexIdx >=1.0 && vertexIdx <=2.0)));vec2 quadVertexExtent=quadVertexOffset*radius;vec3 tilePos=toTilePosition(quadCenterPos);vec4 clipPos=u_matrix*vec4(tilePos,1.0);highp float camera_to_anchor_distance=clipPos.w;highp float collision_perspective_ratio=clamp(0.5+0.5*(u_camera_to_center_distance/camera_to_anchor_distance),0.0,4.0);float padding_factor=1.2;v_radius=radius;v_extrude=quadVertexExtent*padding_factor;v_perspective_ratio=collision_perspective_ratio;v_collision=collision;gl_Position=vec4(clipPos.xyz/clipPos.w,1.0)+vec4(quadVertexExtent*padding_factor/u_viewport_size*2.0,0.0,0.0);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var debugFrag = 'uniform highp vec4 u_color;uniform sampler2D u_overlay;varying vec2 v_uv;void main() {vec4 overlay_color=texture2D(u_overlay,v_uv);gl_FragColor=mix(u_color,overlay_color,overlay_color.a);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var debugVert = 'attribute vec2 a_pos;varying vec2 v_uv;uniform mat4 u_matrix;uniform float u_overlay_scale;void main() {v_uv=a_pos/8192.0;gl_Position=u_matrix*vec4(a_pos*u_overlay_scale,get_elevation(a_pos),1);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillFrag = '#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float opacity\ngl_FragColor=color*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillVert = 'attribute vec2 a_pos;uniform mat4 u_matrix;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float opacity\ngl_Position=u_matrix*vec4(a_pos,0,1);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillOutlineFrag = 'varying vec2 v_pos;\n#pragma mapbox: define highp vec4 outline_color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 outline_color\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=outline_color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillOutlineVert = 'attribute vec2 a_pos;uniform mat4 u_matrix;uniform vec2 u_world;varying vec2 v_pos;\n#pragma mapbox: define highp vec4 outline_color\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 outline_color\n#pragma mapbox: initialize lowp float opacity\ngl_Position=u_matrix*vec4(a_pos,0,1);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillOutlinePatternFrag = 'uniform vec2 u_texsize;uniform sampler2D u_image;uniform float u_fade;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);float dist=length(v_pos-gl_FragCoord.xy);float alpha=1.0-smoothstep(0.0,1.0,dist);gl_FragColor=mix(color1,color2,u_fade)*alpha*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillOutlinePatternVert = 'uniform mat4 u_matrix;uniform vec2 u_world;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec2 v_pos;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;gl_Position=u_matrix*vec4(a_pos,0,1);vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,a_pos);v_pos=(gl_Position.xy/gl_Position.w+1.0)/2.0*u_world;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillPatternFrag = '#ifdef GL_ES\nprecision highp float;\n#endif\nuniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);gl_FragColor=mix(color1,color2,u_fade)*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillPatternVert = 'uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform vec3 u_scale;attribute vec2 a_pos;varying vec2 v_pos_a;varying vec2 v_pos_b;\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;gl_Position=u_matrix*vec4(a_pos,0,1);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileZoomRatio,a_pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileZoomRatio,a_pos);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillExtrusionFrag = 'varying vec4 v_color;void main() {gl_FragColor=v_color;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillExtrusionVert = 'uniform mat4 u_matrix;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;uniform float u_vertical_gradient;uniform lowp float u_opacity;attribute vec2 a_pos;attribute vec4 a_normal_ed;\n#ifdef TERRAIN3D\nattribute vec2 a_centroid;\n#endif\nvarying vec4 v_color;\n#pragma mapbox: define highp float base\n#pragma mapbox: define highp float height\n#pragma mapbox: define highp vec4 color\nvoid main() {\n#pragma mapbox: initialize highp float base\n#pragma mapbox: initialize highp float height\n#pragma mapbox: initialize highp vec4 color\nvec3 normal=a_normal_ed.xyz;\n#ifdef TERRAIN3D\nfloat height_terrain3d_offset=get_elevation(a_centroid);float base_terrain3d_offset=height_terrain3d_offset-(base > 0.0 ? 0.0 : 10.0);\n#else\nfloat height_terrain3d_offset=0.0;float base_terrain3d_offset=0.0;\n#endif\nbase=max(0.0,base)+base_terrain3d_offset;height=max(0.0,height)+height_terrain3d_offset;float t=mod(normal.x,2.0);gl_Position=u_matrix*vec4(a_pos,t > 0.0 ? height : base,1);float colorvalue=color.r*0.2126+color.g*0.7152+color.b*0.0722;v_color=vec4(0.0,0.0,0.0,1.0);vec4 ambientlight=vec4(0.03,0.03,0.03,1.0);color+=ambientlight;float directional=clamp(dot(normal/16384.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((1.0-colorvalue+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_color.r+=clamp(color.r*directional*u_lightcolor.r,mix(0.0,0.3,1.0-u_lightcolor.r),1.0);v_color.g+=clamp(color.g*directional*u_lightcolor.g,mix(0.0,0.3,1.0-u_lightcolor.g),1.0);v_color.b+=clamp(color.b*directional*u_lightcolor.b,mix(0.0,0.3,1.0-u_lightcolor.b),1.0);v_color*=u_opacity;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillExtrusionPatternFrag = 'uniform vec2 u_texsize;uniform float u_fade;uniform sampler2D u_image;varying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\n#pragma mapbox: define lowp float base\n#pragma mapbox: define lowp float height\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float base\n#pragma mapbox: initialize lowp float height\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;vec2 imagecoord=mod(v_pos_a,1.0);vec2 pos=mix(pattern_tl_a/u_texsize,pattern_br_a/u_texsize,imagecoord);vec4 color1=texture2D(u_image,pos);vec2 imagecoord_b=mod(v_pos_b,1.0);vec2 pos2=mix(pattern_tl_b/u_texsize,pattern_br_b/u_texsize,imagecoord_b);vec4 color2=texture2D(u_image,pos2);vec4 mixedColor=mix(color1,color2,u_fade);gl_FragColor=mixedColor*v_lighting;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var fillExtrusionPatternVert = 'uniform mat4 u_matrix;uniform vec2 u_pixel_coord_upper;uniform vec2 u_pixel_coord_lower;uniform float u_height_factor;uniform vec3 u_scale;uniform float u_vertical_gradient;uniform lowp float u_opacity;uniform vec3 u_lightcolor;uniform lowp vec3 u_lightpos;uniform lowp float u_lightintensity;attribute vec2 a_pos;attribute vec4 a_normal_ed;\n#ifdef TERRAIN3D\nattribute vec2 a_centroid;\n#endif\nvarying vec2 v_pos_a;varying vec2 v_pos_b;varying vec4 v_lighting;\n#pragma mapbox: define lowp float base\n#pragma mapbox: define lowp float height\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float base\n#pragma mapbox: initialize lowp float height\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec3 normal=a_normal_ed.xyz;float edgedistance=a_normal_ed.w;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;\n#ifdef TERRAIN3D\nfloat height_terrain3d_offset=get_elevation(a_centroid);float base_terrain3d_offset=height_terrain3d_offset-(base > 0.0 ? 0.0 : 10.0);\n#else\nfloat height_terrain3d_offset=0.0;float base_terrain3d_offset=0.0;\n#endif\nbase=max(0.0,base)+base_terrain3d_offset;height=max(0.0,height)+height_terrain3d_offset;float t=mod(normal.x,2.0);float z=t > 0.0 ? height : base;gl_Position=u_matrix*vec4(a_pos,z,1);vec2 pos=normal.x==1.0 && normal.y==0.0 && normal.z==16384.0\n? a_pos\n: vec2(edgedistance,z*u_height_factor);v_pos_a=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,fromScale*display_size_a,tileRatio,pos);v_pos_b=get_pattern_pos(u_pixel_coord_upper,u_pixel_coord_lower,toScale*display_size_b,tileRatio,pos);v_lighting=vec4(0.0,0.0,0.0,1.0);float directional=clamp(dot(normal/16383.0,u_lightpos),0.0,1.0);directional=mix((1.0-u_lightintensity),max((0.5+u_lightintensity),1.0),directional);if (normal.y !=0.0) {directional*=((1.0-u_vertical_gradient)+(u_vertical_gradient*clamp((t+base)*pow(height/150.0,0.5),mix(0.7,0.98,1.0-u_lightintensity),1.0)));}v_lighting.rgb+=clamp(directional*u_lightcolor,mix(vec3(0.0),vec3(0.3),1.0-u_lightcolor),vec3(1.0));v_lighting*=u_opacity;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var hillshadePrepareFrag = '#ifdef GL_ES\nprecision highp float;\n#endif\nuniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_dimension;uniform float u_zoom;uniform vec4 u_unpack;float getElevation(vec2 coord,float bias) {vec4 data=texture2D(u_image,coord)*255.0;data.a=-1.0;return dot(data,u_unpack)/4.0;}void main() {vec2 epsilon=1.0/u_dimension;float a=getElevation(v_pos+vec2(-epsilon.x,-epsilon.y),0.0);float b=getElevation(v_pos+vec2(0,-epsilon.y),0.0);float c=getElevation(v_pos+vec2(epsilon.x,-epsilon.y),0.0);float d=getElevation(v_pos+vec2(-epsilon.x,0),0.0);float e=getElevation(v_pos,0.0);float f=getElevation(v_pos+vec2(epsilon.x,0),0.0);float g=getElevation(v_pos+vec2(-epsilon.x,epsilon.y),0.0);float h=getElevation(v_pos+vec2(0,epsilon.y),0.0);float i=getElevation(v_pos+vec2(epsilon.x,epsilon.y),0.0);float exaggerationFactor=u_zoom < 2.0 ? 0.4 : u_zoom < 4.5 ? 0.35 : 0.3;float exaggeration=u_zoom < 15.0 ? (u_zoom-15.0)*exaggerationFactor : 0.0;vec2 deriv=vec2((c+f+f+i)-(a+d+d+g),(g+h+h+i)-(a+b+b+c))/pow(2.0,exaggeration+(19.2562-u_zoom));gl_FragColor=clamp(vec4(deriv.x/2.0+0.5,deriv.y/2.0+0.5,1.0,1.0),0.0,1.0);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var hillshadePrepareVert = 'uniform mat4 u_matrix;uniform vec2 u_dimension;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);highp vec2 epsilon=1.0/u_dimension;float scale=(u_dimension.x-2.0)/u_dimension.x;v_pos=(a_texture_pos/8192.0)*scale+epsilon;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var hillshadeFrag = 'uniform sampler2D u_image;varying vec2 v_pos;uniform vec2 u_latrange;uniform vec2 u_light;uniform vec4 u_shadow;uniform vec4 u_highlight;uniform vec4 u_accent;\n#define PI 3.141592653589793\nvoid main() {vec4 pixel=texture2D(u_image,v_pos);vec2 deriv=((pixel.rg*2.0)-1.0);float scaleFactor=cos(radians((u_latrange[0]-u_latrange[1])*(1.0-v_pos.y)+u_latrange[1]));float slope=atan(1.25*length(deriv)/scaleFactor);float aspect=deriv.x !=0.0 ? atan(deriv.y,-deriv.x) : PI/2.0*(deriv.y > 0.0 ? 1.0 :-1.0);float intensity=u_light.x;float azimuth=u_light.y+PI;float base=1.875-intensity*1.75;float maxValue=0.5*PI;float scaledSlope=intensity !=0.5 ? ((pow(base,slope)-1.0)/(pow(base,maxValue)-1.0))*maxValue : slope;float accent=cos(scaledSlope);vec4 accent_color=(1.0-accent)*u_accent*clamp(intensity*2.0,0.0,1.0);float shade=abs(mod((aspect+azimuth)/PI+0.5,2.0)-1.0);vec4 shade_color=mix(u_shadow,u_highlight,shade)*sin(scaledSlope)*clamp(intensity*2.0,0.0,1.0);gl_FragColor=accent_color*(1.0-shade_color.a)+shade_color;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var hillshadeVert = 'uniform mat4 u_matrix;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos=a_texture_pos/8192.0;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineFrag = 'uniform lowp float u_device_pixel_ratio;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineVert = '\n#define scale 0.015873016\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform vec2 u_units_to_pixels;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp float v_linesofar;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;v_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*2.0;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_width2=vec2(outset,inset);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineGradientFrag = 'uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;varying vec2 v_width2;varying vec2 v_normal;varying float v_gamma_scale;varying highp vec2 v_uv;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);vec4 color=texture2D(u_image,v_uv);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineGradientVert = '\n#define scale 0.015873016\nattribute vec2 a_pos_normal;attribute vec4 a_data;attribute float a_uv_x;attribute float a_split_index;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_units_to_pixels;uniform float u_image_height;varying vec2 v_normal;varying vec2 v_width2;varying float v_gamma_scale;varying highp vec2 v_uv;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;highp float texel_height=1.0/u_image_height;highp float half_texel_height=0.5*texel_height;v_uv=vec2(a_uv_x,a_split_index*texel_height-half_texel_height);vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_width2=vec2(outset,inset);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var linePatternFrag = '#ifdef GL_ES\nprecision highp float;\n#endif\nuniform lowp float u_device_pixel_ratio;uniform vec2 u_texsize;uniform float u_fade;uniform mediump vec3 u_scale;uniform sampler2D u_image;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\nvec2 pattern_tl_a=pattern_from.xy;vec2 pattern_br_a=pattern_from.zw;vec2 pattern_tl_b=pattern_to.xy;vec2 pattern_br_b=pattern_to.zw;float tileZoomRatio=u_scale.x;float fromScale=u_scale.y;float toScale=u_scale.z;vec2 display_size_a=(pattern_br_a-pattern_tl_a)/pixel_ratio_from;vec2 display_size_b=(pattern_br_b-pattern_tl_b)/pixel_ratio_to;vec2 pattern_size_a=vec2(display_size_a.x*fromScale/tileZoomRatio,display_size_a.y);vec2 pattern_size_b=vec2(display_size_b.x*toScale/tileZoomRatio,display_size_b.y);float aspect_a=display_size_a.y/v_width;float aspect_b=display_size_b.y/v_width;float dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float x_a=mod(v_linesofar/pattern_size_a.x*aspect_a,1.0);float x_b=mod(v_linesofar/pattern_size_b.x*aspect_b,1.0);float y=0.5*v_normal.y+0.5;vec2 texel_size=1.0/u_texsize;vec2 pos_a=mix(pattern_tl_a*texel_size-texel_size,pattern_br_a*texel_size+texel_size,vec2(x_a,y));vec2 pos_b=mix(pattern_tl_b*texel_size-texel_size,pattern_br_b*texel_size+texel_size,vec2(x_b,y));vec4 color=mix(texture2D(u_image,pos_a),texture2D(u_image,pos_b),u_fade);gl_FragColor=color*alpha*opacity;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var linePatternVert = '\n#define scale 0.015873016\n#define LINE_DISTANCE_SCALE 2.0\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform vec2 u_units_to_pixels;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;varying vec2 v_normal;varying vec2 v_width2;varying float v_linesofar;varying float v_gamma_scale;varying float v_width;\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\n#pragma mapbox: define lowp vec4 pattern_from\n#pragma mapbox: define lowp vec4 pattern_to\n#pragma mapbox: define lowp float pixel_ratio_from\n#pragma mapbox: define lowp float pixel_ratio_to\nvoid main() {\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\n#pragma mapbox: initialize mediump vec4 pattern_from\n#pragma mapbox: initialize mediump vec4 pattern_to\n#pragma mapbox: initialize lowp float pixel_ratio_from\n#pragma mapbox: initialize lowp float pixel_ratio_to\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_linesofar=a_linesofar;v_width2=vec2(outset,inset);v_width=floorwidth;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineSDFFrag = 'uniform lowp float u_device_pixel_ratio;uniform sampler2D u_image;uniform float u_sdfgamma;uniform float u_mix;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\nfloat dist=length(v_normal)*v_width2.s;float blur2=(blur+1.0/u_device_pixel_ratio)*v_gamma_scale;float alpha=clamp(min(dist-(v_width2.t-blur2),v_width2.s-dist)/blur2,0.0,1.0);float sdfdist_a=texture2D(u_image,v_tex_a).a;float sdfdist_b=texture2D(u_image,v_tex_b).a;float sdfdist=mix(sdfdist_a,sdfdist_b,u_mix);alpha*=smoothstep(0.5-u_sdfgamma/floorwidth,0.5+u_sdfgamma/floorwidth,sdfdist);gl_FragColor=color*(alpha*opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var lineSDFVert = '\n#define scale 0.015873016\n#define LINE_DISTANCE_SCALE 2.0\nattribute vec2 a_pos_normal;attribute vec4 a_data;uniform mat4 u_matrix;uniform mediump float u_ratio;uniform lowp float u_device_pixel_ratio;uniform vec2 u_patternscale_a;uniform float u_tex_y_a;uniform vec2 u_patternscale_b;uniform float u_tex_y_b;uniform vec2 u_units_to_pixels;varying vec2 v_normal;varying vec2 v_width2;varying vec2 v_tex_a;varying vec2 v_tex_b;varying float v_gamma_scale;\n#pragma mapbox: define highp vec4 color\n#pragma mapbox: define lowp float blur\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define mediump float gapwidth\n#pragma mapbox: define lowp float offset\n#pragma mapbox: define mediump float width\n#pragma mapbox: define lowp float floorwidth\nvoid main() {\n#pragma mapbox: initialize highp vec4 color\n#pragma mapbox: initialize lowp float blur\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize mediump float gapwidth\n#pragma mapbox: initialize lowp float offset\n#pragma mapbox: initialize mediump float width\n#pragma mapbox: initialize lowp float floorwidth\nfloat ANTIALIASING=1.0/u_device_pixel_ratio/2.0;vec2 a_extrude=a_data.xy-128.0;float a_direction=mod(a_data.z,4.0)-1.0;float a_linesofar=(floor(a_data.z/4.0)+a_data.w*64.0)*LINE_DISTANCE_SCALE;vec2 pos=floor(a_pos_normal*0.5);mediump vec2 normal=a_pos_normal-2.0*pos;normal.y=normal.y*2.0-1.0;v_normal=normal;gapwidth=gapwidth/2.0;float halfwidth=width/2.0;offset=-1.0*offset;float inset=gapwidth+(gapwidth > 0.0 ? ANTIALIASING : 0.0);float outset=gapwidth+halfwidth*(gapwidth > 0.0 ? 2.0 : 1.0)+(halfwidth==0.0 ? 0.0 : ANTIALIASING);mediump vec2 dist=outset*a_extrude*scale;mediump float u=0.5*a_direction;mediump float t=1.0-abs(u);mediump vec2 offset2=offset*a_extrude*scale*normal.y*mat2(t,-u,u,t);vec4 projected_extrude=u_matrix*vec4(dist/u_ratio,0.0,0.0);gl_Position=u_matrix*vec4(pos+offset2/u_ratio,0.0,1.0)+projected_extrude;\n#ifdef TERRAIN3D\nv_gamma_scale=1.0;\n#else\nfloat extrude_length_without_perspective=length(dist);float extrude_length_with_perspective=length(projected_extrude.xy/gl_Position.w*u_units_to_pixels);v_gamma_scale=extrude_length_without_perspective/extrude_length_with_perspective;\n#endif\nv_tex_a=vec2(a_linesofar*u_patternscale_a.x/floorwidth,normal.y*u_patternscale_a.y+u_tex_y_a);v_tex_b=vec2(a_linesofar*u_patternscale_b.x/floorwidth,normal.y*u_patternscale_b.y+u_tex_y_b);v_width2=vec2(outset,inset);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var rasterFrag = 'uniform float u_fade_t;uniform float u_opacity;uniform sampler2D u_image0;uniform sampler2D u_image1;varying vec2 v_pos0;varying vec2 v_pos1;uniform float u_brightness_low;uniform float u_brightness_high;uniform float u_saturation_factor;uniform float u_contrast_factor;uniform vec3 u_spin_weights;void main() {vec4 color0=texture2D(u_image0,v_pos0);vec4 color1=texture2D(u_image1,v_pos1);if (color0.a > 0.0) {color0.rgb=color0.rgb/color0.a;}if (color1.a > 0.0) {color1.rgb=color1.rgb/color1.a;}vec4 color=mix(color0,color1,u_fade_t);color.a*=u_opacity;vec3 rgb=color.rgb;rgb=vec3(dot(rgb,u_spin_weights.xyz),dot(rgb,u_spin_weights.zxy),dot(rgb,u_spin_weights.yzx));float average=(color.r+color.g+color.b)/3.0;rgb+=(average-rgb)*u_saturation_factor;rgb=(rgb-0.5)*u_contrast_factor+0.5;vec3 u_high_vec=vec3(u_brightness_low,u_brightness_low,u_brightness_low);vec3 u_low_vec=vec3(u_brightness_high,u_brightness_high,u_brightness_high);gl_FragColor=vec4(mix(u_high_vec,u_low_vec,rgb)*color.a,color.a);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var rasterVert = 'uniform mat4 u_matrix;uniform vec2 u_tl_parent;uniform float u_scale_parent;uniform float u_buffer_scale;attribute vec2 a_pos;attribute vec2 a_texture_pos;varying vec2 v_pos0;varying vec2 v_pos1;void main() {gl_Position=u_matrix*vec4(a_pos,0,1);v_pos0=(((a_texture_pos/8192.0)-0.5)/u_buffer_scale )+0.5;v_pos1=(v_pos0*u_scale_parent)+u_tl_parent;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolIconFrag = 'uniform sampler2D u_texture;varying vec2 v_tex;varying float v_fade_opacity;\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\nlowp float alpha=opacity*v_fade_opacity;gl_FragColor=texture2D(u_texture,v_tex)*alpha;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolIconVert = 'attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform highp float u_camera_to_center_distance;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform float u_fade_change;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform vec2 u_texsize;uniform bool u_is_along_line;uniform bool u_is_variable_anchor;uniform vec2 u_translation;uniform float u_pitched_scale;varying vec2 v_tex;varying float v_fade_opacity;vec4 projectTileWithElevation(vec2 posInTile,float elevation) {return u_matrix*vec4(posInTile,elevation,1.0);}\n#pragma mapbox: define lowp float opacity\nvoid main() {\n#pragma mapbox: initialize lowp float opacity\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;vec2 a_minFontScale=a_pixeloffset.zw/256.0;float ele=get_elevation(a_pos);highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec2 translated_a_pos=a_pos+u_translation;vec4 projectedPoint=projectTileWithElevation(translated_a_pos,ele);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=projectTileWithElevation(translated_a_pos+vec2(1,0),ele);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos;if (u_is_along_line || u_is_variable_anchor) {projected_pos=vec4(a_projected_pos.xy,ele,1.0);} else if (u_pitch_with_map) {projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy+u_translation,ele,1.0);} else {projected_pos=u_label_plane_matrix*projectTileWithElevation(a_projected_pos.xy+u_translation,ele);}float z=float(u_pitch_with_map)*projected_pos.z/projected_pos.w;float projectionScaling=1.0;vec4 finalPos=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*max(a_minFontScale,fontScale)+a_pxoffset/16.0)*projectionScaling,z,1.0);if(u_pitch_with_map) {finalPos=projectTileWithElevation(finalPos.xy,finalPos.z);}gl_Position=finalPos;v_tex=a_tex/u_texsize;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float visibility=calculate_visibility(projectedPoint);v_fade_opacity=max(0.0,min(visibility,fade_opacity[0]+fade_change));}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolSDFFrag = '#define SDF_PX 8.0\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;uniform bool u_is_text;varying vec2 v_data0;varying vec3 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nfloat EDGE_GAMMA=0.105/u_device_pixel_ratio;vec2 tex=v_data0.xy;float gamma_scale=v_data1.x;float size=v_data1.y;float fade_opacity=v_data1[2];float fontScale=u_is_text ? size/24.0 : size;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float inner_edge=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);inner_edge=inner_edge+gamma*gamma_scale;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(inner_edge-gamma_scaled,inner_edge+gamma_scaled,dist);if (u_is_halo) {lowp float halo_edge=(6.0-halo_width/fontScale)/SDF_PX;alpha=min(smoothstep(halo_edge-gamma_scaled,halo_edge+gamma_scaled,dist),1.0-alpha);}gl_FragColor=color*(alpha*opacity*fade_opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolSDFVert = 'attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec4 a_pixeloffset;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform bool u_is_along_line;uniform bool u_is_variable_anchor;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;uniform vec2 u_translation;uniform float u_pitched_scale;varying vec2 v_data0;varying vec3 v_data1;vec4 projectTileWithElevation(vec2 posInTile,float elevation) {return u_matrix*vec4(posInTile,elevation,1.0);}\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);vec2 a_pxoffset=a_pixeloffset.xy;float ele=get_elevation(a_pos);highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec2 translated_a_pos=a_pos+u_translation;vec4 projectedPoint=projectTileWithElevation(translated_a_pos,ele);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=u_is_text ? size/24.0 : size;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=projectTileWithElevation(translated_a_pos+vec2(1,0),ele);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos;if (u_is_along_line || u_is_variable_anchor) {projected_pos=vec4(a_projected_pos.xy,ele,1.0);} else if (u_pitch_with_map) {projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy+u_translation,ele,1.0);} else {projected_pos=u_label_plane_matrix*projectTileWithElevation(a_projected_pos.xy+u_translation,ele);}float z=float(u_pitch_with_map)*projected_pos.z/projected_pos.w;float projectionScaling=1.0;vec4 finalPos=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale+a_pxoffset)*projectionScaling,z,1.0);if(u_pitch_with_map) {finalPos=projectTileWithElevation(finalPos.xy,finalPos.z);}float gamma_scale=finalPos.w;gl_Position=finalPos;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float visibility=calculate_visibility(projectedPoint);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(visibility,fade_opacity[0]+fade_change));v_data0=a_tex/u_texsize;v_data1=vec3(gamma_scale,size,interpolated_fade_opacity);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolTextAndIconFrag = '#define SDF_PX 8.0\n#define SDF 1.0\n#define ICON 0.0\nuniform bool u_is_halo;uniform sampler2D u_texture;uniform sampler2D u_texture_icon;uniform highp float u_gamma_scale;uniform lowp float u_device_pixel_ratio;varying vec4 v_data0;varying vec4 v_data1;\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nfloat fade_opacity=v_data1[2];if (v_data1.w==ICON) {vec2 tex_icon=v_data0.zw;lowp float alpha=opacity*fade_opacity;gl_FragColor=texture2D(u_texture_icon,tex_icon)*alpha;\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\nreturn;}vec2 tex=v_data0.xy;float EDGE_GAMMA=0.105/u_device_pixel_ratio;float gamma_scale=v_data1.x;float size=v_data1.y;float fontScale=size/24.0;lowp vec4 color=fill_color;highp float gamma=EDGE_GAMMA/(fontScale*u_gamma_scale);lowp float buff=(256.0-64.0)/256.0;if (u_is_halo) {color=halo_color;gamma=(halo_blur*1.19/SDF_PX+EDGE_GAMMA)/(fontScale*u_gamma_scale);buff=(6.0-halo_width/fontScale)/SDF_PX;}lowp float dist=texture2D(u_texture,tex).a;highp float gamma_scaled=gamma*gamma_scale;highp float alpha=smoothstep(buff-gamma_scaled,buff+gamma_scaled,dist);gl_FragColor=color*(alpha*opacity*fade_opacity);\n#ifdef OVERDRAW_INSPECTOR\ngl_FragColor=vec4(1.0);\n#endif\n}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var symbolTextAndIconVert = 'attribute vec4 a_pos_offset;attribute vec4 a_data;attribute vec3 a_projected_pos;attribute float a_fade_opacity;uniform bool u_is_size_zoom_constant;uniform bool u_is_size_feature_constant;uniform highp float u_size_t;uniform highp float u_size;uniform mat4 u_matrix;uniform mat4 u_label_plane_matrix;uniform mat4 u_coord_matrix;uniform bool u_is_text;uniform bool u_pitch_with_map;uniform highp float u_pitch;uniform bool u_rotate_symbol;uniform highp float u_aspect_ratio;uniform highp float u_camera_to_center_distance;uniform float u_fade_change;uniform vec2 u_texsize;uniform vec2 u_texsize_icon;uniform bool u_is_along_line;uniform bool u_is_variable_anchor;uniform vec2 u_translation;uniform float u_pitched_scale;varying vec4 v_data0;varying vec4 v_data1;vec4 projectTileWithElevation(vec2 posInTile,float elevation) {return u_matrix*vec4(posInTile,elevation,1.0);}\n#pragma mapbox: define highp vec4 fill_color\n#pragma mapbox: define highp vec4 halo_color\n#pragma mapbox: define lowp float opacity\n#pragma mapbox: define lowp float halo_width\n#pragma mapbox: define lowp float halo_blur\nvoid main() {\n#pragma mapbox: initialize highp vec4 fill_color\n#pragma mapbox: initialize highp vec4 halo_color\n#pragma mapbox: initialize lowp float opacity\n#pragma mapbox: initialize lowp float halo_width\n#pragma mapbox: initialize lowp float halo_blur\nvec2 a_pos=a_pos_offset.xy;vec2 a_offset=a_pos_offset.zw;vec2 a_tex=a_data.xy;vec2 a_size=a_data.zw;float a_size_min=floor(a_size[0]*0.5);float is_sdf=a_size[0]-2.0*a_size_min;float ele=get_elevation(a_pos);highp float segment_angle=-a_projected_pos[2];float size;if (!u_is_size_zoom_constant && !u_is_size_feature_constant) {size=mix(a_size_min,a_size[1],u_size_t)/128.0;} else if (u_is_size_zoom_constant && !u_is_size_feature_constant) {size=a_size_min/128.0;} else {size=u_size;}vec2 translated_a_pos=a_pos+u_translation;vec4 projectedPoint=projectTileWithElevation(translated_a_pos,ele);highp float camera_to_anchor_distance=projectedPoint.w;highp float distance_ratio=u_pitch_with_map ?\ncamera_to_anchor_distance/u_camera_to_center_distance :\nu_camera_to_center_distance/camera_to_anchor_distance;highp float perspective_ratio=clamp(0.5+0.5*distance_ratio,0.0,4.0);size*=perspective_ratio;float fontScale=size/24.0;highp float symbol_rotation=0.0;if (u_rotate_symbol) {vec4 offsetProjectedPoint=projectTileWithElevation(translated_a_pos+vec2(1,0),ele);vec2 a=projectedPoint.xy/projectedPoint.w;vec2 b=offsetProjectedPoint.xy/offsetProjectedPoint.w;symbol_rotation=atan((b.y-a.y)/u_aspect_ratio,b.x-a.x);}highp float angle_sin=sin(segment_angle+symbol_rotation);highp float angle_cos=cos(segment_angle+symbol_rotation);mat2 rotation_matrix=mat2(angle_cos,-1.0*angle_sin,angle_sin,angle_cos);vec4 projected_pos;if (u_is_along_line || u_is_variable_anchor) {projected_pos=vec4(a_projected_pos.xy,ele,1.0);} else if (u_pitch_with_map) {projected_pos=u_label_plane_matrix*vec4(a_projected_pos.xy+u_translation,ele,1.0);} else {projected_pos=u_label_plane_matrix*projectTileWithElevation(a_projected_pos.xy+u_translation,ele);}float z=float(u_pitch_with_map)*projected_pos.z/projected_pos.w;float projectionScaling=1.0;vec4 finalPos=u_coord_matrix*vec4(projected_pos.xy/projected_pos.w+rotation_matrix*(a_offset/32.0*fontScale)*projectionScaling,z,1.0);if(u_pitch_with_map) {finalPos=projectTileWithElevation(finalPos.xy,finalPos.z);}float gamma_scale=finalPos.w;gl_Position=finalPos;vec2 fade_opacity=unpack_opacity(a_fade_opacity);float visibility=calculate_visibility(projectedPoint);float fade_change=fade_opacity[1] > 0.5 ? u_fade_change :-u_fade_change;float interpolated_fade_opacity=max(0.0,min(visibility,fade_opacity[0]+fade_change));v_data0.xy=a_tex/u_texsize;v_data0.zw=a_tex/u_texsize_icon;v_data1=vec4(gamma_scale,size,interpolated_fade_opacity,is_sdf);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainDepthFrag = 'varying float v_depth;const highp vec4 bitSh=vec4(256.*256.*256.,256.*256.,256.,1.);const highp vec4 bitMsk=vec4(0.,vec3(1./256.0));highp vec4 pack(highp float value) {highp vec4 comp=fract(value*bitSh);comp-=comp.xxyz*bitMsk;return comp;}void main() {gl_FragColor=pack(v_depth);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainCoordsFrag = 'precision mediump float;uniform sampler2D u_texture;uniform float u_terrain_coords_id;varying vec2 v_texture_pos;void main() {vec4 rgba=texture2D(u_texture,v_texture_pos);gl_FragColor=vec4(rgba.r,rgba.g,rgba.b,u_terrain_coords_id);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainFrag = 'uniform sampler2D u_texture;uniform vec4 u_fog_color;uniform vec4 u_horizon_color;uniform float u_fog_ground_blend;uniform float u_fog_ground_blend_opacity;uniform float u_horizon_fog_blend;varying vec2 v_texture_pos;varying float v_fog_depth;const float gamma=2.2;vec4 gammaToLinear(vec4 color) {return pow(color,vec4(gamma));}vec4 linearToGamma(vec4 color) {return pow(color,vec4(1.0/gamma));}void main() {vec4 surface_color=texture2D(u_texture,v_texture_pos);if (v_fog_depth > u_fog_ground_blend) {vec4 surface_color_linear=gammaToLinear(surface_color);float blend_color=smoothstep(0.0,1.0,max((v_fog_depth-u_horizon_fog_blend)/(1.0-u_horizon_fog_blend),0.0));vec4 fog_horizon_color_linear=mix(gammaToLinear(u_fog_color),gammaToLinear(u_horizon_color),blend_color);float factor_fog=max(v_fog_depth-u_fog_ground_blend,0.0)/(1.0-u_fog_ground_blend);gl_FragColor=linearToGamma(mix(surface_color_linear,fog_horizon_color_linear,pow(factor_fog,2.0)*u_fog_ground_blend_opacity));} else {gl_FragColor=surface_color;}}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainDepthVert = 'attribute vec3 a_pos3d;uniform mat4 u_matrix;uniform float u_ele_delta;varying float v_depth;void main() {float ele=get_elevation(a_pos3d.xy);float ele_delta=a_pos3d.z==1.0 ? u_ele_delta : 0.0;gl_Position=u_matrix*vec4(a_pos3d.xy,ele-ele_delta,1.0);v_depth=gl_Position.z/gl_Position.w;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainCoordsVert = 'attribute vec3 a_pos3d;uniform mat4 u_matrix;uniform float u_ele_delta;varying vec2 v_texture_pos;void main() {float ele=get_elevation(a_pos3d.xy);float ele_delta=a_pos3d.z==1.0 ? u_ele_delta : 0.0;v_texture_pos=a_pos3d.xy/8192.0;gl_Position=u_matrix*vec4(a_pos3d.xy,ele-ele_delta,1.0);}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var terrainVert = 'attribute vec3 a_pos3d;uniform mat4 u_matrix;uniform mat4 u_fog_matrix;uniform float u_ele_delta;varying vec2 v_texture_pos;varying float v_fog_depth;void main() {float ele=get_elevation(a_pos3d.xy);float ele_delta=a_pos3d.z==1.0 ? u_ele_delta : 0.0;v_texture_pos=a_pos3d.xy/8192.0;gl_Position=u_matrix*vec4(a_pos3d.xy,ele-ele_delta,1.0);vec4 pos=u_fog_matrix*vec4(a_pos3d.xy,ele,1.0);v_fog_depth=pos.z/pos.w*0.5+0.5;}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var skyFrag = 'uniform vec4 u_sky_color;uniform vec4 u_horizon_color;uniform float u_horizon;uniform float u_sky_horizon_blend;void main() {float y=gl_FragCoord.y;if (y > u_horizon) {float blend=y-u_horizon;if (blend < u_sky_horizon_blend) {gl_FragColor=mix(u_sky_color,u_horizon_color,pow(1.0-blend/u_sky_horizon_blend,2.0));} else {gl_FragColor=u_sky_color;}}}'; // This file is generated. Edit build/generate-shaders.ts, then run `npm run codegen`. var skyVert = 'attribute vec2 a_pos;void main() {gl_Position=vec4(a_pos,1.0,1.0);}'; // Disable Flow annotations here because Flow doesn't support importing GLSL files const shaders = { prelude: compile(preludeFrag, preludeVert), background: compile(backgroundFrag, backgroundVert), backgroundPattern: compile(backgroundPatternFrag, backgroundPatternVert), circle: compile(circleFrag, circleVert), clippingMask: compile(clippingMaskFrag, clippingMaskVert), heatmap: compile(heatmapFrag, heatmapVert), heatmapTexture: compile(heatmapTextureFrag, heatmapTextureVert), collisionBox: compile(collisionBoxFrag, collisionBoxVert), collisionCircle: compile(collisionCircleFrag, collisionCircleVert), debug: compile(debugFrag, debugVert), fill: compile(fillFrag, fillVert), fillOutline: compile(fillOutlineFrag, fillOutlineVert), fillOutlinePattern: compile(fillOutlinePatternFrag, fillOutlinePatternVert), fillPattern: compile(fillPatternFrag, fillPatternVert), fillExtrusion: compile(fillExtrusionFrag, fillExtrusionVert), fillExtrusionPattern: compile(fillExtrusionPatternFrag, fillExtrusionPatternVert), hillshadePrepare: compile(hillshadePrepareFrag, hillshadePrepareVert), hillshade: compile(hillshadeFrag, hillshadeVert), line: compile(lineFrag, lineVert), lineGradient: compile(lineGradientFrag, lineGradientVert), linePattern: compile(linePatternFrag, linePatternVert), lineSDF: compile(lineSDFFrag, lineSDFVert), raster: compile(rasterFrag, rasterVert), symbolIcon: compile(symbolIconFrag, symbolIconVert), symbolSDF: compile(symbolSDFFrag, symbolSDFVert), symbolTextAndIcon: compile(symbolTextAndIconFrag, symbolTextAndIconVert), terrain: compile(terrainFrag, terrainVert), terrainDepth: compile(terrainDepthFrag, terrainDepthVert), terrainCoords: compile(terrainCoordsFrag, terrainCoordsVert), sky: compile(skyFrag, skyVert) }; // Expand #pragmas to #ifdefs. function compile(fragmentSource, vertexSource) { const re = /#pragma mapbox: ([\w]+) ([\w]+) ([\w]+) ([\w]+)/g; const staticAttributes = vertexSource.match(/attribute ([\w]+) ([\w]+)/g); const fragmentUniforms = fragmentSource.match(/uniform ([\w]+) ([\w]+)([\s]*)([\w]*)/g); const vertexUniforms = vertexSource.match(/uniform ([\w]+) ([\w]+)([\s]*)([\w]*)/g); const staticUniforms = vertexUniforms ? vertexUniforms.concat(fragmentUniforms) : fragmentUniforms; const fragmentPragmas = {}; fragmentSource = fragmentSource.replace(re, (match, operation, precision, type, name) => { fragmentPragmas[name] = true; if (operation === 'define') { return ` #ifndef HAS_UNIFORM_u_${name} varying ${precision} ${type} ${name}; #else uniform ${precision} ${type} u_${name}; #endif `; } else /* if (operation === 'initialize') */ { return ` #ifdef HAS_UNIFORM_u_${name} ${precision} ${type} ${name} = u_${name}; #endif `; } }); vertexSource = vertexSource.replace(re, (match, operation, precision, type, name) => { const attrType = type === 'float' ? 'vec2' : 'vec4'; const unpackType = name.match(/color/) ? 'color' : attrType; if (fragmentPragmas[name]) { if (operation === 'define') { return ` #ifndef HAS_UNIFORM_u_${name} uniform lowp float u_${name}_t; attribute ${precision} ${attrType} a_${name}; varying ${precision} ${type} ${name}; #else uniform ${precision} ${type} u_${name}; #endif `; } else /* if (operation === 'initialize') */ { if (unpackType === 'vec4') { // vec4 attributes are only used for cross-faded properties, and are not packed return ` #ifndef HAS_UNIFORM_u_${name} ${name} = a_${name}; #else ${precision} ${type} ${name} = u_${name}; #endif `; } else { return ` #ifndef HAS_UNIFORM_u_${name} ${name} = unpack_mix_${unpackType}(a_${name}, u_${name}_t); #else ${precision} ${type} ${name} = u_${name}; #endif `; } } } else { if (operation === 'define') { return ` #ifndef HAS_UNIFORM_u_${name} uniform lowp float u_${name}_t; attribute ${precision} ${attrType} a_${name}; #else uniform ${precision} ${type} u_${name}; #endif `; } else /* if (operation === 'initialize') */ { if (unpackType === 'vec4') { // vec4 attributes are only used for cross-faded properties, and are not packed return ` #ifndef HAS_UNIFORM_u_${name} ${precision} ${type} ${name} = a_${name}; #else ${precision} ${type} ${name} = u_${name}; #endif `; } else /* */ { return ` #ifndef HAS_UNIFORM_u_${name} ${precision} ${type} ${name} = unpack_mix_${unpackType}(a_${name}, u_${name}_t); #else ${precision} ${type} ${name} = u_${name}; #endif `; } } } }); return { fragmentSource, vertexSource, staticAttributes, staticUniforms }; } /** * @internal * A vertex array object used to pass data to the webgl code */ class VertexArrayObject { constructor() { this.boundProgram = null; this.boundLayoutVertexBuffer = null; this.boundPaintVertexBuffers = []; this.boundIndexBuffer = null; this.boundVertexOffset = null; this.boundDynamicVertexBuffer = null; this.vao = null; } bind(context, program, layoutVertexBuffer, paintVertexBuffers, indexBuffer, vertexOffset, dynamicVertexBuffer, dynamicVertexBuffer2, dynamicVertexBuffer3) { this.context = context; let paintBuffersDiffer = this.boundPaintVertexBuffers.length !== paintVertexBuffers.length; for (let i = 0; !paintBuffersDiffer && i < paintVertexBuffers.length; i++) { if (this.boundPaintVertexBuffers[i] !== paintVertexBuffers[i]) { paintBuffersDiffer = true; } } const isFreshBindRequired = (!this.vao || this.boundProgram !== program || this.boundLayoutVertexBuffer !== layoutVertexBuffer || paintBuffersDiffer || this.boundIndexBuffer !== indexBuffer || this.boundVertexOffset !== vertexOffset || this.boundDynamicVertexBuffer !== dynamicVertexBuffer || this.boundDynamicVertexBuffer2 !== dynamicVertexBuffer2 || this.boundDynamicVertexBuffer3 !== dynamicVertexBuffer3); if (isFreshBindRequired) { this.freshBind(program, layoutVertexBuffer, paintVertexBuffers, indexBuffer, vertexOffset, dynamicVertexBuffer, dynamicVertexBuffer2, dynamicVertexBuffer3); } else { context.bindVertexArray.set(this.vao); if (dynamicVertexBuffer) { // The buffer may have been updated. Rebind to upload data. dynamicVertexBuffer.bind(); } if (indexBuffer && indexBuffer.dynamicDraw) { indexBuffer.bind(); } if (dynamicVertexBuffer2) { dynamicVertexBuffer2.bind(); } if (dynamicVertexBuffer3) { dynamicVertexBuffer3.bind(); } } } freshBind(program, layoutVertexBuffer, paintVertexBuffers, indexBuffer, vertexOffset, dynamicVertexBuffer, dynamicVertexBuffer2, dynamicVertexBuffer3) { const numNextAttributes = program.numAttributes; const context = this.context; const gl = context.gl; if (this.vao) this.destroy(); this.vao = context.createVertexArray(); context.bindVertexArray.set(this.vao); // store the arguments so that we can verify them when the vao is bound again this.boundProgram = program; this.boundLayoutVertexBuffer = layoutVertexBuffer; this.boundPaintVertexBuffers = paintVertexBuffers; this.boundIndexBuffer = indexBuffer; this.boundVertexOffset = vertexOffset; this.boundDynamicVertexBuffer = dynamicVertexBuffer; this.boundDynamicVertexBuffer2 = dynamicVertexBuffer2; this.boundDynamicVertexBuffer3 = dynamicVertexBuffer3; layoutVertexBuffer.enableAttributes(gl, program); for (const vertexBuffer of paintVertexBuffers) { vertexBuffer.enableAttributes(gl, program); } if (dynamicVertexBuffer) { dynamicVertexBuffer.enableAttributes(gl, program); } if (dynamicVertexBuffer2) { dynamicVertexBuffer2.enableAttributes(gl, program); } if (dynamicVertexBuffer3) { dynamicVertexBuffer3.enableAttributes(gl, program); } layoutVertexBuffer.bind(); layoutVertexBuffer.setVertexAttribPointers(gl, program, vertexOffset); for (const vertexBuffer of paintVertexBuffers) { vertexBuffer.bind(); vertexBuffer.setVertexAttribPointers(gl, program, vertexOffset); } if (dynamicVertexBuffer) { dynamicVertexBuffer.bind(); dynamicVertexBuffer.setVertexAttribPointers(gl, program, vertexOffset); } if (indexBuffer) { indexBuffer.bind(); } if (dynamicVertexBuffer2) { dynamicVertexBuffer2.bind(); dynamicVertexBuffer2.setVertexAttribPointers(gl, program, vertexOffset); } if (dynamicVertexBuffer3) { dynamicVertexBuffer3.bind(); dynamicVertexBuffer3.setVertexAttribPointers(gl, program, vertexOffset); } context.currentNumAttributes = numNextAttributes; } destroy() { if (this.vao) { this.context.deleteVertexArray(this.vao); this.vao = null; } } } const terrainPreludeUniforms = (context, locations) => ({ 'u_depth': new Uniform1i(context, locations.u_depth), 'u_terrain': new Uniform1i(context, locations.u_terrain), 'u_terrain_dim': new Uniform1f(context, locations.u_terrain_dim), 'u_terrain_matrix': new UniformMatrix4f(context, locations.u_terrain_matrix), 'u_terrain_unpack': new Uniform4f(context, locations.u_terrain_unpack), 'u_terrain_exaggeration': new Uniform1f(context, locations.u_terrain_exaggeration) }); const terrainUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_texture': new Uniform1i(context, locations.u_texture), 'u_ele_delta': new Uniform1f(context, locations.u_ele_delta), 'u_fog_matrix': new UniformMatrix4f(context, locations.u_fog_matrix), 'u_fog_color': new UniformColor(context, locations.u_fog_color), 'u_fog_ground_blend': new Uniform1f(context, locations.u_fog_ground_blend), 'u_fog_ground_blend_opacity': new Uniform1f(context, locations.u_fog_ground_blend_opacity), 'u_horizon_color': new UniformColor(context, locations.u_horizon_color), 'u_horizon_fog_blend': new Uniform1f(context, locations.u_horizon_fog_blend) }); const terrainDepthUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_ele_delta': new Uniform1f(context, locations.u_ele_delta) }); const terrainCoordsUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_texture': new Uniform1i(context, locations.u_texture), 'u_terrain_coords_id': new Uniform1f(context, locations.u_terrain_coords_id), 'u_ele_delta': new Uniform1f(context, locations.u_ele_delta) }); const terrainUniformValues = (matrix, eleDelta, fogMatrix, sky, pitch) => ({ 'u_matrix': matrix, 'u_texture': 0, 'u_ele_delta': eleDelta, 'u_fog_matrix': fogMatrix, 'u_fog_color': sky ? sky.properties.get('fog-color') : Color.white, 'u_fog_ground_blend': sky ? sky.properties.get('fog-ground-blend') : 1, 'u_fog_ground_blend_opacity': sky ? sky.calculateFogBlendOpacity(pitch) : 0, 'u_horizon_color': sky ? sky.properties.get('horizon-color') : Color.white, 'u_horizon_fog_blend': sky ? sky.properties.get('horizon-fog-blend') : 1 }); const terrainDepthUniformValues = (matrix, eleDelta) => ({ 'u_matrix': matrix, 'u_ele_delta': eleDelta }); const terrainCoordsUniformValues = (matrix, coordsId, eleDelta) => ({ 'u_matrix': matrix, 'u_terrain_coords_id': coordsId / 255, 'u_texture': 0, 'u_ele_delta': eleDelta }); function getTokenizedAttributesAndUniforms(array) { const result = []; for (let i = 0; i < array.length; i++) { if (array[i] === null) continue; const token = array[i].split(' '); result.push(token.pop()); } return result; } /** * @internal * A webgl program to execute in the GPU space */ class Program { constructor(context, source, configuration, fixedUniforms, showOverdrawInspector, terrain) { const gl = context.gl; this.program = gl.createProgram(); const staticAttrInfo = getTokenizedAttributesAndUniforms(source.staticAttributes); const dynamicAttrInfo = configuration ? configuration.getBinderAttributes() : []; const allAttrInfo = staticAttrInfo.concat(dynamicAttrInfo); const preludeUniformsInfo = shaders.prelude.staticUniforms ? getTokenizedAttributesAndUniforms(shaders.prelude.staticUniforms) : []; const staticUniformsInfo = source.staticUniforms ? getTokenizedAttributesAndUniforms(source.staticUniforms) : []; const dynamicUniformsInfo = configuration ? configuration.getBinderUniforms() : []; // remove duplicate uniforms const uniformList = preludeUniformsInfo.concat(staticUniformsInfo).concat(dynamicUniformsInfo); const allUniformsInfo = []; for (const uniform of uniformList) { if (allUniformsInfo.indexOf(uniform) < 0) allUniformsInfo.push(uniform); } const defines = configuration ? configuration.defines() : []; if (showOverdrawInspector) { defines.push('#define OVERDRAW_INSPECTOR;'); } if (terrain) { defines.push('#define TERRAIN3D;'); } const fragmentSource = defines.concat(shaders.prelude.fragmentSource, source.fragmentSource).join('\n'); const vertexSource = defines.concat(shaders.prelude.vertexSource, source.vertexSource).join('\n'); const fragmentShader = gl.createShader(gl.FRAGMENT_SHADER); if (gl.isContextLost()) { this.failedToCreate = true; return; } gl.shaderSource(fragmentShader, fragmentSource); gl.compileShader(fragmentShader); if (!gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS)) { throw new Error(`Could not compile fragment shader: ${gl.getShaderInfoLog(fragmentShader)}`); } gl.attachShader(this.program, fragmentShader); const vertexShader = gl.createShader(gl.VERTEX_SHADER); if (gl.isContextLost()) { this.failedToCreate = true; return; } gl.shaderSource(vertexShader, vertexSource); gl.compileShader(vertexShader); if (!gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS)) { throw new Error(`Could not compile vertex shader: ${gl.getShaderInfoLog(vertexShader)}`); } gl.attachShader(this.program, vertexShader); this.attributes = {}; const uniformLocations = {}; this.numAttributes = allAttrInfo.length; for (let i = 0; i < this.numAttributes; i++) { if (allAttrInfo[i]) { gl.bindAttribLocation(this.program, i, allAttrInfo[i]); this.attributes[allAttrInfo[i]] = i; } } gl.linkProgram(this.program); if (!gl.getProgramParameter(this.program, gl.LINK_STATUS)) { throw new Error(`Program failed to link: ${gl.getProgramInfoLog(this.program)}`); } gl.deleteShader(vertexShader); gl.deleteShader(fragmentShader); for (let it = 0; it < allUniformsInfo.length; it++) { const uniform = allUniformsInfo[it]; if (uniform && !uniformLocations[uniform]) { const uniformLocation = gl.getUniformLocation(this.program, uniform); if (uniformLocation) { uniformLocations[uniform] = uniformLocation; } } } this.fixedUniforms = fixedUniforms(context, uniformLocations); this.terrainUniforms = terrainPreludeUniforms(context, uniformLocations); this.binderUniforms = configuration ? configuration.getUniforms(context, uniformLocations) : []; } draw(context, drawMode, depthMode, stencilMode, colorMode, cullFaceMode, uniformValues, terrain, layerID, layoutVertexBuffer, indexBuffer, segments, currentProperties, zoom, configuration, dynamicLayoutBuffer, dynamicLayoutBuffer2, dynamicLayoutBuffer3) { const gl = context.gl; if (this.failedToCreate) return; context.program.set(this.program); context.setDepthMode(depthMode); context.setStencilMode(stencilMode); context.setColorMode(colorMode); context.setCullFace(cullFaceMode); // set variables used by the 3d functions defined in _prelude.vertex.glsl if (terrain) { context.activeTexture.set(gl.TEXTURE2); gl.bindTexture(gl.TEXTURE_2D, terrain.depthTexture); context.activeTexture.set(gl.TEXTURE3); gl.bindTexture(gl.TEXTURE_2D, terrain.texture); for (const name in this.terrainUniforms) { this.terrainUniforms[name].set(terrain[name]); } } for (const name in this.fixedUniforms) { this.fixedUniforms[name].set(uniformValues[name]); } if (configuration) { configuration.setUniforms(context, this.binderUniforms, currentProperties, { zoom: zoom }); } let primitiveSize = 0; switch (drawMode) { case gl.LINES: primitiveSize = 2; break; case gl.TRIANGLES: primitiveSize = 3; break; case gl.LINE_STRIP: primitiveSize = 1; break; } for (const segment of segments.get()) { const vaos = segment.vaos || (segment.vaos = {}); const vao = vaos[layerID] || (vaos[layerID] = new VertexArrayObject()); vao.bind(context, this, layoutVertexBuffer, configuration ? configuration.getPaintVertexBuffers() : [], indexBuffer, segment.vertexOffset, dynamicLayoutBuffer, dynamicLayoutBuffer2, dynamicLayoutBuffer3); gl.drawElements(drawMode, segment.primitiveLength * primitiveSize, gl.UNSIGNED_SHORT, segment.primitiveOffset * primitiveSize * 2); } } } function patternUniformValues(crossfade, painter, tile) { const tileRatio = 1 / pixelsToTileUnits(tile, 1, painter.transform.tileZoom); const numTiles = Math.pow(2, tile.tileID.overscaledZ); const tileSizeAtNearestZoom = tile.tileSize * Math.pow(2, painter.transform.tileZoom) / numTiles; const pixelX = tileSizeAtNearestZoom * (tile.tileID.canonical.x + tile.tileID.wrap * numTiles); const pixelY = tileSizeAtNearestZoom * tile.tileID.canonical.y; return { 'u_image': 0, 'u_texsize': tile.imageAtlasTexture.size, 'u_scale': [tileRatio, crossfade.fromScale, crossfade.toScale], 'u_fade': crossfade.t, // split the pixel coord into two pairs of 16 bit numbers. The glsl spec only guarantees 16 bits of precision. 'u_pixel_coord_upper': [pixelX >> 16, pixelY >> 16], 'u_pixel_coord_lower': [pixelX & 0xFFFF, pixelY & 0xFFFF] }; } function bgPatternUniformValues(image, crossfade, painter, tile) { const imagePosA = painter.imageManager.getPattern(image.from.toString()); const imagePosB = painter.imageManager.getPattern(image.to.toString()); const { width, height } = painter.imageManager.getPixelSize(); const numTiles = Math.pow(2, tile.tileID.overscaledZ); const tileSizeAtNearestZoom = tile.tileSize * Math.pow(2, painter.transform.tileZoom) / numTiles; const pixelX = tileSizeAtNearestZoom * (tile.tileID.canonical.x + tile.tileID.wrap * numTiles); const pixelY = tileSizeAtNearestZoom * tile.tileID.canonical.y; return { 'u_image': 0, 'u_pattern_tl_a': imagePosA.tl, 'u_pattern_br_a': imagePosA.br, 'u_pattern_tl_b': imagePosB.tl, 'u_pattern_br_b': imagePosB.br, 'u_texsize': [width, height], 'u_mix': crossfade.t, 'u_pattern_size_a': imagePosA.displaySize, 'u_pattern_size_b': imagePosB.displaySize, 'u_scale_a': crossfade.fromScale, 'u_scale_b': crossfade.toScale, 'u_tile_units_to_pixels': 1 / pixelsToTileUnits(tile, 1, painter.transform.tileZoom), // split the pixel coord into two pairs of 16 bit numbers. The glsl spec only guarantees 16 bits of precision. 'u_pixel_coord_upper': [pixelX >> 16, pixelY >> 16], 'u_pixel_coord_lower': [pixelX & 0xFFFF, pixelY & 0xFFFF] }; } const fillExtrusionUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_lightpos': new Uniform3f(context, locations.u_lightpos), 'u_lightintensity': new Uniform1f(context, locations.u_lightintensity), 'u_lightcolor': new Uniform3f(context, locations.u_lightcolor), 'u_vertical_gradient': new Uniform1f(context, locations.u_vertical_gradient), 'u_opacity': new Uniform1f(context, locations.u_opacity) }); const fillExtrusionPatternUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_lightpos': new Uniform3f(context, locations.u_lightpos), 'u_lightintensity': new Uniform1f(context, locations.u_lightintensity), 'u_lightcolor': new Uniform3f(context, locations.u_lightcolor), 'u_vertical_gradient': new Uniform1f(context, locations.u_vertical_gradient), 'u_height_factor': new Uniform1f(context, locations.u_height_factor), // pattern uniforms 'u_image': new Uniform1i(context, locations.u_image), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_pixel_coord_upper': new Uniform2f(context, locations.u_pixel_coord_upper), 'u_pixel_coord_lower': new Uniform2f(context, locations.u_pixel_coord_lower), 'u_scale': new Uniform3f(context, locations.u_scale), 'u_fade': new Uniform1f(context, locations.u_fade), 'u_opacity': new Uniform1f(context, locations.u_opacity) }); const fillExtrusionUniformValues = (matrix, painter, shouldUseVerticalGradient, opacity) => { const light = painter.style.light; const _lp = light.properties.get('position'); const lightPos = [_lp.x, _lp.y, _lp.z]; const lightMat = create$7(); if (light.properties.get('anchor') === 'viewport') { fromRotation$2(lightMat, -painter.transform.angle); } transformMat3$1(lightPos, lightPos, lightMat); const lightColor = light.properties.get('color'); return { 'u_matrix': matrix, 'u_lightpos': lightPos, 'u_lightintensity': light.properties.get('intensity'), 'u_lightcolor': [lightColor.r, lightColor.g, lightColor.b], 'u_vertical_gradient': +shouldUseVerticalGradient, 'u_opacity': opacity }; }; const fillExtrusionPatternUniformValues = (matrix, painter, shouldUseVerticalGradient, opacity, coord, crossfade, tile) => { return extend(fillExtrusionUniformValues(matrix, painter, shouldUseVerticalGradient, opacity), patternUniformValues(crossfade, painter, tile), { 'u_height_factor': -Math.pow(2, coord.overscaledZ) / tile.tileSize / 8 }); }; const fillUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix) }); const fillPatternUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_image': new Uniform1i(context, locations.u_image), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_pixel_coord_upper': new Uniform2f(context, locations.u_pixel_coord_upper), 'u_pixel_coord_lower': new Uniform2f(context, locations.u_pixel_coord_lower), 'u_scale': new Uniform3f(context, locations.u_scale), 'u_fade': new Uniform1f(context, locations.u_fade) }); const fillOutlineUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_world': new Uniform2f(context, locations.u_world) }); const fillOutlinePatternUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_world': new Uniform2f(context, locations.u_world), 'u_image': new Uniform1i(context, locations.u_image), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_pixel_coord_upper': new Uniform2f(context, locations.u_pixel_coord_upper), 'u_pixel_coord_lower': new Uniform2f(context, locations.u_pixel_coord_lower), 'u_scale': new Uniform3f(context, locations.u_scale), 'u_fade': new Uniform1f(context, locations.u_fade) }); const fillUniformValues = (matrix) => ({ 'u_matrix': matrix }); const fillPatternUniformValues = (matrix, painter, crossfade, tile) => extend(fillUniformValues(matrix), patternUniformValues(crossfade, painter, tile)); const fillOutlineUniformValues = (matrix, drawingBufferSize) => ({ 'u_matrix': matrix, 'u_world': drawingBufferSize }); const fillOutlinePatternUniformValues = (matrix, painter, crossfade, tile, drawingBufferSize) => extend(fillPatternUniformValues(matrix, painter, crossfade, tile), { 'u_world': drawingBufferSize }); const circleUniforms = (context, locations) => ({ 'u_camera_to_center_distance': new Uniform1f(context, locations.u_camera_to_center_distance), 'u_scale_with_map': new Uniform1i(context, locations.u_scale_with_map), 'u_pitch_with_map': new Uniform1i(context, locations.u_pitch_with_map), 'u_extrude_scale': new Uniform2f(context, locations.u_extrude_scale), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix) }); const circleUniformValues = (painter, coord, tile, layer) => { const transform = painter.transform; let pitchWithMap, extrudeScale; if (layer.paint.get('circle-pitch-alignment') === 'map') { const pixelRatio = pixelsToTileUnits(tile, 1, transform.zoom); pitchWithMap = true; extrudeScale = [pixelRatio, pixelRatio]; } else { pitchWithMap = false; extrudeScale = transform.pixelsToGLUnits; } return { 'u_camera_to_center_distance': transform.cameraToCenterDistance, 'u_scale_with_map': +(layer.paint.get('circle-pitch-scale') === 'map'), 'u_matrix': painter.translatePosMatrix(coord.posMatrix, tile, layer.paint.get('circle-translate'), layer.paint.get('circle-translate-anchor')), 'u_pitch_with_map': +(pitchWithMap), 'u_device_pixel_ratio': painter.pixelRatio, 'u_extrude_scale': extrudeScale }; }; const collisionUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_pixel_extrude_scale': new Uniform2f(context, locations.u_pixel_extrude_scale) }); const collisionCircleUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_inv_matrix': new UniformMatrix4f(context, locations.u_inv_matrix), 'u_camera_to_center_distance': new Uniform1f(context, locations.u_camera_to_center_distance), 'u_viewport_size': new Uniform2f(context, locations.u_viewport_size) }); const collisionUniformValues = (transform, matrix) => { return { 'u_matrix': matrix, 'u_pixel_extrude_scale': [1.0 / transform.width, 1.0 / transform.height], }; }; const collisionCircleUniformValues = (matrix, invMatrix, transform) => { return { 'u_matrix': matrix, 'u_inv_matrix': invMatrix, 'u_camera_to_center_distance': transform.cameraToCenterDistance, 'u_viewport_size': [transform.width, transform.height] }; }; const debugUniforms = (context, locations) => ({ 'u_color': new UniformColor(context, locations.u_color), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_overlay': new Uniform1i(context, locations.u_overlay), 'u_overlay_scale': new Uniform1f(context, locations.u_overlay_scale) }); const debugUniformValues = (matrix, color, scaleRatio = 1) => ({ 'u_matrix': matrix, 'u_color': color, 'u_overlay': 0, 'u_overlay_scale': scaleRatio }); const clippingMaskUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix) }); const clippingMaskUniformValues = (matrix) => ({ 'u_matrix': matrix }); const heatmapUniforms = (context, locations) => ({ 'u_extrude_scale': new Uniform1f(context, locations.u_extrude_scale), 'u_intensity': new Uniform1f(context, locations.u_intensity), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix) }); const heatmapTextureUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_world': new Uniform2f(context, locations.u_world), 'u_image': new Uniform1i(context, locations.u_image), 'u_color_ramp': new Uniform1i(context, locations.u_color_ramp), 'u_opacity': new Uniform1f(context, locations.u_opacity) }); const heatmapUniformValues = (matrix, tile, zoom, intensity) => ({ 'u_matrix': matrix, 'u_extrude_scale': pixelsToTileUnits(tile, 1, zoom), 'u_intensity': intensity }); const heatmapTextureUniformValues = (painter, layer, textureUnit, colorRampUnit) => { const matrix = create$6(); ortho(matrix, 0, painter.width, painter.height, 0, 0, 1); const gl = painter.context.gl; return { 'u_matrix': matrix, 'u_world': [gl.drawingBufferWidth, gl.drawingBufferHeight], 'u_image': textureUnit, 'u_color_ramp': colorRampUnit, 'u_opacity': layer.paint.get('heatmap-opacity') }; }; const hillshadeUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_image': new Uniform1i(context, locations.u_image), 'u_latrange': new Uniform2f(context, locations.u_latrange), 'u_light': new Uniform2f(context, locations.u_light), 'u_shadow': new UniformColor(context, locations.u_shadow), 'u_highlight': new UniformColor(context, locations.u_highlight), 'u_accent': new UniformColor(context, locations.u_accent) }); const hillshadePrepareUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_image': new Uniform1i(context, locations.u_image), 'u_dimension': new Uniform2f(context, locations.u_dimension), 'u_zoom': new Uniform1f(context, locations.u_zoom), 'u_unpack': new Uniform4f(context, locations.u_unpack) }); const hillshadeUniformValues = (painter, tile, layer, coord) => { const shadow = layer.paint.get('hillshade-shadow-color'); const highlight = layer.paint.get('hillshade-highlight-color'); const accent = layer.paint.get('hillshade-accent-color'); let azimuthal = layer.paint.get('hillshade-illumination-direction') * (Math.PI / 180); // modify azimuthal angle by map rotation if light is anchored at the viewport if (layer.paint.get('hillshade-illumination-anchor') === 'viewport') { azimuthal -= painter.transform.angle; } const align = !painter.options.moving; return { 'u_matrix': coord ? coord.posMatrix : painter.transform.calculatePosMatrix(tile.tileID.toUnwrapped(), align), 'u_image': 0, 'u_latrange': getTileLatRange(painter, tile.tileID), 'u_light': [layer.paint.get('hillshade-exaggeration'), azimuthal], 'u_shadow': shadow, 'u_highlight': highlight, 'u_accent': accent }; }; const hillshadeUniformPrepareValues = (tileID, dem) => { const stride = dem.stride; const matrix = create$6(); // Flip rendering at y axis. ortho(matrix, 0, EXTENT, -EXTENT, 0, 0, 1); translate$1(matrix, matrix, [0, -EXTENT, 0]); return { 'u_matrix': matrix, 'u_image': 1, 'u_dimension': [stride, stride], 'u_zoom': tileID.overscaledZ, 'u_unpack': dem.getUnpackVector() }; }; function getTileLatRange(painter, tileID) { // for scaling the magnitude of a points slope by its latitude const tilesAtZoom = Math.pow(2, tileID.canonical.z); const y = tileID.canonical.y; return [ new MercatorCoordinate(0, y / tilesAtZoom).toLngLat().lat, new MercatorCoordinate(0, (y + 1) / tilesAtZoom).toLngLat().lat ]; } const lineUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_ratio': new Uniform1f(context, locations.u_ratio), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_units_to_pixels': new Uniform2f(context, locations.u_units_to_pixels) }); const lineGradientUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_ratio': new Uniform1f(context, locations.u_ratio), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_units_to_pixels': new Uniform2f(context, locations.u_units_to_pixels), 'u_image': new Uniform1i(context, locations.u_image), 'u_image_height': new Uniform1f(context, locations.u_image_height) }); const linePatternUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_ratio': new Uniform1f(context, locations.u_ratio), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_image': new Uniform1i(context, locations.u_image), 'u_units_to_pixels': new Uniform2f(context, locations.u_units_to_pixels), 'u_scale': new Uniform3f(context, locations.u_scale), 'u_fade': new Uniform1f(context, locations.u_fade) }); const lineSDFUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_ratio': new Uniform1f(context, locations.u_ratio), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_units_to_pixels': new Uniform2f(context, locations.u_units_to_pixels), 'u_patternscale_a': new Uniform2f(context, locations.u_patternscale_a), 'u_patternscale_b': new Uniform2f(context, locations.u_patternscale_b), 'u_sdfgamma': new Uniform1f(context, locations.u_sdfgamma), 'u_image': new Uniform1i(context, locations.u_image), 'u_tex_y_a': new Uniform1f(context, locations.u_tex_y_a), 'u_tex_y_b': new Uniform1f(context, locations.u_tex_y_b), 'u_mix': new Uniform1f(context, locations.u_mix) }); const lineUniformValues = (painter, tile, layer, coord) => { const transform = painter.transform; return { 'u_matrix': calculateMatrix(painter, tile, layer, coord), 'u_ratio': 1 / pixelsToTileUnits(tile, 1, transform.zoom), 'u_device_pixel_ratio': painter.pixelRatio, 'u_units_to_pixels': [ 1 / transform.pixelsToGLUnits[0], 1 / transform.pixelsToGLUnits[1] ] }; }; const lineGradientUniformValues = (painter, tile, layer, imageHeight, coord) => { return extend(lineUniformValues(painter, tile, layer, coord), { 'u_image': 0, 'u_image_height': imageHeight, }); }; const linePatternUniformValues = (painter, tile, layer, crossfade, coord) => { const transform = painter.transform; const tileZoomRatio = calculateTileRatio(tile, transform); return { 'u_matrix': calculateMatrix(painter, tile, layer, coord), 'u_texsize': tile.imageAtlasTexture.size, // camera zoom ratio 'u_ratio': 1 / pixelsToTileUnits(tile, 1, transform.zoom), 'u_device_pixel_ratio': painter.pixelRatio, 'u_image': 0, 'u_scale': [tileZoomRatio, crossfade.fromScale, crossfade.toScale], 'u_fade': crossfade.t, 'u_units_to_pixels': [ 1 / transform.pixelsToGLUnits[0], 1 / transform.pixelsToGLUnits[1] ] }; }; const lineSDFUniformValues = (painter, tile, layer, dasharray, crossfade, coord) => { const transform = painter.transform; const lineAtlas = painter.lineAtlas; const tileRatio = calculateTileRatio(tile, transform); const round = layer.layout.get('line-cap') === 'round'; const posA = lineAtlas.getDash(dasharray.from, round); const posB = lineAtlas.getDash(dasharray.to, round); const widthA = posA.width * crossfade.fromScale; const widthB = posB.width * crossfade.toScale; return extend(lineUniformValues(painter, tile, layer, coord), { 'u_patternscale_a': [tileRatio / widthA, -posA.height / 2], 'u_patternscale_b': [tileRatio / widthB, -posB.height / 2], 'u_sdfgamma': lineAtlas.width / (Math.min(widthA, widthB) * 256 * painter.pixelRatio) / 2, 'u_image': 0, 'u_tex_y_a': posA.y, 'u_tex_y_b': posB.y, 'u_mix': crossfade.t }); }; function calculateTileRatio(tile, transform) { return 1 / pixelsToTileUnits(tile, 1, transform.tileZoom); } function calculateMatrix(painter, tile, layer, coord) { return painter.translatePosMatrix(coord ? coord.posMatrix : tile.tileID.posMatrix, tile, layer.paint.get('line-translate'), layer.paint.get('line-translate-anchor')); } const rasterUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_tl_parent': new Uniform2f(context, locations.u_tl_parent), 'u_scale_parent': new Uniform1f(context, locations.u_scale_parent), 'u_buffer_scale': new Uniform1f(context, locations.u_buffer_scale), 'u_fade_t': new Uniform1f(context, locations.u_fade_t), 'u_opacity': new Uniform1f(context, locations.u_opacity), 'u_image0': new Uniform1i(context, locations.u_image0), 'u_image1': new Uniform1i(context, locations.u_image1), 'u_brightness_low': new Uniform1f(context, locations.u_brightness_low), 'u_brightness_high': new Uniform1f(context, locations.u_brightness_high), 'u_saturation_factor': new Uniform1f(context, locations.u_saturation_factor), 'u_contrast_factor': new Uniform1f(context, locations.u_contrast_factor), 'u_spin_weights': new Uniform3f(context, locations.u_spin_weights) }); const rasterUniformValues = (matrix, parentTL, parentScaleBy, fade, layer) => ({ 'u_matrix': matrix, 'u_tl_parent': parentTL, 'u_scale_parent': parentScaleBy, 'u_buffer_scale': 1, 'u_fade_t': fade.mix, 'u_opacity': fade.opacity * layer.paint.get('raster-opacity'), 'u_image0': 0, 'u_image1': 1, 'u_brightness_low': layer.paint.get('raster-brightness-min'), 'u_brightness_high': layer.paint.get('raster-brightness-max'), 'u_saturation_factor': saturationFactor(layer.paint.get('raster-saturation')), 'u_contrast_factor': contrastFactor(layer.paint.get('raster-contrast')), 'u_spin_weights': spinWeights(layer.paint.get('raster-hue-rotate')) }); function spinWeights(angle) { angle *= Math.PI / 180; const s = Math.sin(angle); const c = Math.cos(angle); return [ (2 * c + 1) / 3, (-Math.sqrt(3) * s - c + 1) / 3, (Math.sqrt(3) * s - c + 1) / 3 ]; } function contrastFactor(contrast) { return contrast > 0 ? 1 / (1 - contrast) : 1 + contrast; } function saturationFactor(saturation) { return saturation > 0 ? 1 - 1 / (1.001 - saturation) : -saturation; } const symbolIconUniforms = (context, locations) => ({ 'u_is_size_zoom_constant': new Uniform1i(context, locations.u_is_size_zoom_constant), 'u_is_size_feature_constant': new Uniform1i(context, locations.u_is_size_feature_constant), 'u_size_t': new Uniform1f(context, locations.u_size_t), 'u_size': new Uniform1f(context, locations.u_size), 'u_camera_to_center_distance': new Uniform1f(context, locations.u_camera_to_center_distance), 'u_pitch': new Uniform1f(context, locations.u_pitch), 'u_rotate_symbol': new Uniform1i(context, locations.u_rotate_symbol), 'u_aspect_ratio': new Uniform1f(context, locations.u_aspect_ratio), 'u_fade_change': new Uniform1f(context, locations.u_fade_change), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_label_plane_matrix': new UniformMatrix4f(context, locations.u_label_plane_matrix), 'u_coord_matrix': new UniformMatrix4f(context, locations.u_coord_matrix), 'u_is_text': new Uniform1i(context, locations.u_is_text), 'u_pitch_with_map': new Uniform1i(context, locations.u_pitch_with_map), 'u_is_along_line': new Uniform1i(context, locations.u_is_along_line), 'u_is_variable_anchor': new Uniform1i(context, locations.u_is_variable_anchor), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_texture': new Uniform1i(context, locations.u_texture), 'u_translation': new Uniform2f(context, locations.u_translation), 'u_pitched_scale': new Uniform1f(context, locations.u_pitched_scale), }); const symbolSDFUniforms = (context, locations) => ({ 'u_is_size_zoom_constant': new Uniform1i(context, locations.u_is_size_zoom_constant), 'u_is_size_feature_constant': new Uniform1i(context, locations.u_is_size_feature_constant), 'u_size_t': new Uniform1f(context, locations.u_size_t), 'u_size': new Uniform1f(context, locations.u_size), 'u_camera_to_center_distance': new Uniform1f(context, locations.u_camera_to_center_distance), 'u_pitch': new Uniform1f(context, locations.u_pitch), 'u_rotate_symbol': new Uniform1i(context, locations.u_rotate_symbol), 'u_aspect_ratio': new Uniform1f(context, locations.u_aspect_ratio), 'u_fade_change': new Uniform1f(context, locations.u_fade_change), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_label_plane_matrix': new UniformMatrix4f(context, locations.u_label_plane_matrix), 'u_coord_matrix': new UniformMatrix4f(context, locations.u_coord_matrix), 'u_is_text': new Uniform1i(context, locations.u_is_text), 'u_pitch_with_map': new Uniform1i(context, locations.u_pitch_with_map), 'u_is_along_line': new Uniform1i(context, locations.u_is_along_line), 'u_is_variable_anchor': new Uniform1i(context, locations.u_is_variable_anchor), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_texture': new Uniform1i(context, locations.u_texture), 'u_gamma_scale': new Uniform1f(context, locations.u_gamma_scale), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_is_halo': new Uniform1i(context, locations.u_is_halo), 'u_translation': new Uniform2f(context, locations.u_translation), 'u_pitched_scale': new Uniform1f(context, locations.u_pitched_scale), }); const symbolTextAndIconUniforms = (context, locations) => ({ 'u_is_size_zoom_constant': new Uniform1i(context, locations.u_is_size_zoom_constant), 'u_is_size_feature_constant': new Uniform1i(context, locations.u_is_size_feature_constant), 'u_size_t': new Uniform1f(context, locations.u_size_t), 'u_size': new Uniform1f(context, locations.u_size), 'u_camera_to_center_distance': new Uniform1f(context, locations.u_camera_to_center_distance), 'u_pitch': new Uniform1f(context, locations.u_pitch), 'u_rotate_symbol': new Uniform1i(context, locations.u_rotate_symbol), 'u_aspect_ratio': new Uniform1f(context, locations.u_aspect_ratio), 'u_fade_change': new Uniform1f(context, locations.u_fade_change), 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_label_plane_matrix': new UniformMatrix4f(context, locations.u_label_plane_matrix), 'u_coord_matrix': new UniformMatrix4f(context, locations.u_coord_matrix), 'u_is_text': new Uniform1i(context, locations.u_is_text), 'u_pitch_with_map': new Uniform1i(context, locations.u_pitch_with_map), 'u_is_along_line': new Uniform1i(context, locations.u_is_along_line), 'u_is_variable_anchor': new Uniform1i(context, locations.u_is_variable_anchor), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_texsize_icon': new Uniform2f(context, locations.u_texsize_icon), 'u_texture': new Uniform1i(context, locations.u_texture), 'u_texture_icon': new Uniform1i(context, locations.u_texture_icon), 'u_gamma_scale': new Uniform1f(context, locations.u_gamma_scale), 'u_device_pixel_ratio': new Uniform1f(context, locations.u_device_pixel_ratio), 'u_is_halo': new Uniform1i(context, locations.u_is_halo), 'u_translation': new Uniform2f(context, locations.u_translation), 'u_pitched_scale': new Uniform1f(context, locations.u_pitched_scale), }); const symbolIconUniformValues = (functionType, size, rotateInShader, pitchWithMap, isAlongLine, isVariableAnchor, painter, matrix, labelPlaneMatrix, glCoordMatrix, translation, isText, texSize, pitchedScale) => { const transform = painter.transform; return { 'u_is_size_zoom_constant': +(functionType === 'constant' || functionType === 'source'), 'u_is_size_feature_constant': +(functionType === 'constant' || functionType === 'camera'), 'u_size_t': size ? size.uSizeT : 0, 'u_size': size ? size.uSize : 0, 'u_camera_to_center_distance': transform.cameraToCenterDistance, 'u_pitch': transform.pitch / 360 * 2 * Math.PI, 'u_rotate_symbol': +rotateInShader, 'u_aspect_ratio': transform.width / transform.height, 'u_fade_change': painter.options.fadeDuration ? painter.symbolFadeChange : 1, 'u_matrix': matrix, 'u_label_plane_matrix': labelPlaneMatrix, 'u_coord_matrix': glCoordMatrix, 'u_is_text': +isText, 'u_pitch_with_map': +pitchWithMap, 'u_is_along_line': isAlongLine, 'u_is_variable_anchor': isVariableAnchor, 'u_texsize': texSize, 'u_texture': 0, 'u_translation': translation, 'u_pitched_scale': pitchedScale }; }; const symbolSDFUniformValues = (functionType, size, rotateInShader, pitchWithMap, isAlongLine, isVariableAnchor, painter, matrix, labelPlaneMatrix, glCoordMatrix, translation, isText, texSize, isHalo, pitchedScale) => { const transform = painter.transform; return extend(symbolIconUniformValues(functionType, size, rotateInShader, pitchWithMap, isAlongLine, isVariableAnchor, painter, matrix, labelPlaneMatrix, glCoordMatrix, translation, isText, texSize, pitchedScale), { 'u_gamma_scale': (pitchWithMap ? Math.cos(transform._pitch) * transform.cameraToCenterDistance : 1), 'u_device_pixel_ratio': painter.pixelRatio, 'u_is_halo': +isHalo }); }; const symbolTextAndIconUniformValues = (functionType, size, rotateInShader, pitchWithMap, isAlongLine, isVariableAnchor, painter, matrix, labelPlaneMatrix, glCoordMatrix, translation, texSizeSDF, texSizeIcon, pitchedScale) => { return extend(symbolSDFUniformValues(functionType, size, rotateInShader, pitchWithMap, isAlongLine, isVariableAnchor, painter, matrix, labelPlaneMatrix, glCoordMatrix, translation, true, texSizeSDF, true, pitchedScale), { 'u_texsize_icon': texSizeIcon, 'u_texture_icon': 1 }); }; const backgroundUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_opacity': new Uniform1f(context, locations.u_opacity), 'u_color': new UniformColor(context, locations.u_color) }); const backgroundPatternUniforms = (context, locations) => ({ 'u_matrix': new UniformMatrix4f(context, locations.u_matrix), 'u_opacity': new Uniform1f(context, locations.u_opacity), 'u_image': new Uniform1i(context, locations.u_image), 'u_pattern_tl_a': new Uniform2f(context, locations.u_pattern_tl_a), 'u_pattern_br_a': new Uniform2f(context, locations.u_pattern_br_a), 'u_pattern_tl_b': new Uniform2f(context, locations.u_pattern_tl_b), 'u_pattern_br_b': new Uniform2f(context, locations.u_pattern_br_b), 'u_texsize': new Uniform2f(context, locations.u_texsize), 'u_mix': new Uniform1f(context, locations.u_mix), 'u_pattern_size_a': new Uniform2f(context, locations.u_pattern_size_a), 'u_pattern_size_b': new Uniform2f(context, locations.u_pattern_size_b), 'u_scale_a': new Uniform1f(context, locations.u_scale_a), 'u_scale_b': new Uniform1f(context, locations.u_scale_b), 'u_pixel_coord_upper': new Uniform2f(context, locations.u_pixel_coord_upper), 'u_pixel_coord_lower': new Uniform2f(context, locations.u_pixel_coord_lower), 'u_tile_units_to_pixels': new Uniform1f(context, locations.u_tile_units_to_pixels) }); const backgroundUniformValues = (matrix, opacity, color) => ({ 'u_matrix': matrix, 'u_opacity': opacity, 'u_color': color }); const backgroundPatternUniformValues = (matrix, opacity, painter, image, tile, crossfade) => extend(bgPatternUniformValues(image, crossfade, painter, tile), { 'u_matrix': matrix, 'u_opacity': opacity }); const skyUniforms = (context, locations) => ({ 'u_sky_color': new UniformColor(context, locations.u_sky_color), 'u_horizon_color': new UniformColor(context, locations.u_horizon_color), 'u_horizon': new Uniform1f(context, locations.u_horizon), 'u_sky_horizon_blend': new Uniform1f(context, locations.u_sky_horizon_blend), }); const skyUniformValues = (sky, transform, pixelRatio) => ({ 'u_sky_color': sky.properties.get('sky-color'), 'u_horizon_color': sky.properties.get('horizon-color'), 'u_horizon': (transform.height / 2 + transform.getHorizon()) * pixelRatio, 'u_sky_horizon_blend': (sky.properties.get('sky-horizon-blend') * transform.height / 2) * pixelRatio, }); const programUniforms = { fillExtrusion: fillExtrusionUniforms, fillExtrusionPattern: fillExtrusionPatternUniforms, fill: fillUniforms, fillPattern: fillPatternUniforms, fillOutline: fillOutlineUniforms, fillOutlinePattern: fillOutlinePatternUniforms, circle: circleUniforms, collisionBox: collisionUniforms, collisionCircle: collisionCircleUniforms, debug: debugUniforms, clippingMask: clippingMaskUniforms, heatmap: heatmapUniforms, heatmapTexture: heatmapTextureUniforms, hillshade: hillshadeUniforms, hillshadePrepare: hillshadePrepareUniforms, line: lineUniforms, lineGradient: lineGradientUniforms, linePattern: linePatternUniforms, lineSDF: lineSDFUniforms, raster: rasterUniforms, symbolIcon: symbolIconUniforms, symbolSDF: symbolSDFUniforms, symbolTextAndIcon: symbolTextAndIconUniforms, background: backgroundUniforms, backgroundPattern: backgroundPatternUniforms, terrain: terrainUniforms, terrainDepth: terrainDepthUniforms, terrainCoords: terrainCoordsUniforms, sky: skyUniforms }; /** * @internal * an index buffer class */ class IndexBuffer { constructor(context, array, dynamicDraw) { this.context = context; const gl = context.gl; this.buffer = gl.createBuffer(); this.dynamicDraw = Boolean(dynamicDraw); // The bound index buffer is part of vertex array object state. We don't want to // modify whatever VAO happens to be currently bound, so make sure the default // vertex array provided by the context is bound instead. this.context.unbindVAO(); context.bindElementBuffer.set(this.buffer); gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, array.arrayBuffer, this.dynamicDraw ? gl.DYNAMIC_DRAW : gl.STATIC_DRAW); if (!this.dynamicDraw) { delete array.arrayBuffer; } } bind() { this.context.bindElementBuffer.set(this.buffer); } updateData(array) { const gl = this.context.gl; if (!this.dynamicDraw) throw new Error('Attempted to update data while not in dynamic mode.'); // The right VAO will get this buffer re-bound later in VertexArrayObject#bind // See https://github.com/mapbox/mapbox-gl-js/issues/5620 this.context.unbindVAO(); this.bind(); gl.bufferSubData(gl.ELEMENT_ARRAY_BUFFER, 0, array.arrayBuffer); } destroy() { const gl = this.context.gl; if (this.buffer) { gl.deleteBuffer(this.buffer); delete this.buffer; } } } /** * An Enum for AttributeType */ const AttributeType = { Int8: 'BYTE', Uint8: 'UNSIGNED_BYTE', Int16: 'SHORT', Uint16: 'UNSIGNED_SHORT', Int32: 'INT', Uint32: 'UNSIGNED_INT', Float32: 'FLOAT' }; /** * @internal * The `VertexBuffer` class turns a `StructArray` into a WebGL buffer. Each member of the StructArray's * Struct type is converted to a WebGL attribute. */ class VertexBuffer { /** * @param dynamicDraw - Whether this buffer will be repeatedly updated. */ constructor(context, array, attributes, dynamicDraw) { this.length = array.length; this.attributes = attributes; this.itemSize = array.bytesPerElement; this.dynamicDraw = dynamicDraw; this.context = context; const gl = context.gl; this.buffer = gl.createBuffer(); context.bindVertexBuffer.set(this.buffer); gl.bufferData(gl.ARRAY_BUFFER, array.arrayBuffer, this.dynamicDraw ? gl.DYNAMIC_DRAW : gl.STATIC_DRAW); if (!this.dynamicDraw) { delete array.arrayBuffer; } } bind() { this.context.bindVertexBuffer.set(this.buffer); } updateData(array) { if (array.length !== this.length) throw new Error(`Length of new data is ${array.length}, which doesn't match current length of ${this.length}`); const gl = this.context.gl; this.bind(); gl.bufferSubData(gl.ARRAY_BUFFER, 0, array.arrayBuffer); } enableAttributes(gl, program) { for (let j = 0; j < this.attributes.length; j++) { const member = this.attributes[j]; const attribIndex = program.attributes[member.name]; if (attribIndex !== undefined) { gl.enableVertexAttribArray(attribIndex); } } } /** * Set the attribute pointers in a WebGL context * @param gl - The WebGL context * @param program - The active WebGL program * @param vertexOffset - Index of the starting vertex of the segment */ setVertexAttribPointers(gl, program, vertexOffset) { for (let j = 0; j < this.attributes.length; j++) { const member = this.attributes[j]; const attribIndex = program.attributes[member.name]; if (attribIndex !== undefined) { gl.vertexAttribPointer(attribIndex, member.components, gl[AttributeType[member.type]], false, this.itemSize, member.offset + (this.itemSize * (vertexOffset || 0))); } } } /** * Destroy the GL buffer bound to the given WebGL context */ destroy() { const gl = this.context.gl; if (this.buffer) { gl.deleteBuffer(this.buffer); delete this.buffer; } } } const cache = new WeakMap(); function isWebGL2(gl) { var _a; if (cache.has(gl)) { return cache.get(gl); } else { const value = (_a = gl.getParameter(gl.VERSION)) === null || _a === void 0 ? void 0 : _a.startsWith('WebGL 2.0'); cache.set(gl, value); return value; } } class BaseValue { constructor(context) { this.gl = context.gl; this.default = this.getDefault(); this.current = this.default; this.dirty = false; } get() { return this.current; } set(value) { // overridden in child classes; } getDefault() { return this.default; // overridden in child classes } setDefault() { this.set(this.default); } } class ClearColor extends BaseValue { getDefault() { return Color.transparent; } set(v) { const c = this.current; if (v.r === c.r && v.g === c.g && v.b === c.b && v.a === c.a && !this.dirty) return; this.gl.clearColor(v.r, v.g, v.b, v.a); this.current = v; this.dirty = false; } } class ClearDepth extends BaseValue { getDefault() { return 1; } set(v) { if (v === this.current && !this.dirty) return; this.gl.clearDepth(v); this.current = v; this.dirty = false; } } class ClearStencil extends BaseValue { getDefault() { return 0; } set(v) { if (v === this.current && !this.dirty) return; this.gl.clearStencil(v); this.current = v; this.dirty = false; } } class ColorMask extends BaseValue { getDefault() { return [true, true, true, true]; } set(v) { const c = this.current; if (v[0] === c[0] && v[1] === c[1] && v[2] === c[2] && v[3] === c[3] && !this.dirty) return; this.gl.colorMask(v[0], v[1], v[2], v[3]); this.current = v; this.dirty = false; } } class DepthMask extends BaseValue { getDefault() { return true; } set(v) { if (v === this.current && !this.dirty) return; this.gl.depthMask(v); this.current = v; this.dirty = false; } } class StencilMask extends BaseValue { getDefault() { return 0xFF; } set(v) { if (v === this.current && !this.dirty) return; this.gl.stencilMask(v); this.current = v; this.dirty = false; } } class StencilFunc extends BaseValue { getDefault() { return { func: this.gl.ALWAYS, ref: 0, mask: 0xFF }; } set(v) { const c = this.current; if (v.func === c.func && v.ref === c.ref && v.mask === c.mask && !this.dirty) return; this.gl.stencilFunc(v.func, v.ref, v.mask); this.current = v; this.dirty = false; } } class StencilOp extends BaseValue { getDefault() { const gl = this.gl; return [gl.KEEP, gl.KEEP, gl.KEEP]; } set(v) { const c = this.current; if (v[0] === c[0] && v[1] === c[1] && v[2] === c[2] && !this.dirty) return; this.gl.stencilOp(v[0], v[1], v[2]); this.current = v; this.dirty = false; } } class StencilTest extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; if (v) { gl.enable(gl.STENCIL_TEST); } else { gl.disable(gl.STENCIL_TEST); } this.current = v; this.dirty = false; } } class DepthRange extends BaseValue { getDefault() { return [0, 1]; } set(v) { const c = this.current; if (v[0] === c[0] && v[1] === c[1] && !this.dirty) return; this.gl.depthRange(v[0], v[1]); this.current = v; this.dirty = false; } } class DepthTest extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; if (v) { gl.enable(gl.DEPTH_TEST); } else { gl.disable(gl.DEPTH_TEST); } this.current = v; this.dirty = false; } } class DepthFunc extends BaseValue { getDefault() { return this.gl.LESS; } set(v) { if (v === this.current && !this.dirty) return; this.gl.depthFunc(v); this.current = v; this.dirty = false; } } class Blend extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; if (v) { gl.enable(gl.BLEND); } else { gl.disable(gl.BLEND); } this.current = v; this.dirty = false; } } class BlendFunc extends BaseValue { getDefault() { const gl = this.gl; return [gl.ONE, gl.ZERO]; } set(v) { const c = this.current; if (v[0] === c[0] && v[1] === c[1] && !this.dirty) return; this.gl.blendFunc(v[0], v[1]); this.current = v; this.dirty = false; } } class BlendColor extends BaseValue { getDefault() { return Color.transparent; } set(v) { const c = this.current; if (v.r === c.r && v.g === c.g && v.b === c.b && v.a === c.a && !this.dirty) return; this.gl.blendColor(v.r, v.g, v.b, v.a); this.current = v; this.dirty = false; } } class BlendEquation extends BaseValue { getDefault() { return this.gl.FUNC_ADD; } set(v) { if (v === this.current && !this.dirty) return; this.gl.blendEquation(v); this.current = v; this.dirty = false; } } class CullFace extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; if (v) { gl.enable(gl.CULL_FACE); } else { gl.disable(gl.CULL_FACE); } this.current = v; this.dirty = false; } } class CullFaceSide extends BaseValue { getDefault() { return this.gl.BACK; } set(v) { if (v === this.current && !this.dirty) return; this.gl.cullFace(v); this.current = v; this.dirty = false; } } class FrontFace extends BaseValue { getDefault() { return this.gl.CCW; } set(v) { if (v === this.current && !this.dirty) return; this.gl.frontFace(v); this.current = v; this.dirty = false; } } class ProgramValue extends BaseValue { getDefault() { return null; } set(v) { if (v === this.current && !this.dirty) return; this.gl.useProgram(v); this.current = v; this.dirty = false; } } class ActiveTextureUnit extends BaseValue { getDefault() { return this.gl.TEXTURE0; } set(v) { if (v === this.current && !this.dirty) return; this.gl.activeTexture(v); this.current = v; this.dirty = false; } } class Viewport extends BaseValue { getDefault() { const gl = this.gl; return [0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight]; } set(v) { const c = this.current; if (v[0] === c[0] && v[1] === c[1] && v[2] === c[2] && v[3] === c[3] && !this.dirty) return; this.gl.viewport(v[0], v[1], v[2], v[3]); this.current = v; this.dirty = false; } } class BindFramebuffer extends BaseValue { getDefault() { return null; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.bindFramebuffer(gl.FRAMEBUFFER, v); this.current = v; this.dirty = false; } } class BindRenderbuffer extends BaseValue { getDefault() { return null; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.bindRenderbuffer(gl.RENDERBUFFER, v); this.current = v; this.dirty = false; } } class BindTexture extends BaseValue { getDefault() { return null; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.bindTexture(gl.TEXTURE_2D, v); this.current = v; this.dirty = false; } } class BindVertexBuffer extends BaseValue { getDefault() { return null; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.bindBuffer(gl.ARRAY_BUFFER, v); this.current = v; this.dirty = false; } } class BindElementBuffer extends BaseValue { getDefault() { return null; } set(v) { // Always rebind const gl = this.gl; gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, v); this.current = v; this.dirty = false; } } class BindVertexArray extends BaseValue { getDefault() { return null; } set(v) { var _a; if (v === this.current && !this.dirty) return; const gl = this.gl; if (isWebGL2(gl)) { gl.bindVertexArray(v); } else { (_a = gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.bindVertexArrayOES(v); } this.current = v; this.dirty = false; } } class PixelStoreUnpack extends BaseValue { getDefault() { return 4; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.pixelStorei(gl.UNPACK_ALIGNMENT, v); this.current = v; this.dirty = false; } } class PixelStoreUnpackPremultiplyAlpha extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, v); this.current = v; this.dirty = false; } } class PixelStoreUnpackFlipY extends BaseValue { getDefault() { return false; } set(v) { if (v === this.current && !this.dirty) return; const gl = this.gl; gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, v); this.current = v; this.dirty = false; } } class FramebufferAttachment extends BaseValue { constructor(context, parent) { super(context); this.context = context; this.parent = parent; } getDefault() { return null; } } class ColorAttachment extends FramebufferAttachment { setDirty() { this.dirty = true; } set(v) { if (v === this.current && !this.dirty) return; this.context.bindFramebuffer.set(this.parent); // note: it's possible to attach a renderbuffer to the color // attachment point, but thus far MBGL only uses textures for color const gl = this.gl; gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, v, 0); this.current = v; this.dirty = false; } } class DepthAttachment extends FramebufferAttachment { set(v) { if (v === this.current && !this.dirty) return; this.context.bindFramebuffer.set(this.parent); // note: it's possible to attach a texture to the depth attachment // point, but thus far MBGL only uses renderbuffers for depth const gl = this.gl; gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.RENDERBUFFER, v); this.current = v; this.dirty = false; } } class DepthStencilAttachment extends FramebufferAttachment { set(v) { if (v === this.current && !this.dirty) return; this.context.bindFramebuffer.set(this.parent); // note: it's possible to attach a texture to the depth attachment // point, but thus far MBGL only uses renderbuffers for depth const gl = this.gl; gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_STENCIL_ATTACHMENT, gl.RENDERBUFFER, v); this.current = v; this.dirty = false; } } /** * @internal * A framebuffer holder object */ class Framebuffer { constructor(context, width, height, hasDepth, hasStencil) { this.context = context; this.width = width; this.height = height; const gl = context.gl; const fbo = this.framebuffer = gl.createFramebuffer(); this.colorAttachment = new ColorAttachment(context, fbo); if (hasDepth) { this.depthAttachment = hasStencil ? new DepthStencilAttachment(context, fbo) : new DepthAttachment(context, fbo); } else if (hasStencil) { throw new Error('Stencil cannot be set without depth'); } if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE) { throw new Error('Framebuffer is not complete'); } } destroy() { const gl = this.context.gl; const texture = this.colorAttachment.get(); if (texture) gl.deleteTexture(texture); if (this.depthAttachment) { const renderbuffer = this.depthAttachment.get(); if (renderbuffer) gl.deleteRenderbuffer(renderbuffer); } gl.deleteFramebuffer(this.framebuffer); } } const ZERO = 0x0000; const ONE = 0x0001; const ONE_MINUS_SRC_ALPHA = 0x0303; class ColorMode { constructor(blendFunction, blendColor, mask) { this.blendFunction = blendFunction; this.blendColor = blendColor; this.mask = mask; } } ColorMode.Replace = [ONE, ZERO]; ColorMode.disabled = new ColorMode(ColorMode.Replace, Color.transparent, [false, false, false, false]); ColorMode.unblended = new ColorMode(ColorMode.Replace, Color.transparent, [true, true, true, true]); ColorMode.alphaBlended = new ColorMode([ONE, ONE_MINUS_SRC_ALPHA], Color.transparent, [true, true, true, true]); /** * @internal * A webgl wrapper class to allow injection, mocking and abstaction */ class Context { constructor(gl) { var _a, _b; this.gl = gl; this.clearColor = new ClearColor(this); this.clearDepth = new ClearDepth(this); this.clearStencil = new ClearStencil(this); this.colorMask = new ColorMask(this); this.depthMask = new DepthMask(this); this.stencilMask = new StencilMask(this); this.stencilFunc = new StencilFunc(this); this.stencilOp = new StencilOp(this); this.stencilTest = new StencilTest(this); this.depthRange = new DepthRange(this); this.depthTest = new DepthTest(this); this.depthFunc = new DepthFunc(this); this.blend = new Blend(this); this.blendFunc = new BlendFunc(this); this.blendColor = new BlendColor(this); this.blendEquation = new BlendEquation(this); this.cullFace = new CullFace(this); this.cullFaceSide = new CullFaceSide(this); this.frontFace = new FrontFace(this); this.program = new ProgramValue(this); this.activeTexture = new ActiveTextureUnit(this); this.viewport = new Viewport(this); this.bindFramebuffer = new BindFramebuffer(this); this.bindRenderbuffer = new BindRenderbuffer(this); this.bindTexture = new BindTexture(this); this.bindVertexBuffer = new BindVertexBuffer(this); this.bindElementBuffer = new BindElementBuffer(this); this.bindVertexArray = new BindVertexArray(this); this.pixelStoreUnpack = new PixelStoreUnpack(this); this.pixelStoreUnpackPremultiplyAlpha = new PixelStoreUnpackPremultiplyAlpha(this); this.pixelStoreUnpackFlipY = new PixelStoreUnpackFlipY(this); this.extTextureFilterAnisotropic = (gl.getExtension('EXT_texture_filter_anisotropic') || gl.getExtension('MOZ_EXT_texture_filter_anisotropic') || gl.getExtension('WEBKIT_EXT_texture_filter_anisotropic')); if (this.extTextureFilterAnisotropic) { this.extTextureFilterAnisotropicMax = gl.getParameter(this.extTextureFilterAnisotropic.MAX_TEXTURE_MAX_ANISOTROPY_EXT); } this.maxTextureSize = gl.getParameter(gl.MAX_TEXTURE_SIZE); if (isWebGL2(gl)) { this.HALF_FLOAT = gl.HALF_FLOAT; const extColorBufferHalfFloat = gl.getExtension('EXT_color_buffer_half_float'); this.RGBA16F = (_a = gl.RGBA16F) !== null && _a !== void 0 ? _a : extColorBufferHalfFloat === null || extColorBufferHalfFloat === void 0 ? void 0 : extColorBufferHalfFloat.RGBA16F_EXT; this.RGB16F = (_b = gl.RGB16F) !== null && _b !== void 0 ? _b : extColorBufferHalfFloat === null || extColorBufferHalfFloat === void 0 ? void 0 : extColorBufferHalfFloat.RGB16F_EXT; gl.getExtension('EXT_color_buffer_float'); } else { gl.getExtension('EXT_color_buffer_half_float'); gl.getExtension('OES_texture_half_float_linear'); const extTextureHalfFloat = gl.getExtension('OES_texture_half_float'); this.HALF_FLOAT = extTextureHalfFloat === null || extTextureHalfFloat === void 0 ? void 0 : extTextureHalfFloat.HALF_FLOAT_OES; } } setDefault() { this.unbindVAO(); this.clearColor.setDefault(); this.clearDepth.setDefault(); this.clearStencil.setDefault(); this.colorMask.setDefault(); this.depthMask.setDefault(); this.stencilMask.setDefault(); this.stencilFunc.setDefault(); this.stencilOp.setDefault(); this.stencilTest.setDefault(); this.depthRange.setDefault(); this.depthTest.setDefault(); this.depthFunc.setDefault(); this.blend.setDefault(); this.blendFunc.setDefault(); this.blendColor.setDefault(); this.blendEquation.setDefault(); this.cullFace.setDefault(); this.cullFaceSide.setDefault(); this.frontFace.setDefault(); this.program.setDefault(); this.activeTexture.setDefault(); this.bindFramebuffer.setDefault(); this.pixelStoreUnpack.setDefault(); this.pixelStoreUnpackPremultiplyAlpha.setDefault(); this.pixelStoreUnpackFlipY.setDefault(); } setDirty() { this.clearColor.dirty = true; this.clearDepth.dirty = true; this.clearStencil.dirty = true; this.colorMask.dirty = true; this.depthMask.dirty = true; this.stencilMask.dirty = true; this.stencilFunc.dirty = true; this.stencilOp.dirty = true; this.stencilTest.dirty = true; this.depthRange.dirty = true; this.depthTest.dirty = true; this.depthFunc.dirty = true; this.blend.dirty = true; this.blendFunc.dirty = true; this.blendColor.dirty = true; this.blendEquation.dirty = true; this.cullFace.dirty = true; this.cullFaceSide.dirty = true; this.frontFace.dirty = true; this.program.dirty = true; this.activeTexture.dirty = true; this.viewport.dirty = true; this.bindFramebuffer.dirty = true; this.bindRenderbuffer.dirty = true; this.bindTexture.dirty = true; this.bindVertexBuffer.dirty = true; this.bindElementBuffer.dirty = true; this.bindVertexArray.dirty = true; this.pixelStoreUnpack.dirty = true; this.pixelStoreUnpackPremultiplyAlpha.dirty = true; this.pixelStoreUnpackFlipY.dirty = true; } createIndexBuffer(array, dynamicDraw) { return new IndexBuffer(this, array, dynamicDraw); } createVertexBuffer(array, attributes, dynamicDraw) { return new VertexBuffer(this, array, attributes, dynamicDraw); } createRenderbuffer(storageFormat, width, height) { const gl = this.gl; const rbo = gl.createRenderbuffer(); this.bindRenderbuffer.set(rbo); gl.renderbufferStorage(gl.RENDERBUFFER, storageFormat, width, height); this.bindRenderbuffer.set(null); return rbo; } createFramebuffer(width, height, hasDepth, hasStencil) { return new Framebuffer(this, width, height, hasDepth, hasStencil); } clear({ color, depth, stencil }) { const gl = this.gl; let mask = 0; if (color) { mask |= gl.COLOR_BUFFER_BIT; this.clearColor.set(color); this.colorMask.set([true, true, true, true]); } if (typeof depth !== 'undefined') { mask |= gl.DEPTH_BUFFER_BIT; // Workaround for platforms where clearDepth doesn't seem to work // without resetting the depthRange. See https://github.com/mapbox/mapbox-gl-js/issues/3437 this.depthRange.set([0, 1]); this.clearDepth.set(depth); this.depthMask.set(true); } if (typeof stencil !== 'undefined') { mask |= gl.STENCIL_BUFFER_BIT; this.clearStencil.set(stencil); this.stencilMask.set(0xFF); } gl.clear(mask); } setCullFace(cullFaceMode) { if (cullFaceMode.enable === false) { this.cullFace.set(false); } else { this.cullFace.set(true); this.cullFaceSide.set(cullFaceMode.mode); this.frontFace.set(cullFaceMode.frontFace); } } setDepthMode(depthMode) { if (depthMode.func === this.gl.ALWAYS && !depthMode.mask) { this.depthTest.set(false); } else { this.depthTest.set(true); this.depthFunc.set(depthMode.func); this.depthMask.set(depthMode.mask); this.depthRange.set(depthMode.range); } } setStencilMode(stencilMode) { if (stencilMode.test.func === this.gl.ALWAYS && !stencilMode.mask) { this.stencilTest.set(false); } else { this.stencilTest.set(true); this.stencilMask.set(stencilMode.mask); this.stencilOp.set([stencilMode.fail, stencilMode.depthFail, stencilMode.pass]); this.stencilFunc.set({ func: stencilMode.test.func, ref: stencilMode.ref, mask: stencilMode.test.mask }); } } setColorMode(colorMode) { if (deepEqual$1(colorMode.blendFunction, ColorMode.Replace)) { this.blend.set(false); } else { this.blend.set(true); this.blendFunc.set(colorMode.blendFunction); this.blendColor.set(colorMode.blendColor); } this.colorMask.set(colorMode.mask); } createVertexArray() { var _a; if (isWebGL2(this.gl)) return this.gl.createVertexArray(); return (_a = this.gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.createVertexArrayOES(); } deleteVertexArray(x) { var _a; if (isWebGL2(this.gl)) return this.gl.deleteVertexArray(x); return (_a = this.gl.getExtension('OES_vertex_array_object')) === null || _a === void 0 ? void 0 : _a.deleteVertexArrayOES(x); } unbindVAO() { // Unbinding the VAO prevents other things (custom layers, new buffer creation) from // unintentionally changing the state of the last VAO used. this.bindVertexArray.set(null); } } const ALWAYS$1 = 0x0207; class DepthMode { constructor(depthFunc, depthMask, depthRange) { this.func = depthFunc; this.mask = depthMask; this.range = depthRange; } } DepthMode.ReadOnly = false; DepthMode.ReadWrite = true; DepthMode.disabled = new DepthMode(ALWAYS$1, DepthMode.ReadOnly, [0, 1]); const ALWAYS = 0x0207; const KEEP = 0x1E00; class StencilMode { constructor(test, ref, mask, fail, depthFail, pass) { this.test = test; this.ref = ref; this.mask = mask; this.fail = fail; this.depthFail = depthFail; this.pass = pass; } } StencilMode.disabled = new StencilMode({ func: ALWAYS, mask: 0 }, 0, 0, KEEP, KEEP, KEEP); const BACK = 0x0405; const CCW = 0x0901; class CullFaceMode { constructor(enable, mode, frontFace) { this.enable = enable; this.mode = mode; this.frontFace = frontFace; } } CullFaceMode.disabled = new CullFaceMode(false, BACK, CCW); CullFaceMode.backCCW = new CullFaceMode(true, BACK, CCW); let quadTriangles; function drawCollisionDebug(painter, sourceCache, layer, coords, isText) { const context = painter.context; const gl = context.gl; const program = painter.useProgram('collisionBox'); const tileBatches = []; let circleCount = 0; let circleOffset = 0; for (let i = 0; i < coords.length; i++) { const coord = coords[i]; const tile = sourceCache.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket) continue; const buffers = isText ? bucket.textCollisionBox : bucket.iconCollisionBox; // Get collision circle data of this bucket const circleArray = bucket.collisionCircleArray; if (circleArray.length > 0) { // We need to know the projection matrix that was used for projecting collision circles to the screen. // This might vary between buckets as the symbol placement is a continuous process. This matrix is // required for transforming points from previous screen space to the current one const invTransform = create$6(); mul$5(invTransform, bucket.placementInvProjMatrix, painter.transform.glCoordMatrix); mul$5(invTransform, invTransform, bucket.placementViewportMatrix); tileBatches.push({ circleArray, circleOffset, transform: coord.posMatrix, // Ignore translation invTransform, coord }); circleCount += circleArray.length / 4; // 4 values per circle circleOffset = circleCount; } // Draw collision boxes if (!buffers) { continue; } program.draw(context, gl.LINES, DepthMode.disabled, StencilMode.disabled, painter.colorModeForRenderPass(), CullFaceMode.disabled, collisionUniformValues(painter.transform, coord.posMatrix), painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord), layer.id, buffers.layoutVertexBuffer, buffers.indexBuffer, buffers.segments, null, painter.transform.zoom, null, null, buffers.collisionVertexBuffer); } if (!isText || !tileBatches.length) { return; } // Render collision circles const circleProgram = painter.useProgram('collisionCircle'); // Construct vertex data const vertexData = new CollisionCircleLayoutArray(); vertexData.resize(circleCount * 4); vertexData._trim(); let vertexOffset = 0; for (const batch of tileBatches) { for (let i = 0; i < batch.circleArray.length / 4; i++) { const circleIdx = i * 4; const x = batch.circleArray[circleIdx + 0]; const y = batch.circleArray[circleIdx + 1]; const radius = batch.circleArray[circleIdx + 2]; const collision = batch.circleArray[circleIdx + 3]; // 4 floats per vertex, 4 vertices per quad vertexData.emplace(vertexOffset++, x, y, radius, collision, 0); vertexData.emplace(vertexOffset++, x, y, radius, collision, 1); vertexData.emplace(vertexOffset++, x, y, radius, collision, 2); vertexData.emplace(vertexOffset++, x, y, radius, collision, 3); } } if (!quadTriangles || quadTriangles.length < circleCount * 2) { quadTriangles = createQuadTriangles(circleCount); } const indexBuffer = context.createIndexBuffer(quadTriangles, true); const vertexBuffer = context.createVertexBuffer(vertexData, collisionCircleLayout.members, true); // Render batches for (const batch of tileBatches) { const uniforms = collisionCircleUniformValues(batch.transform, batch.invTransform, painter.transform); circleProgram.draw(context, gl.TRIANGLES, DepthMode.disabled, StencilMode.disabled, painter.colorModeForRenderPass(), CullFaceMode.disabled, uniforms, painter.style.map.terrain && painter.style.map.terrain.getTerrainData(batch.coord), layer.id, vertexBuffer, indexBuffer, SegmentVector.simpleSegment(0, batch.circleOffset * 2, batch.circleArray.length, batch.circleArray.length / 2), null, painter.transform.zoom, null, null, null); } vertexBuffer.destroy(); indexBuffer.destroy(); } function createQuadTriangles(quadCount) { const triCount = quadCount * 2; const array = new QuadTriangleArray(); array.resize(triCount); array._trim(); // Two triangles and 4 vertices per quad. for (let i = 0; i < triCount; i++) { const idx = i * 6; array.uint16[idx + 0] = i * 4 + 0; array.uint16[idx + 1] = i * 4 + 1; array.uint16[idx + 2] = i * 4 + 2; array.uint16[idx + 3] = i * 4 + 2; array.uint16[idx + 4] = i * 4 + 3; array.uint16[idx + 5] = i * 4 + 0; } return array; } const identityMat4 = identity$2(new Float32Array(16)); function drawSymbols(painter, sourceCache, layer, coords, variableOffsets) { if (painter.renderPass !== 'translucent') return; // Disable the stencil test so that labels aren't clipped to tile boundaries. const stencilMode = StencilMode.disabled; const colorMode = painter.colorModeForRenderPass(); const hasVariablePlacement = layer._unevaluatedLayout.hasValue('text-variable-anchor') || layer._unevaluatedLayout.hasValue('text-variable-anchor-offset'); //Compute variable-offsets before painting since icons and text data positioning //depend on each other in this case. if (hasVariablePlacement) { updateVariableAnchors(coords, painter, layer, sourceCache, layer.layout.get('text-rotation-alignment'), layer.layout.get('text-pitch-alignment'), layer.paint.get('text-translate'), layer.paint.get('text-translate-anchor'), variableOffsets); } if (layer.paint.get('icon-opacity').constantOr(1) !== 0) { drawLayerSymbols(painter, sourceCache, layer, coords, false, layer.paint.get('icon-translate'), layer.paint.get('icon-translate-anchor'), layer.layout.get('icon-rotation-alignment'), layer.layout.get('icon-pitch-alignment'), layer.layout.get('icon-keep-upright'), stencilMode, colorMode); } if (layer.paint.get('text-opacity').constantOr(1) !== 0) { drawLayerSymbols(painter, sourceCache, layer, coords, true, layer.paint.get('text-translate'), layer.paint.get('text-translate-anchor'), layer.layout.get('text-rotation-alignment'), layer.layout.get('text-pitch-alignment'), layer.layout.get('text-keep-upright'), stencilMode, colorMode); } if (sourceCache.map.showCollisionBoxes) { drawCollisionDebug(painter, sourceCache, layer, coords, true); drawCollisionDebug(painter, sourceCache, layer, coords, false); } } function calculateVariableRenderShift(anchor, width, height, textOffset, textBoxScale, renderTextSize) { const { horizontalAlign, verticalAlign } = getAnchorAlignment(anchor); const shiftX = -(horizontalAlign - 0.5) * width; const shiftY = -(verticalAlign - 0.5) * height; return new Point$2((shiftX / textBoxScale + textOffset[0]) * renderTextSize, (shiftY / textBoxScale + textOffset[1]) * renderTextSize); } function updateVariableAnchors(coords, painter, layer, sourceCache, rotationAlignment, pitchAlignment, translate, translateAnchor, variableOffsets) { const transform = painter.transform; const projection = createProjection(); const rotateWithMap = rotationAlignment === 'map'; const pitchWithMap = pitchAlignment === 'map'; for (const coord of coords) { const tile = sourceCache.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket || !bucket.text || !bucket.text.segments.get().length) continue; const sizeData = bucket.textSizeData; const size = evaluateSizeForZoom(sizeData, transform.zoom); const pixelToTileScale = pixelsToTileUnits(tile, 1, painter.transform.zoom); const labelPlaneMatrix = getLabelPlaneMatrix(coord.posMatrix, pitchWithMap, rotateWithMap, painter.transform, pixelToTileScale); const updateTextFitIcon = layer.layout.get('icon-text-fit') !== 'none' && bucket.hasIconData(); if (size) { const tileScale = Math.pow(2, transform.zoom - tile.tileID.overscaledZ); const getElevation = painter.style.map.terrain ? (x, y) => painter.style.map.terrain.getElevation(coord, x, y) : null; const translation = projection.translatePosition(transform, tile, translate, translateAnchor); updateVariableAnchorsForBucket(bucket, rotateWithMap, pitchWithMap, variableOffsets, transform, labelPlaneMatrix, coord.posMatrix, tileScale, size, updateTextFitIcon, projection, translation, coord.toUnwrapped(), getElevation); } } } function getShiftedAnchor(projectedAnchorPoint, projectionContext, rotateWithMap, shift, transformAngle, pitchedTextShiftCorrection) { // Usual case is that we take the projected anchor and add the pixel-based shift // calculated earlier. In the (somewhat weird) case of pitch-aligned text, we add an equivalent // tile-unit based shift to the anchor before projecting to the label plane. const translatedAnchor = projectionContext.tileAnchorPoint.add(new Point$2(projectionContext.translation[0], projectionContext.translation[1])); if (projectionContext.pitchWithMap) { let adjustedShift = shift.mult(pitchedTextShiftCorrection); if (!rotateWithMap) { adjustedShift = adjustedShift.rotate(-transformAngle); } const tileAnchorShifted = translatedAnchor.add(adjustedShift); return project(tileAnchorShifted.x, tileAnchorShifted.y, projectionContext.labelPlaneMatrix, projectionContext.getElevation).point; } else { if (rotateWithMap) { // Compute the angle with which to rotate the anchor, so that it is aligned with // the map's actual east-west axis. Very similar to what is done in the shader. const projectedAnchorRight = projectTileCoordinatesToViewport(projectionContext.tileAnchorPoint.x + 1, projectionContext.tileAnchorPoint.y, projectionContext); const east = projectedAnchorRight.point.sub(projectedAnchorPoint); const angle = Math.atan(east.y / east.x) + (east.x < 0 ? Math.PI : 0); return projectedAnchorPoint.add(shift.rotate(angle)); } else { return projectedAnchorPoint.add(shift); } } } function updateVariableAnchorsForBucket(bucket, rotateWithMap, pitchWithMap, variableOffsets, transform, labelPlaneMatrix, posMatrix, tileScale, size, updateTextFitIcon, projection, translation, unwrappedTileID, getElevation) { const placedSymbols = bucket.text.placedSymbolArray; const dynamicTextLayoutVertexArray = bucket.text.dynamicLayoutVertexArray; const dynamicIconLayoutVertexArray = bucket.icon.dynamicLayoutVertexArray; const placedTextShifts = {}; dynamicTextLayoutVertexArray.clear(); for (let s = 0; s < placedSymbols.length; s++) { const symbol = placedSymbols.get(s); const skipOrientation = bucket.allowVerticalPlacement && !symbol.placedOrientation; const variableOffset = (!symbol.hidden && symbol.crossTileID && !skipOrientation) ? variableOffsets[symbol.crossTileID] : null; if (!variableOffset) { // These symbols are from a justification that is not being used, or a label that wasn't placed // so we don't need to do the extra math to figure out what incremental shift to apply. hideGlyphs(symbol.numGlyphs, dynamicTextLayoutVertexArray); } else { const tileAnchor = new Point$2(symbol.anchorX, symbol.anchorY); const projectionContext = { getElevation, width: transform.width, height: transform.height, labelPlaneMatrix, lineVertexArray: null, pitchWithMap, projection, projectionCache: null, tileAnchorPoint: tileAnchor, translation, unwrappedTileID }; const projectedAnchor = pitchWithMap ? project(tileAnchor.x, tileAnchor.y, posMatrix, getElevation) : projectTileCoordinatesToViewport(tileAnchor.x, tileAnchor.y, projectionContext); const perspectiveRatio = getPerspectiveRatio(transform.cameraToCenterDistance, projectedAnchor.signedDistanceFromCamera); let renderTextSize = evaluateSizeForFeature(bucket.textSizeData, size, symbol) * perspectiveRatio / ONE_EM; if (pitchWithMap) { // Go from size in pixels to equivalent size in tile units renderTextSize *= bucket.tilePixelRatio / tileScale; } const { width, height, anchor, textOffset, textBoxScale } = variableOffset; const shift = calculateVariableRenderShift(anchor, width, height, textOffset, textBoxScale, renderTextSize); const pitchedTextCorrection = projection.getPitchedTextCorrection(transform, tileAnchor.add(new Point$2(translation[0], translation[1])), unwrappedTileID); const shiftedAnchor = getShiftedAnchor(projectedAnchor.point, projectionContext, rotateWithMap, shift, transform.angle, pitchedTextCorrection); const angle = (bucket.allowVerticalPlacement && symbol.placedOrientation === WritingMode.vertical) ? Math.PI / 2 : 0; for (let g = 0; g < symbol.numGlyphs; g++) { addDynamicAttributes(dynamicTextLayoutVertexArray, shiftedAnchor, angle); } //Only offset horizontal text icons if (updateTextFitIcon && symbol.associatedIconIndex >= 0) { placedTextShifts[symbol.associatedIconIndex] = { shiftedAnchor, angle }; } } } if (updateTextFitIcon) { dynamicIconLayoutVertexArray.clear(); const placedIcons = bucket.icon.placedSymbolArray; for (let i = 0; i < placedIcons.length; i++) { const placedIcon = placedIcons.get(i); if (placedIcon.hidden) { hideGlyphs(placedIcon.numGlyphs, dynamicIconLayoutVertexArray); } else { const shift = placedTextShifts[i]; if (!shift) { hideGlyphs(placedIcon.numGlyphs, dynamicIconLayoutVertexArray); } else { for (let g = 0; g < placedIcon.numGlyphs; g++) { addDynamicAttributes(dynamicIconLayoutVertexArray, shift.shiftedAnchor, shift.angle); } } } } bucket.icon.dynamicLayoutVertexBuffer.updateData(dynamicIconLayoutVertexArray); } bucket.text.dynamicLayoutVertexBuffer.updateData(dynamicTextLayoutVertexArray); } function getSymbolProgramName(isSDF, isText, bucket) { if (bucket.iconsInText && isText) { return 'symbolTextAndIcon'; } else if (isSDF) { return 'symbolSDF'; } else { return 'symbolIcon'; } } function drawLayerSymbols(painter, sourceCache, layer, coords, isText, translate, translateAnchor, rotationAlignment, pitchAlignment, keepUpright, stencilMode, colorMode) { const context = painter.context; const gl = context.gl; const tr = painter.transform; const projection = createProjection(); const rotateWithMap = rotationAlignment === 'map'; const pitchWithMap = pitchAlignment === 'map'; const alongLine = rotationAlignment !== 'viewport' && layer.layout.get('symbol-placement') !== 'point'; // Line label rotation happens in `updateLineLabels` // Pitched point labels are automatically rotated by the labelPlaneMatrix projection // Unpitched point labels need to have their rotation applied after projection const rotateInShader = rotateWithMap && !pitchWithMap && !alongLine; const isViewportLine = !pitchWithMap && alongLine; const hasSortKey = !layer.layout.get('symbol-sort-key').isConstant(); let sortFeaturesByKey = false; const depthMode = painter.depthModeForSublayer(0, DepthMode.ReadOnly); const hasVariablePlacement = layer._unevaluatedLayout.hasValue('text-variable-anchor') || layer._unevaluatedLayout.hasValue('text-variable-anchor-offset'); const tileRenderState = []; const pitchedTextRescaling = projection.getCircleRadiusCorrection(tr); for (const coord of coords) { const tile = sourceCache.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket) continue; const buffers = isText ? bucket.text : bucket.icon; if (!buffers || !buffers.segments.get().length || !buffers.hasVisibleVertices) continue; const programConfiguration = buffers.programConfigurations.get(layer.id); const isSDF = isText || bucket.sdfIcons; const sizeData = isText ? bucket.textSizeData : bucket.iconSizeData; const transformed = pitchWithMap || tr.pitch !== 0; const program = painter.useProgram(getSymbolProgramName(isSDF, isText, bucket), programConfiguration); const size = evaluateSizeForZoom(sizeData, tr.zoom); const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); let texSize; let texSizeIcon = [0, 0]; let atlasTexture; let atlasInterpolation; let atlasTextureIcon = null; let atlasInterpolationIcon; if (isText) { atlasTexture = tile.glyphAtlasTexture; atlasInterpolation = gl.LINEAR; texSize = tile.glyphAtlasTexture.size; if (bucket.iconsInText) { texSizeIcon = tile.imageAtlasTexture.size; atlasTextureIcon = tile.imageAtlasTexture; const zoomDependentSize = sizeData.kind === 'composite' || sizeData.kind === 'camera'; atlasInterpolationIcon = transformed || painter.options.rotating || painter.options.zooming || zoomDependentSize ? gl.LINEAR : gl.NEAREST; } } else { const iconScaled = layer.layout.get('icon-size').constantOr(0) !== 1 || bucket.iconsNeedLinear; atlasTexture = tile.imageAtlasTexture; atlasInterpolation = isSDF || painter.options.rotating || painter.options.zooming || iconScaled || transformed ? gl.LINEAR : gl.NEAREST; texSize = tile.imageAtlasTexture.size; } const s = pixelsToTileUnits(tile, 1, painter.transform.zoom); const baseMatrix = isViewportLine ? coord.posMatrix : identityMat4; const labelPlaneMatrix = getLabelPlaneMatrix(baseMatrix, pitchWithMap, rotateWithMap, painter.transform, s); const glCoordMatrixForShader = getGlCoordMatrix(baseMatrix, pitchWithMap, rotateWithMap, painter.transform, s); const glCoordMatrixForSymbolPlacement = getGlCoordMatrix(coord.posMatrix, pitchWithMap, rotateWithMap, painter.transform, s); const translation = projection.translatePosition(painter.transform, tile, translate, translateAnchor); const hasVariableAnchors = hasVariablePlacement && bucket.hasTextData(); const updateTextFitIcon = layer.layout.get('icon-text-fit') !== 'none' && hasVariableAnchors && bucket.hasIconData(); if (alongLine) { const getElevation = painter.style.map.terrain ? (x, y) => painter.style.map.terrain.getElevation(coord, x, y) : null; const rotateToLine = layer.layout.get('text-rotation-alignment') === 'map'; updateLineLabels(bucket, coord.posMatrix, painter, isText, labelPlaneMatrix, glCoordMatrixForSymbolPlacement, pitchWithMap, keepUpright, rotateToLine, projection, coord.toUnwrapped(), tr.width, tr.height, translation, getElevation); } const matrix = coord.posMatrix; // formerly also incorporated translate and translate-anchor const shaderVariableAnchor = (isText && hasVariablePlacement) || updateTextFitIcon; const noLabelPlane = (alongLine || shaderVariableAnchor); const uLabelPlaneMatrix = noLabelPlane ? identityMat4 : labelPlaneMatrix; const uglCoordMatrix = glCoordMatrixForShader; // formerly also incorporated translate and translate-anchor const hasHalo = isSDF && layer.paint.get(isText ? 'text-halo-width' : 'icon-halo-width').constantOr(1) !== 0; let uniformValues; if (isSDF) { if (!bucket.iconsInText) { uniformValues = symbolSDFUniformValues(sizeData.kind, size, rotateInShader, pitchWithMap, alongLine, shaderVariableAnchor, painter, matrix, uLabelPlaneMatrix, uglCoordMatrix, translation, isText, texSize, true, pitchedTextRescaling); } else { uniformValues = symbolTextAndIconUniformValues(sizeData.kind, size, rotateInShader, pitchWithMap, alongLine, shaderVariableAnchor, painter, matrix, uLabelPlaneMatrix, uglCoordMatrix, translation, texSize, texSizeIcon, pitchedTextRescaling); } } else { uniformValues = symbolIconUniformValues(sizeData.kind, size, rotateInShader, pitchWithMap, alongLine, shaderVariableAnchor, painter, matrix, uLabelPlaneMatrix, uglCoordMatrix, translation, isText, texSize, pitchedTextRescaling); } const state = { program, buffers, uniformValues, atlasTexture, atlasTextureIcon, atlasInterpolation, atlasInterpolationIcon, isSDF, hasHalo }; if (hasSortKey && bucket.canOverlap) { sortFeaturesByKey = true; const oldSegments = buffers.segments.get(); for (const segment of oldSegments) { tileRenderState.push({ segments: new SegmentVector([segment]), sortKey: segment.sortKey, state, terrainData }); } } else { tileRenderState.push({ segments: buffers.segments, sortKey: 0, state, terrainData }); } } if (sortFeaturesByKey) { tileRenderState.sort((a, b) => a.sortKey - b.sortKey); } for (const segmentState of tileRenderState) { const state = segmentState.state; context.activeTexture.set(gl.TEXTURE0); state.atlasTexture.bind(state.atlasInterpolation, gl.CLAMP_TO_EDGE); if (state.atlasTextureIcon) { context.activeTexture.set(gl.TEXTURE1); if (state.atlasTextureIcon) { state.atlasTextureIcon.bind(state.atlasInterpolationIcon, gl.CLAMP_TO_EDGE); } } if (state.isSDF) { const uniformValues = state.uniformValues; if (state.hasHalo) { uniformValues['u_is_halo'] = 1; drawSymbolElements(state.buffers, segmentState.segments, layer, painter, state.program, depthMode, stencilMode, colorMode, uniformValues, segmentState.terrainData); } uniformValues['u_is_halo'] = 0; } drawSymbolElements(state.buffers, segmentState.segments, layer, painter, state.program, depthMode, stencilMode, colorMode, state.uniformValues, segmentState.terrainData); } } function drawSymbolElements(buffers, segments, layer, painter, program, depthMode, stencilMode, colorMode, uniformValues, terrainData) { const context = painter.context; const gl = context.gl; program.draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, buffers.layoutVertexBuffer, buffers.indexBuffer, segments, layer.paint, painter.transform.zoom, buffers.programConfigurations.get(layer.id), buffers.dynamicLayoutVertexBuffer, buffers.opacityVertexBuffer); } function drawCircles(painter, sourceCache, layer, coords) { if (painter.renderPass !== 'translucent') return; const opacity = layer.paint.get('circle-opacity'); const strokeWidth = layer.paint.get('circle-stroke-width'); const strokeOpacity = layer.paint.get('circle-stroke-opacity'); const sortFeaturesByKey = !layer.layout.get('circle-sort-key').isConstant(); if (opacity.constantOr(1) === 0 && (strokeWidth.constantOr(1) === 0 || strokeOpacity.constantOr(1) === 0)) { return; } const context = painter.context; const gl = context.gl; const depthMode = painter.depthModeForSublayer(0, DepthMode.ReadOnly); // Turn off stencil testing to allow circles to be drawn across boundaries, // so that large circles are not clipped to tiles const stencilMode = StencilMode.disabled; const colorMode = painter.colorModeForRenderPass(); const segmentsRenderStates = []; for (let i = 0; i < coords.length; i++) { const coord = coords[i]; const tile = sourceCache.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket) continue; const programConfiguration = bucket.programConfigurations.get(layer.id); const program = painter.useProgram('circle', programConfiguration); const layoutVertexBuffer = bucket.layoutVertexBuffer; const indexBuffer = bucket.indexBuffer; const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); const uniformValues = circleUniformValues(painter, coord, tile, layer); const state = { programConfiguration, program, layoutVertexBuffer, indexBuffer, uniformValues, terrainData }; if (sortFeaturesByKey) { const oldSegments = bucket.segments.get(); for (const segment of oldSegments) { segmentsRenderStates.push({ segments: new SegmentVector([segment]), sortKey: segment.sortKey, state }); } } else { segmentsRenderStates.push({ segments: bucket.segments, sortKey: 0, state }); } } if (sortFeaturesByKey) { segmentsRenderStates.sort((a, b) => a.sortKey - b.sortKey); } for (const segmentsState of segmentsRenderStates) { const { programConfiguration, program, layoutVertexBuffer, indexBuffer, uniformValues, terrainData } = segmentsState.state; const segments = segmentsState.segments; program.draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, layoutVertexBuffer, indexBuffer, segments, layer.paint, painter.transform.zoom, programConfiguration); } } function drawHeatmap(painter, sourceCache, layer, tileIDs) { if (layer.paint.get('heatmap-opacity') === 0) { return; } const context = painter.context; if (painter.style.map.terrain) { for (const coord of tileIDs) { const tile = sourceCache.getTile(coord); // Skip tiles that have uncovered parents to avoid flickering; we don't need // to use complex tile masking here because the change between zoom levels is subtle, // so it's fine to simply render the parent until all its 4 children are loaded if (sourceCache.hasRenderableParent(coord)) continue; if (painter.renderPass === 'offscreen') { prepareHeatmapTerrain(painter, tile, layer, coord); } else if (painter.renderPass === 'translucent') { renderHeatmapTerrain(painter, layer, coord); } } context.viewport.set([0, 0, painter.width, painter.height]); } else { if (painter.renderPass === 'offscreen') { prepareHeatmapFlat(painter, sourceCache, layer, tileIDs); } else if (painter.renderPass === 'translucent') { renderHeatmapFlat(painter, layer); } } } function prepareHeatmapFlat(painter, sourceCache, layer, coords) { const context = painter.context; const gl = context.gl; // Allow kernels to be drawn across boundaries, so that // large kernels are not clipped to tiles const stencilMode = StencilMode.disabled; // Turn on additive blending for kernels, which is a key aspect of kernel density estimation formula const colorMode = new ColorMode([gl.ONE, gl.ONE], Color.transparent, [true, true, true, true]); bindFramebuffer(context, painter, layer); context.clear({ color: Color.transparent }); for (let i = 0; i < coords.length; i++) { const coord = coords[i]; // Skip tiles that have uncovered parents to avoid flickering; we don't need // to use complex tile masking here because the change between zoom levels is subtle, // so it's fine to simply render the parent until all its 4 children are loaded if (sourceCache.hasRenderableParent(coord)) continue; const tile = sourceCache.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket) continue; const programConfiguration = bucket.programConfigurations.get(layer.id); const program = painter.useProgram('heatmap', programConfiguration); const { zoom } = painter.transform; program.draw(context, gl.TRIANGLES, DepthMode.disabled, stencilMode, colorMode, CullFaceMode.disabled, heatmapUniformValues(coord.posMatrix, tile, zoom, layer.paint.get('heatmap-intensity')), null, layer.id, bucket.layoutVertexBuffer, bucket.indexBuffer, bucket.segments, layer.paint, painter.transform.zoom, programConfiguration); } context.viewport.set([0, 0, painter.width, painter.height]); } function renderHeatmapFlat(painter, layer) { const context = painter.context; const gl = context.gl; context.setColorMode(painter.colorModeForRenderPass()); // Here we bind two different textures from which we'll sample in drawing // heatmaps: the kernel texture, prepared in the offscreen pass, and a // color ramp texture. const fbo = layer.heatmapFbos.get(HEATMAP_FULL_RENDER_FBO_KEY); if (!fbo) return; context.activeTexture.set(gl.TEXTURE0); gl.bindTexture(gl.TEXTURE_2D, fbo.colorAttachment.get()); context.activeTexture.set(gl.TEXTURE1); const colorRampTexture = getColorRampTexture(context, layer); colorRampTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); painter.useProgram('heatmapTexture').draw(context, gl.TRIANGLES, DepthMode.disabled, StencilMode.disabled, painter.colorModeForRenderPass(), CullFaceMode.disabled, heatmapTextureUniformValues(painter, layer, 0, 1), null, layer.id, painter.viewportBuffer, painter.quadTriangleIndexBuffer, painter.viewportSegments, layer.paint, painter.transform.zoom); } function prepareHeatmapTerrain(painter, tile, layer, coord) { const context = painter.context; const gl = context.gl; const stencilMode = StencilMode.disabled; // Turn on additive blending for kernels, which is a key aspect of kernel density estimation formula const colorMode = new ColorMode([gl.ONE, gl.ONE], Color.transparent, [true, true, true, true]); const bucket = tile.getBucket(layer); if (!bucket) return; const tileKey = coord.key; let fbo = layer.heatmapFbos.get(tileKey); if (!fbo) { fbo = createHeatmapFbo(context, tile.tileSize, tile.tileSize); layer.heatmapFbos.set(tileKey, fbo); } context.bindFramebuffer.set(fbo.framebuffer); context.viewport.set([0, 0, tile.tileSize, tile.tileSize]); context.clear({ color: Color.transparent }); const programConfiguration = bucket.programConfigurations.get(layer.id); const program = painter.useProgram('heatmap', programConfiguration); const terrainData = painter.style.map.terrain.getTerrainData(coord); program.draw(context, gl.TRIANGLES, DepthMode.disabled, stencilMode, colorMode, CullFaceMode.disabled, heatmapUniformValues(coord.posMatrix, tile, painter.transform.zoom, layer.paint.get('heatmap-intensity')), terrainData, layer.id, bucket.layoutVertexBuffer, bucket.indexBuffer, bucket.segments, layer.paint, painter.transform.zoom, programConfiguration); } function renderHeatmapTerrain(painter, layer, coord) { const context = painter.context; const gl = context.gl; context.setColorMode(painter.colorModeForRenderPass()); const colorRampTexture = getColorRampTexture(context, layer); // Here we bind two different textures from which we'll sample in drawing // heatmaps: the kernel texture, prepared in the offscreen pass, and a // color ramp texture. const tileKey = coord.key; const fbo = layer.heatmapFbos.get(tileKey); if (!fbo) return; context.activeTexture.set(gl.TEXTURE0); gl.bindTexture(gl.TEXTURE_2D, fbo.colorAttachment.get()); context.activeTexture.set(gl.TEXTURE1); colorRampTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); painter.useProgram('heatmapTexture').draw(context, gl.TRIANGLES, DepthMode.disabled, StencilMode.disabled, painter.colorModeForRenderPass(), CullFaceMode.disabled, heatmapTextureUniformValues(painter, layer, 0, 1), null, layer.id, painter.rasterBoundsBuffer, painter.quadTriangleIndexBuffer, painter.rasterBoundsSegments, layer.paint, painter.transform.zoom); // destroy the FBO after rendering fbo.destroy(); layer.heatmapFbos.delete(tileKey); } function bindFramebuffer(context, painter, layer) { const gl = context.gl; context.activeTexture.set(gl.TEXTURE1); // Use a 4x downscaled screen texture for better performance context.viewport.set([0, 0, painter.width / 4, painter.height / 4]); let fbo = layer.heatmapFbos.get(HEATMAP_FULL_RENDER_FBO_KEY); if (!fbo) { fbo = createHeatmapFbo(context, painter.width / 4, painter.height / 4); layer.heatmapFbos.set(HEATMAP_FULL_RENDER_FBO_KEY, fbo); } else { gl.bindTexture(gl.TEXTURE_2D, fbo.colorAttachment.get()); context.bindFramebuffer.set(fbo.framebuffer); } } function createHeatmapFbo(context, width, height) { var _a, _b; const gl = context.gl; const texture = gl.createTexture(); gl.bindTexture(gl.TEXTURE_2D, texture); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR); gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR); // Use the higher precision half-float texture where available (producing much smoother looking heatmaps); // Otherwise, fall back to a low precision texture const numType = (_a = context.HALF_FLOAT) !== null && _a !== void 0 ? _a : gl.UNSIGNED_BYTE; const internalFormat = (_b = context.RGBA16F) !== null && _b !== void 0 ? _b : gl.RGBA; gl.texImage2D(gl.TEXTURE_2D, 0, internalFormat, width, height, 0, gl.RGBA, numType, null); const fbo = context.createFramebuffer(width, height, false, false); fbo.colorAttachment.set(texture); return fbo; } function getColorRampTexture(context, layer) { if (!layer.colorRampTexture) { layer.colorRampTexture = new Texture(context, layer.colorRamp, context.gl.RGBA); } return layer.colorRampTexture; } function drawLine(painter, sourceCache, layer, coords) { if (painter.renderPass !== 'translucent') return; const opacity = layer.paint.get('line-opacity'); const width = layer.paint.get('line-width'); if (opacity.constantOr(1) === 0 || width.constantOr(1) === 0) return; const depthMode = painter.depthModeForSublayer(0, DepthMode.ReadOnly); const colorMode = painter.colorModeForRenderPass(); const dasharray = layer.paint.get('line-dasharray'); const patternProperty = layer.paint.get('line-pattern'); const image = patternProperty.constantOr(1); const gradient = layer.paint.get('line-gradient'); const crossfade = layer.getCrossfadeParameters(); const programId = image ? 'linePattern' : dasharray ? 'lineSDF' : gradient ? 'lineGradient' : 'line'; const context = painter.context; const gl = context.gl; let firstTile = true; for (const coord of coords) { const tile = sourceCache.getTile(coord); if (image && !tile.patternsLoaded()) continue; const bucket = tile.getBucket(layer); if (!bucket) continue; const programConfiguration = bucket.programConfigurations.get(layer.id); const prevProgram = painter.context.program.get(); const program = painter.useProgram(programId, programConfiguration); const programChanged = firstTile || program.program !== prevProgram; const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); const constantPattern = patternProperty.constantOr(null); if (constantPattern && tile.imageAtlas) { const atlas = tile.imageAtlas; const posTo = atlas.patternPositions[constantPattern.to.toString()]; const posFrom = atlas.patternPositions[constantPattern.from.toString()]; if (posTo && posFrom) programConfiguration.setConstantPatternPositions(posTo, posFrom); } const terrainCoord = terrainData ? coord : null; const uniformValues = image ? linePatternUniformValues(painter, tile, layer, crossfade, terrainCoord) : dasharray ? lineSDFUniformValues(painter, tile, layer, dasharray, crossfade, terrainCoord) : gradient ? lineGradientUniformValues(painter, tile, layer, bucket.lineClipsArray.length, terrainCoord) : lineUniformValues(painter, tile, layer, terrainCoord); if (image) { context.activeTexture.set(gl.TEXTURE0); tile.imageAtlasTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); programConfiguration.updatePaintBuffers(crossfade); } else if (dasharray && (programChanged || painter.lineAtlas.dirty)) { context.activeTexture.set(gl.TEXTURE0); painter.lineAtlas.bind(context); } else if (gradient) { const layerGradient = bucket.gradients[layer.id]; let gradientTexture = layerGradient.texture; if (layer.gradientVersion !== layerGradient.version) { let textureResolution = 256; if (layer.stepInterpolant) { const sourceMaxZoom = sourceCache.getSource().maxzoom; const potentialOverzoom = coord.canonical.z === sourceMaxZoom ? Math.ceil(1 << (painter.transform.maxZoom - coord.canonical.z)) : 1; const lineLength = bucket.maxLineLength / EXTENT; // Logical pixel tile size is 512px, and 1024px right before current zoom + 1 const maxTilePixelSize = 1024; // Maximum possible texture coverage heuristic, bound by hardware max texture size const maxTextureCoverage = lineLength * maxTilePixelSize * potentialOverzoom; textureResolution = clamp$1(nextPowerOfTwo(maxTextureCoverage), 256, context.maxTextureSize); } layerGradient.gradient = renderColorRamp({ expression: layer.gradientExpression(), evaluationKey: 'lineProgress', resolution: textureResolution, image: layerGradient.gradient || undefined, clips: bucket.lineClipsArray }); if (layerGradient.texture) { layerGradient.texture.update(layerGradient.gradient); } else { layerGradient.texture = new Texture(context, layerGradient.gradient, gl.RGBA); } layerGradient.version = layer.gradientVersion; gradientTexture = layerGradient.texture; } context.activeTexture.set(gl.TEXTURE0); gradientTexture.bind(layer.stepInterpolant ? gl.NEAREST : gl.LINEAR, gl.CLAMP_TO_EDGE); } program.draw(context, gl.TRIANGLES, depthMode, painter.stencilModeForClipping(coord), colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, bucket.layoutVertexBuffer, bucket.indexBuffer, bucket.segments, layer.paint, painter.transform.zoom, programConfiguration, bucket.layoutVertexBuffer2); firstTile = false; // once refactored so that bound texture state is managed, we'll also be able to remove this firstTile/programChanged logic } } /** * A simple helper shared by draw_fill and draw_fill_extrusions to find the correct pattern positions AND update program. * For transitionable properties, especially 'fill-pattern' and 'fill-extrusion-pattern', while rendering certain frames * tile.imageAtlas has been updated by worker to hold the new pattern only, but rendering code is still looking for the previous image. * The mismatch was causing setConstantPatternPositions method not being called and pixelRatio was always the * default of 1, instead of actual values set by original map.addImage. * * @param programConfiguration - to be used to set pattern position and device pixel ratio. * @param propertyName - 'fill-pattern' or 'fill-extrusion-pattern' property key * @param constantPattern - either 'fill-pattern' or 'fill-extrusion-pattern' property value * @param tile - current tile being drawn * @param layer - current layer being rendered */ function updatePatternPositionsInProgram(programConfiguration, propertyName, constantPattern, tile, layer) { if (!constantPattern || !tile || !tile.imageAtlas) { return; } const patternPositions = tile.imageAtlas.patternPositions; let posTo = patternPositions[constantPattern.to.toString()]; let posFrom = patternPositions[constantPattern.from.toString()]; // https://github.com/maplibre/maplibre-gl-js/issues/3377 if (!posTo && posFrom) posTo = posFrom; if (!posFrom && posTo) posFrom = posTo; // try again in case patternPositions has been updated by worker if (!posTo || !posFrom) { const transitioned = layer.getPaintProperty(propertyName); posTo = patternPositions[transitioned]; posFrom = patternPositions[transitioned]; } if (posTo && posFrom) { programConfiguration.setConstantPatternPositions(posTo, posFrom); } } function drawFill(painter, sourceCache, layer, coords) { const color = layer.paint.get('fill-color'); const opacity = layer.paint.get('fill-opacity'); if (opacity.constantOr(1) === 0) { return; } const colorMode = painter.colorModeForRenderPass(); const pattern = layer.paint.get('fill-pattern'); const pass = painter.opaquePassEnabledForLayer() && (!pattern.constantOr(1) && color.constantOr(Color.transparent).a === 1 && opacity.constantOr(0) === 1) ? 'opaque' : 'translucent'; // Draw fill if (painter.renderPass === pass) { const depthMode = painter.depthModeForSublayer(1, painter.renderPass === 'opaque' ? DepthMode.ReadWrite : DepthMode.ReadOnly); drawFillTiles(painter, sourceCache, layer, coords, depthMode, colorMode, false); } // Draw stroke if (painter.renderPass === 'translucent' && layer.paint.get('fill-antialias')) { // If we defined a different color for the fill outline, we are // going to ignore the bits in 0x07 and just care about the global // clipping mask. // Otherwise, we only want to drawFill the antialiased parts that are // *outside* the current shape. This is important in case the fill // or stroke color is translucent. If we wouldn't clip to outside // the current shape, some pixels from the outline stroke overlapped // the (non-antialiased) fill. const depthMode = painter.depthModeForSublayer(layer.getPaintProperty('fill-outline-color') ? 2 : 0, DepthMode.ReadOnly); drawFillTiles(painter, sourceCache, layer, coords, depthMode, colorMode, true); } } function drawFillTiles(painter, sourceCache, layer, coords, depthMode, colorMode, isOutline) { const gl = painter.context.gl; const fillPropertyName = 'fill-pattern'; const patternProperty = layer.paint.get(fillPropertyName); const image = patternProperty && patternProperty.constantOr(1); const crossfade = layer.getCrossfadeParameters(); let drawMode, programName, uniformValues, indexBuffer, segments; if (!isOutline) { programName = image ? 'fillPattern' : 'fill'; drawMode = gl.TRIANGLES; } else { programName = image && !layer.getPaintProperty('fill-outline-color') ? 'fillOutlinePattern' : 'fillOutline'; drawMode = gl.LINES; } const constantPattern = patternProperty.constantOr(null); for (const coord of coords) { const tile = sourceCache.getTile(coord); if (image && !tile.patternsLoaded()) continue; const bucket = tile.getBucket(layer); if (!bucket) continue; const programConfiguration = bucket.programConfigurations.get(layer.id); const program = painter.useProgram(programName, programConfiguration); const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); if (image) { painter.context.activeTexture.set(gl.TEXTURE0); tile.imageAtlasTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); programConfiguration.updatePaintBuffers(crossfade); } updatePatternPositionsInProgram(programConfiguration, fillPropertyName, constantPattern, tile, layer); const terrainCoord = terrainData ? coord : null; const posMatrix = terrainCoord ? terrainCoord.posMatrix : coord.posMatrix; const tileMatrix = painter.translatePosMatrix(posMatrix, tile, layer.paint.get('fill-translate'), layer.paint.get('fill-translate-anchor')); if (!isOutline) { indexBuffer = bucket.indexBuffer; segments = bucket.segments; uniformValues = image ? fillPatternUniformValues(tileMatrix, painter, crossfade, tile) : fillUniformValues(tileMatrix); } else { indexBuffer = bucket.indexBuffer2; segments = bucket.segments2; const drawingBufferSize = [gl.drawingBufferWidth, gl.drawingBufferHeight]; uniformValues = (programName === 'fillOutlinePattern' && image) ? fillOutlinePatternUniformValues(tileMatrix, painter, crossfade, tile, drawingBufferSize) : fillOutlineUniformValues(tileMatrix, drawingBufferSize); } program.draw(painter.context, drawMode, depthMode, painter.stencilModeForClipping(coord), colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, bucket.layoutVertexBuffer, indexBuffer, segments, layer.paint, painter.transform.zoom, programConfiguration); } } function drawFillExtrusion(painter, source, layer, coords) { const opacity = layer.paint.get('fill-extrusion-opacity'); if (opacity === 0) { return; } if (painter.renderPass === 'translucent') { const depthMode = new DepthMode(painter.context.gl.LEQUAL, DepthMode.ReadWrite, painter.depthRangeFor3D); if (opacity === 1 && !layer.paint.get('fill-extrusion-pattern').constantOr(1)) { const colorMode = painter.colorModeForRenderPass(); drawExtrusionTiles(painter, source, layer, coords, depthMode, StencilMode.disabled, colorMode); } else { // Draw transparent buildings in two passes so that only the closest surface is drawn. // First draw all the extrusions into only the depth buffer. No colors are drawn. drawExtrusionTiles(painter, source, layer, coords, depthMode, StencilMode.disabled, ColorMode.disabled); // Then draw all the extrusions a second type, only coloring fragments if they have the // same depth value as the closest fragment in the previous pass. Use the stencil buffer // to prevent the second draw in cases where we have coincident polygons. drawExtrusionTiles(painter, source, layer, coords, depthMode, painter.stencilModeFor3D(), painter.colorModeForRenderPass()); } } } function drawExtrusionTiles(painter, source, layer, coords, depthMode, stencilMode, colorMode) { const context = painter.context; const gl = context.gl; const fillPropertyName = 'fill-extrusion-pattern'; const patternProperty = layer.paint.get(fillPropertyName); const image = patternProperty.constantOr(1); const crossfade = layer.getCrossfadeParameters(); const opacity = layer.paint.get('fill-extrusion-opacity'); const constantPattern = patternProperty.constantOr(null); for (const coord of coords) { const tile = source.getTile(coord); const bucket = tile.getBucket(layer); if (!bucket) continue; const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); const programConfiguration = bucket.programConfigurations.get(layer.id); const program = painter.useProgram(image ? 'fillExtrusionPattern' : 'fillExtrusion', programConfiguration); if (image) { painter.context.activeTexture.set(gl.TEXTURE0); tile.imageAtlasTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); programConfiguration.updatePaintBuffers(crossfade); } updatePatternPositionsInProgram(programConfiguration, fillPropertyName, constantPattern, tile, layer); const matrix = painter.translatePosMatrix(coord.posMatrix, tile, layer.paint.get('fill-extrusion-translate'), layer.paint.get('fill-extrusion-translate-anchor')); const shouldUseVerticalGradient = layer.paint.get('fill-extrusion-vertical-gradient'); const uniformValues = image ? fillExtrusionPatternUniformValues(matrix, painter, shouldUseVerticalGradient, opacity, coord, crossfade, tile) : fillExtrusionUniformValues(matrix, painter, shouldUseVerticalGradient, opacity); program.draw(context, context.gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.backCCW, uniformValues, terrainData, layer.id, bucket.layoutVertexBuffer, bucket.indexBuffer, bucket.segments, layer.paint, painter.transform.zoom, programConfiguration, painter.style.map.terrain && bucket.centroidVertexBuffer); } } function drawHillshade(painter, sourceCache, layer, tileIDs) { if (painter.renderPass !== 'offscreen' && painter.renderPass !== 'translucent') return; const context = painter.context; const depthMode = painter.depthModeForSublayer(0, DepthMode.ReadOnly); const colorMode = painter.colorModeForRenderPass(); const [stencilModes, coords] = painter.renderPass === 'translucent' ? painter.stencilConfigForOverlap(tileIDs) : [{}, tileIDs]; for (const coord of coords) { const tile = sourceCache.getTile(coord); if (typeof tile.needsHillshadePrepare !== 'undefined' && tile.needsHillshadePrepare && painter.renderPass === 'offscreen') { prepareHillshade(painter, tile, layer, depthMode, StencilMode.disabled, colorMode); } else if (painter.renderPass === 'translucent') { renderHillshade(painter, coord, tile, layer, depthMode, stencilModes[coord.overscaledZ], colorMode); } } context.viewport.set([0, 0, painter.width, painter.height]); } function renderHillshade(painter, coord, tile, layer, depthMode, stencilMode, colorMode) { const context = painter.context; const gl = context.gl; const fbo = tile.fbo; if (!fbo) return; const program = painter.useProgram('hillshade'); const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); context.activeTexture.set(gl.TEXTURE0); gl.bindTexture(gl.TEXTURE_2D, fbo.colorAttachment.get()); const terrainCoord = terrainData ? coord : null; program.draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, hillshadeUniformValues(painter, tile, layer, terrainCoord), terrainData, layer.id, painter.rasterBoundsBuffer, painter.quadTriangleIndexBuffer, painter.rasterBoundsSegments); } // hillshade rendering is done in two steps. the prepare step first calculates the slope of the terrain in the x and y // directions for each pixel, and saves those values to a framebuffer texture in the r and g channels. function prepareHillshade(painter, tile, layer, depthMode, stencilMode, colorMode) { const context = painter.context; const gl = context.gl; const dem = tile.dem; if (dem && dem.data) { const tileSize = dem.dim; const textureStride = dem.stride; const pixelData = dem.getPixels(); context.activeTexture.set(gl.TEXTURE1); context.pixelStoreUnpackPremultiplyAlpha.set(false); tile.demTexture = tile.demTexture || painter.getTileTexture(textureStride); if (tile.demTexture) { const demTexture = tile.demTexture; demTexture.update(pixelData, { premultiply: false }); demTexture.bind(gl.NEAREST, gl.CLAMP_TO_EDGE); } else { tile.demTexture = new Texture(context, pixelData, gl.RGBA, { premultiply: false }); tile.demTexture.bind(gl.NEAREST, gl.CLAMP_TO_EDGE); } context.activeTexture.set(gl.TEXTURE0); let fbo = tile.fbo; if (!fbo) { const renderTexture = new Texture(context, { width: tileSize, height: tileSize, data: null }, gl.RGBA); renderTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); fbo = tile.fbo = context.createFramebuffer(tileSize, tileSize, true, false); fbo.colorAttachment.set(renderTexture.texture); } context.bindFramebuffer.set(fbo.framebuffer); context.viewport.set([0, 0, tileSize, tileSize]); painter.useProgram('hillshadePrepare').draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, hillshadeUniformPrepareValues(tile.tileID, dem), null, layer.id, painter.rasterBoundsBuffer, painter.quadTriangleIndexBuffer, painter.rasterBoundsSegments); tile.needsHillshadePrepare = false; } } function drawRaster(painter, sourceCache, layer, tileIDs) { if (painter.renderPass !== 'translucent') return; if (layer.paint.get('raster-opacity') === 0) return; if (!tileIDs.length) return; const context = painter.context; const gl = context.gl; const source = sourceCache.getSource(); const program = painter.useProgram('raster'); const colorMode = painter.colorModeForRenderPass(); const [stencilModes, coords] = source instanceof ImageSource ? [{}, tileIDs] : painter.stencilConfigForOverlap(tileIDs); const minTileZ = coords[coords.length - 1].overscaledZ; const align = !painter.options.moving; for (const coord of coords) { // Set the lower zoom level to sublayer 0, and higher zoom levels to higher sublayers // Use gl.LESS to prevent double drawing in areas where tiles overlap. const depthMode = painter.depthModeForSublayer(coord.overscaledZ - minTileZ, layer.paint.get('raster-opacity') === 1 ? DepthMode.ReadWrite : DepthMode.ReadOnly, gl.LESS); const tile = sourceCache.getTile(coord); tile.registerFadeDuration(layer.paint.get('raster-fade-duration')); const parentTile = sourceCache.findLoadedParent(coord, 0); const siblingTile = sourceCache.findLoadedSibling(coord); // Prefer parent tile if present const fadeTileReference = parentTile || siblingTile || null; const fade = getFadeValues(tile, fadeTileReference, sourceCache, layer, painter.transform, painter.style.map.terrain); let parentScaleBy, parentTL; const textureFilter = layer.paint.get('raster-resampling') === 'nearest' ? gl.NEAREST : gl.LINEAR; context.activeTexture.set(gl.TEXTURE0); tile.texture.bind(textureFilter, gl.CLAMP_TO_EDGE, gl.LINEAR_MIPMAP_NEAREST); context.activeTexture.set(gl.TEXTURE1); if (parentTile) { parentTile.texture.bind(textureFilter, gl.CLAMP_TO_EDGE, gl.LINEAR_MIPMAP_NEAREST); parentScaleBy = Math.pow(2, parentTile.tileID.overscaledZ - tile.tileID.overscaledZ); parentTL = [tile.tileID.canonical.x * parentScaleBy % 1, tile.tileID.canonical.y * parentScaleBy % 1]; } else { tile.texture.bind(textureFilter, gl.CLAMP_TO_EDGE, gl.LINEAR_MIPMAP_NEAREST); } // Enable anisotropic filtering only when the pitch is greater than 20 degrees // to preserve image sharpness on flat or slightly tilted maps. if (tile.texture.useMipmap && context.extTextureFilterAnisotropic && painter.transform.pitch > 20) { gl.texParameterf(gl.TEXTURE_2D, context.extTextureFilterAnisotropic.TEXTURE_MAX_ANISOTROPY_EXT, context.extTextureFilterAnisotropicMax); } const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); const terrainCoord = terrainData ? coord : null; const posMatrix = terrainCoord ? terrainCoord.posMatrix : painter.transform.calculatePosMatrix(coord.toUnwrapped(), align); const uniformValues = rasterUniformValues(posMatrix, parentTL || [0, 0], parentScaleBy || 1, fade, layer); if (source instanceof ImageSource) { program.draw(context, gl.TRIANGLES, depthMode, StencilMode.disabled, colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, source.boundsBuffer, painter.quadTriangleIndexBuffer, source.boundsSegments); } else { program.draw(context, gl.TRIANGLES, depthMode, stencilModes[coord.overscaledZ], colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, painter.rasterBoundsBuffer, painter.quadTriangleIndexBuffer, painter.rasterBoundsSegments); } } } function getFadeValues(tile, parentTile, sourceCache, layer, transform, terrain) { const fadeDuration = layer.paint.get('raster-fade-duration'); if (!terrain && fadeDuration > 0) { const now = browser.now(); const sinceTile = (now - tile.timeAdded) / fadeDuration; const sinceParent = parentTile ? (now - parentTile.timeAdded) / fadeDuration : -1; const source = sourceCache.getSource(); const idealZ = transform.coveringZoomLevel({ tileSize: source.tileSize, roundZoom: source.roundZoom }); // if no parent or parent is older, fade in; if parent is younger, fade out const fadeIn = !parentTile || Math.abs(parentTile.tileID.overscaledZ - idealZ) > Math.abs(tile.tileID.overscaledZ - idealZ); const childOpacity = (fadeIn && tile.refreshedUponExpiration) ? 1 : clamp$1(fadeIn ? sinceTile : 1 - sinceParent, 0, 1); // we don't crossfade tiles that were just refreshed upon expiring: // once they're old enough to pass the crossfading threshold // (fadeDuration), unset the `refreshedUponExpiration` flag so we don't // incorrectly fail to crossfade them when zooming if (tile.refreshedUponExpiration && sinceTile >= 1) tile.refreshedUponExpiration = false; if (parentTile) { return { opacity: 1, mix: 1 - childOpacity }; } else { return { opacity: childOpacity, mix: 0 }; } } else { return { opacity: 1, mix: 0 }; } } function drawBackground(painter, sourceCache, layer, coords) { const color = layer.paint.get('background-color'); const opacity = layer.paint.get('background-opacity'); if (opacity === 0) return; const context = painter.context; const gl = context.gl; const transform = painter.transform; const tileSize = transform.tileSize; const image = layer.paint.get('background-pattern'); if (painter.isPatternMissing(image)) return; const pass = (!image && color.a === 1 && opacity === 1 && painter.opaquePassEnabledForLayer()) ? 'opaque' : 'translucent'; if (painter.renderPass !== pass) return; const stencilMode = StencilMode.disabled; const depthMode = painter.depthModeForSublayer(0, pass === 'opaque' ? DepthMode.ReadWrite : DepthMode.ReadOnly); const colorMode = painter.colorModeForRenderPass(); const program = painter.useProgram(image ? 'backgroundPattern' : 'background'); const tileIDs = coords ? coords : transform.coveringTiles({ tileSize, terrain: painter.style.map.terrain }); if (image) { context.activeTexture.set(gl.TEXTURE0); painter.imageManager.bind(painter.context); } const crossfade = layer.getCrossfadeParameters(); for (const tileID of tileIDs) { const matrix = coords ? tileID.posMatrix : painter.transform.calculatePosMatrix(tileID.toUnwrapped()); const uniformValues = image ? backgroundPatternUniformValues(matrix, opacity, painter, image, { tileID, tileSize }, crossfade) : backgroundUniformValues(matrix, opacity, color); const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(tileID); program.draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, uniformValues, terrainData, layer.id, painter.tileExtentBuffer, painter.quadTriangleIndexBuffer, painter.tileExtentSegments); } } const topColor = new Color(1, 0, 0, 1); const btmColor = new Color(0, 1, 0, 1); const leftColor = new Color(0, 0, 1, 1); const rightColor = new Color(1, 0, 1, 1); const centerColor = new Color(0, 1, 1, 1); function drawDebugPadding(painter) { const padding = painter.transform.padding; const lineWidth = 3; // Top drawHorizontalLine(painter, painter.transform.height - (padding.top || 0), lineWidth, topColor); // Bottom drawHorizontalLine(painter, padding.bottom || 0, lineWidth, btmColor); // Left drawVerticalLine(painter, padding.left || 0, lineWidth, leftColor); // Right drawVerticalLine(painter, painter.transform.width - (padding.right || 0), lineWidth, rightColor); // Center const center = painter.transform.centerPoint; drawCrosshair(painter, center.x, painter.transform.height - center.y, centerColor); } function drawCrosshair(painter, x, y, color) { const size = 20; const lineWidth = 2; //Vertical line drawDebugSSRect(painter, x - lineWidth / 2, y - size / 2, lineWidth, size, color); //Horizontal line drawDebugSSRect(painter, x - size / 2, y - lineWidth / 2, size, lineWidth, color); } function drawHorizontalLine(painter, y, lineWidth, color) { drawDebugSSRect(painter, 0, y + lineWidth / 2, painter.transform.width, lineWidth, color); } function drawVerticalLine(painter, x, lineWidth, color) { drawDebugSSRect(painter, x - lineWidth / 2, 0, lineWidth, painter.transform.height, color); } function drawDebugSSRect(painter, x, y, width, height, color) { const context = painter.context; const gl = context.gl; gl.enable(gl.SCISSOR_TEST); gl.scissor(x * painter.pixelRatio, y * painter.pixelRatio, width * painter.pixelRatio, height * painter.pixelRatio); context.clear({ color }); gl.disable(gl.SCISSOR_TEST); } function drawDebug(painter, sourceCache, coords) { for (let i = 0; i < coords.length; i++) { drawDebugTile(painter, sourceCache, coords[i]); } } function drawDebugTile(painter, sourceCache, coord) { const context = painter.context; const gl = context.gl; const posMatrix = coord.posMatrix; const program = painter.useProgram('debug'); const depthMode = DepthMode.disabled; const stencilMode = StencilMode.disabled; const colorMode = painter.colorModeForRenderPass(); const id = '$debug'; const terrainData = painter.style.map.terrain && painter.style.map.terrain.getTerrainData(coord); context.activeTexture.set(gl.TEXTURE0); const tileRawData = sourceCache.getTileByID(coord.key).latestRawTileData; const tileByteLength = (tileRawData && tileRawData.byteLength) || 0; const tileSizeKb = Math.floor(tileByteLength / 1024); const tileSize = sourceCache.getTile(coord).tileSize; const scaleRatio = (512 / Math.min(tileSize, 512) * (coord.overscaledZ / painter.transform.zoom)) * 0.5; let tileIdText = coord.canonical.toString(); if (coord.overscaledZ !== coord.canonical.z) { tileIdText += ` => ${coord.overscaledZ}`; } const tileLabel = `${tileIdText} ${tileSizeKb}kB`; drawTextToOverlay(painter, tileLabel); program.draw(context, gl.TRIANGLES, depthMode, stencilMode, ColorMode.alphaBlended, CullFaceMode.disabled, debugUniformValues(posMatrix, Color.transparent, scaleRatio), null, id, painter.debugBuffer, painter.quadTriangleIndexBuffer, painter.debugSegments); program.draw(context, gl.LINE_STRIP, depthMode, stencilMode, colorMode, CullFaceMode.disabled, debugUniformValues(posMatrix, Color.red), terrainData, id, painter.debugBuffer, painter.tileBorderIndexBuffer, painter.debugSegments); } function drawTextToOverlay(painter, text) { painter.initDebugOverlayCanvas(); const canvas = painter.debugOverlayCanvas; const gl = painter.context.gl; const ctx2d = painter.debugOverlayCanvas.getContext('2d'); ctx2d.clearRect(0, 0, canvas.width, canvas.height); ctx2d.shadowColor = 'white'; ctx2d.shadowBlur = 2; ctx2d.lineWidth = 1.5; ctx2d.strokeStyle = 'white'; ctx2d.textBaseline = 'top'; ctx2d.font = `bold ${36}px Open Sans, sans-serif`; ctx2d.fillText(text, 5, 5); ctx2d.strokeText(text, 5, 5); painter.debugOverlayTexture.update(canvas); painter.debugOverlayTexture.bind(gl.LINEAR, gl.CLAMP_TO_EDGE); } function selectDebugSource(style, zoom) { // Use vector source with highest maxzoom // Else use source with highest maxzoom of any type let selectedSource = null; const layers = Object.values(style._layers); const sources = layers.flatMap((layer) => { if (layer.source && !layer.isHidden(zoom)) { const sourceCache = style.sourceCaches[layer.source]; return [sourceCache]; } else { return []; } }); const vectorSources = sources.filter((source) => source.getSource().type === 'vector'); const otherSources = sources.filter((source) => source.getSource().type !== 'vector'); const considerSource = (source) => { if (!selectedSource || (selectedSource.getSource().maxzoom < source.getSource().maxzoom)) { selectedSource = source; } }; vectorSources.forEach((source) => considerSource(source)); if (!selectedSource) { otherSources.forEach((source) => considerSource(source)); } return selectedSource; } function drawCustom(painter, sourceCache, layer) { const context = painter.context; const implementation = layer.implementation; if (painter.renderPass === 'offscreen') { const prerender = implementation.prerender; if (prerender) { painter.setCustomLayerDefaults(); context.setColorMode(painter.colorModeForRenderPass()); prerender.call(implementation, context.gl, painter.transform.customLayerMatrix()); context.setDirty(); painter.setBaseState(); } } else if (painter.renderPass === 'translucent') { painter.setCustomLayerDefaults(); context.setColorMode(painter.colorModeForRenderPass()); context.setStencilMode(StencilMode.disabled); const depthMode = implementation.renderingMode === '3d' ? new DepthMode(painter.context.gl.LEQUAL, DepthMode.ReadWrite, painter.depthRangeFor3D) : painter.depthModeForSublayer(0, DepthMode.ReadOnly); context.setDepthMode(depthMode); implementation.render(context.gl, painter.transform.customLayerMatrix(), { farZ: painter.transform.farZ, nearZ: painter.transform.nearZ, fov: painter.transform._fov, modelViewProjectionMatrix: painter.transform.modelViewProjectionMatrix, projectionMatrix: painter.transform.projectionMatrix }); context.setDirty(); painter.setBaseState(); context.bindFramebuffer.set(null); } } /** * Redraw the Depth Framebuffer * @param painter - the painter * @param terrain - the terrain */ function drawDepth(painter, terrain) { const context = painter.context; const gl = context.gl; const colorMode = ColorMode.unblended; const depthMode = new DepthMode(gl.LEQUAL, DepthMode.ReadWrite, [0, 1]); const mesh = terrain.getTerrainMesh(); const tiles = terrain.sourceCache.getRenderableTiles(); const program = painter.useProgram('terrainDepth'); context.bindFramebuffer.set(terrain.getFramebuffer('depth').framebuffer); context.viewport.set([0, 0, painter.width / devicePixelRatio, painter.height / devicePixelRatio]); context.clear({ color: Color.transparent, depth: 1 }); for (const tile of tiles) { const terrainData = terrain.getTerrainData(tile.tileID); const posMatrix = painter.transform.calculatePosMatrix(tile.tileID.toUnwrapped()); const uniformValues = terrainDepthUniformValues(posMatrix, terrain.getMeshFrameDelta(painter.transform.zoom)); program.draw(context, gl.TRIANGLES, depthMode, StencilMode.disabled, colorMode, CullFaceMode.backCCW, uniformValues, terrainData, 'terrain', mesh.vertexBuffer, mesh.indexBuffer, mesh.segments); } context.bindFramebuffer.set(null); context.viewport.set([0, 0, painter.width, painter.height]); } /** * Redraw the Coords Framebuffers * @param painter - the painter * @param terrain - the terrain */ function drawCoords(painter, terrain) { const context = painter.context; const gl = context.gl; const colorMode = ColorMode.unblended; const depthMode = new DepthMode(gl.LEQUAL, DepthMode.ReadWrite, [0, 1]); const mesh = terrain.getTerrainMesh(); const coords = terrain.getCoordsTexture(); const tiles = terrain.sourceCache.getRenderableTiles(); // draw tile-coords into framebuffer const program = painter.useProgram('terrainCoords'); context.bindFramebuffer.set(terrain.getFramebuffer('coords').framebuffer); context.viewport.set([0, 0, painter.width / devicePixelRatio, painter.height / devicePixelRatio]); context.clear({ color: Color.transparent, depth: 1 }); terrain.coordsIndex = []; for (const tile of tiles) { const terrainData = terrain.getTerrainData(tile.tileID); context.activeTexture.set(gl.TEXTURE0); gl.bindTexture(gl.TEXTURE_2D, coords.texture); const posMatrix = painter.transform.calculatePosMatrix(tile.tileID.toUnwrapped()); const uniformValues = terrainCoordsUniformValues(posMatrix, 255 - terrain.coordsIndex.length, terrain.getMeshFrameDelta(painter.transform.zoom)); program.draw(context, gl.TRIANGLES, depthMode, StencilMode.disabled, colorMode, CullFaceMode.backCCW, uniformValues, terrainData, 'terrain', mesh.vertexBuffer, mesh.indexBuffer, mesh.segments); terrain.coordsIndex.push(tile.tileID.key); } context.bindFramebuffer.set(null); context.viewport.set([0, 0, painter.width, painter.height]); } function drawTerrain(painter, terrain, tiles) { const context = painter.context; const gl = context.gl; const colorMode = painter.colorModeForRenderPass(); const depthMode = new DepthMode(gl.LEQUAL, DepthMode.ReadWrite, painter.depthRangeFor3D); const program = painter.useProgram('terrain'); const mesh = terrain.getTerrainMesh(); context.bindFramebuffer.set(null); context.viewport.set([0, 0, painter.width, painter.height]); for (const tile of tiles) { const texture = painter.renderToTexture.getTexture(tile); const terrainData = terrain.getTerrainData(tile.tileID); context.activeTexture.set(gl.TEXTURE0); gl.bindTexture(gl.TEXTURE_2D, texture.texture); const posMatrix = painter.transform.calculatePosMatrix(tile.tileID.toUnwrapped()); const eleDelta = terrain.getMeshFrameDelta(painter.transform.zoom); const fogMatrix = painter.transform.calculateFogMatrix(tile.tileID.toUnwrapped()); const uniformValues = terrainUniformValues(posMatrix, eleDelta, fogMatrix, painter.style.sky, painter.transform.pitch); program.draw(context, gl.TRIANGLES, depthMode, StencilMode.disabled, colorMode, CullFaceMode.backCCW, uniformValues, terrainData, 'terrain', mesh.vertexBuffer, mesh.indexBuffer, mesh.segments); } } class Mesh { constructor(vertexBuffer, indexBuffer, segments) { this.vertexBuffer = vertexBuffer; this.indexBuffer = indexBuffer; this.segments = segments; } destroy() { this.vertexBuffer.destroy(); this.indexBuffer.destroy(); this.segments.destroy(); this.vertexBuffer = null; this.indexBuffer = null; this.segments = null; } } function drawSky(painter, sky) { const context = painter.context; const gl = context.gl; const skyUniforms = skyUniformValues(sky, painter.style.map.transform, painter.pixelRatio); const depthMode = new DepthMode(gl.LEQUAL, DepthMode.ReadWrite, [0, 1]); const stencilMode = StencilMode.disabled; const colorMode = painter.colorModeForRenderPass(); const program = painter.useProgram('sky'); if (!sky.mesh) { const vertexArray = new PosArray(); vertexArray.emplaceBack(-1, -1); vertexArray.emplaceBack(1, -1); vertexArray.emplaceBack(1, 1); vertexArray.emplaceBack(-1, 1); const indexArray = new TriangleIndexArray(); indexArray.emplaceBack(0, 1, 2); indexArray.emplaceBack(0, 2, 3); sky.mesh = new Mesh(context.createVertexBuffer(vertexArray, posAttributes.members), context.createIndexBuffer(indexArray), SegmentVector.simpleSegment(0, 0, vertexArray.length, indexArray.length)); } program.draw(context, gl.TRIANGLES, depthMode, stencilMode, colorMode, CullFaceMode.disabled, skyUniforms, undefined, 'sky', sky.mesh.vertexBuffer, sky.mesh.indexBuffer, sky.mesh.segments); } /** * @internal * Initialize a new painter object. */ class Painter { constructor(gl, transform) { this.context = new Context(gl); this.transform = transform; this._tileTextures = {}; this.terrainFacilitator = { dirty: true, matrix: identity$2(new Float64Array(16)), renderTime: 0 }; this.setup(); // Within each layer there are multiple distinct z-planes that can be drawn to. // This is implemented using the WebGL depth buffer. this.numSublayers = SourceCache.maxUnderzooming + SourceCache.maxOverzooming + 1; this.depthEpsilon = 1 / Math.pow(2, 16); this.crossTileSymbolIndex = new CrossTileSymbolIndex(); } /* * Update the GL viewport, projection matrix, and transforms to compensate * for a new width and height value. */ resize(width, height, pixelRatio) { this.width = Math.floor(width * pixelRatio); this.height = Math.floor(height * pixelRatio); this.pixelRatio = pixelRatio; this.context.viewport.set([0, 0, this.width, this.height]); if (this.style) { for (const layerId of this.style._order) { this.style._layers[layerId].resize(); } } } setup() { const context = this.context; const tileExtentArray = new PosArray(); tileExtentArray.emplaceBack(0, 0); tileExtentArray.emplaceBack(EXTENT, 0); tileExtentArray.emplaceBack(0, EXTENT); tileExtentArray.emplaceBack(EXTENT, EXTENT); this.tileExtentBuffer = context.createVertexBuffer(tileExtentArray, posAttributes.members); this.tileExtentSegments = SegmentVector.simpleSegment(0, 0, 4, 2); const debugArray = new PosArray(); debugArray.emplaceBack(0, 0); debugArray.emplaceBack(EXTENT, 0); debugArray.emplaceBack(0, EXTENT); debugArray.emplaceBack(EXTENT, EXTENT); this.debugBuffer = context.createVertexBuffer(debugArray, posAttributes.members); this.debugSegments = SegmentVector.simpleSegment(0, 0, 4, 5); const rasterBoundsArray = new RasterBoundsArray(); rasterBoundsArray.emplaceBack(0, 0, 0, 0); rasterBoundsArray.emplaceBack(EXTENT, 0, EXTENT, 0); rasterBoundsArray.emplaceBack(0, EXTENT, 0, EXTENT); rasterBoundsArray.emplaceBack(EXTENT, EXTENT, EXTENT, EXTENT); this.rasterBoundsBuffer = context.createVertexBuffer(rasterBoundsArray, rasterBoundsAttributes.members); this.rasterBoundsSegments = SegmentVector.simpleSegment(0, 0, 4, 2); const viewportArray = new PosArray(); viewportArray.emplaceBack(0, 0); viewportArray.emplaceBack(1, 0); viewportArray.emplaceBack(0, 1); viewportArray.emplaceBack(1, 1); this.viewportBuffer = context.createVertexBuffer(viewportArray, posAttributes.members); this.viewportSegments = SegmentVector.simpleSegment(0, 0, 4, 2); const tileLineStripIndices = new LineStripIndexArray(); tileLineStripIndices.emplaceBack(0); tileLineStripIndices.emplaceBack(1); tileLineStripIndices.emplaceBack(3); tileLineStripIndices.emplaceBack(2); tileLineStripIndices.emplaceBack(0); this.tileBorderIndexBuffer = context.createIndexBuffer(tileLineStripIndices); const quadTriangleIndices = new TriangleIndexArray(); quadTriangleIndices.emplaceBack(0, 1, 2); quadTriangleIndices.emplaceBack(2, 1, 3); this.quadTriangleIndexBuffer = context.createIndexBuffer(quadTriangleIndices); const gl = this.context.gl; this.stencilClearMode = new StencilMode({ func: gl.ALWAYS, mask: 0 }, 0x0, 0xFF, gl.ZERO, gl.ZERO, gl.ZERO); } /* * Reset the drawing canvas by clearing the stencil buffer so that we can draw * new tiles at the same location, while retaining previously drawn pixels. */ clearStencil() { const context = this.context; const gl = context.gl; this.nextStencilID = 1; this.currentStencilSource = undefined; // As a temporary workaround for https://github.com/mapbox/mapbox-gl-js/issues/5490, // pending an upstream fix, we draw a fullscreen stencil=0 clipping mask here, // effectively clearing the stencil buffer: once an upstream patch lands, remove // this function in favor of context.clear({ stencil: 0x0 }) const matrix = create$6(); ortho(matrix, 0, this.width, this.height, 0, 0, 1); scale$5(matrix, matrix, [gl.drawingBufferWidth, gl.drawingBufferHeight, 0]); this.useProgram('clippingMask').draw(context, gl.TRIANGLES, DepthMode.disabled, this.stencilClearMode, ColorMode.disabled, CullFaceMode.disabled, clippingMaskUniformValues(matrix), null, '$clipping', this.viewportBuffer, this.quadTriangleIndexBuffer, this.viewportSegments); } _renderTileClippingMasks(layer, tileIDs) { if (this.currentStencilSource === layer.source || !layer.isTileClipped() || !tileIDs || !tileIDs.length) return; this.currentStencilSource = layer.source; const context = this.context; const gl = context.gl; if (this.nextStencilID + tileIDs.length > 256) { // we'll run out of fresh IDs so we need to clear and start from scratch this.clearStencil(); } context.setColorMode(ColorMode.disabled); context.setDepthMode(DepthMode.disabled); const program = this.useProgram('clippingMask'); this._tileClippingMaskIDs = {}; for (const tileID of tileIDs) { const id = this._tileClippingMaskIDs[tileID.key] = this.nextStencilID++; const terrainData = this.style.map.terrain && this.style.map.terrain.getTerrainData(tileID); program.draw(context, gl.TRIANGLES, DepthMode.disabled, // Tests will always pass, and ref value will be written to stencil buffer. new StencilMode({ func: gl.ALWAYS, mask: 0 }, id, 0xFF, gl.KEEP, gl.KEEP, gl.REPLACE), ColorMode.disabled, CullFaceMode.disabled, clippingMaskUniformValues(tileID.posMatrix), terrainData, '$clipping', this.tileExtentBuffer, this.quadTriangleIndexBuffer, this.tileExtentSegments); } } stencilModeFor3D() { this.currentStencilSource = undefined; if (this.nextStencilID + 1 > 256) { this.clearStencil(); } const id = this.nextStencilID++; const gl = this.context.gl; return new StencilMode({ func: gl.NOTEQUAL, mask: 0xFF }, id, 0xFF, gl.KEEP, gl.KEEP, gl.REPLACE); } stencilModeForClipping(tileID) { const gl = this.context.gl; return new StencilMode({ func: gl.EQUAL, mask: 0xFF }, this._tileClippingMaskIDs[tileID.key], 0x00, gl.KEEP, gl.KEEP, gl.REPLACE); } /* * Sort coordinates by Z as drawing tiles is done in Z-descending order. * All children with the same Z write the same stencil value. Children * stencil values are greater than parent's. This is used only for raster * and raster-dem tiles, which are already clipped to tile boundaries, to * mask area of tile overlapped by children tiles. * Stencil ref values continue range used in _tileClippingMaskIDs. * * Returns [StencilMode for tile overscaleZ map, sortedCoords]. */ stencilConfigForOverlap(tileIDs) { const gl = this.context.gl; const coords = tileIDs.sort((a, b) => b.overscaledZ - a.overscaledZ); const minTileZ = coords[coords.length - 1].overscaledZ; const stencilValues = coords[0].overscaledZ - minTileZ + 1; if (stencilValues > 1) { this.currentStencilSource = undefined; if (this.nextStencilID + stencilValues > 256) { this.clearStencil(); } const zToStencilMode = {}; for (let i = 0; i < stencilValues; i++) { zToStencilMode[i + minTileZ] = new StencilMode({ func: gl.GEQUAL, mask: 0xFF }, i + this.nextStencilID, 0xFF, gl.KEEP, gl.KEEP, gl.REPLACE); } this.nextStencilID += stencilValues; return [zToStencilMode, coords]; } return [{ [minTileZ]: StencilMode.disabled }, coords]; } colorModeForRenderPass() { const gl = this.context.gl; if (this._showOverdrawInspector) { const numOverdrawSteps = 8; const a = 1 / numOverdrawSteps; return new ColorMode([gl.CONSTANT_COLOR, gl.ONE], new Color(a, a, a, 0), [true, true, true, true]); } else if (this.renderPass === 'opaque') { return ColorMode.unblended; } else { return ColorMode.alphaBlended; } } depthModeForSublayer(n, mask, func) { if (!this.opaquePassEnabledForLayer()) return DepthMode.disabled; const depth = 1 - ((1 + this.currentLayer) * this.numSublayers + n) * this.depthEpsilon; return new DepthMode(func || this.context.gl.LEQUAL, mask, [depth, depth]); } /* * The opaque pass and 3D layers both use the depth buffer. * Layers drawn above 3D layers need to be drawn using the * painter's algorithm so that they appear above 3D features. * This returns true for layers that can be drawn using the * opaque pass. */ opaquePassEnabledForLayer() { return this.currentLayer < this.opaquePassCutoff; } render(style, options) { this.style = style; this.options = options; this.lineAtlas = style.lineAtlas; this.imageManager = style.imageManager; this.glyphManager = style.glyphManager; this.symbolFadeChange = style.placement.symbolFadeChange(browser.now()); this.imageManager.beginFrame(); const layerIds = this.style._order; const sourceCaches = this.style.sourceCaches; const coordsAscending = {}; const coordsDescending = {}; const coordsDescendingSymbol = {}; for (const id in sourceCaches) { const sourceCache = sourceCaches[id]; if (sourceCache.used) { sourceCache.prepare(this.context); } coordsAscending[id] = sourceCache.getVisibleCoordinates(); coordsDescending[id] = coordsAscending[id].slice().reverse(); coordsDescendingSymbol[id] = sourceCache.getVisibleCoordinates(true).reverse(); } this.opaquePassCutoff = Infinity; for (let i = 0; i < layerIds.length; i++) { const layerId = layerIds[i]; if (this.style._layers[layerId].is3D()) { this.opaquePassCutoff = i; break; } } this.maybeDrawDepthAndCoords(false); if (this.renderToTexture) { this.renderToTexture.prepareForRender(this.style, this.transform.zoom); // this is disabled, because render-to-texture is rendering all layers from bottom to top. this.opaquePassCutoff = 0; } // Offscreen pass =============================================== // We first do all rendering that requires rendering to a separate // framebuffer, and then save those for rendering back to the map // later: in doing this we avoid doing expensive framebuffer restores. this.renderPass = 'offscreen'; for (const layerId of layerIds) { const layer = this.style._layers[layerId]; if (!layer.hasOffscreenPass() || layer.isHidden(this.transform.zoom)) continue; const coords = coordsDescending[layer.source]; if (layer.type !== 'custom' && !coords.length) continue; this.renderLayer(this, sourceCaches[layer.source], layer, coords); } // Rebind the main framebuffer now that all offscreen layers have been rendered: this.context.bindFramebuffer.set(null); // Clear buffers in preparation for drawing to the main framebuffer this.context.clear({ color: options.showOverdrawInspector ? Color.black : Color.transparent, depth: 1 }); this.clearStencil(); // draw sky first to not overwrite symbols if (this.style.sky) drawSky(this, this.style.sky); this._showOverdrawInspector = options.showOverdrawInspector; this.depthRangeFor3D = [0, 1 - ((style._order.length + 2) * this.numSublayers * this.depthEpsilon)]; // Opaque pass =============================================== // Draw opaque layers top-to-bottom first. if (!this.renderToTexture) { this.renderPass = 'opaque'; for (this.currentLayer = layerIds.length - 1; this.currentLayer >= 0; this.currentLayer--) { const layer = this.style._layers[layerIds[this.currentLayer]]; const sourceCache = sourceCaches[layer.source]; const coords = coordsAscending[layer.source]; this._renderTileClippingMasks(layer, coords); this.renderLayer(this, sourceCache, layer, coords); } } // Translucent pass =============================================== // Draw all other layers bottom-to-top. this.renderPass = 'translucent'; for (this.currentLayer = 0; this.currentLayer < layerIds.length; this.currentLayer++) { const layer = this.style._layers[layerIds[this.currentLayer]]; const sourceCache = sourceCaches[layer.source]; if (this.renderToTexture && this.renderToTexture.renderLayer(layer)) continue; // For symbol layers in the translucent pass, we add extra tiles to the renderable set // for cross-tile symbol fading. Symbol layers don't use tile clipping, so no need to render // separate clipping masks const coords = (layer.type === 'symbol' ? coordsDescendingSymbol : coordsDescending)[layer.source]; this._renderTileClippingMasks(layer, coordsAscending[layer.source]); this.renderLayer(this, sourceCache, layer, coords); } if (this.options.showTileBoundaries) { const selectedSource = selectDebugSource(this.style, this.transform.zoom); if (selectedSource) { drawDebug(this, selectedSource, selectedSource.getVisibleCoordinates()); } } if (this.options.showPadding) { drawDebugPadding(this); } // Set defaults for most GL values so that anyone using the state after the render // encounters more expected values. this.context.setDefault(); } /** * Update the depth and coords framebuffers, if the contents of those frame buffers is out of date. * If requireExact is false, then the contents of those frame buffers is not updated if it is close * to accurate (that is, the camera has not moved much since it was updated last). */ maybeDrawDepthAndCoords(requireExact) { if (!this.style || !this.style.map || !this.style.map.terrain) { return; } const prevMatrix = this.terrainFacilitator.matrix; const currMatrix = this.transform.modelViewProjectionMatrix; // Update coords/depth-framebuffer on camera movement, or tile reloading let doUpdate = this.terrainFacilitator.dirty; doUpdate || (doUpdate = requireExact ? !exactEquals$5(prevMatrix, currMatrix) : !equals$6(prevMatrix, currMatrix)); doUpdate || (doUpdate = this.style.map.terrain.sourceCache.tilesAfterTime(this.terrainFacilitator.renderTime).length > 0); if (!doUpdate) { return; } copy$5(prevMatrix, currMatrix); this.terrainFacilitator.renderTime = Date.now(); this.terrainFacilitator.dirty = false; drawDepth(this, this.style.map.terrain); drawCoords(this, this.style.map.terrain); } renderLayer(painter, sourceCache, layer, coords) { if (layer.isHidden(this.transform.zoom)) return; if (layer.type !== 'background' && layer.type !== 'custom' && !(coords || []).length) return; this.id = layer.id; switch (layer.type) { case 'symbol': drawSymbols(painter, sourceCache, layer, coords, this.style.placement.variableOffsets); break; case 'circle': drawCircles(painter, sourceCache, layer, coords); break; case 'heatmap': drawHeatmap(painter, sourceCache, layer, coords); break; case 'line': drawLine(painter, sourceCache, layer, coords); break; case 'fill': drawFill(painter, sourceCache, layer, coords); break; case 'fill-extrusion': drawFillExtrusion(painter, sourceCache, layer, coords); break; case 'hillshade': drawHillshade(painter, sourceCache, layer, coords); break; case 'raster': drawRaster(painter, sourceCache, layer, coords); break; case 'background': drawBackground(painter, sourceCache, layer, coords); break; case 'custom': drawCustom(painter, sourceCache, layer); break; } } /** * Transform a matrix to incorporate the *-translate and *-translate-anchor properties into it. * @param inViewportPixelUnitsUnits - True when the units accepted by the matrix are in viewport pixels instead of tile units. * @returns matrix */ translatePosMatrix(matrix, tile, translate, translateAnchor, inViewportPixelUnitsUnits) { if (!translate[0] && !translate[1]) return matrix; const angle = inViewportPixelUnitsUnits ? (translateAnchor === 'map' ? this.transform.angle : 0) : (translateAnchor === 'viewport' ? -this.transform.angle : 0); if (angle) { const sinA = Math.sin(angle); const cosA = Math.cos(angle); translate = [ translate[0] * cosA - translate[1] * sinA, translate[0] * sinA + translate[1] * cosA ]; } const translation = [ inViewportPixelUnitsUnits ? translate[0] : pixelsToTileUnits(tile, translate[0], this.transform.zoom), inViewportPixelUnitsUnits ? translate[1] : pixelsToTileUnits(tile, translate[1], this.transform.zoom), 0 ]; const translatedMatrix = new Float32Array(16); translate$1(translatedMatrix, matrix, translation); return translatedMatrix; } saveTileTexture(texture) { const textures = this._tileTextures[texture.size[0]]; if (!textures) { this._tileTextures[texture.size[0]] = [texture]; } else { textures.push(texture); } } getTileTexture(size) { const textures = this._tileTextures[size]; return textures && textures.length > 0 ? textures.pop() : null; } /** * Checks whether a pattern image is needed, and if it is, whether it is not loaded. * * @returns true if a needed image is missing and rendering needs to be skipped. */ isPatternMissing(image) { if (!image) return false; if (!image.from || !image.to) return true; const imagePosA = this.imageManager.getPattern(image.from.toString()); const imagePosB = this.imageManager.getPattern(image.to.toString()); return !imagePosA || !imagePosB; } useProgram(name, programConfiguration) { this.cache = this.cache || {}; const key = name + (programConfiguration ? programConfiguration.cacheKey : '') + (this._showOverdrawInspector ? '/overdraw' : '') + (this.style.map.terrain ? '/terrain' : ''); if (!this.cache[key]) { this.cache[key] = new Program(this.context, shaders[name], programConfiguration, programUniforms[name], this._showOverdrawInspector, this.style.map.terrain); } return this.cache[key]; } /* * Reset some GL state to default values to avoid hard-to-debug bugs * in custom layers. */ setCustomLayerDefaults() { // Prevent custom layers from unintentionally modify the last VAO used. // All other state is state is restored on it's own, but for VAOs it's // simpler to unbind so that we don't have to track the state of VAOs. this.context.unbindVAO(); // The default values for this state is meaningful and often expected. // Leaving this state dirty could cause a lot of confusion for users. this.context.cullFace.setDefault(); this.context.activeTexture.setDefault(); this.context.pixelStoreUnpack.setDefault(); this.context.pixelStoreUnpackPremultiplyAlpha.setDefault(); this.context.pixelStoreUnpackFlipY.setDefault(); } /* * Set GL state that is shared by all layers. */ setBaseState() { const gl = this.context.gl; this.context.cullFace.set(false); this.context.viewport.set([0, 0, this.width, this.height]); this.context.blendEquation.set(gl.FUNC_ADD); } initDebugOverlayCanvas() { if (this.debugOverlayCanvas == null) { this.debugOverlayCanvas = document.createElement('canvas'); this.debugOverlayCanvas.width = 512; this.debugOverlayCanvas.height = 512; const gl = this.context.gl; this.debugOverlayTexture = new Texture(this.context, this.debugOverlayCanvas, gl.RGBA); } } destroy() { if (this.debugOverlayTexture) { this.debugOverlayTexture.destroy(); } } /* * Return true if drawing buffer size is != from requested size. * That means that we've reached GL limits somehow. * Note: drawing buffer size changes only when canvas size changes */ overLimit() { const { drawingBufferWidth, drawingBufferHeight } = this.context.gl; return this.width !== drawingBufferWidth || this.height !== drawingBufferHeight; } } class Frustum { constructor(points, planes) { this.points = points; this.planes = planes; } static fromInvProjectionMatrix(invProj, worldSize, zoom) { const clipSpaceCorners = [ [-1, 1, -1, 1], [1, 1, -1, 1], [1, -1, -1, 1], [-1, -1, -1, 1], [-1, 1, 1, 1], [1, 1, 1, 1], [1, -1, 1, 1], [-1, -1, 1, 1] ]; const scale = Math.pow(2, zoom); // Transform frustum corner points from clip space to tile space, Z to meters const frustumCoords = clipSpaceCorners.map(v => { v = transformMat4$1([], v, invProj); const s = 1.0 / v[3] / worldSize * scale; return mul$3(v, v, [s, s, 1.0 / v[3], s]); }); const frustumPlanePointIndices = [ [0, 1, 2], // near [6, 5, 4], // far [0, 3, 7], // left [2, 1, 5], // right [3, 2, 6], // bottom [0, 4, 5] // top ]; const frustumPlanes = frustumPlanePointIndices.map((p) => { const a = sub$2([], frustumCoords[p[0]], frustumCoords[p[1]]); const b = sub$2([], frustumCoords[p[2]], frustumCoords[p[1]]); const n = normalize$4([], cross$2([], a, b)); const d = -dot$5(n, frustumCoords[p[1]]); return n.concat(d); }); return new Frustum(frustumCoords, frustumPlanes); } } class Aabb { constructor(min_, max_) { this.min = min_; this.max = max_; this.center = scale$4([], add$4([], this.min, this.max), 0.5); } quadrant(index) { const split = [(index % 2) === 0, index < 2]; const qMin = clone$4(this.min); const qMax = clone$4(this.max); for (let axis = 0; axis < split.length; axis++) { qMin[axis] = split[axis] ? this.min[axis] : this.center[axis]; qMax[axis] = split[axis] ? this.center[axis] : this.max[axis]; } // Elevation is always constant, hence quadrant.max.z = this.max.z qMax[2] = this.max[2]; return new Aabb(qMin, qMax); } distanceX(point) { const pointOnAabb = Math.max(Math.min(this.max[0], point[0]), this.min[0]); return pointOnAabb - point[0]; } distanceY(point) { const pointOnAabb = Math.max(Math.min(this.max[1], point[1]), this.min[1]); return pointOnAabb - point[1]; } // Performs a frustum-aabb intersection test. Returns 0 if there's no intersection, // 1 if shapes are intersecting and 2 if the aabb if fully inside the frustum. intersects(frustum) { // Execute separating axis test between two convex objects to find intersections // Each frustum plane together with 3 major axes define the separating axes const aabbPoints = [ [this.min[0], this.min[1], this.min[2], 1], [this.max[0], this.min[1], this.min[2], 1], [this.max[0], this.max[1], this.min[2], 1], [this.min[0], this.max[1], this.min[2], 1], [this.min[0], this.min[1], this.max[2], 1], [this.max[0], this.min[1], this.max[2], 1], [this.max[0], this.max[1], this.max[2], 1], [this.min[0], this.max[1], this.max[2], 1] ]; let fullyInside = true; for (let p = 0; p < frustum.planes.length; p++) { const plane = frustum.planes[p]; let pointsInside = 0; for (let i = 0; i < aabbPoints.length; i++) { if (dot$4(plane, aabbPoints[i]) >= 0) { pointsInside++; } } if (pointsInside === 0) return 0; if (pointsInside !== aabbPoints.length) fullyInside = false; } if (fullyInside) return 2; for (let axis = 0; axis < 3; axis++) { let projMin = Number.MAX_VALUE; let projMax = -Number.MAX_VALUE; for (let p = 0; p < frustum.points.length; p++) { const projectedPoint = frustum.points[p][axis] - this.min[axis]; projMin = Math.min(projMin, projectedPoint); projMax = Math.max(projMax, projectedPoint); } if (projMax < 0 || projMin > this.max[axis] - this.min[axis]) return 0; } return 1; } } /** * An `EdgeInset` object represents screen space padding applied to the edges of the viewport. * This shifts the apprent center or the vanishing point of the map. This is useful for adding floating UI elements * on top of the map and having the vanishing point shift as UI elements resize. * * @group Geography and Geometry */ class EdgeInsets { constructor(top = 0, bottom = 0, left = 0, right = 0) { if (isNaN(top) || top < 0 || isNaN(bottom) || bottom < 0 || isNaN(left) || left < 0 || isNaN(right) || right < 0) { throw new Error('Invalid value for edge-insets, top, bottom, left and right must all be numbers'); } this.top = top; this.bottom = bottom; this.left = left; this.right = right; } /** * Interpolates the inset in-place. * This maintains the current inset value for any inset not present in `target`. * @param start - interpolation start * @param target - interpolation target * @param t - interpolation step/weight * @returns the insets */ interpolate(start, target, t) { if (target.top != null && start.top != null) this.top = interpolate.number(start.top, target.top, t); if (target.bottom != null && start.bottom != null) this.bottom = interpolate.number(start.bottom, target.bottom, t); if (target.left != null && start.left != null) this.left = interpolate.number(start.left, target.left, t); if (target.right != null && start.right != null) this.right = interpolate.number(start.right, target.right, t); return this; } /** * Utility method that computes the new apprent center or vanishing point after applying insets. * This is in pixels and with the top left being (0.0) and +y being downwards. * * @param width - the width * @param height - the height * @returns the point */ getCenter(width, height) { // Clamp insets so they never overflow width/height and always calculate a valid center const x = clamp$1((this.left + width - this.right) / 2, 0, width); const y = clamp$1((this.top + height - this.bottom) / 2, 0, height); return new Point$2(x, y); } equals(other) { return this.top === other.top && this.bottom === other.bottom && this.left === other.left && this.right === other.right; } clone() { return new EdgeInsets(this.top, this.bottom, this.left, this.right); } /** * Returns the current state as json, useful when you want to have a * read-only representation of the inset. * * @returns state as json */ toJSON() { return { top: this.top, bottom: this.bottom, left: this.left, right: this.right }; } } const MAX_VALID_LATITUDE = 85.051129; /** * @internal * A single transform, generally used for a single tile to be * scaled, rotated, and zoomed. */ class Transform { constructor(minZoom, maxZoom, minPitch, maxPitch, renderWorldCopies) { this.tileSize = 512; // constant this._renderWorldCopies = renderWorldCopies === undefined ? true : !!renderWorldCopies; this._minZoom = minZoom || 0; this._maxZoom = maxZoom || 22; this._minPitch = (minPitch === undefined || minPitch === null) ? 0 : minPitch; this._maxPitch = (maxPitch === undefined || maxPitch === null) ? 60 : maxPitch; this.setMaxBounds(); this.width = 0; this.height = 0; this._center = new LngLat(0, 0); this._elevation = 0; this.zoom = 0; this.angle = 0; this._fov = 0.6435011087932844; this._pitch = 0; this._unmodified = true; this._edgeInsets = new EdgeInsets(); this._posMatrixCache = {}; this._alignedPosMatrixCache = {}; this._fogMatrixCache = {}; this.minElevationForCurrentTile = 0; } clone() { const clone = new Transform(this._minZoom, this._maxZoom, this._minPitch, this.maxPitch, this._renderWorldCopies); clone.apply(this); return clone; } apply(that) { this.tileSize = that.tileSize; this.latRange = that.latRange; this.lngRange = that.lngRange; this.width = that.width; this.height = that.height; this._center = that._center; this._elevation = that._elevation; this.minElevationForCurrentTile = that.minElevationForCurrentTile; this.zoom = that.zoom; this.angle = that.angle; this._fov = that._fov; this._pitch = that._pitch; this._unmodified = that._unmodified; this._edgeInsets = that._edgeInsets.clone(); this._calcMatrices(); } get minZoom() { return this._minZoom; } set minZoom(zoom) { if (this._minZoom === zoom) return; this._minZoom = zoom; this.zoom = Math.max(this.zoom, zoom); } get maxZoom() { return this._maxZoom; } set maxZoom(zoom) { if (this._maxZoom === zoom) return; this._maxZoom = zoom; this.zoom = Math.min(this.zoom, zoom); } get minPitch() { return this._minPitch; } set minPitch(pitch) { if (this._minPitch === pitch) return; this._minPitch = pitch; this.pitch = Math.max(this.pitch, pitch); } get maxPitch() { return this._maxPitch; } set maxPitch(pitch) { if (this._maxPitch === pitch) return; this._maxPitch = pitch; this.pitch = Math.min(this.pitch, pitch); } get renderWorldCopies() { return this._renderWorldCopies; } set renderWorldCopies(renderWorldCopies) { if (renderWorldCopies === undefined) { renderWorldCopies = true; } else if (renderWorldCopies === null) { renderWorldCopies = false; } this._renderWorldCopies = renderWorldCopies; } get worldSize() { return this.tileSize * this.scale; } get centerOffset() { return this.centerPoint._sub(this.size._div(2)); } get size() { return new Point$2(this.width, this.height); } get bearing() { return -this.angle / Math.PI * 180; } set bearing(bearing) { const b = -wrap(bearing, -180, 180) * Math.PI / 180; if (this.angle === b) return; this._unmodified = false; this.angle = b; this._calcMatrices(); // 2x2 matrix for rotating points this.rotationMatrix = create$9(); rotate$4(this.rotationMatrix, this.rotationMatrix, this.angle); } get pitch() { return this._pitch / Math.PI * 180; } set pitch(pitch) { const p = clamp$1(pitch, this.minPitch, this.maxPitch) / 180 * Math.PI; if (this._pitch === p) return; this._unmodified = false; this._pitch = p; this._calcMatrices(); } get fov() { return this._fov / Math.PI * 180; } set fov(fov) { fov = Math.max(0.01, Math.min(60, fov)); if (this._fov === fov) return; this._unmodified = false; this._fov = fov / 180 * Math.PI; this._calcMatrices(); } get zoom() { return this._zoom; } set zoom(zoom) { const constrainedZoom = Math.min(Math.max(zoom, this.minZoom), this.maxZoom); if (this._zoom === constrainedZoom) return; this._unmodified = false; this._zoom = constrainedZoom; this.tileZoom = Math.max(0, Math.floor(constrainedZoom)); this.scale = this.zoomScale(constrainedZoom); this._constrain(); this._calcMatrices(); } get center() { return this._center; } set center(center) { if (center.lat === this._center.lat && center.lng === this._center.lng) return; this._unmodified = false; this._center = center; this._constrain(); this._calcMatrices(); } /** * Elevation at current center point, meters above sea level */ get elevation() { return this._elevation; } set elevation(elevation) { if (elevation === this._elevation) return; this._elevation = elevation; this._constrain(); this._calcMatrices(); } get padding() { return this._edgeInsets.toJSON(); } set padding(padding) { if (this._edgeInsets.equals(padding)) return; this._unmodified = false; //Update edge-insets in place this._edgeInsets.interpolate(this._edgeInsets, padding, 1); this._calcMatrices(); } /** * The center of the screen in pixels with the top-left corner being (0,0) * and +y axis pointing downwards. This accounts for padding. */ get centerPoint() { return this._edgeInsets.getCenter(this.width, this.height); } /** * Returns if the padding params match * * @param padding - the padding to check against * @returns true if they are equal, false otherwise */ isPaddingEqual(padding) { return this._edgeInsets.equals(padding); } /** * Helper method to update edge-insets in place * * @param start - the starting padding * @param target - the target padding * @param t - the step/weight */ interpolatePadding(start, target, t) { this._unmodified = false; this._edgeInsets.interpolate(start, target, t); this._constrain(); this._calcMatrices(); } /** * Return a zoom level that will cover all tiles the transform * @param options - the options * @returns zoom level An integer zoom level at which all tiles will be visible. */ coveringZoomLevel(options) { const z = (options.roundZoom ? Math.round : Math.floor)(this.zoom + this.scaleZoom(this.tileSize / options.tileSize)); // At negative zoom levels load tiles from z0 because negative tile zoom levels don't exist. return Math.max(0, z); } /** * Return any "wrapped" copies of a given tile coordinate that are visible * in the current view. */ getVisibleUnwrappedCoordinates(tileID) { const result = [new UnwrappedTileID(0, tileID)]; if (this._renderWorldCopies) { const utl = this.pointCoordinate(new Point$2(0, 0)); const utr = this.pointCoordinate(new Point$2(this.width, 0)); const ubl = this.pointCoordinate(new Point$2(this.width, this.height)); const ubr = this.pointCoordinate(new Point$2(0, this.height)); const w0 = Math.floor(Math.min(utl.x, utr.x, ubl.x, ubr.x)); const w1 = Math.floor(Math.max(utl.x, utr.x, ubl.x, ubr.x)); // Add an extra copy of the world on each side to properly render ImageSources and CanvasSources. // Both sources draw outside the tile boundaries of the tile that "contains them" so we need // to add extra copies on both sides in case offscreen tiles need to draw into on-screen ones. const extraWorldCopy = 1; for (let w = w0 - extraWorldCopy; w <= w1 + extraWorldCopy; w++) { if (w === 0) continue; result.push(new UnwrappedTileID(w, tileID)); } } return result; } /** * Return all coordinates that could cover this transform for a covering * zoom level. * @param options - the options * @returns OverscaledTileIDs */ coveringTiles(options) { var _a, _b; let z = this.coveringZoomLevel(options); const actualZ = z; if (options.minzoom !== undefined && z < options.minzoom) return []; if (options.maxzoom !== undefined && z > options.maxzoom) z = options.maxzoom; const cameraCoord = this.pointCoordinate(this.getCameraPoint()); const centerCoord = MercatorCoordinate.fromLngLat(this.center); const numTiles = Math.pow(2, z); const cameraPoint = [numTiles * cameraCoord.x, numTiles * cameraCoord.y, 0]; const centerPoint = [numTiles * centerCoord.x, numTiles * centerCoord.y, 0]; const cameraFrustum = Frustum.fromInvProjectionMatrix(this.invModelViewProjectionMatrix, this.worldSize, z); // No change of LOD behavior for pitch lower than 60 and when there is no top padding: return only tile ids from the requested zoom level let minZoom = options.minzoom || 0; // Use 0.1 as an epsilon to avoid for explicit == 0.0 floating point checks if (!options.terrain && this.pitch <= 60.0 && this._edgeInsets.top < 0.1) minZoom = z; // There should always be a certain number of maximum zoom level tiles surrounding the center location in 2D or in front of the camera in 3D const radiusOfMaxLvlLodInTiles = options.terrain ? 2 / Math.min(this.tileSize, options.tileSize) * this.tileSize : 3; const newRootTile = (wrap) => { return { aabb: new Aabb([wrap * numTiles, 0, 0], [(wrap + 1) * numTiles, numTiles, 0]), zoom: 0, x: 0, y: 0, wrap, fullyVisible: false }; }; // Do a depth-first traversal to find visible tiles and proper levels of detail const stack = []; const result = []; const maxZoom = z; const overscaledZ = options.reparseOverscaled ? actualZ : z; if (this._renderWorldCopies) { // Render copy of the globe thrice on both sides for (let i = 1; i <= 3; i++) { stack.push(newRootTile(-i)); stack.push(newRootTile(i)); } } stack.push(newRootTile(0)); while (stack.length > 0) { const it = stack.pop(); const x = it.x; const y = it.y; let fullyVisible = it.fullyVisible; // Visibility of a tile is not required if any of its ancestor if fully inside the frustum if (!fullyVisible) { const intersectResult = it.aabb.intersects(cameraFrustum); if (intersectResult === 0) continue; fullyVisible = intersectResult === 2; } const refPoint = options.terrain ? cameraPoint : centerPoint; const distanceX = it.aabb.distanceX(refPoint); const distanceY = it.aabb.distanceY(refPoint); const longestDim = Math.max(Math.abs(distanceX), Math.abs(distanceY)); // We're using distance based heuristics to determine if a tile should be split into quadrants or not. // radiusOfMaxLvlLodInTiles defines that there's always a certain number of maxLevel tiles next to the map center. // Using the fact that a parent node in quadtree is twice the size of its children (per dimension) // we can define distance thresholds for each relative level: // f(k) = offset + 2 + 4 + 8 + 16 + ... + 2^k. This is the same as "offset+2^(k+1)-2" const distToSplit = radiusOfMaxLvlLodInTiles + (1 << (maxZoom - it.zoom)) - 2; // Have we reached the target depth or is the tile too far away to be any split further? if (it.zoom === maxZoom || (longestDim > distToSplit && it.zoom >= minZoom)) { const dz = maxZoom - it.zoom, dx = cameraPoint[0] - 0.5 - (x << dz), dy = cameraPoint[1] - 0.5 - (y << dz); result.push({ tileID: new OverscaledTileID(it.zoom === maxZoom ? overscaledZ : it.zoom, it.wrap, it.zoom, x, y), distanceSq: sqrLen([centerPoint[0] - 0.5 - x, centerPoint[1] - 0.5 - y]), // this variable is currently not used, but may be important to reduce the amount of loaded tiles tileDistanceToCamera: Math.sqrt(dx * dx + dy * dy) }); continue; } for (let i = 0; i < 4; i++) { const childX = (x << 1) + (i % 2); const childY = (y << 1) + (i >> 1); const childZ = it.zoom + 1; let quadrant = it.aabb.quadrant(i); if (options.terrain) { const tileID = new OverscaledTileID(childZ, it.wrap, childZ, childX, childY); const minMax = options.terrain.getMinMaxElevation(tileID); const minElevation = (_a = minMax.minElevation) !== null && _a !== void 0 ? _a : this.elevation; const maxElevation = (_b = minMax.maxElevation) !== null && _b !== void 0 ? _b : this.elevation; quadrant = new Aabb([quadrant.min[0], quadrant.min[1], minElevation], [quadrant.max[0], quadrant.max[1], maxElevation]); } stack.push({ aabb: quadrant, zoom: childZ, x: childX, y: childY, wrap: it.wrap, fullyVisible }); } } return result.sort((a, b) => a.distanceSq - b.distanceSq).map(a => a.tileID); } resize(width, height) { this.width = width; this.height = height; this.pixelsToGLUnits = [2 / width, -2 / height]; this._constrain(); this._calcMatrices(); } get unmodified() { return this._unmodified; } zoomScale(zoom) { return Math.pow(2, zoom); } scaleZoom(scale) { return Math.log(scale) / Math.LN2; } /** * Convert from LngLat to world coordinates (Mercator coordinates scaled by 512) * @param lnglat - the lngLat * @returns Point */ project(lnglat) { const lat = clamp$1(lnglat.lat, -MAX_VALID_LATITUDE, MAX_VALID_LATITUDE); return new Point$2(mercatorXfromLng(lnglat.lng) * this.worldSize, mercatorYfromLat(lat) * this.worldSize); } /** * Convert from world coordinates ([0, 512],[0, 512]) to LngLat ([-180, 180], [-90, 90]) * @param point - world coordinate * @returns LngLat */ unproject(point) { return new MercatorCoordinate(point.x / this.worldSize, point.y / this.worldSize).toLngLat(); } get point() { return this.project(this.center); } /** * get the camera position in LngLat and altitudes in meter * @returns An object with lngLat & altitude. */ getCameraPosition() { const lngLat = this.pointLocation(this.getCameraPoint()); const altitude = Math.cos(this._pitch) * this.cameraToCenterDistance / this._pixelPerMeter; return { lngLat, altitude: altitude + this.elevation }; } /** * This method works in combination with freezeElevation activated. * freezeElevation is enabled during map-panning because during this the camera should sit in constant height. * After panning finished, call this method to recalculate the zoomlevel for the current camera-height in current terrain. * @param terrain - the terrain */ recalculateZoom(terrain) { const origElevation = this.elevation; const origAltitude = Math.cos(this._pitch) * this.cameraToCenterDistance / this._pixelPerMeter; // find position the camera is looking on const center = this.pointLocation(this.centerPoint, terrain); const elevation = terrain.getElevationForLngLatZoom(center, this.tileZoom); const deltaElevation = this.elevation - elevation; if (!deltaElevation) return; // The camera's altitude off the ground + the ground's elevation = a constant: // this means the camera stays at the same total height. const requiredAltitude = origAltitude + origElevation - elevation; // Since altitude = Math.cos(this._pitch) * this.cameraToCenterDistance / pixelPerMeter: const requiredPixelPerMeter = Math.cos(this._pitch) * this.cameraToCenterDistance / requiredAltitude; // Since pixelPerMeter = mercatorZfromAltitude(1, center.lat) * worldSize: const requiredWorldSize = requiredPixelPerMeter / mercatorZfromAltitude(1, center.lat); // Since worldSize = this.tileSize * scale: const requiredScale = requiredWorldSize / this.tileSize; const zoom = this.scaleZoom(requiredScale); // update matrices this._elevation = elevation; this._center = center; this.zoom = zoom; } setLocationAtPoint(lnglat, point) { const a = this.pointCoordinate(point); const b = this.pointCoordinate(this.centerPoint); const loc = this.locationCoordinate(lnglat); const newCenter = new MercatorCoordinate(loc.x - (a.x - b.x), loc.y - (a.y - b.y)); this.center = this.coordinateLocation(newCenter); if (this._renderWorldCopies) { this.center = this.center.wrap(); } } /** * Given a LngLat location, return the screen point that corresponds to it * @param lnglat - location * @param terrain - optional terrain * @returns screen point */ locationPoint(lnglat, terrain) { return terrain ? this.coordinatePoint(this.locationCoordinate(lnglat), terrain.getElevationForLngLatZoom(lnglat, this.tileZoom), this.pixelMatrix3D) : this.coordinatePoint(this.locationCoordinate(lnglat)); } /** * Given a point on screen, return its lnglat * @param p - screen point * @param terrain - optional terrain * @returns lnglat location */ pointLocation(p, terrain) { return this.coordinateLocation(this.pointCoordinate(p, terrain)); } /** * Given a geographical lnglat, return an unrounded * coordinate that represents it at low zoom level. * @param lnglat - the location * @returns The mercator coordinate */ locationCoordinate(lnglat) { return MercatorCoordinate.fromLngLat(lnglat); } /** * Given a Coordinate, return its geographical position. * @param coord - mercator coordinates * @returns lng and lat */ coordinateLocation(coord) { return coord && coord.toLngLat(); } /** * Given a Point, return its mercator coordinate. * @param p - the point * @param terrain - optional terrain * @returns lnglat */ pointCoordinate(p, terrain) { // get point-coordinate from terrain coordinates framebuffer if (terrain) { const coordinate = terrain.pointCoordinate(p); if (coordinate != null) { return coordinate; } } // calculate point-coordinate on flat earth const targetZ = 0; // since we don't know the correct projected z value for the point, // unproject two points to get a line and then find the point on that // line with z=0 const coord0 = [p.x, p.y, 0, 1]; const coord1 = [p.x, p.y, 1, 1]; transformMat4$1(coord0, coord0, this.pixelMatrixInverse); transformMat4$1(coord1, coord1, this.pixelMatrixInverse); const w0 = coord0[3]; const w1 = coord1[3]; const x0 = coord0[0] / w0; const x1 = coord1[0] / w1; const y0 = coord0[1] / w0; const y1 = coord1[1] / w1; const z0 = coord0[2] / w0; const z1 = coord1[2] / w1; const t = z0 === z1 ? 0 : (targetZ - z0) / (z1 - z0); return new MercatorCoordinate(interpolate.number(x0, x1, t) / this.worldSize, interpolate.number(y0, y1, t) / this.worldSize); } /** * Given a coordinate, return the screen point that corresponds to it * @param coord - the coordinates * @param elevation - the elevation * @param pixelMatrix - the pixel matrix * @returns screen point */ coordinatePoint(coord, elevation = 0, pixelMatrix = this.pixelMatrix) { const p = [coord.x * this.worldSize, coord.y * this.worldSize, elevation, 1]; transformMat4$1(p, p, pixelMatrix); return new Point$2(p[0] / p[3], p[1] / p[3]); } /** * Returns the map's geographical bounds. When the bearing or pitch is non-zero, the visible region is not * an axis-aligned rectangle, and the result is the smallest bounds that encompasses the visible region. * @returns Returns a {@link LngLatBounds} object describing the map's geographical bounds. */ getBounds() { const top = Math.max(0, this.height / 2 - this.getHorizon()); return new LngLatBounds() .extend(this.pointLocation(new Point$2(0, top))) .extend(this.pointLocation(new Point$2(this.width, top))) .extend(this.pointLocation(new Point$2(this.width, this.height))) .extend(this.pointLocation(new Point$2(0, this.height))); } /** * Returns the maximum geographical bounds the map is constrained to, or `null` if none set. * @returns max bounds */ getMaxBounds() { if (!this.latRange || this.latRange.length !== 2 || !this.lngRange || this.lngRange.length !== 2) return null; return new LngLatBounds([this.lngRange[0], this.latRange[0]], [this.lngRange[1], this.latRange[1]]); } /** * Calculate pixel height of the visible horizon in relation to map-center (e.g. height/2), * multiplied by a static factor to simulate the earth-radius. * The calculated value is the horizontal line from the camera-height to sea-level. * @returns Horizon above center in pixels. */ getHorizon() { return Math.tan(Math.PI / 2 - this._pitch) * this.cameraToCenterDistance * 0.85; } /** * Sets or clears the map's geographical constraints. * @param bounds - A {@link LngLatBounds} object describing the new geographic boundaries of the map. */ setMaxBounds(bounds) { if (bounds) { this.lngRange = [bounds.getWest(), bounds.getEast()]; this.latRange = [bounds.getSouth(), bounds.getNorth()]; this._constrain(); } else { this.lngRange = null; this.latRange = [-MAX_VALID_LATITUDE, MAX_VALID_LATITUDE]; } } calculateTileMatrix(unwrappedTileID) { const canonical = unwrappedTileID.canonical; const scale = this.worldSize / this.zoomScale(canonical.z); const unwrappedX = canonical.x + Math.pow(2, canonical.z) * unwrappedTileID.wrap; const worldMatrix = identity$2(new Float64Array(16)); translate$1(worldMatrix, worldMatrix, [unwrappedX * scale, canonical.y * scale, 0]); scale$5(worldMatrix, worldMatrix, [scale / EXTENT, scale / EXTENT, 1]); return worldMatrix; } /** * Calculate the posMatrix that, given a tile coordinate, would be used to display the tile on a map. * @param unwrappedTileID - the tile ID */ calculatePosMatrix(unwrappedTileID, aligned = false) { const posMatrixKey = unwrappedTileID.key; const cache = aligned ? this._alignedPosMatrixCache : this._posMatrixCache; if (cache[posMatrixKey]) { return cache[posMatrixKey]; } const posMatrix = this.calculateTileMatrix(unwrappedTileID); multiply$5(posMatrix, aligned ? this.alignedModelViewProjectionMatrix : this.modelViewProjectionMatrix, posMatrix); cache[posMatrixKey] = new Float32Array(posMatrix); return cache[posMatrixKey]; } /** * Calculate the fogMatrix that, given a tile coordinate, would be used to calculate fog on the map. * @param unwrappedTileID - the tile ID * @private */ calculateFogMatrix(unwrappedTileID) { const posMatrixKey = unwrappedTileID.key; const cache = this._fogMatrixCache; if (cache[posMatrixKey]) { return cache[posMatrixKey]; } const fogMatrix = this.calculateTileMatrix(unwrappedTileID); multiply$5(fogMatrix, this.fogMatrix, fogMatrix); cache[posMatrixKey] = new Float32Array(fogMatrix); return cache[posMatrixKey]; } customLayerMatrix() { return this.mercatorMatrix.slice(); } /** * Get center lngLat and zoom to ensure that * 1) everything beyond the bounds is excluded * 2) a given lngLat is as near the center as possible * Bounds are those set by maxBounds or North & South "Poles" and, if only 1 globe is displayed, antimeridian. */ getConstrained(lngLat, zoom) { zoom = clamp$1(+zoom, this.minZoom, this.maxZoom); const result = { center: new LngLat(lngLat.lng, lngLat.lat), zoom }; let lngRange = this.lngRange; if (!this._renderWorldCopies && lngRange === null) { const almost180 = 180 - 1e-10; lngRange = [-almost180, almost180]; } const worldSize = this.tileSize * this.zoomScale(result.zoom); // A world size for the requested zoom level, not the current world size let minY = 0; let maxY = worldSize; let minX = 0; let maxX = worldSize; let scaleY = 0; let scaleX = 0; const { x: screenWidth, y: screenHeight } = this.size; if (this.latRange) { const latRange = this.latRange; minY = mercatorYfromLat(latRange[1]) * worldSize; maxY = mercatorYfromLat(latRange[0]) * worldSize; const shouldZoomIn = maxY - minY < screenHeight; if (shouldZoomIn) scaleY = screenHeight / (maxY - minY); } if (lngRange) { minX = wrap(mercatorXfromLng(lngRange[0]) * worldSize, 0, worldSize); maxX = wrap(mercatorXfromLng(lngRange[1]) * worldSize, 0, worldSize); if (maxX < minX) maxX += worldSize; const shouldZoomIn = maxX - minX < screenWidth; if (shouldZoomIn) scaleX = screenWidth / (maxX - minX); } const { x: originalX, y: originalY } = this.project.call({ worldSize }, lngLat); let modifiedX, modifiedY; const scale = Math.max(scaleX || 0, scaleY || 0); if (scale) { // zoom in to exclude all beyond the given lng/lat ranges const newPoint = new Point$2(scaleX ? (maxX + minX) / 2 : originalX, scaleY ? (maxY + minY) / 2 : originalY); result.center = this.unproject.call({ worldSize }, newPoint).wrap(); result.zoom += this.scaleZoom(scale); return result; } if (this.latRange) { const h2 = screenHeight / 2; if (originalY - h2 < minY) modifiedY = minY + h2; if (originalY + h2 > maxY) modifiedY = maxY - h2; } if (lngRange) { const centerX = (minX + maxX) / 2; let wrappedX = originalX; if (this._renderWorldCopies) { wrappedX = wrap(originalX, centerX - worldSize / 2, centerX + worldSize / 2); } const w2 = screenWidth / 2; if (wrappedX - w2 < minX) modifiedX = minX + w2; if (wrappedX + w2 > maxX) modifiedX = maxX - w2; } // pan the map if the screen goes off the range if (modifiedX !== undefined || modifiedY !== undefined) { const newPoint = new Point$2(modifiedX !== null && modifiedX !== void 0 ? modifiedX : originalX, modifiedY !== null && modifiedY !== void 0 ? modifiedY : originalY); result.center = this.unproject.call({ worldSize }, newPoint).wrap(); } return result; } _constrain() { if (!this.center || !this.width || !this.height || this._constraining) return; this._constraining = true; const unmodified = this._unmodified; const { center, zoom } = this.getConstrained(this.center, this.zoom); this.center = center; this.zoom = zoom; this._unmodified = unmodified; this._constraining = false; } _calcMatrices() { if (!this.height) return; const halfFov = this._fov / 2; const offset = this.centerOffset; const x = this.point.x, y = this.point.y; this.cameraToCenterDistance = 0.5 / Math.tan(halfFov) * this.height; this._pixelPerMeter = mercatorZfromAltitude(1, this.center.lat) * this.worldSize; let m = identity$2(new Float64Array(16)); scale$5(m, m, [this.width / 2, -this.height / 2, 1]); translate$1(m, m, [1, -1, 0]); this.labelPlaneMatrix = m; m = identity$2(new Float64Array(16)); scale$5(m, m, [1, -1, 1]); translate$1(m, m, [-1, -1, 0]); scale$5(m, m, [2 / this.width, 2 / this.height, 1]); this.glCoordMatrix = m; // Calculate the camera to sea-level distance in pixel in respect of terrain const cameraToSeaLevelDistance = this.cameraToCenterDistance + this._elevation * this._pixelPerMeter / Math.cos(this._pitch); // In case of negative minimum elevation (e.g. the dead see, under the sea maps) use a lower plane for calculation const minElevation = Math.min(this.elevation, this.minElevationForCurrentTile); const cameraToLowestPointDistance = cameraToSeaLevelDistance - minElevation * this._pixelPerMeter / Math.cos(this._pitch); const lowestPlane = minElevation < 0 ? cameraToLowestPointDistance : cameraToSeaLevelDistance; // Find the distance from the center point [width/2 + offset.x, height/2 + offset.y] to the // center top point [width/2 + offset.x, 0] in Z units, using the law of sines. // 1 Z unit is equivalent to 1 horizontal px at the center of the map // (the distance between[width/2, height/2] and [width/2 + 1, height/2]) const groundAngle = Math.PI / 2 + this._pitch; const fovAboveCenter = this._fov * (0.5 + offset.y / this.height); const topHalfSurfaceDistance = Math.sin(fovAboveCenter) * lowestPlane / Math.sin(clamp$1(Math.PI - groundAngle - fovAboveCenter, 0.01, Math.PI - 0.01)); // Find the distance from the center point to the horizon const horizon = this.getHorizon(); const horizonAngle = Math.atan(horizon / this.cameraToCenterDistance); const fovCenterToHorizon = 2 * horizonAngle * (0.5 + offset.y / (horizon * 2)); const topHalfSurfaceDistanceHorizon = Math.sin(fovCenterToHorizon) * lowestPlane / Math.sin(clamp$1(Math.PI - groundAngle - fovCenterToHorizon, 0.01, Math.PI - 0.01)); // Calculate z distance of the farthest fragment that should be rendered. // Add a bit extra to avoid precision problems when a fragment's distance is exactly `furthestDistance` const topHalfMinDistance = Math.min(topHalfSurfaceDistance, topHalfSurfaceDistanceHorizon); this.farZ = (Math.cos(Math.PI / 2 - this._pitch) * topHalfMinDistance + lowestPlane) * 1.01; // The larger the value of nearZ is // - the more depth precision is available for features (good) // - clipping starts appearing sooner when the camera is close to 3d features (bad) // // Other values work for mapbox-gl-js but deck.gl was encountering precision issues // when rendering custom layers. This value was experimentally chosen and // seems to solve z-fighting issues in deck.gl while not clipping buildings too close to the camera. this.nearZ = this.height / 50; // matrix for conversion from location to clip space(-1 .. 1) m = new Float64Array(16); perspective(m, this._fov, this.width / this.height, this.nearZ, this.farZ); // Apply center of perspective offset m[8] = -offset.x * 2 / this.width; m[9] = offset.y * 2 / this.height; this.projectionMatrix = clone$5(m); scale$5(m, m, [1, -1, 1]); translate$1(m, m, [0, 0, -this.cameraToCenterDistance]); rotateX$3(m, m, this._pitch); rotateZ$3(m, m, this.angle); translate$1(m, m, [-x, -y, 0]); // The mercatorMatrix can be used to transform points from mercator coordinates // ([0, 0] nw, [1, 1] se) to clip space. this.mercatorMatrix = scale$5([], m, [this.worldSize, this.worldSize, this.worldSize]); // scale vertically to meters per pixel (inverse of ground resolution): scale$5(m, m, [1, 1, this._pixelPerMeter]); // matrix for conversion from world space to screen coordinates in 2D this.pixelMatrix = multiply$5(new Float64Array(16), this.labelPlaneMatrix, m); // matrix for conversion from world space to clip space (-1 .. 1) translate$1(m, m, [0, 0, -this.elevation]); // elevate camera over terrain this.modelViewProjectionMatrix = m; this.invModelViewProjectionMatrix = invert$2([], m); // create a fog matrix, same es proj-matrix but with near clipping-plane in mapcenter // needed to calculate a correct z-value for fog calculation, because projMatrix z value is not this.fogMatrix = new Float64Array(16); perspective(this.fogMatrix, this._fov, this.width / this.height, cameraToSeaLevelDistance, this.farZ); this.fogMatrix[8] = -offset.x * 2 / this.width; this.fogMatrix[9] = offset.y * 2 / this.height; scale$5(this.fogMatrix, this.fogMatrix, [1, -1, 1]); translate$1(this.fogMatrix, this.fogMatrix, [0, 0, -this.cameraToCenterDistance]); rotateX$3(this.fogMatrix, this.fogMatrix, this._pitch); rotateZ$3(this.fogMatrix, this.fogMatrix, this.angle); translate$1(this.fogMatrix, this.fogMatrix, [-x, -y, 0]); scale$5(this.fogMatrix, this.fogMatrix, [1, 1, this._pixelPerMeter]); translate$1(this.fogMatrix, this.fogMatrix, [0, 0, -this.elevation]); // elevate camera over terrain // matrix for conversion from world space to screen coordinates in 3D this.pixelMatrix3D = multiply$5(new Float64Array(16), this.labelPlaneMatrix, m); // Make a second projection matrix that is aligned to a pixel grid for rendering raster tiles. // We're rounding the (floating point) x/y values to achieve to avoid rendering raster images to fractional // coordinates. Additionally, we adjust by half a pixel in either direction in case that viewport dimension // is an odd integer to preserve rendering to the pixel grid. We're rotating this shift based on the angle // of the transformation so that 0°, 90°, 180°, and 270° rasters are crisp, and adjust the shift so that // it is always <= 0.5 pixels. const xShift = (this.width % 2) / 2, yShift = (this.height % 2) / 2, angleCos = Math.cos(this.angle), angleSin = Math.sin(this.angle), dx = x - Math.round(x) + angleCos * xShift + angleSin * yShift, dy = y - Math.round(y) + angleCos * yShift + angleSin * xShift; const alignedM = new Float64Array(m); translate$1(alignedM, alignedM, [dx > 0.5 ? dx - 1 : dx, dy > 0.5 ? dy - 1 : dy, 0]); this.alignedModelViewProjectionMatrix = alignedM; // inverse matrix for conversion from screen coordinates to location m = invert$2(new Float64Array(16), this.pixelMatrix); if (!m) throw new Error('failed to invert matrix'); this.pixelMatrixInverse = m; this._posMatrixCache = {}; this._alignedPosMatrixCache = {}; this._fogMatrixCache = {}; } maxPitchScaleFactor() { // calcMatrices hasn't run yet if (!this.pixelMatrixInverse) return 1; const coord = this.pointCoordinate(new Point$2(0, 0)); const p = [coord.x * this.worldSize, coord.y * this.worldSize, 0, 1]; const topPoint = transformMat4$1(p, p, this.pixelMatrix); return topPoint[3] / this.cameraToCenterDistance; } /** * The camera looks at the map from a 3D (lng, lat, altitude) location. Let's use `cameraLocation` * as the name for the location under the camera and on the surface of the earth (lng, lat, 0). * `cameraPoint` is the projected position of the `cameraLocation`. * * This point is useful to us because only fill-extrusions that are between `cameraPoint` and * the query point on the surface of the earth can extend and intersect the query. * * When the map is not pitched the `cameraPoint` is equivalent to the center of the map because * the camera is right above the center of the map. */ getCameraPoint() { const pitch = this._pitch; const yOffset = Math.tan(pitch) * (this.cameraToCenterDistance || 1); return this.centerPoint.add(new Point$2(0, yOffset)); } /** * When the map is pitched, some of the 3D features that intersect a query will not intersect * the query at the surface of the earth. Instead the feature may be closer and only intersect * the query because it extrudes into the air. * @param queryGeometry - For point queries, the line from the query point to the "camera point", * for other geometries, the envelope of the query geometry and the "camera point" * @returns a geometry that includes all of the original query as well as all possible ares of the * screen where the *base* of a visible extrusion could be. * */ getCameraQueryGeometry(queryGeometry) { const c = this.getCameraPoint(); if (queryGeometry.length === 1) { return [queryGeometry[0], c]; } else { let minX = c.x; let minY = c.y; let maxX = c.x; let maxY = c.y; for (const p of queryGeometry) { minX = Math.min(minX, p.x); minY = Math.min(minY, p.y); maxX = Math.max(maxX, p.x); maxY = Math.max(maxY, p.y); } return [ new Point$2(minX, minY), new Point$2(maxX, minY), new Point$2(maxX, maxY), new Point$2(minX, maxY), new Point$2(minX, minY) ]; } } /** * Return the distance to the camera in clip space from a LngLat. * This can be compared to the value from the depth buffer (terrain.depthAtPoint) * to determine whether a point is occluded. * @param lngLat - the point * @param elevation - the point's elevation * @returns depth value in clip space (between 0 and 1) */ lngLatToCameraDepth(lngLat, elevation) { const coord = this.locationCoordinate(lngLat); const p = [coord.x * this.worldSize, coord.y * this.worldSize, elevation, 1]; transformMat4$1(p, p, this.modelViewProjectionMatrix); return (p[2] / p[3]); } } /** * Throttle the given function to run at most every `period` milliseconds. */ function throttle(fn, time) { let pending = false; let timerId = null; let lastCallContext = null; let lastCallArgs; const later = () => { timerId = null; if (pending) { fn.apply(lastCallContext, lastCallArgs); timerId = setTimeout(later, time); pending = false; } }; return (...args) => { pending = true; lastCallContext = this; lastCallArgs = args; if (!timerId) { later(); } return timerId; }; } /** * Adds the map's position to its page's location hash. * Passed as an option to the map object. * * @group Markers and Controls */ class Hash { constructor(hashName) { this._getCurrentHash = () => { // Get the current hash from location, stripped from its number sign const hash = window.location.hash.replace('#', ''); if (this._hashName) { // Split the parameter-styled hash into parts and find the value we need let keyval; hash.split('&').map(part => part.split('=')).forEach(part => { if (part[0] === this._hashName) { keyval = part; } }); return (keyval ? keyval[1] || '' : '').split('/'); } return hash.split('/'); }; this._onHashChange = () => { const loc = this._getCurrentHash(); if (loc.length >= 3 && !loc.some(v => isNaN(v))) { const bearing = this._map.dragRotate.isEnabled() && this._map.touchZoomRotate.isEnabled() ? +(loc[3] || 0) : this._map.getBearing(); this._map.jumpTo({ center: [+loc[2], +loc[1]], zoom: +loc[0], bearing, pitch: +(loc[4] || 0) }); return true; } return false; }; this._updateHashUnthrottled = () => { // Replace if already present, else append the updated hash string const location = window.location.href.replace(/(#.+)?$/, this.getHashString()); window.history.replaceState(window.history.state, null, location); }; this._removeHash = () => { const currentHash = this._getCurrentHash(); if (currentHash.length === 0) { return; } const baseHash = currentHash.join('/'); let targetHash = baseHash; if (targetHash.split('&').length > 0) { targetHash = targetHash.split('&')[0]; // #3/1/2&foo=bar -> #3/1/2 } if (this._hashName) { targetHash = `${this._hashName}=${baseHash}`; } let replaceString = window.location.hash.replace(targetHash, ''); if (replaceString.startsWith('#&')) { replaceString = replaceString.slice(0, 1) + replaceString.slice(2); } else if (replaceString === '#') { replaceString = ''; } let location = window.location.href.replace(/(#.+)?$/, replaceString); location = location.replace('&&', '&'); window.history.replaceState(window.history.state, null, location); }; /** * Mobile Safari doesn't allow updating the hash more than 100 times per 30 seconds. */ this._updateHash = throttle(this._updateHashUnthrottled, 30 * 1000 / 100); this._hashName = hashName && encodeURIComponent(hashName); } /** * Map element to listen for coordinate changes * * @param map - The map object */ addTo(map) { this._map = map; addEventListener('hashchange', this._onHashChange, false); this._map.on('moveend', this._updateHash); return this; } /** * Removes hash */ remove() { removeEventListener('hashchange', this._onHashChange, false); this._map.off('moveend', this._updateHash); clearTimeout(this._updateHash()); this._removeHash(); delete this._map; return this; } getHashString(mapFeedback) { const center = this._map.getCenter(), zoom = Math.round(this._map.getZoom() * 100) / 100, // derived from equation: 512px * 2^z / 360 / 10^d < 0.5px precision = Math.ceil((zoom * Math.LN2 + Math.log(512 / 360 / 0.5)) / Math.LN10), m = Math.pow(10, precision), lng = Math.round(center.lng * m) / m, lat = Math.round(center.lat * m) / m, bearing = this._map.getBearing(), pitch = this._map.getPitch(); let hash = ''; if (mapFeedback) { // new map feedback site has some constraints that don't allow // us to use the same hash format as we do for the Map hash option. hash += `/${lng}/${lat}/${zoom}`; } else { hash += `${zoom}/${lat}/${lng}`; } if (bearing || pitch) hash += (`/${Math.round(bearing * 10) / 10}`); if (pitch) hash += (`/${Math.round(pitch)}`); if (this._hashName) { const hashName = this._hashName; let found = false; const parts = window.location.hash.slice(1).split('&').map(part => { const key = part.split('=')[0]; if (key === hashName) { found = true; return `${key}=${hash}`; } return part; }).filter(a => a); if (!found) { parts.push(`${hashName}=${hash}`); } return `#${parts.join('&')}`; } return `#${hash}`; } } const defaultInertiaOptions = { linearity: 0.3, easing: bezier$1(0, 0, 0.3, 1), }; const defaultPanInertiaOptions = extend({ deceleration: 2500, maxSpeed: 1400 }, defaultInertiaOptions); const defaultZoomInertiaOptions = extend({ deceleration: 20, maxSpeed: 1400 }, defaultInertiaOptions); const defaultBearingInertiaOptions = extend({ deceleration: 1000, maxSpeed: 360 }, defaultInertiaOptions); const defaultPitchInertiaOptions = extend({ deceleration: 1000, maxSpeed: 90 }, defaultInertiaOptions); class HandlerInertia { constructor(map) { this._map = map; this.clear(); } clear() { this._inertiaBuffer = []; } record(settings) { this._drainInertiaBuffer(); this._inertiaBuffer.push({ time: browser.now(), settings }); } _drainInertiaBuffer() { const inertia = this._inertiaBuffer, now = browser.now(), cutoff = 160; //msec while (inertia.length > 0 && now - inertia[0].time > cutoff) inertia.shift(); } _onMoveEnd(panInertiaOptions) { this._drainInertiaBuffer(); if (this._inertiaBuffer.length < 2) { return; } const deltas = { zoom: 0, bearing: 0, pitch: 0, pan: new Point$2(0, 0), pinchAround: undefined, around: undefined }; for (const { settings } of this._inertiaBuffer) { deltas.zoom += settings.zoomDelta || 0; deltas.bearing += settings.bearingDelta || 0; deltas.pitch += settings.pitchDelta || 0; if (settings.panDelta) deltas.pan._add(settings.panDelta); if (settings.around) deltas.around = settings.around; if (settings.pinchAround) deltas.pinchAround = settings.pinchAround; } const lastEntry = this._inertiaBuffer[this._inertiaBuffer.length - 1]; const duration = (lastEntry.time - this._inertiaBuffer[0].time); const easeOptions = {}; if (deltas.pan.mag()) { const result = calculateEasing(deltas.pan.mag(), duration, extend({}, defaultPanInertiaOptions, panInertiaOptions || {})); easeOptions.offset = deltas.pan.mult(result.amount / deltas.pan.mag()); easeOptions.center = this._map.transform.center; extendDuration(easeOptions, result); } if (deltas.zoom) { const result = calculateEasing(deltas.zoom, duration, defaultZoomInertiaOptions); easeOptions.zoom = this._map.transform.zoom + result.amount; extendDuration(easeOptions, result); } if (deltas.bearing) { const result = calculateEasing(deltas.bearing, duration, defaultBearingInertiaOptions); easeOptions.bearing = this._map.transform.bearing + clamp$1(result.amount, -179, 179); extendDuration(easeOptions, result); } if (deltas.pitch) { const result = calculateEasing(deltas.pitch, duration, defaultPitchInertiaOptions); easeOptions.pitch = this._map.transform.pitch + result.amount; extendDuration(easeOptions, result); } if (easeOptions.zoom || easeOptions.bearing) { const last = deltas.pinchAround === undefined ? deltas.around : deltas.pinchAround; easeOptions.around = last ? this._map.unproject(last) : this._map.getCenter(); } this.clear(); return extend(easeOptions, { noMoveStart: true }); } } // Unfortunately zoom, bearing, etc can't have different durations and easings so // we need to choose one. We use the longest duration and it's corresponding easing. function extendDuration(easeOptions, result) { if (!easeOptions.duration || easeOptions.duration < result.duration) { easeOptions.duration = result.duration; easeOptions.easing = result.easing; } } function calculateEasing(amount, inertiaDuration, inertiaOptions) { const { maxSpeed, linearity, deceleration } = inertiaOptions; const speed = clamp$1(amount * linearity / (inertiaDuration / 1000), -maxSpeed, maxSpeed); const duration = Math.abs(speed) / (deceleration * linearity); return { easing: inertiaOptions.easing, duration: duration * 1000, amount: speed * (duration / 2) }; } /** * `MapMouseEvent` is the event type for mouse-related map events. * * @group Event Related * * @example * ```ts * // The `click` event is an example of a `MapMouseEvent`. * // Set up an event listener on the map. * map.on('click', (e) => { * // The event object (e) contains information like the * // coordinates of the point on the map that was clicked. * console.log('A click event has occurred at ' + e.lngLat); * }); * ``` */ class MapMouseEvent extends Event { /** * Prevents subsequent default processing of the event by the map. * * Calling this method will prevent the following default map behaviors: * * * On `mousedown` events, the behavior of {@link DragPanHandler} * * On `mousedown` events, the behavior of {@link DragRotateHandler} * * On `mousedown` events, the behavior of {@link BoxZoomHandler} * * On `dblclick` events, the behavior of {@link DoubleClickZoomHandler} * */ preventDefault() { this._defaultPrevented = true; } /** * `true` if `preventDefault` has been called. */ get defaultPrevented() { return this._defaultPrevented; } constructor(type, map, originalEvent, data = {}) { const point = DOM.mousePos(map.getCanvas(), originalEvent); const lngLat = map.unproject(point); super(type, extend({ point, lngLat, originalEvent }, data)); this._defaultPrevented = false; this.target = map; } } /** * `MapTouchEvent` is the event type for touch-related map events. * * @group Event Related */ class MapTouchEvent extends Event { /** * Prevents subsequent default processing of the event by the map. * * Calling this method will prevent the following default map behaviors: * * * On `touchstart` events, the behavior of {@link DragPanHandler} * * On `touchstart` events, the behavior of {@link TwoFingersTouchZoomRotateHandler} * */ preventDefault() { this._defaultPrevented = true; } /** * `true` if `preventDefault` has been called. */ get defaultPrevented() { return this._defaultPrevented; } constructor(type, map, originalEvent) { const touches = type === 'touchend' ? originalEvent.changedTouches : originalEvent.touches; const points = DOM.touchPos(map.getCanvasContainer(), touches); const lngLats = points.map((t) => map.unproject(t)); const point = points.reduce((prev, curr, i, arr) => { return prev.add(curr.div(arr.length)); }, new Point$2(0, 0)); const lngLat = map.unproject(point); super(type, { points, point, lngLats, lngLat, originalEvent }); this._defaultPrevented = false; } } /** * `MapWheelEvent` is the event type for the `wheel` map event. * * @group Event Related */ class MapWheelEvent extends Event { /** * Prevents subsequent default processing of the event by the map. * * Calling this method will prevent the behavior of {@link ScrollZoomHandler}. */ preventDefault() { this._defaultPrevented = true; } /** * `true` if `preventDefault` has been called. */ get defaultPrevented() { return this._defaultPrevented; } /** */ constructor(type, map, originalEvent) { super(type, { originalEvent }); this._defaultPrevented = false; } } class MapEventHandler { constructor(map, options) { this._map = map; this._clickTolerance = options.clickTolerance; } reset() { delete this._mousedownPos; } wheel(e) { // If mapEvent.preventDefault() is called by the user, prevent handlers such as: // - ScrollZoom return this._firePreventable(new MapWheelEvent(e.type, this._map, e)); } mousedown(e, point) { this._mousedownPos = point; // If mapEvent.preventDefault() is called by the user, prevent handlers such as: // - MousePan // - MouseRotate // - MousePitch // - DblclickHandler return this._firePreventable(new MapMouseEvent(e.type, this._map, e)); } mouseup(e) { this._map.fire(new MapMouseEvent(e.type, this._map, e)); } click(e, point) { if (this._mousedownPos && this._mousedownPos.dist(point) >= this._clickTolerance) return; this._map.fire(new MapMouseEvent(e.type, this._map, e)); } dblclick(e) { // If mapEvent.preventDefault() is called by the user, prevent handlers such as: // - DblClickZoom return this._firePreventable(new MapMouseEvent(e.type, this._map, e)); } mouseover(e) { this._map.fire(new MapMouseEvent(e.type, this._map, e)); } mouseout(e) { this._map.fire(new MapMouseEvent(e.type, this._map, e)); } touchstart(e) { // If mapEvent.preventDefault() is called by the user, prevent handlers such as: // - TouchPan // - TouchZoom // - TouchRotate // - TouchPitch // - TapZoom // - SwipeZoom return this._firePreventable(new MapTouchEvent(e.type, this._map, e)); } touchmove(e) { this._map.fire(new MapTouchEvent(e.type, this._map, e)); } touchend(e) { this._map.fire(new MapTouchEvent(e.type, this._map, e)); } touchcancel(e) { this._map.fire(new MapTouchEvent(e.type, this._map, e)); } _firePreventable(mapEvent) { this._map.fire(mapEvent); if (mapEvent.defaultPrevented) { // returning an object marks the handler as active and resets other handlers return {}; } } isEnabled() { return true; } isActive() { return false; } enable() { } disable() { } } class BlockableMapEventHandler { constructor(map) { this._map = map; } reset() { this._delayContextMenu = false; this._ignoreContextMenu = true; delete this._contextMenuEvent; } mousemove(e) { // mousemove map events should not be fired when interaction handlers (pan, rotate, etc) are active this._map.fire(new MapMouseEvent(e.type, this._map, e)); } mousedown() { this._delayContextMenu = true; this._ignoreContextMenu = false; } mouseup() { this._delayContextMenu = false; if (this._contextMenuEvent) { this._map.fire(new MapMouseEvent('contextmenu', this._map, this._contextMenuEvent)); delete this._contextMenuEvent; } } contextmenu(e) { if (this._delayContextMenu) { // Mac: contextmenu fired on mousedown; we save it until mouseup for consistency's sake this._contextMenuEvent = e; } else if (!this._ignoreContextMenu) { // Windows: contextmenu fired on mouseup, so fire event now this._map.fire(new MapMouseEvent(e.type, this._map, e)); } // prevent browser context menu when necessary if (this._map.listens('contextmenu')) { e.preventDefault(); } } isEnabled() { return true; } isActive() { return false; } enable() { } disable() { } } /** * @internal * Shared utilities for the Handler classes to access the correct camera state. * If Camera.transformCameraUpdate is specified or terrain is enabled, the * "desired state" of camera may differ from the state used for rendering. The * handlers need the "desired state" to track accumulated changes. */ class TransformProvider { constructor(map) { this._map = map; } get transform() { return this._map._requestedCameraState || this._map.transform; } get center() { return { lng: this.transform.center.lng, lat: this.transform.center.lat }; } get zoom() { return this.transform.zoom; } get pitch() { return this.transform.pitch; } get bearing() { return this.transform.bearing; } unproject(point) { return this.transform.pointLocation(Point$2.convert(point), this._map.terrain); } } /** * The `BoxZoomHandler` allows the user to zoom the map to fit within a bounding box. * The bounding box is defined by clicking and holding `shift` while dragging the cursor. * * @group Handlers */ class BoxZoomHandler { /** @internal */ constructor(map, options) { this._map = map; this._tr = new TransformProvider(map); this._el = map.getCanvasContainer(); this._container = map.getContainer(); this._clickTolerance = options.clickTolerance || 1; } /** * Returns a Boolean indicating whether the "box zoom" interaction is enabled. * * @returns `true` if the "box zoom" interaction is enabled. */ isEnabled() { return !!this._enabled; } /** * Returns a Boolean indicating whether the "box zoom" interaction is active, i.e. currently being used. * * @returns `true` if the "box zoom" interaction is active. */ isActive() { return !!this._active; } /** * Enables the "box zoom" interaction. * * @example * ```ts * map.boxZoom.enable(); * ``` */ enable() { if (this.isEnabled()) return; this._enabled = true; } /** * Disables the "box zoom" interaction. * * @example * ```ts * map.boxZoom.disable(); * ``` */ disable() { if (!this.isEnabled()) return; this._enabled = false; } mousedown(e, point) { if (!this.isEnabled()) return; if (!(e.shiftKey && e.button === 0)) return; DOM.disableDrag(); this._startPos = this._lastPos = point; this._active = true; } mousemoveWindow(e, point) { if (!this._active) return; const pos = point; if (this._lastPos.equals(pos) || (!this._box && pos.dist(this._startPos) < this._clickTolerance)) { return; } const p0 = this._startPos; this._lastPos = pos; if (!this._box) { this._box = DOM.create('div', 'maplibregl-boxzoom', this._container); this._container.classList.add('maplibregl-crosshair'); this._fireEvent('boxzoomstart', e); } const minX = Math.min(p0.x, pos.x), maxX = Math.max(p0.x, pos.x), minY = Math.min(p0.y, pos.y), maxY = Math.max(p0.y, pos.y); DOM.setTransform(this._box, `translate(${minX}px,${minY}px)`); this._box.style.width = `${maxX - minX}px`; this._box.style.height = `${maxY - minY}px`; } mouseupWindow(e, point) { if (!this._active) return; if (e.button !== 0) return; const p0 = this._startPos, p1 = point; this.reset(); DOM.suppressClick(); if (p0.x === p1.x && p0.y === p1.y) { this._fireEvent('boxzoomcancel', e); } else { this._map.fire(new Event('boxzoomend', { originalEvent: e })); return { cameraAnimation: map => map.fitScreenCoordinates(p0, p1, this._tr.bearing, { linear: true }) }; } } keydown(e) { if (!this._active) return; if (e.keyCode === 27) { this.reset(); this._fireEvent('boxzoomcancel', e); } } reset() { this._active = false; this._container.classList.remove('maplibregl-crosshair'); if (this._box) { DOM.remove(this._box); this._box = null; } DOM.enableDrag(); delete this._startPos; delete this._lastPos; } _fireEvent(type, e) { return this._map.fire(new Event(type, { originalEvent: e })); } } function indexTouches(touches, points) { if (touches.length !== points.length) throw new Error(`The number of touches and points are not equal - touches ${touches.length}, points ${points.length}`); const obj = {}; for (let i = 0; i < touches.length; i++) { obj[touches[i].identifier] = points[i]; } return obj; } function getCentroid(points) { const sum = new Point$2(0, 0); for (const point of points) { sum._add(point); } return sum.div(points.length); } const MAX_TAP_INTERVAL = 500; const MAX_TOUCH_TIME = 500; const MAX_DIST = 30; class SingleTapRecognizer { constructor(options) { this.reset(); this.numTouches = options.numTouches; } reset() { delete this.centroid; delete this.startTime; delete this.touches; this.aborted = false; } touchstart(e, points, mapTouches) { if (this.centroid || mapTouches.length > this.numTouches) { this.aborted = true; } if (this.aborted) { return; } if (this.startTime === undefined) { this.startTime = e.timeStamp; } if (mapTouches.length === this.numTouches) { this.centroid = getCentroid(points); this.touches = indexTouches(mapTouches, points); } } touchmove(e, points, mapTouches) { if (this.aborted || !this.centroid) return; const newTouches = indexTouches(mapTouches, points); for (const id in this.touches) { const prevPos = this.touches[id]; const pos = newTouches[id]; if (!pos || pos.dist(prevPos) > MAX_DIST) { this.aborted = true; } } } touchend(e, points, mapTouches) { if (!this.centroid || e.timeStamp - this.startTime > MAX_TOUCH_TIME) { this.aborted = true; } if (mapTouches.length === 0) { const centroid = !this.aborted && this.centroid; this.reset(); if (centroid) return centroid; } } } class TapRecognizer { constructor(options) { this.singleTap = new SingleTapRecognizer(options); this.numTaps = options.numTaps; this.reset(); } reset() { this.lastTime = Infinity; delete this.lastTap; this.count = 0; this.singleTap.reset(); } touchstart(e, points, mapTouches) { this.singleTap.touchstart(e, points, mapTouches); } touchmove(e, points, mapTouches) { this.singleTap.touchmove(e, points, mapTouches); } touchend(e, points, mapTouches) { const tap = this.singleTap.touchend(e, points, mapTouches); if (tap) { const soonEnough = e.timeStamp - this.lastTime < MAX_TAP_INTERVAL; const closeEnough = !this.lastTap || this.lastTap.dist(tap) < MAX_DIST; if (!soonEnough || !closeEnough) { this.reset(); } this.count++; this.lastTime = e.timeStamp; this.lastTap = tap; if (this.count === this.numTaps) { this.reset(); return tap; } } } } /** * A `TapZoomHandler` allows the user to zoom the map at a point by double tapping */ class TapZoomHandler { constructor(map) { this._tr = new TransformProvider(map); this._zoomIn = new TapRecognizer({ numTouches: 1, numTaps: 2 }); this._zoomOut = new TapRecognizer({ numTouches: 2, numTaps: 1 }); this.reset(); } reset() { this._active = false; this._zoomIn.reset(); this._zoomOut.reset(); } touchstart(e, points, mapTouches) { this._zoomIn.touchstart(e, points, mapTouches); this._zoomOut.touchstart(e, points, mapTouches); } touchmove(e, points, mapTouches) { this._zoomIn.touchmove(e, points, mapTouches); this._zoomOut.touchmove(e, points, mapTouches); } touchend(e, points, mapTouches) { const zoomInPoint = this._zoomIn.touchend(e, points, mapTouches); const zoomOutPoint = this._zoomOut.touchend(e, points, mapTouches); const tr = this._tr; if (zoomInPoint) { this._active = true; e.preventDefault(); setTimeout(() => this.reset(), 0); return { cameraAnimation: (map) => map.easeTo({ duration: 300, zoom: tr.zoom + 1, around: tr.unproject(zoomInPoint) }, { originalEvent: e }) }; } else if (zoomOutPoint) { this._active = true; e.preventDefault(); setTimeout(() => this.reset(), 0); return { cameraAnimation: (map) => map.easeTo({ duration: 300, zoom: tr.zoom - 1, around: tr.unproject(zoomOutPoint) }, { originalEvent: e }) }; } } touchcancel() { this.reset(); } enable() { this._enabled = true; } disable() { this._enabled = false; this.reset(); } isEnabled() { return this._enabled; } isActive() { return this._active; } } /** * A generic class to create handlers for drag events, from both mouse and touch events. */ class DragHandler { constructor(options) { this._enabled = !!options.enable; this._moveStateManager = options.moveStateManager; this._clickTolerance = options.clickTolerance || 1; this._moveFunction = options.move; this._activateOnStart = !!options.activateOnStart; options.assignEvents(this); this.reset(); } reset(e) { this._active = false; this._moved = false; delete this._lastPoint; this._moveStateManager.endMove(e); } _move(...params) { const move = this._moveFunction(...params); if (move.bearingDelta || move.pitchDelta || move.around || move.panDelta) { this._active = true; return move; } } dragStart(e, point) { if (!this.isEnabled() || this._lastPoint) return; if (!this._moveStateManager.isValidStartEvent(e)) return; this._moveStateManager.startMove(e); this._lastPoint = point['length'] ? point[0] : point; if (this._activateOnStart && this._lastPoint) this._active = true; } dragMove(e, point) { if (!this.isEnabled()) return; const lastPoint = this._lastPoint; if (!lastPoint) return; e.preventDefault(); if (!this._moveStateManager.isValidMoveEvent(e)) { this.reset(e); return; } const movePoint = point['length'] ? point[0] : point; if (!this._moved && movePoint.dist(lastPoint) < this._clickTolerance) return; this._moved = true; this._lastPoint = movePoint; return this._move(lastPoint, movePoint); } dragEnd(e) { if (!this.isEnabled() || !this._lastPoint) return; if (!this._moveStateManager.isValidEndEvent(e)) return; if (this._moved) DOM.suppressClick(); this.reset(e); } enable() { this._enabled = true; } disable() { this._enabled = false; this.reset(); } isEnabled() { return this._enabled; } isActive() { return this._active; } getClickTolerance() { return this._clickTolerance; } } const LEFT_BUTTON$1 = 0; const RIGHT_BUTTON$1 = 2; // the values for each button in MouseEvent.buttons const BUTTONS_FLAGS = { [LEFT_BUTTON$1]: 1, [RIGHT_BUTTON$1]: 2 }; function buttonNoLongerPressed(e, button) { const flag = BUTTONS_FLAGS[button]; return e.buttons === undefined || (e.buttons & flag) !== flag; } class MouseMoveStateManager { constructor(options) { this._correctEvent = options.checkCorrectEvent; } startMove(e) { const eventButton = DOM.mouseButton(e); this._eventButton = eventButton; } endMove(_e) { delete this._eventButton; } isValidStartEvent(e) { return this._correctEvent(e); } isValidMoveEvent(e) { // Some browsers don't fire a `mouseup` when the mouseup occurs outside // the window or iframe: // https://github.com/mapbox/mapbox-gl-js/issues/4622 // // If the button is no longer pressed during this `mousemove` it may have // been released outside of the window or iframe. return !buttonNoLongerPressed(e, this._eventButton); } isValidEndEvent(e) { const eventButton = DOM.mouseButton(e); return eventButton === this._eventButton; } } class OneFingerTouchMoveStateManager { constructor() { this._firstTouch = undefined; } _isOneFingerTouch(e) { return e.targetTouches.length === 1; } _isSameTouchEvent(e) { return e.targetTouches[0].identifier === this._firstTouch; } startMove(e) { const firstTouch = e.targetTouches[0].identifier; this._firstTouch = firstTouch; } endMove(_e) { delete this._firstTouch; } isValidStartEvent(e) { return this._isOneFingerTouch(e); } isValidMoveEvent(e) { return this._isOneFingerTouch(e) && this._isSameTouchEvent(e); } isValidEndEvent(e) { return this._isOneFingerTouch(e) && this._isSameTouchEvent(e); } } const LEFT_BUTTON = 0; const RIGHT_BUTTON = 2; const assignEvents$1 = (handler) => { handler.mousedown = handler.dragStart; handler.mousemoveWindow = handler.dragMove; handler.mouseup = handler.dragEnd; handler.contextmenu = (e) => { e.preventDefault(); }; }; const generateMousePanHandler = ({ enable, clickTolerance, }) => { const mouseMoveStateManager = new MouseMoveStateManager({ checkCorrectEvent: (e) => DOM.mouseButton(e) === LEFT_BUTTON && !e.ctrlKey, }); return new DragHandler({ clickTolerance, move: (lastPoint, point) => ({ around: point, panDelta: point.sub(lastPoint) }), activateOnStart: true, moveStateManager: mouseMoveStateManager, enable, assignEvents: assignEvents$1, }); }; const generateMouseRotationHandler = ({ enable, clickTolerance, bearingDegreesPerPixelMoved = 0.8 }) => { const mouseMoveStateManager = new MouseMoveStateManager({ checkCorrectEvent: (e) => (DOM.mouseButton(e) === LEFT_BUTTON && e.ctrlKey) || (DOM.mouseButton(e) === RIGHT_BUTTON), }); return new DragHandler({ clickTolerance, move: (lastPoint, point) => ({ bearingDelta: (point.x - lastPoint.x) * bearingDegreesPerPixelMoved }), // prevent browser context menu when necessary; we don't allow it with rotation // because we can't discern rotation gesture start from contextmenu on Mac moveStateManager: mouseMoveStateManager, enable, assignEvents: assignEvents$1, }); }; const generateMousePitchHandler = ({ enable, clickTolerance, pitchDegreesPerPixelMoved = -0.5 }) => { const mouseMoveStateManager = new MouseMoveStateManager({ checkCorrectEvent: (e) => (DOM.mouseButton(e) === LEFT_BUTTON && e.ctrlKey) || (DOM.mouseButton(e) === RIGHT_BUTTON), }); return new DragHandler({ clickTolerance, move: (lastPoint, point) => ({ pitchDelta: (point.y - lastPoint.y) * pitchDegreesPerPixelMoved }), // prevent browser context menu when necessary; we don't allow it with rotation // because we can't discern rotation gesture start from contextmenu on Mac moveStateManager: mouseMoveStateManager, enable, assignEvents: assignEvents$1, }); }; /** * A `TouchPanHandler` allows the user to pan the map using touch gestures. */ class TouchPanHandler { constructor(options, map) { this._clickTolerance = options.clickTolerance || 1; this._map = map; this.reset(); } reset() { this._active = false; this._touches = {}; this._sum = new Point$2(0, 0); } _shouldBePrevented(touchesCount) { const minTouches = this._map.cooperativeGestures.isEnabled() ? 2 : 1; return touchesCount < minTouches; } touchstart(e, points, mapTouches) { return this._calculateTransform(e, points, mapTouches); } touchmove(e, points, mapTouches) { if (!this._active) return; if (this._shouldBePrevented(mapTouches.length)) { this._map.cooperativeGestures.notifyGestureBlocked('touch_pan', e); return; } e.preventDefault(); return this._calculateTransform(e, points, mapTouches); } touchend(e, points, mapTouches) { this._calculateTransform(e, points, mapTouches); if (this._active && this._shouldBePrevented(mapTouches.length)) { this.reset(); } } touchcancel() { this.reset(); } _calculateTransform(e, points, mapTouches) { if (mapTouches.length > 0) this._active = true; const touches = indexTouches(mapTouches, points); const touchPointSum = new Point$2(0, 0); const touchDeltaSum = new Point$2(0, 0); let touchDeltaCount = 0; for (const identifier in touches) { const point = touches[identifier]; const prevPoint = this._touches[identifier]; if (prevPoint) { touchPointSum._add(point); touchDeltaSum._add(point.sub(prevPoint)); touchDeltaCount++; touches[identifier] = point; } } this._touches = touches; if (this._shouldBePrevented(touchDeltaCount) || !touchDeltaSum.mag()) return; const panDelta = touchDeltaSum.div(touchDeltaCount); this._sum._add(panDelta); if (this._sum.mag() < this._clickTolerance) return; const around = touchPointSum.div(touchDeltaCount); return { around, panDelta }; } enable() { this._enabled = true; } disable() { this._enabled = false; this.reset(); } isEnabled() { return this._enabled; } isActive() { return this._active; } } /** * The `TwoFingersTouchHandler`s allows the user to zoom, pitch and rotate the map using two fingers * */ class TwoFingersTouchHandler { /** @internal */ constructor() { this.reset(); } reset() { this._active = false; delete this._firstTwoTouches; } touchstart(e, points, mapTouches) { //log('touchstart', points, e.target.innerHTML, e.targetTouches.length ? e.targetTouches[0].target.innerHTML: undefined); if (this._firstTwoTouches || mapTouches.length < 2) return; this._firstTwoTouches = [ mapTouches[0].identifier, mapTouches[1].identifier ]; // implemented by child classes this._start([points[0], points[1]]); } touchmove(e, points, mapTouches) { if (!this._firstTwoTouches) return; e.preventDefault(); const [idA, idB] = this._firstTwoTouches; const a = getTouchById(mapTouches, points, idA); const b = getTouchById(mapTouches, points, idB); if (!a || !b) return; const pinchAround = this._aroundCenter ? null : a.add(b).div(2); // implemented by child classes return this._move([a, b], pinchAround, e); } touchend(e, points, mapTouches) { if (!this._firstTwoTouches) return; const [idA, idB] = this._firstTwoTouches; const a = getTouchById(mapTouches, points, idA); const b = getTouchById(mapTouches, points, idB); if (a && b) return; if (this._active) DOM.suppressClick(); this.reset(); } touchcancel() { this.reset(); } /** * Enables the "drag to pitch" interaction. * * @example * ```ts * map.touchPitch.enable(); * ``` */ enable(options) { this._enabled = true; this._aroundCenter = !!options && options.around === 'center'; } /** * Disables the "drag to pitch" interaction. * * @example * ```ts * map.touchPitch.disable(); * ``` */ disable() { this._enabled = false; this.reset(); } /** * Returns a Boolean indicating whether the "drag to pitch" interaction is enabled. * * @returns `true` if the "drag to pitch" interaction is enabled. */ isEnabled() { return !!this._enabled; } /** * Returns a Boolean indicating whether the "drag to pitch" interaction is active, i.e. currently being used. * * @returns `true` if the "drag to pitch" interaction is active. */ isActive() { return !!this._active; } } function getTouchById(mapTouches, points, identifier) { for (let i = 0; i < mapTouches.length; i++) { if (mapTouches[i].identifier === identifier) return points[i]; } return undefined; } /* ZOOM */ const ZOOM_THRESHOLD = 0.1; function getZoomDelta(distance, lastDistance) { return Math.log(distance / lastDistance) / Math.LN2; } /** * The `TwoFingersTouchHandler`s allows the user to zoom the map two fingers * * @group Handlers */ class TwoFingersTouchZoomHandler extends TwoFingersTouchHandler { reset() { super.reset(); delete this._distance; delete this._startDistance; } _start(points) { this._startDistance = this._distance = points[0].dist(points[1]); } _move(points, pinchAround) { const lastDistance = this._distance; this._distance = points[0].dist(points[1]); if (!this._active && Math.abs(getZoomDelta(this._distance, this._startDistance)) < ZOOM_THRESHOLD) return; this._active = true; return { zoomDelta: getZoomDelta(this._distance, lastDistance), pinchAround }; } } /* ROTATE */ const ROTATION_THRESHOLD = 25; // pixels along circumference of touch circle function getBearingDelta(a, b) { return a.angleWith(b) * 180 / Math.PI; } /** * The `TwoFingersTouchHandler`s allows the user to rotate the map two fingers * * @group Handlers */ class TwoFingersTouchRotateHandler extends TwoFingersTouchHandler { reset() { super.reset(); delete this._minDiameter; delete this._startVector; delete this._vector; } _start(points) { this._startVector = this._vector = points[0].sub(points[1]); this._minDiameter = points[0].dist(points[1]); } _move(points, pinchAround, _e) { const lastVector = this._vector; this._vector = points[0].sub(points[1]); if (!this._active && this._isBelowThreshold(this._vector)) return; this._active = true; return { bearingDelta: getBearingDelta(this._vector, lastVector), pinchAround }; } _isBelowThreshold(vector) { /* * The threshold before a rotation actually happens is configured in * pixels along the circumference of the circle formed by the two fingers. * This makes the threshold in degrees larger when the fingers are close * together and smaller when the fingers are far apart. * * Use the smallest diameter from the whole gesture to reduce sensitivity * when pinching in and out. */ this._minDiameter = Math.min(this._minDiameter, vector.mag()); const circumference = Math.PI * this._minDiameter; const threshold = ROTATION_THRESHOLD / circumference * 360; const bearingDeltaSinceStart = getBearingDelta(vector, this._startVector); return Math.abs(bearingDeltaSinceStart) < threshold; } } /* PITCH */ function isVertical(vector) { return Math.abs(vector.y) > Math.abs(vector.x); } const ALLOWED_SINGLE_TOUCH_TIME = 100; /** * The `TwoFingersTouchPitchHandler` allows the user to pitch the map by dragging up and down with two fingers. * * @group Handlers */ class TwoFingersTouchPitchHandler extends TwoFingersTouchHandler { constructor(map) { super(); this._currentTouchCount = 0; this._map = map; } reset() { super.reset(); this._valid = undefined; delete this._firstMove; delete this._lastPoints; } touchstart(e, points, mapTouches) { super.touchstart(e, points, mapTouches); this._currentTouchCount = mapTouches.length; } _start(points) { this._lastPoints = points; if (isVertical(points[0].sub(points[1]))) { // fingers are more horizontal than vertical this._valid = false; } } _move(points, center, e) { // If cooperative gestures is enabled, we need a 3-finger minimum for this gesture to register if (this._map.cooperativeGestures.isEnabled() && this._currentTouchCount < 3) { return; } const vectorA = points[0].sub(this._lastPoints[0]); const vectorB = points[1].sub(this._lastPoints[1]); this._valid = this.gestureBeginsVertically(vectorA, vectorB, e.timeStamp); if (!this._valid) return; this._lastPoints = points; this._active = true; const yDeltaAverage = (vectorA.y + vectorB.y) / 2; const degreesPerPixelMoved = -0.5; return { pitchDelta: yDeltaAverage * degreesPerPixelMoved }; } gestureBeginsVertically(vectorA, vectorB, timeStamp) { if (this._valid !== undefined) return this._valid; const threshold = 2; const movedA = vectorA.mag() >= threshold; const movedB = vectorB.mag() >= threshold; // neither finger has moved a meaningful amount, wait if (!movedA && !movedB) return; // One finger has moved and the other has not. // If enough time has passed, decide it is not a pitch. if (!movedA || !movedB) { if (this._firstMove === undefined) { this._firstMove = timeStamp; } if (timeStamp - this._firstMove < ALLOWED_SINGLE_TOUCH_TIME) { // still waiting for a movement from the second finger return undefined; } else { return false; } } const isSameDirection = vectorA.y > 0 === vectorB.y > 0; return isVertical(vectorA) && isVertical(vectorB) && isSameDirection; } } const defaultOptions$5 = { panStep: 100, bearingStep: 15, pitchStep: 10 }; /** * The `KeyboardHandler` allows the user to zoom, rotate, and pan the map using * the following keyboard shortcuts: * * - `=` / `+`: Increase the zoom level by 1. * - `Shift-=` / `Shift-+`: Increase the zoom level by 2. * - `-`: Decrease the zoom level by 1. * - `Shift--`: Decrease the zoom level by 2. * - Arrow keys: Pan by 100 pixels. * - `Shift+⇢`: Increase the rotation by 15 degrees. * - `Shift+⇠`: Decrease the rotation by 15 degrees. * - `Shift+⇡`: Increase the pitch by 10 degrees. * - `Shift+⇣`: Decrease the pitch by 10 degrees. * * @group Handlers */ class KeyboardHandler { /** @internal */ constructor(map) { this._tr = new TransformProvider(map); const stepOptions = defaultOptions$5; this._panStep = stepOptions.panStep; this._bearingStep = stepOptions.bearingStep; this._pitchStep = stepOptions.pitchStep; this._rotationDisabled = false; } reset() { this._active = false; } keydown(e) { if (e.altKey || e.ctrlKey || e.metaKey) return; let zoomDir = 0; let bearingDir = 0; let pitchDir = 0; let xDir = 0; let yDir = 0; switch (e.keyCode) { case 61: case 107: case 171: case 187: zoomDir = 1; break; case 189: case 109: case 173: zoomDir = -1; break; case 37: if (e.shiftKey) { bearingDir = -1; } else { e.preventDefault(); xDir = -1; } break; case 39: if (e.shiftKey) { bearingDir = 1; } else { e.preventDefault(); xDir = 1; } break; case 38: if (e.shiftKey) { pitchDir = 1; } else { e.preventDefault(); yDir = -1; } break; case 40: if (e.shiftKey) { pitchDir = -1; } else { e.preventDefault(); yDir = 1; } break; default: return; } if (this._rotationDisabled) { bearingDir = 0; pitchDir = 0; } return { cameraAnimation: (map) => { const tr = this._tr; map.easeTo({ duration: 300, easeId: 'keyboardHandler', easing: easeOut, zoom: zoomDir ? Math.round(tr.zoom) + zoomDir * (e.shiftKey ? 2 : 1) : tr.zoom, bearing: tr.bearing + bearingDir * this._bearingStep, pitch: tr.pitch + pitchDir * this._pitchStep, offset: [-xDir * this._panStep, -yDir * this._panStep], center: tr.center }, { originalEvent: e }); } }; } /** * Enables the "keyboard rotate and zoom" interaction. * * @example * ```ts * map.keyboard.enable(); * ``` */ enable() { this._enabled = true; } /** * Disables the "keyboard rotate and zoom" interaction. * * @example * ```ts * map.keyboard.disable(); * ``` */ disable() { this._enabled = false; this.reset(); } /** * Returns a Boolean indicating whether the "keyboard rotate and zoom" * interaction is enabled. * * @returns `true` if the "keyboard rotate and zoom" * interaction is enabled. */ isEnabled() { return this._enabled; } /** * Returns true if the handler is enabled and has detected the start of a * zoom/rotate gesture. * * @returns `true` if the handler is enabled and has detected the * start of a zoom/rotate gesture. */ isActive() { return this._active; } /** * Disables the "keyboard pan/rotate" interaction, leaving the * "keyboard zoom" interaction enabled. * * @example * ```ts * map.keyboard.disableRotation(); * ``` */ disableRotation() { this._rotationDisabled = true; } /** * Enables the "keyboard pan/rotate" interaction. * * @example * ```ts * map.keyboard.enable(); * map.keyboard.enableRotation(); * ``` */ enableRotation() { this._rotationDisabled = false; } } function easeOut(t) { return t * (2 - t); } // deltaY value for mouse scroll wheel identification const wheelZoomDelta = 4.000244140625; // These magic numbers control the rate of zoom. Trackpad events fire at a greater // frequency than mouse scroll wheel, so reduce the zoom rate per wheel tick const defaultZoomRate = 1 / 100; const wheelZoomRate = 1 / 450; // upper bound on how much we scale the map in any single render frame; this // is used to limit zoom rate in the case of very fast scrolling const maxScalePerFrame = 2; /** * The `ScrollZoomHandler` allows the user to zoom the map by scrolling. * * @group Handlers */ class ScrollZoomHandler { /** @internal */ constructor(map, triggerRenderFrame) { this._onTimeout = (initialEvent) => { this._type = 'wheel'; this._delta -= this._lastValue; if (!this._active) { this._start(initialEvent); } }; this._map = map; this._tr = new TransformProvider(map); this._triggerRenderFrame = triggerRenderFrame; this._delta = 0; this._defaultZoomRate = defaultZoomRate; this._wheelZoomRate = wheelZoomRate; } /** * Set the zoom rate of a trackpad * @param zoomRate - 1/100 The rate used to scale trackpad movement to a zoom value. * @example * Speed up trackpad zoom * ```ts * map.scrollZoom.setZoomRate(1/25); * ``` */ setZoomRate(zoomRate) { this._defaultZoomRate = zoomRate; } /** * Set the zoom rate of a mouse wheel * @param wheelZoomRate - 1/450 The rate used to scale mouse wheel movement to a zoom value. * @example * Slow down zoom of mouse wheel * ```ts * map.scrollZoom.setWheelZoomRate(1/600); * ``` */ setWheelZoomRate(wheelZoomRate) { this._wheelZoomRate = wheelZoomRate; } /** * Returns a Boolean indicating whether the "scroll to zoom" interaction is enabled. * @returns `true` if the "scroll to zoom" interaction is enabled. */ isEnabled() { return !!this._enabled; } /* * Active state is turned on and off with every scroll wheel event and is set back to false before the map * render is called, so _active is not a good candidate for determining if a scroll zoom animation is in * progress. */ isActive() { return !!this._active || this._finishTimeout !== undefined; } isZooming() { return !!this._zooming; } /** * Enables the "scroll to zoom" interaction. * * @param options - Options object. * @example * ```ts * map.scrollZoom.enable(); * map.scrollZoom.enable({ around: 'center' }) * ``` */ enable(options) { if (this.isEnabled()) return; this._enabled = true; this._aroundCenter = !!options && options.around === 'center'; } /** * Disables the "scroll to zoom" interaction. * * @example * ```ts * map.scrollZoom.disable(); * ``` */ disable() { if (!this.isEnabled()) return; this._enabled = false; } /** * Determines whether or not the gesture is blocked due to cooperativeGestures. */ _shouldBePrevented(e) { if (!this._map.cooperativeGestures.isEnabled()) { return false; } const isTrackpadPinch = e.ctrlKey; const isBypassed = isTrackpadPinch || this._map.cooperativeGestures.isBypassed(e); return !isBypassed; } wheel(e) { if (!this.isEnabled()) return; if (this._shouldBePrevented(e)) { this._map.cooperativeGestures.notifyGestureBlocked('wheel_zoom', e); return; } let value = e.deltaMode === WheelEvent.DOM_DELTA_LINE ? e.deltaY * 40 : e.deltaY; const now = browser.now(), timeDelta = now - (this._lastWheelEventTime || 0); this._lastWheelEventTime = now; if (value !== 0 && (value % wheelZoomDelta) === 0) { // This one is definitely a mouse wheel event. this._type = 'wheel'; } else if (value !== 0 && Math.abs(value) < 4) { // This one is definitely a trackpad event because it is so small. this._type = 'trackpad'; } else if (timeDelta > 400) { // This is likely a new scroll action. this._type = null; this._lastValue = value; // Start a timeout in case this was a singular event, and delay it by up to 40ms. this._timeout = setTimeout(this._onTimeout, 40, e); } else if (!this._type) { // This is a repeating event, but we don't know the type of event just yet. // If the delta per time is small, we assume it's a fast trackpad; otherwise we switch into wheel mode. this._type = (Math.abs(timeDelta * value) < 200) ? 'trackpad' : 'wheel'; // Make sure our delayed event isn't fired again, because we accumulate // the previous event (which was less than 40ms ago) into this event. if (this._timeout) { clearTimeout(this._timeout); this._timeout = null; value += this._lastValue; } } // Slow down zoom if shift key is held for more precise zooming if (e.shiftKey && value) value = value / 4; // Only fire the callback if we actually know what type of scrolling device the user uses. if (this._type) { this._lastWheelEvent = e; this._delta -= value; if (!this._active) { this._start(e); } } e.preventDefault(); } _start(e) { if (!this._delta) return; if (this._frameId) { this._frameId = null; } this._active = true; if (!this.isZooming()) { this._zooming = true; } if (this._finishTimeout) { clearTimeout(this._finishTimeout); delete this._finishTimeout; } const pos = DOM.mousePos(this._map.getCanvas(), e); const tr = this._tr; if (pos.y > tr.transform.height / 2 - tr.transform.getHorizon()) { this._around = LngLat.convert(this._aroundCenter ? tr.center : tr.unproject(pos)); } else { // Do not use current cursor position if above the horizon to avoid 'unproject' this point // as it is not mapped into 'coords' framebuffer or inversible with 'pixelMatrixInverse'. this._around = LngLat.convert(tr.center); } this._aroundPoint = tr.transform.locationPoint(this._around); if (!this._frameId) { this._frameId = true; this._triggerRenderFrame(); } } renderFrame() { if (!this._frameId) return; this._frameId = null; if (!this.isActive()) return; const tr = this._tr.transform; // if we've had scroll events since the last render frame, consume the // accumulated delta, and update the target zoom level accordingly if (this._delta !== 0) { // For trackpad events and single mouse wheel ticks, use the default zoom rate const zoomRate = (this._type === 'wheel' && Math.abs(this._delta) > wheelZoomDelta) ? this._wheelZoomRate : this._defaultZoomRate; // Scale by sigmoid of scroll wheel delta. let scale = maxScalePerFrame / (1 + Math.exp(-Math.abs(this._delta * zoomRate))); if (this._delta < 0 && scale !== 0) { scale = 1 / scale; } const fromScale = typeof this._targetZoom === 'number' ? tr.zoomScale(this._targetZoom) : tr.scale; this._targetZoom = Math.min(tr.maxZoom, Math.max(tr.minZoom, tr.scaleZoom(fromScale * scale))); // if this is a mouse wheel, refresh the starting zoom and easing // function we're using to smooth out the zooming between wheel // events if (this._type === 'wheel') { this._startZoom = tr.zoom; this._easing = this._smoothOutEasing(200); } this._delta = 0; } const targetZoom = typeof this._targetZoom === 'number' ? this._targetZoom : tr.zoom; const startZoom = this._startZoom; const easing = this._easing; let finished = false; let zoom; const lastWheelEventTimeDiff = browser.now() - this._lastWheelEventTime; if (this._type === 'wheel' && startZoom && easing && lastWheelEventTimeDiff) { const t = Math.min(lastWheelEventTimeDiff / 200, 1); const k = easing(t); zoom = interpolate.number(startZoom, targetZoom, k); if (t < 1) { if (!this._frameId) { this._frameId = true; } } else { finished = true; } } else { zoom = targetZoom; finished = true; } this._active = true; if (finished) { this._active = false; this._finishTimeout = setTimeout(() => { this._zooming = false; this._triggerRenderFrame(); delete this._targetZoom; delete this._finishTimeout; }, 200); } return { noInertia: true, needsRenderFrame: !finished, zoomDelta: zoom - tr.zoom, around: this._aroundPoint, originalEvent: this._lastWheelEvent }; } _smoothOutEasing(duration) { let easing = defaultEasing; if (this._prevEase) { const currentEase = this._prevEase; const t = (browser.now() - currentEase.start) / currentEase.duration; const speed = currentEase.easing(t + 0.01) - currentEase.easing(t); // Quick hack to make new bezier that is continuous with last const x = 0.27 / Math.sqrt(speed * speed + 0.0001) * 0.01; const y = Math.sqrt(0.27 * 0.27 - x * x); easing = bezier$1(x, y, 0.25, 1); } this._prevEase = { start: browser.now(), duration, easing }; return easing; } reset() { this._active = false; this._zooming = false; delete this._targetZoom; if (this._finishTimeout) { clearTimeout(this._finishTimeout); delete this._finishTimeout; } } } /** * The `DoubleClickZoomHandler` allows the user to zoom the map at a point by * double clicking or double tapping. * * @group Handlers */ class DoubleClickZoomHandler { /** @internal */ constructor(clickZoom, TapZoom) { this._clickZoom = clickZoom; this._tapZoom = TapZoom; } /** * Enables the "double click to zoom" interaction. * * @example * ```ts * map.doubleClickZoom.enable(); * ``` */ enable() { this._clickZoom.enable(); this._tapZoom.enable(); } /** * Disables the "double click to zoom" interaction. * * @example * ```ts * map.doubleClickZoom.disable(); * ``` */ disable() { this._clickZoom.disable(); this._tapZoom.disable(); } /** * Returns a Boolean indicating whether the "double click to zoom" interaction is enabled. * * @returns `true` if the "double click to zoom" interaction is enabled. */ isEnabled() { return this._clickZoom.isEnabled() && this._tapZoom.isEnabled(); } /** * Returns a Boolean indicating whether the "double click to zoom" interaction is active, i.e. currently being used. * * @returns `true` if the "double click to zoom" interaction is active. */ isActive() { return this._clickZoom.isActive() || this._tapZoom.isActive(); } } /** * The `ClickZoomHandler` allows the user to zoom the map at a point by double clicking * It is used by other handlers */ class ClickZoomHandler { /** @internal */ constructor(map) { this._tr = new TransformProvider(map); this.reset(); } reset() { this._active = false; } dblclick(e, point) { e.preventDefault(); return { cameraAnimation: (map) => { map.easeTo({ duration: 300, zoom: this._tr.zoom + (e.shiftKey ? -1 : 1), around: this._tr.unproject(point) }, { originalEvent: e }); } }; } enable() { this._enabled = true; } disable() { this._enabled = false; this.reset(); } isEnabled() { return this._enabled; } isActive() { return this._active; } } /** * A `TapDragZoomHandler` allows the user to zoom the map at a point by double tapping. It also allows the user pan the map by dragging. */ class TapDragZoomHandler { constructor() { this._tap = new TapRecognizer({ numTouches: 1, numTaps: 1 }); this.reset(); } reset() { this._active = false; delete this._swipePoint; delete this._swipeTouch; delete this._tapTime; delete this._tapPoint; this._tap.reset(); } touchstart(e, points, mapTouches) { if (this._swipePoint) return; if (!this._tapTime) { this._tap.touchstart(e, points, mapTouches); } else { const swipePoint = points[0]; const soonEnough = e.timeStamp - this._tapTime < MAX_TAP_INTERVAL; const closeEnough = this._tapPoint.dist(swipePoint) < MAX_DIST; if (!soonEnough || !closeEnough) { this.reset(); } else if (mapTouches.length > 0) { this._swipePoint = swipePoint; this._swipeTouch = mapTouches[0].identifier; } } } touchmove(e, points, mapTouches) { if (!this._tapTime) { this._tap.touchmove(e, points, mapTouches); } else if (this._swipePoint) { if (mapTouches[0].identifier !== this._swipeTouch) { return; } const newSwipePoint = points[0]; const dist = newSwipePoint.y - this._swipePoint.y; this._swipePoint = newSwipePoint; e.preventDefault(); this._active = true; return { zoomDelta: dist / 128 }; } } touchend(e, points, mapTouches) { if (!this._tapTime) { const point = this._tap.touchend(e, points, mapTouches); if (point) { this._tapTime = e.timeStamp; this._tapPoint = point; } } else if (this._swipePoint) { if (mapTouches.length === 0) { this.reset(); } } } touchcancel() { this.reset(); } enable() { this._enabled = true; } disable() { this._enabled = false; this.reset(); } isEnabled() { return this._enabled; } isActive() { return this._active; } } /** * The `DragPanHandler` allows the user to pan the map by clicking and dragging * the cursor. * * @group Handlers */ class DragPanHandler { /** @internal */ constructor(el, mousePan, touchPan) { this._el = el; this._mousePan = mousePan; this._touchPan = touchPan; } /** * Enables the "drag to pan" interaction. * * @param options - Options object * @example * ```ts * map.dragPan.enable(); * map.dragPan.enable({ * linearity: 0.3, * easing: bezier(0, 0, 0.3, 1), * maxSpeed: 1400, * deceleration: 2500, * }); * ``` */ enable(options) { this._inertiaOptions = options || {}; this._mousePan.enable(); this._touchPan.enable(); this._el.classList.add('maplibregl-touch-drag-pan'); } /** * Disables the "drag to pan" interaction. * * @example * ```ts * map.dragPan.disable(); * ``` */ disable() { this._mousePan.disable(); this._touchPan.disable(); this._el.classList.remove('maplibregl-touch-drag-pan'); } /** * Returns a Boolean indicating whether the "drag to pan" interaction is enabled. * * @returns `true` if the "drag to pan" interaction is enabled. */ isEnabled() { return this._mousePan.isEnabled() && this._touchPan.isEnabled(); } /** * Returns a Boolean indicating whether the "drag to pan" interaction is active, i.e. currently being used. * * @returns `true` if the "drag to pan" interaction is active. */ isActive() { return this._mousePan.isActive() || this._touchPan.isActive(); } } /** * The `DragRotateHandler` allows the user to rotate the map by clicking and * dragging the cursor while holding the right mouse button or `ctrl` key. * * @group Handlers */ class DragRotateHandler { /** @internal */ constructor(options, mouseRotate, mousePitch) { this._pitchWithRotate = options.pitchWithRotate; this._mouseRotate = mouseRotate; this._mousePitch = mousePitch; } /** * Enables the "drag to rotate" interaction. * * @example * ```ts * map.dragRotate.enable(); * ``` */ enable() { this._mouseRotate.enable(); if (this._pitchWithRotate) this._mousePitch.enable(); } /** * Disables the "drag to rotate" interaction. * * @example * ```ts * map.dragRotate.disable(); * ``` */ disable() { this._mouseRotate.disable(); this._mousePitch.disable(); } /** * Returns a Boolean indicating whether the "drag to rotate" interaction is enabled. * * @returns `true` if the "drag to rotate" interaction is enabled. */ isEnabled() { return this._mouseRotate.isEnabled() && (!this._pitchWithRotate || this._mousePitch.isEnabled()); } /** * Returns a Boolean indicating whether the "drag to rotate" interaction is active, i.e. currently being used. * * @returns `true` if the "drag to rotate" interaction is active. */ isActive() { return this._mouseRotate.isActive() || this._mousePitch.isActive(); } } /** * The `TwoFingersTouchZoomRotateHandler` allows the user to zoom and rotate the map by * pinching on a touchscreen. * * They can zoom with one finger by double tapping and dragging. On the second tap, * hold the finger down and drag up or down to zoom in or out. * * @group Handlers */ class TwoFingersTouchZoomRotateHandler { /** @internal */ constructor(el, touchZoom, touchRotate, tapDragZoom) { this._el = el; this._touchZoom = touchZoom; this._touchRotate = touchRotate; this._tapDragZoom = tapDragZoom; this._rotationDisabled = false; this._enabled = true; } /** * Enables the "pinch to rotate and zoom" interaction. * * @param options - Options object. * * @example * ```ts * map.touchZoomRotate.enable(); * map.touchZoomRotate.enable({ around: 'center' }); * ``` */ enable(options) { this._touchZoom.enable(options); if (!this._rotationDisabled) this._touchRotate.enable(options); this._tapDragZoom.enable(); this._el.classList.add('maplibregl-touch-zoom-rotate'); } /** * Disables the "pinch to rotate and zoom" interaction. * * @example * ```ts * map.touchZoomRotate.disable(); * ``` */ disable() { this._touchZoom.disable(); this._touchRotate.disable(); this._tapDragZoom.disable(); this._el.classList.remove('maplibregl-touch-zoom-rotate'); } /** * Returns a Boolean indicating whether the "pinch to rotate and zoom" interaction is enabled. * * @returns `true` if the "pinch to rotate and zoom" interaction is enabled. */ isEnabled() { return this._touchZoom.isEnabled() && (this._rotationDisabled || this._touchRotate.isEnabled()) && this._tapDragZoom.isEnabled(); } /** * Returns true if the handler is enabled and has detected the start of a zoom/rotate gesture. * * @returns `true` if the handler is active, `false` otherwise */ isActive() { return this._touchZoom.isActive() || this._touchRotate.isActive() || this._tapDragZoom.isActive(); } /** * Disables the "pinch to rotate" interaction, leaving the "pinch to zoom" * interaction enabled. * * @example * ```ts * map.touchZoomRotate.disableRotation(); * ``` */ disableRotation() { this._rotationDisabled = true; this._touchRotate.disable(); } /** * Enables the "pinch to rotate" interaction. * * @example * ```ts * map.touchZoomRotate.enable(); * map.touchZoomRotate.enableRotation(); * ``` */ enableRotation() { this._rotationDisabled = false; if (this._touchZoom.isEnabled()) this._touchRotate.enable(); } } /** * A `CooperativeGestureHandler` is a control that adds cooperative gesture info when user tries to zoom in/out. * * When the CooperativeGestureHandler blocks a gesture, it will emit a `cooperativegestureprevented` event. * * @group Handlers * * @example * ```ts * const map = new Map({ * cooperativeGestures: true * }); * ``` * @see [Example: cooperative gestures](https://maplibre.org/maplibre-gl-js/docs/examples/cooperative-gestures/) **/ class CooperativeGesturesHandler { constructor(map, options) { /** * This is the key that will allow to bypass the cooperative gesture protection */ this._bypassKey = navigator.userAgent.indexOf('Mac') !== -1 ? 'metaKey' : 'ctrlKey'; this._map = map; this._options = options; this._enabled = false; } isActive() { return false; } reset() { } _setupUI() { if (this._container) return; const mapCanvasContainer = this._map.getCanvasContainer(); // Add a cooperative gestures class (enable touch-action: pan-x pan-y;) mapCanvasContainer.classList.add('maplibregl-cooperative-gestures'); this._container = DOM.create('div', 'maplibregl-cooperative-gesture-screen', mapCanvasContainer); let desktopMessage = this._map._getUIString('CooperativeGesturesHandler.WindowsHelpText'); if (this._bypassKey === 'metaKey') { desktopMessage = this._map._getUIString('CooperativeGesturesHandler.MacHelpText'); } const mobileMessage = this._map._getUIString('CooperativeGesturesHandler.MobileHelpText'); // Create and append the desktop message div const desktopDiv = document.createElement('div'); desktopDiv.className = 'maplibregl-desktop-message'; desktopDiv.textContent = desktopMessage; this._container.appendChild(desktopDiv); // Create and append the mobile message div const mobileDiv = document.createElement('div'); mobileDiv.className = 'maplibregl-mobile-message'; mobileDiv.textContent = mobileMessage; this._container.appendChild(mobileDiv); // Remove cooperative gesture screen from the accessibility tree since screenreaders cannot interact with the map using gestures this._container.setAttribute('aria-hidden', 'true'); } _destroyUI() { if (this._container) { DOM.remove(this._container); const mapCanvasContainer = this._map.getCanvasContainer(); mapCanvasContainer.classList.remove('maplibregl-cooperative-gestures'); } delete this._container; } enable() { this._setupUI(); this._enabled = true; } disable() { this._enabled = false; this._destroyUI(); } isEnabled() { return this._enabled; } isBypassed(event) { return event[this._bypassKey]; } notifyGestureBlocked(gestureType, originalEvent) { if (!this._enabled) return; // notify subscribers that a cooperative gesture was prevented this._map.fire(new Event('cooperativegestureprevented', { gestureType, originalEvent })); // Alert user how to scroll/pan this._container.classList.add('maplibregl-show'); setTimeout(() => { this._container.classList.remove('maplibregl-show'); }, 100); } } const isMoving = (p) => p.zoom || p.drag || p.pitch || p.rotate; class RenderFrameEvent extends Event { } function hasChange(result) { return (result.panDelta && result.panDelta.mag()) || result.zoomDelta || result.bearingDelta || result.pitchDelta; } class HandlerManager { constructor(map, options) { this.handleWindowEvent = (e) => { this.handleEvent(e, `${e.type}Window`); }; this.handleEvent = (e, eventName) => { if (e.type === 'blur') { this.stop(true); return; } this._updatingCamera = true; const inputEvent = e.type === 'renderFrame' ? undefined : e; /* * We don't call e.preventDefault() for any events by default. * Handlers are responsible for calling it where necessary. */ const mergedHandlerResult = { needsRenderFrame: false }; const eventsInProgress = {}; const activeHandlers = {}; const eventTouches = e.touches; const mapTouches = eventTouches ? this._getMapTouches(eventTouches) : undefined; const points = mapTouches ? DOM.touchPos(this._map.getCanvas(), mapTouches) : DOM.mousePos(this._map.getCanvas(), e); for (const { handlerName, handler, allowed } of this._handlers) { if (!handler.isEnabled()) continue; let data; if (this._blockedByActive(activeHandlers, allowed, handlerName)) { handler.reset(); } else { if (handler[eventName || e.type]) { data = handler[eventName || e.type](e, points, mapTouches); this.mergeHandlerResult(mergedHandlerResult, eventsInProgress, data, handlerName, inputEvent); if (data && data.needsRenderFrame) { this._triggerRenderFrame(); } } } if (data || handler.isActive()) { activeHandlers[handlerName] = handler; } } const deactivatedHandlers = {}; for (const name in this._previousActiveHandlers) { if (!activeHandlers[name]) { deactivatedHandlers[name] = inputEvent; } } this._previousActiveHandlers = activeHandlers; if (Object.keys(deactivatedHandlers).length || hasChange(mergedHandlerResult)) { this._changes.push([mergedHandlerResult, eventsInProgress, deactivatedHandlers]); this._triggerRenderFrame(); } if (Object.keys(activeHandlers).length || hasChange(mergedHandlerResult)) { this._map._stop(true); } this._updatingCamera = false; const { cameraAnimation } = mergedHandlerResult; if (cameraAnimation) { this._inertia.clear(); this._fireEvents({}, {}, true); this._changes = []; cameraAnimation(this._map); } }; this._map = map; this._el = this._map.getCanvasContainer(); this._handlers = []; this._handlersById = {}; this._changes = []; this._inertia = new HandlerInertia(map); this._bearingSnap = options.bearingSnap; this._previousActiveHandlers = {}; // Track whether map is currently moving, to compute start/move/end events this._eventsInProgress = {}; this._addDefaultHandlers(options); const el = this._el; this._listeners = [ // This needs to be `passive: true` so that a double tap fires two // pairs of touchstart/end events in iOS Safari 13. If this is set to // `passive: false` then the second pair of events is only fired if // preventDefault() is called on the first touchstart. Calling preventDefault() // undesirably prevents click events. [el, 'touchstart', { passive: true }], // This needs to be `passive: false` so that scrolls and pinches can be // prevented in browsers that don't support `touch-actions: none`, for example iOS Safari 12. [el, 'touchmove', { passive: false }], [el, 'touchend', undefined], [el, 'touchcancel', undefined], [el, 'mousedown', undefined], [el, 'mousemove', undefined], [el, 'mouseup', undefined], // Bind window-level event listeners for move and up/end events. In the absence of // the pointer capture API, which is not supported by all necessary platforms, // window-level event listeners give us the best shot at capturing events that // fall outside the map canvas element. Use `{capture: true}` for the move event // to prevent map move events from being fired during a drag. [document, 'mousemove', { capture: true }], [document, 'mouseup', undefined], [el, 'mouseover', undefined], [el, 'mouseout', undefined], [el, 'dblclick', undefined], [el, 'click', undefined], [el, 'keydown', { capture: false }], [el, 'keyup', undefined], [el, 'wheel', { passive: false }], [el, 'contextmenu', undefined], [window, 'blur', undefined] ]; for (const [target, type, listenerOptions] of this._listeners) { DOM.addEventListener(target, type, target === document ? this.handleWindowEvent : this.handleEvent, listenerOptions); } } destroy() { for (const [target, type, listenerOptions] of this._listeners) { DOM.removeEventListener(target, type, target === document ? this.handleWindowEvent : this.handleEvent, listenerOptions); } } _addDefaultHandlers(options) { const map = this._map; const el = map.getCanvasContainer(); this._add('mapEvent', new MapEventHandler(map, options)); const boxZoom = map.boxZoom = new BoxZoomHandler(map, options); this._add('boxZoom', boxZoom); if (options.interactive && options.boxZoom) { boxZoom.enable(); } const cooperativeGestures = map.cooperativeGestures = new CooperativeGesturesHandler(map, options.cooperativeGestures); this._add('cooperativeGestures', cooperativeGestures); if (options.cooperativeGestures) { cooperativeGestures.enable(); } const tapZoom = new TapZoomHandler(map); const clickZoom = new ClickZoomHandler(map); map.doubleClickZoom = new DoubleClickZoomHandler(clickZoom, tapZoom); this._add('tapZoom', tapZoom); this._add('clickZoom', clickZoom); if (options.interactive && options.doubleClickZoom) { map.doubleClickZoom.enable(); } const tapDragZoom = new TapDragZoomHandler(); this._add('tapDragZoom', tapDragZoom); const touchPitch = map.touchPitch = new TwoFingersTouchPitchHandler(map); this._add('touchPitch', touchPitch); if (options.interactive && options.touchPitch) { map.touchPitch.enable(options.touchPitch); } const mouseRotate = generateMouseRotationHandler(options); const mousePitch = generateMousePitchHandler(options); map.dragRotate = new DragRotateHandler(options, mouseRotate, mousePitch); this._add('mouseRotate', mouseRotate, ['mousePitch']); this._add('mousePitch', mousePitch, ['mouseRotate']); if (options.interactive && options.dragRotate) { map.dragRotate.enable(); } const mousePan = generateMousePanHandler(options); const touchPan = new TouchPanHandler(options, map); map.dragPan = new DragPanHandler(el, mousePan, touchPan); this._add('mousePan', mousePan); this._add('touchPan', touchPan, ['touchZoom', 'touchRotate']); if (options.interactive && options.dragPan) { map.dragPan.enable(options.dragPan); } const touchRotate = new TwoFingersTouchRotateHandler(); const touchZoom = new TwoFingersTouchZoomHandler(); map.touchZoomRotate = new TwoFingersTouchZoomRotateHandler(el, touchZoom, touchRotate, tapDragZoom); this._add('touchRotate', touchRotate, ['touchPan', 'touchZoom']); this._add('touchZoom', touchZoom, ['touchPan', 'touchRotate']); if (options.interactive && options.touchZoomRotate) { map.touchZoomRotate.enable(options.touchZoomRotate); } const scrollZoom = map.scrollZoom = new ScrollZoomHandler(map, () => this._triggerRenderFrame()); this._add('scrollZoom', scrollZoom, ['mousePan']); if (options.interactive && options.scrollZoom) { map.scrollZoom.enable(options.scrollZoom); } const keyboard = map.keyboard = new KeyboardHandler(map); this._add('keyboard', keyboard); if (options.interactive && options.keyboard) { map.keyboard.enable(); } this._add('blockableMapEvent', new BlockableMapEventHandler(map)); } _add(handlerName, handler, allowed) { this._handlers.push({ handlerName, handler, allowed }); this._handlersById[handlerName] = handler; } stop(allowEndAnimation) { // do nothing if this method was triggered by a gesture update if (this._updatingCamera) return; for (const { handler } of this._handlers) { handler.reset(); } this._inertia.clear(); this._fireEvents({}, {}, allowEndAnimation); this._changes = []; } isActive() { for (const { handler } of this._handlers) { if (handler.isActive()) return true; } return false; } isZooming() { return !!this._eventsInProgress.zoom || this._map.scrollZoom.isZooming(); } isRotating() { return !!this._eventsInProgress.rotate; } isMoving() { return Boolean(isMoving(this._eventsInProgress)) || this.isZooming(); } _blockedByActive(activeHandlers, allowed, myName) { for (const name in activeHandlers) { if (name === myName) continue; if (!allowed || allowed.indexOf(name) < 0) { return true; } } return false; } _getMapTouches(touches) { const mapTouches = []; for (const t of touches) { const target = t.target; if (this._el.contains(target)) { mapTouches.push(t); } } return mapTouches; } mergeHandlerResult(mergedHandlerResult, eventsInProgress, handlerResult, name, e) { if (!handlerResult) return; extend(mergedHandlerResult, handlerResult); const eventData = { handlerName: name, originalEvent: handlerResult.originalEvent || e }; // track which handler changed which camera property if (handlerResult.zoomDelta !== undefined) { eventsInProgress.zoom = eventData; } if (handlerResult.panDelta !== undefined) { eventsInProgress.drag = eventData; } if (handlerResult.pitchDelta !== undefined) { eventsInProgress.pitch = eventData; } if (handlerResult.bearingDelta !== undefined) { eventsInProgress.rotate = eventData; } } _applyChanges() { const combined = {}; const combinedEventsInProgress = {}; const combinedDeactivatedHandlers = {}; for (const [change, eventsInProgress, deactivatedHandlers] of this._changes) { if (change.panDelta) combined.panDelta = (combined.panDelta || new Point$2(0, 0))._add(change.panDelta); if (change.zoomDelta) combined.zoomDelta = (combined.zoomDelta || 0) + change.zoomDelta; if (change.bearingDelta) combined.bearingDelta = (combined.bearingDelta || 0) + change.bearingDelta; if (change.pitchDelta) combined.pitchDelta = (combined.pitchDelta || 0) + change.pitchDelta; if (change.around !== undefined) combined.around = change.around; if (change.pinchAround !== undefined) combined.pinchAround = change.pinchAround; if (change.noInertia) combined.noInertia = change.noInertia; extend(combinedEventsInProgress, eventsInProgress); extend(combinedDeactivatedHandlers, deactivatedHandlers); } this._updateMapTransform(combined, combinedEventsInProgress, combinedDeactivatedHandlers); this._changes = []; } _updateMapTransform(combinedResult, combinedEventsInProgress, deactivatedHandlers) { const map = this._map; const tr = map._getTransformForUpdate(); const terrain = map.terrain; if (!hasChange(combinedResult) && !(terrain && this._terrainMovement)) { return this._fireEvents(combinedEventsInProgress, deactivatedHandlers, true); } let { panDelta, zoomDelta, bearingDelta, pitchDelta, around, pinchAround } = combinedResult; if (pinchAround !== undefined) { around = pinchAround; } // stop any ongoing camera animations (easeTo, flyTo) map._stop(true); around = around || map.transform.centerPoint; const loc = tr.pointLocation(panDelta ? around.sub(panDelta) : around); if (bearingDelta) tr.bearing += bearingDelta; if (pitchDelta) tr.pitch += pitchDelta; if (zoomDelta) tr.zoom += zoomDelta; if (!terrain) { tr.setLocationAtPoint(loc, around); } else { // when 3d-terrain is enabled act a little different: // - dragging do not drag the picked point itself, instead it drags the map by pixel-delta. // With this approach it is no longer possible to pick a point from somewhere near // the horizon to the center in one move. // So this logic avoids the problem, that in such cases you easily loose orientation. if (!this._terrainMovement && (combinedEventsInProgress.drag || combinedEventsInProgress.zoom)) { // When starting to drag or move, flag it and register moveend to clear flagging this._terrainMovement = true; this._map._elevationFreeze = true; tr.setLocationAtPoint(loc, around); } else if (combinedEventsInProgress.drag && this._terrainMovement) { // drag map tr.center = tr.pointLocation(tr.centerPoint.sub(panDelta)); } else { tr.setLocationAtPoint(loc, around); } } map._applyUpdatedTransform(tr); this._map._update(); if (!combinedResult.noInertia) this._inertia.record(combinedResult); this._fireEvents(combinedEventsInProgress, deactivatedHandlers, true); } _fireEvents(newEventsInProgress, deactivatedHandlers, allowEndAnimation) { const wasMoving = isMoving(this._eventsInProgress); const nowMoving = isMoving(newEventsInProgress); const startEvents = {}; for (const eventName in newEventsInProgress) { const { originalEvent } = newEventsInProgress[eventName]; if (!this._eventsInProgress[eventName]) { startEvents[`${eventName}start`] = originalEvent; } this._eventsInProgress[eventName] = newEventsInProgress[eventName]; } // fire start events only after this._eventsInProgress has been updated if (!wasMoving && nowMoving) { this._fireEvent('movestart', nowMoving.originalEvent); } for (const name in startEvents) { this._fireEvent(name, startEvents[name]); } if (nowMoving) { this._fireEvent('move', nowMoving.originalEvent); } for (const eventName in newEventsInProgress) { const { originalEvent } = newEventsInProgress[eventName]; this._fireEvent(eventName, originalEvent); } const endEvents = {}; let originalEndEvent; for (const eventName in this._eventsInProgress) { const { handlerName, originalEvent } = this._eventsInProgress[eventName]; if (!this._handlersById[handlerName].isActive()) { delete this._eventsInProgress[eventName]; originalEndEvent = deactivatedHandlers[handlerName] || originalEvent; endEvents[`${eventName}end`] = originalEndEvent; } } for (const name in endEvents) { this._fireEvent(name, endEvents[name]); } const stillMoving = isMoving(this._eventsInProgress); const finishedMoving = (wasMoving || nowMoving) && !stillMoving; if (finishedMoving && this._terrainMovement) { this._map._elevationFreeze = false; this._terrainMovement = false; const tr = this._map._getTransformForUpdate(); tr.recalculateZoom(this._map.terrain); this._map._applyUpdatedTransform(tr); } if (allowEndAnimation && finishedMoving) { this._updatingCamera = true; const inertialEase = this._inertia._onMoveEnd(this._map.dragPan._inertiaOptions); const shouldSnapToNorth = bearing => bearing !== 0 && -this._bearingSnap < bearing && bearing < this._bearingSnap; if (inertialEase && (inertialEase.essential || !browser.prefersReducedMotion)) { if (shouldSnapToNorth(inertialEase.bearing || this._map.getBearing())) { inertialEase.bearing = 0; } inertialEase.freezeElevation = true; this._map.easeTo(inertialEase, { originalEvent: originalEndEvent }); } else { this._map.fire(new Event('moveend', { originalEvent: originalEndEvent })); if (shouldSnapToNorth(this._map.getBearing())) { this._map.resetNorth(); } } this._updatingCamera = false; } } _fireEvent(type, e) { this._map.fire(new Event(type, e ? { originalEvent: e } : {})); } _requestFrame() { this._map.triggerRepaint(); return this._map._renderTaskQueue.add(timeStamp => { delete this._frameId; this.handleEvent(new RenderFrameEvent('renderFrame', { timeStamp })); this._applyChanges(); }); } _triggerRenderFrame() { if (this._frameId === undefined) { this._frameId = this._requestFrame(); } } } class Camera extends Evented { constructor(transform, options) { super(); // Callback for map._requestRenderFrame this._renderFrameCallback = () => { const t = Math.min((browser.now() - this._easeStart) / this._easeOptions.duration, 1); this._onEaseFrame(this._easeOptions.easing(t)); // if _stop is called during _onEaseFrame from _fireMoveEvents we should avoid a new _requestRenderFrame, checking it by ensuring _easeFrameId was not deleted if (t < 1 && this._easeFrameId) { this._easeFrameId = this._requestRenderFrame(this._renderFrameCallback); } else { this.stop(); } }; this._moving = false; this._zooming = false; this.transform = transform; this._bearingSnap = options.bearingSnap; this.on('moveend', () => { delete this._requestedCameraState; }); } /** * Returns the map's geographical centerpoint. * * @returns The map's geographical centerpoint. * @example * Return a LngLat object such as `{lng: 0, lat: 0}` * ```ts * let center = map.getCenter(); * // access longitude and latitude values directly * let {lng, lat} = map.getCenter(); * ``` */ getCenter() { return new LngLat(this.transform.center.lng, this.transform.center.lat); } /** * Sets the map's geographical centerpoint. Equivalent to `jumpTo({center: center})`. * * Triggers the following events: `movestart` and `moveend`. * * @param center - The centerpoint to set. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * map.setCenter([-74, 38]); * ``` */ setCenter(center, eventData) { return this.jumpTo({ center }, eventData); } /** * Pans the map by the specified offset. * * Triggers the following events: `movestart` and `moveend`. * * @param offset - `x` and `y` coordinates by which to pan the map. * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/) */ panBy(offset, options, eventData) { offset = Point$2.convert(offset).mult(-1); return this.panTo(this.transform.center, extend({ offset }, options), eventData); } /** * Pans the map to the specified location with an animated transition. * * Triggers the following events: `movestart` and `moveend`. * * @param lnglat - The location to pan the map to. * @param options - Options describing the destination and animation of the transition. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * map.panTo([-74, 38]); * // Specify that the panTo animation should last 5000 milliseconds. * map.panTo([-74, 38], {duration: 5000}); * ``` * @see [Update a feature in realtime](https://maplibre.org/maplibre-gl-js/docs/examples/live-update-feature/) */ panTo(lnglat, options, eventData) { return this.easeTo(extend({ center: lnglat }, options), eventData); } /** * Returns the map's current zoom level. * * @returns The map's current zoom level. * @example * ```ts * map.getZoom(); * ``` */ getZoom() { return this.transform.zoom; } /** * Sets the map's zoom level. Equivalent to `jumpTo({zoom: zoom})`. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`. * * @param zoom - The zoom level to set (0-20). * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * Zoom to the zoom level 5 without an animated transition * ```ts * map.setZoom(5); * ``` */ setZoom(zoom, eventData) { this.jumpTo({ zoom }, eventData); return this; } /** * Zooms the map to the specified zoom level, with an animated transition. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`. * * @param zoom - The zoom level to transition to. * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * // Zoom to the zoom level 5 without an animated transition * map.zoomTo(5); * // Zoom to the zoom level 8 with an animated transition * map.zoomTo(8, { * duration: 2000, * offset: [100, 50] * }); * ``` */ zoomTo(zoom, options, eventData) { return this.easeTo(extend({ zoom }, options), eventData); } /** * Increases the map's zoom level by 1. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * Zoom the map in one level with a custom animation duration * ```ts * map.zoomIn({duration: 1000}); * ``` */ zoomIn(options, eventData) { this.zoomTo(this.getZoom() + 1, options, eventData); return this; } /** * Decreases the map's zoom level by 1. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, and `zoomend`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * Zoom the map out one level with a custom animation offset * ```ts * map.zoomOut({offset: [80, 60]}); * ``` */ zoomOut(options, eventData) { this.zoomTo(this.getZoom() - 1, options, eventData); return this; } /** * Returns the map's current bearing. The bearing is the compass direction that is "up"; for example, a bearing * of 90° orients the map so that east is up. * * @returns The map's current bearing. * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/) */ getBearing() { return this.transform.bearing; } /** * Sets the map's bearing (rotation). The bearing is the compass direction that is "up"; for example, a bearing * of 90° orients the map so that east is up. * * Equivalent to `jumpTo({bearing: bearing})`. * * Triggers the following events: `movestart`, `moveend`, and `rotate`. * * @param bearing - The desired bearing. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * Rotate the map to 90 degrees * ```ts * map.setBearing(90); * ``` */ setBearing(bearing, eventData) { this.jumpTo({ bearing }, eventData); return this; } /** * Returns the current padding applied around the map viewport. * * @returns The current padding around the map viewport. */ getPadding() { return this.transform.padding; } /** * Sets the padding in pixels around the viewport. * * Equivalent to `jumpTo({padding: padding})`. * * Triggers the following events: `movestart` and `moveend`. * * @param padding - The desired padding. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * Sets a left padding of 300px, and a top padding of 50px * ```ts * map.setPadding({ left: 300, top: 50 }); * ``` */ setPadding(padding, eventData) { this.jumpTo({ padding }, eventData); return this; } /** * Rotates the map to the specified bearing, with an animated transition. The bearing is the compass direction * that is "up"; for example, a bearing of 90° orients the map so that east is up. * * Triggers the following events: `movestart`, `moveend`, and `rotate`. * * @param bearing - The desired bearing. * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. */ rotateTo(bearing, options, eventData) { return this.easeTo(extend({ bearing }, options), eventData); } /** * Rotates the map so that north is up (0° bearing), with an animated transition. * * Triggers the following events: `movestart`, `moveend`, and `rotate`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. */ resetNorth(options, eventData) { this.rotateTo(0, extend({ duration: 1000 }, options), eventData); return this; } /** * Rotates and pitches the map so that north is up (0° bearing) and pitch is 0°, with an animated transition. * * Triggers the following events: `movestart`, `move`, `moveend`, `pitchstart`, `pitch`, `pitchend`, and `rotate`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. */ resetNorthPitch(options, eventData) { this.easeTo(extend({ bearing: 0, pitch: 0, duration: 1000 }, options), eventData); return this; } /** * Snaps the map so that north is up (0° bearing), if the current bearing is close enough to it (i.e. within the * `bearingSnap` threshold). * * Triggers the following events: `movestart`, `moveend`, and `rotate`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. */ snapToNorth(options, eventData) { if (Math.abs(this.getBearing()) < this._bearingSnap) { return this.resetNorth(options, eventData); } return this; } /** * Returns the map's current pitch (tilt). * * @returns The map's current pitch, measured in degrees away from the plane of the screen. */ getPitch() { return this.transform.pitch; } /** * Sets the map's pitch (tilt). Equivalent to `jumpTo({pitch: pitch})`. * * Triggers the following events: `movestart`, `moveend`, `pitchstart`, and `pitchend`. * * @param pitch - The pitch to set, measured in degrees away from the plane of the screen (0-60). * @param eventData - Additional properties to be added to event objects of events triggered by this method. */ setPitch(pitch, eventData) { this.jumpTo({ pitch }, eventData); return this; } /** * @param bounds - Calculate the center for these bounds in the viewport and use * the highest zoom level up to and including `Map#getMaxZoom()` that fits * in the viewport. LngLatBounds represent a box that is always axis-aligned with bearing 0. * Bounds will be taken in [sw, ne] order. Southwest point will always be to the left of the northeast point. * @param options - Options object * @returns If map is able to fit to provided bounds, returns `center`, `zoom`, and `bearing`. * If map is unable to fit, method will warn and return undefined. * @example * ```ts * let bbox = [[-79, 43], [-73, 45]]; * let newCameraTransform = map.cameraForBounds(bbox, { * padding: {top: 10, bottom:25, left: 15, right: 5} * }); * ``` */ cameraForBounds(bounds, options) { bounds = LngLatBounds.convert(bounds).adjustAntiMeridian(); const bearing = options && options.bearing || 0; return this._cameraForBoxAndBearing(bounds.getNorthWest(), bounds.getSouthEast(), bearing, options); } /** * @internal * Calculate the center of these two points in the viewport and use * the highest zoom level up to and including `Map#getMaxZoom()` that fits * the points in the viewport at the specified bearing. * @param p0 - First point * @param p1 - Second point * @param bearing - Desired map bearing at end of animation, in degrees * @param options - the camera options * @returns If map is able to fit to provided bounds, returns `center`, `zoom`, and `bearing`. * If map is unable to fit, method will warn and return undefined. * @example * ```ts * let p0 = [-79, 43]; * let p1 = [-73, 45]; * let bearing = 90; * let newCameraTransform = map._cameraForBoxAndBearing(p0, p1, bearing, { * padding: {top: 10, bottom:25, left: 15, right: 5} * }); * ``` */ _cameraForBoxAndBearing(p0, p1, bearing, options) { const defaultPadding = { top: 0, bottom: 0, right: 0, left: 0 }; options = extend({ padding: defaultPadding, offset: [0, 0], maxZoom: this.transform.maxZoom }, options); if (typeof options.padding === 'number') { const p = options.padding; options.padding = { top: p, bottom: p, right: p, left: p }; } options.padding = extend(defaultPadding, options.padding); const tr = this.transform; const edgePadding = tr.padding; // Consider all corners of the rotated bounding box derived from the given points // when find the camera position that fits the given points. const bounds = new LngLatBounds(p0, p1); const nwWorld = tr.project(bounds.getNorthWest()); const neWorld = tr.project(bounds.getNorthEast()); const seWorld = tr.project(bounds.getSouthEast()); const swWorld = tr.project(bounds.getSouthWest()); const bearingRadians = degreesToRadians(-bearing); const nwRotatedWorld = nwWorld.rotate(bearingRadians); const neRotatedWorld = neWorld.rotate(bearingRadians); const seRotatedWorld = seWorld.rotate(bearingRadians); const swRotatedWorld = swWorld.rotate(bearingRadians); const upperRight = new Point$2(Math.max(nwRotatedWorld.x, neRotatedWorld.x, swRotatedWorld.x, seRotatedWorld.x), Math.max(nwRotatedWorld.y, neRotatedWorld.y, swRotatedWorld.y, seRotatedWorld.y)); const lowerLeft = new Point$2(Math.min(nwRotatedWorld.x, neRotatedWorld.x, swRotatedWorld.x, seRotatedWorld.x), Math.min(nwRotatedWorld.y, neRotatedWorld.y, swRotatedWorld.y, seRotatedWorld.y)); // Calculate zoom: consider the original bbox and padding. const size = upperRight.sub(lowerLeft); const scaleX = (tr.width - (edgePadding.left + edgePadding.right + options.padding.left + options.padding.right)) / size.x; const scaleY = (tr.height - (edgePadding.top + edgePadding.bottom + options.padding.top + options.padding.bottom)) / size.y; if (scaleY < 0 || scaleX < 0) { warnOnce('Map cannot fit within canvas with the given bounds, padding, and/or offset.'); return undefined; } const zoom = Math.min(tr.scaleZoom(tr.scale * Math.min(scaleX, scaleY)), options.maxZoom); // Calculate center: apply the zoom, the configured offset, as well as offset that exists as a result of padding. const offset = Point$2.convert(options.offset); const paddingOffsetX = (options.padding.left - options.padding.right) / 2; const paddingOffsetY = (options.padding.top - options.padding.bottom) / 2; const paddingOffset = new Point$2(paddingOffsetX, paddingOffsetY); const rotatedPaddingOffset = paddingOffset.rotate(degreesToRadians(bearing)); const offsetAtInitialZoom = offset.add(rotatedPaddingOffset); const offsetAtFinalZoom = offsetAtInitialZoom.mult(tr.scale / tr.zoomScale(zoom)); const center = tr.unproject( // either world diagonal can be used (NW-SE or NE-SW) nwWorld.add(seWorld).div(2).sub(offsetAtFinalZoom)); return { center, zoom, bearing }; } /** * Pans and zooms the map to contain its visible area within the specified geographical bounds. * This function will also reset the map's bearing to 0 if bearing is nonzero. * * Triggers the following events: `movestart` and `moveend`. * * @param bounds - Center these bounds in the viewport and use the highest * zoom level up to and including `Map#getMaxZoom()` that fits them in the viewport. * Bounds will be taken in [sw, ne] order. Southwest point will always be to the left of the northeast point. * @param options - Options supports all properties from {@link AnimationOptions} and {@link CameraOptions} in addition to the fields below. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * let bbox = [[-79, 43], [-73, 45]]; * map.fitBounds(bbox, { * padding: {top: 10, bottom:25, left: 15, right: 5} * }); * ``` * @see [Fit a map to a bounding box](https://maplibre.org/maplibre-gl-js/docs/examples/fitbounds/) */ fitBounds(bounds, options, eventData) { return this._fitInternal(this.cameraForBounds(bounds, options), options, eventData); } /** * Pans, rotates and zooms the map to to fit the box made by points p0 and p1 * once the map is rotated to the specified bearing. To zoom without rotating, * pass in the current map bearing. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend` and `rotate`. * * @param p0 - First point on screen, in pixel coordinates * @param p1 - Second point on screen, in pixel coordinates * @param bearing - Desired map bearing at end of animation, in degrees * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * let p0 = [220, 400]; * let p1 = [500, 900]; * map.fitScreenCoordinates(p0, p1, map.getBearing(), { * padding: {top: 10, bottom:25, left: 15, right: 5} * }); * ``` * @see Used by {@link BoxZoomHandler} */ fitScreenCoordinates(p0, p1, bearing, options, eventData) { return this._fitInternal(this._cameraForBoxAndBearing(this.transform.pointLocation(Point$2.convert(p0)), this.transform.pointLocation(Point$2.convert(p1)), bearing, options), options, eventData); } _fitInternal(calculatedOptions, options, eventData) { // cameraForBounds warns + returns undefined if unable to fit: if (!calculatedOptions) return this; options = extend(calculatedOptions, options); // Explicitly remove the padding field because, calculatedOptions already accounts for padding by setting zoom and center accordingly. delete options.padding; return options.linear ? this.easeTo(options, eventData) : this.flyTo(options, eventData); } /** * Changes any combination of center, zoom, bearing, and pitch, without * an animated transition. The map will retain its current values for any * details not specified in `options`. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`, * `pitch`, `pitchend`, and `rotate`. * * @param options - Options object * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * // jump to coordinates at current zoom * map.jumpTo({center: [0, 0]}); * // jump with zoom, pitch, and bearing options * map.jumpTo({ * center: [0, 0], * zoom: 8, * pitch: 45, * bearing: 90 * }); * ``` * @see [Jump to a series of locations](https://maplibre.org/maplibre-gl-js/docs/examples/jump-to/) * @see [Update a feature in realtime](https://maplibre.org/maplibre-gl-js/docs/examples/live-update-feature/) */ jumpTo(options, eventData) { this.stop(); const tr = this._getTransformForUpdate(); let zoomChanged = false, bearingChanged = false, pitchChanged = false; if ('zoom' in options && tr.zoom !== +options.zoom) { zoomChanged = true; tr.zoom = +options.zoom; } if (options.center !== undefined) { tr.center = LngLat.convert(options.center); } if ('bearing' in options && tr.bearing !== +options.bearing) { bearingChanged = true; tr.bearing = +options.bearing; } if ('pitch' in options && tr.pitch !== +options.pitch) { pitchChanged = true; tr.pitch = +options.pitch; } if (options.padding != null && !tr.isPaddingEqual(options.padding)) { tr.padding = options.padding; } this._applyUpdatedTransform(tr); this.fire(new Event('movestart', eventData)) .fire(new Event('move', eventData)); if (zoomChanged) { this.fire(new Event('zoomstart', eventData)) .fire(new Event('zoom', eventData)) .fire(new Event('zoomend', eventData)); } if (bearingChanged) { this.fire(new Event('rotatestart', eventData)) .fire(new Event('rotate', eventData)) .fire(new Event('rotateend', eventData)); } if (pitchChanged) { this.fire(new Event('pitchstart', eventData)) .fire(new Event('pitch', eventData)) .fire(new Event('pitchend', eventData)); } return this.fire(new Event('moveend', eventData)); } /** * Calculates pitch, zoom and bearing for looking at `newCenter` with the camera position being `newCenter` * and returns them as {@link CameraOptions}. * @param from - The camera to look from * @param altitudeFrom - The altitude of the camera to look from * @param to - The center to look at * @param altitudeTo - Optional altitude of the center to look at. If none given the ground height will be used. * @returns the calculated camera options */ calculateCameraOptionsFromTo(from, altitudeFrom, to, altitudeTo = 0) { const fromMerc = MercatorCoordinate.fromLngLat(from, altitudeFrom); const toMerc = MercatorCoordinate.fromLngLat(to, altitudeTo); const dx = toMerc.x - fromMerc.x; const dy = toMerc.y - fromMerc.y; const dz = toMerc.z - fromMerc.z; const distance3D = Math.hypot(dx, dy, dz); if (distance3D === 0) throw new Error('Can\'t calculate camera options with same From and To'); const groundDistance = Math.hypot(dx, dy); const zoom = this.transform.scaleZoom(this.transform.cameraToCenterDistance / distance3D / this.transform.tileSize); const bearing = (Math.atan2(dx, -dy) * 180) / Math.PI; let pitch = (Math.acos(groundDistance / distance3D) * 180) / Math.PI; pitch = dz < 0 ? 90 - pitch : 90 + pitch; return { center: toMerc.toLngLat(), zoom, pitch, bearing }; } /** * Changes any combination of `center`, `zoom`, `bearing`, `pitch`, and `padding` with an animated transition * between old and new values. The map will retain its current values for any * details not specified in `options`. * * Note: The transition will happen instantly if the user has enabled * the `reduced motion` accessibility feature enabled in their operating system, * unless `options` includes `essential: true`. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`, * `pitch`, `pitchend`, and `rotate`. * * @param options - Options describing the destination and animation of the transition. * Accepts {@link CameraOptions} and {@link AnimationOptions}. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @see [Navigate the map with game-like controls](https://maplibre.org/maplibre-gl-js/docs/examples/game-controls/) */ easeTo(options, eventData) { var _a; this._stop(false, options.easeId); options = extend({ offset: [0, 0], duration: 500, easing: defaultEasing }, options); if (options.animate === false || (!options.essential && browser.prefersReducedMotion)) options.duration = 0; const tr = this._getTransformForUpdate(), startZoom = tr.zoom, startBearing = tr.bearing, startPitch = tr.pitch, startPadding = tr.padding, bearing = 'bearing' in options ? this._normalizeBearing(options.bearing, startBearing) : startBearing, pitch = 'pitch' in options ? +options.pitch : startPitch, padding = 'padding' in options ? options.padding : tr.padding; const offsetAsPoint = Point$2.convert(options.offset); let pointAtOffset = tr.centerPoint.add(offsetAsPoint); const locationAtOffset = tr.pointLocation(pointAtOffset); const { center, zoom } = tr.getConstrained(LngLat.convert(options.center || locationAtOffset), (_a = options.zoom) !== null && _a !== void 0 ? _a : startZoom); this._normalizeCenter(center, tr); const from = tr.project(locationAtOffset); const delta = tr.project(center).sub(from); const finalScale = tr.zoomScale(zoom - startZoom); let around, aroundPoint; if (options.around) { around = LngLat.convert(options.around); aroundPoint = tr.locationPoint(around); } const currently = { moving: this._moving, zooming: this._zooming, rotating: this._rotating, pitching: this._pitching }; this._zooming = this._zooming || (zoom !== startZoom); this._rotating = this._rotating || (startBearing !== bearing); this._pitching = this._pitching || (pitch !== startPitch); this._padding = !tr.isPaddingEqual(padding); this._easeId = options.easeId; this._prepareEase(eventData, options.noMoveStart, currently); if (this.terrain) this._prepareElevation(center); this._ease((k) => { if (this._zooming) { tr.zoom = interpolate.number(startZoom, zoom, k); } if (this._rotating) { tr.bearing = interpolate.number(startBearing, bearing, k); } if (this._pitching) { tr.pitch = interpolate.number(startPitch, pitch, k); } if (this._padding) { tr.interpolatePadding(startPadding, padding, k); // When padding is being applied, Transform#centerPoint is changing continuously, // thus we need to recalculate offsetPoint every frame pointAtOffset = tr.centerPoint.add(offsetAsPoint); } if (this.terrain && !options.freezeElevation) this._updateElevation(k); if (around) { tr.setLocationAtPoint(around, aroundPoint); } else { const scale = tr.zoomScale(tr.zoom - startZoom); const base = zoom > startZoom ? Math.min(2, finalScale) : Math.max(0.5, finalScale); const speedup = Math.pow(base, 1 - k); const newCenter = tr.unproject(from.add(delta.mult(k * speedup)).mult(scale)); tr.setLocationAtPoint(tr.renderWorldCopies ? newCenter.wrap() : newCenter, pointAtOffset); } this._applyUpdatedTransform(tr); this._fireMoveEvents(eventData); }, (interruptingEaseId) => { if (this.terrain && options.freezeElevation) this._finalizeElevation(); this._afterEase(eventData, interruptingEaseId); }, options); return this; } _prepareEase(eventData, noMoveStart, currently = {}) { this._moving = true; if (!noMoveStart && !currently.moving) { this.fire(new Event('movestart', eventData)); } if (this._zooming && !currently.zooming) { this.fire(new Event('zoomstart', eventData)); } if (this._rotating && !currently.rotating) { this.fire(new Event('rotatestart', eventData)); } if (this._pitching && !currently.pitching) { this.fire(new Event('pitchstart', eventData)); } } _prepareElevation(center) { this._elevationCenter = center; this._elevationStart = this.transform.elevation; this._elevationTarget = this.terrain.getElevationForLngLatZoom(center, this.transform.tileZoom); this._elevationFreeze = true; } _updateElevation(k) { this.transform.minElevationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this._elevationCenter, this.transform.tileZoom); const elevation = this.terrain.getElevationForLngLatZoom(this._elevationCenter, this.transform.tileZoom); // target terrain updated during flight, slowly move camera to new height if (k < 1 && elevation !== this._elevationTarget) { const pitch1 = this._elevationTarget - this._elevationStart; const pitch2 = (elevation - (pitch1 * k + this._elevationStart)) / (1 - k); this._elevationStart += k * (pitch1 - pitch2); this._elevationTarget = elevation; } this.transform.elevation = interpolate.number(this._elevationStart, this._elevationTarget, k); } _finalizeElevation() { this._elevationFreeze = false; this.transform.recalculateZoom(this.terrain); } /** * @internal * Called when the camera is about to be manipulated. * If `transformCameraUpdate` is specified or terrain is enabled, a copy of * the current transform is created to track the accumulated changes. * This underlying transform represents the "desired state" proposed by input handlers / animations / UI controls. * It may differ from the state used for rendering (`this.transform`). * @returns Transform to apply changes to */ _getTransformForUpdate() { if (!this.transformCameraUpdate && !this.terrain) return this.transform; if (!this._requestedCameraState) { this._requestedCameraState = this.transform.clone(); } return this._requestedCameraState; } /** * @internal * Checks the given transform for the camera being below terrain surface and * returns new pitch and zoom to fix that. * * With the new pitch and zoom, the camera will be at the same ground * position but at higher altitude. It will still point to the same spot on * the map. * * @param tr - The transform to check. */ _elevateCameraIfInsideTerrain(tr) { const camera = tr.getCameraPosition(); const minAltitude = this.terrain.getElevationForLngLatZoom(camera.lngLat, tr.zoom); if (camera.altitude < minAltitude) { const newCamera = this.calculateCameraOptionsFromTo(camera.lngLat, minAltitude, tr.center, tr.elevation); return { pitch: newCamera.pitch, zoom: newCamera.zoom, }; } return {}; } /** * @internal * Called after the camera is done being manipulated. * @param tr - the requested camera end state * If the camera is inside terrain, it gets elevated. * Call `transformCameraUpdate` if present, and then apply the "approved" changes. */ _applyUpdatedTransform(tr) { const modifiers = []; if (this.terrain) { modifiers.push(tr => this._elevateCameraIfInsideTerrain(tr)); } if (this.transformCameraUpdate) { modifiers.push(tr => this.transformCameraUpdate(tr)); } if (!modifiers.length) { return; } const finalTransform = tr.clone(); for (const modifier of modifiers) { const nextTransform = finalTransform.clone(); const { center, zoom, pitch, bearing, elevation } = modifier(nextTransform); if (center) nextTransform.center = center; if (zoom !== undefined) nextTransform.zoom = zoom; if (pitch !== undefined) nextTransform.pitch = pitch; if (bearing !== undefined) nextTransform.bearing = bearing; if (elevation !== undefined) nextTransform.elevation = elevation; finalTransform.apply(nextTransform); } this.transform.apply(finalTransform); } _fireMoveEvents(eventData) { this.fire(new Event('move', eventData)); if (this._zooming) { this.fire(new Event('zoom', eventData)); } if (this._rotating) { this.fire(new Event('rotate', eventData)); } if (this._pitching) { this.fire(new Event('pitch', eventData)); } } _afterEase(eventData, easeId) { // if this easing is being stopped to start another easing with // the same id then don't fire any events to avoid extra start/stop events if (this._easeId && easeId && this._easeId === easeId) { return; } delete this._easeId; const wasZooming = this._zooming; const wasRotating = this._rotating; const wasPitching = this._pitching; this._moving = false; this._zooming = false; this._rotating = false; this._pitching = false; this._padding = false; if (wasZooming) { this.fire(new Event('zoomend', eventData)); } if (wasRotating) { this.fire(new Event('rotateend', eventData)); } if (wasPitching) { this.fire(new Event('pitchend', eventData)); } this.fire(new Event('moveend', eventData)); } /** * Changes any combination of center, zoom, bearing, and pitch, animating the transition along a curve that * evokes flight. The animation seamlessly incorporates zooming and panning to help * the user maintain her bearings even after traversing a great distance. * * Note: The animation will be skipped, and this will behave equivalently to `jumpTo` * if the user has the `reduced motion` accessibility feature enabled in their operating system, * unless 'options' includes `essential: true`. * * Triggers the following events: `movestart`, `move`, `moveend`, `zoomstart`, `zoom`, `zoomend`, `pitchstart`, * `pitch`, `pitchend`, and `rotate`. * * @param options - Options describing the destination and animation of the transition. * Accepts {@link CameraOptions}, {@link AnimationOptions}, * and the following additional options. * @param eventData - Additional properties to be added to event objects of events triggered by this method. * @example * ```ts * // fly with default options to null island * map.flyTo({center: [0, 0], zoom: 9}); * // using flyTo options * map.flyTo({ * center: [0, 0], * zoom: 9, * speed: 0.2, * curve: 1, * easing(t) { * return t; * } * }); * ``` * @see [Fly to a location](https://maplibre.org/maplibre-gl-js/docs/examples/flyto/) * @see [Slowly fly to a location](https://maplibre.org/maplibre-gl-js/docs/examples/flyto-options/) * @see [Fly to a location based on scroll position](https://maplibre.org/maplibre-gl-js/docs/examples/scroll-fly-to/) */ flyTo(options, eventData) { var _a; // Fall through to jumpTo if user has set prefers-reduced-motion if (!options.essential && browser.prefersReducedMotion) { const coercedOptions = pick(options, ['center', 'zoom', 'bearing', 'pitch', 'around']); return this.jumpTo(coercedOptions, eventData); } // This method implements an “optimal path” animation, as detailed in: // // Van Wijk, Jarke J.; Nuij, Wim A. A. “Smooth and efficient zooming and panning.” INFOVIS // ’03. pp. 15–22. . // // Where applicable, local variable documentation begins with the associated variable or // function in van Wijk (2003). this.stop(); options = extend({ offset: [0, 0], speed: 1.2, curve: 1.42, easing: defaultEasing }, options); const tr = this._getTransformForUpdate(), startZoom = tr.zoom, startBearing = tr.bearing, startPitch = tr.pitch, startPadding = tr.padding; const bearing = 'bearing' in options ? this._normalizeBearing(options.bearing, startBearing) : startBearing; const pitch = 'pitch' in options ? +options.pitch : startPitch; const padding = 'padding' in options ? options.padding : tr.padding; const offsetAsPoint = Point$2.convert(options.offset); let pointAtOffset = tr.centerPoint.add(offsetAsPoint); const locationAtOffset = tr.pointLocation(pointAtOffset); const { center, zoom } = tr.getConstrained(LngLat.convert(options.center || locationAtOffset), (_a = options.zoom) !== null && _a !== void 0 ? _a : startZoom); this._normalizeCenter(center, tr); const scale = tr.zoomScale(zoom - startZoom); const from = tr.project(locationAtOffset); const delta = tr.project(center).sub(from); let rho = options.curve; // w₀: Initial visible span, measured in pixels at the initial scale. const w0 = Math.max(tr.width, tr.height), // w₁: Final visible span, measured in pixels with respect to the initial scale. w1 = w0 / scale, // Length of the flight path as projected onto the ground plane, measured in pixels from // the world image origin at the initial scale. u1 = delta.mag(); if ('minZoom' in options) { const minZoom = clamp$1(Math.min(options.minZoom, startZoom, zoom), tr.minZoom, tr.maxZoom); // wm: Maximum visible span, measured in pixels with respect to the initial // scale. const wMax = w0 / tr.zoomScale(minZoom - startZoom); rho = Math.sqrt(wMax / u1 * 2); } // ρ² const rho2 = rho * rho; /** * rᵢ: Returns the zoom-out factor at one end of the animation. * * @param descent - `true` for the descent, `false` for the ascent */ function zoomOutFactor(descent) { const b = (w1 * w1 - w0 * w0 + (descent ? -1 : 1) * rho2 * rho2 * u1 * u1) / (2 * (descent ? w1 : w0) * rho2 * u1); return Math.log(Math.sqrt(b * b + 1) - b); } function sinh(n) { return (Math.exp(n) - Math.exp(-n)) / 2; } function cosh(n) { return (Math.exp(n) + Math.exp(-n)) / 2; } function tanh(n) { return sinh(n) / cosh(n); } // r₀: Zoom-out factor during ascent. const r0 = zoomOutFactor(false); // w(s): Returns the visible span on the ground, measured in pixels with respect to the // initial scale. Assumes an angular field of view of 2 arctan ½ ≈ 53°. let w = function (s) { return (cosh(r0) / cosh(r0 + rho * s)); }; // u(s): Returns the distance along the flight path as projected onto the ground plane, // measured in pixels from the world image origin at the initial scale. let u = function (s) { return w0 * ((cosh(r0) * tanh(r0 + rho * s) - sinh(r0)) / rho2) / u1; }; // S: Total length of the flight path, measured in ρ-screenfuls. let S = (zoomOutFactor(true) - r0) / rho; // When u₀ = u₁, the optimal path doesn’t require both ascent and descent. if (Math.abs(u1) < 0.000001 || !isFinite(S)) { // Perform a more or less instantaneous transition if the path is too short. if (Math.abs(w0 - w1) < 0.000001) return this.easeTo(options, eventData); const k = w1 < w0 ? -1 : 1; S = Math.abs(Math.log(w1 / w0)) / rho; u = () => 0; w = (s) => Math.exp(k * rho * s); } if ('duration' in options) { options.duration = +options.duration; } else { const V = 'screenSpeed' in options ? +options.screenSpeed / rho : +options.speed; options.duration = 1000 * S / V; } if (options.maxDuration && options.duration > options.maxDuration) { options.duration = 0; } this._zooming = true; this._rotating = (startBearing !== bearing); this._pitching = (pitch !== startPitch); this._padding = !tr.isPaddingEqual(padding); this._prepareEase(eventData, false); if (this.terrain) this._prepareElevation(center); this._ease((k) => { // s: The distance traveled along the flight path, measured in ρ-screenfuls. const s = k * S; const scale = 1 / w(s); tr.zoom = k === 1 ? zoom : startZoom + tr.scaleZoom(scale); if (this._rotating) { tr.bearing = interpolate.number(startBearing, bearing, k); } if (this._pitching) { tr.pitch = interpolate.number(startPitch, pitch, k); } if (this._padding) { tr.interpolatePadding(startPadding, padding, k); // When padding is being applied, Transform#centerPoint is changing continuously, // thus we need to recalculate offsetPoint every frame pointAtOffset = tr.centerPoint.add(offsetAsPoint); } if (this.terrain && !options.freezeElevation) this._updateElevation(k); const newCenter = k === 1 ? center : tr.unproject(from.add(delta.mult(u(s))).mult(scale)); tr.setLocationAtPoint(tr.renderWorldCopies ? newCenter.wrap() : newCenter, pointAtOffset); this._applyUpdatedTransform(tr); this._fireMoveEvents(eventData); }, () => { if (this.terrain && options.freezeElevation) this._finalizeElevation(); this._afterEase(eventData); }, options); return this; } isEasing() { return !!this._easeFrameId; } /** * Stops any animated transition underway. */ stop() { return this._stop(); } _stop(allowGestures, easeId) { var _a; if (this._easeFrameId) { this._cancelRenderFrame(this._easeFrameId); delete this._easeFrameId; delete this._onEaseFrame; } if (this._onEaseEnd) { // The _onEaseEnd function might emit events which trigger new // animation, which sets a new _onEaseEnd. Ensure we don't delete // it unintentionally. const onEaseEnd = this._onEaseEnd; delete this._onEaseEnd; onEaseEnd.call(this, easeId); } if (!allowGestures) { (_a = this.handlers) === null || _a === void 0 ? void 0 : _a.stop(false); } return this; } _ease(frame, finish, options) { if (options.animate === false || options.duration === 0) { frame(1); finish(); } else { this._easeStart = browser.now(); this._easeOptions = options; this._onEaseFrame = frame; this._onEaseEnd = finish; this._easeFrameId = this._requestRenderFrame(this._renderFrameCallback); } } // convert bearing so that it's numerically close to the current one so that it interpolates properly _normalizeBearing(bearing, currentBearing) { bearing = wrap(bearing, -180, 180); const diff = Math.abs(bearing - currentBearing); if (Math.abs(bearing - 360 - currentBearing) < diff) bearing -= 360; if (Math.abs(bearing + 360 - currentBearing) < diff) bearing += 360; return bearing; } // If a path crossing the antimeridian would be shorter, extend the final coordinate so that // interpolating between the two endpoints will cross it. _normalizeCenter(center, tr) { if (!tr.renderWorldCopies || tr.lngRange) return; const delta = center.lng - tr.center.lng; center.lng += delta > 180 ? -360 : delta < -180 ? 360 : 0; } /** * Get the elevation difference between a given point * and a point that is currently in the middle of the screen. * This method should be used for proper positioning of custom 3d objects, as explained [here](https://maplibre.org/maplibre-gl-js/docs/examples/add-3d-model-with-terrain/) * Returns null if terrain is not enabled. * This method is subject to change in Maplibre GL JS v5. * @param lngLatLike - [x,y] or LngLat coordinates of the location * @returns elevation offset in meters */ queryTerrainElevation(lngLatLike) { if (!this.terrain) { return null; } const elevation = this.terrain.getElevationForLngLatZoom(LngLat.convert(lngLatLike), this.transform.tileZoom); return elevation - this.transform.elevation; } } const defaultAttributionControlOptions = { compact: true, customAttribution: 'MapLibre' }; /** * An `AttributionControl` control presents the map's attribution information. By default, the attribution control is expanded (regardless of map width). * @group Markers and Controls * @example * ```ts * let map = new Map({attributionControl: false}) * .addControl(new AttributionControl({ * compact: true * })); * ``` */ class AttributionControl { /** * @param options - the attribution options */ constructor(options = defaultAttributionControlOptions) { this._toggleAttribution = () => { if (this._container.classList.contains('maplibregl-compact')) { if (this._container.classList.contains('maplibregl-compact-show')) { this._container.setAttribute('open', ''); this._container.classList.remove('maplibregl-compact-show'); } else { this._container.classList.add('maplibregl-compact-show'); this._container.removeAttribute('open'); } } }; this._updateData = (e) => { if (e && (e.sourceDataType === 'metadata' || e.sourceDataType === 'visibility' || e.dataType === 'style' || e.type === 'terrain')) { this._updateAttributions(); } }; this._updateCompact = () => { if (this._map.getCanvasContainer().offsetWidth <= 640 || this._compact) { if (this._compact === false) { this._container.setAttribute('open', ''); } else if (!this._container.classList.contains('maplibregl-compact') && !this._container.classList.contains('maplibregl-attrib-empty')) { this._container.setAttribute('open', ''); this._container.classList.add('maplibregl-compact', 'maplibregl-compact-show'); } } else { this._container.setAttribute('open', ''); if (this._container.classList.contains('maplibregl-compact')) { this._container.classList.remove('maplibregl-compact', 'maplibregl-compact-show'); } } }; this._updateCompactMinimize = () => { if (this._container.classList.contains('maplibregl-compact')) { if (this._container.classList.contains('maplibregl-compact-show')) { this._container.classList.remove('maplibregl-compact-show'); } } }; this.options = options; } getDefaultPosition() { return 'bottom-right'; } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; this._compact = this.options.compact; this._container = DOM.create('details', 'maplibregl-ctrl maplibregl-ctrl-attrib'); this._compactButton = DOM.create('summary', 'maplibregl-ctrl-attrib-button', this._container); this._compactButton.addEventListener('click', this._toggleAttribution); this._setElementTitle(this._compactButton, 'ToggleAttribution'); this._innerContainer = DOM.create('div', 'maplibregl-ctrl-attrib-inner', this._container); this._updateAttributions(); this._updateCompact(); this._map.on('styledata', this._updateData); this._map.on('sourcedata', this._updateData); this._map.on('terrain', this._updateData); this._map.on('resize', this._updateCompact); this._map.on('drag', this._updateCompactMinimize); return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._container); this._map.off('styledata', this._updateData); this._map.off('sourcedata', this._updateData); this._map.off('terrain', this._updateData); this._map.off('resize', this._updateCompact); this._map.off('drag', this._updateCompactMinimize); this._map = undefined; this._compact = undefined; this._attribHTML = undefined; } _setElementTitle(element, title) { const str = this._map._getUIString(`AttributionControl.${title}`); element.title = str; element.setAttribute('aria-label', str); } _updateAttributions() { if (!this._map.style) return; let attributions = []; if (this.options.customAttribution) { if (Array.isArray(this.options.customAttribution)) { attributions = attributions.concat(this.options.customAttribution.map(attribution => { if (typeof attribution !== 'string') return ''; return attribution; })); } else if (typeof this.options.customAttribution === 'string') { attributions.push(this.options.customAttribution); } } if (this._map.style.stylesheet) { const stylesheet = this._map.style.stylesheet; this.styleOwner = stylesheet.owner; this.styleId = stylesheet.id; } const sourceCaches = this._map.style.sourceCaches; for (const id in sourceCaches) { const sourceCache = sourceCaches[id]; if (sourceCache.used || sourceCache.usedForTerrain) { const source = sourceCache.getSource(); if (source.attribution && attributions.indexOf(source.attribution) < 0) { attributions.push(source.attribution); } } } // remove any entries that are whitespace attributions = attributions.filter(e => String(e).trim()); // remove any entries that are substrings of another entry. // first sort by length so that substrings come first attributions.sort((a, b) => a.length - b.length); attributions = attributions.filter((attrib, i) => { for (let j = i + 1; j < attributions.length; j++) { if (attributions[j].indexOf(attrib) >= 0) { return false; } } return true; }); // check if attribution string is different to minimize DOM changes const attribHTML = attributions.join(' | '); if (attribHTML === this._attribHTML) return; this._attribHTML = attribHTML; if (attributions.length) { this._innerContainer.innerHTML = attribHTML; this._container.classList.remove('maplibregl-attrib-empty'); } else { this._container.classList.add('maplibregl-attrib-empty'); } this._updateCompact(); // remove old DOM node from _editLink this._editLink = null; } } /** * A `LogoControl` is a control that adds the watermark. * * @group Markers and Controls * * @example * ```ts * map.addControl(new LogoControl({compact: false})); * ``` **/ class LogoControl { /** * @param options - the control's options */ constructor(options = {}) { this._updateCompact = () => { const containerChildren = this._container.children; if (containerChildren.length) { const anchor = containerChildren[0]; if (this._map.getCanvasContainer().offsetWidth <= 640 || this._compact) { if (this._compact !== false) { anchor.classList.add('maplibregl-compact'); } } else { anchor.classList.remove('maplibregl-compact'); } } }; this.options = options; } getDefaultPosition() { return 'bottom-left'; } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; this._compact = this.options && this.options.compact; this._container = DOM.create('div', 'maplibregl-ctrl'); const anchor = DOM.create('a', 'maplibregl-ctrl-logo'); anchor.target = '_blank'; anchor.rel = 'noopener nofollow'; anchor.href = 'https://maplibre.org/'; anchor.setAttribute('aria-label', this._map._getUIString('LogoControl.Title')); anchor.setAttribute('rel', 'noopener nofollow'); this._container.appendChild(anchor); this._container.style.display = 'block'; this._map.on('resize', this._updateCompact); this._updateCompact(); return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._container); this._map.off('resize', this._updateCompact); this._map = undefined; this._compact = undefined; } } class TaskQueue { constructor() { this._queue = []; this._id = 0; this._cleared = false; this._currentlyRunning = false; } add(callback) { const id = ++this._id; const queue = this._queue; queue.push({ callback, id, cancelled: false }); return id; } remove(id) { const running = this._currentlyRunning; const queue = running ? this._queue.concat(running) : this._queue; for (const task of queue) { if (task.id === id) { task.cancelled = true; return; } } } run(timeStamp = 0) { if (this._currentlyRunning) throw new Error('Attempting to run(), but is already running.'); const queue = this._currentlyRunning = this._queue; // Tasks queued by callbacks in the current queue should be executed // on the next run, not the current run. this._queue = []; for (const task of queue) { if (task.cancelled) continue; task.callback(timeStamp); if (this._cleared) break; } this._cleared = false; this._currentlyRunning = false; } clear() { if (this._currentlyRunning) { this._cleared = true; } this._queue = []; } } var PerformanceMarkers; (function (PerformanceMarkers) { PerformanceMarkers["create"] = "create"; PerformanceMarkers["load"] = "load"; PerformanceMarkers["fullLoad"] = "fullLoad"; })(PerformanceMarkers || (PerformanceMarkers = {})); let lastFrameTime = null; let frameTimes = []; const minFramerateTarget = 60; const frameTimeTarget = 1000 / minFramerateTarget; const loadTimeKey = 'loadTime'; const fullLoadTimeKey = 'fullLoadTime'; const PerformanceUtils = { mark(marker) { performance.mark(marker); }, frame(timestamp) { const currTimestamp = timestamp; if (lastFrameTime != null) { const frameTime = currTimestamp - lastFrameTime; frameTimes.push(frameTime); } lastFrameTime = currTimestamp; }, clearMetrics() { lastFrameTime = null; frameTimes = []; performance.clearMeasures(loadTimeKey); performance.clearMeasures(fullLoadTimeKey); for (const marker in PerformanceMarkers) { performance.clearMarks(PerformanceMarkers[marker]); } }, getPerformanceMetrics() { performance.measure(loadTimeKey, PerformanceMarkers.create, PerformanceMarkers.load); performance.measure(fullLoadTimeKey, PerformanceMarkers.create, PerformanceMarkers.fullLoad); const loadTime = performance.getEntriesByName(loadTimeKey)[0].duration; const fullLoadTime = performance.getEntriesByName(fullLoadTimeKey)[0].duration; const totalFrames = frameTimes.length; const avgFrameTime = frameTimes.reduce((prev, curr) => prev + curr, 0) / totalFrames / 1000; const fps = 1 / avgFrameTime; // count frames that missed our framerate target const droppedFrames = frameTimes .filter((frameTime) => frameTime > frameTimeTarget) .reduce((acc, curr) => { return acc + (curr - frameTimeTarget) / frameTimeTarget; }, 0); const percentDroppedFrames = (droppedFrames / (totalFrames + droppedFrames)) * 100; return { loadTime, fullLoadTime, fps, percentDroppedFrames, totalFrames }; } }; /** * @internal * Safe wrapper for the performance resource timing API in web workers with graceful degradation */ class RequestPerformance { constructor(request) { this._marks = { start: [request.url, 'start'].join('#'), end: [request.url, 'end'].join('#'), measure: request.url.toString() }; performance.mark(this._marks.start); } finish() { performance.mark(this._marks.end); let resourceTimingData = performance.getEntriesByName(this._marks.measure); // fallback if web worker implementation of perf.getEntriesByName returns empty if (resourceTimingData.length === 0) { performance.measure(this._marks.measure, this._marks.start, this._marks.end); resourceTimingData = performance.getEntriesByName(this._marks.measure); // cleanup performance.clearMarks(this._marks.start); performance.clearMarks(this._marks.end); performance.clearMeasures(this._marks.measure); } return resourceTimingData; } } var performance$1 = performance; var pos3dAttributes = createLayout([ { name: 'a_pos3d', type: 'Int16', components: 3 } ]); /** * @internal * This class is a helper for the Terrain-class, it: * * - loads raster-dem tiles * - manages all renderToTexture tiles. * - caches previous rendered tiles. * - finds all necessary renderToTexture tiles for a OverscaledTileID area * - finds the corresponding raster-dem tile for OverscaledTileID */ class TerrainSourceCache extends Evented { constructor(sourceCache) { super(); this.sourceCache = sourceCache; this._tiles = {}; this._renderableTilesKeys = []; this._sourceTileCache = {}; this.minzoom = 0; this.maxzoom = 22; this.tileSize = 512; this.deltaZoom = 1; sourceCache.usedForTerrain = true; sourceCache.tileSize = this.tileSize * 2 ** this.deltaZoom; } destruct() { this.sourceCache.usedForTerrain = false; this.sourceCache.tileSize = null; } /** * Load Terrain Tiles, create internal render-to-texture tiles, free GPU memory. * @param transform - the operation to do * @param terrain - the terrain */ update(transform, terrain) { // load raster-dem tiles for the current scene. this.sourceCache.update(transform, terrain); // create internal render-to-texture tiles for the current scene. this._renderableTilesKeys = []; const keys = {}; for (const tileID of transform.coveringTiles({ tileSize: this.tileSize, minzoom: this.minzoom, maxzoom: this.maxzoom, reparseOverscaled: false, terrain })) { keys[tileID.key] = true; this._renderableTilesKeys.push(tileID.key); if (!this._tiles[tileID.key]) { tileID.posMatrix = new Float64Array(16); ortho(tileID.posMatrix, 0, EXTENT, 0, EXTENT, 0, 1); this._tiles[tileID.key] = new Tile(tileID, this.tileSize); } } // free unused tiles for (const key in this._tiles) { if (!keys[key]) delete this._tiles[key]; } } /** * Free render to texture cache * @param tileID - optional, free only corresponding to tileID. */ freeRtt(tileID) { for (const key in this._tiles) { const tile = this._tiles[key]; if (!tileID || tile.tileID.equals(tileID) || tile.tileID.isChildOf(tileID) || tileID.isChildOf(tile.tileID)) tile.rtt = []; } } /** * get a list of tiles, which are loaded and should be rendered in the current scene * @returns the renderable tiles */ getRenderableTiles() { return this._renderableTilesKeys.map(key => this.getTileByID(key)); } /** * get terrain tile by the TileID key * @param id - the tile id * @returns the tile */ getTileByID(id) { return this._tiles[id]; } /** * Searches for the corresponding current renderable terrain-tiles * @param tileID - the tile to look for * @returns the tiles that were found */ getTerrainCoords(tileID) { const coords = {}; for (const key of this._renderableTilesKeys) { const _tileID = this._tiles[key].tileID; if (_tileID.canonical.equals(tileID.canonical)) { const coord = tileID.clone(); coord.posMatrix = new Float64Array(16); ortho(coord.posMatrix, 0, EXTENT, 0, EXTENT, 0, 1); coords[key] = coord; } else if (_tileID.canonical.isChildOf(tileID.canonical)) { const coord = tileID.clone(); coord.posMatrix = new Float64Array(16); const dz = _tileID.canonical.z - tileID.canonical.z; const dx = _tileID.canonical.x - (_tileID.canonical.x >> dz << dz); const dy = _tileID.canonical.y - (_tileID.canonical.y >> dz << dz); const size = EXTENT >> dz; ortho(coord.posMatrix, 0, size, 0, size, 0, 1); translate$1(coord.posMatrix, coord.posMatrix, [-dx * size, -dy * size, 0]); coords[key] = coord; } else if (tileID.canonical.isChildOf(_tileID.canonical)) { const coord = tileID.clone(); coord.posMatrix = new Float64Array(16); const dz = tileID.canonical.z - _tileID.canonical.z; const dx = tileID.canonical.x - (tileID.canonical.x >> dz << dz); const dy = tileID.canonical.y - (tileID.canonical.y >> dz << dz); const size = EXTENT >> dz; ortho(coord.posMatrix, 0, EXTENT, 0, EXTENT, 0, 1); translate$1(coord.posMatrix, coord.posMatrix, [dx * size, dy * size, 0]); scale$5(coord.posMatrix, coord.posMatrix, [1 / (2 ** dz), 1 / (2 ** dz), 0]); coords[key] = coord; } } return coords; } /** * find the covering raster-dem tile * @param tileID - the tile to look for * @param searchForDEM - Optional parameter to search for (parent) sourcetiles with loaded dem. * @returns the tile */ getSourceTile(tileID, searchForDEM) { const source = this.sourceCache._source; let z = tileID.overscaledZ - this.deltaZoom; if (z > source.maxzoom) z = source.maxzoom; if (z < source.minzoom) return null; // cache for tileID to terrain-tileID if (!this._sourceTileCache[tileID.key]) this._sourceTileCache[tileID.key] = tileID.scaledTo(z).key; let tile = this.sourceCache.getTileByID(this._sourceTileCache[tileID.key]); // during tile-loading phase look if parent tiles (with loaded dem) are available. if (!(tile && tile.dem) && searchForDEM) while (z >= source.minzoom && !(tile && tile.dem)) tile = this.sourceCache.getTileByID(tileID.scaledTo(z--).key); return tile; } /** * get a list of tiles, loaded after a specific time. This is used to update depth & coords framebuffers. * @param time - the time * @returns the relevant tiles */ tilesAfterTime(time = Date.now()) { return Object.values(this._tiles).filter(t => t.timeAdded >= time); } } /** * @internal * This is the main class which handles most of the 3D Terrain logic. It has the following topics: * * 1. loads raster-dem tiles via the internal sourceCache this.sourceCache * 2. creates a depth-framebuffer, which is used to calculate the visibility of coordinates * 3. creates a coords-framebuffer, which is used the get to tile-coordinate for a screen-pixel * 4. stores all render-to-texture tiles in the this.sourceCache._tiles * 5. calculates the elevation for a specific tile-coordinate * 6. creates a terrain-mesh * * A note about the GPU resource-usage: * * Framebuffers: * * - one for the depth & coords framebuffer with the size of the map-div. * - one for rendering a tile to texture with the size of tileSize (= 512x512). * * Textures: * * - one texture for an empty raster-dem tile with size 1x1 * - one texture for an empty depth-buffer, when terrain is disabled with size 1x1 * - one texture for an each loaded raster-dem with size of the source.tileSize * - one texture for the coords-framebuffer with the size of the map-div. * - one texture for the depth-framebuffer with the size of the map-div. * - one texture for the encoded tile-coords with the size 2*tileSize (=1024x1024) * - finally for each render-to-texture tile (= this._tiles) a set of textures * for each render stack (The stack-concept is documented in painter.ts). * * Normally there exists 1-3 Textures per tile, depending on the stylesheet. * Each Textures has the size 2*tileSize (= 1024x1024). Also there exists a * cache of the last 150 newest rendered tiles. * */ class Terrain { constructor(painter, sourceCache, options) { this.painter = painter; this.sourceCache = new TerrainSourceCache(sourceCache); this.options = options; this.exaggeration = typeof options.exaggeration === 'number' ? options.exaggeration : 1.0; this.qualityFactor = 2; this.meshSize = 128; this._demMatrixCache = {}; this.coordsIndex = []; this._coordsTextureSize = 1024; } /** * get the elevation-value from original dem-data for a given tile-coordinate * @param tileID - the tile to get elevation for * @param x - between 0 .. EXTENT * @param y - between 0 .. EXTENT * @param extent - optional, default 8192 * @returns the elevation */ getDEMElevation(tileID, x, y, extent = EXTENT) { var _a; if (!(x >= 0 && x < extent && y >= 0 && y < extent)) return 0; const terrain = this.getTerrainData(tileID); const dem = (_a = terrain.tile) === null || _a === void 0 ? void 0 : _a.dem; if (!dem) return 0; const pos = transformMat4([], [x / extent * EXTENT, y / extent * EXTENT], terrain.u_terrain_matrix); const coord = [pos[0] * dem.dim, pos[1] * dem.dim]; // bilinear interpolation const cx = Math.floor(coord[0]), cy = Math.floor(coord[1]), tx = coord[0] - cx, ty = coord[1] - cy; return (dem.get(cx, cy) * (1 - tx) * (1 - ty) + dem.get(cx + 1, cy) * (tx) * (1 - ty) + dem.get(cx, cy + 1) * (1 - tx) * (ty) + dem.get(cx + 1, cy + 1) * (tx) * (ty)); } /** * Get the elevation for given {@link LngLat} in respect of exaggeration. * @param lnglat - the location * @param zoom - the zoom * @returns the elevation */ getElevationForLngLatZoom(lnglat, zoom) { if (!isInBoundsForZoomLngLat(zoom, lnglat.wrap())) return 0; const { tileID, mercatorX, mercatorY } = this._getOverscaledTileIDFromLngLatZoom(lnglat, zoom); return this.getElevation(tileID, mercatorX % EXTENT, mercatorY % EXTENT, EXTENT); } /** * Get the elevation for given coordinate in respect of exaggeration. * @param tileID - the tile id * @param x - between 0 .. EXTENT * @param y - between 0 .. EXTENT * @param extent - optional, default 8192 * @returns the elevation */ getElevation(tileID, x, y, extent = EXTENT) { return this.getDEMElevation(tileID, x, y, extent) * this.exaggeration; } /** * returns a Terrain Object for a tile. Unless the tile corresponds to data (e.g. tile is loading), return a flat dem object * @param tileID - the tile to get the terrain for * @returns the terrain data to use in the program */ getTerrainData(tileID) { // create empty DEM Objects, which will used while raster-dem tiles are loading. // creates an empty depth-buffer texture which is needed, during the initialization process of the 3d mesh.. if (!this._emptyDemTexture) { const context = this.painter.context; const image = new RGBAImage({ width: 1, height: 1 }, new Uint8Array(1 * 4)); this._emptyDepthTexture = new Texture(context, image, context.gl.RGBA, { premultiply: false }); this._emptyDemUnpack = [0, 0, 0, 0]; this._emptyDemTexture = new Texture(context, new RGBAImage({ width: 1, height: 1 }), context.gl.RGBA, { premultiply: false }); this._emptyDemTexture.bind(context.gl.NEAREST, context.gl.CLAMP_TO_EDGE); this._emptyDemMatrix = identity$2([]); } // find covering dem tile and prepare demTexture const sourceTile = this.sourceCache.getSourceTile(tileID, true); if (sourceTile && sourceTile.dem && (!sourceTile.demTexture || sourceTile.needsTerrainPrepare)) { const context = this.painter.context; sourceTile.demTexture = this.painter.getTileTexture(sourceTile.dem.stride); if (sourceTile.demTexture) sourceTile.demTexture.update(sourceTile.dem.getPixels(), { premultiply: false }); else sourceTile.demTexture = new Texture(context, sourceTile.dem.getPixels(), context.gl.RGBA, { premultiply: false }); sourceTile.demTexture.bind(context.gl.NEAREST, context.gl.CLAMP_TO_EDGE); sourceTile.needsTerrainPrepare = false; } // create matrix for lookup in dem data const matrixKey = sourceTile && (sourceTile + sourceTile.tileID.key) + tileID.key; if (matrixKey && !this._demMatrixCache[matrixKey]) { const maxzoom = this.sourceCache.sourceCache._source.maxzoom; let dz = tileID.canonical.z - sourceTile.tileID.canonical.z; if (tileID.overscaledZ > tileID.canonical.z) { if (tileID.canonical.z >= maxzoom) dz = tileID.canonical.z - maxzoom; else warnOnce('cannot calculate elevation if elevation maxzoom > source.maxzoom'); } const dx = tileID.canonical.x - (tileID.canonical.x >> dz << dz); const dy = tileID.canonical.y - (tileID.canonical.y >> dz << dz); const demMatrix = fromScaling(new Float64Array(16), [1 / (EXTENT << dz), 1 / (EXTENT << dz), 0]); translate$1(demMatrix, demMatrix, [dx * EXTENT, dy * EXTENT, 0]); this._demMatrixCache[tileID.key] = { matrix: demMatrix, coord: tileID }; } // return uniform values & textures return { 'u_depth': 2, 'u_terrain': 3, 'u_terrain_dim': sourceTile && sourceTile.dem && sourceTile.dem.dim || 1, 'u_terrain_matrix': matrixKey ? this._demMatrixCache[tileID.key].matrix : this._emptyDemMatrix, 'u_terrain_unpack': sourceTile && sourceTile.dem && sourceTile.dem.getUnpackVector() || this._emptyDemUnpack, 'u_terrain_exaggeration': this.exaggeration, texture: (sourceTile && sourceTile.demTexture || this._emptyDemTexture).texture, depthTexture: (this._fboDepthTexture || this._emptyDepthTexture).texture, tile: sourceTile }; } /** * get a framebuffer as big as the map-div, which will be used to render depth & coords into a texture * @param texture - the texture * @returns the frame buffer */ getFramebuffer(texture) { const painter = this.painter; const width = painter.width / devicePixelRatio; const height = painter.height / devicePixelRatio; if (this._fbo && (this._fbo.width !== width || this._fbo.height !== height)) { this._fbo.destroy(); this._fboCoordsTexture.destroy(); this._fboDepthTexture.destroy(); delete this._fbo; delete this._fboDepthTexture; delete this._fboCoordsTexture; } if (!this._fboCoordsTexture) { this._fboCoordsTexture = new Texture(painter.context, { width, height, data: null }, painter.context.gl.RGBA, { premultiply: false }); this._fboCoordsTexture.bind(painter.context.gl.NEAREST, painter.context.gl.CLAMP_TO_EDGE); } if (!this._fboDepthTexture) { this._fboDepthTexture = new Texture(painter.context, { width, height, data: null }, painter.context.gl.RGBA, { premultiply: false }); this._fboDepthTexture.bind(painter.context.gl.NEAREST, painter.context.gl.CLAMP_TO_EDGE); } if (!this._fbo) { this._fbo = painter.context.createFramebuffer(width, height, true, false); this._fbo.depthAttachment.set(painter.context.createRenderbuffer(painter.context.gl.DEPTH_COMPONENT16, width, height)); } this._fbo.colorAttachment.set(texture === 'coords' ? this._fboCoordsTexture.texture : this._fboDepthTexture.texture); return this._fbo; } /** * create coords texture, needed to grab coordinates from canvas * encode coords coordinate into 4 bytes: * - 8 lower bits for x * - 8 lower bits for y * - 4 higher bits for x * - 4 higher bits for y * - 8 bits for coordsIndex (1 .. 255) (= number of terraintile), is later setted in draw_terrain uniform value * @returns the texture */ getCoordsTexture() { const context = this.painter.context; if (this._coordsTexture) return this._coordsTexture; const data = new Uint8Array(this._coordsTextureSize * this._coordsTextureSize * 4); for (let y = 0, i = 0; y < this._coordsTextureSize; y++) for (let x = 0; x < this._coordsTextureSize; x++, i += 4) { data[i + 0] = x & 255; data[i + 1] = y & 255; data[i + 2] = ((x >> 8) << 4) | (y >> 8); data[i + 3] = 0; } const image = new RGBAImage({ width: this._coordsTextureSize, height: this._coordsTextureSize }, new Uint8Array(data.buffer)); const texture = new Texture(context, image, context.gl.RGBA, { premultiply: false }); texture.bind(context.gl.NEAREST, context.gl.CLAMP_TO_EDGE); this._coordsTexture = texture; return texture; } /** * Reads a pixel from the coords-framebuffer and translate this to mercator. * @param p - Screen-Coordinate * @returns mercator coordinate for a screen pixel */ pointCoordinate(p) { // First, ensure the coords framebuffer is up to date. this.painter.maybeDrawDepthAndCoords(true); const rgba = new Uint8Array(4); const context = this.painter.context, gl = context.gl; const px = Math.round(p.x * this.painter.pixelRatio / devicePixelRatio); const py = Math.round(p.y * this.painter.pixelRatio / devicePixelRatio); const fbHeight = Math.round(this.painter.height / devicePixelRatio); // grab coordinate pixel from coordinates framebuffer context.bindFramebuffer.set(this.getFramebuffer('coords').framebuffer); gl.readPixels(px, fbHeight - py - 1, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, rgba); context.bindFramebuffer.set(null); // decode coordinates (encoding see getCoordsTexture) const x = rgba[0] + ((rgba[2] >> 4) << 8); const y = rgba[1] + ((rgba[2] & 15) << 8); const tileID = this.coordsIndex[255 - rgba[3]]; const tile = tileID && this.sourceCache.getTileByID(tileID); if (!tile) return null; const coordsSize = this._coordsTextureSize; const worldSize = (1 << tile.tileID.canonical.z) * coordsSize; return new MercatorCoordinate((tile.tileID.canonical.x * coordsSize + x) / worldSize + tile.tileID.wrap, (tile.tileID.canonical.y * coordsSize + y) / worldSize, this.getElevation(tile.tileID, x, y, coordsSize)); } /** * Reads the depth value from the depth-framebuffer at a given screen pixel * @param p - Screen coordinate * @returns depth value in clip space (between 0 and 1) */ depthAtPoint(p) { const rgba = new Uint8Array(4); const context = this.painter.context, gl = context.gl; context.bindFramebuffer.set(this.getFramebuffer('depth').framebuffer); gl.readPixels(p.x, this.painter.height / devicePixelRatio - p.y - 1, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, rgba); context.bindFramebuffer.set(null); // decode coordinates (encoding see terran_depth.fragment.glsl) const depthValue = (rgba[0] / (256 * 256 * 256) + rgba[1] / (256 * 256) + rgba[2] / 256 + rgba[3]) / 256; return depthValue; } /** * create a regular mesh which will be used by all terrain-tiles * @returns the created regular mesh */ getTerrainMesh() { if (this._mesh) return this._mesh; const context = this.painter.context; const vertexArray = new Pos3dArray(); const indexArray = new TriangleIndexArray(); const meshSize = this.meshSize; const delta = EXTENT / meshSize; const meshSize2 = meshSize * meshSize; for (let y = 0; y <= meshSize; y++) for (let x = 0; x <= meshSize; x++) vertexArray.emplaceBack(x * delta, y * delta, 0); for (let y = 0; y < meshSize2; y += meshSize + 1) for (let x = 0; x < meshSize; x++) { indexArray.emplaceBack(x + y, meshSize + x + y + 1, meshSize + x + y + 2); indexArray.emplaceBack(x + y, meshSize + x + y + 2, x + y + 1); } // add an extra frame around the mesh to avoid stiching on tile boundaries with different zoomlevels // first code-block is for top-bottom frame and second for left-right frame const offsetTop = vertexArray.length, offsetBottom = offsetTop + (meshSize + 1) * 2; for (const y of [0, 1]) for (let x = 0; x <= meshSize; x++) for (const z of [0, 1]) vertexArray.emplaceBack(x * delta, y * EXTENT, z); for (let x = 0; x < meshSize * 2; x += 2) { indexArray.emplaceBack(offsetBottom + x, offsetBottom + x + 1, offsetBottom + x + 3); indexArray.emplaceBack(offsetBottom + x, offsetBottom + x + 3, offsetBottom + x + 2); indexArray.emplaceBack(offsetTop + x, offsetTop + x + 3, offsetTop + x + 1); indexArray.emplaceBack(offsetTop + x, offsetTop + x + 2, offsetTop + x + 3); } const offsetLeft = vertexArray.length, offsetRight = offsetLeft + (meshSize + 1) * 2; for (const x of [0, 1]) for (let y = 0; y <= meshSize; y++) for (const z of [0, 1]) vertexArray.emplaceBack(x * EXTENT, y * delta, z); for (let y = 0; y < meshSize * 2; y += 2) { indexArray.emplaceBack(offsetLeft + y, offsetLeft + y + 1, offsetLeft + y + 3); indexArray.emplaceBack(offsetLeft + y, offsetLeft + y + 3, offsetLeft + y + 2); indexArray.emplaceBack(offsetRight + y, offsetRight + y + 3, offsetRight + y + 1); indexArray.emplaceBack(offsetRight + y, offsetRight + y + 2, offsetRight + y + 3); } this._mesh = new Mesh(context.createVertexBuffer(vertexArray, pos3dAttributes.members), context.createIndexBuffer(indexArray), SegmentVector.simpleSegment(0, 0, vertexArray.length, indexArray.length)); return this._mesh; } /** * Calculates a height of the frame around the terrain-mesh to avoid stiching between * tile boundaries in different zoomlevels. * @param zoom - current zoomlevel * @returns the elevation delta in meters */ getMeshFrameDelta(zoom) { // divide by 5 is evaluated by trial & error to get a frame in the right height return 2 * Math.PI * earthRadius / Math.pow(2, zoom) / 5; } getMinTileElevationForLngLatZoom(lnglat, zoom) { var _a; const { tileID } = this._getOverscaledTileIDFromLngLatZoom(lnglat, zoom); return (_a = this.getMinMaxElevation(tileID).minElevation) !== null && _a !== void 0 ? _a : 0; } /** * Get the minimum and maximum elevation contained in a tile. This includes any * exaggeration included in the terrain. * * @param tileID - ID of the tile to be used as a source for the min/max elevation * @returns the minimum and maximum elevation found in the tile, including the terrain's * exaggeration */ getMinMaxElevation(tileID) { const tile = this.getTerrainData(tileID).tile; const minMax = { minElevation: null, maxElevation: null }; if (tile && tile.dem) { minMax.minElevation = tile.dem.min * this.exaggeration; minMax.maxElevation = tile.dem.max * this.exaggeration; } return minMax; } _getOverscaledTileIDFromLngLatZoom(lnglat, zoom) { const mercatorCoordinate = MercatorCoordinate.fromLngLat(lnglat.wrap()); const worldSize = (1 << zoom) * EXTENT; const mercatorX = mercatorCoordinate.x * worldSize; const mercatorY = mercatorCoordinate.y * worldSize; const tileX = Math.floor(mercatorX / EXTENT), tileY = Math.floor(mercatorY / EXTENT); const tileID = new OverscaledTileID(zoom, 0, zoom, tileX, tileY); return { tileID, mercatorX, mercatorY }; } } /** * @internal * `RenderPool` is a resource pool for textures and framebuffers */ class RenderPool { constructor(_context, _size, _tileSize) { this._context = _context; this._size = _size; this._tileSize = _tileSize; this._objects = []; this._recentlyUsed = []; this._stamp = 0; } destruct() { for (const obj of this._objects) { obj.texture.destroy(); obj.fbo.destroy(); } } _createObject(id) { const fbo = this._context.createFramebuffer(this._tileSize, this._tileSize, true, true); const texture = new Texture(this._context, { width: this._tileSize, height: this._tileSize, data: null }, this._context.gl.RGBA); texture.bind(this._context.gl.LINEAR, this._context.gl.CLAMP_TO_EDGE); fbo.depthAttachment.set(this._context.createRenderbuffer(this._context.gl.DEPTH_STENCIL, this._tileSize, this._tileSize)); fbo.colorAttachment.set(texture.texture); return { id, fbo, texture, stamp: -1, inUse: false }; } getObjectForId(id) { return this._objects[id]; } useObject(obj) { obj.inUse = true; this._recentlyUsed = this._recentlyUsed.filter(id => obj.id !== id); this._recentlyUsed.push(obj.id); } stampObject(obj) { obj.stamp = ++this._stamp; } getOrCreateFreeObject() { // check for free existing object for (const id of this._recentlyUsed) { if (!this._objects[id].inUse) return this._objects[id]; } if (this._objects.length >= this._size) throw new Error('No free RenderPool available, call freeAllObjects() required!'); // create new object const obj = this._createObject(this._objects.length); this._objects.push(obj); return obj; } freeObject(obj) { obj.inUse = false; } freeAllObjects() { for (const obj of this._objects) this.freeObject(obj); } isFull() { if (this._objects.length < this._size) { return false; } return this._objects.some(o => !o.inUse) === false; } } /** * lookup table which layers should rendered to texture */ const LAYERS = { background: true, fill: true, line: true, raster: true, hillshade: true }; /** * @internal * A helper class to help define what should be rendered to texture and how */ class RenderToTexture { constructor(painter, terrain) { this.painter = painter; this.terrain = terrain; this.pool = new RenderPool(painter.context, 30, terrain.sourceCache.tileSize * terrain.qualityFactor); } destruct() { this.pool.destruct(); } getTexture(tile) { return this.pool.getObjectForId(tile.rtt[this._stacks.length - 1].id).texture; } prepareForRender(style, zoom) { this._stacks = []; this._prevType = null; this._rttTiles = []; this._renderableTiles = this.terrain.sourceCache.getRenderableTiles(); this._renderableLayerIds = style._order.filter(id => !style._layers[id].isHidden(zoom)); this._coordsDescendingInv = {}; for (const id in style.sourceCaches) { this._coordsDescendingInv[id] = {}; const tileIDs = style.sourceCaches[id].getVisibleCoordinates(); for (const tileID of tileIDs) { const keys = this.terrain.sourceCache.getTerrainCoords(tileID); for (const key in keys) { if (!this._coordsDescendingInv[id][key]) this._coordsDescendingInv[id][key] = []; this._coordsDescendingInv[id][key].push(keys[key]); } } } this._coordsDescendingInvStr = {}; for (const id of style._order) { const layer = style._layers[id], source = layer.source; if (LAYERS[layer.type]) { if (!this._coordsDescendingInvStr[source]) { this._coordsDescendingInvStr[source] = {}; for (const key in this._coordsDescendingInv[source]) this._coordsDescendingInvStr[source][key] = this._coordsDescendingInv[source][key].map(c => c.key).sort().join(); } } } // check tiles to render for (const tile of this._renderableTiles) { for (const source in this._coordsDescendingInvStr) { // rerender if there are more coords to render than in the last rendering const coords = this._coordsDescendingInvStr[source][tile.tileID.key]; if (coords && coords !== tile.rttCoords[source]) tile.rtt = []; } } } /** * due that switching textures is relatively slow, the render * layer-by-layer context is not practicable. To bypass this problem * this lines of code stack all layers and later render all at once. * Because of the stylesheet possibility to mixing render-to-texture layers * and 'live'-layers (f.e. symbols) it is necessary to create more stacks. For example * a symbol-layer is in between of fill-layers. * @param layer - the layer to render * @returns if true layer is rendered to texture, otherwise false */ renderLayer(layer) { if (layer.isHidden(this.painter.transform.zoom)) return false; const type = layer.type; const painter = this.painter; const isLastLayer = this._renderableLayerIds[this._renderableLayerIds.length - 1] === layer.id; // remember background, fill, line & raster layer to render into a stack if (LAYERS[type]) { // create a new stack if previous layer was not rendered to texture (f.e. symbols) if (!this._prevType || !LAYERS[this._prevType]) this._stacks.push([]); // push current render-to-texture layer to render-stack this._prevType = type; this._stacks[this._stacks.length - 1].push(layer.id); // rendering is done later, all in once if (!isLastLayer) return true; } // in case a stack is finished render all collected stack-layers into a texture if (LAYERS[this._prevType] || (LAYERS[type] && isLastLayer)) { this._prevType = type; const stack = this._stacks.length - 1, layers = this._stacks[stack] || []; for (const tile of this._renderableTiles) { // if render pool is full draw current tiles to screen and free pool if (this.pool.isFull()) { drawTerrain(this.painter, this.terrain, this._rttTiles); this._rttTiles = []; this.pool.freeAllObjects(); } this._rttTiles.push(tile); // check for cached PoolObject if (tile.rtt[stack]) { const obj = this.pool.getObjectForId(tile.rtt[stack].id); if (obj.stamp === tile.rtt[stack].stamp) { this.pool.useObject(obj); continue; } } // get free PoolObject const obj = this.pool.getOrCreateFreeObject(); this.pool.useObject(obj); this.pool.stampObject(obj); tile.rtt[stack] = { id: obj.id, stamp: obj.stamp }; // prepare PoolObject for rendering painter.context.bindFramebuffer.set(obj.fbo.framebuffer); painter.context.clear({ color: Color.transparent, stencil: 0 }); painter.currentStencilSource = undefined; for (let l = 0; l < layers.length; l++) { const layer = painter.style._layers[layers[l]]; const coords = layer.source ? this._coordsDescendingInv[layer.source][tile.tileID.key] : [tile.tileID]; painter.context.viewport.set([0, 0, obj.fbo.width, obj.fbo.height]); painter._renderTileClippingMasks(layer, coords); painter.renderLayer(painter, painter.style.sourceCaches[layer.source], layer, coords); if (layer.source) tile.rttCoords[layer.source] = this._coordsDescendingInvStr[layer.source][tile.tileID.key]; } } drawTerrain(this.painter, this.terrain, this._rttTiles); this._rttTiles = []; this.pool.freeAllObjects(); return LAYERS[type]; } return false; } } const defaultLocale = { 'AttributionControl.ToggleAttribution': 'Toggle attribution', 'AttributionControl.MapFeedback': 'Map feedback', 'FullscreenControl.Enter': 'Enter fullscreen', 'FullscreenControl.Exit': 'Exit fullscreen', 'GeolocateControl.FindMyLocation': 'Find my location', 'GeolocateControl.LocationNotAvailable': 'Location not available', 'LogoControl.Title': 'MapLibre logo', 'Map.Title': 'Map', 'Marker.Title': 'Map marker', 'NavigationControl.ResetBearing': 'Reset bearing to north', 'NavigationControl.ZoomIn': 'Zoom in', 'NavigationControl.ZoomOut': 'Zoom out', 'Popup.Close': 'Close popup', 'ScaleControl.Feet': 'ft', 'ScaleControl.Meters': 'm', 'ScaleControl.Kilometers': 'km', 'ScaleControl.Miles': 'mi', 'ScaleControl.NauticalMiles': 'nm', 'TerrainControl.Enable': 'Enable terrain', 'TerrainControl.Disable': 'Disable terrain', 'CooperativeGesturesHandler.WindowsHelpText': 'Use Ctrl + scroll to zoom the map', 'CooperativeGesturesHandler.MacHelpText': 'Use ⌘ + scroll to zoom the map', 'CooperativeGesturesHandler.MobileHelpText': 'Use two fingers to move the map', }; const version$1 = packageJSON.version; const defaultMinZoom = -2; const defaultMaxZoom = 22; // the default values, but also the valid range const defaultMinPitch = 0; const defaultMaxPitch = 60; // use this variable to check maxPitch for validity const maxPitchThreshold = 85; const defaultOptions$4 = { hash: false, interactive: true, bearingSnap: 7, attributionControl: defaultAttributionControlOptions, maplibreLogo: false, failIfMajorPerformanceCaveat: false, preserveDrawingBuffer: false, refreshExpiredTiles: true, scrollZoom: true, minZoom: defaultMinZoom, maxZoom: defaultMaxZoom, minPitch: defaultMinPitch, maxPitch: defaultMaxPitch, boxZoom: true, dragRotate: true, dragPan: true, keyboard: true, doubleClickZoom: true, touchZoomRotate: true, touchPitch: true, cooperativeGestures: false, trackResize: true, center: [0, 0], zoom: 0, bearing: 0, pitch: 0, renderWorldCopies: true, maxTileCacheSize: null, maxTileCacheZoomLevels: config.MAX_TILE_CACHE_ZOOM_LEVELS, transformRequest: null, transformCameraUpdate: null, fadeDuration: 300, crossSourceCollisions: true, clickTolerance: 3, localIdeographFontFamily: 'sans-serif', pitchWithRotate: true, validateStyle: true, /**Because GL MAX_TEXTURE_SIZE is usually at least 4096px. */ maxCanvasSize: [4096, 4096], cancelPendingTileRequestsWhileZooming: true }; /** * The `Map` object represents the map on your page. It exposes methods * and properties that enable you to programmatically change the map, * and fires events as users interact with it. * * You create a `Map` by specifying a `container` and other options, see {@link MapOptions} for the full list. * Then MapLibre GL JS initializes the map on the page and returns your `Map` object. * * @group Main * * @example * ```ts * let map = new Map({ * container: 'map', * center: [-122.420679, 37.772537], * zoom: 13, * style: style_object, * hash: true, * transformRequest: (url, resourceType)=> { * if(resourceType === 'Source' && url.startsWith('http://myHost')) { * return { * url: url.replace('http', 'https'), * headers: { 'my-custom-header': true}, * credentials: 'include' // Include cookies for cross-origin requests * } * } * } * }); * ``` * @see [Display a map](https://maplibre.org/maplibre-gl-js/docs/examples/simple-map/) */ let Map$1 = class Map extends Camera { constructor(options) { PerformanceUtils.mark(PerformanceMarkers.create); const resolvedOptions = Object.assign(Object.assign({}, defaultOptions$4), options); if (resolvedOptions.minZoom != null && resolvedOptions.maxZoom != null && resolvedOptions.minZoom > resolvedOptions.maxZoom) { throw new Error('maxZoom must be greater than or equal to minZoom'); } if (resolvedOptions.minPitch != null && resolvedOptions.maxPitch != null && resolvedOptions.minPitch > resolvedOptions.maxPitch) { throw new Error('maxPitch must be greater than or equal to minPitch'); } if (resolvedOptions.minPitch != null && resolvedOptions.minPitch < defaultMinPitch) { throw new Error(`minPitch must be greater than or equal to ${defaultMinPitch}`); } if (resolvedOptions.maxPitch != null && resolvedOptions.maxPitch > maxPitchThreshold) { throw new Error(`maxPitch must be less than or equal to ${maxPitchThreshold}`); } const transform = new Transform(resolvedOptions.minZoom, resolvedOptions.maxZoom, resolvedOptions.minPitch, resolvedOptions.maxPitch, resolvedOptions.renderWorldCopies); super(transform, { bearingSnap: resolvedOptions.bearingSnap }); this._idleTriggered = false; this._crossFadingFactor = 1; this._renderTaskQueue = new TaskQueue(); this._controls = []; this._mapId = uniqueId(); this._contextLost = (event) => { event.preventDefault(); if (this._frameRequest) { this._frameRequest.abort(); this._frameRequest = null; } this.fire(new Event('webglcontextlost', { originalEvent: event })); }; this._contextRestored = (event) => { this._setupPainter(); this.resize(); this._update(); this.fire(new Event('webglcontextrestored', { originalEvent: event })); }; this._onMapScroll = (event) => { if (event.target !== this._container) return; // Revert any scroll which would move the canvas outside of the view this._container.scrollTop = 0; this._container.scrollLeft = 0; return false; }; this._onWindowOnline = () => { this._update(); }; this._interactive = resolvedOptions.interactive; this._maxTileCacheSize = resolvedOptions.maxTileCacheSize; this._maxTileCacheZoomLevels = resolvedOptions.maxTileCacheZoomLevels; this._failIfMajorPerformanceCaveat = resolvedOptions.failIfMajorPerformanceCaveat === true; this._preserveDrawingBuffer = resolvedOptions.preserveDrawingBuffer === true; this._antialias = resolvedOptions.antialias === true; this._trackResize = resolvedOptions.trackResize === true; this._bearingSnap = resolvedOptions.bearingSnap; this._refreshExpiredTiles = resolvedOptions.refreshExpiredTiles === true; this._fadeDuration = resolvedOptions.fadeDuration; this._crossSourceCollisions = resolvedOptions.crossSourceCollisions === true; this._collectResourceTiming = resolvedOptions.collectResourceTiming === true; this._locale = Object.assign(Object.assign({}, defaultLocale), resolvedOptions.locale); this._clickTolerance = resolvedOptions.clickTolerance; this._overridePixelRatio = resolvedOptions.pixelRatio; this._maxCanvasSize = resolvedOptions.maxCanvasSize; this.transformCameraUpdate = resolvedOptions.transformCameraUpdate; this.cancelPendingTileRequestsWhileZooming = resolvedOptions.cancelPendingTileRequestsWhileZooming === true; this._imageQueueHandle = ImageRequest.addThrottleControl(() => this.isMoving()); this._requestManager = new RequestManager(resolvedOptions.transformRequest); if (typeof resolvedOptions.container === 'string') { this._container = document.getElementById(resolvedOptions.container); if (!this._container) { throw new Error(`Container '${resolvedOptions.container}' not found.`); } } else if (resolvedOptions.container instanceof HTMLElement) { this._container = resolvedOptions.container; } else { throw new Error('Invalid type: \'container\' must be a String or HTMLElement.'); } if (resolvedOptions.maxBounds) { this.setMaxBounds(resolvedOptions.maxBounds); } this._setupContainer(); this._setupPainter(); this.on('move', () => this._update(false)) .on('moveend', () => this._update(false)) .on('zoom', () => this._update(true)) .on('terrain', () => { this.painter.terrainFacilitator.dirty = true; this._update(true); }) .once('idle', () => { this._idleTriggered = true; }); if (typeof window !== 'undefined') { addEventListener('online', this._onWindowOnline, false); let initialResizeEventCaptured = false; const throttledResizeCallback = throttle((entries) => { if (this._trackResize && !this._removed) { this.resize(entries); this.redraw(); } }, 50); this._resizeObserver = new ResizeObserver((entries) => { if (!initialResizeEventCaptured) { initialResizeEventCaptured = true; return; } throttledResizeCallback(entries); }); this._resizeObserver.observe(this._container); } this.handlers = new HandlerManager(this, resolvedOptions); const hashName = (typeof resolvedOptions.hash === 'string' && resolvedOptions.hash) || undefined; this._hash = resolvedOptions.hash && (new Hash(hashName)).addTo(this); // don't set position from options if set through hash if (!this._hash || !this._hash._onHashChange()) { this.jumpTo({ center: resolvedOptions.center, zoom: resolvedOptions.zoom, bearing: resolvedOptions.bearing, pitch: resolvedOptions.pitch }); if (resolvedOptions.bounds) { this.resize(); this.fitBounds(resolvedOptions.bounds, extend({}, resolvedOptions.fitBoundsOptions, { duration: 0 })); } } this.resize(); this._localIdeographFontFamily = resolvedOptions.localIdeographFontFamily; this._validateStyle = resolvedOptions.validateStyle; if (resolvedOptions.style) this.setStyle(resolvedOptions.style, { localIdeographFontFamily: resolvedOptions.localIdeographFontFamily }); if (resolvedOptions.attributionControl) this.addControl(new AttributionControl(typeof resolvedOptions.attributionControl === 'boolean' ? undefined : resolvedOptions.attributionControl)); if (resolvedOptions.maplibreLogo) this.addControl(new LogoControl(), resolvedOptions.logoPosition); this.on('style.load', () => { if (this.transform.unmodified) { this.jumpTo(this.style.stylesheet); } }); this.on('data', (event) => { this._update(event.dataType === 'style'); this.fire(new Event(`${event.dataType}data`, event)); }); this.on('dataloading', (event) => { this.fire(new Event(`${event.dataType}dataloading`, event)); }); this.on('dataabort', (event) => { this.fire(new Event('sourcedataabort', event)); }); } /** * @internal * Returns a unique number for this map instance which is used for the MapLoadEvent * to make sure we only fire one event per instantiated map object. * @returns the uniq map ID */ _getMapId() { return this._mapId; } /** * Adds an {@link IControl} to the map, calling `control.onAdd(this)`. * * An {@link ErrorEvent} will be fired if the image parameter is invald. * * @param control - The {@link IControl} to add. * @param position - position on the map to which the control will be added. * Valid values are `'top-left'`, `'top-right'`, `'bottom-left'`, and `'bottom-right'`. Defaults to `'top-right'`. * @example * Add zoom and rotation controls to the map. * ```ts * map.addControl(new NavigationControl()); * ``` * @see [Display map navigation controls](https://maplibre.org/maplibre-gl-js/docs/examples/navigation/) */ addControl(control, position) { if (position === undefined) { if (control.getDefaultPosition) { position = control.getDefaultPosition(); } else { position = 'top-right'; } } if (!control || !control.onAdd) { return this.fire(new ErrorEvent(new Error('Invalid argument to map.addControl(). Argument must be a control with onAdd and onRemove methods.'))); } const controlElement = control.onAdd(this); this._controls.push(control); const positionContainer = this._controlPositions[position]; if (position.indexOf('bottom') !== -1) { positionContainer.insertBefore(controlElement, positionContainer.firstChild); } else { positionContainer.appendChild(controlElement); } return this; } /** * Removes the control from the map. * * An {@link ErrorEvent} will be fired if the image parameter is invald. * * @param control - The {@link IControl} to remove. * @example * ```ts * // Define a new navigation control. * let navigation = new NavigationControl(); * // Add zoom and rotation controls to the map. * map.addControl(navigation); * // Remove zoom and rotation controls from the map. * map.removeControl(navigation); * ``` */ removeControl(control) { if (!control || !control.onRemove) { return this.fire(new ErrorEvent(new Error('Invalid argument to map.removeControl(). Argument must be a control with onAdd and onRemove methods.'))); } const ci = this._controls.indexOf(control); if (ci > -1) this._controls.splice(ci, 1); control.onRemove(this); return this; } /** * Checks if a control exists on the map. * * @param control - The {@link IControl} to check. * @returns true if map contains control. * @example * ```ts * // Define a new navigation control. * let navigation = new NavigationControl(); * // Add zoom and rotation controls to the map. * map.addControl(navigation); * // Check that the navigation control exists on the map. * map.hasControl(navigation); * ``` */ hasControl(control) { return this._controls.indexOf(control) > -1; } calculateCameraOptionsFromTo(from, altitudeFrom, to, altitudeTo) { if (altitudeTo == null && this.terrain) { altitudeTo = this.terrain.getElevationForLngLatZoom(to, this.transform.tileZoom); } return super.calculateCameraOptionsFromTo(from, altitudeFrom, to, altitudeTo); } /** * Resizes the map according to the dimensions of its * `container` element. * * Checks if the map container size changed and updates the map if it has changed. * This method must be called after the map's `container` is resized programmatically * or when the map is shown after being initially hidden with CSS. * * Triggers the following events: `movestart`, `move`, `moveend`, and `resize`. * * @param eventData - Additional properties to be passed to `movestart`, `move`, `resize`, and `moveend` * events that get triggered as a result of resize. This can be useful for differentiating the * source of an event (for example, user-initiated or programmatically-triggered events). * @example * Resize the map when the map container is shown after being initially hidden with CSS. * ```ts * let mapDiv = document.getElementById('map'); * if (mapDiv.style.visibility === true) map.resize(); * ``` */ resize(eventData) { var _a; const dimensions = this._containerDimensions(); const width = dimensions[0]; const height = dimensions[1]; const clampedPixelRatio = this._getClampedPixelRatio(width, height); this._resizeCanvas(width, height, clampedPixelRatio); this.painter.resize(width, height, clampedPixelRatio); // check if we've reached GL limits, in that case further clamps pixelRatio if (this.painter.overLimit()) { const gl = this.painter.context.gl; // store updated _maxCanvasSize value this._maxCanvasSize = [gl.drawingBufferWidth, gl.drawingBufferHeight]; const clampedPixelRatio = this._getClampedPixelRatio(width, height); this._resizeCanvas(width, height, clampedPixelRatio); this.painter.resize(width, height, clampedPixelRatio); } this.transform.resize(width, height); (_a = this._requestedCameraState) === null || _a === void 0 ? void 0 : _a.resize(width, height); const fireMoving = !this._moving; if (fireMoving) { this.stop(); this.fire(new Event('movestart', eventData)) .fire(new Event('move', eventData)); } this.fire(new Event('resize', eventData)); if (fireMoving) this.fire(new Event('moveend', eventData)); return this; } /** * @internal * Return the map's pixel ratio eventually scaled down to respect maxCanvasSize. * Internally you should use this and not getPixelRatio(). */ _getClampedPixelRatio(width, height) { const { 0: maxCanvasWidth, 1: maxCanvasHeight } = this._maxCanvasSize; const pixelRatio = this.getPixelRatio(); const canvasWidth = width * pixelRatio; const canvasHeight = height * pixelRatio; const widthScaleFactor = canvasWidth > maxCanvasWidth ? (maxCanvasWidth / canvasWidth) : 1; const heightScaleFactor = canvasHeight > maxCanvasHeight ? (maxCanvasHeight / canvasHeight) : 1; return Math.min(widthScaleFactor, heightScaleFactor) * pixelRatio; } /** * Returns the map's pixel ratio. * Note that the pixel ratio actually applied may be lower to respect maxCanvasSize. * @returns The pixel ratio. */ getPixelRatio() { var _a; return (_a = this._overridePixelRatio) !== null && _a !== void 0 ? _a : devicePixelRatio; } /** * Sets the map's pixel ratio. This allows to override `devicePixelRatio`. * After this call, the canvas' `width` attribute will be `container.clientWidth * pixelRatio` * and its height attribute will be `container.clientHeight * pixelRatio`. * Set this to null to disable `devicePixelRatio` override. * Note that the pixel ratio actually applied may be lower to respect maxCanvasSize. * @param pixelRatio - The pixel ratio. */ setPixelRatio(pixelRatio) { this._overridePixelRatio = pixelRatio; this.resize(); } /** * Returns the map's geographical bounds. When the bearing or pitch is non-zero, the visible region is not * an axis-aligned rectangle, and the result is the smallest bounds that encompasses the visible region. * @returns The geographical bounds of the map as {@link LngLatBounds}. * @example * ```ts * let bounds = map.getBounds(); * ``` */ getBounds() { return this.transform.getBounds(); } /** * Returns the maximum geographical bounds the map is constrained to, or `null` if none set. * @returns The map object. * @example * ```ts * let maxBounds = map.getMaxBounds(); * ``` */ getMaxBounds() { return this.transform.getMaxBounds(); } /** * Sets or clears the map's geographical bounds. * * Pan and zoom operations are constrained within these bounds. * If a pan or zoom is performed that would * display regions outside these bounds, the map will * instead display a position and zoom level * as close as possible to the operation's request while still * remaining within the bounds. * * @param bounds - The maximum bounds to set. If `null` or `undefined` is provided, the function removes the map's maximum bounds. * @example * Define bounds that conform to the `LngLatBoundsLike` object as set the max bounds. * ```ts * let bounds = [ * [-74.04728, 40.68392], // [west, south] * [-73.91058, 40.87764] // [east, north] * ]; * map.setMaxBounds(bounds); * ``` */ setMaxBounds(bounds) { this.transform.setMaxBounds(LngLatBounds.convert(bounds)); return this._update(); } /** * Sets or clears the map's minimum zoom level. * If the map's current zoom level is lower than the new minimum, * the map will zoom to the new minimum. * * It is not always possible to zoom out and reach the set `minZoom`. * Other factors such as map height may restrict zooming. For example, * if the map is 512px tall it will not be possible to zoom below zoom 0 * no matter what the `minZoom` is set to. * * A {@link ErrorEvent} event will be fired if minZoom is out of bounds. * * @param minZoom - The minimum zoom level to set (-2 - 24). * If `null` or `undefined` is provided, the function removes the current minimum zoom (i.e. sets it to -2). * @example * ```ts * map.setMinZoom(12.25); * ``` */ setMinZoom(minZoom) { minZoom = minZoom === null || minZoom === undefined ? defaultMinZoom : minZoom; if (minZoom >= defaultMinZoom && minZoom <= this.transform.maxZoom) { this.transform.minZoom = minZoom; this._update(); if (this.getZoom() < minZoom) this.setZoom(minZoom); return this; } else throw new Error(`minZoom must be between ${defaultMinZoom} and the current maxZoom, inclusive`); } /** * Returns the map's minimum allowable zoom level. * * @returns minZoom * @example * ```ts * let minZoom = map.getMinZoom(); * ``` */ getMinZoom() { return this.transform.minZoom; } /** * Sets or clears the map's maximum zoom level. * If the map's current zoom level is higher than the new maximum, * the map will zoom to the new maximum. * * A {@link ErrorEvent} event will be fired if minZoom is out of bounds. * * @param maxZoom - The maximum zoom level to set. * If `null` or `undefined` is provided, the function removes the current maximum zoom (sets it to 22). * @example * ```ts * map.setMaxZoom(18.75); * ``` */ setMaxZoom(maxZoom) { maxZoom = maxZoom === null || maxZoom === undefined ? defaultMaxZoom : maxZoom; if (maxZoom >= this.transform.minZoom) { this.transform.maxZoom = maxZoom; this._update(); if (this.getZoom() > maxZoom) this.setZoom(maxZoom); return this; } else throw new Error('maxZoom must be greater than the current minZoom'); } /** * Returns the map's maximum allowable zoom level. * * @returns The maxZoom * @example * ```ts * let maxZoom = map.getMaxZoom(); * ``` */ getMaxZoom() { return this.transform.maxZoom; } /** * Sets or clears the map's minimum pitch. * If the map's current pitch is lower than the new minimum, * the map will pitch to the new minimum. * * A {@link ErrorEvent} event will be fired if minPitch is out of bounds. * * @param minPitch - The minimum pitch to set (0-85). Values greater than 60 degrees are experimental and may result in rendering issues. If you encounter any, please raise an issue with details in the MapLibre project. * If `null` or `undefined` is provided, the function removes the current minimum pitch (i.e. sets it to 0). */ setMinPitch(minPitch) { minPitch = minPitch === null || minPitch === undefined ? defaultMinPitch : minPitch; if (minPitch < defaultMinPitch) { throw new Error(`minPitch must be greater than or equal to ${defaultMinPitch}`); } if (minPitch >= defaultMinPitch && minPitch <= this.transform.maxPitch) { this.transform.minPitch = minPitch; this._update(); if (this.getPitch() < minPitch) this.setPitch(minPitch); return this; } else throw new Error(`minPitch must be between ${defaultMinPitch} and the current maxPitch, inclusive`); } /** * Returns the map's minimum allowable pitch. * * @returns The minPitch */ getMinPitch() { return this.transform.minPitch; } /** * Sets or clears the map's maximum pitch. * If the map's current pitch is higher than the new maximum, * the map will pitch to the new maximum. * * A {@link ErrorEvent} event will be fired if maxPitch is out of bounds. * * @param maxPitch - The maximum pitch to set (0-85). Values greater than 60 degrees are experimental and may result in rendering issues. If you encounter any, please raise an issue with details in the MapLibre project. * If `null` or `undefined` is provided, the function removes the current maximum pitch (sets it to 60). */ setMaxPitch(maxPitch) { maxPitch = maxPitch === null || maxPitch === undefined ? defaultMaxPitch : maxPitch; if (maxPitch > maxPitchThreshold) { throw new Error(`maxPitch must be less than or equal to ${maxPitchThreshold}`); } if (maxPitch >= this.transform.minPitch) { this.transform.maxPitch = maxPitch; this._update(); if (this.getPitch() > maxPitch) this.setPitch(maxPitch); return this; } else throw new Error('maxPitch must be greater than the current minPitch'); } /** * Returns the map's maximum allowable pitch. * * @returns The maxPitch */ getMaxPitch() { return this.transform.maxPitch; } /** * Returns the state of `renderWorldCopies`. If `true`, multiple copies of the world will be rendered side by side beyond -180 and 180 degrees longitude. If set to `false`: * * - When the map is zoomed out far enough that a single representation of the world does not fill the map's entire * container, there will be blank space beyond 180 and -180 degrees longitude. * - Features that cross 180 and -180 degrees longitude will be cut in two (with one portion on the right edge of the * map and the other on the left edge of the map) at every zoom level. * @returns The renderWorldCopies * @example * ```ts * let worldCopiesRendered = map.getRenderWorldCopies(); * ``` * @see [Render world copies](https://maplibre.org/maplibre-gl-js/docs/examples/render-world-copies/) */ getRenderWorldCopies() { return this.transform.renderWorldCopies; } /** * Sets the state of `renderWorldCopies`. * * @param renderWorldCopies - If `true`, multiple copies of the world will be rendered side by side beyond -180 and 180 degrees longitude. If set to `false`: * * - When the map is zoomed out far enough that a single representation of the world does not fill the map's entire * container, there will be blank space beyond 180 and -180 degrees longitude. * - Features that cross 180 and -180 degrees longitude will be cut in two (with one portion on the right edge of the * map and the other on the left edge of the map) at every zoom level. * * `undefined` is treated as `true`, `null` is treated as `false`. * @example * ```ts * map.setRenderWorldCopies(true); * ``` * @see [Render world copies](https://maplibre.org/maplibre-gl-js/docs/examples/render-world-copies/) */ setRenderWorldCopies(renderWorldCopies) { this.transform.renderWorldCopies = renderWorldCopies; return this._update(); } /** * Returns a [Point](https://github.com/mapbox/point-geometry) representing pixel coordinates, relative to the map's `container`, * that correspond to the specified geographical location. * * @param lnglat - The geographical location to project. * @returns The [Point](https://github.com/mapbox/point-geometry) corresponding to `lnglat`, relative to the map's `container`. * @example * ```ts * let coordinate = [-122.420679, 37.772537]; * let point = map.project(coordinate); * ``` */ project(lnglat) { return this.transform.locationPoint(LngLat.convert(lnglat), this.style && this.terrain); } /** * Returns a {@link LngLat} representing geographical coordinates that correspond * to the specified pixel coordinates. * * @param point - The pixel coordinates to unproject. * @returns The {@link LngLat} corresponding to `point`. * @example * ```ts * map.on('click', (e) => { * // When the map is clicked, get the geographic coordinate. * let coordinate = map.unproject(e.point); * }); * ``` */ unproject(point) { return this.transform.pointLocation(Point$2.convert(point), this.terrain); } /** * Returns true if the map is panning, zooming, rotating, or pitching due to a camera animation or user gesture. * @returns true if the map is moving. * @example * ```ts * let isMoving = map.isMoving(); * ``` */ isMoving() { var _a; return this._moving || ((_a = this.handlers) === null || _a === void 0 ? void 0 : _a.isMoving()); } /** * Returns true if the map is zooming due to a camera animation or user gesture. * @returns true if the map is zooming. * @example * ```ts * let isZooming = map.isZooming(); * ``` */ isZooming() { var _a; return this._zooming || ((_a = this.handlers) === null || _a === void 0 ? void 0 : _a.isZooming()); } /** * Returns true if the map is rotating due to a camera animation or user gesture. * @returns true if the map is rotating. * @example * ```ts * map.isRotating(); * ``` */ isRotating() { var _a; return this._rotating || ((_a = this.handlers) === null || _a === void 0 ? void 0 : _a.isRotating()); } _createDelegatedListener(type, layerIds, listener) { if (type === 'mouseenter' || type === 'mouseover') { let mousein = false; const mousemove = (e) => { const existingLayers = layerIds.filter((layerId) => this.getLayer(layerId)); const features = existingLayers.length !== 0 ? this.queryRenderedFeatures(e.point, { layers: existingLayers }) : []; if (!features.length) { mousein = false; } else if (!mousein) { mousein = true; listener.call(this, new MapMouseEvent(type, this, e.originalEvent, { features })); } }; const mouseout = () => { mousein = false; }; return { layers: layerIds, listener, delegates: { mousemove, mouseout } }; } else if (type === 'mouseleave' || type === 'mouseout') { let mousein = false; const mousemove = (e) => { const existingLayers = layerIds.filter((layerId) => this.getLayer(layerId)); const features = existingLayers.length !== 0 ? this.queryRenderedFeatures(e.point, { layers: existingLayers }) : []; if (features.length) { mousein = true; } else if (mousein) { mousein = false; listener.call(this, new MapMouseEvent(type, this, e.originalEvent)); } }; const mouseout = (e) => { if (mousein) { mousein = false; listener.call(this, new MapMouseEvent(type, this, e.originalEvent)); } }; return { layers: layerIds, listener, delegates: { mousemove, mouseout } }; } else { const delegate = (e) => { const existingLayers = layerIds.filter((layerId) => this.getLayer(layerId)); const features = existingLayers.length !== 0 ? this.queryRenderedFeatures(e.point, { layers: existingLayers }) : []; if (features.length) { // Here we need to mutate the original event, so that preventDefault works as expected. e.features = features; listener.call(this, e); delete e.features; } }; return { layers: layerIds, listener, delegates: { [type]: delegate } }; } } _saveDelegatedListener(type, delegatedListener) { this._delegatedListeners = this._delegatedListeners || {}; this._delegatedListeners[type] = this._delegatedListeners[type] || []; this._delegatedListeners[type].push(delegatedListener); } _removeDelegatedListener(type, layerIds, listener) { if (!this._delegatedListeners || !this._delegatedListeners[type]) { return; } const listeners = this._delegatedListeners[type]; for (let i = 0; i < listeners.length; i++) { const delegatedListener = listeners[i]; if (delegatedListener.listener === listener && delegatedListener.layers.length === layerIds.length && delegatedListener.layers.every((layerId) => layerIds.includes(layerId))) { for (const event in delegatedListener.delegates) { this.off(event, delegatedListener.delegates[event]); } listeners.splice(i, 1); return; } } } on(type, layerIdsOrListener, listener) { if (listener === undefined) { return super.on(type, layerIdsOrListener); } const layerIds = typeof layerIdsOrListener === 'string' ? [layerIdsOrListener] : layerIdsOrListener; const delegatedListener = this._createDelegatedListener(type, layerIds, listener); this._saveDelegatedListener(type, delegatedListener); for (const event in delegatedListener.delegates) { this.on(event, delegatedListener.delegates[event]); } return this; } once(type, layerIdsOrListener, listener) { if (listener === undefined) { return super.once(type, layerIdsOrListener); } const layerIds = typeof layerIdsOrListener === 'string' ? [layerIdsOrListener] : layerIdsOrListener; const delegatedListener = this._createDelegatedListener(type, layerIds, listener); for (const key in delegatedListener.delegates) { const delegate = delegatedListener.delegates[key]; delegatedListener.delegates[key] = (...args) => { this._removeDelegatedListener(type, layerIds, listener); delegate(...args); }; } this._saveDelegatedListener(type, delegatedListener); for (const event in delegatedListener.delegates) { this.once(event, delegatedListener.delegates[event]); } return this; } off(type, layerIdsOrListener, listener) { if (listener === undefined) { return super.off(type, layerIdsOrListener); } const layerIds = typeof layerIdsOrListener === 'string' ? [layerIdsOrListener] : layerIdsOrListener; this._removeDelegatedListener(type, layerIds, listener); return this; } /** * Returns an array of MapGeoJSONFeature objects * representing visible features that satisfy the query parameters. * * @param geometryOrOptions - (optional) The geometry of the query region: * either a single point or southwest and northeast points describing a bounding box. * Omitting this parameter (i.e. calling {@link Map#queryRenderedFeatures} with zero arguments, * or with only a `options` argument) is equivalent to passing a bounding box encompassing the entire * map viewport. * The geometryOrOptions can receive a {@link QueryRenderedFeaturesOptions} only to support a situation where the function receives only one parameter which is the options parameter. * @param options - (optional) Options object. * * @returns An array of MapGeoJSONFeature objects. * * The `properties` value of each returned feature object contains the properties of its source feature. For GeoJSON sources, only * string and numeric property values are supported (i.e. `null`, `Array`, and `Object` values are not supported). * * Each feature includes top-level `layer`, `source`, and `sourceLayer` properties. The `layer` property is an object * representing the style layer to which the feature belongs. Layout and paint properties in this object contain values * which are fully evaluated for the given zoom level and feature. * * Only features that are currently rendered are included. Some features will **not** be included, like: * * - Features from layers whose `visibility` property is `"none"`. * - Features from layers whose zoom range excludes the current zoom level. * - Symbol features that have been hidden due to text or icon collision. * * Features from all other layers are included, including features that may have no visible * contribution to the rendered result; for example, because the layer's opacity or color alpha component is set to * 0. * * The topmost rendered feature appears first in the returned array, and subsequent features are sorted by * descending z-order. Features that are rendered multiple times (due to wrapping across the antemeridian at low * zoom levels) are returned only once (though subject to the following caveat). * * Because features come from tiled vector data or GeoJSON data that is converted to tiles internally, feature * geometries may be split or duplicated across tile boundaries and, as a result, features may appear multiple * times in query results. For example, suppose there is a highway running through the bounding rectangle of a query. * The results of the query will be those parts of the highway that lie within the map tiles covering the bounding * rectangle, even if the highway extends into other tiles, and the portion of the highway within each map tile * will be returned as a separate feature. Similarly, a point feature near a tile boundary may appear in multiple * tiles due to tile buffering. * * @example * Find all features at a point * ```ts * let features = map.queryRenderedFeatures( * [20, 35], * { layers: ['my-layer-name'] } * ); * ``` * * @example * Find all features within a static bounding box * ```ts * let features = map.queryRenderedFeatures( * [[10, 20], [30, 50]], * { layers: ['my-layer-name'] } * ); * ``` * * @example * Find all features within a bounding box around a point * ```ts * let width = 10; * let height = 20; * let features = map.queryRenderedFeatures([ * [point.x - width / 2, point.y - height / 2], * [point.x + width / 2, point.y + height / 2] * ], { layers: ['my-layer-name'] }); * ``` * * @example * Query all rendered features from a single layer * ```ts * let features = map.queryRenderedFeatures({ layers: ['my-layer-name'] }); * ``` * @see [Get features under the mouse pointer](https://maplibre.org/maplibre-gl-js/docs/examples/queryrenderedfeatures/) */ queryRenderedFeatures(geometryOrOptions, options) { if (!this.style) { return []; } let queryGeometry; const isGeometry = geometryOrOptions instanceof Point$2 || Array.isArray(geometryOrOptions); const geometry = isGeometry ? geometryOrOptions : [[0, 0], [this.transform.width, this.transform.height]]; options = options || (isGeometry ? {} : geometryOrOptions) || {}; if (geometry instanceof Point$2 || typeof geometry[0] === 'number') { queryGeometry = [Point$2.convert(geometry)]; } else { const tl = Point$2.convert(geometry[0]); const br = Point$2.convert(geometry[1]); queryGeometry = [tl, new Point$2(br.x, tl.y), br, new Point$2(tl.x, br.y), tl]; } return this.style.queryRenderedFeatures(queryGeometry, options, this.transform); } /** * Returns an array of MapGeoJSONFeature objects * representing features within the specified vector tile or GeoJSON source that satisfy the query parameters. * * @param sourceId - The ID of the vector tile or GeoJSON source to query. * @param parameters - The options object. * @returns An array of MapGeoJSONFeature objects. * * In contrast to {@link Map#queryRenderedFeatures}, this function returns all features matching the query parameters, * whether or not they are rendered by the current style (i.e. visible). The domain of the query includes all currently-loaded * vector tiles and GeoJSON source tiles: this function does not check tiles outside the currently * visible viewport. * * Because features come from tiled vector data or GeoJSON data that is converted to tiles internally, feature * geometries may be split or duplicated across tile boundaries and, as a result, features may appear multiple * times in query results. For example, suppose there is a highway running through the bounding rectangle of a query. * The results of the query will be those parts of the highway that lie within the map tiles covering the bounding * rectangle, even if the highway extends into other tiles, and the portion of the highway within each map tile * will be returned as a separate feature. Similarly, a point feature near a tile boundary may appear in multiple * tiles due to tile buffering. * * @example * Find all features in one source layer in a vector source * ```ts * let features = map.querySourceFeatures('your-source-id', { * sourceLayer: 'your-source-layer' * }); * ``` * */ querySourceFeatures(sourceId, parameters) { return this.style.querySourceFeatures(sourceId, parameters); } /** * Updates the map's MapLibre style object with a new value. * * If a style is already set when this is used and options.diff is set to true, the map renderer will attempt to compare the given style * against the map's current state and perform only the changes necessary to make the map style match the desired state. Changes in sprites * (images used for icons and patterns) and glyphs (fonts for label text) **cannot** be diffed. If the sprites or fonts used in the current * style and the given style are different in any way, the map renderer will force a full update, removing the current style and building * the given one from scratch. * * * @param style - A JSON object conforming to the schema described in the * [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/), or a URL to such JSON. * @param options - The options object. * * @example * ```ts * map.setStyle("https://demotiles.maplibre.org/style.json"); * * map.setStyle('https://demotiles.maplibre.org/style.json', { * transformStyle: (previousStyle, nextStyle) => ({ * ...nextStyle, * sources: { * ...nextStyle.sources, * // copy a source from previous style * 'osm': previousStyle.sources.osm * }, * layers: [ * // background layer * nextStyle.layers[0], * // copy a layer from previous style * previousStyle.layers[0], * // other layers from the next style * ...nextStyle.layers.slice(1).map(layer => { * // hide the layers we don't need from demotiles style * if (layer.id.startsWith('geolines')) { * layer.layout = {...layer.layout || {}, visibility: 'none'}; * // filter out US polygons * } else if (layer.id.startsWith('coastline') || layer.id.startsWith('countries')) { * layer.filter = ['!=', ['get', 'ADM0_A3'], 'USA']; * } * return layer; * }) * ] * }) * }); * ``` */ setStyle(style, options) { options = extend({}, { localIdeographFontFamily: this._localIdeographFontFamily, validate: this._validateStyle }, options); if ((options.diff !== false && options.localIdeographFontFamily === this._localIdeographFontFamily) && this.style && style) { this._diffStyle(style, options); return this; } else { this._localIdeographFontFamily = options.localIdeographFontFamily; return this._updateStyle(style, options); } } /** * Updates the requestManager's transform request with a new function * * @param transformRequest - A callback run before the Map makes a request for an external URL. The callback can be used to modify the url, set headers, or set the credentials property for cross-origin requests. * Expected to return an object with a `url` property and optionally `headers` and `credentials` properties * * @example * ```ts * map.setTransformRequest((url: string, resourceType: string) => {}); * ``` */ setTransformRequest(transformRequest) { this._requestManager.setTransformRequest(transformRequest); return this; } _getUIString(key) { const str = this._locale[key]; if (str == null) { throw new Error(`Missing UI string '${key}'`); } return str; } _updateStyle(style, options) { // transformStyle relies on having previous style serialized, if it is not loaded yet, delay _updateStyle until previous style is loaded if (options.transformStyle && this.style && !this.style._loaded) { this.style.once('style.load', () => this._updateStyle(style, options)); return; } const previousStyle = this.style && options.transformStyle ? this.style.serialize() : undefined; if (this.style) { this.style.setEventedParent(null); // Only release workers when map is getting disposed this.style._remove(!style); } if (!style) { delete this.style; return this; } else { this.style = new Style(this, options || {}); } this.style.setEventedParent(this, { style: this.style }); if (typeof style === 'string') { this.style.loadURL(style, options, previousStyle); } else { this.style.loadJSON(style, options, previousStyle); } return this; } _lazyInitEmptyStyle() { if (!this.style) { this.style = new Style(this, {}); this.style.setEventedParent(this, { style: this.style }); this.style.loadEmpty(); } } _diffStyle(style, options) { if (typeof style === 'string') { const url = style; const request = this._requestManager.transformRequest(url, "Style" /* ResourceType.Style */); getJSON(request, new AbortController()).then((response) => { this._updateDiff(response.data, options); }).catch((error) => { if (error) { this.fire(new ErrorEvent(error)); } }); } else if (typeof style === 'object') { this._updateDiff(style, options); } } _updateDiff(style, options) { try { if (this.style.setState(style, options)) { this._update(true); } } catch (e) { warnOnce(`Unable to perform style diff: ${e.message || e.error || e}. Rebuilding the style from scratch.`); this._updateStyle(style, options); } } /** * Returns the map's MapLibre style object, a JSON object which can be used to recreate the map's style. * * @returns The map's style JSON object. * * @example * ```ts * let styleJson = map.getStyle(); * ``` * */ getStyle() { if (this.style) { return this.style.serialize(); } } /** * Returns a Boolean indicating whether the map's style is fully loaded. * * @returns A Boolean indicating whether the style is fully loaded. * * @example * ```ts * let styleLoadStatus = map.isStyleLoaded(); * ``` */ isStyleLoaded() { if (!this.style) return warnOnce('There is no style added to the map.'); return this.style.loaded(); } /** * Adds a source to the map's style. * * Events triggered: * * Triggers the `source.add` event. * * @param id - The ID of the source to add. Must not conflict with existing sources. * @param source - The source object, conforming to the * MapLibre Style Specification's [source definition](https://maplibre.org/maplibre-style-spec/sources) or * {@link CanvasSourceSpecification}. * @example * ```ts * map.addSource('my-data', { * type: 'vector', * url: 'https://demotiles.maplibre.org/tiles/tiles.json' * }); * ``` * @example * ```ts * map.addSource('my-data', { * "type": "geojson", * "data": { * "type": "Feature", * "geometry": { * "type": "Point", * "coordinates": [-77.0323, 38.9131] * }, * "properties": { * "title": "Mapbox DC", * "marker-symbol": "monument" * } * } * }); * ``` * @see GeoJSON source: [Add live realtime data](https://maplibre.org/maplibre-gl-js/docs/examples/live-geojson/) */ addSource(id, source) { this._lazyInitEmptyStyle(); this.style.addSource(id, source); return this._update(true); } /** * Returns a Boolean indicating whether the source is loaded. Returns `true` if the source with * the given ID in the map's style has no outstanding network requests, otherwise `false`. * * A {@link ErrorEvent} event will be fired if there is no source wit the specified ID. * * @param id - The ID of the source to be checked. * @returns A Boolean indicating whether the source is loaded. * @example * ```ts * let sourceLoaded = map.isSourceLoaded('bathymetry-data'); * ``` */ isSourceLoaded(id) { const source = this.style && this.style.sourceCaches[id]; if (source === undefined) { this.fire(new ErrorEvent(new Error(`There is no source with ID '${id}'`))); return; } return source.loaded(); } /** * Loads a 3D terrain mesh, based on a "raster-dem" source. * * Triggers the `terrain` event. * * @param options - Options object. * @example * ```ts * map.setTerrain({ source: 'terrain' }); * ``` */ setTerrain(options) { this.style._checkLoaded(); // clear event handlers if (this._terrainDataCallback) this.style.off('data', this._terrainDataCallback); if (!options) { // remove terrain if (this.terrain) this.terrain.sourceCache.destruct(); this.terrain = null; if (this.painter.renderToTexture) this.painter.renderToTexture.destruct(); this.painter.renderToTexture = null; this.transform.minElevationForCurrentTile = 0; this.transform.elevation = 0; } else { // add terrain const sourceCache = this.style.sourceCaches[options.source]; if (!sourceCache) throw new Error(`cannot load terrain, because there exists no source with ID: ${options.source}`); // Update terrain tiles when adding new terrain if (this.terrain === null) sourceCache.reload(); // Warn once if user is using the same source for hillshade and terrain for (const index in this.style._layers) { const thisLayer = this.style._layers[index]; if (thisLayer.type === 'hillshade' && thisLayer.source === options.source) { warnOnce('You are using the same source for a hillshade layer and for 3D terrain. Please consider using two separate sources to improve rendering quality.'); } } this.terrain = new Terrain(this.painter, sourceCache, options); this.painter.renderToTexture = new RenderToTexture(this.painter, this.terrain); this.transform.minElevationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); this._terrainDataCallback = e => { if (e.dataType === 'style') { this.terrain.sourceCache.freeRtt(); } else if (e.dataType === 'source' && e.tile) { if (e.sourceId === options.source && !this._elevationFreeze) { this.transform.minElevationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); } this.terrain.sourceCache.freeRtt(e.tile.tileID); } }; this.style.on('data', this._terrainDataCallback); } this.fire(new Event('terrain', { terrain: options })); return this; } /** * Get the terrain-options if terrain is loaded * @returns the TerrainSpecification passed to setTerrain * @example * ```ts * map.getTerrain(); // { source: 'terrain' }; * ``` */ getTerrain() { var _a, _b; return (_b = (_a = this.terrain) === null || _a === void 0 ? void 0 : _a.options) !== null && _b !== void 0 ? _b : null; } /** * Returns a Boolean indicating whether all tiles in the viewport from all sources on * the style are loaded. * * @returns A Boolean indicating whether all tiles are loaded. * @example * ```ts * let tilesLoaded = map.areTilesLoaded(); * ``` */ areTilesLoaded() { const sources = this.style && this.style.sourceCaches; for (const id in sources) { const source = sources[id]; const tiles = source._tiles; for (const t in tiles) { const tile = tiles[t]; if (!(tile.state === 'loaded' || tile.state === 'errored')) return false; } } return true; } /** * Removes a source from the map's style. * * @param id - The ID of the source to remove. * @example * ```ts * map.removeSource('bathymetry-data'); * ``` */ removeSource(id) { this.style.removeSource(id); return this._update(true); } /** * Returns the source with the specified ID in the map's style. * * This method is often used to update a source using the instance members for the relevant * source type as defined in classes that derive from {@link Source}. * For example, setting the `data` for a GeoJSON source or updating the `url` and `coordinates` * of an image source. * * @param id - The ID of the source to get. * @returns The style source with the specified ID or `undefined` if the ID * corresponds to no existing sources. * The shape of the object varies by source type. * A list of options for each source type is available on the MapLibre Style Specification's * [Sources](https://maplibre.org/maplibre-style-spec/sources/) page. * @example * ```ts * let sourceObject = map.getSource('points'); * ``` * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-point/) * @see [Animate a point](https://maplibre.org/maplibre-gl-js/docs/examples/animate-point-along-line/) * @see [Add live realtime data](https://maplibre.org/maplibre-gl-js/docs/examples/live-geojson/) */ getSource(id) { return this.style.getSource(id); } /** * Add an image to the style. This image can be displayed on the map like any other icon in the style's * sprite using the image's ID with * [`icon-image`](https://maplibre.org/maplibre-style-spec/layers/#layout-symbol-icon-image), * [`background-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-background-background-pattern), * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-fill-fill-pattern), * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-line-line-pattern). * * A {@link ErrorEvent} event will be fired if the image parameter is invalid or there is not enough space in the sprite to add this image. * * @param id - The ID of the image. * @param image - The image as an `HTMLImageElement`, `ImageData`, `ImageBitmap` or object with `width`, `height`, and `data` * properties with the same format as `ImageData`. * @param options - Options object. * @example * ```ts * // If the style's sprite does not already contain an image with ID 'cat', * // add the image 'cat-icon.png' to the style's sprite with the ID 'cat'. * const image = await map.loadImage('https://upload.wikimedia.org/wikipedia/commons/thumb/6/60/Cat_silhouette.svg/400px-Cat_silhouette.svg.png'); * if (!map.hasImage('cat')) map.addImage('cat', image.data); * * // Add a stretchable image that can be used with `icon-text-fit` * // In this example, the image is 600px wide by 400px high. * const image = await map.loadImage('https://upload.wikimedia.org/wikipedia/commons/8/89/Black_and_White_Boxed_%28bordered%29.png'); * if (map.hasImage('border-image')) return; * map.addImage('border-image', image.data, { * content: [16, 16, 300, 384], // place text over left half of image, avoiding the 16px border * stretchX: [[16, 584]], // stretch everything horizontally except the 16px border * stretchY: [[16, 384]], // stretch everything vertically except the 16px border * }); * ``` * @see Use `HTMLImageElement`: [Add an icon to the map](https://maplibre.org/maplibre-gl-js/docs/examples/add-image/) * @see Use `ImageData`: [Add a generated icon to the map](https://maplibre.org/maplibre-gl-js/docs/examples/add-image-generated/) */ addImage(id, image, options = {}) { const { pixelRatio = 1, sdf = false, stretchX, stretchY, content, textFitWidth, textFitHeight } = options; this._lazyInitEmptyStyle(); const version = 0; if (image instanceof HTMLImageElement || isImageBitmap(image)) { const { width, height, data } = browser.getImageData(image); this.style.addImage(id, { data: new RGBAImage({ width, height }, data), pixelRatio, stretchX, stretchY, content, textFitWidth, textFitHeight, sdf, version }); } else if (image.width === undefined || image.height === undefined) { return this.fire(new ErrorEvent(new Error('Invalid arguments to map.addImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, ' + 'or object with `width`, `height`, and `data` properties with the same format as `ImageData`'))); } else { const { width, height, data } = image; const userImage = image; this.style.addImage(id, { data: new RGBAImage({ width, height }, new Uint8Array(data)), pixelRatio, stretchX, stretchY, content, textFitWidth, textFitHeight, sdf, version, userImage }); if (userImage.onAdd) { userImage.onAdd(this, id); } return this; } } /** * Update an existing image in a style. This image can be displayed on the map like any other icon in the style's * sprite using the image's ID with * [`icon-image`](https://maplibre.org/maplibre-style-spec/layers/#layout-symbol-icon-image), * [`background-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-background-background-pattern), * [`fill-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-fill-fill-pattern), * or [`line-pattern`](https://maplibre.org/maplibre-style-spec/layers/#paint-line-line-pattern). * * An {@link ErrorEvent} will be fired if the image parameter is invald. * * @param id - The ID of the image. * @param image - The image as an `HTMLImageElement`, `ImageData`, `ImageBitmap` or object with `width`, `height`, and `data` * properties with the same format as `ImageData`. * @example * ```ts * // If an image with the ID 'cat' already exists in the style's sprite, * // replace that image with a new image, 'other-cat-icon.png'. * if (map.hasImage('cat')) map.updateImage('cat', './other-cat-icon.png'); * ``` */ updateImage(id, image) { const existingImage = this.style.getImage(id); if (!existingImage) { return this.fire(new ErrorEvent(new Error('The map has no image with that id. If you are adding a new image use `map.addImage(...)` instead.'))); } const imageData = (image instanceof HTMLImageElement || isImageBitmap(image)) ? browser.getImageData(image) : image; const { width, height, data } = imageData; if (width === undefined || height === undefined) { return this.fire(new ErrorEvent(new Error('Invalid arguments to map.updateImage(). The second argument must be an `HTMLImageElement`, `ImageData`, `ImageBitmap`, ' + 'or object with `width`, `height`, and `data` properties with the same format as `ImageData`'))); } if (width !== existingImage.data.width || height !== existingImage.data.height) { return this.fire(new ErrorEvent(new Error('The width and height of the updated image must be that same as the previous version of the image'))); } const copy = !(image instanceof HTMLImageElement || isImageBitmap(image)); existingImage.data.replace(data, copy); this.style.updateImage(id, existingImage); return this; } /** * Returns an image, specified by ID, currently available in the map. * This includes both images from the style's original sprite * and any images that have been added at runtime using {@link Map#addImage}. * * @param id - The ID of the image. * @returns An image in the map with the specified ID. * * @example * ```ts * let coffeeShopIcon = map.getImage("coffee_cup"); * ``` */ getImage(id) { return this.style.getImage(id); } /** * Check whether or not an image with a specific ID exists in the style. This checks both images * in the style's original sprite and any images * that have been added at runtime using {@link Map#addImage}. * * An {@link ErrorEvent} will be fired if the image parameter is invald. * * @param id - The ID of the image. * * @returns A Boolean indicating whether the image exists. * @example * Check if an image with the ID 'cat' exists in the style's sprite. * ```ts * let catIconExists = map.hasImage('cat'); * ``` */ hasImage(id) { if (!id) { this.fire(new ErrorEvent(new Error('Missing required image id'))); return false; } return !!this.style.getImage(id); } /** * Remove an image from a style. This can be an image from the style's original * sprite or any images * that have been added at runtime using {@link Map#addImage}. * * @param id - The ID of the image. * * @example * ```ts * // If an image with the ID 'cat' exists in * // the style's sprite, remove it. * if (map.hasImage('cat')) map.removeImage('cat'); * ``` */ removeImage(id) { this.style.removeImage(id); } /** * Load an image from an external URL to be used with {@link Map#addImage}. External * domains must support [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Access_control_CORS). * * @param url - The URL of the image file. Image file must be in png, webp, or jpg format. * @returns a promise that is resolved when the image is loaded * * @example * Load an image from an external URL. * ```ts * const response = await map.loadImage('https://picsum.photos/50/50'); * // Add the loaded image to the style's sprite with the ID 'photo'. * map.addImage('photo', response.data); * ``` * @see [Add an icon to the map](https://maplibre.org/maplibre-gl-js/docs/examples/add-image/) */ loadImage(url) { return ImageRequest.getImage(this._requestManager.transformRequest(url, "Image" /* ResourceType.Image */), new AbortController()); } /** * Returns an Array of strings containing the IDs of all images currently available in the map. * This includes both images from the style's original sprite * and any images that have been added at runtime using {@link Map#addImage}. * * @returns An Array of strings containing the names of all sprites/images currently available in the map. * * @example * ```ts * let allImages = map.listImages(); * ``` */ listImages() { return this.style.listImages(); } /** * Adds a [MapLibre style layer](https://maplibre.org/maplibre-style-spec/layers) * to the map's style. * * A layer defines how data from a specified source will be styled. Read more about layer types * and available paint and layout properties in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/layers). * * @param layer - The layer to add, * conforming to either the MapLibre Style Specification's [layer definition](https://maplibre.org/maplibre-style-spec/layers) or, * less commonly, the {@link CustomLayerInterface} specification. Can also be a layer definition with an embedded source definition. * The MapLibre Style Specification's layer definition is appropriate for most layers. * * @param beforeId - The ID of an existing layer to insert the new layer before, * resulting in the new layer appearing visually beneath the existing layer. * If this argument is not specified, the layer will be appended to the end of the layers array * and appear visually above all other layers. * * @example * Add a circle layer with a vector source * ```ts * map.addLayer({ * id: 'points-of-interest', * source: { * type: 'vector', * url: 'https://demotiles.maplibre.org/tiles/tiles.json' * }, * 'source-layer': 'poi_label', * type: 'circle', * paint: { * // MapLibre Style Specification paint properties * }, * layout: { * // MapLibre Style Specification layout properties * } * }); * ``` * * @example * Define a source before using it to create a new layer * ```ts * map.addSource('state-data', { * type: 'geojson', * data: 'path/to/data.geojson' * }); * * map.addLayer({ * id: 'states', * // References the GeoJSON source defined above * // and does not require a `source-layer` * source: 'state-data', * type: 'symbol', * layout: { * // Set the label content to the * // feature's `name` property * text-field: ['get', 'name'] * } * }); * ``` * * @example * Add a new symbol layer before an existing layer * ```ts * map.addLayer({ * id: 'states', * // References a source that's already been defined * source: 'state-data', * type: 'symbol', * layout: { * // Set the label content to the * // feature's `name` property * text-field: ['get', 'name'] * } * // Add the layer before the existing `cities` layer * }, 'cities'); * ``` * @see [Create and style clusters](https://maplibre.org/maplibre-gl-js/docs/examples/cluster/) * @see [Add a vector tile source](https://maplibre.org/maplibre-gl-js/docs/examples/vector-source/) * @see [Add a WMS source](https://maplibre.org/maplibre-gl-js/docs/examples/wms/) */ addLayer(layer, beforeId) { this._lazyInitEmptyStyle(); this.style.addLayer(layer, beforeId); return this._update(true); } /** * Moves a layer to a different z-position. * * @param id - The ID of the layer to move. * @param beforeId - The ID of an existing layer to insert the new layer before. When viewing the map, the `id` layer will appear beneath the `beforeId` layer. If `beforeId` is omitted, the layer will be appended to the end of the layers array and appear above all other layers on the map. * * @example * Move a layer with ID 'polygon' before the layer with ID 'country-label'. The `polygon` layer will appear beneath the `country-label` layer on the map. * ```ts * map.moveLayer('polygon', 'country-label'); * ``` */ moveLayer(id, beforeId) { this.style.moveLayer(id, beforeId); return this._update(true); } /** * Removes the layer with the given ID from the map's style. * * An {@link ErrorEvent} will be fired if the image parameter is invald. * * @param id - The ID of the layer to remove * * @example * If a layer with ID 'state-data' exists, remove it. * ```ts * if (map.getLayer('state-data')) map.removeLayer('state-data'); * ``` */ removeLayer(id) { this.style.removeLayer(id); return this._update(true); } /** * Returns the layer with the specified ID in the map's style. * * @param id - The ID of the layer to get. * @returns The layer with the specified ID, or `undefined` * if the ID corresponds to no existing layers. * * @example * ```ts * let stateDataLayer = map.getLayer('state-data'); * ``` * @see [Filter symbols by toggling a list](https://maplibre.org/maplibre-gl-js/docs/examples/filter-markers/) * @see [Filter symbols by text input](https://maplibre.org/maplibre-gl-js/docs/examples/filter-markers-by-input/) */ getLayer(id) { return this.style.getLayer(id); } /** * Return the ids of all layers currently in the style, including custom layers, in order. * * @returns ids of layers, in order * * @example * ```ts * const orderedLayerIds = map.getLayersOrder(); * ``` */ getLayersOrder() { return this.style.getLayersOrder(); } /** * Sets the zoom extent for the specified style layer. The zoom extent includes the * [minimum zoom level](https://maplibre.org/maplibre-style-spec/layers/#minzoom) * and [maximum zoom level](https://maplibre.org/maplibre-style-spec/layers/#maxzoom)) * at which the layer will be rendered. * * Note: For style layers using vector sources, style layers cannot be rendered at zoom levels lower than the * minimum zoom level of the _source layer_ because the data does not exist at those zoom levels. If the minimum * zoom level of the source layer is higher than the minimum zoom level defined in the style layer, the style * layer will not be rendered at all zoom levels in the zoom range. * * @param layerId - The ID of the layer to which the zoom extent will be applied. * @param minzoom - The minimum zoom to set (0-24). * @param maxzoom - The maximum zoom to set (0-24). * * @example * ```ts * map.setLayerZoomRange('my-layer', 2, 5); * ``` */ setLayerZoomRange(layerId, minzoom, maxzoom) { this.style.setLayerZoomRange(layerId, minzoom, maxzoom); return this._update(true); } /** * Sets the filter for the specified style layer. * * Filters control which features a style layer renders from its source. * Any feature for which the filter expression evaluates to `true` will be * rendered on the map. Those that are false will be hidden. * * Use `setFilter` to show a subset of your source data. * * To clear the filter, pass `null` or `undefined` as the second parameter. * * @param layerId - The ID of the layer to which the filter will be applied. * @param filter - The filter, conforming to the MapLibre Style Specification's * [filter definition](https://maplibre.org/maplibre-style-spec/layers/#filter). If `null` or `undefined` is provided, the function removes any existing filter from the layer. * @param options - Options object. * * @example * Display only features with the 'name' property 'USA' * ```ts * map.setFilter('my-layer', ['==', ['get', 'name'], 'USA']); * ``` * @example * Display only features with five or more 'available-spots' * ```ts * map.setFilter('bike-docks', ['>=', ['get', 'available-spots'], 5]); * ``` * @example * Remove the filter for the 'bike-docks' style layer * ```ts * map.setFilter('bike-docks', null); * ``` * @see [Create a timeline animation](https://maplibre.org/maplibre-gl-js/docs/examples/timeline-animation/) */ setFilter(layerId, filter, options = {}) { this.style.setFilter(layerId, filter, options); return this._update(true); } /** * Returns the filter applied to the specified style layer. * * @param layerId - The ID of the style layer whose filter to get. * @returns The layer's filter. */ getFilter(layerId) { return this.style.getFilter(layerId); } /** * Sets the value of a paint property in the specified style layer. * * @param layerId - The ID of the layer to set the paint property in. * @param name - The name of the paint property to set. * @param value - The value of the paint property to set. * Must be of a type appropriate for the property, as defined in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/). * Pass `null` to unset the existing value. * @param options - Options object. * @example * ```ts * map.setPaintProperty('my-layer', 'fill-color', '#faafee'); * ``` * @see [Change a layer's color with buttons](https://maplibre.org/maplibre-gl-js/docs/examples/color-switcher/) * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-point/) */ setPaintProperty(layerId, name, value, options = {}) { this.style.setPaintProperty(layerId, name, value, options); return this._update(true); } /** * Returns the value of a paint property in the specified style layer. * * @param layerId - The ID of the layer to get the paint property from. * @param name - The name of a paint property to get. * @returns The value of the specified paint property. */ getPaintProperty(layerId, name) { return this.style.getPaintProperty(layerId, name); } /** * Sets the value of a layout property in the specified style layer. * * @param layerId - The ID of the layer to set the layout property in. * @param name - The name of the layout property to set. * @param value - The value of the layout property. Must be of a type appropriate for the property, as defined in the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/). * @param options - The options object. * @example * ```ts * map.setLayoutProperty('my-layer', 'visibility', 'none'); * ``` */ setLayoutProperty(layerId, name, value, options = {}) { this.style.setLayoutProperty(layerId, name, value, options); return this._update(true); } /** * Returns the value of a layout property in the specified style layer. * * @param layerId - The ID of the layer to get the layout property from. * @param name - The name of the layout property to get. * @returns The value of the specified layout property. */ getLayoutProperty(layerId, name) { return this.style.getLayoutProperty(layerId, name); } /** * Sets the value of the style's glyphs property. * * @param glyphsUrl - Glyph URL to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/glyphs/). * @param options - Options object. * @example * ```ts * map.setGlyphs('https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf'); * ``` */ setGlyphs(glyphsUrl, options = {}) { this._lazyInitEmptyStyle(); this.style.setGlyphs(glyphsUrl, options); return this._update(true); } /** * Returns the value of the style's glyphs URL * * @returns glyphs Style's glyphs url */ getGlyphs() { return this.style.getGlyphsUrl(); } /** * Adds a sprite to the map's style. Fires the `style` event. * * @param id - The ID of the sprite to add. Must not conflict with existing sprites. * @param url - The URL to load the sprite from * @param options - Options object. * @example * ```ts * map.addSprite('sprite-two', 'http://example.com/sprite-two'); * ``` */ addSprite(id, url, options = {}) { this._lazyInitEmptyStyle(); this.style.addSprite(id, url, options, (err) => { if (!err) { this._update(true); } }); return this; } /** * Removes the sprite from the map's style. Fires the `style` event. * * @param id - The ID of the sprite to remove. If the sprite is declared as a single URL, the ID must be "default". * @example * ```ts * map.removeSprite('sprite-two'); * map.removeSprite('default'); * ``` */ removeSprite(id) { this._lazyInitEmptyStyle(); this.style.removeSprite(id); return this._update(true); } /** * Returns the as-is value of the style's sprite. * * @returns style's sprite list of id-url pairs */ getSprite() { return this.style.getSprite(); } /** * Sets the value of the style's sprite property. * * @param spriteUrl - Sprite URL to set. * @param options - Options object. * @example * ```ts * map.setSprite('YOUR_SPRITE_URL'); * ``` */ setSprite(spriteUrl, options = {}) { this._lazyInitEmptyStyle(); this.style.setSprite(spriteUrl, options, (err) => { if (!err) { this._update(true); } }); return this; } /** * Sets the any combination of light values. * * @param light - Light properties to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/light). * @param options - Options object. * * @example * ```ts * let layerVisibility = map.getLayoutProperty('my-layer', 'visibility'); * ``` */ setLight(light, options = {}) { this._lazyInitEmptyStyle(); this.style.setLight(light, options); return this._update(true); } /** * Returns the value of the light object. * * @returns light Light properties of the style. */ getLight() { return this.style.getLight(); } /** * Loads sky and fog defined by {@link SkySpecification} onto the map. * Note: The fog only shows when using the terrain 3D feature. * @param sky - Sky properties to set. Must conform to the [MapLibre Style Specification](https://maplibre.org/maplibre-style-spec/sky/). * @returns `this` * @example * ```ts * map.setSky({ 'sky-color': '#00f' }); * ``` */ setSky(sky) { this._lazyInitEmptyStyle(); this.style.setSky(sky); return this._update(true); } /** * Returns the value of the sky object. * * @returns the sky properties of the style. * @example * ```ts * map.getSky(); * ``` */ getSky() { return this.style.getSky(); } /** * Sets the `state` of a feature. * A feature's `state` is a set of user-defined key-value pairs that are assigned to a feature at runtime. * When using this method, the `state` object is merged with any existing key-value pairs in the feature's state. * Features are identified by their `feature.id` attribute, which can be any number or string. * * This method can only be used with sources that have a `feature.id` attribute. The `feature.id` attribute can be defined in three ways: * * - For vector or GeoJSON sources, including an `id` attribute in the original data file. * - For vector or GeoJSON sources, using the [`promoteId`](https://maplibre.org/maplibre-style-spec/sources/#vector-promoteId) option at the time the source is defined. * - For GeoJSON sources, using the [`generateId`](https://maplibre.org/maplibre-style-spec/sources/#geojson-generateId) option to auto-assign an `id` based on the feature's index in the source data. If you change feature data using `map.getSource('some id').setData(..)`, you may need to re-apply state taking into account updated `id` values. * * _Note: You can use the [`feature-state` expression](https://maplibre.org/maplibre-style-spec/expressions/#feature-state) to access the values in a feature's state object for the purposes of styling._ * * @param feature - Feature identifier. Feature objects returned from * {@link Map#queryRenderedFeatures} or event handlers can be used as feature identifiers. * @param state - A set of key-value pairs. The values should be valid JSON types. * * @example * ```ts * // When the mouse moves over the `my-layer` layer, update * // the feature state for the feature under the mouse * map.on('mousemove', 'my-layer', (e) => { * if (e.features.length > 0) { * map.setFeatureState({ * source: 'my-source', * sourceLayer: 'my-source-layer', * id: e.features[0].id, * }, { * hover: true * }); * } * }); * ``` * @see [Create a hover effect](https://maplibre.org/maplibre-gl-js/docs/examples/hover-styles/) */ setFeatureState(feature, state) { this.style.setFeatureState(feature, state); return this._update(); } /** * Removes the `state` of a feature, setting it back to the default behavior. * If only a `target.source` is specified, it will remove the state for all features from that source. * If `target.id` is also specified, it will remove all keys for that feature's state. * If `key` is also specified, it removes only that key from that feature's state. * Features are identified by their `feature.id` attribute, which can be any number or string. * * @param target - Identifier of where to remove state. It can be a source, a feature, or a specific key of feature. * Feature objects returned from {@link Map#queryRenderedFeatures} or event handlers can be used as feature identifiers. * @param key - (optional) The key in the feature state to reset. * @example * Reset the entire state object for all features in the `my-source` source * ```ts * map.removeFeatureState({ * source: 'my-source' * }); * ``` * * @example * When the mouse leaves the `my-layer` layer, * reset the entire state object for the * feature under the mouse * ```ts * map.on('mouseleave', 'my-layer', (e) => { * map.removeFeatureState({ * source: 'my-source', * sourceLayer: 'my-source-layer', * id: e.features[0].id * }); * }); * ``` * * @example * When the mouse leaves the `my-layer` layer, * reset only the `hover` key-value pair in the * state for the feature under the mouse * ```ts * map.on('mouseleave', 'my-layer', (e) => { * map.removeFeatureState({ * source: 'my-source', * sourceLayer: 'my-source-layer', * id: e.features[0].id * }, 'hover'); * }); * ``` */ removeFeatureState(target, key) { this.style.removeFeatureState(target, key); return this._update(); } /** * Gets the `state` of a feature. * A feature's `state` is a set of user-defined key-value pairs that are assigned to a feature at runtime. * Features are identified by their `feature.id` attribute, which can be any number or string. * * _Note: To access the values in a feature's state object for the purposes of styling the feature, use the [`feature-state` expression](https://maplibre.org/maplibre-style-spec/expressions/#feature-state)._ * * @param feature - Feature identifier. Feature objects returned from * {@link Map#queryRenderedFeatures} or event handlers can be used as feature identifiers. * @returns The state of the feature: a set of key-value pairs that was assigned to the feature at runtime. * * @example * When the mouse moves over the `my-layer` layer, * get the feature state for the feature under the mouse * ```ts * map.on('mousemove', 'my-layer', (e) => { * if (e.features.length > 0) { * map.getFeatureState({ * source: 'my-source', * sourceLayer: 'my-source-layer', * id: e.features[0].id * }); * } * }); * ``` */ getFeatureState(feature) { return this.style.getFeatureState(feature); } /** * Returns the map's containing HTML element. * * @returns The map's container. */ getContainer() { return this._container; } /** * Returns the HTML element containing the map's `` element. * * If you want to add non-GL overlays to the map, you should append them to this element. * * This is the element to which event bindings for map interactivity (such as panning and zooming) are * attached. It will receive bubbled events from child elements such as the ``, but not from * map controls. * * @returns The container of the map's ``. * @see [Create a draggable point](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-point/) */ getCanvasContainer() { return this._canvasContainer; } /** * Returns the map's `` element. * * @returns The map's `` element. * @see [Measure distances](https://maplibre.org/maplibre-gl-js/docs/examples/measure/) * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-hover/) * @see [Center the map on a clicked symbol](https://maplibre.org/maplibre-gl-js/docs/examples/center-on-symbol/) */ getCanvas() { return this._canvas; } _containerDimensions() { let width = 0; let height = 0; if (this._container) { width = this._container.clientWidth || 400; height = this._container.clientHeight || 300; } return [width, height]; } _setupContainer() { const container = this._container; container.classList.add('maplibregl-map'); const canvasContainer = this._canvasContainer = DOM.create('div', 'maplibregl-canvas-container', container); if (this._interactive) { canvasContainer.classList.add('maplibregl-interactive'); } this._canvas = DOM.create('canvas', 'maplibregl-canvas', canvasContainer); this._canvas.addEventListener('webglcontextlost', this._contextLost, false); this._canvas.addEventListener('webglcontextrestored', this._contextRestored, false); this._canvas.setAttribute('tabindex', this._interactive ? '0' : '-1'); this._canvas.setAttribute('aria-label', this._getUIString('Map.Title')); this._canvas.setAttribute('role', 'region'); const dimensions = this._containerDimensions(); const clampedPixelRatio = this._getClampedPixelRatio(dimensions[0], dimensions[1]); this._resizeCanvas(dimensions[0], dimensions[1], clampedPixelRatio); const controlContainer = this._controlContainer = DOM.create('div', 'maplibregl-control-container', container); const positions = this._controlPositions = {}; ['top-left', 'top-right', 'bottom-left', 'bottom-right'].forEach((positionName) => { positions[positionName] = DOM.create('div', `maplibregl-ctrl-${positionName} `, controlContainer); }); this._container.addEventListener('scroll', this._onMapScroll, false); } _resizeCanvas(width, height, pixelRatio) { // Request the required canvas size taking the pixelratio into account. this._canvas.width = Math.floor(pixelRatio * width); this._canvas.height = Math.floor(pixelRatio * height); // Maintain the same canvas size, potentially downscaling it for HiDPI displays this._canvas.style.width = `${width}px`; this._canvas.style.height = `${height}px`; } _setupPainter() { const attributes = { alpha: true, stencil: true, depth: true, failIfMajorPerformanceCaveat: this._failIfMajorPerformanceCaveat, preserveDrawingBuffer: this._preserveDrawingBuffer, antialias: this._antialias || false }; let webglcontextcreationerrorDetailObject = null; this._canvas.addEventListener('webglcontextcreationerror', (args) => { webglcontextcreationerrorDetailObject = { requestedAttributes: attributes }; if (args) { webglcontextcreationerrorDetailObject.statusMessage = args.statusMessage; webglcontextcreationerrorDetailObject.type = args.type; } }, { once: true }); const gl = this._canvas.getContext('webgl2', attributes) || this._canvas.getContext('webgl', attributes); if (!gl) { const msg = 'Failed to initialize WebGL'; if (webglcontextcreationerrorDetailObject) { webglcontextcreationerrorDetailObject.message = msg; throw new Error(JSON.stringify(webglcontextcreationerrorDetailObject)); } else { throw new Error(msg); } } this.painter = new Painter(gl, this.transform); webpSupported.testSupport(gl); } /** * Returns a Boolean indicating whether the map is fully loaded. * * Returns `false` if the style is not yet fully loaded, * or if there has been a change to the sources or style that * has not yet fully loaded. * * @returns A Boolean indicating whether the map is fully loaded. */ loaded() { return !this._styleDirty && !this._sourcesDirty && !!this.style && this.style.loaded(); } /** * @internal * Update this map's style and sources, and re-render the map. * * @param updateStyle - mark the map's style for reprocessing as * well as its sources */ _update(updateStyle) { if (!this.style || !this.style._loaded) return this; this._styleDirty = this._styleDirty || updateStyle; this._sourcesDirty = true; this.triggerRepaint(); return this; } /** * @internal * Request that the given callback be executed during the next render * frame. Schedule a render frame if one is not already scheduled. * * @returns An id that can be used to cancel the callback */ _requestRenderFrame(callback) { this._update(); return this._renderTaskQueue.add(callback); } _cancelRenderFrame(id) { this._renderTaskQueue.remove(id); } /** * @internal * Call when a (re-)render of the map is required: * * - The style has changed (`setPaintProperty()`, etc.) * - Source data has changed (e.g. tiles have finished loading) * - The map has is moving (or just finished moving) * - A transition is in progress * * @param paintStartTimeStamp - The time when the animation frame began executing. */ _render(paintStartTimeStamp) { const fadeDuration = this._idleTriggered ? this._fadeDuration : 0; // A custom layer may have used the context asynchronously. Mark the state as dirty. this.painter.context.setDirty(); this.painter.setBaseState(); this._renderTaskQueue.run(paintStartTimeStamp); // A task queue callback may have fired a user event which may have removed the map if (this._removed) return; let crossFading = false; // If the style has changed, the map is being zoomed, or a transition or fade is in progress: // - Apply style changes (in a batch) // - Recalculate paint properties. if (this.style && this._styleDirty) { this._styleDirty = false; const zoom = this.transform.zoom; const now = browser.now(); this.style.zoomHistory.update(zoom, now); const parameters = new EvaluationParameters(zoom, { now, fadeDuration, zoomHistory: this.style.zoomHistory, transition: this.style.getTransition() }); const factor = parameters.crossFadingFactor(); if (factor !== 1 || factor !== this._crossFadingFactor) { crossFading = true; this._crossFadingFactor = factor; } this.style.update(parameters); } // If we are in _render for any reason other than an in-progress paint // transition, update source caches to check for and load any tiles we // need for the current transform if (this.style && this._sourcesDirty) { this._sourcesDirty = false; this.style._updateSources(this.transform); } // update terrain stuff if (this.terrain) { this.terrain.sourceCache.update(this.transform, this.terrain); this.transform.minElevationForCurrentTile = this.terrain.getMinTileElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); if (!this._elevationFreeze) { this.transform.elevation = this.terrain.getElevationForLngLatZoom(this.transform.center, this.transform.tileZoom); } } else { this.transform.minElevationForCurrentTile = 0; this.transform.elevation = 0; } this._placementDirty = this.style && this.style._updatePlacement(this.painter.transform, this.showCollisionBoxes, fadeDuration, this._crossSourceCollisions); // Actually draw this.painter.render(this.style, { showTileBoundaries: this.showTileBoundaries, showOverdrawInspector: this._showOverdrawInspector, rotating: this.isRotating(), zooming: this.isZooming(), moving: this.isMoving(), fadeDuration, showPadding: this.showPadding, }); this.fire(new Event('render')); if (this.loaded() && !this._loaded) { this._loaded = true; PerformanceUtils.mark(PerformanceMarkers.load); this.fire(new Event('load')); } if (this.style && (this.style.hasTransitions() || crossFading)) { this._styleDirty = true; } if (this.style && !this._placementDirty) { // Since no fade operations are in progress, we can release // all tiles held for fading. If we didn't do this, the tiles // would just sit in the SourceCaches until the next render this.style._releaseSymbolFadeTiles(); } // Schedule another render frame if it's needed. // // Even though `_styleDirty` and `_sourcesDirty` are reset in this // method, synchronous events fired during Style#update or // Style#_updateSources could have caused them to be set again. const somethingDirty = this._sourcesDirty || this._styleDirty || this._placementDirty; if (somethingDirty || this._repaint) { this.triggerRepaint(); } else if (!this.isMoving() && this.loaded()) { this.fire(new Event('idle')); } if (this._loaded && !this._fullyLoaded && !somethingDirty) { this._fullyLoaded = true; PerformanceUtils.mark(PerformanceMarkers.fullLoad); } return this; } /** * Force a synchronous redraw of the map. * @example * ```ts * map.redraw(); * ``` */ redraw() { if (this.style) { // cancel the scheduled update if (this._frameRequest) { this._frameRequest.abort(); this._frameRequest = null; } this._render(0); } return this; } /** * Clean up and release all internal resources associated with this map. * * This includes DOM elements, event bindings, web workers, and WebGL resources. * * Use this method when you are done using the map and wish to ensure that it no * longer consumes browser resources. Afterwards, you must not call any other * methods on the map. */ remove() { var _a; if (this._hash) this._hash.remove(); for (const control of this._controls) control.onRemove(this); this._controls = []; if (this._frameRequest) { this._frameRequest.abort(); this._frameRequest = null; } this._renderTaskQueue.clear(); this.painter.destroy(); this.handlers.destroy(); delete this.handlers; this.setStyle(null); if (typeof window !== 'undefined') { removeEventListener('online', this._onWindowOnline, false); } ImageRequest.removeThrottleControl(this._imageQueueHandle); (_a = this._resizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect(); const extension = this.painter.context.gl.getExtension('WEBGL_lose_context'); if (extension === null || extension === void 0 ? void 0 : extension.loseContext) extension.loseContext(); this._canvas.removeEventListener('webglcontextrestored', this._contextRestored, false); this._canvas.removeEventListener('webglcontextlost', this._contextLost, false); DOM.remove(this._canvasContainer); DOM.remove(this._controlContainer); this._container.classList.remove('maplibregl-map'); PerformanceUtils.clearMetrics(); this._removed = true; this.fire(new Event('remove')); } /** * Trigger the rendering of a single frame. Use this method with custom layers to * repaint the map when the layer changes. Calling this multiple times before the * next frame is rendered will still result in only a single frame being rendered. * @example * ```ts * map.triggerRepaint(); * ``` * @see [Add a 3D model](https://maplibre.org/maplibre-gl-js/docs/examples/add-3d-model/) * @see [Add an animated icon to the map](https://maplibre.org/maplibre-gl-js/docs/examples/add-image-animated/) */ triggerRepaint() { if (this.style && !this._frameRequest) { this._frameRequest = new AbortController(); browser.frameAsync(this._frameRequest).then((paintStartTimeStamp) => { PerformanceUtils.frame(paintStartTimeStamp); this._frameRequest = null; this._render(paintStartTimeStamp); }).catch(() => { }); // ignore abort error } } /** * Gets and sets a Boolean indicating whether the map will render an outline * around each tile and the tile ID. These tile boundaries are useful for * debugging. * * The uncompressed file size of the first vector source is drawn in the top left * corner of each tile, next to the tile ID. * * @example * ```ts * map.showTileBoundaries = true; * ``` */ get showTileBoundaries() { return !!this._showTileBoundaries; } set showTileBoundaries(value) { if (this._showTileBoundaries === value) return; this._showTileBoundaries = value; this._update(); } /** * Gets and sets a Boolean indicating whether the map will visualize * the padding offsets. */ get showPadding() { return !!this._showPadding; } set showPadding(value) { if (this._showPadding === value) return; this._showPadding = value; this._update(); } /** * Gets and sets a Boolean indicating whether the map will render boxes * around all symbols in the data source, revealing which symbols * were rendered or which were hidden due to collisions. * This information is useful for debugging. */ get showCollisionBoxes() { return !!this._showCollisionBoxes; } set showCollisionBoxes(value) { if (this._showCollisionBoxes === value) return; this._showCollisionBoxes = value; if (value) { // When we turn collision boxes on we have to generate them for existing tiles // When we turn them off, there's no cost to leaving existing boxes in place this.style._generateCollisionBoxes(); } else { // Otherwise, call an update to remove collision boxes this._update(); } } /** * Gets and sets a Boolean indicating whether the map should color-code * each fragment to show how many times it has been shaded. * White fragments have been shaded 8 or more times. * Black fragments have been shaded 0 times. * This information is useful for debugging. */ get showOverdrawInspector() { return !!this._showOverdrawInspector; } set showOverdrawInspector(value) { if (this._showOverdrawInspector === value) return; this._showOverdrawInspector = value; this._update(); } /** * Gets and sets a Boolean indicating whether the map will * continuously repaint. This information is useful for analyzing performance. */ get repaint() { return !!this._repaint; } set repaint(value) { if (this._repaint !== value) { this._repaint = value; this.triggerRepaint(); } } // show vertices get vertices() { return !!this._vertices; } set vertices(value) { this._vertices = value; this._update(); } /** * Returns the package version of the library * @returns Package version of the library */ get version() { return version$1; } /** * Returns the elevation for the point where the camera is looking. * This value corresponds to: * "meters above sea level" * "exaggeration" * @returns The elevation. */ getCameraTargetElevation() { return this.transform.elevation; } }; const assignEvents = (handler) => { handler.touchstart = handler.dragStart; handler.touchmoveWindow = handler.dragMove; handler.touchend = handler.dragEnd; }; const generateOneFingerTouchRotationHandler = ({ enable, clickTolerance, bearingDegreesPerPixelMoved = 0.8 }) => { const touchMoveStateManager = new OneFingerTouchMoveStateManager(); return new DragHandler({ clickTolerance, move: (lastPoint, point) => ({ bearingDelta: (point.x - lastPoint.x) * bearingDegreesPerPixelMoved }), moveStateManager: touchMoveStateManager, enable, assignEvents, }); }; const generateOneFingerTouchPitchHandler = ({ enable, clickTolerance, pitchDegreesPerPixelMoved = -0.5 }) => { const touchMoveStateManager = new OneFingerTouchMoveStateManager(); return new DragHandler({ clickTolerance, move: (lastPoint, point) => ({ pitchDelta: (point.y - lastPoint.y) * pitchDegreesPerPixelMoved }), moveStateManager: touchMoveStateManager, enable, assignEvents, }); }; const defaultOptions$3 = { showCompass: true, showZoom: true, visualizePitch: false }; /** * A `NavigationControl` control contains zoom buttons and a compass. * * @group Markers and Controls * * @example * ```ts * let nav = new NavigationControl(); * map.addControl(nav, 'top-left'); * ``` * @see [Display map navigation controls](https://maplibre.org/maplibre-gl-js/docs/examples/navigation/) */ class NavigationControl { /** * @param options - the control's options */ constructor(options) { this._updateZoomButtons = () => { const zoom = this._map.getZoom(); const isMax = zoom === this._map.getMaxZoom(); const isMin = zoom === this._map.getMinZoom(); this._zoomInButton.disabled = isMax; this._zoomOutButton.disabled = isMin; this._zoomInButton.setAttribute('aria-disabled', isMax.toString()); this._zoomOutButton.setAttribute('aria-disabled', isMin.toString()); }; this._rotateCompassArrow = () => { const rotate = this.options.visualizePitch ? `scale(${1 / Math.pow(Math.cos(this._map.transform.pitch * (Math.PI / 180)), 0.5)}) rotateX(${this._map.transform.pitch}deg) rotateZ(${this._map.transform.angle * (180 / Math.PI)}deg)` : `rotate(${this._map.transform.angle * (180 / Math.PI)}deg)`; this._compassIcon.style.transform = rotate; }; this._setButtonTitle = (button, title) => { const str = this._map._getUIString(`NavigationControl.${title}`); button.title = str; button.setAttribute('aria-label', str); }; this.options = extend({}, defaultOptions$3, options); this._container = DOM.create('div', 'maplibregl-ctrl maplibregl-ctrl-group'); this._container.addEventListener('contextmenu', (e) => e.preventDefault()); if (this.options.showZoom) { this._zoomInButton = this._createButton('maplibregl-ctrl-zoom-in', (e) => this._map.zoomIn({}, { originalEvent: e })); DOM.create('span', 'maplibregl-ctrl-icon', this._zoomInButton).setAttribute('aria-hidden', 'true'); this._zoomOutButton = this._createButton('maplibregl-ctrl-zoom-out', (e) => this._map.zoomOut({}, { originalEvent: e })); DOM.create('span', 'maplibregl-ctrl-icon', this._zoomOutButton).setAttribute('aria-hidden', 'true'); } if (this.options.showCompass) { this._compass = this._createButton('maplibregl-ctrl-compass', (e) => { if (this.options.visualizePitch) { this._map.resetNorthPitch({}, { originalEvent: e }); } else { this._map.resetNorth({}, { originalEvent: e }); } }); this._compassIcon = DOM.create('span', 'maplibregl-ctrl-icon', this._compass); this._compassIcon.setAttribute('aria-hidden', 'true'); } } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; if (this.options.showZoom) { this._setButtonTitle(this._zoomInButton, 'ZoomIn'); this._setButtonTitle(this._zoomOutButton, 'ZoomOut'); this._map.on('zoom', this._updateZoomButtons); this._updateZoomButtons(); } if (this.options.showCompass) { this._setButtonTitle(this._compass, 'ResetBearing'); if (this.options.visualizePitch) { this._map.on('pitch', this._rotateCompassArrow); } this._map.on('rotate', this._rotateCompassArrow); this._rotateCompassArrow(); this._handler = new MouseRotateWrapper(this._map, this._compass, this.options.visualizePitch); } return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._container); if (this.options.showZoom) { this._map.off('zoom', this._updateZoomButtons); } if (this.options.showCompass) { if (this.options.visualizePitch) { this._map.off('pitch', this._rotateCompassArrow); } this._map.off('rotate', this._rotateCompassArrow); this._handler.off(); delete this._handler; } delete this._map; } _createButton(className, fn) { const a = DOM.create('button', className, this._container); a.type = 'button'; a.addEventListener('click', fn); return a; } } class MouseRotateWrapper { constructor(map, element, pitch = false) { this.mousedown = (e) => { this.startMouse(extend({}, e, { ctrlKey: true, preventDefault: () => e.preventDefault() }), DOM.mousePos(this.element, e)); DOM.addEventListener(window, 'mousemove', this.mousemove); DOM.addEventListener(window, 'mouseup', this.mouseup); }; this.mousemove = (e) => { this.moveMouse(e, DOM.mousePos(this.element, e)); }; this.mouseup = (e) => { this.mouseRotate.dragEnd(e); if (this.mousePitch) this.mousePitch.dragEnd(e); this.offTemp(); }; this.touchstart = (e) => { if (e.targetTouches.length !== 1) { this.reset(); } else { this._startPos = this._lastPos = DOM.touchPos(this.element, e.targetTouches)[0]; this.startTouch(e, this._startPos); DOM.addEventListener(window, 'touchmove', this.touchmove, { passive: false }); DOM.addEventListener(window, 'touchend', this.touchend); } }; this.touchmove = (e) => { if (e.targetTouches.length !== 1) { this.reset(); } else { this._lastPos = DOM.touchPos(this.element, e.targetTouches)[0]; this.moveTouch(e, this._lastPos); } }; this.touchend = (e) => { if (e.targetTouches.length === 0 && this._startPos && this._lastPos && this._startPos.dist(this._lastPos) < this._clickTolerance) { this.element.click(); } delete this._startPos; delete this._lastPos; this.offTemp(); }; this.reset = () => { this.mouseRotate.reset(); if (this.mousePitch) this.mousePitch.reset(); this.touchRotate.reset(); if (this.touchPitch) this.touchPitch.reset(); delete this._startPos; delete this._lastPos; this.offTemp(); }; this._clickTolerance = 10; const mapRotateTolerance = map.dragRotate._mouseRotate.getClickTolerance(); const mapPitchTolerance = map.dragRotate._mousePitch.getClickTolerance(); this.element = element; this.mouseRotate = generateMouseRotationHandler({ clickTolerance: mapRotateTolerance, enable: true }); this.touchRotate = generateOneFingerTouchRotationHandler({ clickTolerance: mapRotateTolerance, enable: true }); this.map = map; if (pitch) { this.mousePitch = generateMousePitchHandler({ clickTolerance: mapPitchTolerance, enable: true }); this.touchPitch = generateOneFingerTouchPitchHandler({ clickTolerance: mapPitchTolerance, enable: true }); } DOM.addEventListener(element, 'mousedown', this.mousedown); DOM.addEventListener(element, 'touchstart', this.touchstart, { passive: false }); DOM.addEventListener(element, 'touchcancel', this.reset); } startMouse(e, point) { this.mouseRotate.dragStart(e, point); if (this.mousePitch) this.mousePitch.dragStart(e, point); DOM.disableDrag(); } startTouch(e, point) { this.touchRotate.dragStart(e, point); if (this.touchPitch) this.touchPitch.dragStart(e, point); DOM.disableDrag(); } moveMouse(e, point) { const map = this.map; const { bearingDelta } = this.mouseRotate.dragMove(e, point) || {}; if (bearingDelta) map.setBearing(map.getBearing() + bearingDelta); if (this.mousePitch) { const { pitchDelta } = this.mousePitch.dragMove(e, point) || {}; if (pitchDelta) map.setPitch(map.getPitch() + pitchDelta); } } moveTouch(e, point) { const map = this.map; const { bearingDelta } = this.touchRotate.dragMove(e, point) || {}; if (bearingDelta) map.setBearing(map.getBearing() + bearingDelta); if (this.touchPitch) { const { pitchDelta } = this.touchPitch.dragMove(e, point) || {}; if (pitchDelta) map.setPitch(map.getPitch() + pitchDelta); } } off() { const element = this.element; DOM.removeEventListener(element, 'mousedown', this.mousedown); DOM.removeEventListener(element, 'touchstart', this.touchstart, { passive: false }); DOM.removeEventListener(window, 'touchmove', this.touchmove, { passive: false }); DOM.removeEventListener(window, 'touchend', this.touchend); DOM.removeEventListener(element, 'touchcancel', this.reset); this.offTemp(); } offTemp() { DOM.enableDrag(); DOM.removeEventListener(window, 'mousemove', this.mousemove); DOM.removeEventListener(window, 'mouseup', this.mouseup); DOM.removeEventListener(window, 'touchmove', this.touchmove, { passive: false }); DOM.removeEventListener(window, 'touchend', this.touchend); } } let supportsGeolocation; function checkGeolocationSupport() { return __awaiter(this, arguments, void 0, function* (forceRecalculation = false) { if (supportsGeolocation !== undefined && !forceRecalculation) { return supportsGeolocation; } if (window.navigator.permissions === undefined) { supportsGeolocation = !!window.navigator.geolocation; return supportsGeolocation; } // navigator.permissions has incomplete browser support // https://caniuse.com/#feat=permissions-api // Test for the case where a browser disables Geolocation because of an // insecure origin try { const permissions = yield window.navigator.permissions.query({ name: 'geolocation' }); supportsGeolocation = permissions.state !== 'denied'; // eslint-disable-line require-atomic-updates } catch (_a) { // Fix for iOS16 which rejects query but still supports geolocation supportsGeolocation = !!window.navigator.geolocation; // eslint-disable-line require-atomic-updates } return supportsGeolocation; }); } /** * Given a LngLat, prior projected position, and a transform, return a new LngLat shifted * n × 360° east or west for some n ≥ 0 such that: * * * the projected location of the result is on screen, if possible, and secondarily: * * the difference between the projected location of the result and the prior position * is minimized. * * The object is to preserve perceived object constancy for Popups and Markers as much as * possible; they should avoid shifting large distances across the screen, even when the * map center changes by ±360° due to automatic wrapping, and when about to go off screen, * should wrap just enough to avoid doing so. */ function smartWrap(lngLat, priorPos, transform) { const originalLngLat = new LngLat(lngLat.lng, lngLat.lat); lngLat = new LngLat(lngLat.lng, lngLat.lat); // First, try shifting one world in either direction, and see if either is closer to the // prior position. This preserves object constancy when the map center is auto-wrapped // during animations. if (priorPos) { const left = new LngLat(lngLat.lng - 360, lngLat.lat); const right = new LngLat(lngLat.lng + 360, lngLat.lat); const delta = transform.locationPoint(lngLat).distSqr(priorPos); if (transform.locationPoint(left).distSqr(priorPos) < delta) { lngLat = left; } else if (transform.locationPoint(right).distSqr(priorPos) < delta) { lngLat = right; } } // Second, wrap toward the center until the new position is on screen, or we can't get // any closer. while (Math.abs(lngLat.lng - transform.center.lng) > 180) { const pos = transform.locationPoint(lngLat); if (pos.x >= 0 && pos.y >= 0 && pos.x <= transform.width && pos.y <= transform.height) { break; } if (lngLat.lng > transform.center.lng) { lngLat.lng -= 360; } else { lngLat.lng += 360; } } // Apply the change only if new coord is below horizon if (lngLat.lng !== originalLngLat.lng && transform.locationPoint(lngLat).y > (transform.height / 2 - transform.getHorizon())) { return lngLat; } return originalLngLat; } const anchorTranslate = { 'center': 'translate(-50%,-50%)', 'top': 'translate(-50%,0)', 'top-left': 'translate(0,0)', 'top-right': 'translate(-100%,0)', 'bottom': 'translate(-50%,-100%)', 'bottom-left': 'translate(0,-100%)', 'bottom-right': 'translate(-100%,-100%)', 'left': 'translate(0,-50%)', 'right': 'translate(-100%,-50%)' }; function applyAnchorClass(element, anchor, prefix) { const classList = element.classList; for (const key in anchorTranslate) { classList.remove(`maplibregl-${prefix}-anchor-${key}`); } classList.add(`maplibregl-${prefix}-anchor-${anchor}`); } /** * Creates a marker component * * @group Markers and Controls * * @example * ```ts * let marker = new Marker() * .setLngLat([30.5, 50.5]) * .addTo(map); * ``` * * @example * Set options * ```ts * let marker = new Marker({ * color: "#FFFFFF", * draggable: true * }).setLngLat([30.5, 50.5]) * .addTo(map); * ``` * @see [Add custom icons with Markers](https://maplibre.org/maplibre-gl-js/docs/examples/custom-marker-icons/) * @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-marker/) * * ## Events * * **Event** `dragstart` of type {@link Event} will be fired when dragging starts. * * **Event** `drag` of type {@link Event} will be fired while dragging. * * **Event** `dragend` of type {@link Event} will be fired when the marker is finished being dragged. */ class Marker extends Evented { /** * @param options - the options */ constructor(options) { super(); this._onKeyPress = (e) => { const code = e.code; const legacyCode = e.charCode || e.keyCode; if ((code === 'Space') || (code === 'Enter') || (legacyCode === 32) || (legacyCode === 13) // space or enter ) { this.togglePopup(); } }; this._onMapClick = (e) => { const targetElement = e.originalEvent.target; const element = this._element; if (this._popup && (targetElement === element || element.contains(targetElement))) { this.togglePopup(); } }; this._update = (e) => { var _a; if (!this._map) return; const isFullyLoaded = this._map.loaded() && !this._map.isMoving(); if ((e === null || e === void 0 ? void 0 : e.type) === 'terrain' || ((e === null || e === void 0 ? void 0 : e.type) === 'render' && !isFullyLoaded)) { this._map.once('render', this._update); } if (this._map.transform.renderWorldCopies) { this._lngLat = smartWrap(this._lngLat, this._flatPos, this._map.transform); } else { this._lngLat = (_a = this._lngLat) === null || _a === void 0 ? void 0 : _a.wrap(); } this._flatPos = this._pos = this._map.project(this._lngLat)._add(this._offset); if (this._map.terrain) { // flat position is saved because smartWrap needs non-elevated points this._flatPos = this._map.transform.locationPoint(this._lngLat)._add(this._offset); } let rotation = ''; if (this._rotationAlignment === 'viewport' || this._rotationAlignment === 'auto') { rotation = `rotateZ(${this._rotation}deg)`; } else if (this._rotationAlignment === 'map') { rotation = `rotateZ(${this._rotation - this._map.getBearing()}deg)`; } let pitch = ''; if (this._pitchAlignment === 'viewport' || this._pitchAlignment === 'auto') { pitch = 'rotateX(0deg)'; } else if (this._pitchAlignment === 'map') { pitch = `rotateX(${this._map.getPitch()}deg)`; } // because rounding the coordinates at every `move` event causes stuttered zooming // we only round them when _update is called with `moveend` or when its called with // no arguments (when the Marker is initialized or Marker#setLngLat is invoked). if (!this._subpixelPositioning && (!e || e.type === 'moveend')) { this._pos = this._pos.round(); } DOM.setTransform(this._element, `${anchorTranslate[this._anchor]} translate(${this._pos.x}px, ${this._pos.y}px) ${pitch} ${rotation}`); browser.frameAsync(new AbortController()).then(() => { this._updateOpacity(e && e.type === 'moveend'); }).catch(() => { }); }; this._onMove = (e) => { if (!this._isDragging) { const clickTolerance = this._clickTolerance || this._map._clickTolerance; this._isDragging = e.point.dist(this._pointerdownPos) >= clickTolerance; } if (!this._isDragging) return; this._pos = e.point.sub(this._positionDelta); this._lngLat = this._map.unproject(this._pos); this.setLngLat(this._lngLat); // suppress click event so that popups don't toggle on drag this._element.style.pointerEvents = 'none'; // make sure dragstart only fires on the first move event after mousedown. // this can't be on mousedown because that event doesn't necessarily // imply that a drag is about to happen. if (this._state === 'pending') { this._state = 'active'; this.fire(new Event('dragstart')); } this.fire(new Event('drag')); }; this._onUp = () => { // revert to normal pointer event handling this._element.style.pointerEvents = 'auto'; this._positionDelta = null; this._pointerdownPos = null; this._isDragging = false; this._map.off('mousemove', this._onMove); this._map.off('touchmove', this._onMove); // only fire dragend if it was preceded by at least one drag event if (this._state === 'active') { this.fire(new Event('dragend')); } this._state = 'inactive'; }; this._addDragHandler = (e) => { if (this._element.contains(e.originalEvent.target)) { e.preventDefault(); // We need to calculate the pixel distance between the click point // and the marker position, with the offset accounted for. Then we // can subtract this distance from the mousemove event's position // to calculate the new marker position. // If we don't do this, the marker 'jumps' to the click position // creating a jarring UX effect. this._positionDelta = e.point.sub(this._pos).add(this._offset); this._pointerdownPos = e.point; this._state = 'pending'; this._map.on('mousemove', this._onMove); this._map.on('touchmove', this._onMove); this._map.once('mouseup', this._onUp); this._map.once('touchend', this._onUp); } }; this._anchor = options && options.anchor || 'center'; this._color = options && options.color || '#3FB1CE'; this._scale = options && options.scale || 1; this._draggable = options && options.draggable || false; this._clickTolerance = options && options.clickTolerance || 0; this._subpixelPositioning = options && options.subpixelPositioning || false; this._isDragging = false; this._state = 'inactive'; this._rotation = options && options.rotation || 0; this._rotationAlignment = options && options.rotationAlignment || 'auto'; this._pitchAlignment = options && options.pitchAlignment && options.pitchAlignment !== 'auto' ? options.pitchAlignment : this._rotationAlignment; this.setOpacity(); // set default opacity this.setOpacity(options === null || options === void 0 ? void 0 : options.opacity, options === null || options === void 0 ? void 0 : options.opacityWhenCovered); if (!options || !options.element) { this._defaultMarker = true; this._element = DOM.create('div'); // create default map marker SVG const svg = DOM.createNS('http://www.w3.org/2000/svg', 'svg'); const defaultHeight = 41; const defaultWidth = 27; svg.setAttributeNS(null, 'display', 'block'); svg.setAttributeNS(null, 'height', `${defaultHeight}px`); svg.setAttributeNS(null, 'width', `${defaultWidth}px`); svg.setAttributeNS(null, 'viewBox', `0 0 ${defaultWidth} ${defaultHeight}`); const markerLarge = DOM.createNS('http://www.w3.org/2000/svg', 'g'); markerLarge.setAttributeNS(null, 'stroke', 'none'); markerLarge.setAttributeNS(null, 'stroke-width', '1'); markerLarge.setAttributeNS(null, 'fill', 'none'); markerLarge.setAttributeNS(null, 'fill-rule', 'evenodd'); const page1 = DOM.createNS('http://www.w3.org/2000/svg', 'g'); page1.setAttributeNS(null, 'fill-rule', 'nonzero'); const shadow = DOM.createNS('http://www.w3.org/2000/svg', 'g'); shadow.setAttributeNS(null, 'transform', 'translate(3.0, 29.0)'); shadow.setAttributeNS(null, 'fill', '#000000'); const ellipses = [ { 'rx': '10.5', 'ry': '5.25002273' }, { 'rx': '10.5', 'ry': '5.25002273' }, { 'rx': '9.5', 'ry': '4.77275007' }, { 'rx': '8.5', 'ry': '4.29549936' }, { 'rx': '7.5', 'ry': '3.81822308' }, { 'rx': '6.5', 'ry': '3.34094679' }, { 'rx': '5.5', 'ry': '2.86367051' }, { 'rx': '4.5', 'ry': '2.38636864' } ]; for (const data of ellipses) { const ellipse = DOM.createNS('http://www.w3.org/2000/svg', 'ellipse'); ellipse.setAttributeNS(null, 'opacity', '0.04'); ellipse.setAttributeNS(null, 'cx', '10.5'); ellipse.setAttributeNS(null, 'cy', '5.80029008'); ellipse.setAttributeNS(null, 'rx', data['rx']); ellipse.setAttributeNS(null, 'ry', data['ry']); shadow.appendChild(ellipse); } const background = DOM.createNS('http://www.w3.org/2000/svg', 'g'); background.setAttributeNS(null, 'fill', this._color); const bgPath = DOM.createNS('http://www.w3.org/2000/svg', 'path'); bgPath.setAttributeNS(null, 'd', 'M27,13.5 C27,19.074644 20.250001,27.000002 14.75,34.500002 C14.016665,35.500004 12.983335,35.500004 12.25,34.500002 C6.7499993,27.000002 0,19.222562 0,13.5 C0,6.0441559 6.0441559,0 13.5,0 C20.955844,0 27,6.0441559 27,13.5 Z'); background.appendChild(bgPath); const border = DOM.createNS('http://www.w3.org/2000/svg', 'g'); border.setAttributeNS(null, 'opacity', '0.25'); border.setAttributeNS(null, 'fill', '#000000'); const borderPath = DOM.createNS('http://www.w3.org/2000/svg', 'path'); borderPath.setAttributeNS(null, 'd', 'M13.5,0 C6.0441559,0 0,6.0441559 0,13.5 C0,19.222562 6.7499993,27 12.25,34.5 C13,35.522727 14.016664,35.500004 14.75,34.5 C20.250001,27 27,19.074644 27,13.5 C27,6.0441559 20.955844,0 13.5,0 Z M13.5,1 C20.415404,1 26,6.584596 26,13.5 C26,15.898657 24.495584,19.181431 22.220703,22.738281 C19.945823,26.295132 16.705119,30.142167 13.943359,33.908203 C13.743445,34.180814 13.612715,34.322738 13.5,34.441406 C13.387285,34.322738 13.256555,34.180814 13.056641,33.908203 C10.284481,30.127985 7.4148684,26.314159 5.015625,22.773438 C2.6163816,19.232715 1,15.953538 1,13.5 C1,6.584596 6.584596,1 13.5,1 Z'); border.appendChild(borderPath); const maki = DOM.createNS('http://www.w3.org/2000/svg', 'g'); maki.setAttributeNS(null, 'transform', 'translate(6.0, 7.0)'); maki.setAttributeNS(null, 'fill', '#FFFFFF'); const circleContainer = DOM.createNS('http://www.w3.org/2000/svg', 'g'); circleContainer.setAttributeNS(null, 'transform', 'translate(8.0, 8.0)'); const circle1 = DOM.createNS('http://www.w3.org/2000/svg', 'circle'); circle1.setAttributeNS(null, 'fill', '#000000'); circle1.setAttributeNS(null, 'opacity', '0.25'); circle1.setAttributeNS(null, 'cx', '5.5'); circle1.setAttributeNS(null, 'cy', '5.5'); circle1.setAttributeNS(null, 'r', '5.4999962'); const circle2 = DOM.createNS('http://www.w3.org/2000/svg', 'circle'); circle2.setAttributeNS(null, 'fill', '#FFFFFF'); circle2.setAttributeNS(null, 'cx', '5.5'); circle2.setAttributeNS(null, 'cy', '5.5'); circle2.setAttributeNS(null, 'r', '5.4999962'); circleContainer.appendChild(circle1); circleContainer.appendChild(circle2); page1.appendChild(shadow); page1.appendChild(background); page1.appendChild(border); page1.appendChild(maki); page1.appendChild(circleContainer); svg.appendChild(page1); svg.setAttributeNS(null, 'height', `${defaultHeight * this._scale}px`); svg.setAttributeNS(null, 'width', `${defaultWidth * this._scale}px`); this._element.appendChild(svg); // if no element and no offset option given apply an offset for the default marker // the -14 as the y value of the default marker offset was determined as follows // // the marker tip is at the center of the shadow ellipse from the default svg // the y value of the center of the shadow ellipse relative to the svg top left is "shadow transform translate-y (29.0) + ellipse cy (5.80029008)" // offset to the svg center "height (41 / 2)" gives (29.0 + 5.80029008) - (41 / 2) and rounded for an integer pixel offset gives 14 // negative is used to move the marker up from the center so the tip is at the Marker lngLat this._offset = Point$2.convert(options && options.offset || [0, -14]); } else { this._element = options.element; this._offset = Point$2.convert(options && options.offset || [0, 0]); } this._element.classList.add('maplibregl-marker'); this._element.addEventListener('dragstart', (e) => { e.preventDefault(); }); this._element.addEventListener('mousedown', (e) => { // prevent focusing on click e.preventDefault(); }); applyAnchorClass(this._element, this._anchor, 'marker'); if (options && options.className) { for (const name of options.className.split(' ')) { this._element.classList.add(name); } } this._popup = null; } /** * Attaches the `Marker` to a `Map` object. * @param map - The MapLibre GL JS map to add the marker to. * @example * ```ts * let marker = new Marker() * .setLngLat([30.5, 50.5]) * .addTo(map); // add the marker to the map * ``` */ addTo(map) { this.remove(); this._map = map; this._element.setAttribute('aria-label', map._getUIString('Marker.Title')); map.getCanvasContainer().appendChild(this._element); map.on('move', this._update); map.on('moveend', this._update); map.on('terrain', this._update); this.setDraggable(this._draggable); this._update(); // If we attached the `click` listener to the marker element, the popup // would close once the event propagated to `map` due to the // `Popup#_onClickClose` listener. this._map.on('click', this._onMapClick); return this; } /** * Removes the marker from a map * @example * ```ts * let marker = new Marker().addTo(map); * marker.remove(); * ``` */ remove() { if (this._opacityTimeout) { clearTimeout(this._opacityTimeout); delete this._opacityTimeout; } if (this._map) { this._map.off('click', this._onMapClick); this._map.off('move', this._update); this._map.off('moveend', this._update); this._map.off('terrain', this._update); this._map.off('mousedown', this._addDragHandler); this._map.off('touchstart', this._addDragHandler); this._map.off('mouseup', this._onUp); this._map.off('touchend', this._onUp); this._map.off('mousemove', this._onMove); this._map.off('touchmove', this._onMove); delete this._map; } DOM.remove(this._element); if (this._popup) this._popup.remove(); return this; } /** * Get the marker's geographical location. * * The longitude of the result may differ by a multiple of 360 degrees from the longitude previously * set by `setLngLat` because `Marker` wraps the anchor longitude across copies of the world to keep * the marker on screen. * * @returns A {@link LngLat} describing the marker's location. * @example * ```ts * // Store the marker's longitude and latitude coordinates in a variable * let lngLat = marker.getLngLat(); * // Print the marker's longitude and latitude values in the console * console.log('Longitude: ' + lngLat.lng + ', Latitude: ' + lngLat.lat ) * ``` * @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-marker/) */ getLngLat() { return this._lngLat; } /** * Set the marker's geographical position and move it. * @param lnglat - A {@link LngLat} describing where the marker should be located. * @example * Create a new marker, set the longitude and latitude, and add it to the map * ```ts * new Marker() * .setLngLat([-65.017, -16.457]) * .addTo(map); * ``` * @see [Add custom icons with Markers](https://maplibre.org/maplibre-gl-js/docs/examples/custom-marker-icons/) * @see [Create a draggable Marker](https://maplibre.org/maplibre-gl-js/docs/examples/drag-a-marker/) */ setLngLat(lnglat) { this._lngLat = LngLat.convert(lnglat); this._pos = null; if (this._popup) this._popup.setLngLat(this._lngLat); this._update(); return this; } /** * Returns the `Marker`'s HTML element. * @returns element */ getElement() { return this._element; } /** * Binds a {@link Popup} to the {@link Marker}. * @param popup - An instance of the {@link Popup} class. If undefined or null, any popup * set on this {@link Marker} instance is unset. * @example * ```ts * let marker = new Marker() * .setLngLat([0, 0]) * .setPopup(new Popup().setHTML("

Hello World!

")) // add popup * .addTo(map); * ``` * @see [Attach a popup to a marker instance](https://maplibre.org/maplibre-gl-js/docs/examples/set-popup/) */ setPopup(popup) { if (this._popup) { this._popup.remove(); this._popup = null; this._element.removeEventListener('keypress', this._onKeyPress); if (!this._originalTabIndex) { this._element.removeAttribute('tabindex'); } } if (popup) { if (!('offset' in popup.options)) { const markerHeight = 41 - (5.8 / 2); const markerRadius = 13.5; const linearOffset = Math.abs(markerRadius) / Math.SQRT2; popup.options.offset = this._defaultMarker ? { 'top': [0, 0], 'top-left': [0, 0], 'top-right': [0, 0], 'bottom': [0, -markerHeight], 'bottom-left': [linearOffset, (markerHeight - markerRadius + linearOffset) * -1], 'bottom-right': [-linearOffset, (markerHeight - markerRadius + linearOffset) * -1], 'left': [markerRadius, (markerHeight - markerRadius) * -1], 'right': [-markerRadius, (markerHeight - markerRadius) * -1] } : this._offset; } this._popup = popup; this._originalTabIndex = this._element.getAttribute('tabindex'); if (!this._originalTabIndex) { this._element.setAttribute('tabindex', '0'); } this._element.addEventListener('keypress', this._onKeyPress); } return this; } /** * Set the option to allow subpixel positioning of the marker by passing a boolean * * @param value - when set to `true`, subpixel positioning is enabled for the marker. * * @example * ```ts * let marker = new Marker() * marker.setSubpixelPositioning(true); * ``` */ setSubpixelPositioning(value) { this._subpixelPositioning = value; return this; } /** * Returns the {@link Popup} instance that is bound to the {@link Marker}. * @returns popup * @example * ```ts * let marker = new Marker() * .setLngLat([0, 0]) * .setPopup(new Popup().setHTML("

Hello World!

")) * .addTo(map); * * console.log(marker.getPopup()); // return the popup instance * ``` */ getPopup() { return this._popup; } /** * Opens or closes the {@link Popup} instance that is bound to the {@link Marker}, depending on the current state of the {@link Popup}. * @example * ```ts * let marker = new Marker() * .setLngLat([0, 0]) * .setPopup(new Popup().setHTML("

Hello World!

")) * .addTo(map); * * marker.togglePopup(); // toggle popup open or closed * ``` */ togglePopup() { const popup = this._popup; if (this._element.style.opacity === this._opacityWhenCovered) return this; if (!popup) return this; else if (popup.isOpen()) popup.remove(); else { popup.setLngLat(this._lngLat); popup.addTo(this._map); } return this; } _updateOpacity(force = false) { var _a, _b; const terrain = (_a = this._map) === null || _a === void 0 ? void 0 : _a.terrain; if (!terrain) { if (this._element.style.opacity !== this._opacity) { this._element.style.opacity = this._opacity; } return; } if (force) { this._opacityTimeout = null; } else { if (this._opacityTimeout) { return; } this._opacityTimeout = setTimeout(() => { this._opacityTimeout = null; }, 100); } const map = this._map; // Read depth framebuffer, getting position of terrain in line of sight to marker const terrainDistance = map.terrain.depthAtPoint(this._pos); // Transform marker position to clip space const elevation = map.terrain.getElevationForLngLatZoom(this._lngLat, map.transform.tileZoom); const markerDistance = map.transform.lngLatToCameraDepth(this._lngLat, elevation); const forgiveness = .006; if (markerDistance - terrainDistance < forgiveness) { this._element.style.opacity = this._opacity; return; } // If the base is obscured, use the offset to check if the marker's center is obscured. const metersToCenter = -this._offset.y / map.transform._pixelPerMeter; const elevationToCenter = Math.sin(map.getPitch() * Math.PI / 180) * metersToCenter; const terrainDistanceCenter = map.terrain.depthAtPoint(new Point$2(this._pos.x, this._pos.y - this._offset.y)); const markerDistanceCenter = map.transform.lngLatToCameraDepth(this._lngLat, elevation + elevationToCenter); // Display at full opacity if center is visible. const centerIsInvisible = markerDistanceCenter - terrainDistanceCenter > forgiveness; if (((_b = this._popup) === null || _b === void 0 ? void 0 : _b.isOpen()) && centerIsInvisible) this._popup.remove(); this._element.style.opacity = centerIsInvisible ? this._opacityWhenCovered : this._opacity; } /** * Get the marker's offset. * @returns The marker's screen coordinates in pixels. */ getOffset() { return this._offset; } /** * Sets the offset of the marker * @param offset - The offset in pixels as a {@link PointLike} object to apply relative to the element's center. Negatives indicate left and up. */ setOffset(offset) { this._offset = Point$2.convert(offset); this._update(); return this; } /** * Adds a CSS class to the marker element. * * @param className - on-empty string with CSS class name to add to marker element * * @example * ``` * let marker = new Marker() * marker.addClassName('some-class') * ``` */ addClassName(className) { this._element.classList.add(className); } /** * Removes a CSS class from the marker element. * * @param className - Non-empty string with CSS class name to remove from marker element * * @example * ```ts * let marker = new Marker() * marker.removeClassName('some-class') * ``` */ removeClassName(className) { this._element.classList.remove(className); } /** * Add or remove the given CSS class on the marker element, depending on whether the element currently has that class. * * @param className - Non-empty string with CSS class name to add/remove * * @returns if the class was removed return false, if class was added, then return true * * @example * ```ts * let marker = new Marker() * marker.toggleClassName('toggleClass') * ``` */ toggleClassName(className) { return this._element.classList.toggle(className); } /** * Sets the `draggable` property and functionality of the marker * @param shouldBeDraggable - Turns drag functionality on/off */ setDraggable(shouldBeDraggable) { this._draggable = !!shouldBeDraggable; // convert possible undefined value to false // handle case where map may not exist yet // e.g. when setDraggable is called before addTo if (this._map) { if (shouldBeDraggable) { this._map.on('mousedown', this._addDragHandler); this._map.on('touchstart', this._addDragHandler); } else { this._map.off('mousedown', this._addDragHandler); this._map.off('touchstart', this._addDragHandler); } } return this; } /** * Returns true if the marker can be dragged * @returns True if the marker is draggable. */ isDraggable() { return this._draggable; } /** * Sets the `rotation` property of the marker. * @param rotation - The rotation angle of the marker (clockwise, in degrees), relative to its respective {@link Marker#setRotationAlignment} setting. */ setRotation(rotation) { this._rotation = rotation || 0; this._update(); return this; } /** * Returns the current rotation angle of the marker (in degrees). * @returns The current rotation angle of the marker. */ getRotation() { return this._rotation; } /** * Sets the `rotationAlignment` property of the marker. * @param alignment - Sets the `rotationAlignment` property of the marker. defaults to 'auto' */ setRotationAlignment(alignment) { this._rotationAlignment = alignment || 'auto'; this._update(); return this; } /** * Returns the current `rotationAlignment` property of the marker. * @returns The current rotational alignment of the marker. */ getRotationAlignment() { return this._rotationAlignment; } /** * Sets the `pitchAlignment` property of the marker. * @param alignment - Sets the `pitchAlignment` property of the marker. If alignment is 'auto', it will automatically match `rotationAlignment`. */ setPitchAlignment(alignment) { this._pitchAlignment = alignment && alignment !== 'auto' ? alignment : this._rotationAlignment; this._update(); return this; } /** * Returns the current `pitchAlignment` property of the marker. * @returns The current pitch alignment of the marker in degrees. */ getPitchAlignment() { return this._pitchAlignment; } /** * Sets the `opacity` and `opacityWhenCovered` properties of the marker. * When called without arguments, resets opacity and opacityWhenCovered to defaults * @param opacity - Sets the `opacity` property of the marker. * @param opacityWhenCovered - Sets the `opacityWhenCovered` property of the marker. */ setOpacity(opacity, opacityWhenCovered) { if (opacity === undefined && opacityWhenCovered === undefined) { this._opacity = '1'; this._opacityWhenCovered = '0.2'; } if (opacity !== undefined) { this._opacity = opacity; } if (opacityWhenCovered !== undefined) { this._opacityWhenCovered = opacityWhenCovered; } if (this._map) { this._updateOpacity(true); } return this; } } const defaultOptions$2 = { positionOptions: { enableHighAccuracy: false, maximumAge: 0, timeout: 6000 /* 6 sec */ }, fitBoundsOptions: { maxZoom: 15 }, trackUserLocation: false, showAccuracyCircle: true, showUserLocation: true }; let numberOfWatches = 0; let noTimeout = false; /** * A `GeolocateControl` control provides a button that uses the browser's geolocation * API to locate the user on the map. * * Not all browsers support geolocation, * and some users may disable the feature. Geolocation support for modern * browsers including Chrome requires sites to be served over HTTPS. If * geolocation support is not available, the `GeolocateControl` will show * as disabled. * * The zoom level applied will depend on the accuracy of the geolocation provided by the device. * * The `GeolocateControl` has two modes. If `trackUserLocation` is `false` (default) the control acts as a button, which when pressed will set the map's camera to target the user location. If the user moves, the map won't update. This is most suited for the desktop. If `trackUserLocation` is `true` the control acts as a toggle button that when active the user's location is actively monitored for changes. In this mode the `GeolocateControl` has three interaction states: * * active - the map's camera automatically updates as the user's location changes, keeping the location dot in the center. Initial state and upon clicking the `GeolocateControl` button. * * passive - the user's location dot automatically updates, but the map's camera does not. Occurs upon the user initiating a map movement. * * disabled - occurs if Geolocation is not available, disabled or denied. * * These interaction states can't be controlled programmatically, rather they are set based on user interactions. * * ## State Diagram * ![GeolocateControl state diagram](https://github.com/maplibre/maplibre-gl-js/assets/3269297/78e720e5-d781-4da8-9803-a7a0e6aaaa9f) * * @group Markers and Controls * * @example * ```ts * map.addControl(new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * })); * ``` * @see [Locate the user](https://maplibre.org/maplibre-gl-js/docs/examples/locate-user/) * * ## Events * * **Event** `trackuserlocationend` of type {@link Event} will be fired when the `GeolocateControl` changes to the background state, which happens when a user changes the camera during an active position lock. This only applies when `trackUserLocation` is `true`. In the background state, the dot on the map will update with location updates but the camera will not. * * **Event** `trackuserlocationstart` of type {@link Event} will be fired when the `GeolocateControl` changes to the active lock state, which happens either upon first obtaining a successful Geolocation API position for the user (a `geolocate` event will follow), or the user clicks the geolocate button when in the background state which uses the last known position to recenter the map and enter active lock state (no `geolocate` event will follow unless the users's location changes). * * **Event** `userlocationlostfocus` of type {@link Event} will be fired when the `GeolocateControl` changes to the background state, which happens when a user changes the camera during an active position lock. This only applies when `trackUserLocation` is `true`. In the background state, the dot on the map will update with location updates but the camera will not. * * **Event** `userlocationfocus` of type {@link Event} will be fired when the `GeolocateControl` changes to the active lock state, which happens upon the user clicks the geolocate button when in the background state which uses the last known position to recenter the map and enter active lock state. * * **Event** `geolocate` of type {@link Event} will be fired on each Geolocation API position update which returned as success. * `data` - The returned [Position](https://developer.mozilla.org/en-US/docs/Web/API/Position) object from the callback in [Geolocation.getCurrentPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/getCurrentPosition) or [Geolocation.watchPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/watchPosition). * * **Event** `error` of type {@link Event} will be fired on each Geolocation API position update which returned as an error. * `data` - The returned [PositionError](https://developer.mozilla.org/en-US/docs/Web/API/PositionError) object from the callback in [Geolocation.getCurrentPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/getCurrentPosition) or [Geolocation.watchPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/watchPosition). * * **Event** `outofmaxbounds` of type {@link Event} will be fired on each Geolocation API position update which returned as success but user position is out of map `maxBounds`. * `data` - The returned [Position](https://developer.mozilla.org/en-US/docs/Web/API/Position) object from the callback in [Geolocation.getCurrentPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/getCurrentPosition) or [Geolocation.watchPosition()](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/watchPosition). * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when a trackuserlocationend event occurs. * geolocate.on('trackuserlocationend', () => { * console.log('A trackuserlocationend event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when a trackuserlocationstart event occurs. * geolocate.on('trackuserlocationstart', () => { * console.log('A trackuserlocationstart event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when an userlocationlostfocus event occurs. * geolocate.on('userlocationlostfocus', function() { * console.log('An userlocationlostfocus event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when an userlocationfocus event occurs. * geolocate.on('userlocationfocus', function() { * console.log('An userlocationfocus event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when a geolocate event occurs. * geolocate.on('geolocate', () => { * console.log('A geolocate event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when an error event occurs. * geolocate.on('error', () => { * console.log('An error event has occurred.') * }); * ``` * * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * // Set an event listener that fires * // when an outofmaxbounds event occurs. * geolocate.on('outofmaxbounds', () => { * console.log('An outofmaxbounds event has occurred.') * }); * ``` */ class GeolocateControl extends Evented { /** * @param options - the control's options */ constructor(options) { super(); /** * When the Geolocation API returns a new location, update the `GeolocateControl`. * * @param position - the Geolocation API Position */ this._onSuccess = (position) => { if (!this._map) { // control has since been removed return; } if (this._isOutOfMapMaxBounds(position)) { this._setErrorState(); this.fire(new Event('outofmaxbounds', position)); this._updateMarker(); this._finish(); return; } if (this.options.trackUserLocation) { // keep a record of the position so that if the state is BACKGROUND and the user // clicks the button, we can move to ACTIVE_LOCK immediately without waiting for // watchPosition to trigger _onSuccess this._lastKnownPosition = position; switch (this._watchState) { case 'WAITING_ACTIVE': case 'ACTIVE_LOCK': case 'ACTIVE_ERROR': this._watchState = 'ACTIVE_LOCK'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active-error'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-active'); break; case 'BACKGROUND': case 'BACKGROUND_ERROR': this._watchState = 'BACKGROUND'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background-error'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-background'); break; default: throw new Error(`Unexpected watchState ${this._watchState}`); } } // if showUserLocation and the watch state isn't off then update the marker location if (this.options.showUserLocation && this._watchState !== 'OFF') { this._updateMarker(position); } // if in normal mode (not watch mode), or if in watch mode and the state is active watch // then update the camera if (!this.options.trackUserLocation || this._watchState === 'ACTIVE_LOCK') { this._updateCamera(position); } if (this.options.showUserLocation) { this._dotElement.classList.remove('maplibregl-user-location-dot-stale'); } this.fire(new Event('geolocate', position)); this._finish(); }; /** * Update the camera location to center on the current position * * @param position - the Geolocation API Position */ this._updateCamera = (position) => { const center = new LngLat(position.coords.longitude, position.coords.latitude); const radius = position.coords.accuracy; const bearing = this._map.getBearing(); const options = extend({ bearing }, this.options.fitBoundsOptions); const newBounds = LngLatBounds.fromLngLat(center, radius); this._map.fitBounds(newBounds, options, { geolocateSource: true // tag this camera change so it won't cause the control to change to background state }); }; /** * Update the user location dot Marker to the current position * * @param position - the Geolocation API Position */ this._updateMarker = (position) => { if (position) { const center = new LngLat(position.coords.longitude, position.coords.latitude); this._accuracyCircleMarker.setLngLat(center).addTo(this._map); this._userLocationDotMarker.setLngLat(center).addTo(this._map); this._accuracy = position.coords.accuracy; if (this.options.showUserLocation && this.options.showAccuracyCircle) { this._updateCircleRadius(); } } else { this._userLocationDotMarker.remove(); this._accuracyCircleMarker.remove(); } }; this._onZoom = () => { if (this.options.showUserLocation && this.options.showAccuracyCircle) { this._updateCircleRadius(); } }; this._onError = (error) => { if (!this._map) { // control has since been removed return; } if (this.options.trackUserLocation) { if (error.code === 1) { // PERMISSION_DENIED this._watchState = 'OFF'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active-error'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background-error'); this._geolocateButton.disabled = true; const title = this._map._getUIString('GeolocateControl.LocationNotAvailable'); this._geolocateButton.title = title; this._geolocateButton.setAttribute('aria-label', title); if (this._geolocationWatchID !== undefined) { this._clearWatch(); } } else if (error.code === 3 && noTimeout) { // this represents a forced error state // this was triggered to force immediate geolocation when a watch is already present // see https://github.com/mapbox/mapbox-gl-js/issues/8214 // and https://w3c.github.io/geolocation-api/#example-5-forcing-the-user-agent-to-return-a-fresh-cached-position return; } else { this._setErrorState(); } } if (this._watchState !== 'OFF' && this.options.showUserLocation) { this._dotElement.classList.add('maplibregl-user-location-dot-stale'); } this.fire(new Event('error', error)); this._finish(); }; this._finish = () => { if (this._timeoutId) { clearTimeout(this._timeoutId); } this._timeoutId = undefined; }; this._setupUI = () => { // the control could have been removed before reaching here if (!this._map) { return; } this._container.addEventListener('contextmenu', (e) => e.preventDefault()); this._geolocateButton = DOM.create('button', 'maplibregl-ctrl-geolocate', this._container); DOM.create('span', 'maplibregl-ctrl-icon', this._geolocateButton).setAttribute('aria-hidden', 'true'); this._geolocateButton.type = 'button'; this._geolocateButton.disabled = true; }; this._finishSetupUI = (supported) => { // this method is called asynchronously during onAdd if (!this._map) { // control has since been removed return; } if (supported === false) { warnOnce('Geolocation support is not available so the GeolocateControl will be disabled.'); const title = this._map._getUIString('GeolocateControl.LocationNotAvailable'); this._geolocateButton.disabled = true; this._geolocateButton.title = title; this._geolocateButton.setAttribute('aria-label', title); } else { const title = this._map._getUIString('GeolocateControl.FindMyLocation'); this._geolocateButton.disabled = false; this._geolocateButton.title = title; this._geolocateButton.setAttribute('aria-label', title); } if (this.options.trackUserLocation) { this._geolocateButton.setAttribute('aria-pressed', 'false'); this._watchState = 'OFF'; } // when showUserLocation is enabled, keep the Geolocate button disabled until the device location marker is setup on the map if (this.options.showUserLocation) { this._dotElement = DOM.create('div', 'maplibregl-user-location-dot'); this._userLocationDotMarker = new Marker({ element: this._dotElement }); this._circleElement = DOM.create('div', 'maplibregl-user-location-accuracy-circle'); this._accuracyCircleMarker = new Marker({ element: this._circleElement, pitchAlignment: 'map' }); if (this.options.trackUserLocation) this._watchState = 'OFF'; this._map.on('zoom', this._onZoom); } this._geolocateButton.addEventListener('click', () => this.trigger()); this._setup = true; // when the camera is changed (and it's not as a result of the Geolocation Control) change // the watch mode to background watch, so that the marker is updated but not the camera. if (this.options.trackUserLocation) { this._map.on('movestart', (event) => { const fromResize = event.originalEvent && event.originalEvent.type === 'resize'; if (!event.geolocateSource && this._watchState === 'ACTIVE_LOCK' && !fromResize) { this._watchState = 'BACKGROUND'; this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-background'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active'); this.fire(new Event('trackuserlocationend')); this.fire(new Event('userlocationlostfocus')); } }); } }; this.options = extend({}, defaultOptions$2, options); } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; this._container = DOM.create('div', 'maplibregl-ctrl maplibregl-ctrl-group'); this._setupUI(); checkGeolocationSupport().then((supported) => this._finishSetupUI(supported)); return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { // clear the geolocation watch if exists if (this._geolocationWatchID !== undefined) { window.navigator.geolocation.clearWatch(this._geolocationWatchID); this._geolocationWatchID = undefined; } // clear the markers from the map if (this.options.showUserLocation && this._userLocationDotMarker) { this._userLocationDotMarker.remove(); } if (this.options.showAccuracyCircle && this._accuracyCircleMarker) { this._accuracyCircleMarker.remove(); } DOM.remove(this._container); this._map.off('zoom', this._onZoom); this._map = undefined; numberOfWatches = 0; noTimeout = false; } /** * Check if the Geolocation API Position is outside the map's `maxBounds`. * * @param position - the Geolocation API Position * @returns `true` if position is outside the map's `maxBounds`, otherwise returns `false`. */ _isOutOfMapMaxBounds(position) { const bounds = this._map.getMaxBounds(); const coordinates = position.coords; return bounds && (coordinates.longitude < bounds.getWest() || coordinates.longitude > bounds.getEast() || coordinates.latitude < bounds.getSouth() || coordinates.latitude > bounds.getNorth()); } _setErrorState() { switch (this._watchState) { case 'WAITING_ACTIVE': this._watchState = 'ACTIVE_ERROR'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-active-error'); break; case 'ACTIVE_LOCK': this._watchState = 'ACTIVE_ERROR'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-active-error'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-waiting'); // turn marker grey break; case 'BACKGROUND': this._watchState = 'BACKGROUND_ERROR'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-background-error'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-waiting'); // turn marker grey break; case 'ACTIVE_ERROR': break; default: throw new Error(`Unexpected watchState ${this._watchState}`); } } _updateCircleRadius() { const bounds = this._map.getBounds(); const southEastPoint = bounds.getSouthEast(); const northEastPoint = bounds.getNorthEast(); const mapHeightInMeters = southEastPoint.distanceTo(northEastPoint); const mapHeightInPixels = this._map._container.clientHeight; const circleDiameter = Math.ceil(2 * (this._accuracy / (mapHeightInMeters / mapHeightInPixels))); this._circleElement.style.width = `${circleDiameter}px`; this._circleElement.style.height = `${circleDiameter}px`; } /** * Programmatically request and move the map to the user's location. * * @returns `false` if called before control was added to a map, otherwise returns `true`. * @example * ```ts * // Initialize the geolocate control. * let geolocate = new GeolocateControl({ * positionOptions: { * enableHighAccuracy: true * }, * trackUserLocation: true * }); * // Add the control to the map. * map.addControl(geolocate); * map.on('load', () => { * geolocate.trigger(); * }); * ``` */ trigger() { if (!this._setup) { warnOnce('Geolocate control triggered before added to a map'); return false; } if (this.options.trackUserLocation) { // update watchState and do any outgoing state cleanup switch (this._watchState) { case 'OFF': // turn on the Geolocate Control this._watchState = 'WAITING_ACTIVE'; this.fire(new Event('trackuserlocationstart')); break; case 'WAITING_ACTIVE': case 'ACTIVE_LOCK': case 'ACTIVE_ERROR': case 'BACKGROUND_ERROR': // turn off the Geolocate Control numberOfWatches--; noTimeout = false; this._watchState = 'OFF'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-active-error'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background'); this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background-error'); this.fire(new Event('trackuserlocationend')); break; case 'BACKGROUND': this._watchState = 'ACTIVE_LOCK'; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-background'); // set camera to last known location if (this._lastKnownPosition) this._updateCamera(this._lastKnownPosition); this.fire(new Event('trackuserlocationstart')); this.fire(new Event('userlocationfocus')); break; default: throw new Error(`Unexpected watchState ${this._watchState}`); } // incoming state setup switch (this._watchState) { case 'WAITING_ACTIVE': this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-active'); break; case 'ACTIVE_LOCK': this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-active'); break; case 'OFF': break; default: throw new Error(`Unexpected watchState ${this._watchState}`); } // manage geolocation.watchPosition / geolocation.clearWatch if (this._watchState === 'OFF' && this._geolocationWatchID !== undefined) { // clear watchPosition as we've changed to an OFF state this._clearWatch(); } else if (this._geolocationWatchID === undefined) { // enable watchPosition since watchState is not OFF and there is no watchPosition already running this._geolocateButton.classList.add('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.setAttribute('aria-pressed', 'true'); numberOfWatches++; let positionOptions; if (numberOfWatches > 1) { positionOptions = { maximumAge: 600000, timeout: 0 }; noTimeout = true; } else { positionOptions = this.options.positionOptions; noTimeout = false; } this._geolocationWatchID = window.navigator.geolocation.watchPosition(this._onSuccess, this._onError, positionOptions); } } else { window.navigator.geolocation.getCurrentPosition(this._onSuccess, this._onError, this.options.positionOptions); // This timeout ensures that we still call finish() even if // the user declines to share their location in Firefox this._timeoutId = setTimeout(this._finish, 10000 /* 10sec */); } return true; } _clearWatch() { window.navigator.geolocation.clearWatch(this._geolocationWatchID); this._geolocationWatchID = undefined; this._geolocateButton.classList.remove('maplibregl-ctrl-geolocate-waiting'); this._geolocateButton.setAttribute('aria-pressed', 'false'); if (this.options.showUserLocation) { this._updateMarker(null); } } } const defaultOptions$1 = { maxWidth: 100, unit: 'metric' }; /** * A `ScaleControl` control displays the ratio of a distance on the map to the corresponding distance on the ground. * * @group Markers and Controls * * @example * ```ts * let scale = new ScaleControl({ * maxWidth: 80, * unit: 'imperial' * }); * map.addControl(scale); * * scale.setUnit('metric'); * ``` */ class ScaleControl { /** * @param options - the control's options */ constructor(options) { this._onMove = () => { updateScale(this._map, this._container, this.options); }; /** * Set the scale's unit of the distance * * @param unit - Unit of the distance (`'imperial'`, `'metric'` or `'nautical'`). */ this.setUnit = (unit) => { this.options.unit = unit; updateScale(this._map, this._container, this.options); }; this.options = Object.assign(Object.assign({}, defaultOptions$1), options); } getDefaultPosition() { return 'bottom-left'; } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; this._container = DOM.create('div', 'maplibregl-ctrl maplibregl-ctrl-scale', map.getContainer()); this._map.on('move', this._onMove); this._onMove(); return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._container); this._map.off('move', this._onMove); this._map = undefined; } } function updateScale(map, container, options) { // A horizontal scale is imagined to be present at center of the map // container with maximum length (Default) as 100px. // Using spherical law of cosines approximation, the real distance is // found between the two coordinates. const maxWidth = options && options.maxWidth || 100; const y = map._container.clientHeight / 2; const left = map.unproject([0, y]); const right = map.unproject([maxWidth, y]); const maxMeters = left.distanceTo(right); // The real distance corresponding to 100px scale length is rounded off to // near pretty number and the scale length for the same is found out. // Default unit of the scale is based on User's locale. if (options && options.unit === 'imperial') { const maxFeet = 3.2808 * maxMeters; if (maxFeet > 5280) { const maxMiles = maxFeet / 5280; setScale(container, maxWidth, maxMiles, map._getUIString('ScaleControl.Miles')); } else { setScale(container, maxWidth, maxFeet, map._getUIString('ScaleControl.Feet')); } } else if (options && options.unit === 'nautical') { const maxNauticals = maxMeters / 1852; setScale(container, maxWidth, maxNauticals, map._getUIString('ScaleControl.NauticalMiles')); } else if (maxMeters >= 1000) { setScale(container, maxWidth, maxMeters / 1000, map._getUIString('ScaleControl.Kilometers')); } else { setScale(container, maxWidth, maxMeters, map._getUIString('ScaleControl.Meters')); } } function setScale(container, maxWidth, maxDistance, unit) { const distance = getRoundNum(maxDistance); const ratio = distance / maxDistance; container.style.width = `${maxWidth * ratio}px`; container.innerHTML = `${distance} ${unit}`; } function getDecimalRoundNum(d) { const multiplier = Math.pow(10, Math.ceil(-Math.log(d) / Math.LN10)); return Math.round(d * multiplier) / multiplier; } function getRoundNum(num) { const pow10 = Math.pow(10, (`${Math.floor(num)}`).length - 1); let d = num / pow10; d = d >= 10 ? 10 : d >= 5 ? 5 : d >= 3 ? 3 : d >= 2 ? 2 : d >= 1 ? 1 : getDecimalRoundNum(d); return pow10 * d; } /** * A `FullscreenControl` control contains a button for toggling the map in and out of fullscreen mode. * When [requestFullscreen](https://developer.mozilla.org/en-US/docs/Web/API/Element/requestFullscreen) is not supported, fullscreen is handled via CSS properties. * The map's `cooperativeGestures` option is temporarily disabled while the map * is in fullscreen mode, and is restored when the map exist fullscreen mode. * * @group Markers and Controls * @param options - the full screen control options * * @example * ```ts * map.addControl(new FullscreenControl({container: document.querySelector('body')})); * ``` * @see [View a fullscreen map](https://maplibre.org/maplibre-gl-js/docs/examples/fullscreen/) * * ## Events * * **Event** `fullscreenstart` of type {@link Event} will be fired when fullscreen mode has started. * * **Event** `fullscreenend` of type {@link Event} will be fired when fullscreen mode has ended. */ class FullscreenControl extends Evented { /** * @param options - the control's options */ constructor(options = {}) { super(); this._onFullscreenChange = () => { var _a; let fullscreenElement = window.document.fullscreenElement || window.document.mozFullScreenElement || window.document.webkitFullscreenElement || window.document.msFullscreenElement; while ((_a = fullscreenElement === null || fullscreenElement === void 0 ? void 0 : fullscreenElement.shadowRoot) === null || _a === void 0 ? void 0 : _a.fullscreenElement) { fullscreenElement = fullscreenElement.shadowRoot.fullscreenElement; } if ((fullscreenElement === this._container) !== this._fullscreen) { this._handleFullscreenChange(); } }; this._onClickFullscreen = () => { if (this._isFullscreen()) { this._exitFullscreen(); } else { this._requestFullscreen(); } }; this._fullscreen = false; if (options && options.container) { if (options.container instanceof HTMLElement) { this._container = options.container; } else { warnOnce('Full screen control \'container\' must be a DOM element.'); } } if ('onfullscreenchange' in document) { this._fullscreenchange = 'fullscreenchange'; } else if ('onmozfullscreenchange' in document) { this._fullscreenchange = 'mozfullscreenchange'; } else if ('onwebkitfullscreenchange' in document) { this._fullscreenchange = 'webkitfullscreenchange'; } else if ('onmsfullscreenchange' in document) { this._fullscreenchange = 'MSFullscreenChange'; } } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; if (!this._container) this._container = this._map.getContainer(); this._controlContainer = DOM.create('div', 'maplibregl-ctrl maplibregl-ctrl-group'); this._setupUI(); return this._controlContainer; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._controlContainer); this._map = null; window.document.removeEventListener(this._fullscreenchange, this._onFullscreenChange); } _setupUI() { const button = this._fullscreenButton = DOM.create('button', (('maplibregl-ctrl-fullscreen')), this._controlContainer); DOM.create('span', 'maplibregl-ctrl-icon', button).setAttribute('aria-hidden', 'true'); button.type = 'button'; this._updateTitle(); this._fullscreenButton.addEventListener('click', this._onClickFullscreen); window.document.addEventListener(this._fullscreenchange, this._onFullscreenChange); } _updateTitle() { const title = this._getTitle(); this._fullscreenButton.setAttribute('aria-label', title); this._fullscreenButton.title = title; } _getTitle() { return this._map._getUIString(this._isFullscreen() ? 'FullscreenControl.Exit' : 'FullscreenControl.Enter'); } _isFullscreen() { return this._fullscreen; } _handleFullscreenChange() { this._fullscreen = !this._fullscreen; this._fullscreenButton.classList.toggle('maplibregl-ctrl-shrink'); this._fullscreenButton.classList.toggle('maplibregl-ctrl-fullscreen'); this._updateTitle(); if (this._fullscreen) { this.fire(new Event('fullscreenstart')); this._prevCooperativeGesturesEnabled = this._map.cooperativeGestures.isEnabled(); this._map.cooperativeGestures.disable(); } else { this.fire(new Event('fullscreenend')); if (this._prevCooperativeGesturesEnabled) { this._map.cooperativeGestures.enable(); } } } _exitFullscreen() { if (window.document.exitFullscreen) { window.document.exitFullscreen(); } else if (window.document.mozCancelFullScreen) { window.document.mozCancelFullScreen(); } else if (window.document.msExitFullscreen) { window.document.msExitFullscreen(); } else if (window.document.webkitCancelFullScreen) { window.document.webkitCancelFullScreen(); } else { this._togglePseudoFullScreen(); } } _requestFullscreen() { if (this._container.requestFullscreen) { this._container.requestFullscreen(); } else if (this._container.mozRequestFullScreen) { this._container.mozRequestFullScreen(); } else if (this._container.msRequestFullscreen) { this._container.msRequestFullscreen(); } else if (this._container.webkitRequestFullscreen) { this._container.webkitRequestFullscreen(); } else { this._togglePseudoFullScreen(); } } _togglePseudoFullScreen() { this._container.classList.toggle('maplibregl-pseudo-fullscreen'); this._handleFullscreenChange(); this._map.resize(); } } /** * A `TerrainControl` control contains a button for turning the terrain on and off. * * @group Markers and Controls * * @example * ```ts * let map = new Map({TerrainControl: false}) * .addControl(new TerrainControl({ * source: "terrain" * })); * ``` */ class TerrainControl { /** * @param options - the control's options */ constructor(options) { this._toggleTerrain = () => { if (this._map.getTerrain()) { this._map.setTerrain(null); } else { this._map.setTerrain(this.options); } this._updateTerrainIcon(); }; this._updateTerrainIcon = () => { this._terrainButton.classList.remove('maplibregl-ctrl-terrain'); this._terrainButton.classList.remove('maplibregl-ctrl-terrain-enabled'); if (this._map.terrain) { this._terrainButton.classList.add('maplibregl-ctrl-terrain-enabled'); this._terrainButton.title = this._map._getUIString('TerrainControl.Disable'); } else { this._terrainButton.classList.add('maplibregl-ctrl-terrain'); this._terrainButton.title = this._map._getUIString('TerrainControl.Enable'); } }; this.options = options; } /** {@inheritDoc IControl.onAdd} */ onAdd(map) { this._map = map; this._container = DOM.create('div', 'maplibregl-ctrl maplibregl-ctrl-group'); this._terrainButton = DOM.create('button', 'maplibregl-ctrl-terrain', this._container); DOM.create('span', 'maplibregl-ctrl-icon', this._terrainButton).setAttribute('aria-hidden', 'true'); this._terrainButton.type = 'button'; this._terrainButton.addEventListener('click', this._toggleTerrain); this._updateTerrainIcon(); this._map.on('terrain', this._updateTerrainIcon); return this._container; } /** {@inheritDoc IControl.onRemove} */ onRemove() { DOM.remove(this._container); this._map.off('terrain', this._updateTerrainIcon); this._map = undefined; } } const defaultOptions = { closeButton: true, closeOnClick: true, focusAfterOpen: true, className: '', maxWidth: '240px', subpixelPositioning: false }; const focusQuerySelector = [ 'a[href]', '[tabindex]:not([tabindex=\'-1\'])', '[contenteditable]:not([contenteditable=\'false\'])', 'button:not([disabled])', 'input:not([disabled])', 'select:not([disabled])', 'textarea:not([disabled])', ].join(', '); /** * A popup component. * * @group Markers and Controls * * * @example * Create a popup * ```ts * let popup = new Popup(); * // Set an event listener that will fire * // any time the popup is opened * popup.on('open', () => { * console.log('popup was opened'); * }); * ``` * * @example * Create a popup * ```ts * let popup = new Popup(); * // Set an event listener that will fire * // any time the popup is closed * popup.on('close', () => { * console.log('popup was closed'); * }); * ``` * * @example * ```ts * let markerHeight = 50, markerRadius = 10, linearOffset = 25; * let popupOffsets = { * 'top': [0, 0], * 'top-left': [0,0], * 'top-right': [0,0], * 'bottom': [0, -markerHeight], * 'bottom-left': [linearOffset, (markerHeight - markerRadius + linearOffset) * -1], * 'bottom-right': [-linearOffset, (markerHeight - markerRadius + linearOffset) * -1], * 'left': [markerRadius, (markerHeight - markerRadius) * -1], * 'right': [-markerRadius, (markerHeight - markerRadius) * -1] * }; * let popup = new Popup({offset: popupOffsets, className: 'my-class'}) * .setLngLat(e.lngLat) * .setHTML("

Hello World!

") * .setMaxWidth("300px") * .addTo(map); * ``` * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/) * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-hover/) * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-click/) * @see [Attach a popup to a marker instance](https://maplibre.org/maplibre-gl-js/docs/examples/set-popup/) * * ## Events * * **Event** `open` of type {@link Event} will be fired when the popup is opened manually or programmatically. * * **Event** `close` of type {@link Event} will be fired when the popup is closed manually or programmatically. */ class Popup extends Evented { /** * @param options - the options */ constructor(options) { super(); /** * Removes the popup from the map it has been added to. * * @example * ```ts * let popup = new Popup().addTo(map); * popup.remove(); * ``` */ this.remove = () => { if (this._content) { DOM.remove(this._content); } if (this._container) { DOM.remove(this._container); delete this._container; } if (this._map) { this._map.off('move', this._update); this._map.off('move', this._onClose); this._map.off('click', this._onClose); this._map.off('remove', this.remove); this._map.off('mousemove', this._onMouseMove); this._map.off('mouseup', this._onMouseUp); this._map.off('drag', this._onDrag); this._map._canvasContainer.classList.remove('maplibregl-track-pointer'); delete this._map; this.fire(new Event('close')); } return this; }; this._onMouseUp = (event) => { this._update(event.point); }; this._onMouseMove = (event) => { this._update(event.point); }; this._onDrag = (event) => { this._update(event.point); }; this._update = (cursor) => { var _a; const hasPosition = this._lngLat || this._trackPointer; if (!this._map || !hasPosition || !this._content) { return; } if (!this._container) { this._container = DOM.create('div', 'maplibregl-popup', this._map.getContainer()); this._tip = DOM.create('div', 'maplibregl-popup-tip', this._container); this._container.appendChild(this._content); if (this.options.className) { for (const name of this.options.className.split(' ')) { this._container.classList.add(name); } } if (this._closeButton) { this._closeButton.setAttribute('aria-label', this._map._getUIString('Popup.Close')); } if (this._trackPointer) { this._container.classList.add('maplibregl-popup-track-pointer'); } } if (this.options.maxWidth && this._container.style.maxWidth !== this.options.maxWidth) { this._container.style.maxWidth = this.options.maxWidth; } if (this._map.transform.renderWorldCopies && !this._trackPointer) { this._lngLat = smartWrap(this._lngLat, this._flatPos, this._map.transform); } else { this._lngLat = (_a = this._lngLat) === null || _a === void 0 ? void 0 : _a.wrap(); } if (this._trackPointer && !cursor) return; const pos = this._flatPos = this._pos = this._trackPointer && cursor ? cursor : this._map.project(this._lngLat); if (this._map.terrain) { // flat position is saved because smartWrap needs non-elevated points this._flatPos = this._trackPointer && cursor ? cursor : this._map.transform.locationPoint(this._lngLat); } let anchor = this.options.anchor; const offset = normalizeOffset(this.options.offset); if (!anchor) { const width = this._container.offsetWidth; const height = this._container.offsetHeight; let anchorComponents; if (pos.y + offset.bottom.y < height) { anchorComponents = ['top']; } else if (pos.y > this._map.transform.height - height) { anchorComponents = ['bottom']; } else { anchorComponents = []; } if (pos.x < width / 2) { anchorComponents.push('left'); } else if (pos.x > this._map.transform.width - width / 2) { anchorComponents.push('right'); } if (anchorComponents.length === 0) { anchor = 'bottom'; } else { anchor = anchorComponents.join('-'); } } let offsetedPos = pos.add(offset[anchor]); if (!this.options.subpixelPositioning) { offsetedPos = offsetedPos.round(); } DOM.setTransform(this._container, `${anchorTranslate[anchor]} translate(${offsetedPos.x}px,${offsetedPos.y}px)`); applyAnchorClass(this._container, anchor, 'popup'); }; this._onClose = () => { this.remove(); }; this.options = extend(Object.create(defaultOptions), options); } /** * Adds the popup to a map. * * @param map - The MapLibre GL JS map to add the popup to. * @example * ```ts * new Popup() * .setLngLat([0, 0]) * .setHTML("

Null Island

") * .addTo(map); * ``` * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/) * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-hover/) * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-click/) * @see [Show polygon information on click](https://maplibre.org/maplibre-gl-js/docs/examples/polygon-popup-on-click/) */ addTo(map) { if (this._map) this.remove(); this._map = map; if (this.options.closeOnClick) { this._map.on('click', this._onClose); } if (this.options.closeOnMove) { this._map.on('move', this._onClose); } this._map.on('remove', this.remove); this._update(); this._focusFirstElement(); if (this._trackPointer) { this._map.on('mousemove', this._onMouseMove); this._map.on('mouseup', this._onMouseUp); if (this._container) { this._container.classList.add('maplibregl-popup-track-pointer'); } this._map._canvasContainer.classList.add('maplibregl-track-pointer'); } else { this._map.on('move', this._update); } this.fire(new Event('open')); return this; } /** * @returns `true` if the popup is open, `false` if it is closed. */ isOpen() { return !!this._map; } /** * Returns the geographical location of the popup's anchor. * * The longitude of the result may differ by a multiple of 360 degrees from the longitude previously * set by `setLngLat` because `Popup` wraps the anchor longitude across copies of the world to keep * the popup on screen. * * @returns The geographical location of the popup's anchor. */ getLngLat() { return this._lngLat; } /** * Sets the geographical location of the popup's anchor, and moves the popup to it. Replaces trackPointer() behavior. * * @param lnglat - The geographical location to set as the popup's anchor. */ setLngLat(lnglat) { this._lngLat = LngLat.convert(lnglat); this._pos = null; this._flatPos = null; this._trackPointer = false; this._update(); if (this._map) { this._map.on('move', this._update); this._map.off('mousemove', this._onMouseMove); if (this._container) { this._container.classList.remove('maplibregl-popup-track-pointer'); } this._map._canvasContainer.classList.remove('maplibregl-track-pointer'); } return this; } /** * Tracks the popup anchor to the cursor position on screens with a pointer device (it will be hidden on touchscreens). Replaces the `setLngLat` behavior. * For most use cases, set `closeOnClick` and `closeButton` to `false`. * @example * ```ts * let popup = new Popup({ closeOnClick: false, closeButton: false }) * .setHTML("

Hello World!

") * .trackPointer() * .addTo(map); * ``` */ trackPointer() { this._trackPointer = true; this._pos = null; this._flatPos = null; this._update(); if (this._map) { this._map.off('move', this._update); this._map.on('mousemove', this._onMouseMove); this._map.on('drag', this._onDrag); if (this._container) { this._container.classList.add('maplibregl-popup-track-pointer'); } this._map._canvasContainer.classList.add('maplibregl-track-pointer'); } return this; } /** * Returns the `Popup`'s HTML element. * @example * Change the `Popup` element's font size * ```ts * let popup = new Popup() * .setLngLat([-96, 37.8]) * .setHTML("

Hello World!

") * .addTo(map); * let popupElem = popup.getElement(); * popupElem.style.fontSize = "25px"; * ``` * @returns element */ getElement() { return this._container; } /** * Sets the popup's content to a string of text. * * This function creates a [Text](https://developer.mozilla.org/en-US/docs/Web/API/Text) node in the DOM, * so it cannot insert raw HTML. Use this method for security against XSS * if the popup content is user-provided. * * @param text - Textual content for the popup. * @example * ```ts * let popup = new Popup() * .setLngLat(e.lngLat) * .setText('Hello, world!') * .addTo(map); * ``` */ setText(text) { return this.setDOMContent(document.createTextNode(text)); } /** * Sets the popup's content to the HTML provided as a string. * * This method does not perform HTML filtering or sanitization, and must be * used only with trusted content. Consider {@link Popup#setText} if * the content is an untrusted text string. * * @param html - A string representing HTML content for the popup. * @example * ```ts * let popup = new Popup() * .setLngLat(e.lngLat) * .setHTML("

Hello World!

") * .addTo(map); * ``` * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/) * @see [Display a popup on hover](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-hover/) * @see [Display a popup on click](https://maplibre.org/maplibre-gl-js/docs/examples/popup-on-click/) * @see [Attach a popup to a marker instance](https://maplibre.org/maplibre-gl-js/docs/examples/set-popup/) */ setHTML(html) { const frag = document.createDocumentFragment(); const temp = document.createElement('body'); let child; temp.innerHTML = html; while (true) { child = temp.firstChild; if (!child) break; frag.appendChild(child); } return this.setDOMContent(frag); } /** * Returns the popup's maximum width. * * @returns The maximum width of the popup. */ getMaxWidth() { var _a; return (_a = this._container) === null || _a === void 0 ? void 0 : _a.style.maxWidth; } /** * Sets the popup's maximum width. This is setting the CSS property `max-width`. * Available values can be found here: https://developer.mozilla.org/en-US/docs/Web/CSS/max-width * * @param maxWidth - A string representing the value for the maximum width. */ setMaxWidth(maxWidth) { this.options.maxWidth = maxWidth; this._update(); return this; } /** * Sets the popup's content to the element provided as a DOM node. * * @param htmlNode - A DOM node to be used as content for the popup. * @example * Create an element with the popup content * ```ts * let div = document.createElement('div'); * div.innerHTML = 'Hello, world!'; * let popup = new Popup() * .setLngLat(e.lngLat) * .setDOMContent(div) * .addTo(map); * ``` */ setDOMContent(htmlNode) { if (this._content) { // Clear out children first. while (this._content.hasChildNodes()) { if (this._content.firstChild) { this._content.removeChild(this._content.firstChild); } } } else { this._content = DOM.create('div', 'maplibregl-popup-content', this._container); } // The close button should be the last tabbable element inside the popup for a good keyboard UX. this._content.appendChild(htmlNode); this._createCloseButton(); this._update(); this._focusFirstElement(); return this; } /** * Adds a CSS class to the popup container element. * * @param className - Non-empty string with CSS class name to add to popup container * * @example * ```ts * let popup = new Popup() * popup.addClassName('some-class') * ``` */ addClassName(className) { if (this._container) { this._container.classList.add(className); } return this; } /** * Removes a CSS class from the popup container element. * * @param className - Non-empty string with CSS class name to remove from popup container * * @example * ```ts * let popup = new Popup() * popup.removeClassName('some-class') * ``` */ removeClassName(className) { if (this._container) { this._container.classList.remove(className); } return this; } /** * Sets the popup's offset. * * @param offset - Sets the popup's offset. */ setOffset(offset) { this.options.offset = offset; this._update(); return this; } /** * Add or remove the given CSS class on the popup container, depending on whether the container currently has that class. * * @param className - Non-empty string with CSS class name to add/remove * * @returns if the class was removed return false, if class was added, then return true, undefined if there is no container * * @example * ```ts * let popup = new Popup() * popup.toggleClassName('toggleClass') * ``` */ toggleClassName(className) { if (this._container) { return this._container.classList.toggle(className); } } /** * Set the option to allow subpixel positioning of the popup by passing a boolean * * @param value - When boolean is true, subpixel positioning is enabled for the popup. * * @example * ```ts * let popup = new Popup() * popup.setSubpixelPositioning(true); * ``` */ setSubpixelPositioning(value) { this.options.subpixelPositioning = value; } _createCloseButton() { if (this.options.closeButton) { this._closeButton = DOM.create('button', 'maplibregl-popup-close-button', this._content); this._closeButton.type = 'button'; this._closeButton.innerHTML = '×'; this._closeButton.addEventListener('click', this._onClose); } } _focusFirstElement() { if (!this.options.focusAfterOpen || !this._container) return; const firstFocusable = this._container.querySelector(focusQuerySelector); if (firstFocusable) firstFocusable.focus(); } } function normalizeOffset(offset) { if (!offset) { return normalizeOffset(new Point$2(0, 0)); } else if (typeof offset === 'number') { // input specifies a radius from which to calculate offsets at all positions const cornerOffset = Math.round(Math.abs(offset) / Math.SQRT2); return { 'center': new Point$2(0, 0), 'top': new Point$2(0, offset), 'top-left': new Point$2(cornerOffset, cornerOffset), 'top-right': new Point$2(-cornerOffset, cornerOffset), 'bottom': new Point$2(0, -offset), 'bottom-left': new Point$2(cornerOffset, -cornerOffset), 'bottom-right': new Point$2(-cornerOffset, -cornerOffset), 'left': new Point$2(offset, 0), 'right': new Point$2(-offset, 0) }; } else if (offset instanceof Point$2 || Array.isArray(offset)) { // input specifies a single offset to be applied to all positions const convertedOffset = Point$2.convert(offset); return { 'center': convertedOffset, 'top': convertedOffset, 'top-left': convertedOffset, 'top-right': convertedOffset, 'bottom': convertedOffset, 'bottom-left': convertedOffset, 'bottom-right': convertedOffset, 'left': convertedOffset, 'right': convertedOffset }; } else { // input specifies an offset per position return { 'center': Point$2.convert(offset['center'] || [0, 0]), 'top': Point$2.convert(offset['top'] || [0, 0]), 'top-left': Point$2.convert(offset['top-left'] || [0, 0]), 'top-right': Point$2.convert(offset['top-right'] || [0, 0]), 'bottom': Point$2.convert(offset['bottom'] || [0, 0]), 'bottom-left': Point$2.convert(offset['bottom-left'] || [0, 0]), 'bottom-right': Point$2.convert(offset['bottom-right'] || [0, 0]), 'left': Point$2.convert(offset['left'] || [0, 0]), 'right': Point$2.convert(offset['right'] || [0, 0]) }; } } const version = packageJSON.version; /** * Sets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text). * Necessary for supporting the Arabic and Hebrew languages, which are written right-to-left. * * @param pluginURL - URL pointing to the Mapbox RTL text plugin source. * @param lazy - If set to `true`, maplibre will defer loading the plugin until rtl text is encountered, * rtl text will then be rendered only after the plugin finishes loading. * @example * ```ts * setRTLTextPlugin('https://unpkg.com/@mapbox/mapbox-gl-rtl-text@0.2.3/mapbox-gl-rtl-text.js', false); * ``` * @see [Add support for right-to-left scripts](https://maplibre.org/maplibre-gl-js/docs/examples/mapbox-gl-rtl-text/) */ function setRTLTextPlugin(pluginURL, lazy) { return rtlMainThreadPluginFactory().setRTLTextPlugin(pluginURL, lazy); } /** * Gets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text) status. * The status can be `unavailable` (i.e. not requested or removed), `loading`, `loaded` or `error`. * If the status is `loaded` and the plugin is requested again, an error will be thrown. * * @example * ```ts * const pluginStatus = getRTLTextPluginStatus(); * ``` */ function getRTLTextPluginStatus() { return rtlMainThreadPluginFactory().getRTLTextPluginStatus(); } /** * Returns the package version of the library * @returns Package version of the library */ function getVersion() { return version; } /** * Gets the number of web workers instantiated on a page with GL JS maps. * By default, workerCount is 1 except for Safari browser where it is set to half the number of CPU cores (capped at 3). * Make sure to set this property before creating any map instances for it to have effect. * * @returns Number of workers currently configured. * @example * ```ts * const workerCount = getWorkerCount() * ``` */ function getWorkerCount() { return WorkerPool.workerCount; } /** * Sets the number of web workers instantiated on a page with GL JS maps. * By default, workerCount is 1 except for Safari browser where it is set to half the number of CPU cores (capped at 3). * Make sure to set this property before creating any map instances for it to have effect. * * @example * ```ts * setWorkerCount(2); * ``` */ function setWorkerCount(count) { WorkerPool.workerCount = count; } /** * Gets and sets the maximum number of images (raster tiles, sprites, icons) to load in parallel, * which affects performance in raster-heavy maps. 16 by default. * * @returns Number of parallel requests currently configured. * @example * ```ts * getMaxParallelImageRequests(); * ``` */ function getMaxParallelImageRequests() { return config.MAX_PARALLEL_IMAGE_REQUESTS; } /** * Sets the maximum number of images (raster tiles, sprites, icons) to load in parallel, * which affects performance in raster-heavy maps. 16 by default. * * @example * ```ts * setMaxParallelImageRequests(10); * ``` */ function setMaxParallelImageRequests(numRequests) { config.MAX_PARALLEL_IMAGE_REQUESTS = numRequests; } /** * Gets the worker url * @returns The worker url */ function getWorkerUrl() { return config.WORKER_URL; } /** * Sets the worker url */ function setWorkerUrl(value) { config.WORKER_URL = value; } /** * Allows loading javascript code in the worker thread. * *Note* that since this is using some very internal classes and flows it is considered experimental and can break at any point. * * It can be useful for the following examples: * 1. Using `self.addProtocol` in the worker thread - note that you might need to also register the protocol on the main thread. * 2. Using `self.registerWorkerSource(workerSource: WorkerSource)` to register a worker source, which should come with `addSourceType` usually. * 3. using `self.actor.registerMessageHandler` to override some internal worker operations * @param workerUrl - the worker url e.g. a url of a javascript file to load in the worker * @returns * * @example * ```ts * // below is an example of sending a js file to the worker to load the method there * // Note that you'll need to call the global function `addProtocol` in the worker to register the protocol there. * // add-protocol-worker.js * async function loadFn(params, abortController) { * const t = await fetch(`https://${params.url.split("://")[1]}`); * if (t.status == 200) { * const buffer = await t.arrayBuffer(); * return {data: buffer} * } else { * throw new Error(`Tile fetch error: ${t.statusText}`); * } * } * self.addProtocol('custom', loadFn); * * // main.js * importScriptInWorkers('add-protocol-worker.js'); * ``` */ function importScriptInWorkers(workerUrl) { return getGlobalDispatcher().broadcast("IS" /* MessageType.importScript */, workerUrl); } exports.AJAXError = AJAXError; exports.AttributionControl = AttributionControl; exports.BoxZoomHandler = BoxZoomHandler; exports.CanvasSource = CanvasSource; exports.CooperativeGesturesHandler = CooperativeGesturesHandler; exports.DoubleClickZoomHandler = DoubleClickZoomHandler; exports.DragPanHandler = DragPanHandler; exports.DragRotateHandler = DragRotateHandler; exports.EdgeInsets = EdgeInsets; exports.Evented = Evented; exports.FullscreenControl = FullscreenControl; exports.GeoJSONSource = GeoJSONSource; exports.GeolocateControl = GeolocateControl; exports.Hash = Hash; exports.ImageSource = ImageSource; exports.KeyboardHandler = KeyboardHandler; exports.LngLat = LngLat; exports.LngLatBounds = LngLatBounds; exports.LogoControl = LogoControl; exports.Map = Map$1; exports.MapMouseEvent = MapMouseEvent; exports.MapTouchEvent = MapTouchEvent; exports.MapWheelEvent = MapWheelEvent; exports.Marker = Marker; exports.MercatorCoordinate = MercatorCoordinate; exports.NavigationControl = NavigationControl; exports.Point = Point$2; exports.Popup = Popup; exports.RasterDEMTileSource = RasterDEMTileSource; exports.RasterTileSource = RasterTileSource; exports.ScaleControl = ScaleControl; exports.ScrollZoomHandler = ScrollZoomHandler; exports.Style = Style; exports.TerrainControl = TerrainControl; exports.TwoFingersTouchPitchHandler = TwoFingersTouchPitchHandler; exports.TwoFingersTouchRotateHandler = TwoFingersTouchRotateHandler; exports.TwoFingersTouchZoomHandler = TwoFingersTouchZoomHandler; exports.TwoFingersTouchZoomRotateHandler = TwoFingersTouchZoomRotateHandler; exports.VectorTileSource = VectorTileSource; exports.VideoSource = VideoSource; exports.addProtocol = addProtocol; exports.addSourceType = addSourceType; exports.clearPrewarmedResources = clearPrewarmedResources; exports.config = config; exports.getMaxParallelImageRequests = getMaxParallelImageRequests; exports.getRTLTextPluginStatus = getRTLTextPluginStatus; exports.getVersion = getVersion; exports.getWorkerCount = getWorkerCount; exports.getWorkerUrl = getWorkerUrl; exports.importScriptInWorkers = importScriptInWorkers; exports.prewarm = prewarm; exports.removeProtocol = removeProtocol; exports.setMaxParallelImageRequests = setMaxParallelImageRequests; exports.setRTLTextPlugin = setRTLTextPlugin; exports.setWorkerCount = setWorkerCount; exports.setWorkerUrl = setWorkerUrl; })); //# sourceMappingURL=maplibre-gl-csp-dev.js.map