#xgis-cesium


<p>
<a href="https://www.npmjs.com/package/xgis-cesium"  target="_blank"> 
<img src="https://img.shields.io/npm/v/xgis-cesium?color=orange&logo=npm" />
</a>
<a href="https://www.npmjs.com/package/xgis-cesium"  target="_blank"> 
<img src="https://img.shields.io/npm/dt/xgis-cesium?logo=npm"/>
</a>
<a href="https://zorrowm.github.io/api-doc/xgis-cesium/index.html" target="_blank"> 
<img src="https://img.shields.io/badge/docs-online-yellow.svg"/>
</a>
</p>

> `xgis-cesium` is an internally customized version based on @cesium/engine, incorporating project experience.Free for non-commercial projects; commercial applications require a license key.

[ReadMe中文](https://share.note.youdao.com/s/GRpyYNZS)|[Update Log中文](https://share.note.youdao.com/s/QWsZrCbX)|[Development Sample Code](https://share.note.youdao.com/s/AqrDtpBz)

---

`xgis-cesium-mars3d` is a version based on mars3d-cesium, used to support integration with mars3d. https://www.npmjs.com/package/xgis-cesium-mars3d

---
## Main Features

- The core XViewer is an implementation that extends Cesium.CesiumWidget.

- Basic layer management, supporting multiple map basemaps.

- Layer tree management function.

- 3D plotting function.

- Spatial analysis function (adding support based on WebWorker).

- Weather (snow effect).

- 3D vector annotation.

- WebWorker applications: turfWorker, etc.

- RouteFlight enables multi-drone flight.

## Installation

`npm i xgis-cesium`

No need to install `@cesium/engine` separately.

Requires importing library styles:

`import 'xgis-cesium/dist/index.css'`

Install the vite plugin.

`npm i vite-plugin-xgis-cesium -D`

```ts
import { defineConfig } from 'vite';

import xgisCesiumPlugin from 'vite-plugin-xgis-cesium';

export default defineConfig({
plugins: [xgisCesiumPlugin()]

});
```


Development example address: https://zorrowm.github.io/3d/#/product/index

------

## Feature Example Screenshots

![3D Layer Management](https://zorrowm.github.io/npm/layermanage.png)

![3D Plotting](https://zorrowm.github.io/npm/plot3d.png)

![Viewport Analysis](https://zorrowm.github.io/npm/Analysis1.png)

![Model Mesh and Clipping](https://zorrowm.github.io/npm/Analysis2.png)

![Slope and Aspect Calculation](https://zorrowm.github.io/npm/Analysis3.png)

![Model Flattening - Dayanta Pagoda](https://zorrowm.github.io/npm/dayanta_flat.png)

![Terrain Flattening](https://zorrowm.github.io/npm/terrain_flat.png)

![Model Snow Effect](https://zorrowm.github.io/npm/snowCover.png)

![3D Annotation](https://zorrowm.github.io/npm/vector_annotation.png)

![Vector Annotation 2](https://zorrowm.github.io/npm/vector_annotation2.png)

![Contour Line Extraction Progress](https://zorrowm.github.io/npm/analysis-progress.png)

![LabelGeojsonLayer](https://zorrowm.github.io/npm/labelGeojsonLayer.jpg)

![RouteFlight](https://zorrowm.github.io/npm/multiflight.png)

![Multi-flight Collision Mesh Detection](https://zorrowm.github.io/npm/multicollision.png)

------

## Copyright Notice

> xgis-cesium is a 3D GIS development framework library based on @cesium/engine.

> Copyright (c) 2026-2030 Wuhenke. All rights reserved.

> Developer: zorrowm@126.com

> NPM Address: https://www.npmjs.com/package/xgis-cesium

> License Notice:

> 1. Free use in non-commercial projects is permitted, provided the license information and copyright logo are retained.

> 2. We are not responsible for any issues arising from unauthorized free use.

> 3. We only provide technical support to users of the commercial license version.

> 4. We reserve the right to the final interpretation of this copyright information.

> Unauthorized modification of the package or removal of the copyright notice is prohibited!

## Related Resources

[xgis-bdgrid](https://www.npmjs.com/package/xgis-bdgrid)

[xframelib](https://www.npmjs.com/package/xframelib)

[xgis-ol](https://www.npmjs.com/package/xgis-ol)