# AI-RenderEngine

**Repository Path**: chn-cem/ai-render-engine

## Basic Information

- **Project Name**: AI-RenderEngine
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-25
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI-RenderEngine

基于VTK的3D显示引擎模块 (C++实现)

## 功能特性

- ✅ 批量STL模型导入
- ✅ 3D模型变换（平移、旋转、缩放）
- ✅ 模型拾取（点选和框选）
- ✅ 模型高亮显示
- ✅ 比例尺显示
- ✅ 灯光管理
- ✅ 模型显隐控制

## 架构设计

项目采用三层架构设计：

### 1. 接口层 (Interface Layer)
- `include/interface/RenderEngineAPI.h` - 提供统一的API接口
- `src/interface/RenderEngineAPI.cpp` - API实现

### 2. 业务逻辑层 (Proc Layer)
- `include/proc/ModelManager.h` - 模型管理
- `include/proc/TransformManager.h` - 变换管理
- `include/proc/PickerManager.h` - 拾取管理
- `include/proc/RenderManager.h` - 渲染管理

### 3. 底层实现层 (Core Layer)
- `include/core/ModelLoader.h` - 模型加载器
- `include/core/ModelTransformer.h` - 模型变换器
- `include/core/ModelPicker.h` - 模型拾取器
- `include/core/HighlightHandler.h` - 高亮处理器
- `include/core/LightManager.h` - 灯光管理器
- `include/core/ScaleRuler.h` - 比例尺

## 依赖项

- CMake >= 3.12
- VTK >= 9.0
- C++17 编译器

## 编译

### Windows (Visual Studio)

```bash
mkdir build
cd build
cmake .. -G "Visual Studio 16 2019" -DCMAKE_PREFIX_PATH="C:/VTK-9.2.0/build"
cmake --build . --config Release
```

### Linux/Mac

```bash
mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH="/path/to/vtk/build"
make -j4
```

## 快速开始

```cpp
#include "interface/RenderEngineAPI.h"

int main() {
    // 创建渲染引擎实例
    RenderEngineAPI engine;
    
    // 加载STL模型
    std::string modelId = engine.LoadModel("model.stl");
    
    // 启动渲染窗口
    engine.Start();
    
    return 0;
}
```

## 使用示例

详细示例请参考：
- `examples/BasicUsage.cpp` - 基础功能示例
- `examples/AdvancedFeatures.cpp` - 高级功能示例

## 许可证

MIT License