# RapidCAX

**Repository Path**: anycad/RapidCAX

## Basic Information

- **Project Name**: RapidCAX
- **Description**: AnyCAD Rapid .NET数据管理模块功能展示
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://www.anycad.cn
- **GVP Project**: No

## Statistics

- **Stars**: 45
- **Forks**: 22
- **Created**: 2021-01-23
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: cad

**Tags**: WPF, Net6, 数据管理, cad, CAM

## README

# RapidCAX UI Framework

基于.NET8和WPF的CAD/CAE/CAM界面框架，采用MVVM架构，界面风格参考Autodesk Fusion。

## 功能特性

- ✅ **Fusion 风格界面** - 现代化深色主题 Ribbon 界面
- ✅ **MVVM 架构** - 完全解耦的视图、ViewModel 和模型层
- ✅ **AnyCAD 集成** - 支持 AnyCAD Rapid .NET 控件作为三维查看器
- ✅ **模块化设计** - 可扩展的插件化架构
- ✅ **命令系统** - 基于 CommunityToolkit.Mvvm 的命令实现

## 项目结构

```
RapidCAX/
├── src/
│   ├── RapidCAX.App/          # 主应用程序（WPF）
│   │   ├── App.xaml           # 应用程序入口
│   │   └── Views/
│   │       └── MainWindow.xaml # 主窗口（Fusion 风格）
│   ├── RapidCAX.ViewModel/    # ViewModel 层
│   │   └── MainWindowViewModel.cs
│   ├── RapidCAX.View/         # 视图层
│   │   ├── Controls/
│   │   │   └── RapidView3D.cs # AnyCAD 三维视图包装器
│   │   └── Themes/
│   │       └── FusionTheme.xaml # Fusion 主题资源
│   └── RapidCAX.Common/       # 公共组件
└── RapidCAX.sln               # Visual Studio 解决方案
```

## 环境依赖

### 必需
- **.NET 8 SDK** - [下载链接](https://dotnet.microsoft.com/download/dotnet/8.0)
- **Visual Studio 2022** - 包含 C++ 运行时库支持
- **VS2022 C++ 运行时库** - 部署时需要

### AnyCAD Rapid .NET SDK
本项目使用 AnyCAD Rapid .NET 控件作为三维引擎。您需要：

1. 从 [AnyCAD 官网](http://www.anycad.cn) 获取 Rapid .NET SDK
2. 将 DLL 文件放置到 `libs/AnyCAD/Rapid/` 目录：
   ```
   libs/
   └── AnyCAD/
       └── Rapid/
           ├── AnyCAD.Rapid.dll
           └── AnyCAD.Rapid.WPF.dll
   ```

3. 或者在项目中通过 NuGet 安装（如果有官方包）

## 快速开始

### 1. 克隆项目
```bash
git clone <repository-url>
cd RapidCAX
```

### 2. 准备 AnyCAD SDK
确保已将 AnyCAD Rapid .NET SDK 放置到正确位置，或修改项目文件中的引用路径。

### 3. 还原 NuGet 包
```bash
dotnet restore
```

### 4. 编译项目
```bash
dotnet build
```

### 5. 运行应用
```bash
dotnet run --project src/RapidCAX.App/RapidCAX.App.csproj
```

或使用 Visual Studio:
1. 打开 `RapidCAX.sln`
2. 设置 `RapidCAX.App` 为启动项目
3. 按 F5 运行

## 主要功能

### Ribbon 界面
- 主页、建模、视图、工具等选项卡
- 快速访问工具栏
- Application Menu（文件菜单）

### 三维视图区域
- 集成 AnyCAD Rapid .NET 控件
- 支持基本体创建（球体、立方体、圆柱体）
- 模型导入/导出
- 视图控制（缩放、旋转、平移）

### 项目浏览器
- 场景树管理
- 相机、灯光、几何体组织

## 自定义主题

Fusion 主题定义在 `src/RapidCAX.View/Themes/FusionTheme.xaml` 中，您可以修改以下配色：

```xaml
<SolidColorBrush x:Key="FusionDarkBackground" Color="#1E1E1E"/>
<SolidColorBrush x:Key="FusionAccent" Color="#007ACC"/>
<!-- 更多颜色定义 -->
```

## 开发指南

### 添加新的 Ribbon 选项卡

在 `MainWindow.xaml` 中添加：

```xaml
<fluent:RibbonTabItem Header="您的选项卡">
    <fluent:RibbonGroupBox Header="功能组">
        <fluent:Button Header="按钮" Command="{Binding YourCommand}"/>
    </fluent:RibbonGroupBox>
</fluent:RibbonTabItem>
```

### 添加新的 ViewModel 命令

在 `MainWindowViewModel.cs` 中：

```csharp
[RelayCommand]
private void YourNewCommand()
{
    // 实现逻辑
}
```

### 使用 AnyCAD API

通过 `RapidView3D` 控件调用 AnyCAD 功能：

```csharp
// XAML 中
<view:RapidView3D x:Name="view3D" />

// C# 代码中
view3D.CreateSphere(50, 0, 0, 0);
view3D.LoadModel("model.step");
```

## 示例代码

### 创建基本体

```csharp
// 创建球体
rapidView3D.CreateSphere(radius: 50, x: 0, y: 0, z: 0);

// 创建立方体
rapidView3D.CreateBox(width: 100, height: 100, depth: 100, x: 0, y: 0, z: 0);

// 创建圆柱体
rapidView3D.CreateCylinder(radius: 30, height: 100, x: 0, y: 0, z: 0);
```

### 加载模型文件

```csharp
// 支持 STEP, IGES, STL 等格式
rapidView3D.LoadModel("path/to/model.step");
```

## 常见问题

### Q: AnyCAD 控件无法加载？
A: 确保已正确安装 AnyCAD Rapid .NET SDK，并且 DLL 引用路径正确。

### Q: 如何更改主题颜色？
A: 修改 `FusionTheme.xaml` 中的颜色资源定义。

### Q: 能否使用其他三维引擎？
A: 可以。替换 `RapidView3D` 控件的实现即可，MVVM 架构保证了良好的解耦性。

## 参考资源

- [AnyCAD 官方网站](http://www.anycad.cn)
- [Fluent.Ribbon 文档](https://fluentribbon.net/)
- [CommunityToolkit.Mvvm 文档](https://docs.microsoft.com/dotnet/communitytoolkit/mvvm/)
- [.NET 8 文档](https://docs.microsoft.com/dotnet/core/dotnet-8)

## 许可证

本项目采用 MIT 许可证。

## 联系方式

如有问题或建议，欢迎提交 Issue。

---

**注意**: 本项目的三维功能依赖 AnyCAD Rapid .NET SDK，该 SDK 可能需要单独授权。请遵守 AnyCAD 的许可协议。