标定项目
ProjectionTools 将标定作为项目管理。标定项目在所有 ProjectionTools 应用程序（如 Creator、Align、Mapper2d 和 Mapper3d）之间共享。
每个项目是一个文件夹，包含配置 XML 文件、标定数据和标定过程中拍摄的所有照片。此项目文件夹包含所有相关数据，可以在计算机之间传输。
项目管理
| 操作 | 说明 |
|---|---|
| New Project（新建项目） | 使用项目创建向导创建新项目 |
| Load Project（加载项目） | 加载现有项目。需要选择项目主文件夹中的配置 XML 文件（默认命名为 config.xml） |
| Recent Projects（最近项目） | 允许重新打开最近创建或加载的项目 |
| Save Project（保存项目） | 保存当前打开项目的配置 |
项目组件
投影仪（Projectors）
投影仪分辨率和测试图案生成与识别的信息。
摄像头（Cameras）
用于捕获测试图案的标定摄像头。
屏幕（Screen）
屏幕的一般形状。
参考点（Reference Points）
用于摄像头定向的测量或生成的点。
标记控制（Marker Control）
可选的主动标记控制，可以自动开关。
位置（Positions）
由一个或多个摄像头位置组成的标定过程。
结果（Results）
基于测量标定图案的每个投影通道的重建点云和网格。在 3D 视图中可见，供 Mapper2D 和 Mapper3D 用于计算扭曲和融合导出。
收集支持数据
标定项目可能非常大，因为所有捕获的摄像头图像都会保留以供后续使用。虽然这对于离线分析和优化标定很有用，但可能不适合通过互联网传输。
Help/Collect Support File... 允许将相关项目数据打包到一个存档中，该存档仍可在 Creator 中打开，但不包含图像拍摄过程中产生的大量数据。通常由 domeprojection.com 要求用于支持。
投影仪设置
列表
显示项目中所有投影仪的列表，包括名称、IP、端口和分辨率。允许多选投影仪。
通用设置
| 设置项 | 说明 |
|---|---|
| Name（名称） | 描述投影仪的任意字符串 |
| Type（类型） | 显示测试图案的接口类型 |
| OSC Single | 默认 PatternGenerator 接口 |
| OSC Multi | ProjectionTools 通道虚拟拆分为多个 PatternGenerator 通道 |
| OSC Legacy | 用于非常旧的 PatternGenerator 安装 |
| NDI | 每个通道提供一个 NDI 流 |
| Norxe Unify | 直接向 Norxe Unify 投影仪发送测试图案 |
| Barco Pulse | 直接向 Barco Pulse 投影仪发送测试图案 |
| Luna | 直接向 domeprojection Luna 扭曲单元发送测试图案 |
| Warper4k | 直接向 Westar Warper4k 扭曲单元发送测试图案 |
| IP | 运行 PatternGenerator 软件的计算机网络地址 |
| Port | 与 PatternGenerator 通信的端口（默认 11000） |
| Channel | 通道号，仅用于 PatternGenerator 虚拟模式 |
点图案设置
| 设置项 | 说明 |
|---|---|
| Dot Radius（点半径） | 投影点的像素半径 |
| Columns/Rows（列/行） | 点的列数和行数 |
| Mask Edit（蒙版编辑） | 允许编辑点图案 |
| Recognition Edit（识别编辑） | 允许在带有视觉反馈的编辑器中编辑和测试识别参数 |
识别设置
| 参数 | 说明 |
|---|---|
| Threshold（阈值） | 图像二值化阈值 |
| Brightness average（亮度平均） | 在黑白图像之间淡入平均图像 |
| Radius min/max（最小/最大半径） | 摄像头图像中点的最小和最大像素半径 |
| Test Parameters（测试参数） | 使用摄像头拍摄图像并显示结果 |
图层选择：
- Black Image（黑色图像）：拍摄的第一张图像，应不包含点
- White Image（白色图像）：拍摄的第二张图像，应包含点
- Average Image（平均图像）：黑白图像的平均值
- Binary Image（二值图像）：黑白图像，点应为全白，其余应为黑色
- Contour Image（轮廓图像）：显示每个点周围的轮廓，每个点应恰好有一个闭合轮廓
更改投影仪分辨率
投影仪分辨率在项目创建向导中设置。所有标定数据都与该分辨率绑定，因此更改分辨率后需要重新捕获所有数据。
使用 Tools Menu/Change Projector Resolution... 更改投影仪分辨率。
摄像头设置
| 设置类别 | 参数 | 说明 |
|---|---|---|
| 曝光 | Exposure Mode（曝光模式） | 手动和自动曝光之间选择。建议使用手动模式 |
| 曝光 | Shutter Speed（快门速度） | 拍摄一张图像的快门打开时间。值越高图像越亮 |
| 曝光 | Gain/ISO（增益/ISO） | 摄像头信号增益，高值导致图像有噪点 |
| 曝光 | Aperture（光圈） | 调整镜头开口。高值减小镜头开口 |
| 对焦 | Focus Mode（对焦模式） | 固定和自动对焦之间选择。强烈推荐固定对焦 |
| 对焦 | Digital Zoom（数字变焦） | 应停用 |
| 图像处理 | - | 通常应停用 |
摄像头参数应设置为投影清晰可见但不过亮。
屏幕编辑器
| 设置项 | 说明 |
|---|---|
| Select Screen（选择屏幕） | 如果项目中定义了多个屏幕，选择当前要编辑的屏幕 |
| Add Screen（添加屏幕） | 向项目添加新屏幕 |
| Remove Screen（删除屏幕） | 删除当前选定的屏幕 |
| Type（类型） | 可选：Plane、Cylinder、Dome、Sphere Segment、Mesh、Torus |
| Culling（剔除） | 选择在屏幕的哪一侧投影 |
| Procedural Shape Settings（程序形状设置） | 标准形状的参数调整 |
| Mesh Settings（网格设置） | 网格通常从外部软件生成的 obj 文件导入 |
| Transform 3D（3D 变换） | 在 3D 空间中放置屏幕 |
屏幕助手（Screen Assistant）
允许基于简单的输入值在图形表示之上设置屏幕几何。支持的屏幕类型：plane、cylinder、dome、sphere segment。
屏幕拟合（Screen Fitting）
允许基于屏幕表面上的测量点自动计算屏幕参数。
参考点
参考点是已知的 3D 位置。它们通常与视觉可检测的特征相关，如屏幕角落或任何类型的标记（如 LED 或激光点）。
它们用于计算标定摄像头的位置，并为标定结果提供与实际设置的比例和关系。
添加参考点选项：
- Add single Marker（添加单个标记）
- Generate Markers（生成标记）：基于屏幕的理想几何形状生成参考点
- Add new Markers（添加新标记）：添加可选数量的新标记
- Import Leica DST 360
- Import Leica 3D Disto
- Measure Leica 3D Disto
位置（Positions）
位置代表摄像头在空间中的位置和方向。每个位置包含一个摄像头及其捕获的投影仪图案图像。
位置表显示位置属性，如摄像头位置和方向。颜色编码的质量列显示每个投影仪捕获数据的质量。
位置查找器（Position Finder）
用于根据参考点计算摄像头位置和方向。
位置编辑器
允许手动编辑摄像头位置和方向。支持使用旋转单元时的航向和俯仰角度设置。
