itowns 2.44.3-next.8 → 2.45.0

package/lib/Source/C3DTilesSource.js

@@ -1,30 +0,0 @@
-import Source from "./Source.js";
-import Fetcher from "../Provider/Fetcher.js";
-
-/**
- * An object defining the source connection to a 3DTiles dataset from a web server.
- *
- * @extends Source
- *
- * @property {boolean} isC3DTilesSource - Used to checkout whether this source is a isC3DTilesSource. Default is
- * true. You should not change this, as it is used internally for optimisation.
- * @property {string} url - The URL of the tileset json.
- * @property {string} baseUrl - The base URL to access tiles.
- */
-class C3DTilesSource extends Source {
-  /**
-   * Create a new Source for 3D Tiles data from a web server.
-   *
-   * @extends Source
-   *
-   * @param {Object} source An object that can contain all properties of {@link Source}.
-   * Only `url` is mandatory.
-   */
-  constructor(source) {
-    super(source);
-    this.isC3DTilesSource = true;
-    this.baseUrl = this.url.slice(0, this.url.lastIndexOf('/') + 1);
-    this.whenReady = Fetcher.json(this.url, this.networkOptions);
-  }
-}
-export default C3DTilesSource;

package/lib/Source/CopcSource.js

@@ -1,115 +0,0 @@
-import { Binary, Info, Las } from 'copc';
-import Extent from "../Core/Geographic/Extent.js";
-import Fetcher from "../Provider/Fetcher.js";
-import LASParser from "../Parser/LASParser.js";
-import Source from "./Source.js";
-import * as THREE from 'three';
-
-/**
- * @param {function(number, number):Promise<Uint8Array>} fetcher
- */
-async function getHeaders(fetcher) {
-  const header = Las.Header.parse(await fetcher(0, Las.Constants.minHeaderLength));
-  const vlrs = await Las.Vlr.walk(fetcher, header);
-
-  // info VLR: required by COPC
-  const infoVlr = Las.Vlr.find(vlrs, 'copc', 1);
-  if (!infoVlr) {
-    return Promise.reject('COPC info VLR is required');
-  }
-  const info = Info.parse(await Las.Vlr.fetch(fetcher, infoVlr));
-
-  // OGC Coordinate System WKT: required by LAS1.4
-  const wktVlr = Las.Vlr.find(vlrs, 'LASF_Projection', 2112);
-  if (!wktVlr) {
-    return Promise.reject('LAS1.4 WKT VLR is required');
-  }
-  const wkt = Binary.toCString(await Las.Vlr.fetch(fetcher, wktVlr));
-
-  // Extra bytes: optional by LAS1.4
-  const ebVlr = Las.Vlr.find(vlrs, 'LASF_Spec', 4);
-  const eb = ebVlr ? Las.ExtraBytes.parse(await Las.Vlr.fetch(fetcher, ebVlr)) : [];
-  return {
-    header,
-    info,
-    wkt,
-    eb
-  };
-}
-
-/**
- * A source for [Cloud Optimised Point Cloud](https://copc.io/) (COPC) data.
- * Such data consists of a [LAZ 1.4](https://www.ogc.org/standard/las/) file
- * that stores compressed points data organized in a clustered octree.
- *
- * A freshly created source fetches and parses portions of the file
- * corresponding to the LAS 1.4 header, all the Variable Length Record (VLR)
- * headers as well the following VLRs:
- * - COPC [`info`](https://copc.io/#info-vlr) record (mandatory)
- * - LAS 1.4 `OGC Coordinate System WKT` record (mandatory, see [Las 1.4
- *   spec](https://portal.ogc.org/files/?artifact_id=74523))
- * - LAS 1.4 `Extra Bytes` record (optional, see [Las 1.4
- *   spec](https://portal.ogc.org/files/?artifact_id=74523))
- *
- * @extends {Source}
- *
- * @property {boolean} isCopcSource - Read-only flag to check that a given
- * object is of type CopcSource.
- * @property {Object} header - LAS header of the source.
- * @property {Object[]} eb - List of headers of each Variable Length Records
- * (VLRs).
- * @property {Object} info - COPC `info` VLR.
- * @property {number[]} info.cube - Bounding box of the octree as a 6-elements.
- * tuple `[minX, minY, minZ, maxX, maxY, maxZ]`. Computed from `center_x`,
- * `center_y`, `center_z` and `halfSize` properties.
- * @property {Object} info.rootHierarchyPage - Hierarchy page of the root node.
- * @property {number} info.rootHierarchyPage.pageOffset - Absolute Offset to the
- * root node data chunk.
- * @property {number} info.rootHierarchyPage.pageOffset - Size (in bytes) of the
- * root node data chunk.
- * @property {number[]} gpsTimeRange - A 2-element tuple denoting the minimum
- * and maximum values of attribute `gpsTime`.
- */
-class CopcSource extends Source {
-  /**
-   * @param {Object} config - Source configuration
-   * @param {string} config.url - URL of the COPC resource.
-   * @param {8 | 16} [config.colorDepth=16] - Encoding of the `color`
-   * attribute. Either `8` or `16` bits.
-   * @param {string} [config._lazPerfBaseUrl] - (experimental) Overrides base
-   * url of the `las-zip.wasm` file of the `laz-perf` library.
-   * @param {string} [config.crs='EPSG:4326'] - Native CRS of the COPC
-   * ressource. Note that this is not for now inferred from the COPC header.
-   * @param {RequestInit} [config.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).
-   * @param {Object} [config.attribution] - Attribution of the data.
-   */
-  constructor(config) {
-    super(config);
-    this.isCopcSource = true;
-    this.parser = LASParser.parseChunk;
-    this.fetcher = Fetcher.arrayBuffer;
-    this.colorDepth = config.colorDepth ?? 16;
-    const get = (/** @type {number} */begin, /** @type {number} */end) => this.fetcher(this.url, {
-      ...this.networkOptions,
-      headers: {
-        ...this.networkOptions.headers,
-        range: `bytes=${begin}-${end - 1}`
-      }
-    }).then(buffer => new Uint8Array(buffer));
-    this.whenReady = getHeaders(get).then(metadata => {
-      this.header = metadata.header;
-      this.info = metadata.info;
-      this.eb = metadata.eb;
-      // TODO: use wkt definition in `metadata.wkt` to infer/define crs
-      this.crs = config.crs || 'EPSG:4326';
-      const bbox = new THREE.Box3();
-      bbox.min.fromArray(this.info.cube, 0);
-      bbox.max.fromArray(this.info.cube, 3);
-      this.extent = Extent.fromBox3(this.crs, bbox);
-      return this;
-    });
-  }
-}
-export default CopcSource;

