@deck.gl/geo-layers 8.8.0-alpha.5 → 8.8.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/dist/dist.dev.js +32562 -62596
  2. package/dist/es5/geo-cell-layer/GeoCellLayer.js.map +1 -1
  3. package/dist/es5/great-circle-layer/great-circle-layer.js +12 -8
  4. package/dist/es5/great-circle-layer/great-circle-layer.js.map +1 -1
  5. package/dist/es5/h3-layers/h3-cluster-layer.js +5 -4
  6. package/dist/es5/h3-layers/h3-cluster-layer.js.map +1 -1
  7. package/dist/es5/h3-layers/h3-hexagon-layer.js +49 -34
  8. package/dist/es5/h3-layers/h3-hexagon-layer.js.map +1 -1
  9. package/dist/es5/index.js.map +1 -1
  10. package/dist/es5/mesh-layer/mesh-layer-fragment.glsl.js +1 -1
  11. package/dist/es5/mesh-layer/mesh-layer-vertex.glsl.js +1 -1
  12. package/dist/es5/mesh-layer/mesh-layer.js +22 -26
  13. package/dist/es5/mesh-layer/mesh-layer.js.map +1 -1
  14. package/dist/es5/mvt-layer/mvt-layer.js +6 -3
  15. package/dist/es5/mvt-layer/mvt-layer.js.map +1 -1
  16. package/dist/es5/quadkey-layer/quadkey-layer.js.map +1 -1
  17. package/dist/es5/s2-layer/s2-geometry.js.map +1 -1
  18. package/dist/es5/s2-layer/s2-layer.js +4 -2
  19. package/dist/es5/s2-layer/s2-layer.js.map +1 -1
  20. package/dist/es5/s2-layer/s2-utils.js.map +1 -1
  21. package/dist/es5/tile-3d-layer/tile-3d-layer.js +31 -16
  22. package/dist/es5/tile-3d-layer/tile-3d-layer.js.map +1 -1
  23. package/dist/es5/tile-layer/tile-layer.js +4 -1
  24. package/dist/es5/tile-layer/tile-layer.js.map +1 -1
  25. package/dist/es5/tile-layer/tileset-2d.js.map +1 -1
  26. package/dist/es5/trips-layer/trips-layer.js +9 -7
  27. package/dist/es5/trips-layer/trips-layer.js.map +1 -1
  28. package/dist/esm/geo-cell-layer/GeoCellLayer.js.map +1 -1
  29. package/dist/esm/great-circle-layer/great-circle-layer.js +7 -3
  30. package/dist/esm/great-circle-layer/great-circle-layer.js.map +1 -1
  31. package/dist/esm/h3-layers/h3-cluster-layer.js +6 -4
  32. package/dist/esm/h3-layers/h3-cluster-layer.js.map +1 -1
  33. package/dist/esm/h3-layers/h3-hexagon-layer.js +38 -24
  34. package/dist/esm/h3-layers/h3-hexagon-layer.js.map +1 -1
  35. package/dist/esm/index.js.map +1 -1
  36. package/dist/esm/mesh-layer/mesh-layer-fragment.glsl.js +1 -1
  37. package/dist/esm/mesh-layer/mesh-layer-fragment.glsl.js.map +1 -1
  38. package/dist/esm/mesh-layer/mesh-layer-vertex.glsl.js +1 -1
  39. package/dist/esm/mesh-layer/mesh-layer-vertex.glsl.js.map +1 -1
  40. package/dist/esm/mesh-layer/mesh-layer.js +15 -17
  41. package/dist/esm/mesh-layer/mesh-layer.js.map +1 -1
  42. package/dist/esm/mvt-layer/mvt-layer.js +6 -3
  43. package/dist/esm/mvt-layer/mvt-layer.js.map +1 -1
  44. package/dist/esm/quadkey-layer/quadkey-layer.js.map +1 -1
  45. package/dist/esm/s2-layer/s2-geometry.js.map +1 -1
  46. package/dist/esm/s2-layer/s2-layer.js +5 -2
  47. package/dist/esm/s2-layer/s2-layer.js.map +1 -1
  48. package/dist/esm/s2-layer/s2-utils.js.map +1 -1
  49. package/dist/esm/tile-3d-layer/tile-3d-layer.js +21 -10
  50. package/dist/esm/tile-3d-layer/tile-3d-layer.js.map +1 -1
  51. package/dist/esm/tile-layer/tile-layer.js +4 -1
  52. package/dist/esm/tile-layer/tile-layer.js.map +1 -1
  53. package/dist/esm/tile-layer/tileset-2d.js.map +1 -1
  54. package/dist/esm/trips-layer/trips-layer.js +8 -5
  55. package/dist/esm/trips-layer/trips-layer.js.map +1 -1
  56. package/dist.min.js +2 -2
  57. package/package.json +17 -15
  58. package/src/geo-cell-layer/GeoCellLayer.ts +4 -3
  59. package/src/great-circle-layer/great-circle-layer.ts +40 -0
  60. package/src/h3-layers/h3-cluster-layer.ts +60 -0
  61. package/src/h3-layers/{h3-hexagon-layer.js → h3-hexagon-layer.ts} +110 -42
  62. package/src/index.ts +5 -0
  63. package/src/mesh-layer/{mesh-layer-fragment.glsl.js → mesh-layer-fragment.glsl.ts} +0 -0
  64. package/src/mesh-layer/mesh-layer-vertex.glsl.ts +80 -0
  65. package/src/mesh-layer/{mesh-layer.js → mesh-layer.ts} +46 -13
  66. package/src/mvt-layer/mvt-layer.ts +5 -3
  67. package/src/quadkey-layer/quadkey-layer.ts +10 -9
  68. package/src/s2-layer/{s2-geometry.js → s2-geometry.ts} +17 -9
  69. package/src/s2-layer/s2-layer.ts +59 -0
  70. package/src/s2-layer/{s2-utils.js → s2-utils.ts} +14 -7
  71. package/src/tile-3d-layer/{tile-3d-layer.js → tile-3d-layer.ts} +107 -36
  72. package/src/tile-layer/tile-layer.ts +8 -7
  73. package/src/tile-layer/tileset-2d.ts +2 -2
  74. package/src/trips-layer/{trips-layer.js → trips-layer.ts} +41 -10
  75. package/typed/geo-cell-layer/GeoCellLayer.d.ts +12 -0
  76. package/typed/geo-cell-layer/GeoCellLayer.d.ts.map +1 -0
  77. package/typed/geo-cell-layer/GeoCellLayer.js +49 -0
  78. package/typed/great-circle-layer/great-circle-layer.d.ts +9 -0
  79. package/typed/great-circle-layer/great-circle-layer.d.ts.map +1 -0
  80. package/{src → typed}/great-circle-layer/great-circle-layer.js +5 -7
  81. package/typed/h3-layers/h3-cluster-layer.d.ts +22 -0
  82. package/typed/h3-layers/h3-cluster-layer.d.ts.map +1 -0
  83. package/typed/h3-layers/h3-cluster-layer.js +33 -0
  84. package/typed/h3-layers/h3-hexagon-layer.d.ts +70 -0
  85. package/typed/h3-layers/h3-hexagon-layer.d.ts.map +1 -0
  86. package/typed/h3-layers/h3-hexagon-layer.js +251 -0
  87. package/typed/index.d.ts +23 -0
  88. package/typed/index.d.ts.map +1 -0
  89. package/typed/index.js +33 -0
  90. package/typed/mesh-layer/mesh-layer-fragment.glsl.d.ts +3 -0
  91. package/typed/mesh-layer/mesh-layer-fragment.glsl.d.ts.map +1 -0
  92. package/typed/mesh-layer/mesh-layer-fragment.glsl.js +55 -0
  93. package/typed/mesh-layer/mesh-layer-vertex.glsl.d.ts +3 -0
  94. package/typed/mesh-layer/mesh-layer-vertex.glsl.d.ts.map +1 -0
  95. package/{src → typed}/mesh-layer/mesh-layer-vertex.glsl.js +0 -0
  96. package/typed/mesh-layer/mesh-layer.d.ts +37 -0
  97. package/typed/mesh-layer/mesh-layer.d.ts.map +1 -0
  98. package/typed/mesh-layer/mesh-layer.js +110 -0
  99. package/typed/mvt-layer/coordinate-transform.d.ts +4 -0
  100. package/typed/mvt-layer/coordinate-transform.d.ts.map +1 -0
  101. package/typed/mvt-layer/coordinate-transform.js +41 -0
  102. package/typed/mvt-layer/find-index-binary.d.ts +12 -0
  103. package/typed/mvt-layer/find-index-binary.d.ts.map +1 -0
  104. package/typed/mvt-layer/find-index-binary.js +96 -0
  105. package/typed/mvt-layer/mvt-layer.d.ts +70 -0
  106. package/typed/mvt-layer/mvt-layer.d.ts.map +1 -0
  107. package/typed/mvt-layer/mvt-layer.js +297 -0
  108. package/typed/package.json +6 -0
  109. package/typed/quadkey-layer/quadkey-layer.d.ts +20 -0
  110. package/typed/quadkey-layer/quadkey-layer.d.ts.map +1 -0
  111. package/typed/quadkey-layer/quadkey-layer.js +18 -0
  112. package/typed/quadkey-layer/quadkey-utils.d.ts +3 -0
  113. package/typed/quadkey-layer/quadkey-utils.d.ts.map +1 -0
  114. package/typed/quadkey-layer/quadkey-utils.js +26 -0
  115. package/typed/s2-layer/s2-geometry.d.ts +11 -0
  116. package/typed/s2-layer/s2-geometry.d.ts.map +1 -0
  117. package/typed/s2-layer/s2-geometry.js +123 -0
  118. package/typed/s2-layer/s2-layer.d.ts +20 -0
  119. package/typed/s2-layer/s2-layer.d.ts.map +1 -0
  120. package/{src → typed}/s2-layer/s2-layer.js +11 -16
  121. package/typed/s2-layer/s2-utils.d.ts +9 -0
  122. package/typed/s2-layer/s2-utils.d.ts.map +1 -0
  123. package/typed/s2-layer/s2-utils.js +88 -0
  124. package/typed/terrain-layer/terrain-layer.d.ts +28 -0
  125. package/typed/terrain-layer/terrain-layer.d.ts.map +1 -0
  126. package/typed/terrain-layer/terrain-layer.js +226 -0
  127. package/typed/tile-3d-layer/tile-3d-layer.d.ts +60 -0
  128. package/typed/tile-3d-layer/tile-3d-layer.d.ts.map +1 -0
  129. package/typed/tile-3d-layer/tile-3d-layer.js +294 -0
  130. package/typed/tile-layer/tile-2d-header.d.ts +40 -0
  131. package/typed/tile-layer/tile-2d-header.d.ts.map +1 -0
  132. package/typed/tile-layer/tile-2d-header.js +113 -0
  133. package/typed/tile-layer/tile-2d-traversal.d.ts +4 -0
  134. package/typed/tile-layer/tile-2d-traversal.d.ts.map +1 -0
  135. package/typed/tile-layer/tile-2d-traversal.js +181 -0
  136. package/typed/tile-layer/tile-layer.d.ts +118 -0
  137. package/typed/tile-layer/tile-layer.d.ts.map +1 -0
  138. package/typed/tile-layer/tile-layer.js +192 -0
  139. package/typed/tile-layer/tileset-2d.d.ts +88 -0
  140. package/typed/tile-layer/tileset-2d.d.ts.map +1 -0
  141. package/typed/tile-layer/tileset-2d.js +399 -0
  142. package/typed/tile-layer/types.d.ts +29 -0
  143. package/typed/tile-layer/types.d.ts.map +1 -0
  144. package/typed/tile-layer/types.js +1 -0
  145. package/typed/tile-layer/utils.d.ts +37 -0
  146. package/typed/tile-layer/utils.d.ts.map +1 -0
  147. package/typed/tile-layer/utils.js +197 -0
  148. package/typed/trips-layer/trips-layer.d.ts +36 -0
  149. package/typed/trips-layer/trips-layer.d.ts.map +1 -0
  150. package/typed/trips-layer/trips-layer.js +92 -0
  151. package/src/h3-layers/h3-cluster-layer.js +0 -43
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@deck.gl/geo-layers",
3
3
  "description": "deck.gl layers supporting geospatial use cases and GIS formats",
