itowns/lib/Source/EntwinePointTileSource.js

A JS/WebGL framework for 3D geospatial data visualization

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) {
        if (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);
          }
        } else if (metadata.srs.wkt) {
          proj4.defs('unknown', metadata.srs.wkt);
          const projCS = proj4.defs('unknown');
          this.crs = projCS.title || projCS.name;
          if (!(this.crs in proj4.defs)) {
            proj4.defs(this.crs, projCS);
          }
        }
        if (metadata.srs.vertical && metadata.srs.vertical !== metadata.srs.horizontal) {
          console.warn('EntwinePointTileSource: Vertical coordinates system code is not yet supported.');
        }
      }
      this.boundsConforming = metadata.boundsConforming;
      this.bounds = metadata.bounds;
      this.span = metadata.span;
      return this;
    });
    this.fetcher = Fetcher.arrayBuffer;
  }
}
export default EntwinePointTileSource;