使用Charuco板相机校准时标记未完全检测，求排查建议

问题背景 #

使用OpenCV进行Charuco板相机校准时，无法检测到板上所有标记，仅中心区域标记被识别，边缘标记无检测结果。相关代码及图像情况如下：

• 输入图像：Charuco板存在明显透视畸变，边缘标记变形且模糊
• 输出图像：仅中心区域少量标记被标注

代码片段 #

cv::Ptr<cv::aruco::Dictionary> charuco_dictionary = cv::aruco::getPredefinedDictionary(cv::aruco::DICT_4X4_50);
cv::Ptr<cv::aruco::DetectorParameters> charuco_params = cv::aruco::DetectorParameters::create();
cv::Ptr<cv::aruco::CharucoBoard> board = cv::aruco::CharucoBoard::create(11, 8, 19.5, 13.85, charuco_dictionary);
std::vector<int> marker_ids;
vector<vector<cv::Point2f>> image_point;

cv::Mat input = cv::imread("image.png", cv::IMREAD_ANYCOLOR);
cv::aruco::detectMarkers(input, charuco_dictionary, image_point, marker_ids);
cv::Mat out_color;
cv::cvtColor(input, out_color, cv::COLOR_GRAY2RGB);
cv::aruco::drawDetectedMarkers(out_color, image_point, marker_ids);
cv::imshow("test", out_color);
cv::waitKey(0);
return 0;

排查与修复建议 #

1. 核心错误：字典与Charuco板标记数量不匹配 #

你创建的11x8内角数Charuco板，对应(11-1)*(8-1)=70个ArUco标记，但使用的DICT_4X4_50字典仅包含50个唯一标记ID，超出范围的标记无法被识别。
修复：更换为包含足够标记数的字典，比如DICT_4X4_1000：

cv::Ptr<cv::aruco::Dictionary> charuco_dictionary = cv::aruco::getPredefinedDictionary(cv::aruco::DICT_4X4_1000);

2. 优化检测器参数，适配畸变与模糊图像 #

默认参数对边缘变形、模糊的标记兼容性差，调整以下参数：

• 启用亚像素级角点细化，提升标记角点检测精度：

  charuco_params->cornerRefinementMethod = cv::aruco::CORNER_REFINE_SUBPIX;
  charuco_params->cornerRefinementWinSize = 5;
  

• 调整自适应阈值窗口，适配光照不均的情况：

  charuco_params->adaptiveThreshWinSizeMin = 3;
  charuco_params->adaptiveThreshWinSizeMax = 23;
  charuco_params->adaptiveThreshWinSizeStep = 10;
  

• 放宽标记周长限制，兼容边缘变形的标记：

  charuco_params->minMarkerPerimeterRate = 0.02;
  charuco_params->maxMarkerPerimeterRate = 4.0;
  

3. 图像预处理，提升标记辨识度 #

输入图像边缘标记模糊、对比度不足，预处理后再检测：

• 修正灰度转换逻辑：若输入为彩色图，先转为灰度图再检测（当前代码中COLOR_GRAY2RGB转换错误，若原图像是彩色，应先转灰度）：

  cv::Mat gray;
  cv::cvtColor(input, gray, cv::COLOR_BGR2GRAY);
  cv::aruco::detectMarkers(gray, charuco_dictionary, image_point, marker_ids);
  

• 直方图均衡提升对比度：

  cv::equalizeHist(gray, gray);
  

• 轻度高斯模糊减少噪声干扰：

  cv::GaussianBlur(gray, gray, cv::Size(3,3), 0);
  

4. 拍摄场景优化 #

• 拍摄时尽量让Charuco板正对相机，减少透视畸变；
• 保证光照均匀，避免标记过暗或过曝；
• 若相机存在严重畸变，可先用初步校准参数对图像做畸变校正后再检测。

内容的提问来源于stack exchange，提问作者Zhu Mengxi