itowns 2.44.3-next.8 → 2.45.0

package/lib/Source/Potree2Source.js

@@ -1,167 +0,0 @@
-import Source from "./Source.js";
-import Fetcher from "../Provider/Fetcher.js";
-import Potree2BinParser from "../Parser/Potree2BinParser.js";
-
-/**
- * Potree2Source are object containing informations on how to fetch potree 2.0 points cloud resources.
- */
-
-class Potree2Source extends Source {
-  /**
-   * @param {Object} source - An object that can contain all properties of a
-   * Potree2Source
-   * @param {string} source.url - folder url.
-   * @param {string} source.file - metadata file name.
-   *
-   * This `metadata` file stores information about the potree cloud 2.0 in JSON format. the structure is :
-   *
-   * * __`version`__ - The metadata.json format may change over time. The version number is
-   * necessary so that parsers know how to interpret the data.
-   * * __`name`__ - Point cloud name.
-   * * __`description`__ - Point cloud description.
-   * * __`points`__ - Total number of points.
-   * * __`projection`__ - Point cloud geographic projection system.
-   * * __`hierarchy`__ - Information about point cloud hierarchy (first chunk size, step size, octree depth).
-   * * __`offset`__ - Position offset used to determine the global point position.
-   * * __`scale`__ - Point cloud scale.
-   * * __`spacing`__ - The minimum distance between points at root level.
-   * * __`boundingBox`__ - Contains the minimum and maximum of the axis aligned bounding box. This bounding box is cubic and aligned to fit to the octree root.
-   * * __`encoding`__ - Encoding type: BROTLI or DEFAULT (uncompressed).
-   * * __`attributes`__ - Array of attributes (position,  intensity, return number, number of returns, classification, scan angle rank, user data, point source id, gps-time, rgb).
-   * ```
-   * {
-   *     version: '2.0',
-   *     name: "sample",
-   *     description: "",
-   *     points: 534909153,
-   *     projection: "",
-   *     hierarchy: {
-   *         firstChunkSize: 1276,
-   *         stepSize: 4,
-   *         depth: 16
-   *     },
-   *     offset: [1339072.07, 7238866.339, 85.281],
-   *     scale: [0.001, 0.001, 0.002],
-   *     spacing: 24.476062500005355,
-   *     boundingBox: {
-   *         min: [1339072.07, 7238866.339, 85.281],
-   *         max: [1342205.0060000008, 7241999.275, 3218.2170000006854]
-   *     },
-   *     encoding: "BROTLI",
-   *     attributes: [
-   *          {
-   *              name: "position",
-   *              description: "",
-   *              size: 12,
-   *              numElements: 3,
-   *              elementSize: 4,
-   *              type: "int32",
-   *              min: [-0.74821299314498901, -2.7804059982299805, 2.5478212833404541],
-   *              max: [2.4514148223438199, 1.4893437627414672, 7.1957106576508663]
-   *          },
-   *          {
-   *              name: "intensity",
-   *              description: "",
-   *              size: 2,
-   *              numElements: 1,
-   *              elementSize: 2,
-   *              type: "uint16",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "return number",
-   *              description: "",
-   *              size: 1,
-   *              numElements: 1,
-   *              elementSize: 1,
-   *              type: "uint8",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "number of returns",
-   *              description: "",
-   *              size: 1,
-   *              numElements: 1,
-   *              elementSize: 1,
-   *              type: "uint8",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "classification",
-   *              description: "",
-   *              size: 1,
-   *              numElements: 1,
-   *              elementSize: 1,
-   *              type: "uint8",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "scan angle rank",
-   *              description: "",
-   *              size: 1,
-   *              numElements: 1,
-   *              elementSize: 1,
-   *              type: "uint8",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "user data",
-   *              description: "",
-   *              size: 1,
-   *              numElements: 1,
-   *              elementSize: 1,
-   *              type: "uint8",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "point source id",
-   *              description: "",
-   *              size: 2,
-   *              numElements: 1,
-   *              elementSize: 2,
-   *              type: "uint16",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "gps-time",
-   *              description: "",
-   *              size: 8,
-   *              numElements: 1,
-   *              elementSize: 8,
-   *              type: "double",
-   *              min: [0],
-   *              max: [0]
-   *          },{
-   *              name: "rgb",
-   *              description: "",
-   *              size: 6,
-   *              numElements: 3,
-   *              elementSize: 2,
-   *              type: "uint16",
-   *              min: [5632, 5376, 4864],
-   *              max: [65280, 65280, 65280]
-   *          }
-   *     ]
-   * }
-   * ```
-   *
-   * @extends Source
-   */
-  constructor(source) {
-    if (!source.file) {
-      throw new Error('New Potree2Source: file is required');
-    }
-    super(source);
-    this.file = source.file;
-    this.fetcher = Fetcher.arrayBuffer;
-    this.whenReady = (source.metadata ? Promise.resolve(source.metadata) : Fetcher.json(`${this.url}/${this.file}`, this.networkOptions)).then(metadata => {
-      this.metadata = metadata;
-      this.pointAttributes = metadata.attributes;
-      this.baseurl = `${this.url}`;
-      this.extension = 'bin';
-      this.parser = Potree2BinParser.parse;
-      return metadata;
-    });
-  }
-}
-export default Potree2Source;

