Skip to content

Commit

Permalink
Content and Polish for Whats New 7.0 (#3001)
Browse files Browse the repository at this point in the history
  • Loading branch information
tgorkin committed Apr 19, 2019
1 parent 1150bc8 commit caeff6d
Show file tree
Hide file tree
Showing 2 changed files with 56 additions and 20 deletions.
16 changes: 8 additions & 8 deletions docs/upgrade-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@

#### Submodule Structure and Dependency Changes

- `@deck.gl/core` is moved from `dependencies` to `devDependencies` for all submodules. This will reduce the runtime error caused by installing multiple copies of the core.
- The master module `deck.gl` now include all submodules except `@deck.gl/test-utils`. See [list of submodules](/docs/get-started/getting-started.md#selectively-install-dependencies) for details.
- `ContourLayer`, `GridLayer`, `HexagonLayer` and `ScreenGridLayer` are moved from `@deck.gl/layers` to `@deck.gl/aggregation-layers`. No action is required if you are importing them from `deck.gl`.
- `@deck.gl/experimental-layers` is deprecated. Experimental layers will be exported from their respective modules with a `_` prefix.
+ `BitmapLayer` is moved to `@deck.gl/layers`.
+ `MeshLayer` is renamed to `SimpleMeshLayer` and moved to `@deck.gl/mesh-layers`.
+ `TileLayer` and `TripsLayer` are moved to `@deck.gl/geo-layers`.
- ` @deck.gl/core` is moved from `dependencies` to `devDependencies` for all submodules. This will reduce the runtime error caused by installing multiple copies of the core.
- The master module `deck.gl` now include all submodules except ` @deck.gl/test-utils`. See [list of submodules](/docs/get-started/getting-started.md#selectively-install-dependencies) for details.
- `ContourLayer`, `GridLayer`, `HexagonLayer` and `ScreenGridLayer` are moved from ` @deck.gl/layers` to ` @deck.gl/aggregation-layers`. No action is required if you are importing them from `deck.gl`.
- ` @deck.gl/experimental-layers` is deprecated. Experimental layers will be exported from their respective modules with a `_` prefix.
+ `BitmapLayer` is moved to ` @deck.gl/layers`.
+ `MeshLayer` is renamed to `SimpleMeshLayer` and moved to ` @deck.gl/mesh-layers`.
+ `TileLayer` and `TripsLayer` are moved to ` @deck.gl/geo-layers`.

#### Deck Class

Expand Down Expand Up @@ -63,7 +63,7 @@ Deprecations:

#### React

If you are using DeckGL with react-map-gl, `@deck.gl/react@^7.0.0` no longer works with react-map-gl v3.x.
If you are using DeckGL with react-map-gl, ` @deck.gl/react@^7.0.0` no longer works with react-map-gl v3.x.


## Upgrading from deck.gl v6.3 to v6.4
Expand Down
60 changes: 48 additions & 12 deletions docs/whats-new.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,36 +4,60 @@ This page contains highlights of each deck.gl release. Also check our [vis.gl bl

## deck.gl v7.0

Target Release Date: Mar, 2019

### New Effects System

A new effects system is written from the ground up for v7.0. This opens the possibilities for many exciting visual effect features down the road. As a start, we're introducing [LightingEffect](/docs/effects/lighting-effect.md) - an easier, more comprehensive way to control the lighting for your layers.
Release Date: April 19, 2019

### New Layer Catalog

<table style="border: 0;" align="center">
<tbody>
<tr>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/bitmap-layer.png" />
<p><i>BitmapLayer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/column-layer.png" />
<p><i>ColumnLayer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/tile-layer.gif" />
<p><i>TileLayer</i></p>
</td>
</tr>
<tr>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/s2-layer.png" />
<p><i>S2Layer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/h3-layer.png" />
<p><i>H3HexagonLayer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/h3-cluster-layer.png" />
<p><i>H3ClusterLayer</i></p>
</td>
</tr>
<tr>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/trips-layer.gif" />
<p><i>TripsLayer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/mesh-layer.gif" />
<p><i>ScenegraphLayer</i></p>
</td>
<td>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/tile-layer.jpg" />
<p><i>TileLayer</i></p>
<img height=200 src="https://raw.github.com/uber-common/deck.gl-data/master/images/whats-new/great-circle-layer.png" />
<p><i>GreatCircleLayer</i></p>
</td>
</tr>
</tbody>
</table>

As the number of deck.gl layers grow, we are splitting existing and new layers into multiple submodules for better dependency management. These new layer modules are:

* `@deck.gl/layers` - Primitive layers that are the building blocks of all visualizations
* ` @deck.gl/layers` - Primitive layers that are the building blocks of all visualizations
- [ArcLayer](/docs/layers/arc-layer.md)
- [BitmapLayer](/docs/layers/bitmap-layer.md) **<sup>New</sup>**
- [ColumnLayer](/docs/layers/column-layer.md) **<sup>New</sup>**
Expand All @@ -47,23 +71,35 @@ As the number of deck.gl layers grow, we are splitting existing and new layers i
- [ScatterplotLayer](/docs/layers/scatterplot-layer.md)
- [SolidPolygonLayer](/docs/layers/solid-polygon-layer.md)
- [TextLayer](/docs/layers/text-layer.md)
* `@deck.gl/aggregation-layers` - Advanced layers that aggregate data into alternative representations, e.g. heatmap, contour, hex bins, etc.
* ` @deck.gl/aggregation-layers` - Advanced layers that aggregate data into alternative representations, e.g. heatmap, contour, hex bins, etc.
- [ContourLayer](/docs/layers/contour-layer.md)
- [GPUGridLayer](/docs/layers/gpu-grid-layer.md)
- [GridLayer](/docs/layers/grid-layer.md)
- [HexagonLayer](/docs/layers/hexagon-layer.md)
- [ScreenGridLayer](/docs/layers/screen-grid-layer.md)
* `@deck.gl/geo-layers` - Additional layers that handle geospatial use cases and GIS formats.
* ` @deck.gl/geo-layers` - Additional layers that handle geospatial use cases and GIS formats.
- [GreatCircleLayer](/docs/layers/great-circle-layer.md) **<sup>New</sup>**
- [H3ClusterLayer](/docs/layers/h3-cluster-layer.md) **<sup>New</sup>**
- [H3HexagonLayer](/docs/layers/h3-hexagon-layer.md) **<sup>New</sup>**
- [S2Layer](/docs/layers/s2-layer.md) **<sup>New</sup>**
- [TileLayer](/docs/layers/tile-layer.md) **<sup>New</sup>**
- [TripsLayer](/docs/layers/trips-layer.md) **<sup>New</sup>**
* `@deck.gl/mesh-layers` - Additional layers that render 3D meshes and [scene graphs](https://en.wikipedia.org/wiki/Scene_graph).
* ` @deck.gl/mesh-layers` - Additional layers that render 3D meshes and [scene graphs](https://en.wikipedia.org/wiki/Scene_graph).
- [SimpleMeshLayer](/docs/layers/simple-mesh-layer.md) **<sup>New</sup>**
- [ScenegraphLayer](/docs/layers/scenegraph-layer.md) **<sup>New</sup>**

### glTF Support and Loaders.gl

<img height=150 src="https://raw.github.com/uber-common/deck.gl-data/master/images/gltf.png" />

The new [ScenegraphLayer](/docs/layers/scenegraph-layer.md) and [SimpleMeshLayer](/docs/layers/simple-mesh-layer.md) support loading 3D models and scenegraphs in the popular [glTF™](https://www.khronos.org/gltf/) asset format. glTF is a royalty-free specification for the efficient transmission and loading of 3D assets, with a rich ecosystem of tools and extensions. All variants of glTF 2.0 are supported, including binary `.glb` files as well as JSON `.gltf` files with binary assets in base64 encoding or in separate files.

We are releasing [loaders.gl](https://uber-web.github.io/loaders.gl/) as a major new companion framework to deck.gl and luma.gl. Loaders.gl provides a suite of 3D file format loaders. See [What's New in luma.gl v7.0](https://github.com/uber/luma.gl/blob/master/docs/whats-new.md) for more details.

### New Effects System

A new effects system is written from the ground up for v7.0. This opens the possibilities for many exciting visual effect features down the road. As a start, we're introducing [LightingEffect](/docs/effects/lighting-effect.md) - an easier, more comprehensive way to control the lighting for your layers.

### Layer API

* **Binary data support**: In v7.0 we are making binary data a first-class citizen of deck.gl. Whereas the `data` prop of layers only accepted JavaScript arrays in the past, you may now provide a non-iterable object to `data`. See [example](/docs/developer-guide/performance.md#on-using-binary-data).
Expand All @@ -79,7 +115,7 @@ Starting v7.0, deck.gl has experimental support for Google Maps with the [@deck.

### Improved Test Utilities

The `@deck.gl/test-utils` module is revamped with two new exports:
The ` @deck.gl/test-utils` module is revamped with two new exports:
* `generateLayerTests` - automatically create test cases for use with [`testLayer`](/docs/api-reference/test-utils/test-layer.md) to test layer conformance.
* `SnapshotTestRunner` - automated integration test for WebGL. Renders deck.gl layers, takes screenshot and compare with golden images in headless Chromium.

Expand Down

0 comments on commit caeff6d

Please sign in to comment.