OpenCV读取视频在不同VS项目中显示结果不一致问题排查

问题背景 #

我有一段读取MP4文件的简单OpenCV脚本：

#include <opencv2/core/core.hpp>
#include <opencv2/highgui/highgui.hpp>
#include <opencv2/videoio/videoio.hpp>

int main()
{
    cv::VideoCapture file("test.mp4");
    cv::Mat frame;
    while (true)
    {
            file.read(frame);
            cv::imshow("Preview", frame);
            cv::waitKey(42); 
    }
    file.release();
    return 0;
}

这段脚本单独运行时显示正常（左右分屏的3D视频能完整展示，宽高比正确），但集成到我正在开发的另一个项目后，图像帧的宽高比出现错误——仅显示视频的单侧内容，且画面被拉伸变形，完全不符合原视频的16:9比例。

我使用Windows VS2019环境，已移除项目中其他代码，仅保留上述脚本。目前唯一的差异是项目的头文件包含和链接器设置，该项目依赖ceres, glog, d3d11, realsense2, VTK, pcl, eigen3, OpenXR这些库。

已尝试的排查步骤：

• 设置VideoCapture的帧宽和帧高，无效
• 测试OpenCV 4.1和4.6两个版本，问题依旧
• 读取frame.cols和frame.rows能得到正确的分辨率（3840×1080）

补充信息：视频文件元数据 #

该视频是左右分屏的3D视频，可在VLC等播放器正常显示，元数据如下：

mediainfo test.mp4 
General
Complete name                            : test.mp4
Format                                   : MPEG-4
Format profile                           : Base Media
Codec ID                                 : isom (isom/iso2/avc1/mp41)
File size                                : 181 MiB
Duration                                 : 31 s 339 ms
Overall bit rate                         : 48.4 Mb/s
Writing application                      : Lavf58.20.100

Video
ID                                       : 1
Format                                   : AVC
Format/Info                              : Advanced Video Codec
Format profile                           : High@L5.1
Format settings                          : CABAC / 1 Ref Frames
Format settings, CABAC                   : Yes
Format settings, Reference frames        : 1 frame
Format settings, GOP                     : M=1, N=30
Codec ID                                 : avc1
Codec ID/Info                            : Advanced Video Coding
Duration                                 : 31 s 317 ms
Bit rate                                 : 48.0 Mb/s
Width                                    : 3 840 pixels
Height                                   : 1 080 pixels
Display aspect ratio                     : 16:9
Original display aspect ratio            : 3.556
Frame rate mode                          : Variable
Frame rate                               : 60.000 FPS
Minimum frame rate                       : 59.920 FPS
Maximum frame rate                       : 60.080 FPS
Color space                              : YUV
Chroma subsampling                       : 4:2:0
Bit depth                                : 8 bits
Scan type                                : Progressive
Bits/(Pixel*Frame)                       : 0.193
Stream size                              : 179 MiB (99%)
Title                                    : SStar Video
Codec configuration box                  : avcC

Audio
ID                                       : 2
Format                                   : AAC LC
Format/Info                              : Advanced Audio Codec Low Complexity
Codec ID                                 : mp4a-40-2
Duration                                 : 31 s 339 ms
Bit rate mode                            : Constant
Bit rate                                 : 140 kb/s
Channel(s)                               : 2 channels
Channel layout                           : L R
Sampling rate                            : 48.0 kHz
Frame rate                               : 46.875 FPS (1024 SPF)
Compression mode                         : Lossy
Stream size                              : 534 KiB (0%)
Title                                    : SStar Audio
Default                                  : Yes
Alternate group                          : 1

可能的原因及解决方向 #

1. 图形类库冲突干扰OpenCV渲染后端 #

你依赖的d3d11、OpenXR这类图形相关库，可能和OpenCV的highgui模块使用的渲染后端（Win32 GDI、DirectShow等）产生冲突，比如修改全局图形上下文、强制设置特定窗口渲染模式，导致cv::imshow窗口无法适配视频原始分辨率和宽高比。

• 解决尝试：调用cv::imshow前显式设置窗口属性为cv::namedWindow("Preview", cv::WINDOW_NORMAL)，让窗口自适应调整；或者编译OpenCV时指定使用Qt作为highgui后端，替换默认的Win32渲染。

2. 视频宽高比元数据被忽略 #

虽然frame.cols和frame.rows读取正确，但其他库可能干扰OpenCV读取视频的Display aspect ratio元数据（16:9），导致渲染时直接按像素宽高比（3840:1080≈3.556:1）拉伸画面。

• 解决尝试：手动计算并调整显示尺寸，比如将帧缩放后再显示：

cv::Mat displayFrame;
// 按16:9比例缩放
cv::resize(frame, displayFrame, cv::Size(frame.rows * 16 / 9, frame.rows));
cv::imshow("Preview", displayFrame);

3. 链接器符号冲突或顺序问题 #

项目中链接的glog、ceres等库可能存在与OpenCV同名的符号，或者链接顺序错误导致OpenCV的视频读取函数被其他库实现替换，进而破坏宽高比处理逻辑。

• 解决尝试：调整链接器库顺序，将OpenCV相关库放在最前面；使用dumpbin工具检查导出符号，排查是否存在重复符号冲突。

4. Direct3D上下文冲突 #

项目使用的d3d11可能创建了全局D3D设备上下文，和OpenCVhighgui的Direct3D渲染上下文冲突，导致窗口渲染异常。

• 解决尝试：初始化OpenCV视频读取前暂时释放D3D上下文；或者通过设置环境变量OPENCV_VIDEOIO_PRIORITY_MSMF=0禁用Media Foundation后端，强制OpenCV使用GDI渲染。

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