package/lib/Source/EntwinePointTileSource.js

@@ -1,62 +0,0 @@
-import proj4 from 'proj4';
-import LASParser from "../Parser/LASParser.js";
-import PotreeBinParser from "../Parser/PotreeBinParser.js";
-import Fetcher from "../Provider/Fetcher.js";
-import Source from "./Source.js";
-
-/**
- * An object defining the source of Entwine Point Tile data. It fetches and
- * parses the main configuration file of Entwine Point Tile format,
- * [`ept.json`](https://entwine.io/entwine-point-tile.html#ept-json).
- *
- * @extends Source
- *
- * @property {boolean} isEntwinePointTileSource - Used to checkout whether this
- * source is a EntwinePointTileSource. Default is true. You should not change
- * this, as it is used internally for optimisation.
- * @property {string} url - The URL of the directory containing the whole
- * Entwine Point Tile structure.
- */
-class EntwinePointTileSource extends Source {
-  /**
-   * @param {Object} config - The configuration, see {@link Source} for
-   * available values.
-   * @param {number|string} [config.colorDepth='auto'] - Does the color
-   * encoding is known ? Is it `8` or `16` bits ? By default it is to
-   * `'auto'`, but it will be more performant if a specific value is set.
-   */
-  constructor(config) {
-    super(config);
-    this.isEntwinePointTileSource = true;
-    this.colorDepth = config.colorDepth;
-
-    // Necessary because we use the url without the ept.json part as a base
-    this.url = this.url.replace('/ept.json', '');
-
-    // https://entwine.io/entwine-point-tile.html#ept-json
-    this.whenReady = Fetcher.json(`${this.url}/ept.json`, this.networkOptions).then(metadata => {
-      // Set parser and its configuration from schema
-      this.parse = metadata.dataType === 'laszip' ? LASParser.parse : PotreeBinParser.parse;
-      this.extension = metadata.dataType === 'laszip' ? 'laz' : 'bin';
-      if (metadata.srs && metadata.srs.authority && metadata.srs.horizontal) {
-        this.crs = `${metadata.srs.authority}:${metadata.srs.horizontal}`;
-        if (!proj4.defs(this.crs)) {
-          proj4.defs(this.crs, metadata.srs.wkt);
-        }
-        if (metadata.srs.vertical && metadata.srs.vertical !== metadata.srs.horizontal) {
-          console.warn('EntwinePointTileSource: Vertical coordinates system code is not yet supported.');
-        }
-      }
-
-      // NOTE: this spacing is kinda arbitrary here, we take the width and
-      // length (height can be ignored), and we divide by the specified
-      // span in ept.json. This needs improvements.
-      this.spacing = (Math.abs(metadata.boundsConforming[3] - metadata.boundsConforming[0]) + Math.abs(metadata.boundsConforming[4] - metadata.boundsConforming[1])) / (2 * metadata.span);
-      this.boundsConforming = metadata.boundsConforming;
-      this.span = metadata.span;
-      return this;
-    });
-    this.fetcher = Fetcher.arrayBuffer;
-  }
-}
-export default EntwinePointTileSource;

