v1.4.0 (#32)

* v1.3.0 (#24) * Update README.md * Added boundingBoxEN option to tile layerer (#30) Co-authored-by: Tom Cannon <[email protected]> * #1 Add Navigation Control (#31) * Bump v1.4.0 Co-authored-by: Thomas Cannon <[email protected]> Co-authored-by: Tom Cannon <[email protected]>
NASA-AMMOS · Mar 29, 2022 · 4f0645c · 4f0645c
1 parent d11a548
commit 4f0645c
Show file tree

Hide file tree

Showing 16 changed files with 446 additions and 32 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,17 @@
 
 [Official Releases](https://github.com/NASA-AMMOS/LithoSphere/releases)
 
+## v1.4.0
+
+_Mar 29, 2022_
+
+#### Added
+
+-   Navigation control
+-   Easting and northing `boundingBoxEN` option for tile layers
+
+---
+
 ## v1.3.0
 
 _Feb 23, 2022_
@@ -15,6 +26,8 @@ _Feb 23, 2022_
 
 -   Removed extraneous addition of "ratio of surface areas" to `reszoomlevel`
 
+---
+
 ## v1.2.0
 
 _Jan 27, 2022_

diff --git a/dist/src/controls/index.d.ts b/dist/src/controls/index.d.ts
@@ -10,6 +10,7 @@ export default class Controls {
     };
     activeControls: any;
     compass: any;
+    navigation: any;
     coordinates: any;
     home: any;
     layers: any;

diff --git a/dist/src/controls/navigation.d.ts b/dist/src/controls/navigation.d.ts
@@ -0,0 +1,14 @@
+import { Corners } from '../generalTypes.d.ts';
+import './navigation.css';
+interface Private {
+}
+export default class Navigation {
+    _: Private;
+    p: any;
+    name: string;
+    corner: Corners;
+    constructor(parent: any, name: string);
+    getControl: () => string;
+    attachEvents: () => void;
+}
+export {};
diff --git a/dist/src/utils/index.d.ts b/dist/src/utils/index.d.ts
@@ -5,6 +5,7 @@ declare const Utils: {
     findHighestMaxZoom: (tileLayers: any) => number;
     findLowestMinZoom: (tileLayers: any) => number;
     isInExtent: (xyz: XYZ, bb: any, projection: any) => boolean;
+    isInExtentEN: (xyz: XYZ, bb: any, proj: any, margin?: number) => boolean;
     clone: (obj: any) => any;
     capitalizeFirstLetter: (string: string) => string;
     getExtension: (string: string) => string;

diff --git a/docs/pages/Controls/controls.markdown b/docs/pages/Controls/controls.markdown
@@ -62,6 +62,14 @@ A menu that lists out the current layers within LithoSphere and provides the abi
 Litho.addControl('myLayers', Litho.controls.layers)
 ```
 
+### Navigation
+
+Adds on-screen spin, tilt, pan and zoom options to navigate and reorientate the scene through clicking.
+
+```javascript
+Litho.addControl('myNavigation', Litho.controls.navigation)
+```
+
 ### Observe
 
 Allows users to set camera parameters and stand at a location in it.

diff --git a/docs/pages/Layers/Tile/tile.markdown b/docs/pages/Layers/Tile/tile.markdown
@@ -11,21 +11,22 @@ A tiled raster layer with height support.
 
 ## Options
 
-|      Parameter       |     Type      |  Default   |                                               Description                                                |
-| :------------------: | :-----------: | :--------: | :------------------------------------------------------------------------------------------------------: |
-|       **name**       |   _string_    | _Required_ |                                    Layer's name and unique identifier                                    |
-|      **order**       |   _number_    | _Required_ |                                          Layer draw order state                                          |
-|        **on**        |   _boolean_   | _Required_ |                                            Initial visibility                                            |
-|       **path**       |   _string_    | _Required_ |                                   A URL to the raster tileset curtain                                    |
-|     **demPath**      |   _string_    |    null    |                            A URL to the DEM (Digital Elevation Model) tileset                            |
-|      **format**      | _string-enum_ |   'tms'    |                               Raster tileset format ('tms', 'wmts', 'wms )                               |
-|    **demFormat**     |   _string_    |   'tms'    |                                DEM tileset format ('tms', 'wmts', 'wms )                                 |
-| **demFormatOptions** |   _object_    |    null    |                                            See example below                                             |
-|     **opacity**      |   _number_    | _Required_ |                              Initial opaqueness [0(transparent), 1(opaque)]                              |
-|     **minZoom**      |   _integer_   | _Required_ |                      The minimum (smallest number) zoom level of the raster tileset                      |
-|     **maxZoom**      |   _integer_   | _Required_ |                      The maximum (biggest number) zoom level of the raster tileset                       |
-|     **filters**      |   _object_    |    null    |                                Filter and blend mode effect for the layer                                |
-|   **boundingBox**    |  _number[4]_  |    null    | The bounds of the tileset. Only queries for tiles that intersect this box. [lng, lat, lng, lat] (SW, NE) |
+|      Parameter       |     Type      |  Default   |                                                Description                                                 |
+| :------------------: | :-----------: | :--------: | :--------------------------------------------------------------------------------------------------------: |
+|       **name**       |   _string_    | _Required_ |                                     Layer's name and unique identifier                                     |
+|      **order**       |   _number_    | _Required_ |                                           Layer draw order state                                           |
+|        **on**        |   _boolean_   | _Required_ |                                             Initial visibility                                             |
+|       **path**       |   _string_    | _Required_ |                                    A URL to the raster tileset curtain                                     |
+|     **demPath**      |   _string_    |    null    |                             A URL to the DEM (Digital Elevation Model) tileset                             |
+|      **format**      | _string-enum_ |   'tms'    |                                Raster tileset format ('tms', 'wmts', 'wms )                                |
+|    **demFormat**     |   _string_    |   'tms'    |                                 DEM tileset format ('tms', 'wmts', 'wms )                                  |
+| **demFormatOptions** |   _object_    |    null    |                                             See example below                                              |
+|     **opacity**      |   _number_    | _Required_ |                               Initial opaqueness [0(transparent), 1(opaque)]                               |
+|     **minZoom**      |   _integer_   | _Required_ |                       The minimum (smallest number) zoom level of the raster tileset                       |
+|     **maxZoom**      |   _integer_   | _Required_ |                       The maximum (biggest number) zoom level of the raster tileset                        |
+|     **filters**      |   _object_    |    null    |                                 Filter and blend mode effect for the layer                                 |
+|   **boundingBox**    |  _number[4]_  |    null    | The bounds of the tileset. Only queries for tiles that intersect this box. `[lng, lat, lng, lat] (SW, NE)` |
+|  **boundingBoxEN**   |  _number[4]_  |    null    |     Alternative bounding box in the projected space. `[easting, northing, easting, northing] (min, max)`   |
 
 ### Example
 

diff --git a/docs/pages/Overview/overview.markdown b/docs/pages/Overview/overview.markdown
@@ -40,7 +40,7 @@ Head over to [Getting Started]({{ site.baseurl }}/getting-started) for more, che
     -   Home
     -   Exaggerate
     -   Crop
-    -   Controls
+    -   Navigation
     -   Coordinates
     -   Link
 -   A stub to create parsers for your own tiled data formats

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "lithosphere",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "description": "LithoSphere is a GIS JavaScript library for building 3D tile-based globes in the web browser.",
     "author": "Tariq Soliman",
     "license": "Apache-2.0",