4
4
  "license": "MIT",
5
- "version": "8.8.0-alpha.5",
5
+ "version": "8.8.0-beta.2",
6
6
  "publishConfig": {
7
7
  "access": "public"
8
8
  },
@@ -30,19 +30,20 @@
30
30
  "prepublishOnly": "npm run build-bundle && npm run build-bundle -- --env.dev"
31
31
  },
32
32
  "dependencies": {
33
- "@loaders.gl/3d-tiles": "^3.2.0-alpha.4",
34
- "@loaders.gl/gis": "^3.2.0-alpha.4",
35
- "@loaders.gl/loader-utils": "^3.2.0-alpha.4",
36
- "@loaders.gl/mvt": "^3.2.0-alpha.4",
37
- "@loaders.gl/schema": "^3.2.0-alpha.4",
38
- "@loaders.gl/terrain": "^3.2.0-alpha.4",
39
- "@loaders.gl/tiles": "^3.2.0-alpha.4",
40
- "@luma.gl/experimental": "^8.5.13",
41
- "@math.gl/core": "3.6.0-alpha.5",
42
- "@math.gl/culling": "3.6.0-alpha.5",
43
- "@math.gl/web-mercator": "3.6.0-alpha.5",
33
+ "@loaders.gl/3d-tiles": "^3.2.0",
34
+ "@loaders.gl/gis": "^3.2.0",
35
+ "@loaders.gl/loader-utils": "^3.2.0",
36
+ "@loaders.gl/mvt": "^3.2.0",
37
+ "@loaders.gl/schema": "^3.2.0",
38
+ "@loaders.gl/terrain": "^3.2.0",
39
+ "@loaders.gl/tiles": "^3.2.0",
40
+ "@luma.gl/constants": "^8.5.14",
41
+ "@luma.gl/experimental": "^8.5.14",
42
+ "@math.gl/core": "^3.6.0",
43
+ "@math.gl/culling": "^3.6.0",
44
+ "@math.gl/web-mercator": "^3.6.0",
44
45
  "@types/geojson": "^7946.0.8",
45
- "h3-js": "^3.6.0",
46
+ "h3-js": "^3.7.0",
46
47
  "long": "^3.2.0"
47
48
  },
