cesium4lae

Planning, Design and Review frontend framework for Low Attitude Economics using Cesium

Cesium Drawing Library

The Cesium Drawing Library is a powerful extension for the Cesium JavaScript library that enables interactive drawing and editing capabilities for various geometric entities such as polylines, polygons, extruded polygons, and corridors. This library simplifies the process of creating and manipulating these entities within a Cesium viewer.

Features

• Extend Cesium entities with drawing and editing capabilities
• Create draggable control points for intuitive editing
• Support for polylines, polygons, extruded polygons, and corridors
• Customizable dragging behavior (horizontal and vertical)
• Event-driven architecture for easy integration and customization

Installation

To use the Cesium Drawing Library in your project, follow these steps:

1. Make sure you have Cesium installed and properly configured in your project.
2. Copy the cesiumDrawing.ts file into your project's source directory.
3. Import the necessary modules and classes from the cesiumDrawing.ts file in your project.

Usage

Here's a basic example of how to use the Cesium Drawing Library:

import * as Cesium from 'cesium';
import { CesiumDrawing } from './cesiumDrawing';

// Create a Cesium viewer
const viewer = new Cesium.Viewer('cesiumContainer');

// Create an instance of the Editor
const editor = new CesiumDrawing.Editor(viewer);

// Create a polyline entity
const polyline = viewer.entities.add({
  polyline: {
    positions: Cesium.Cartesian3.fromDegreesArray([/* coordinates */]),
    width: 5,
    material: Cesium.Color.RED
  }
});

// Extend the polyline entity with drawing capabilities
const drawablePolyline = CesiumDrawing.extendEntity(polyline);

// Start editing the polyline
editor.startEditing(drawablePolyline);

// Stop editing the polyline
editor.stopEditing(drawablePolyline);

For more detailed examples and usage instructions, please refer to the documentation and code comments.

API Reference

The Cesium Drawing Library provides the following main classes and functions:

• CesiumDrawing.Editor: The main class for managing the drawing and editing functionality.
• CesiumDrawing.extendEntity: A function to extend a Cesium entity with drawing capabilities.
• CesiumDrawing.PolylineEditor: A class for editing polyline entities.
• CesiumDrawing.PolygonEditor: A class for editing polygon entities.
• CesiumDrawing.ExtrudedPolygonEditor: A class for editing extruded polygon entities.
• CesiumDrawing.CorridorEditor: A class for editing corridor entities.

Please refer to the code comments and type definitions for more details on the available properties, methods, and events of each class.

Contributing

Contributions to the Cesium Drawing Library are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

License

The Cesium Drawing Library is released under the MIT License.