如何用OpenCV cv2.VideoWriter正确保存Azure Kinect V3的IR视频？

问题背景 #

同时录制Azure Kinect V3的多类型视频（RGB、RGB+骨骼、骨骼、热成像、深度、IR）及FLIR Lepton3.5视频，其余类型均可正常保存，仅IR视频保存后损坏。尝试将单通道IR数组转为三通道BGR后仍无效，追加np.left_shift和归一化处理也未解决问题。

核心原因 #

Azure Kinect的IR原始数据为16位无符号整数（uint16），直接强制转为uint8会丢失大量有效信息，导致视频帧数据异常，最终损坏整个视频文件。

修复步骤 #

1. 正确转换16位IR数据至8位 #

根据Azure Kinect IR数据的特性，选择以下两种方式之一完成位深映射：

• 线性归一化法：适配动态范围较大的场景

  import numpy as np
  import cv2
  
  # 假设IR_image为读取到的16位单通道数组
  ir_min = np.min(IR_image)
  ir_max = np.max(IR_image)
  # 将数据线性映射到0-255区间
  ir_8bit = ((IR_image - ir_min) / (ir_max - ir_min) * 255).astype(np.uint8)
  

• 位偏移法：针对Azure Kinect IR的常用优化（有效数据集中在高12位）

  # 右移4位，将高12位数据压缩到8位范围
  ir_8bit = (IR_image >> 4).astype(np.uint8)
  

2. 转换为三通道BGR格式 #

使用处理后的8位单通道数组转换为三通道，适配cv2.VideoWriter的要求：

ir_bgr = cv2.cvtColor(ir_8bit, cv2.COLOR_GRAY2BGR)

3. 校验VideoWriter参数一致性 #

确保视频写入器的分辨率、帧率、编码格式与IR帧完全匹配：

# 示例：IR帧分辨率1920x1080，帧率30fps
fourcc = cv2.VideoWriter_fourcc(*'mp4v')  # 可选编码：'XVID'、'MJPG'
# 注意：分辨率参数为(width, height)，与numpy数组的(height, width)顺序相反
out = cv2.VideoWriter('ir_output.mp4', fourcc, 30.0, (1920, 1080))

4. 逐帧校验写入 #

写入前检查帧的有效性，避免异常数据破坏视频：

# 确保帧尺寸、通道数符合要求
if ir_bgr is not None and ir_bgr.shape == (1080, 1920, 3):
    out.write(ir_bgr)

额外排查点 #

• 确认IR帧读取逻辑正确，未截断16位原始数据；
• 若仍有问题，更换视频编码格式（如MJPG兼容性更强）；
• 确保所有写入的IR帧尺寸、通道数完全一致，无突变。

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