C++如何使用OpenCV读取和显示图片?(代码示例)

OpenCV C++读取显示图片需用cv::imread和cv::imshow,注意路径正确(避免中文)、调用waitKey防止闪退、正确链接库;支持灰度/彩色/带Alpha通道读取,可查尺寸类型及调整窗口大小。

用OpenCV在C++中读取和显示图片很简单,核心是cv::imreadcv::imshow两个函数,但要注意路径、窗口管理和库链接等细节。

1. 基础读取与显示代码

以下是最小可运行示例(需已正确安装并链接OpenCV):

#include 
#include 

int main() {
    // 读取图片(支持jpg、png、bmp等常见格式)
    cv::Mat img = cv::imread("lena.jpg");
    
    // 检查是否成功读取
    if (img.empty()) {
        std::cerr << "错误:无法加载图片,请检查路径!" << std::endl;
        return -1;
    }
    
    // 创建窗口并显示
    cv::namedWindow("Display", cv::WINDOW_AUTOSIZE);
    cv::imshow("Display", img);
    
    // 等待按键(0表示无限等待)
    cv::waitKey(0);
    
    return 0;
}

2. 关键注意事项

  • 图片路径必须正确:相对路径以可执行文件所在目录为基准;推荐用绝对路径调试,或把图片放在项目输出目录(如Debug/build/下)
  • 中文路径会失败:OpenCV的imread不支持UTF-8路径(Windows下尤其明显),请用英文路径或改用cv::imdecode+std::filesystem绕过
  • 必须调用waitKey():否则窗口会闪退;参数为毫秒数,0表示一直等待直到按键
  • 确保链接了OpenCV库:CMake中需find_package(OpenCV REQUIRED)target_link_libraries(your_target ${OpenCV_LIBS})

3. 常见扩展用法

  • 指定读取方式cv::imread("img.jpg", cv::IMREAD_GRAYSCALE) 读灰度图;cv::IMREAD_COLOR(默认,BGR通道);cv::IMREAD_UNCHANGED(保留alpha通道)
  • 检查图像信息std::cout (type()返回CV_8UC3等编码)
  • 调整窗口大小:用cv::namedWindow("name", cv::WINDOW_NORMAL)后,再调用cv::resizeWindow("name", 800, 600)

4. Windows下中文路径临时解决(C++17)

如果必须用中文路径,可用如下方式:

#include 
#include 
#include 
#include 

std::vector readImageFromPath(const std::wstring& path) {
    std::ifstream file(path, std::ios::binary);
    file.seekg(0, std::ios::end);
    size_t size = file.tellg();
    file.seekg(0);
    std::vector buf(size);
    file.read(reinterpret_cast(&buf[0]), size);
    return buf;
}

// 使用:
// auto buf = readImageFromPath(L"测试文件夹\\猫.png");
// cv::Mat img = cv::imdecode(buf, cv::IMREAD_COLOR);

基本上就这些。只要路径对、库连上、加上waitKey,就能稳稳显示图片。