48
49
  "peerDependencies": {
@@ -50,7 +51,8 @@
50
51
  "@deck.gl/extensions": "^8.0.0",
51
52
  "@deck.gl/layers": "^8.0.0",
52
53
  "@deck.gl/mesh-layers": "^8.0.0",
53
- "@loaders.gl/core": "^3.0.0"
54
+ "@loaders.gl/core": "^3.0.0",
55
+ "@luma.gl/core": "^8.0.0"
54
56
  },
55
- "gitHead": "a5e210f62321ab78b7cacbcd0614e0ffcdf6bca7"
57
+ "gitHead": "d9bae59d015387c547366465d75d80950c60a34e"
56
58
  }
@@ -1,11 +1,12 @@
1
- import {CompositeLayer, Layer, LayersList} from '@deck.gl/core';
1
+ import {CompositeLayer, CompositeLayerProps, Layer, LayersList, DefaultProps} from '@deck.gl/core';
2
2
  import {PolygonLayer, PolygonLayerProps} from '@deck.gl/layers';
3
3
 
4
- const defaultProps = {
4
+ const defaultProps: DefaultProps<GeoCellLayerProps> = {
5
5
  ...PolygonLayer.defaultProps
6
6
  };
7
7
 
8
- export type GeoCellLayerProps<DataT = any> = PolygonLayerProps<DataT>;
8
+ /** All properties supported by GeoCellLayer. */
9
+ export type GeoCellLayerProps<DataT = any> = PolygonLayerProps<DataT> & CompositeLayerProps<DataT>;
9
10
 
10
11
  export default class GeoCellLayer<DataT = any, ExtraProps = {}> extends CompositeLayer<
11
12
  Required<GeoCellLayerProps<DataT>> & ExtraProps
@@ -0,0 +1,40 @@
1
+ // Copyright (c) 2015 - 2017 Uber Technologies, Inc.
2
+ //
3
+ // Permission is hereby granted, free of charge, to any person obtaining a copy
4
+ // of this software and associated documentation files (the "Software"), to deal
5
+ // in the Software without restriction, including without limitation the rights
6
+ // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7
+ // copies of the Software, and to permit persons to whom the Software is
8
+ // furnished to do so, subject to the following conditions:
9
+ //
10
+ // The above copyright notice and this permission notice shall be included in
11
+ // all copies or substantial portions of the Software.
12
+ //
13
+ // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14
+ // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15
+ // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16
+ // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17
+ // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18
+ // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19
+ // THE SOFTWARE.
20
+ import {DefaultProps} from '@deck.gl/core';
21
+ import {ArcLayer, ArcLayerProps} from '@deck.gl/layers';
22
+
23
+ const defaultProps: DefaultProps<ArcLayerProps> = {
24
+ getHeight: {type: 'accessor', value: 0},
25
+ greatCircle: true
26
+ };
27
+
28
+ /** All properties supported by GreatCircleLayer. */
29
+ export type GreatCircleLayerProps<DataT = any> = ArcLayerProps<DataT>;
30
+
31
+ // This layer has been merged into the core ArcLayer
32
+ // Keeping for backward-compatibility
33
+ /** @deprecated Use ArcLayer with `greatCircle: true` instead */
34
+ export default class GreatCircleLayer<DataT = any, ExtraProps = {}> extends ArcLayer<
35
+ DataT,
36
+ ExtraProps
37
+ > {
38
+ static layerName = 'GreatCircleLayer';
39
+ static defaultProps: any = defaultProps;
40
+ }
@@ -0,0 +1,60 @@
1
+ import {h3SetToMultiPolygon, H3IndexInput} from 'h3-js';
2
+
3
+ import {AccessorFunction, createIterable, UpdateParameters, DefaultProps} from '@deck.gl/core';
4
+ import GeoCellLayer, {GeoCellLayerProps} from '../geo-cell-layer/GeoCellLayer';
5
+
6
+ const defaultProps: DefaultProps<H3ClusterLayerProps> = {
7
+ getHexagons: {type: 'accessor', value: d => d.hexagons}
8
+ };
9
+
10
+ /** All properties supported by H3ClusterLayer. */
11
+ export type H3ClusterLayerProps<DataT = any> = _H3ClusterLayerProps<DataT> &
12
+ GeoCellLayerProps<DataT>;
13
+
14
+ /** Properties added by H3ClusterLayer. */
15
+ type _H3ClusterLayerProps<DataT> = {
16
+ /**
17
+ * Called for each data object to retrieve the hexagon identifiers.
18
+ *
19
+ * By default, it reads `hexagons` property of data object.
20
+ */
21
+ getHexagons?: AccessorFunction<DataT, H3IndexInput[]>;
22
+ };
23
+
24
+ export default class H3ClusterLayer<DataT = any, ExtraProps = {}> extends GeoCellLayer<
25
+ DataT,
26
+ Required<_H3ClusterLayerProps<DataT>> & ExtraProps
27
+ > {
28
+ static layerName = 'H3ClusterLayer';
29
+ static defaultProps = defaultProps;
30
+
31
+ updateState({props, changeFlags}: UpdateParameters<this>): void {
32
+ if (
33
+ changeFlags.dataChanged ||
34
+ (changeFlags.updateTriggersChanged && changeFlags.updateTriggersChanged.getHexagons)
35
+ ) {
36
+ const {data, getHexagons} = props;
37
+ const polygons: {polygon: number[][][]}[] = [];
38
+
39
+ const {iterable, objectInfo} = createIterable(data);
40
+ for (const object of iterable) {
41
+ objectInfo.index++;
42
+ const hexagons = getHexagons(object, objectInfo);
43
+ const multiPolygon = h3SetToMultiPolygon(hexagons, true);
44
+
45
+ for (const polygon of multiPolygon) {
46
+ polygons.push(this.getSubLayerRow({polygon}, object, objectInfo.index));
47
+ }
48
+ }
49
+
50
+ this.setState({polygons});
51
+ }
52
+ }
53
+
54
+ indexToBounds(): Partial<GeoCellLayer['props']> {
55
+ return {
56
+ data: this.state.polygons,
57
+ getPolygon: d => d.polygon
58
+ };
59
+ }
60
+ }
@@ -6,11 +6,21 @@ import {
6
6
  h3IsPentagon,
7
7
  h3Distance,
8
8
  edgeLength,
9
- UNITS
9
+ H3Index
10
10
  } from 'h3-js';
11
11
  import {lerp} from '@math.gl/core';
12
- import {CompositeLayer, createIterable} from '@deck.gl/core';
13
- import {ColumnLayer, PolygonLayer} from '@deck.gl/layers';
12
+ import {
13
+ AccessorFunction,
14
+ CompositeLayer,
15
+ CompositeLayerProps,
16
+ createIterable,
17
+ Layer,
18
+ LayersList,
19
+ UpdateParameters,
20
+ WebMercatorViewport,
21
+ DefaultProps
22
+ } from '@deck.gl/core';
23
+ import {ColumnLayer, PolygonLayer, PolygonLayerProps} from '@deck.gl/layers';
14
24
 
15
25
  // There is a cost to updating the instanced geometries when using highPrecision: false
16
26
  // This constant defines the distance between two hexagons that leads to "significant
@@ -18,7 +28,7 @@ import {ColumnLayer, PolygonLayer} from '@deck.gl/layers';
18
28
  const UPDATE_THRESHOLD_KM = 10;
19
29
 
20
30
  // normalize longitudes w.r.t center (refLng), when not provided first vertex
21
- export function normalizeLongitudes(vertices, refLng) {
31
+ export function normalizeLongitudes(vertices: number[][], refLng?: number): void {
22
32
  refLng = refLng === undefined ? vertices[0][0] : refLng;
23
33
  for (const pt of vertices) {
24
34
  const deltaLng = pt[0] - refLng;
@@ -31,7 +41,7 @@ export function normalizeLongitudes(vertices, refLng) {
31
41
  }
32
42
 
33
43
  // scale polygon vertices w.r.t center (hexId)
34
- export function scalePolygon(hexId, vertices, factor) {
44
+ export function scalePolygon(hexId: H3Index, vertices: number[][], factor: number): void {
35
45
  const [lat, lng] = h3ToGeo(hexId);
36
46
  const actualCount = vertices.length;
37
47
 
@@ -53,7 +63,7 @@ function getHexagonCentroid(getHexagon, object, objectInfo) {
53
63
  return [lng, lat];
54
64
  }
55
65
 
56
- function h3ToPolygon(hexId, coverage = 1, flatten) {
66
+ function h3ToPolygon(hexId: H3Index, coverage: number = 1): number[][] {
57
67
  const vertices = h3ToGeoBoundary(hexId, true);
58
68
 
59
69
  if (coverage !== 1) {
@@ -64,19 +74,19 @@ function h3ToPolygon(hexId, coverage = 1, flatten) {
64
74
  normalizeLongitudes(vertices);
65
75
  }
66
76
 
67
- if (flatten) {
68
- const positions = new Float64Array(vertices.length * 2);
69
- let i = 0;
70
- for (const pt of vertices) {
71
- positions[i++] = pt[0];
72
- positions[i++] = pt[1];
73
- }
74
- return positions;
75
- }
76
-
77
77
  return vertices;
78
78
  }
79
79
 
80
+ function flattenPolygon(vertices: number[][]): Float64Array {
81
+ const positions = new Float64Array(vertices.length * 2);
82
+ let i = 0;
83
+ for (const pt of vertices) {
84
+ positions[i++] = pt[0];
85
+ positions[i++] = pt[1];
86
+ }
87
+ return positions;
88
+ }
89
+
80
90
  function mergeTriggers(getHexagon, coverage) {
81
91
  let trigger;
82
92
  if (getHexagon === undefined || getHexagon === null) {
@@ -89,7 +99,7 @@ function mergeTriggers(getHexagon, coverage) {
89
99
  return trigger;
90
100
  }
91
101
 
92
- const defaultProps = {
102
+ const defaultProps: DefaultProps<H3HexagonLayerProps> = {
93
103
  ...PolygonLayer.defaultProps,
94
104
  highPrecision: 'auto',
95
105
  coverage: {type: 'number', min: 0, max: 1, value: 1},
@@ -98,8 +108,39 @@ const defaultProps = {
98
108
  extruded: true
99
109
  };
100
110
 
101
- // not supported
102
- delete defaultProps.getLineDashArray;
111
+ /** All properties supported by H3HexagonLayer */
112
+ export type H3HexagonLayerProps<DataT = any> = _H3HexagonLayerProps<DataT> &
113
+ PolygonLayerProps<DataT> &
114
+ CompositeLayerProps<DataT>;
115
+
116
+ /** Props added by the H3HexagonLayer */
117
+ type _H3HexagonLayerProps<DataT> = {
118
+ /**
119
+ * Whether or not draw hexagons with high precision.
120
+ * @default 'auto'
121
+ */
122
+ highPrecision?: boolean | 'auto';
123
+ /**
124
+ * Coverage of hexagon in cell.
125
+ * @default 1
126
+ */
127
+ coverage?: number;
128
+ /**
129
+ * Center hexagon that best represents the shape of the set. If not specified, the hexagon closest to the center of the viewport is used.
130
+ */
131
+ centerHexagon?: H3Index | null;
132
+ /**
133
+ * Called for each data object to retrieve the quadkey string identifier.
134
+ *
135
+ * By default, it reads `hexagon` property of data object.
136
+ */
137
+ getHexagon?: AccessorFunction<DataT, string>;
138
+ /**
139
+ * Whether to extrude polygons.
140
+ * @default true
141
+ */
142
+ extruded?: boolean;
143
+ };
103
144
 
104
145
  /**
105
146
  * A subclass of HexagonLayer that uses H3 hexagonIds in data objects
@@ -112,40 +153,61 @@ delete defaultProps.getLineDashArray;
112
153
  * even when no corresponding hexagon is in the data set. You can check
113
154
  * index !== -1 to see if picking matches an actual object.
114
155
  */
115
- export default class H3HexagonLayer extends CompositeLayer {
116
- shouldUpdateState({changeFlags}) {
156
+ export default class H3HexagonLayer<DataT = any, ExtraPropsT = {}> extends CompositeLayer<
157
+ ExtraPropsT & Required<_H3HexagonLayerProps<DataT> & Required<PolygonLayerProps<DataT>>>
158
+ > {
159
+ static defaultProps = defaultProps;
160
+ static layerName = 'H3HexagonLayer';
161
+
162
+ initializeState() {
163
+ this.state = {
164
+ edgeLengthKM: 0,
165
+ resolution: -1
166
+ };
167
+ }
168
+
169
+ state!: {
170
+ centerHex?: H3Index;
171
+ edgeLengthKM: number;
172
+ hasMultipleRes?: boolean;
173
+ hasPentagon?: boolean;
174
+ resolution: number;
175
+ vertices?: number[][];
176
+ };
177
+
178
+ shouldUpdateState({changeFlags}: UpdateParameters<this>): boolean {
117
179
  return this._shouldUseHighPrecision()
118
180
  ? changeFlags.propsOrDataChanged
119
181
  : changeFlags.somethingChanged;
120
182
  }
121
183
 
122
- updateState({props, oldProps, changeFlags}) {
184
+ updateState({props, changeFlags}: UpdateParameters<this>): void {
123
185
  if (
124
186
  props.highPrecision !== true &&
125
187
  (changeFlags.dataChanged ||
126
- (changeFlags.updateTriggers && changeFlags.updateTriggers.getHexagon))
188
+ (changeFlags.updateTriggersChanged && changeFlags.updateTriggersChanged.getHexagon))
127
189
  ) {
128
- const dataProps = this._calculateH3DataProps(props);
190
+ const dataProps = this._calculateH3DataProps();
129
191
  this.setState(dataProps);
130
192
  }
131
193
 
132
- this._updateVertices(this.context.viewport);
194
+ this._updateVertices(this.context.viewport as WebMercatorViewport);
133
195
  }
134
196
 
135
- _calculateH3DataProps(props) {
197
+ private _calculateH3DataProps() {
136
198
  let resolution = -1;
137
199
  let hasPentagon = false;
138
200
  let hasMultipleRes = false;
139
201
 
140
- const {iterable, objectInfo} = createIterable(props.data);
202
+ const {iterable, objectInfo} = createIterable(this.props.data);
141
203
  for (const object of iterable) {
142
204
  objectInfo.index++;
143
- const hexId = props.getHexagon(object, objectInfo);
205
+ const hexId = this.props.getHexagon(object, objectInfo);
144
206
  // Take the resolution of the first hex
145
207
  const hexResolution = h3GetResolution(hexId);
146
208
  if (resolution < 0) {
147
209
  resolution = hexResolution;
148
- if (!props.highPrecision) break;
210
+ if (!this.props.highPrecision) break;
149
211
  } else if (resolution !== hexResolution) {
150
212
  hasMultipleRes = true;
151
213
  break;
@@ -158,25 +220,28 @@ export default class H3HexagonLayer extends CompositeLayer {
158
220
 
159
221
  return {
160
222
  resolution,
161
- edgeLengthKM: resolution >= 0 ? edgeLength(resolution, UNITS.km) : 0,
223
+ edgeLengthKM: resolution >= 0 ? edgeLength(resolution, 'km') : 0,
162
224
  hasMultipleRes,
163
225
  hasPentagon
164
226
  };
165
227
  }
166
228
 
167
- _shouldUseHighPrecision() {
229
+ private _shouldUseHighPrecision(): boolean {
168
230
  if (this.props.highPrecision === 'auto') {
169
231
  const {resolution, hasPentagon, hasMultipleRes} = this.state;
170
232
  const {viewport} = this.context;
171
233
  return (
172
- viewport.resolution || hasMultipleRes || hasPentagon || (resolution >= 0 && resolution <= 5)
234
+ Boolean(viewport?.resolution) ||
235
+ hasMultipleRes ||
236
+ hasPentagon ||
237
+ (resolution >= 0 && resolution <= 5)
173
238
  );
174
239
  }
175
240
 
176
241
  return this.props.highPrecision;
177
242
  }
178
243
 
179
- _updateVertices(viewport) {
244
+ private _updateVertices(viewport: WebMercatorViewport): void {
180
245
  if (this._shouldUseHighPrecision()) {
181
246
  return;
182
247
  }
@@ -215,11 +280,11 @@ export default class H3HexagonLayer extends CompositeLayer {
215
280
  this.setState({centerHex: hex, vertices});
216
281
  }
217
282
 
218
- renderLayers() {
283
+ renderLayers(): Layer | null | LayersList {
219
284
  return this._shouldUseHighPrecision() ? this._renderPolygonLayer() : this._renderColumnLayer();
220
285
  }
221
286
 
222
- _getForwardProps() {
287
+ private _getForwardProps() {
223
288
  const {
224
289
  elevationScale,
225
290
  material,
@@ -262,16 +327,22 @@ export default class H3HexagonLayer extends CompositeLayer {
262
327
  getElevation: updateTriggers.getElevation,
263
328
  getLineColor: updateTriggers.getLineColor,
264
329
  getLineWidth: updateTriggers.getLineWidth
330
+ } as {
331
+ getFillColor: any;
332
+ getElevation: any;
333
+ getLineColor: any;
334
+ getLineWidth: any;
335
+ getPolygon?: any;
336
+ getPosition?: any;
265
337
  }
266
338
  };
267
339
  }
268
340
 
269
- _renderPolygonLayer() {
341
+ private _renderPolygonLayer(): PolygonLayer {
270
342
  const {data, getHexagon, updateTriggers, coverage} = this.props;
271
343
 
272
344
  const SubLayerClass = this.getSubLayerClass('hexagon-cell-hifi', PolygonLayer);
273
345
  const forwardProps = this._getForwardProps();
274
-
275
346
  forwardProps.updateTriggers.getPolygon = mergeTriggers(updateTriggers.getHexagon, coverage);
276
347
 
277
348
  return new SubLayerClass(
@@ -287,13 +358,13 @@ export default class H3HexagonLayer extends CompositeLayer {
287
358
  positionFormat: 'XY',
288
359
  getPolygon: (object, objectInfo) => {
289
360
  const hexagonId = getHexagon(object, objectInfo);
290
- return h3ToPolygon(hexagonId, coverage, true);
361
+ return flattenPolygon(h3ToPolygon(hexagonId, coverage));
291
362
  }
292
363
  }
293
364
  );
294
365
  }
295
366
 
296
- _renderColumnLayer() {
367
+ private _renderColumnLayer(): ColumnLayer {
297
368
  const {data, getHexagon, updateTriggers} = this.props;
298
369
 
299
370
  const SubLayerClass = this.getSubLayerClass('hexagon-cell', ColumnLayer);
@@ -317,6 +388,3 @@ export default class H3HexagonLayer extends CompositeLayer {
317
388
  );
318
389
  }
319
390
  }
320
-
321
- H3HexagonLayer.defaultProps = defaultProps;
322
- H3HexagonLayer.layerName = 'H3HexagonLayer';
package/src/index.ts CHANGED
@@ -35,7 +35,12 @@ export {default as _Tileset2D} from './tile-layer/tileset-2d';
35
35
  export {default as _Tile2DHeader} from './tile-layer/tile-2d-header';
36
36
 
37
37
  // Types
38
+ export type {H3ClusterLayerProps} from './h3-layers/h3-cluster-layer';
39
+ export type {H3HexagonLayerProps} from './h3-layers/h3-hexagon-layer';
40
+ export type {GreatCircleLayerProps} from './great-circle-layer/great-circle-layer';
41
+ export type {S2LayerProps} from './s2-layer/s2-layer';
38
42
  export type {TileLayerProps} from './tile-layer/tile-layer';
43
+ export type {GeoBoundingBox} from './tile-layer/types';
39
44
  export type {QuadkeyLayerProps} from './quadkey-layer/quadkey-layer';
40
45
  export type {TileLoadProps as _TileLoadProps} from './tile-layer/types';
41
46
  export type {MVTLayerProps} from './mvt-layer/mvt-layer';
@@ -0,0 +1,80 @@
1
+ export default `#version 300 es
2
+ #define SHADER_NAME simple-mesh-layer-vs
3
+
4
+ // Scale the model
5
+ uniform float sizeScale;
6
+ uniform bool composeModelMatrix;
7
+ uniform bool pickFeatureIds;
8
+
9
+ // Primitive attributes
10
+ in vec3 positions;
11
+ in vec3 normals;
12
+ in vec3 colors;
13
+ in vec2 texCoords;
14
+ in vec4 uvRegions;
15
+ in vec3 featureIdsPickingColors;
16
+
17
+ // Instance attributes
18
+ in vec4 instanceColors;
19
+ in vec3 instancePickingColors;
20
+ in mat3 instanceModelMatrix;
21
+
22
+ // Outputs to fragment shader
23
+ out vec2 vTexCoord;
24
+ out vec3 cameraPosition;
25
+ out vec3 normals_commonspace;
26
+ out vec4 position_commonspace;
27
+ out vec4 vColor;
28
+
29
+ vec2 applyUVRegion(vec2 uv) {
30
+ #ifdef HAS_UV_REGIONS
31
+ // https://github.com/Esri/i3s-spec/blob/master/docs/1.7/geometryUVRegion.cmn.md
32
+ return fract(uv) * (uvRegions.zw - uvRegions.xy) + uvRegions.xy;
33
+ #else
34
+ return uv;
35
+ #endif
36
+ }
37
+
38
+ void main(void) {
39
+ vec2 uv = applyUVRegion(texCoords);
40
+ geometry.uv = uv;
41
+
42
+ if (pickFeatureIds) {
43
+ geometry.pickingColor = featureIdsPickingColors;
44
+ } else {
45
+ geometry.pickingColor = instancePickingColors;
46
+ }
47
+
48
+ vTexCoord = uv;
49
+ cameraPosition = project_uCameraPosition;
50
+ vColor = vec4(colors * instanceColors.rgb, instanceColors.a);
51
+
52
+ vec3 pos = (instanceModelMatrix * positions) * sizeScale;
53
+ vec3 projectedPosition = project_position(positions);
54
+ position_commonspace = vec4(projectedPosition, 1.0);
55
+ gl_Position = project_common_position_to_clipspace(position_commonspace);
56
+
57
+ geometry.position = position_commonspace;
58
+ normals_commonspace = project_normal(instanceModelMatrix * normals);
59
+ geometry.normal = normals_commonspace;
60
+
61
+ DECKGL_FILTER_GL_POSITION(gl_Position, geometry);
62
+
63
+ #ifdef MODULE_PBR
64
+ // set PBR data
65
+ pbr_vPosition = geometry.position.xyz;
66
+ #ifdef HAS_NORMALS
67
+ pbr_vNormal = geometry.normal;
68
+ #endif
69
+
70
+ #ifdef HAS_UV
71
+ pbr_vUV = uv;
72
+ #else
73
+ pbr_vUV = vec2(0., 0.);
74
+ #endif
75
+ geometry.uv = pbr_vUV;
76
+ #endif
77
+
78
+ DECKGL_FILTER_COLOR(vColor, geometry);
79
+ }
80
+ `;
@@ -1,11 +1,19 @@
1
+ import type {NumericArray} from '@math.gl/core';
1
2
  import {GLTFMaterialParser} from '@luma.gl/experimental';
2
3
  import {Model, pbr} from '@luma.gl/core';
3
4
  import GL from '@luma.gl/constants';
4
- import {SimpleMeshLayer} from '@deck.gl/mesh-layers';
5
+ import type {MeshAttribute, MeshAttributes} from '@loaders.gl/schema';
6
+ import type {UpdateParameters, DefaultProps} from '@deck.gl/core';
7
+ import {SimpleMeshLayer, SimpleMeshLayerProps} from '@deck.gl/mesh-layers';
5
8
 
6
9
  import vs from './mesh-layer-vertex.glsl';
7
10
  import fs from './mesh-layer-fragment.glsl';
8
11
 
12
+ export type Mesh = {
13
+ attributes: MeshAttributes;
14
+ indices?: MeshAttribute;
15
+ };
16
+
9
17
  function validateGeometryAttributes(attributes) {
10
18
  const hasColorAttribute = attributes.COLOR_0 || attributes.colors;
11
19
  if (!hasColorAttribute) {
@@ -13,13 +21,34 @@ function validateGeometryAttributes(attributes) {
13
21
  }
14
22
  }
15
23
 
16
- const defaultProps = {
17
- // PBR material object. _lighting must be pbr for this to work
24
+ const defaultProps: DefaultProps<MeshLayerProps> = {
18
25
  pbrMaterial: {type: 'object', value: null},
19
26
  featureIds: {type: 'array', value: null, optional: true}
20
27
  };
21
28
 
22
- export default class _MeshLayer extends SimpleMeshLayer {
29
+ /** All properties supported by MeshLayer. */
30
+ export type MeshLayerProps<DataT = any> = _MeshLayerProps<DataT> & SimpleMeshLayerProps<DataT>;
31
+
32
+ /** Properties added by MeshLayer. */
33
+ type _MeshLayerProps<DataT> = {
34
+ /**
35
+ * PBR material object. _lighting must be pbr for this to work
36
+ */
37
+ pbrMaterial?: any; // TODO add type when converting Tile3DLayer
38
+
39
+ /**
40
+ * List of feature ids.
41
+ */
42
+ featureIds?: NumericArray | null;
43
+ };
44
+
45
+ export default class MeshLayer<DataT = any, ExtraProps = {}> extends SimpleMeshLayer<
46
+ DataT,
47
+ Required<_MeshLayerProps<DataT>> & ExtraProps
48
+ > {
49
+ static layerName = 'MeshLayer';
50
+ static defaultProps = defaultProps;
51
+
23
52
  getShaders() {
24
53
  const shaders = super.getShaders();
25
54
  const modules = shaders.modules;
@@ -31,20 +60,25 @@ export default class _MeshLayer extends SimpleMeshLayer {
31
60
  const {featureIds} = this.props;
32
61
  super.initializeState();
33
62
 
63
+ const attributeManager = this.getAttributeManager();
34
64
  if (featureIds) {
35
- this.state.attributeManager.add({
65
+ // attributeManager is always defined in a primitive layer
66
+ attributeManager!.add({
36
67
  featureIdsPickingColors: {
37
68
  type: GL.UNSIGNED_BYTE,
38
69
  size: 3,
39
70
  noAlloc: true,
71
+ // eslint-disable-next-line @typescript-eslint/unbound-method
40
72
  update: this.calculateFeatureIdsPickingColors
41
73
  }
42
74
  });
43
75
  }
44
76
  }
45
77
 
46
- updateState({props, oldProps, changeFlags}) {
47
- super.updateState({props, oldProps, changeFlags});
78
+ updateState(params: UpdateParameters<this>) {
79
+ super.updateState(params);
80
+
81
+ const {props, oldProps} = params;
48
82
  if (props.pbrMaterial !== oldProps.pbrMaterial) {
49
83
  this.updatePbrMaterialUniforms(props.pbrMaterial);
50
84
  }
@@ -57,14 +91,15 @@ export default class _MeshLayer extends SimpleMeshLayer {
57
91
  }
58
92
  this.state.model.setUniforms({
59
93
  // Needed for PBR (TODO: find better way to get it)
94
+ // eslint-disable-next-line camelcase
60
95
  u_Camera: this.state.model.getUniforms().project_uCameraPosition,
61
- u_pickFeatureIds: Boolean(featureIds)
96
+ pickFeatureIds: Boolean(featureIds)
62
97
  });
63
98
 
64
99
  super.draw(opts);
65
100
  }
66
101
 
67
- getModel(mesh) {
102
+ protected getModel(mesh: Mesh): Model {
68
103
  const {id, pbrMaterial} = this.props;
69
104
  const materialParser = this.parseMaterial(pbrMaterial, mesh);
70
105
  const shaders = this.getShaders();
@@ -110,7 +145,8 @@ export default class _MeshLayer extends SimpleMeshLayer {
110
145
  }
111
146
 
112
147
  calculateFeatureIdsPickingColors(attribute) {
113
- const {featureIds} = this.props;
148
+ // This updater is only called if featureIds is not null
149
+ const featureIds = this.props.featureIds!;
114
150
  const value = new Uint8ClampedArray(featureIds.length * attribute.size);
115
151
 
116
152
  const pickingColor = [];
@@ -125,6 +161,3 @@ export default class _MeshLayer extends SimpleMeshLayer {
125
161
  attribute.value = value;
126
162
  }
127
163
  }
128
-
129
- _MeshLayer.layerName = '_MeshLayer';
130
- _MeshLayer.defaultProps = defaultProps;