# PySide6

**Repository Path**: qt_study/py-side6

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-21
- **Last Updated**: 2025-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PySide6 + Quick3D TopDownOrtho 视图

这个项目实现了类似 ROS2 RVIZ2 中 TopDownOrtho 视图的鼠标交互效果，包括平移、缩放和旋转功能。使用 PySide6 和 QtQuick3D 构建。

## 功能

- **正交俯视图**：提供类似 RVIZ2 中的 TopDownOrtho 视图
- **鼠标平移**：按住左键拖动可平移视图
- **鼠标旋转**：按住右键拖动可旋转视图
- **鼠标缩放**：滚动鼠标滚轮可缩放视图
- **视图重置**：点击界面右上角的"Reset View"按钮可重置视图

## 安装

1. 确保已安装 Python 3.6 或更高版本
2. 安装依赖：

```bash
pip install -r requirements.txt
```

## 运行

直接运行 main.py 文件：

```bash
python main.py
```

## 项目结构

- `main.py` - 主程序入口
- `ortho_camera_controller.py` - 相机控制器类，处理鼠标交互
- `main.qml` - QML 界面文件，定义 3D 场景和用户界面

## 使用说明

- **平移**：按住左键并拖动鼠标
- **旋转**：按住右键并拖动鼠标
- **缩放**：滚动鼠标滚轮
- **重置视图**：点击右上角的"Reset View"按钮

## 自定义

可以通过修改 `ortho_camera_controller.py` 中的敏感度参数来调整鼠标操作的灵敏度：

```python
self._pan_sensitivity = 0.01    # 平移灵敏度
self._rotate_sensitivity = 0.5  # 旋转灵敏度
self._zoom_sensitivity = 0.1    # 缩放灵敏度
```