FIX `recon` 一次性命令行重建

FIX.exe recon 是无界面、单任务、用完即退出的重建入口。它在当前进程中直接调用随 FIX 发布的 FIXReconEngineFixrc.dll，不会连接、转发命令或关闭已经打开的 FIX 实例。

命令

FIX.exe recon `
  --projection-directory 'E:\Data\BoardA\tif' `
  --recon-config 'E:\Data\BoardA\ReconstructionConfig.json' `
  --output-volume 'E:\Output\BoardA.raw' `
  --cuda-device 0 `
  --result-json 'E:\Output\BoardA.recon.json'

必选参数：

• --projection-directory <dir>：投影文件所在目录；只扫描该目录，不递归。
• --recon-config <json>：FIX ReconstructionConfig.json。
• --output-volume <file.raw>：输出的完整 RAW 体数据。
• --cuda-device <index>：当前进程可见的 CUDA 逻辑设备序号。

可选参数：

• --result-json <file.json>：保存机器可读的执行结果。
• --command-timeout-ms <1000..7200000>：协作式超时，默认 7200000 毫秒。
• --help：显示帮助。

参数采用“选项和值分开”的形式，不接受 --name=value。配置参数只有 --recon-config；--reconstruction-config 不是兼容别名，使用时会返回参数错误。

输入合同

投影目录可包含以下一种输入族：

• 编码图像：.tif、.tiff、.png 或 .bmp，每个文件一张投影；
• RAW：多个文件时每个文件必须恰好一张投影；只有一个 .raw 文件时，可包含连续的完整投影栈。

文件按自然数字顺序读取，例如 1.tif, 2.tif, 10.tif。编码图像必须具有相同宽度、高度、单通道数据类型；RAW 的宽度、高度和类型来自重建配置。目录中不能混合 RAW 与编码图像。配置中的扫描数量、步长、探测器尺寸和数据类型最终仍由生产重建引擎严格校验。

支持的投影标量类型为 UInt8、UInt16、Int16 和 Float32。当前输出只接受 FIX RAW 导入器可无歧义读取的 UInt8、UInt16 或 Int16 单通道体数据；其它输出类型会保护性失败。

执行前会检查对应 FIX 产品许可证；GPU 版本还要求 GPU Acceleration Module 许可证，FIX AXI 版本同时要求 FIX CT Reconstruction 许可证。

输出合同

输出 .raw 的第 0 字节就是第一个体素，不写 FIX 内部 VolumeDataHeader，也不保留 1024 字节偏移。命令同时创建同目录、同主文件名的 .txt，例如：

BoardA.raw
BoardA.txt

TXT 使用 FIX 现有 RAW 自动导入格式，关键字段包括：

Dimensions: Z x Y x X
Data Type: CV_16UC1
Data Offset: 0 bytes
Is Projection: 0

同时记录体素间距、物理尺寸、投影目录、配置路径及 SHA-256、GPU 设备和 UUID。FIX 打开 RAW 时会读取这个 TXT，因此不需要手工填写尺寸、类型或偏移。

.raw、同名 .txt 和可选结果 JSON 均不覆盖已有文件。RAW 和 TXT 先写同目录临时文件；两者都准备完成后才发布。失败时不会把不完整 RAW 当成成功结果。

退出码

正常执行时，进度写入标准错误；最终紧凑 JSON 写入标准输出。指定 --result-json 后，同一结果还会保存为格式化 JSON，便于批量处理程序读取。