# cesium-elevation-gradient

**Repository Path**: cofferlait/cesium-elevation-gradient

## Basic Information

- **Project Name**: cesium-elevation-gradient
- **Description**: An elevation visualizer for Cesium
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-02-24
- **Last Updated**: 2024-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

cesium-elevation-gradient
=========================

**NOTE: Cesium now has built in support for elevation gradients and contours.  See the [Globe Materials](https://cesiumjs.org/Cesium/Build/Apps/Sandcastle/?src=Globe%20Materials.html&label=Showcases) example in the Sandcastle.**

<img src="https://cloud.githubusercontent.com/assets/484870/16941251/53f82342-4dd2-11e6-962b-444d27e11024.jpg" width="535">

An elevation visualiser for [Cesium](https://cesiumjs.org/) acting as an imagery provider.  Elevation samples from a terrain provider are passed to a 2D WebGL renderer.  The renderer then applies a combination of the following algorithms:

* Colour ramp
* Hillshade
* Contour lines

This imagery provider is a contribution to the Cesium community by [Propeller Aerobotics](https://www.propelleraero.com/) and is licensed under the same license as Cesium (Apache 2.0).

Run the test app with a local server
------------------------------------
```
npm install
npm start
```
Then browse to [http://localhost:8080](http://localhost:8080)

Using in your app
-----------------
This code uses GLSL shaders.  It is currently set up to load them using [shader-loader for webpack](https://github.com/makio64/shader-loader).  If you happen to be using webpack on your project then you should be able to...

*  install shader-loader:
```
npm install shader-loader --save-dev
```
* set it up in your webpack.config.js:
```
module: {
    loaders: [{
        test: /\.(glsl|vs|fs)$/,
        loaders: ['shader']
    }]
}
```
* import (or require()) into your app
```
import ElevationGradientImageryProvider from 'cesium-elevation-gradient/lib/ElevationGradientImageryProvider'
```