Axis IP摄像机图像校正Python API及参数获取方法咨询

针对你遇到的Axis IP摄像机图像校正、参数获取以及ros-drivers/axis_camera编译的问题，我整理了以下实用解决方案：

一、通过Axis VAPIX API获取相机校正参数 #

Axis官方的VAPIX API确实支持获取镜头校正相关参数，这些参数通常存储在相机的设备配置中，可通过HTTP请求直接读取：

• 核心请求接口：发送GET请求到相机的参数查询端点，指定镜头校正参数组。示例请求格式：

  http://<相机IP>/axis-cgi/param.cgi?action=list&group=Image.Isp.LensCorrection&responseformat=json
  

  注意：不同Axis相机型号的参数组名可能略有差异，部分型号可能使用Image.LensCorrection替代，建议查阅对应型号的官方VAPIX参数参考文档确认

• Python调用示例：使用requests库快速获取并解析参数：

  import requests
  import json
  
  # 替换为你的相机信息
  CAMERA_IP = "192.168.1.100"
  USERNAME = "admin"
  PASSWORD = "your_password"
  
  # 请求校正参数
  url = f"http://{CAMERA_IP}/axis-cgi/param.cgi?action=list&group=Image.Isp.LensCorrection&responseformat=json"
  response = requests.get(url, auth=(USERNAME, PASSWORD))
  correction_params = json.loads(response.text)["Image.Isp.LensCorrection"]
  
  # 提取关键校正参数（畸变系数、内参矩阵）
  distortion_coeffs = np.array([
      float(correction_params["DistortionK1"]),
      float(correction_params["DistortionK2"]),
      float(correction_params["DistortionP1"]),
      float(correction_params["DistortionP2"])
  ], dtype=np.float32)
  
  camera_matrix = np.array([
      [float(correction_params["FocalLengthX"]), 0, float(correction_params["PrincipalPointX"])],
      [0, float(correction_params["FocalLengthY"]), float(correction_params["PrincipalPointY"])],
      [0, 0, 1]
  ], dtype=np.float32)
  

二、Python实现图像校正（基于OpenCV） #

拿到相机参数后，可通过OpenCV完成图像畸变校正，代码示例如下：

import cv2
import numpy as np

# 读取原始图像（可通过VAPIX的图像接口直接获取：http://<相机IP>/axis-cgi/jpg/image.cgi）
raw_image = cv2.imread("camera_raw.jpg")
h, w = raw_image.shape[:2]

# 计算优化后的相机矩阵和ROI区域
new_camera_matrix, roi = cv2.getOptimalNewCameraMatrix(
    camera_matrix, distortion_coeffs, (w, h), 1, (w, h)
)

# 执行畸变校正
undistorted_image = cv2.undistort(
    raw_image, camera_matrix, distortion_coeffs, None, new_camera_matrix
)

# 裁剪到有效ROI区域（可选）
x, y, roi_w, roi_h = roi
undistorted_image = undistorted_image[y:y+roi_h, x:x+roi_w]

# 保存或预览结果
cv2.imwrite("corrected_image.jpg", undistorted_image)
cv2.imshow("Corrected Image", undistorted_image)
cv2.waitKey(0)

三、直接获取相机硬件校正后的图像 #

其实你不需要自己做校正计算，Axis相机支持直接输出校正后的图像，只需在VAPIX图像/视频流接口中添加参数：

• 获取校正后的单张JPG：

  http://<相机IP>/axis-cgi/jpg/image.cgi?lenscorrection=on
  

• 获取校正后的MJPG视频流：

  http://<相机IP>/axis-cgi/mjpg/video.cgi?lenscorrection=on
  

四、ros-drivers/axis_camera编译失败的排查方向 #

如果仍想使用ROS包，编译失败通常由以下原因导致：

• 依赖缺失：确保安装了对应ROS版本的所有依赖，比如camera-info-manager、image-transport等，可通过以下命令自动安装：

  rosdep install --from-paths src --ignore-src -r -y
  

• 版本不兼容：确认仓库分支与你的ROS版本匹配（比如Noetic对应noetic-devel分支），切换分支后重新编译。
• 权限/网络问题：不要用sudo编译ROS包；若编译时需要下载第三方库，确保网络通畅或手动下载依赖到指定路径。

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