OpenCV 4.7中ArUco模块getPredefinedDictionary()与cv::Ptr使用问题

问题背景 #

将基于OpenCV 3 x86平台的ArUco检测代码移植到OpenCV 4.7（搭配Contrib_4x，ARM64平台，Visual Studio 2022）时，遇到以下问题：

• 执行代码 cv::Ptr<cv::aruco::Dictionary> arucoDictionary = cv::aruco::getPredefinedDictionary(cv::aruco::DICT_6X6_250); 时，出现类型不匹配的自定义错误
• 移除cv::Ptr后错误消失，但后续调用cv::aruco::detectMarkers时会出现新问题
• 已正确配置包含目录、链接器及附加库

解决方案 #

OpenCV 4.x对getPredefinedDictionary的返回值做了const正确性优化，解决方法如下：

1. 修正Ptr的const修饰符 #

OpenCV 4.7中getPredefinedDictionary的返回值为const cv::Ptr<cv::aruco::Dictionary>&，而非OpenCV 3中的非const类型。将变量声明改为带const修饰的Ptr即可匹配类型：

const cv::Ptr<cv::aruco::Dictionary> arucoDictionary = cv::aruco::getPredefinedDictionary(cv::aruco::DICT_6X6_250);

2. 为什么移除Ptr会出问题？ #

cv::aruco::detectMarkers要求的字典参数类型为const cv::aruco::Dictionary&或const cv::Ptr<cv::aruco::Dictionary>&。直接使用值类型（cv::aruco::Dictionary）会触发对象拷贝，可能因生命周期管理或内部资源引用问题导致错误，不符合OpenCV对这类对象的设计规范。

3. 额外检查项 #

• 确保OpenCV主库与Contrib库版本完全一致（均为4.7.x），ARM64编译环境下符号匹配要求严格
• 确认链接的是ARM64版本的opencv_aruco库（如opencv_aruco470.lib）

结论 #

OpenCV 4.7完全支持结合cv::Ptr使用getPredefinedDictionary，仅需注意返回值的const修饰符，这是OpenCV 4对API做的规范性优化，区别于OpenCV 3的实现。

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