# LS2K300_View

**Repository Path**: fourzkw/ls2k300_view

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-04-24
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LS2K0300 上位机项目

## 项目结构

```text
LS2K0300_View/
├── main.py                 # 兼容入口脚本（保持原启动方式）
├── requirements.txt              # Python 依赖
├── README.md
└── src/
    └── ls2k_viewer/
        ├── __init__.py
        ├── app.py                # 程序入口(main)
        ├── config.py             # 常量配置（IP/端口/协议标识）
        ├── receiver.py           # UDP图像接收与重组线程
        ├── widgets.py            # 可点击视频组件
        └── main_window.py        # 主窗口与交互逻辑
```

## 功能模块说明

- `receiver.py`: 负责 UDP 包解析、图像重组、左右边线点绘制和 FPS 统计。
- `main_window.py`: 负责界面布局、视频渲染、四点采集、逆透视矩阵计算和保存。
- `app.py`: 负责创建 Qt 应用并拉起主窗口。
- `main.py`: 对旧启动方式保留兼容，内部转发到 `src/ls2k_viewer`。

## 运行

```bash
python3 -m pip install -r requirements.txt
python3 main.py
```

## 标定工具

- 相机内参标定（棋盘格）:

```bash
python3 tools/camera_intrinsics_calibration_tool.py \
  --images "data/calib/*.jpg" \
  --rows 6 \
  --cols 9 \
  --square-size 20 \
  --output camera_intrinsics.json
```

- 透视变换标定（四点法，独立于主界面）:

```bash
python3 tools/perspective_calibration_tool.py \
  --image data/calib/road.jpg \
  --output ipm_matrix.json
```

> 透视点位顺序固定为：`1左上 2左下 3右上 4右下`。