@loaders.gl/tiles 4.0.0-alpha.5 → 4.0.0-alpha.6

package/dist/es5/tileset/helpers/transform-utils.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.calculateTransformProps = calculateTransformProps;
+var _geospatial = require("@math.gl/geospatial");
+var _core = require("@math.gl/core");
+var _loaderUtils = require("@loaders.gl/loader-utils");
+function calculateTransformProps(tileHeader, tile) {
+  (0, _loaderUtils.assert)(tileHeader);
+  (0, _loaderUtils.assert)(tile);
+  var rtcCenter = tile.rtcCenter,
+    gltfUpAxis = tile.gltfUpAxis;
+  var computedTransform = tileHeader.computedTransform,
+    center = tileHeader.boundingVolume.center;
+  var modelMatrix = new _core.Matrix4(computedTransform);
+  if (rtcCenter) {
+    modelMatrix.translate(rtcCenter);
+  }
+  switch (gltfUpAxis) {
+    case 'Z':
+      break;
+    case 'Y':
+      var rotationY = new _core.Matrix4().rotateX(Math.PI / 2);
+      modelMatrix = modelMatrix.multiplyRight(rotationY);
+      break;
+    case 'X':
+      var rotationX = new _core.Matrix4().rotateY(-Math.PI / 2);
+      modelMatrix = modelMatrix.multiplyRight(rotationX);
+      break;
+    default:
+      break;
+  }
+  if (tile.isQuantized) {
+    modelMatrix.translate(tile.quantizedVolumeOffset).scale(tile.quantizedVolumeScale);
+  }
+  var cartesianOrigin = new _core.Vector3(center);
+  tile.cartesianModelMatrix = modelMatrix;
+  tile.cartesianOrigin = cartesianOrigin;
+  var cartographicOrigin = _geospatial.Ellipsoid.WGS84.cartesianToCartographic(cartesianOrigin, new _core.Vector3());
+  var fromFixedFrameMatrix = _geospatial.Ellipsoid.WGS84.eastNorthUpToFixedFrame(cartesianOrigin);
+  var toFixedFrameMatrix = fromFixedFrameMatrix.invert();
+  tile.cartographicModelMatrix = toFixedFrameMatrix.multiplyRight(modelMatrix);
+  tile.cartographicOrigin = cartographicOrigin;
+  if (!tile.coordinateSystem) {
+    tile.modelMatrix = tile.cartographicModelMatrix;
+  }
+}
+//# sourceMappingURL=transform-utils.js.map

