# cesium-three-base

**Repository Path**: drm/cesium-three-base

## Basic Information

- **Project Name**: cesium-three-base
- **Description**: 一个结合Cesium和Three.js的开源项目，旨在为开发者提供强大的3D地球和地图渲染能力，适用于地理信息可视化、虚拟现实等场景。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cesium + ThreeBase 集成调研项目

本项目专门用于研究 Cesium 和 ThreeBase 的结合使用，包含一个简单的演示页面和后端基础结构。

## 技术栈

- **前端**: React 18 + Vite + Cesium + Three.js + ThreeBase
- **后端**: Node.js + Express + Sequelize (基础骨架)

## 项目结构

```
srcWeb/pages/CesiumThreeBase/   # Cesium + ThreeBase 核心代码
  ├── CesiumThreeBase.tsx        # React 页面组件
  ├── cesiumThreeBaseRenderer.ts  # 核心渲染器（继承 ThreeBase）
  └── cesiumThreeBase.module.less # 样式

public/
  ├── cesium/                    # Cesium 静态资源
  └── models/                   # 3D 模型文件

srcService/                      # 后端基础结构
  ├── service.ts                 # 服务入口
  ├── component/database.ts      # 数据库配置
  └── services/ServiceBase.ts   # 服务基类
```

## 快速开始

### 安装依赖

```bash
npm install
```

### 启动前端开发服务器

```bash
npm run dev
```

访问: http://localhost:5001/

### 启动后端服务

```bash
npm run server
```

### 生产构建

```bash
npm run build
```

## 核心文件说明

### cesiumThreeBaseRenderer.ts

这是最核心的文件，继承了 ThreeBase，实现了 Cesium 与 Three.js 的集成。主要功能是：
- 在 Cesium 场景中嵌入 Three.js 物体
- 同步 Cesium 相机与 Three.js 场景
- 处理坐标转换

### CesiumThreeBase.tsx

演示页面，展示了如何使用 cesiumThreeBaseRenderer。

## 依赖说明

- `cesium`: ^1.142.0 - Cesium 三维地球库
- `three`: 0.167.0 - Three.js 3D 渲染库
- `three-base`: ^2.0.137 - ThreeBase，用于 Cesium 与 Three.js 集成
- `vite-plugin-cesium`: ^1.2.23 - Vite Cesium 插件

## 注意事项

1. Cesium 需要静态资源支持，请确保 `public/cesium/` 目录存在
2. 3D 模型文件放在 `public/models/` 目录
3. 后端仅保留基础骨架，可根据需要添加业务服务