# DWG Color Extractor - Java版本

## 📋 项目概述

这是一个使用 Aspose.CAD for Java 的 DWG 文件特定颜色元素提取器，用于提取颜色为 `(0, 255, 255)` 的所有元素。

## 🔧 环境要求

### Java 环境
- **Java 版本**: 1.8 或更高版本
- **推荐版本**: Java 8 或 Java 11
- **下载地址**: [Oracle Java](https://www.oracle.com/java/technologies/downloads/) 或 [OpenJDK](https://openjdk.org/)

### Maven 环境
- **Maven 版本**: 3.6 或更高版本
- **下载地址**: [Apache Maven](https://maven.apache.org/download.cgi)

## 🚀 快速开始

### 1. 安装Java环境
```bash
# 下载并安装Java 8或11
# 设置JAVA_HOME环境变量
```

### 2. 安装Maven
```bash
# 下载并安装Maven
# 设置MAVEN_HOME环境变量
```

### 3. 编译项目
```bash
mvn clean compile
```

### 4. 运行测试
```bash
mvn exec:java -Dexec.mainClass="DwgColorExtractor"
```

### 5. 打包项目
```bash
mvn clean package
```

## 📁 项目结构

```
problem/java/
├── pom.xml                           # Maven配置文件
├── README.md                         # 项目说明
└── src/
    └── main/
        └── java/
            └── DwgColorExtractor.java # 主程序
```

## 🎯 功能特性

### 核心功能
- **DWG文件加载**: 支持加载DWG文件
- **颜色元素提取**: 提取特定颜色的元素
- **多源数据访问**: 从blocks、entities、layers获取数据
- **详细信息提取**: 获取坐标、图层、可见性等信息

### 输出格式
- **CSV文件**: 便于Excel处理
- **JSON文件**: 便于程序处理
- **统计报告**: 详细的元素统计信息

### 支持的元素类型
- **CadLine**: 直线
- **CadPolyline**: 多段线
- **CadCircle**: 圆形
- **CadArc**: 圆弧

## 📊 使用方法

### 基本使用
1. 将DWG文件放在项目根目录
2. 运行程序：`mvn exec:java -Dexec.mainClass="DwgColorExtractor"`
3. 查看输出目录中的结果文件

### 自定义颜色
修改 `TARGET_COLOR` 常量：
```java
private static final Color TARGET_COLOR = Color.fromArgb(255, 0, 255, 255); // RGB(0, 255, 255)
```

### 输出目录
结果文件保存在 `output/` 目录中：
- `{文件名}_color_elements.csv` - CSV格式数据
- `{文件名}_color_elements.json` - JSON格式数据
- `{文件名}_color_elements_report.txt` - 统计报告

## 🔍 技术细节

### 依赖库
- **Aspose.CAD for Java**: 核心CAD处理库
- **Jackson**: JSON处理
- **OpenCSV**: CSV处理
- **SLF4J**: 日志处理

### API使用
- 使用 `CadImage.load()` 加载DWG文件
- 通过 `getBlocks()`、`getEntities()`、`getLayers()` 访问数据
- 使用反射和类型检查获取元素属性

## 🐛 故障排除

### 常见问题

1. **Java版本不兼容**
   - 确保使用Java 8或更高版本
   - 检查JAVA_HOME环境变量

2. **Maven依赖下载失败**
   - 检查网络连接
   - 尝试使用国内镜像源

3. **DWG文件加载失败**
   - 检查文件路径
   - 确保文件格式正确
   - 检查文件权限

4. **许可证问题**
   - 确保有有效的Aspose.CAD许可证
   - 检查许可证文件路径

### 调试模式
启用详细日志：
```bash
mvn exec:java -Dexec.mainClass="DwgColorExtractor" -Dexec.args="--debug"
```

## 📝 开发说明

### 代码结构
- **main()**: 程序入口点
- **extractColorElements()**: 主要提取逻辑
- **checkElementColor()**: 颜色匹配检查
- **saveToCSV()**: CSV保存功能
- **saveToJSON()**: JSON保存功能
- **createSummaryReport()**: 报告生成功能

### 扩展功能
- 添加新的元素类型支持
- 实现更多颜色匹配算法
- 添加批量处理功能
- 实现GUI界面

## 🔗 相关链接

- [Aspose.CAD for Java 文档](https://docs.aspose.com/cad/java/)
- [Aspose.CAD for Java API 参考](https://reference.aspose.com/cad/java/)
- [Maven 仓库](https://mvnrepository.com/artifact/com.aspose/aspose-cad)
- [Java 8 文档](https://docs.oracle.com/javase/8/docs/)

## 📄 许可证

本项目使用 Aspose.CAD for Java，需要有效的商业许可证。请遵守相关许可证条款。

---

**版本**: 1.0.0  
**最后更新**: 2024-12-19  
**作者**: AI Assistant