package/lib/Source/FileSource.js

@@ -1,189 +0,0 @@
-import Source from "./Source.js";
-import Cache from "../Core/Scheduler/Cache.js";
-import CRS from "../Core/Geographic/Crs.js";
-
-/**
- * An object defining the source of a single resource to get from a direct
- * access. It inherits from {@link Source}. There is multiple ways of adding a
- * resource here:
- * <ul>
- *  <li>add the file like any other sources, using the `url` property.</li>
- *  <li>fetch the file, and give the data to the source using the `fetchedData`
- *  property.</li>
- *  <li>fetch the file, parse it and git the parsed data to the source using the
- *  `features` property.</li>
- * </ul>
- * See the examples below for real use cases.
- *
- * @extends Source
- *
- * @property {boolean} isFileSource - Used to checkout whether this source is a
- * FileSource. Default is true. You should not change this, as it is used
- * internally for optimisation.
- * @property {*} fetchedData - Once the file has been loaded, the resulting data
- * is stored in this property.
- * @property {*} features - Once the file has been loaded and parsed, the
- * resulting data is stored in this property.
- *
- * @example <caption>Simple: create a source, a layer, and let iTowns taking
- * care of everything.</caption>
- * const kmlSource = new itowns.FileSource({
- *     url: 'https://raw.githubusercontent.com/iTowns/iTowns2-sample-data/master/croquis.kml',
- *     crs: 'EPSG:4326',
- *     fetcher: itowns.Fetcher.xml,
- *     parser: itowns.KMLParser.parse,
- * });
- *
- * const kmlLayer = new itowns.ColorLayer('Kml', {
- *     name: 'kml',
- *     transparent: true,
- *     crs: view.tileLayer.extent.crs,
- *     source: kmlSource,
- * });
- *
- * view.addLayer(kmlLayer);
- *
- * @example <caption>Advanced: fetch some data, create a source, a layer, and
- * let iTowns do the parsing and converting.</caption>
- * // Parse and Convert by iTowns
- * itowns.Fetcher.xml('https://raw.githubusercontent.com/iTowns/iTowns2-sample-data/master/ULTRA2009.gpx')
- *     .then(function _(gpx) {
- *         const gpxSource = new itowns.FileSource({
- *             data: gpx,
- *             crs: 'EPSG:4326',
- *             parser: itowns.GpxParser.parse,
- *         });
- *
- *         const gpxLayer = new itowns.ColorLayer('Gpx', {
- *             name: 'Ultra 2009',
- *             transparent: true,
- *             source: gpxSource,
- *         });
- *
- *         return view.addLayer(gpxLayer);
- *     });
- *
- * @example <caption>More advanced: create a layer, fetch some data, parse the
- * data, append a source to the layer and add the layer to iTowns.</caption>
- * // Create a layer
- * const ariege = new itowns.GeometryLayer('ariege', new itowns.THREE.Group());
- *
- * // Specify update method and conversion
- * ariege.update = itowns.FeatureProcessing.update;
- * ariege.convert = itowns.Feature2Mesh.convert({
- *     color: () => new itowns.THREE.Color(0xffcc00),
- *     extrude: () => 5000,
- * });
- *
- * itowns.Fetcher.json('https://raw.githubusercontent.com/gregoiredavid/france-geojson/master/departements/09-ariege/departement-09-ariege.geojson')
- *     .then(function _(geojson) {
- *         return itowns.GeoJsonParser.parse(geojson, {
- *             in: { crs: 'EPSG:4326' },
- *             out: { crs: view.tileLayer.extent.crs,
- *                      style: new itowns.Style({
- *                          fill: {
- *                              color: new itowns.THREE.Color(0xffcc00),
- *                              extrusion_height: () => 5000,
- *                      }),
- *                  },
- *             },
- *         });
- *     }).then(function _(features) {
- *         ariege.source = new itowns.FileSource({
- *             crs: 'EPSG:4326',
- *             features,
- *         });
- *
- *         return view.addLayer(ariegeLayer);
- *     });
- */
-class FileSource extends Source {
-  /**
-   * @param {Object} source - An object that can contain all properties of a
-   * FileSource and {@link Source}. Only `crs` is mandatory, but if it
-   * presents in `features` under the property `crs`, it is fine.
-   */
-  constructor(source) {
-    /* istanbul ignore next */
-    if (source.parsedData) {
-      console.warn('FileSource parsedData parameter is deprecated, use features instead of.');
-      source.features = source.features || source.parsedData;
-    }
-    /* istanbul ignore next */
-    if (source.projection) {
-      console.warn('FileSource projection parameter is deprecated, use crs instead.');
-      source.crs = source.crs || source.projection;
-    }
-    if (!source.crs) {
-      if (source.features && source.features.crs) {
-        source.crs = source.features.crs;
-      } else {
-        throw new Error('source.crs is required in FileSource');
-      }
-    }
-    if (!source.url && !source.fetchedData && !source.features) {
-      throw new Error(`url, fetchedData and features are not set in
-                FileSource; at least one needs to be present`);
-    }
-
-    // the fake url is for when we use the fetchedData or features mode
-    source.url = source.url || 'none';
-    super(source);
-    this.isFileSource = true;
-    this.fetchedData = source.fetchedData;
-    if (!this.fetchedData && !source.features) {
-      this.whenReady = this.fetcher(this.urlFromExtent(), this.networkOptions).then(f => {
-        this.fetchedData = f;
-      });
-    } else if (source.features) {
-      this._featuresCaches[source.features.crs] = new Cache();
-      this._featuresCaches[source.features.crs].setByArray(Promise.resolve(source.features), [0]);
-    }
-    this.whenReady.then(() => this.fetchedData);
-    this.zoom = {
-      min: 0,
-      max: Infinity
-    };
-  }
-  urlFromExtent() {
-    return this.url;
-  }
-  onLayerAdded(options) {
-    options.in = this;
-    super.onLayerAdded(options);
-    let features = this._featuresCaches[options.out.crs].getByArray([0]);
-    if (!features) {
-      options.out.buildExtent = this.crs != 'EPSG:4978';
-      if (options.out.buildExtent) {
-        options.out.forcedExtentCrs = options.out.crs != 'EPSG:4978' ? options.out.crs : CRS.formatToEPSG(this.crs);
-      }
-      features = this.parser(this.fetchedData, options);
-      this._featuresCaches[options.out.crs].setByArray(features, [0]);
-    }
-    features.then(data => {
-      if (data.extent) {
-        this.extent = data.extent.clone();
-        // Transform local extent to data.crs projection.
-        if (this.extent.crs == data.crs) {
-          this.extent.applyMatrix4(data.matrixWorld);
-        }
-      }
-    });
-  }
-
-  /**
-   * 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) {
-    return this._featuresCaches[out.crs].getByArray([0]);
-  }
-  extentInsideLimit(extent) {
-    return this.extent.intersectsExtent(extent);
-  }
-}
-export default FileSource;

package/lib/Source/OGC3DTilesGoogleSource.js

@@ -1,29 +0,0 @@
-import OGC3DTilesSource from "./OGC3DTilesSource.js";
-class OGC3DTilesGoogleSource extends OGC3DTilesSource {
-  /**
-   * An object defining the source connection to a 3D Tiles asset from [Google Tiles API](https://tile.googleapis.com).
-   *
-   * @extends OGC3DTilesSource
-   *
-   * @property {boolean} isOGC3DTilesGoogleSource - Used to check if this source is an OGC3DTilesGoogleSource. Set to true.
-   * You should not change this, as it is used internally for optimisation.
-   * @property {string} url - The URL to the tileset json.
-   * @property {string} baseUrl - The base URL to access tiles.
-   *
-   * @property {boolean} isOGC3DTilesGoogleSource - Used to check if this source is an OGC3DTilesGoogleSource. Set to
-   * true. You should not change this, as it is used internally for optimisation.
-   * @param {Object} source An object that can contain all properties of an OGC3DTilesGoogleSource and {@link Source}.
-   * @param {String} source.key Your google tiles map API access key
-   */
-  constructor(source) {
-    if (!source.key) {
-      throw new Error('[OGC3DTilesGoogleSource]: A API key for the google map tiles API is required');
-    }
-    // URL to the root tileset
-    source.url = `https://tile.googleapis.com/v1/3dtiles/root.json?key=${source.key}`;
-    super(source);
-    this.isOGC3DTilesGoogleSource = true;
-    this.key = source.key;
-  }
-}
-export default OGC3DTilesGoogleSource;