package/lib/Source/PotreeSource.js

@@ -1,82 +0,0 @@
-import Source from "./Source.js";
-import Fetcher from "../Provider/Fetcher.js";
-import PotreeBinParser from "../Parser/PotreeBinParser.js";
-import PotreeCinParser from "../Parser/PotreeCinParser.js";
-
-/**
- * PotreeSource are object containing informations on how to fetch points cloud resources.
- */
-
-class PotreeSource extends Source {
-  /**
-   * @param {Object} source - An object that can contain all properties of a
-   * PotreeSource
-   * @param {string} source.url - folder url.
-   * @param {string} source.file - cloud file name.
-   *
-   * This `cloud` file stores information about the potree cloud in JSON format. the structure is :
-   *
-   * * __`version`__ - The cloud.js format may change over time. The version number is
-   * necessary so that parsers know how to interpret the data.
-   * * __`octreeDir`__ - Directory or URL where node data is stored. Usually points to
-   * "data".
-   * * __`boundingBox`__ - Contains the minimum and maximum of the axis aligned bounding box. This bounding box is cubic and aligned to fit to the octree root.
-   * * __`tightBoundingBox`__ - This bounding box thightly fits the point data.
-   * * __`pointAttributes`__ - Declares the point data format. May be 'LAS', 'LAZ' or in case if the BINARY format an array of attributes like
-   * `['POSITION_CARTESIAN', 'COLOR_PACKED', 'INTENSITY']`
-   * * __`POSITION_CARTESIAN`__ - 3 x 32bit signed integers for x/y/z coordinates
-   * * __`COLOR_PACKED`__ - 4 x unsigned byte for r,g,b,a colors.
-   * * __`spacing`__ - The minimum distance between points at root level.
-   * ```
-   * {
-   *     version: '1.6',
-   *     octreeDir: 'data',
-   *     boundingBox: {
-   *         lx: -4.9854,
-   *         ly: 1.0366,
-   *         lz: -3.4494,
-   *         ux: 0.702300000000001,
-   *         uy: 6.7243,
-   *         uz: 2.2383
-   *     },
-   *     tightBoundingBox: {
-   *         lx: -4.9854,
-   *         ly: 1.0375,
-   *         lz: -3.4494,
-   *         ux: -0.7889,
-   *         uy: 6.7243,
-   *         uz: 1.1245
-   *     },
-   *     pointAttributes: [
-   *         'POSITION_CARTESIAN',
-   *         'COLOR_PACKED'
-   *     ],
-   *     spacing: 0.03,
-   *     scale: 0.001,
-   *     hierarchyStepSize: 5
-   * }
-   * ```
-   *
-   * @extends Source
-   */
-  constructor(source) {
-    if (!source.file) {
-      throw new Error('New PotreeSource: file is required');
-    }
-    super(source);
-    this.file = source.file;
-    this.fetcher = Fetcher.arrayBuffer;
-    this.extensionOctree = 'hrc';
-
-    // For cloud specification visit:
-    // https://github.com/PropellerAero/potree-propeller-private/blob/master/docs/file_format.md#cloudjs
-    this.whenReady = (source.cloud ? Promise.resolve(source.cloud) : Fetcher.json(`${this.url}/${this.file}`, this.networkOptions)).then(cloud => {
-      this.pointAttributes = cloud.pointAttributes;
-      this.baseurl = `${this.url}/${cloud.octreeDir}/r`;
-      this.extension = cloud.pointAttributes === 'CIN' ? 'cin' : 'bin';
-      this.parse = this.extension === 'cin' ? PotreeCinParser.parse : PotreeBinParser.parse;
-      return cloud;
-    });
-  }
-}
-export default PotreeSource;

