🛩️无人机目标三维仿真

©️版权声明
本软件版权归 瞳赋® Tofu Intelligence® 所有，提供持续创作并维护。
程序为Windows系统环境运行exe包，提供试用， 若需要授权码请联系销售。

1. 软件概述

Tofu Drone Target Simulator 是一款用于无人机轨迹仿真、场景演示、视频导出与数据集生成的桌面交付软件。
主要面向以下场景：

• 无人机任务路径规划与可视化演示
• 多机型飞行动画验证
• 客户演示视频制作
• 无人机目标检测训练数据生成（VOC）

2. 核心能力

2.1 轨迹编辑与飞行演示

• 支持添加、删除、编辑轨迹点
• 坐标系固定约定：X=水平左右，Y=前后距离，Z=高度/垂直
• 支持按进度沿轨迹循环飞行
• 飞行姿态包含更真实的动态效果（转弯、升降时俯仰变化）

2.2 多机型模型支持

• 支持加载多种无人机模型（GLB/GLTF/FBX/OBJ）
• 机型规则按 ID 固化，包括：
  • 旋翼识别方式
  • 旋转轴
  • 旋转速度
  • 姿态参数
  • 校准与锚点偏移参数

2.3 背景与场景管理

• 支持纯色背景、图片背景、三维场景背景
• 三维背景支持：
  • 场景缩放（最大到 500）
  • 背景整体上下挪动（Z）
• 背景设置参数可本地持久化保存（重启后恢复）

2.4 视频导出

• 支持开始/结束录像
• 支持分辨率选项：
  • 1920x1080
  • 2688x1520
• 支持帧率选项：
  • 25 Hz
  • 50 Hz
• 录制时可隐藏网格/轨迹/Gizmo，保障画面干净

2.5 VOC 数据集导出

• 按时间间隔抓帧导出
• 生成标准 VOC 目录结构：
  • JPEGImages/
  • Annotations/
• 标注类别固定：drone
• 标注文件格式：VOC XML（BBox）

3. 授权与试用机制

3.1 一机一码离线授权

采用离线授权文件方式：

1. 客户端生成机器码
2. 授权方使用授权工具生成 license.dat
3. 客户导入 license.dat 激活

3.2 无授权试用

• 未授权用户可试用 3 天（基础功能可用）
• 试用期内及未授权状态下，以下功能不可用：
  • 视频导出
  • VOC 数据导出
• 点击受限功能会弹出授权提示

4. 界面功能说明

4.1 顶部与主视图

• 左侧控制面板：参数设置与功能操作
• 右侧三维视图：无人机、轨迹、背景实时渲染
• 标题显示：Tofu Drone Target Simulator 1.0

4.2 轨迹编辑区

• 添加轨迹点：点击后进入俯视拾取
• 点位列表：支持激活与删除
• 选中点可直接修改 X/Y/Z
• 高度滑动条与选中点 Z 实时联动

4.3 背景控制区

• 背景模式切换：图片 / 颜色 / 三维场景
• 三维场景支持：
  • 缩放比例
  • 背景整体上下挪动 Z
• 关键背景参数自动保存

4.4 导出控制区

• 录像导出：设置分辨率、帧率，开始/结束
• VOC 导出：设置采样间隔、导出分辨率

5. 客户操作流程（推荐）

5.1 首次启动

1. 运行 TofuDroneTargetSimulator.exe
2. 打开软件后，先确认模型与场景加载完成
3. 导入授权文件（如已有 license）

5.2 轨迹制作

1. 点击“添加轨迹点”
2. 在地面拾取 XY 位置
3. 调整点位 Z 高度
4. 补齐多点形成轨迹

5.3 飞行预览

1. 选择无人机机型
2. 调整飞行进度或开始演示
3. 检查路径贴合、姿态变化、旋翼状态

5.4 录制视频

1. 设置分辨率和帧率
2. 点击开始录像
3. 演示结束后点击结束录像并保存

5.5 导出 VOC

1. 设定采样间隔与输出分辨率
2. 点击导出 VOC
3. 获取压缩包并检查：
   • JPEGImages
   • Annotations

6. 交付包结构说明

标准客户交付目录建议如下：

release2customer_v10/
├─ TofuDroneTargetSimulator.exe
├─ app/
├─ docs/
│  ├─ tofu-drone-target-simulator-user-manual.html
│  └─ copyright-notice.html
└─ README.txt

说明：

• 主启动入口：TofuDroneTargetSimulator.exe
• app/ 内为编译产物，不含 src 源代码目录

7. 常见问题（FAQ）

Q1：未授权点击导出没有效果？

A：未授权状态下，视频导出和 VOC 导出不可用。点击会提示需要导入有效 license.dat。

Q2：背景参数重启后是否会丢失？

A：背景模式、颜色、场景 URL、场景缩放、背景 Z 偏移等参数会本地保存并自动恢复。

Q3：导入本地背景图片后重启失效？

A：若是临时 blob 地址，重启后会失效，需重新选择图片或使用稳定 URL。

Q4：为什么某些机型姿态或旋翼表现不同？

A：每个机型都有独立专配参数（旋翼轴、速度、校准、姿态系数），属于预期行为。

8. 系统与运行建议

• 操作系统：Windows 10/11（64 位）
• 建议内存：16 GB 及以上
• 建议显卡：支持硬件加速的独立显卡
• 建议浏览内核环境：已使用内嵌窗口启动器，减少系统浏览器差异影响