package/lib/Source/OGC3DTilesIonSource.js

@@ -1,34 +0,0 @@
-import OGC3DTilesSource from "./OGC3DTilesSource.js";
-class OGC3DTilesIonSource extends OGC3DTilesSource {
-  /**
-   * An object defining the source connection to a 3DTiles asset of a [Cesium ion server](https://cesium.com/learn/ion/).
-   *
-   * @extends Source
-   *
-   * @property {boolean} isOGC3DTilesIonSource - Used to check if this source is an OGC3DTilesIonSource. Set to true.
-   * You should not change this, as it is used internally for optimisation.
-   * @property {string} accessToken - The Cesium ion access token used to retrieve the resource.
-   * @property {string} assetId - The id of the asset on Cesium ion.
-   *
-   * @param {Object} source An object that can contain all properties of an OGC3DTilesIonSource and {@link Source}.
-   * Only `accessToken` and `assetId` are mandatory.
-   * @param {string} source.accessToken - The Cesium ion access token used to retrieve the resource.
-   * @param {string} source.assetId - The id of the asset on Cesium ion.
-   */
-  constructor(source) {
-    if (!source.accessToken) {
-      throw new Error('[OGC3DTilesIonSource]: accessToken is required');
-    }
-    if (!source.assetId) {
-      throw new Error('[OGC3DTilesIonSource]: assetId is required');
-    }
-
-    // Url to query cesium ion the first time to retrieve metadata of the asset with assetId
-    source.url = `https://api.cesium.com/v1/assets/${source.assetId}/endpoint?access_token=${source.accessToken}`;
-    super(source);
-    this.isOGC3DTilesIonSource = true;
-    this.accessToken = source.accessToken;
-    this.assetId = source.assetId;
-  }
-}
-export default OGC3DTilesIonSource;