package/lib/Source/Source.js

@@ -1,223 +0,0 @@
-import Extent from "../Core/Geographic/Extent.js";
-import GeoJsonParser from "../Parser/GeoJsonParser.js";
-import KMLParser from "../Parser/KMLParser.js";
-import GDFParser from "../Parser/GDFParser.js";
-import GpxParser from "../Parser/GpxParser.js";
-import GTXParser from "../Parser/GTXParser.js";
-import ISGParser from "../Parser/ISGParser.js";
-import VectorTileParser from "../Parser/VectorTileParser.js";
-import Fetcher from "../Provider/Fetcher.js";
-import Cache from "../Core/Scheduler/Cache.js";
-import CRS from "../Core/Geographic/Crs.js";
-
-/** @private */
-export const supportedParsers = new Map([['application/geo+json', GeoJsonParser.parse], ['application/json', GeoJsonParser.parse], ['application/kml', KMLParser.parse], ['application/gpx', GpxParser.parse], ['application/x-protobuf;type=mapbox-vector', VectorTileParser.parse], ['application/gtx', GTXParser.parse], ['application/isg', ISGParser.parse], ['application/gdf', GDFParser.parse]]);
-const noCache = {
-  getByArray: () => {},
-  setByArray: a => a,
-  clear: () => {}
-};
-
-/**
- * @property {string} crs - data crs projection.
- * @property {boolean} isInverted - This option is to be set to the
- * correct value, true or false (default being false), if the computation of
- * the coordinates needs to be inverted to same scheme as OSM, Google Maps
- * or other system. See [this link](
- * https://alastaira.wordpress.com/2011/07/06/converting-tms-tile-coordinates-to-googlebingosm-tile-coordinates)
- * for more informations.
- *
- */
-class InformationsData {
-  constructor(options) {
-    /* istanbul ignore next */
-    if (options.projection) {
-      console.warn('Source projection parameter is deprecated, use crs instead.');
-      options.crs = options.crs || options.projection;
-    }
-    if (options.crs) {
-      CRS.isValid(options.crs);
-    }
-    this.crs = options.crs;
-  }
-}
-/**
- * This interface describes parsing options.
- * @typedef {Object} ParsingOptions
- * @property {Source} in - data informations contained in the file.
- * @property {FeatureBuildingOptions|Layer} out - options indicates how the features should be built.
- */
-
-let uid = 0;
-
-/**
- * Sources are object containing informations on how to fetch resources, from a
- * set source.
- *
- * To extend a Source, it is necessary to implement two functions:
- * `urlFromExtent` and `extentInsideLimit`.
- *
- * @extends InformationsData
- *
- * @property {boolean} isSource - Used to checkout whether this source is a
- * Source. Default is true. You should not change this, as it is used internally
- * for optimisation.
- * @property {number} uid - Unique uid mainly used to store data linked to this
- * source into Cache.
- * @property {string} url - The url of the resources that are fetched.
- * @property {string} format - The format of the resources that are fetched.
- * @property {function} fetcher - The method used to fetch the resources from
- * the source. iTowns provides some methods in {@link Fetcher}, but it can be
- * specified a custom one. This method should return a `Promise` containing the
- * fetched resource. If this property is set, it overrides the chosen fetcher
- * method with `format`.
- * @property {Object} networkOptions - Fetch options (passed directly to
- * `fetch()`), see [the syntax for more information](
- * https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#Syntax).
- * By default, set to `{ crossOrigin: 'anonymous' }`.
- * @property {string} crs - The crs projection of the resources.
- * @property {string} attribution - The intellectual property rights for the
- * resources.
- * @property {Extent} extent - The extent of the resources.
- * @property {function} parser - The method used to parse the resources attached
- * to the layer. iTowns provides some parsers, visible in the `Parser/` folder.
- * If the method is custom, it should return a `Promise` containing the parsed
- * resource. If this property is set, it overrides the default selected parser
- * method with `source.format`. If `source.format` is also empty, no parsing
- * action is done.
- * <br><br>
- * When calling this method, two parameters are passed:
- * <ul>
- *  <li>the fetched data, i.e. the data to parse</li>
- *  <li>an {@link ParsingOptions}  containing severals properties, set when this method is
- *  called: it is specific to each call, so the value of each property can vary
- *  depending on the current fetched tile for example</li>
- * </ul>
- */
-class Source extends InformationsData {
-  /**
-   * @param {Object} source - An object that can contain all properties of a
-   * Source. Only the `url` property is mandatory.
-   */
-  constructor(source) {
-    super(source);
-    this.isSource = true;
-    if (!source.url) {
-      throw new Error('New Source: url is required');
-    }
-    this.uid = uid++;
-    this.url = source.url;
-    this.format = source.format;
-    this.fetcher = source.fetcher || Fetcher.get(source.format);
-    this.parser = source.parser || supportedParsers.get(source.format) || ((d, opt) => {
-      d.extent = opt.extent;
-      return d;
-    });
-    this.isVectorSource = (source.parser || supportedParsers.get(source.format)) != undefined;
-    this.networkOptions = source.networkOptions || {
-      crossOrigin: 'anonymous'
-    };
-    this.attribution = source.attribution;
-    /** @type {Promise<any>} */
-    this.whenReady = Promise.resolve();
-    this._featuresCaches = {};
-    if (source.extent && !source.extent.isExtent) {
-      this.extent = new Extent(this.crs, source.extent);
-    } else {
-      this.extent = source.extent;
-    }
-  }
-  handlingError(err) {
-    throw new Error(err);
-  }
-
-  /**
-   * Generates an url from an extent. This url is a link to fetch the
-   * resources inside the extent.
-   *
-   * @param {Extent} extent - Extent to convert in url.
-    * @return {string} The URL constructed from the extent.
-   */
-  // eslint-disable-next-line
-  urlFromExtent() {
-    throw new Error('In extended Source, you have to implement the method urlFromExtent!');
-  }
-  requestToKey(extent) {
-    return [extent.zoom, extent.row, extent.col];
-  }
-
-  /**
-   * Load  data from cache or Fetch/Parse data.
-   * The loaded data is a Feature or Texture.
-   *
-   * @param      {Extent}  extent   extent requested parsed data.
-   * @param      {FeatureBuildingOptions|Layer}  out     The feature returned options
-   * @return     {FeatureCollection|Texture}  The parsed data.
-   */
-  loadData(extent, out) {
-    const cache = this._featuresCaches[out.crs];
-    const key = this.requestToKey(extent);
-    // try to get parsed data from cache
-    let features = cache.getByArray(key);
-    if (!features) {
-      // otherwise fetch/parse the data
-      features = cache.setByArray(this.fetcher(this.urlFromExtent(extent), this.networkOptions).then(file => this.parser(file, {
-        out,
-        in: this,
-        extent
-      })).catch(err => this.handlingError(err)), key);
-
-      /* istanbul ignore next */
-      if (this.onParsedFile) {
-        features.then(feat => {
-          this.onParsedFile(feat);
-          console.warn('Source.onParsedFile was deprecated');
-          return feat;
-        });
-      }
-    }
-    return features;
-  }
-
-  /**
-   * Called when layer added.
-   *
-   * @param {object} options
-   */
-  onLayerAdded(options) {
-    // Added new cache by crs
-    if (!this._featuresCaches[options.out.crs]) {
-      // Cache feature only if it's vector data, the feature are cached in source.
-      // It's not necessary to cache raster in Source,
-      // because it's already cached on layer.
-      this._featuresCaches[options.out.crs] = this.isVectorSource ? new Cache() : noCache;
-    }
-  }
-
-  /**
-   * Called when layer removed.
-   *
-   * @param {options}  [options={}] options
-   */
-  onLayerRemoved() {
-    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    // delete unused cache
-    const unusedCache = this._featuresCaches[options.unusedCrs];
-    if (unusedCache) {
-      unusedCache.clear();
-      delete this._featuresCaches[options.unusedCrs];
-    }
-  }
-
-  /**
-   * Tests if an extent is inside the source limits.
-   *
-   * @param {Extent} extent - Extent to test.
-    * @return {boolean} True if the extent is inside the limit, false otherwise.
-   */
-  // eslint-disable-next-line
-  extentInsideLimit() {
-    throw new Error('In extented Source, you have to implement the method extentInsideLimit!');
-  }
-}
-export default Source;