package/dist/es5/tileset/helpers/transform-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-utils.js","names":["_geospatial","require","_core","_loaderUtils","calculateTransformProps","tileHeader","tile","assert","rtcCenter","gltfUpAxis","computedTransform","center","boundingVolume","modelMatrix","Matrix4","translate","rotationY","rotateX","Math","PI","multiplyRight","rotationX","rotateY","isQuantized","quantizedVolumeOffset","scale","quantizedVolumeScale","cartesianOrigin","Vector3","cartesianModelMatrix","cartographicOrigin","Ellipsoid","WGS84","cartesianToCartographic","fromFixedFrameMatrix","eastNorthUpToFixedFrame","toFixedFrameMatrix","invert","cartographicModelMatrix","coordinateSystem"],"sources":["../../../../src/tileset/helpers/transform-utils.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport {Ellipsoid} from '@math.gl/geospatial';\nimport {Matrix4, Vector3} from '@math.gl/core';\nimport {assert} from '@loaders.gl/loader-utils';\n\nexport function calculateTransformProps(tileHeader, tile) {\n  assert(tileHeader);\n  assert(tile);\n\n  const {rtcCenter, gltfUpAxis} = tile;\n  const {\n    computedTransform,\n    boundingVolume: {center}\n  } = tileHeader;\n\n  let modelMatrix = new Matrix4(computedTransform);\n\n  // Translate if appropriate\n  if (rtcCenter) {\n    modelMatrix.translate(rtcCenter);\n  }\n\n  // glTF models need to be rotated from Y to Z up\n  // https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification#y-up-to-z-up\n  switch (gltfUpAxis) {\n    case 'Z':\n      break;\n    case 'Y':\n      const rotationY = new Matrix4().rotateX(Math.PI / 2);\n      modelMatrix = modelMatrix.multiplyRight(rotationY);\n      break;\n    case 'X':\n      const rotationX = new Matrix4().rotateY(-Math.PI / 2);\n      modelMatrix = modelMatrix.multiplyRight(rotationX);\n      break;\n    default:\n      break;\n  }\n\n  // Scale/offset positions if normalized integers\n  if (tile.isQuantized) {\n    modelMatrix.translate(tile.quantizedVolumeOffset).scale(tile.quantizedVolumeScale);\n  }\n\n  // Option 1: Cartesian matrix and origin\n  const cartesianOrigin = new Vector3(center);\n\n  tile.cartesianModelMatrix = modelMatrix;\n  tile.cartesianOrigin = cartesianOrigin;\n\n  // Option 2: Cartographic matrix and origin\n  const cartographicOrigin = Ellipsoid.WGS84.cartesianToCartographic(\n    cartesianOrigin,\n    new Vector3()\n  );\n  const fromFixedFrameMatrix = Ellipsoid.WGS84.eastNorthUpToFixedFrame(cartesianOrigin);\n  const toFixedFrameMatrix = fromFixedFrameMatrix.invert();\n\n  tile.cartographicModelMatrix = toFixedFrameMatrix.multiplyRight(modelMatrix);\n  tile.cartographicOrigin = cartographicOrigin;\n\n  // Deprecated, drop\n  if (!tile.coordinateSystem) {\n    tile.modelMatrix = tile.cartographicModelMatrix;\n  }\n}\n"],"mappings":";;;;;;AAEA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AACA,IAAAE,YAAA,GAAAF,OAAA;AAEO,SAASG,uBAAuBA,CAACC,UAAU,EAAEC,IAAI,EAAE;EACxD,IAAAC,mBAAM,EAACF,UAAU,CAAC;EAClB,IAAAE,mBAAM,EAACD,IAAI,CAAC;EAEZ,IAAOE,SAAS,GAAgBF,IAAI,CAA7BE,SAAS;IAAEC,UAAU,GAAIH,IAAI,CAAlBG,UAAU;EAC5B,IACEC,iBAAiB,GAEfL,UAAU,CAFZK,iBAAiB;IACAC,MAAM,GACrBN,UAAU,CADZO,cAAc,CAAGD,MAAM;EAGzB,IAAIE,WAAW,GAAG,IAAIC,aAAO,CAACJ,iBAAiB,CAAC;EAGhD,IAAIF,SAAS,EAAE;IACbK,WAAW,CAACE,SAAS,CAACP,SAAS,CAAC;EAClC;EAIA,QAAQC,UAAU;IAChB,KAAK,GAAG;MACN;IACF,KAAK,GAAG;MACN,IAAMO,SAAS,GAAG,IAAIF,aAAO,CAAC,CAAC,CAACG,OAAO,CAACC,IAAI,CAACC,EAAE,GAAG,CAAC,CAAC;MACpDN,WAAW,GAAGA,WAAW,CAACO,aAAa,CAACJ,SAAS,CAAC;MAClD;IACF,KAAK,GAAG;MACN,IAAMK,SAAS,GAAG,IAAIP,aAAO,CAAC,CAAC,CAACQ,OAAO,CAAC,CAACJ,IAAI,CAACC,EAAE,GAAG,CAAC,CAAC;MACrDN,WAAW,GAAGA,WAAW,CAACO,aAAa,CAACC,SAAS,CAAC;MAClD;IACF;MACE;EACJ;EAGA,IAAIf,IAAI,CAACiB,WAAW,EAAE;IACpBV,WAAW,CAACE,SAAS,CAACT,IAAI,CAACkB,qBAAqB,CAAC,CAACC,KAAK,CAACnB,IAAI,CAACoB,oBAAoB,CAAC;EACpF;EAGA,IAAMC,eAAe,GAAG,IAAIC,aAAO,CAACjB,MAAM,CAAC;EAE3CL,IAAI,CAACuB,oBAAoB,GAAGhB,WAAW;EACvCP,IAAI,CAACqB,eAAe,GAAGA,eAAe;EAGtC,IAAMG,kBAAkB,GAAGC,qBAAS,CAACC,KAAK,CAACC,uBAAuB,CAChEN,eAAe,EACf,IAAIC,aAAO,CAAC,CACd,CAAC;EACD,IAAMM,oBAAoB,GAAGH,qBAAS,CAACC,KAAK,CAACG,uBAAuB,CAACR,eAAe,CAAC;EACrF,IAAMS,kBAAkB,GAAGF,oBAAoB,CAACG,MAAM,CAAC,CAAC;EAExD/B,IAAI,CAACgC,uBAAuB,GAAGF,kBAAkB,CAAChB,aAAa,CAACP,WAAW,CAAC;EAC5EP,IAAI,CAACwB,kBAAkB,GAAGA,kBAAkB;EAG5C,IAAI,CAACxB,IAAI,CAACiC,gBAAgB,EAAE;IAC1BjC,IAAI,CAACO,WAAW,GAAGP,IAAI,CAACgC,uBAAuB;EACjD;AACF"}

package/dist/es5/tileset/helpers/zoom.js

@@ -0,0 +1,63 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getZoomFromBoundingVolume = getZoomFromBoundingVolume;
+exports.getZoomFromExtent = getZoomFromExtent;
+exports.getZoomFromFullExtent = getZoomFromFullExtent;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _core = require("@math.gl/core");
+var _culling = require("@math.gl/culling");
+var _geospatial = require("@math.gl/geospatial");
+var WGS84_RADIUS_X = 6378137.0;
+var WGS84_RADIUS_Y = 6378137.0;
+var WGS84_RADIUS_Z = 6356752.3142451793;
+var scratchVector = new _core.Vector3();
+function getZoomFromBoundingVolume(boundingVolume, cartorgraphicCenter) {
+  if (boundingVolume instanceof _culling.OrientedBoundingBox) {
+    var halfAxes = boundingVolume.halfAxes;
+    var obbSize = getObbSize(halfAxes);
+    return Math.log2(WGS84_RADIUS_Z / (obbSize + cartorgraphicCenter[2]));
+  } else if (boundingVolume instanceof _culling.BoundingSphere) {
+    var radius = boundingVolume.radius;
+    return Math.log2(WGS84_RADIUS_Z / (radius + cartorgraphicCenter[2]));
+  } else if (boundingVolume.width && boundingVolume.height) {
+    var width = boundingVolume.width,
+      height = boundingVolume.height;
+    var zoomX = Math.log2(WGS84_RADIUS_X / width);
+    var zoomY = Math.log2(WGS84_RADIUS_Y / height);
+    return (zoomX + zoomY) / 2;
+  }
+  return 1;
+}
+function getZoomFromFullExtent(fullExtent, cartorgraphicCenter, cartesianCenter) {
+  var extentVertex = _geospatial.Ellipsoid.WGS84.cartographicToCartesian([fullExtent.xmax, fullExtent.ymax, fullExtent.zmax], new _core.Vector3());
+  var extentSize = Math.sqrt(Math.pow(extentVertex[0] - cartesianCenter[0], 2) + Math.pow(extentVertex[1] - cartesianCenter[1], 2) + Math.pow(extentVertex[2] - cartesianCenter[2], 2));
+  return Math.log2(WGS84_RADIUS_Z / (extentSize + cartorgraphicCenter[2]));
+}
+function getZoomFromExtent(extent, cartorgraphicCenter, cartesianCenter) {
+  var _extent = (0, _slicedToArray2.default)(extent, 4),
+    xmin = _extent[0],
+    ymin = _extent[1],
+    xmax = _extent[2],
+    ymax = _extent[3];
+  return getZoomFromFullExtent({
+    xmin: xmin,
+    xmax: xmax,
+    ymin: ymin,
+    ymax: ymax,
+    zmin: 0,
+    zmax: 0
+  }, cartorgraphicCenter, cartesianCenter);
+}
+function getObbSize(halfAxes) {
+  halfAxes.getColumn(0, scratchVector);
+  var axeY = halfAxes.getColumn(1);
+  var axeZ = halfAxes.getColumn(2);
+  var farthestVertex = scratchVector.add(axeY).add(axeZ);
+  var size = farthestVertex.len();
+  return size;
+}
+//# sourceMappingURL=zoom.js.map

package/dist/es5/tileset/helpers/zoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom.js","names":["_core","require","_culling","_geospatial","WGS84_RADIUS_X","WGS84_RADIUS_Y","WGS84_RADIUS_Z","scratchVector","Vector3","getZoomFromBoundingVolume","boundingVolume","cartorgraphicCenter","OrientedBoundingBox","halfAxes","obbSize","getObbSize","Math","log2","BoundingSphere","radius","width","height","zoomX","zoomY","getZoomFromFullExtent","fullExtent","cartesianCenter","extentVertex","Ellipsoid","WGS84","cartographicToCartesian","xmax","ymax","zmax","extentSize","sqrt","pow","getZoomFromExtent","extent","_extent","_slicedToArray2","default","xmin","ymin","zmin","getColumn","axeY","axeZ","farthestVertex","add","size","len"],"sources":["../../../../src/tileset/helpers/zoom.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport {Vector3} from '@math.gl/core';\nimport {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';\nimport {Ellipsoid} from '@math.gl/geospatial';\nimport {BoundingRectangle} from '../../types';\n\nconst WGS84_RADIUS_X = 6378137.0;\nconst WGS84_RADIUS_Y = 6378137.0;\nconst WGS84_RADIUS_Z = 6356752.3142451793;\n\nconst scratchVector = new Vector3();\n\n/**\n * Calculate appropriate zoom value for a particular boundingVolume\n * @param boundingVolume - the instance of bounding volume\n * @param cartorgraphicCenter - cartographic center of the bounding volume\n * @returns {number} - zoom value\n */\nexport function getZoomFromBoundingVolume(\n  boundingVolume: BoundingSphere | OrientedBoundingBox | BoundingRectangle,\n  cartorgraphicCenter: Vector3\n) {\n  if (boundingVolume instanceof OrientedBoundingBox) {\n    // OrientedBoundingBox\n    const {halfAxes} = boundingVolume;\n    const obbSize = getObbSize(halfAxes);\n    // Use WGS84_RADIUS_Z to allign with BoundingSphere algorithm\n    // Add the tile elevation value for correct zooming to elevated tiles\n    return Math.log2(WGS84_RADIUS_Z / (obbSize + cartorgraphicCenter[2]));\n  } else if (boundingVolume instanceof BoundingSphere) {\n    // BoundingSphere\n    const {radius} = boundingVolume;\n    // Add the tile elevation value for correct zooming to elevated tiles\n    return Math.log2(WGS84_RADIUS_Z / (radius + cartorgraphicCenter[2]));\n  } else if (boundingVolume.width && boundingVolume.height) {\n    // BoundingRectangle\n    const {width, height} = boundingVolume;\n    const zoomX = Math.log2(WGS84_RADIUS_X / width);\n    const zoomY = Math.log2(WGS84_RADIUS_Y / height);\n\n    return (zoomX + zoomY) / 2;\n  }\n\n  return 1;\n}\n\n/**\n * Calculate initial zoom for the tileset from 3D `fullExtent` defined in\n * the tileset metadata\n * @param fullExtent - 3D extent of the tileset\n * @param fullExtent.xmin - minimal longitude in decimal degrees\n * @param fullExtent.xmax - maximal longitude in decimal degrees\n * @param fullExtent.ymin - minimal latitude in decimal degrees\n * @param fullExtent.ymax - maximal latitude in decimal degrees\n * @param fullExtent.zmin - minimal elevation in meters\n * @param fullExtent.zmax - maximal elevation in meters\n * @param cartorgraphicCenter - tileset center in cartographic coordinate system\n * @param cartesianCenter - tileset center in cartesian coordinate system\n * @returns - initial zoom for the tileset\n */\nexport function getZoomFromFullExtent(\n  fullExtent: {\n    xmin: number;\n    xmax: number;\n    ymin: number;\n    ymax: number;\n    zmin: number;\n    zmax: number;\n  },\n  cartorgraphicCenter: Vector3,\n  cartesianCenter: Vector3\n) {\n  const extentVertex = Ellipsoid.WGS84.cartographicToCartesian(\n    [fullExtent.xmax, fullExtent.ymax, fullExtent.zmax],\n    new Vector3()\n  );\n  const extentSize = Math.sqrt(\n    Math.pow(extentVertex[0] - cartesianCenter[0], 2) +\n      Math.pow(extentVertex[1] - cartesianCenter[1], 2) +\n      Math.pow(extentVertex[2] - cartesianCenter[2], 2)\n  );\n  return Math.log2(WGS84_RADIUS_Z / (extentSize + cartorgraphicCenter[2]));\n}\n\n/**\n * Calculate initial zoom for the tileset from 2D `extent` defined in\n * the tileset metadata\n * @param extent - 2D extent of the tileset. It is array of 4 elements [xmin, ymin, xmax, ymax]\n * @param extent[0] - minimal longitude in decimal degrees\n * @param extent[1] - minimal latitude in decimal degrees\n * @param extent[2] - maximal longitude in decimal degrees\n * @param extent[3] - maximal latitude in decimal degrees\n * @param cartorgraphicCenter - tileset center in cartographic coordinate system\n * @param cartesianCenter - tileset center in cartesian coordinate system\n * @returns - initial zoom for the tileset\n */\nexport function getZoomFromExtent(\n  extent: [number, number, number, number],\n  cartorgraphicCenter: Vector3,\n  cartesianCenter: Vector3\n) {\n  const [xmin, ymin, xmax, ymax] = extent;\n  return getZoomFromFullExtent(\n    {xmin, xmax, ymin, ymax, zmin: 0, zmax: 0},\n    cartorgraphicCenter,\n    cartesianCenter\n  );\n}\n\nfunction getObbSize(halfAxes) {\n  halfAxes.getColumn(0, scratchVector);\n  const axeY = halfAxes.getColumn(1);\n  const axeZ = halfAxes.getColumn(2);\n  const farthestVertex = scratchVector.add(axeY).add(axeZ);\n  const size = farthestVertex.len();\n  return size;\n}\n"],"mappings":";;;;;;;;;;AAEA,IAAAA,KAAA,GAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AACA,IAAAE,WAAA,GAAAF,OAAA;AAGA,IAAMG,cAAc,GAAG,SAAS;AAChC,IAAMC,cAAc,GAAG,SAAS;AAChC,IAAMC,cAAc,GAAG,kBAAkB;AAEzC,IAAMC,aAAa,GAAG,IAAIC,aAAO,CAAC,CAAC;AAQ5B,SAASC,yBAAyBA,CACvCC,cAAwE,EACxEC,mBAA4B,EAC5B;EACA,IAAID,cAAc,YAAYE,4BAAmB,EAAE;IAEjD,IAAOC,QAAQ,GAAIH,cAAc,CAA1BG,QAAQ;IACf,IAAMC,OAAO,GAAGC,UAAU,CAACF,QAAQ,CAAC;IAGpC,OAAOG,IAAI,CAACC,IAAI,CAACX,cAAc,IAAIQ,OAAO,GAAGH,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;EACvE,CAAC,MAAM,IAAID,cAAc,YAAYQ,uBAAc,EAAE;IAEnD,IAAOC,MAAM,GAAIT,cAAc,CAAxBS,MAAM;IAEb,OAAOH,IAAI,CAACC,IAAI,CAACX,cAAc,IAAIa,MAAM,GAAGR,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;EACtE,CAAC,MAAM,IAAID,cAAc,CAACU,KAAK,IAAIV,cAAc,CAACW,MAAM,EAAE;IAExD,IAAOD,KAAK,GAAYV,cAAc,CAA/BU,KAAK;MAAEC,MAAM,GAAIX,cAAc,CAAxBW,MAAM;IACpB,IAAMC,KAAK,GAAGN,IAAI,CAACC,IAAI,CAACb,cAAc,GAAGgB,KAAK,CAAC;IAC/C,IAAMG,KAAK,GAAGP,IAAI,CAACC,IAAI,CAACZ,cAAc,GAAGgB,MAAM,CAAC;IAEhD,OAAO,CAACC,KAAK,GAAGC,KAAK,IAAI,CAAC;EAC5B;EAEA,OAAO,CAAC;AACV;AAgBO,SAASC,qBAAqBA,CACnCC,UAOC,EACDd,mBAA4B,EAC5Be,eAAwB,EACxB;EACA,IAAMC,YAAY,GAAGC,qBAAS,CAACC,KAAK,CAACC,uBAAuB,CAC1D,CAACL,UAAU,CAACM,IAAI,EAAEN,UAAU,CAACO,IAAI,EAAEP,UAAU,CAACQ,IAAI,CAAC,EACnD,IAAIzB,aAAO,CAAC,CACd,CAAC;EACD,IAAM0B,UAAU,GAAGlB,IAAI,CAACmB,IAAI,CAC1BnB,IAAI,CAACoB,GAAG,CAACT,YAAY,CAAC,CAAC,CAAC,GAAGD,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAC/CV,IAAI,CAACoB,GAAG,CAACT,YAAY,CAAC,CAAC,CAAC,GAAGD,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GACjDV,IAAI,CAACoB,GAAG,CAACT,YAAY,CAAC,CAAC,CAAC,GAAGD,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CACpD,CAAC;EACD,OAAOV,IAAI,CAACC,IAAI,CAACX,cAAc,IAAI4B,UAAU,GAAGvB,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E;AAcO,SAAS0B,iBAAiBA,CAC/BC,MAAwC,EACxC3B,mBAA4B,EAC5Be,eAAwB,EACxB;EACA,IAAAa,OAAA,OAAAC,eAAA,CAAAC,OAAA,EAAiCH,MAAM;IAAhCI,IAAI,GAAAH,OAAA;IAAEI,IAAI,GAAAJ,OAAA;IAAER,IAAI,GAAAQ,OAAA;IAAEP,IAAI,GAAAO,OAAA;EAC7B,OAAOf,qBAAqB,CAC1B;IAACkB,IAAI,EAAJA,IAAI;IAAEX,IAAI,EAAJA,IAAI;IAAEY,IAAI,EAAJA,IAAI;IAAEX,IAAI,EAAJA,IAAI;IAAEY,IAAI,EAAE,CAAC;IAAEX,IAAI,EAAE;EAAC,CAAC,EAC1CtB,mBAAmB,EACnBe,eACF,CAAC;AACH;AAEA,SAASX,UAAUA,CAACF,QAAQ,EAAE;EAC5BA,QAAQ,CAACgC,SAAS,CAAC,CAAC,EAAEtC,aAAa,CAAC;EACpC,IAAMuC,IAAI,GAAGjC,QAAQ,CAACgC,SAAS,CAAC,CAAC,CAAC;EAClC,IAAME,IAAI,GAAGlC,QAAQ,CAACgC,SAAS,CAAC,CAAC,CAAC;EAClC,IAAMG,cAAc,GAAGzC,aAAa,CAAC0C,GAAG,CAACH,IAAI,CAAC,CAACG,GAAG,CAACF,IAAI,CAAC;EACxD,IAAMG,IAAI,GAAGF,cAAc,CAACG,GAAG,CAAC,CAAC;EACjC,OAAOD,IAAI;AACb"}