# MyTool

**Repository Path**: heller_sw/my-tool

## Basic Information

- **Project Name**: MyTool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyTool - 深度估计与测量应用

MyTool 是一款基于 Android 的实时深度估计与测量应用，采用 Depth Anything V2 深度学习模型进行场景深度估算，并支持在相机画面中进行两点间的距离测量。

## 功能特性

- **实时深度估计**：利用 Depth Anything V2 模型实时估算场景深度
- **距离测量**：支持在相机画面中选择两个点，测量其三维空间距离
- **GPU 加速**：优先使用 GPU 加速深度模型推理，提升性能
- **流畅的用户体验**：支持锁定帧画面进行精确测量

## 技术架构

### 核心技术栈

- **语言**：Kotlin
- **框架**：Jetpack Compose (UI), Android CameraX (相机)
- **深度学习**：TensorFlow Lite (模型推理)
- **模型**：Depth Anything V2 (vits 版本)

### 核心模块

| 模块 | 描述 |
|------|------|
| `CameraController` | 相机控制与图像采集，处理 CameraX 生命周期 |
| `DepthEstimator` | 深度估计模型加载与推理，支持 GPU 加速 |
| `MeasurementEngine` | 测量引擎，实现从 2D 像素坐标到 3D 空间坐标的反投影计算 |
| `CameraScreen` | 相机预览与测量 UI 界面 |

## 模型部署

### 下载模型

从 [Depth Anything V2](https://github.com/DepthAnyThing/depth_anything_v2) 项目下载 `depth_anything_v2_vits.pth` 模型权重。

### 转换为 TensorFlow Lite 格式

将 PyTorch 模型转换为 TensorFlow Lite 格式，生成 `depth_model.tflite` 文件，并放置在 `app/src/main/assets/` 目录下。

详细转换步骤请参考 [MODEL_GUIDE.md](./MODEL_GUIDE.md)。

## 项目结构

```
app/src/main/java/com/example/mytool/
├── MainActivity.kt           # 应用入口
├── camera/
│   └── CameraController.kt   # 相机控制器
├── depth/
│   └── DepthEstimator.kt     # 深度估计器
├── measurement/
│   └── MeasurementEngine.kt  # 测量引擎
└── ui/
    ├── CameraScreen.kt       # 相机界面
    └── theme/                # 主题配置
```

## 使用说明

1. **启动应用**：打开应用后，相机预览画面将自动启动
2. **选择测量点**：点击画面中的第一个点，等待深度图准备完成
3. **完成测量**：点击第二个点，应用将计算并显示两点间的三维距离
4. **重置测量**：点击重置按钮可清除当前测量结果
5. **锁定帧**：支持锁定当前帧画面进行精确测量

## 构建要求

- Android SDK 24+
- Kotlin 1.9+
- Gradle 8.0+
- Android Studio Arctic Fox 或更高版本

## 依赖项

- CameraX (相机功能)
- TensorFlow Lite (深度学习推理)
- Jetpack Compose (UI 框架)
- Material Design 3

## 许可证

本项目仅供学习研究使用，请遵守 Depth Anything V2 的许可证条款。