JavaScript中调用cv.undistort触发Assertion failed错误求助

问题描述 #

我在使用OpenCV.js扫描ArUco标记前，先对图像做去畸变处理。扫描标记的功能运行正常，但调用cv.undistort()时触发了Assertion failed错误。我已确认相机矩阵、畸变系数的尺寸定义正确，且相同逻辑在Python中运行完全正常，但在OpenCV.js里始终报错，希望找到解决方法。

最小可复现代码示例 #

// 初始化相机矩阵（模拟参数）
const cameraMatrix = new cv.Mat(3, 3, cv.CV_64F);
cameraMatrix.data64F.set([1000, 0, 320, 0, 1000, 240, 0, 0, 1]);

// 初始化畸变系数（模拟参数）
const distCoeffs = new cv.Mat(1, 5, cv.CV_64F);
distCoeffs.data64F.set([0.1, -0.2, 0.01, 0.005, 0.05]);

// 假设img为输入的待处理图像
const dst = new cv.Mat();
cv.undistort(img, dst, cameraMatrix, distCoeffs); // 此处触发断言失败错误

可能的解决方案 #

1. 严格匹配Mat对象的数据类型与内存初始化 #

OpenCV.js对Mat的类型要求比Python更严格：

• 相机矩阵和畸变系数必须使用CV_64F（双精度浮点型），不能混用CV_32F
• 输入图像与输出图像的类型要完全一致（比如都是CV_8UC3）
• 确保所有Mat对象在使用前已正确分配内存，避免空Mat直接传入

2. 预先创建匹配尺寸的输出Mat #

不要直接传入空Mat，建议提前创建与输入图像尺寸、类型一致的输出Mat：

const dst = new cv.Mat(img.rows, img.cols, img.type());
cv.undistort(img, dst, cameraMatrix, distCoeffs);

3. 验证相机矩阵与畸变系数的维度格式 #

虽然Python允许灵活的维度形状，但OpenCV.js可能要求更严格的格式：

• 相机矩阵必须是3行3列的Mat
• 畸变系数如果是5个参数，可尝试用(5,1)的列向量格式替代(1,5)的行向量：

  const distCoeffs = new cv.Mat(5, 1, cv.CV_64F);
  distCoeffs.data64F.set([0.1, -0.2, 0.01, 0.005, 0.05]);
  

4. 显式传入可选参数（兼容部分OpenCV.js版本） #

部分版本的OpenCV.js可能要求必须传入newCameraMatrix参数，即使使用默认值：

// 计算最优新相机矩阵
const newCameraMatrix = cv.getOptimalNewCameraMatrix(
  cameraMatrix, 
  distCoeffs, 
  new cv.Size(img.cols, img.rows), 
  1
);
cv.undistort(img, dst, cameraMatrix, distCoeffs, newCameraMatrix);

5. 调试断言错误的具体原因 #

断言失败通常对应内部参数检查不通过，可在调用前打印关键参数验证：

console.log(`输入图像尺寸：${img.rows}x${img.cols}，类型：${img.type()}`);
console.log(`相机矩阵尺寸：${cameraMatrix.rows}x${cameraMatrix.cols}，类型：${cameraMatrix.type()}`);
console.log(`畸变系数尺寸：${distCoeffs.rows}x${distCoeffs.cols}，类型：${distCoeffs.type()}`);

重点确认：输入图像非空、相机矩阵可逆、畸变系数参数数量符合要求（4/5/8个）。

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