142 lines
3.5 KiB
Markdown
142 lines
3.5 KiB
Markdown
|
# Utils 工具库模块
|
|||
|
|
|
|||
|
|
这是一个独立的 Qt 工具库模块，包含了项目中常用的基础工具类和实用功能。
|
|||
|
|
|
|||
|
|
## 模块结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Utils/
|
|||
|
|
├── VrCommon/ # 核心接口和数据结构
|
|||
|
|
│ ├── Inc/ # 公共头文件
|
|||
|
|
│ │ ├── VrCommon.h
|
|||
|
|
│ │ ├── VrConfigCmd.h
|
|||
|
|
│ │ └── VrError.h
|
|||
|
|
│ └── Src/ # 源文件
|
|||
|
|
│
|
|||
|
|
├── VrUtils/ # 工具类库
|
|||
|
|
│ ├── Inc/ # 工具类头文件
|
|||
|
|
│ ├── Src/ # 工具类源文件
|
|||
|
|
│ ├── jsoncpp/ # JSON 解析库
|
|||
|
|
│ ├── log4cpp/ # 日志库
|
|||
|
|
│ ├── tinyxml2/ # XML 解析库
|
|||
|
|
│ ├── ini/ # INI 配置文件解析
|
|||
|
|
│ ├── MD5/ # MD5 加密
|
|||
|
|
│ └── crc/ # CRC 校验
|
|||
|
|
│
|
|||
|
|
├── CloudUtils/ # 点云工具
|
|||
|
|
│ ├── Inc/
|
|||
|
|
│ │ ├── LaserDataLoader.h
|
|||
|
|
│ │ └── PointCloudImageUtils.h
|
|||
|
|
│ └── Src/
|
|||
|
|
│
|
|||
|
|
├── DataUtils/ # 数据处理工具
|
|||
|
|
│ ├── CloudMathClac/ # 点云数学计算
|
|||
|
|
│ └── CoordinateTransform/ # 坐标转换
|
|||
|
|
│
|
|||
|
|
└── CloudView/ # 点云查看工具（独立应用）
|
|||
|
|
├── Inc/
|
|||
|
|
├── Src/
|
|||
|
|
└── resource/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构建说明
|
|||
|
|
|
|||
|
|
### 作为子模块构建
|
|||
|
|
|
|||
|
|
在主项目的 .pro 文件中添加：
|
|||
|
|
|
|||
|
|
```qmake
|
|||
|
|
Utils.file = ../Utils/Utils.pro
|
|||
|
|
SUBDIRS += Utils
|
|||
|
|
|
|||
|
|
# 设置依赖关系
|
|||
|
|
YourModule.depends = Utils
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 独立构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd Utils
|
|||
|
|
qmake Utils.pro
|
|||
|
|
make
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 模块说明
|
|||
|
|
|
|||
|
|
### VrCommon
|
|||
|
|
|
|||
|
|
核心接口和数据结构定义，包括：
|
|||
|
|
- 配置接口定义
|
|||
|
|
- 错误码定义
|
|||
|
|
- 配置命令数据结构
|
|||
|
|
|
|||
|
|
### VrUtils
|
|||
|
|
|
|||
|
|
通用工具类库，包括：
|
|||
|
|
- **日志工具**: 基于 log4cpp 的日志系统
|
|||
|
|
- **JSON 解析**: jsoncpp 库
|
|||
|
|
- **XML 解析**: tinyxml2 库
|
|||
|
|
- **INI 配置**: SimpleIni 库
|
|||
|
|
- **加密工具**: MD5、CRC 校验
|
|||
|
|
- **时间工具**: 时间格式化、NTP 同步
|
|||
|
|
- **网络工具**: 网络相关实用函数
|
|||
|
|
- **文件工具**: 文件操作相关函数
|
|||
|
|
- **字符串工具**: 字符串处理函数
|
|||
|
|
|
|||
|
|
### CloudUtils
|
|||
|
|
|
|||
|
|
点云数据处理工具，包括：
|
|||
|
|
- 激光数据加载器
|
|||
|
|
- 点云图像转换工具
|
|||
|
|
|
|||
|
|
### DataUtils
|
|||
|
|
|
|||
|
|
数据处理工具集，包括：
|
|||
|
|
- **CloudMathClac**: 点云数学计算（曲线拟合等）
|
|||
|
|
- **CoordinateTransform**: 坐标系转换工具
|
|||
|
|
|
|||
|
|
### CloudView
|
|||
|
|
|
|||
|
|
点云可视化查看工具（独立应用程序）
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
### 在项目中引用
|
|||
|
|
|
|||
|
|
```qmake
|
|||
|
|
# 包含路径
|
|||
|
|
INCLUDEPATH += $$PWD/../Utils/VrCommon/Inc
|
|||
|
|
INCLUDEPATH += $$PWD/../Utils/VrUtils/Inc
|
|||
|
|
|
|||
|
|
# 链接库
|
|||
|
|
win32:CONFIG(release, debug|release): {
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrCommon/release -lVrCommon
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrUtils/release -lVrUtils
|
|||
|
|
}
|
|||
|
|
else:win32:CONFIG(debug, debug|release): {
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrCommon/debug -lVrCommon
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrUtils/debug -lVrUtils
|
|||
|
|
}
|
|||
|
|
else:unix:!macx {
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrCommon -lVrCommon
|
|||
|
|
LIBS += -L$$PWD/../Utils/VrUtils -lVrUtils
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 依赖关系
|
|||
|
|
|
|||
|
|
- **VrUtils** 依赖 **VrCommon**
|
|||
|
|
- **CloudUtils** 依赖 **VrCommon** 和 **VrUtils**
|
|||
|
|
- **DataUtils** 依赖 **VrCommon**
|
|||
|
|
- **CloudView** 依赖 **VrCommon**、**VrUtils** 和 **CloudUtils**
|
|||
|
|
|
|||
|
|
## 编译要求
|
|||
|
|
|
|||
|
|
- Qt 5.x 或更高版本
|
|||
|
|
- C++11 或更高版本
|
|||
|
|
- 支持平台：Windows (MSVC/MinGW)、Linux (ARM/x86_64)
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
内部项目使用
|