package/lib/Source/OGC3DTilesSource.js

@@ -1,21 +0,0 @@
-import Source from "./Source.js";
-class OGC3DTilesSource extends Source {
-  /**
-   * An object defining the source connection to a 3DTiles dataset from a web server.
-   *
-   * @extends Source
-   *
-   * @property {boolean} isOGC3DTilesSource - Used to check if this source is an isOGC3DTilesSource. Set to true.
-   * You should not change this, as it is used internally for optimisation.
-   * @property {string} url - The URL of the tileset json.
-   *
-   * @param {Object} source An object that can contain all properties of OGC3DTilesSource and of {@link Source}.
-   * Only `url` is mandatory.
-   * @param {string} source.url - The URL of the tileset json.
-   */
-  constructor(source) {
-    super(source);
-    this.isOGC3DTilesSource = true;
-  }
-}
-export default OGC3DTilesSource;

package/lib/Source/OrientedImageSource.js

@@ -1,59 +0,0 @@
-import Source from "./Source.js";
-import Fetcher from "../Provider/Fetcher.js";
-
-/**
- * OrientedImageSource is a specific source used to load oriented images.
- * @extends Source
- */
-class OrientedImageSource extends Source {
-  /**
-   * @param { Object } source - Configuration object
-   * @param { string } source.url - Url for all the textures.
-   * @param { string } source.orientationsUrl - Json Url, using GeoJSon format to represent points,
-   * it's a set of panoramic position and orientation.
-   * @param { string } source.calibrationUrl - Json url, representing a set of camera.
-   * see {@link CameraCalibrationParser}
-   * This Url must contains {sensorId} and {cameraId}, and these pattern will be replaced to build the Url,
-   * to find the good texture for each camera for each panoramic.
-   */
-  constructor(source) {
-    super(source);
-    this.isOrientedImageSource = true;
-
-    // Fetch the two files
-    const promises = [];
-    promises.push(source.orientationsUrl ? Fetcher.json(source.orientationsUrl, this.networkOptions) : Promise.resolve());
-    promises.push(source.calibrationUrl ? Fetcher.json(source.calibrationUrl, this.networkOptions) : Promise.resolve());
-    this.whenReady = Promise.all(promises).then(data => ({
-      orientation: data[0],
-      calibration: data[1]
-    }));
-  }
-
-  /**
-   * Build the url of the texture, but not from extent.
-   *
-   * @param      {Object}  imageInfo - Information about the texture
-   * @param      {string}  imageInfo.camera - Id of the camera
-   * @param      {string}  imageInfo.pano - Id of the panoramic
-   * @return     {string}  Url of the image
-   */
-  urlFromExtent(imageInfo) {
-    return this.imageUrl(imageInfo.cameraId, imageInfo.panoId);
-  }
-  requestToKey(image) {
-    return [image.cameraId, image.panoId];
-  }
-
-  /**
-   * Build the url of the image, for a given panoramic id, and a given camera id.
-   *
-   * @param      {string}  cameraId  Id of the camera
-   * @param      {string}  panoId   Id of the panoramic
-   * @return     {string}  Url of the image
-   */
-  imageUrl(cameraId, panoId) {
-    return this.url.replace('{cameraId}', cameraId).replace('{panoId}', panoId);
-  }
-}
-export default OrientedImageSource;