Merge pull request #10 from NASA-AMMOS/development

1.0.3

Author: tariqksoliman

dist/lithosphere.js

@@ -1 +1 @@
-export default function load(customParsers: any, tilePath: string, layerObj?: any, xyz?: any, tileResolution?: number, numberOfVertices?: number): Promise<number[]>;
+export default function load(customParsers: any, tilePath: string, layerObj?: any, xyz?: any, tileResolution?: number, numberOfVertices?: number, forceParserType?: string): Promise<number[]>;

dist/src/constants.d.ts

@@ -1,6 +1,6 @@
 import { XY, XYZ } from '../generalTypes';
 declare const Utils: {
-    getIn: (obj: any, keyArray: string[], notSetValue?: any) => any;
+    getIn: (obj: any, keyArray: any, notSetValue?: any) => any;
     mod: (n: number, m: number) => number;
     findHighestMaxZoom: (tileLayers: any) => number;
     findLowestMinZoom: (tileLayers: any) => number;

dist/src/controls/altitude.d.ts

@@ -35,6 +35,7 @@ new LithoSphere(containerId, options)
 |    **minorRadius**     | _integer_  |                                    majorRadius                                     |                         Minor planetary radius in meters                         |
 |   **loadingScreen**    | _boolean_  |                                        true                                        |    If true, shows a loading screen until all lithosphere content first loads     |
 |   **customParsers**    |  _object_  |                     See [Parsers]({{ site.baseurl }}/parsers)                      |                 Allows the use of custom elevation tile parsers                  |
+|    **demFallback**     |  _object_  |     See [demFallback]({{ site.baseurl }}/constructor#optionsdemfallback) below     |                  A DEM to fallback to if any layer's DEM fails                   |
 |  **tileMapResource**   |  _object_  | See [tileMapResource]({{ site.baseurl }}/constructor#optionstilemapresource) below |                              Configures projections                              |
 |   **radiusOfTiles**    | _integer_  |                                         4                                          |         How many tiles outward from the center to use for the base tiles         |
 |   **wireframeMode**    | _boolean_  |                                       false                                        |            If true, all tiles are rendered with a wireframe material             |
@@ -71,6 +72,28 @@ The latitude, longitude, and zoom LithoSphere first starts at.
 }
 ```
 
+### options.demFallback
+
+If a tile layer has a `demPath` set and one of its tile dem request fails for whatever reason (such as a 404) or does not have a `demPath` set, it will try to get the corresponding DEM tile specified in `demFallback`.
+
+|   Parameter    |   Type   | Default |            Description            |
+| :------------: | :------: | :-----: | :-------------------------------: |
+|  **demPath**   | _string_ |         |  Path for the fallback DEM tiles  |
+|   **format**   | _string_ |  'tms'  | Tile format: 'tms', 'wmts', 'wms' |
+| **parserType** | _string_ | 'rgba'  |  Which parser to use for demPath  |
+
+#### Example
+
+```javascript
+{
+    demFallback: {
+        demPath:
+            'https://domain.com/Missions/MSL/Layers/Gale_HiRISE/MSL_Gale_DEM_Mosaic_1m_v3/{z}/{x}/{y}.png',
+        parserType: 'rgba',
+    },
+}
+```
+
 ### options.tileMapResource
 
 Representative of the tilemapresource.xml file outputted following tile generation.