package/lib/Source/TMSSource.js

@@ -1,145 +0,0 @@
-import Source from "./Source.js";
-import URLBuilder from "../Provider/URLBuilder.js";
-import Extent from "../Core/Geographic/Extent.js";
-import Tile from "../Core/Tile/Tile.js";
-import { globalExtentTMS } from "../Core/Tile/TileGrid.js";
-import CRS from "../Core/Geographic/Crs.js";
-const _tile = new Tile(CRS.tms_4326, 0, 0, 0);
-
-/**
- * An object defining the source of resources to get from a
- * [TMS](https://wiki.osgeo.org/wiki/Tile_Map_Service_Specification) server.
- * It inherits from {@link Source}.
- *
- * @extends Source
- *
- * @property {boolean} isTMSSource - Used to checkout whether this source is a
- * TMSSource. Default is true. You should not change this, as it is used
- * internally for optimisation.
- * @property {boolean} isInverted - The isInverted property is to be set to the
- * correct value, true or false (default being false) if the computation of the
- * coordinates needs to be inverted to match the same scheme as OSM, Google Maps
- * or other system. See [this link](
- * https://alastaira.wordpress.com/2011/07/06/converting-tms-tile-coordinates-to-googlebingosm-tile-coordinates/)
- * for more information.
- * @property {Object} tileMatrixSetLimits - it describes the available tile for this layer
- * @property {Object} extentSetlimits - these are the extents of the set of identical zoom tiles.
- * @property {Object} zoom - Object containing the minimum and maximum values of
- * the level, to zoom in the source.
- * @property {number} zoom.min - The minimum level of the source. Default value
- * is 0.
- * @property {number} zoom.max - The maximum level of the source. Default value
- * is 20.
- * @property {function} tileMatrixCallback - a method that create a TileMatrix
- * identifier from the zoom level. For example, if set to `(zoomLevel) => 'EPSG:4326:' + zoomLevel`,
- * the TileMatrix that will be fetched at zoom level 5 will be the one with identifier `EPSG:4326:5`.
- * By default, the method returns the input zoom level.
- *
- * @example <caption><b>Source from OpenStreetMap server :</b></caption>
- * // Create the source
- * const tmsSource = new itowns.TMSSource({
- *     format: 'image/png',
- *     url: 'http://osm.io/styles/${z}/${x}/${y}.png',
- *     attribution: {
- *         name: 'OpenStreetMap',
- *         url: 'http://www.openstreetmap.org/',
- *     },
- *     crs: 'EPSG:3857',
- * });
- *
- * // Create the layer
- * const colorLayer = new itowns.ColorLayer('OPENSM', {
- *     source: tmsSource,
- * });
- *
- * // Add the layer
- * view.addLayer(colorLayer);
- *
- * @example <caption><b>Source from Mapbox server :</b></caption>
- * // Create the source
- * const orthoSource = new itowns.TMSSource({
- *     url: 'https://api.mapbox.com/v4/mapbox.satellite/${z}/${x}/${y}.jpg?access_token=' + accessToken,
- *     crs: 'EPSG:3857',
- * };
- *
- * // Create the layer
- * const imageryLayer = new itowns.ColorLayer("Ortho", {
- *     source: orthoSource,
- * };
- *
- * // Add the layer to the view
- * view.addLayer(imageryLayer);
- */
-class TMSSource extends Source {
-  /**
-   * @param {Object} source - An object that can contain all properties of a
-   * TMSSource and {@link Source}. Only `url` is mandatory.
-   */
-  constructor(source) {
-    source.format = source.format || 'image/png';
-    super(source);
-    if (!source.crs) {
-      throw new Error('New TMSSource/WMTSSource: crs is required');
-    }
-    this.isTMSSource = true;
-    if (!source.extent) {
-      // default to the global extent
-      this.extent = globalExtentTMS.get(source.crs);
-    }
-    this.zoom = source.zoom;
-    this.isInverted = source.isInverted || false;
-    this.crs = CRS.formatToTms(source.crs);
-    this.tileMatrixSetLimits = source.tileMatrixSetLimits;
-    this.extentSetlimits = {};
-    this.tileMatrixCallback = source.tileMatrixCallback || (zoomLevel => zoomLevel);
-    if (!this.zoom) {
-      if (this.tileMatrixSetLimits) {
-        const arrayLimits = Object.keys(this.tileMatrixSetLimits);
-        const size = arrayLimits.length;
-        const maxZoom = Number(arrayLimits[size - 1]);
-        this.zoom = {
-          min: maxZoom - size + 1,
-          max: maxZoom
-        };
-      } else {
-        this.zoom = {
-          min: 0,
-          max: Infinity
-        };
-      }
-    }
-  }
-  urlFromExtent(tile) {
-    return URLBuilder.xyz(tile, this);
-  }
-  onLayerAdded(options) {
-    super.onLayerAdded(options);
-    // Build extents of the set of identical zoom tiles.
-    const parent = options.out.parent;
-    // The extents crs is chosen to facilitate in raster tile process.
-    const crs = parent ? parent.extent.crs : options.out.crs;
-    if (this.tileMatrixSetLimits && !this.extentSetlimits[crs]) {
-      this.extentSetlimits[crs] = {};
-      _tile.crs = this.crs;
-      for (let i = this.zoom.max; i >= this.zoom.min; i--) {
-        const tmsl = this.tileMatrixSetLimits[i];
-        const {
-          west,
-          north
-        } = _tile.set(i, tmsl.minTileRow, tmsl.minTileCol).toExtent(crs);
-        const {
-          east,
-          south
-        } = _tile.set(i, tmsl.maxTileRow, tmsl.maxTileCol).toExtent(crs);
-        this.extentSetlimits[crs][i] = new Extent(crs, west, east, south, north);
-      }
-    }
-  }
-  extentInsideLimit(extent, zoom) {
-    // This layer provides data starting at level = layer.source.zoom.min
-    // (the zoom.max property is used when building the url to make
-    //  sure we don't use invalid levels)
-    return zoom >= this.zoom.min && zoom <= this.zoom.max && (this.extentSetlimits[extent.crs] == undefined || this.extentSetlimits[extent.crs][zoom].intersectsExtent(extent));
-  }
-}
-export default TMSSource;