如何在artoolkitx中使用artoolkitx_genMarkerSet？生成.patt文件失败求助

常见排查方向及解决办法 #

• 命令参数错误
  artoolkitx_genMarkerSet.exe需要严格遵循参数格式，必须指定输入图像、输出路径，以及标记尺寸参数。正确的命令示例如下：

  artoolkitx_genMarkerSet.exe -i input_image.png -o output_marker.patt -s 16
  

  检查是否遗漏了-s（标记尺寸，常用16或32）这类必要参数，同时确保输入输出路径没有空格、中文字符（Windows下该工具对非英文路径支持不佳）。

• 输入图像不符合规范
  用于生成.patt的图像必须满足以下要求：

  • 格式为PNG或JPG，优先用黑白高对比度的灰度图（彩色图易导致生成失败或后续识别异常）
  • 图像需为正方形（如256×256、512×512像素），避免非正方形尺寸
  • 图像内容要有明显纹理特征，不能是全黑、全白这类无辨识度的内容

• 权限或写入问题
  右键选择「以管理员身份运行」artoolkitx_genMarkerSet.exe，避免因系统权限不足无法写入输出文件。同时确认输出目录已存在，工具无法自动创建不存在的目录，比如指定./markers/output.patt时，要先建好markers文件夹。

• 工具依赖缺失
  检查artoolkitx安装目录下的dll文件是否完整（比如OpenCV相关组件、artoolkitx自身的运行库），如果有缺失，重新解压完整的1.1.3版本安装包，确保所有依赖文件都在工具同目录下。

内容的提问来源于stack exchange，提问作者Ruyu Bao