xiaozhongwei / cesium-sensor-volumes Goto Github PK

cesium-sensors: A Cesium plugin for visualizing sensor volumes.

Cesium version: Tested against 1.6. Post a message to the Cesium forum if you have compatibility issues.

License: Apache 2.0. Free for commercial and non-commercial use. See LICENSE.md.

Usage

Prebuilt minified and unminified versions of the plugin are in the Build directory. Include the CesiumSensors.js file using a script tag after the Cesium.js script tag.

The plugin automatically adds support for the CZML properties agi_conicSensor, agi_customPatternSensor, and agi_rectangularSensor. The corresponding Entity properties are conicSensor, customPatternSensor, and rectangularSensor.

In order to load data directly into Entity objects that you create directly, you must call entity.addProperty to create each of the sensor properties you wish to use. The CZML processing does this automatically.

<script src="path/to/Cesium.js"></script>
<script src="path/to/CesiumSensors.js"></script>
<script>
// To create an entity directly
var entityCollection = new Cesium.EntityCollection();

var entity = entityCollection.getOrCreateEntity('test');
entity.addProperty('conicSensor');

// configure other entity properties, e.g. position and orientation...

entity.conicSensor = new CesiumSensors.ConicSensorGraphics();
entity.conicSensor.intersectionColor = new Cesium.ConstantProperty(new Cesium.Color(0.1, 0.2, 0.3, 0.4));
</script>

Example

Simple examples are included in the Examples folder. To run locally, run npm install, then run node server.js and navigate to http://localhost:8080 and select the example application to run.

Build

To build, run npm install, then run node build.js.

Contributions

Contributions welcome. We use the same CLA as Cesium. Please email yours before opening a pull request.