OpenCV 速查手册

1
cmake_minimum_required(VERSION 3.16)
2
project(opencv_demo LANGUAGES CXX)
3
set(CMAKE_CXX_STANDARD 17)
4
set(CMAKE_CXX_STANDARD_REQUIRED ON)
5

6
find_package(OpenCV REQUIRED)
7
add_executable(opencv_demo main.cpp)
8
target_include_directories(opencv_demo PRIVATE ${OpenCV_INCLUDE_DIRS})
9
target_link_libraries(opencv_demo PRIVATE ${OpenCV_LIBS})

1
import cv2
2
print(cv2.__version__)

1
cv::Point p(100, 50);
2
cv::Point2f pf(100.5f, 50.2f);
3
cv::Size sz(1280, 1024);          // width, height
4
cv::Rect rect(100, 80, 300, 200); // x, y, width, height
5
cv::Scalar green(0, 255, 0);      // BGR
6
cv::RotatedRect rr(cv::Point2f(300, 200), cv::Size2f(40, 120), 20.0f);

1
std::cout << image.rows << " " << image.cols << " "
2
          << image.channels() << " " << image.type() << " "
3
          << image.empty() << std::endl;

1
cv::Mat a = image;           // 共享数据（引用计数）
2
cv::Mat b = image.clone();   // 深拷贝
3
image.copyTo(b);             // 显式深拷贝

1
// 灰度
2
uchar v = gray.at<uchar>(y, x);
3

4
// BGR
5
cv::Vec3b pixel = image.at<cv::Vec3b>(y, x);
6
uchar b = pixel[0], g = pixel[1], r = pixel[2];
7

8
// 高性能按行遍历
9
for (int y = 0; y < gray.rows; ++y) {
10
    uchar* row = gray.ptr<uchar>(y);
11
    for (int x = 0; x < gray.cols; ++x) {
12
        // 使用 row[x]
13
    }
14
}

1
cv::Rect roi_rect(x, y, w, h);
2
cv::Mat roi = image(roi_rect);           // 视图
3
cv::Mat roi_copy = image(roi_rect).clone(); // 独立

1
cv::Mat color = cv::imread(path, cv::IMREAD_COLOR);     // BGR
2
cv::Mat gray  = cv::imread(path, cv::IMREAD_GRAYSCALE);
3
if (color.empty()) { /* 失败处理 */ }
4
cv::imwrite("out.jpg", color);

1
img = cv2.imread(path, cv2.IMREAD_COLOR)
2
cv2.imwrite("out.jpg", img)

1
cv::imshow("win", image);
2
int key = cv::waitKey(0);   // 0 = 永久等待
3
if (key == 27) { /* ESC */ }
4
cv::destroyAllWindows();

1
cv::VideoCapture cap(path_or_index);
2
if (!cap.isOpened()) { /* 错误 */ }
3
cv::Mat frame;
4
while (cap.read(frame)) {
5
    // 处理 frame
6
    cv::imshow("frame", frame);
7
    if (cv::waitKey(1) == 27) break;
8
}

1
cv::cvtColor(src, gray, cv::COLOR_BGR2GRAY);
2
cv::cvtColor(src, hsv,  cv::COLOR_BGR2HSV);
3
cv::cvtColor(src, rgb,  cv::COLOR_BGR2RGB);  // 注意：matplotlib 等需要

1
std::vector<cv::Mat> chs;
2
cv::split(image, chs);          // chs[0]=B, [1]=G, [2]=R
3
cv::merge(chs, merged);

1
cv::Scalar lower(90, 80, 80);   // HSV 蓝示例
2
cv::Scalar upper(130, 255, 255);
3
cv::Mat mask;
4
cv::inRange(hsv, lower, upper, mask);
5

6
cv::Mat selected;
7
cv::bitwise_and(image, image, selected, mask);

1
cv::resize(src, dst, cv::Size(640, 480), 0, 0, cv::INTER_LINEAR);
2
// 或按比例
3
cv::resize(src, dst, cv::Size(), 0.5, 0.5, cv::INTER_AREA);

1
cv::GaussianBlur(src, dst, cv::Size(5, 5), 1.2);
2
cv::medianBlur(src, dst, 5);                 // 对椒盐噪声好
3
cv::blur(src, dst, cv::Size(5, 5));          // 均值
4
cv::bilateralFilter(src, dst, 9, 75, 75);    // 保边

1
cv::flip(src, dst, 1);          // 1=水平, 0=垂直, -1=两者
2
cv::rotate(src, dst, cv::ROTATE_90_CLOCKWISE);
3
cv::normalize(src, dst, 0, 255, cv::NORM_MINMAX, CV_8U);

1
cv::threshold(gray, binary, 180, 255, cv::THRESH_BINARY);
2
// 常用类型：THRESH_BINARY, THRESH_BINARY_INV, THRESH_OTSU, THRESH_TOZERO

1
cv::adaptiveThreshold(gray, binary, 255,
2
                      cv::ADAPTIVE_THRESH_GAUSSIAN_C,
3
                      cv::THRESH_BINARY, 11, 2);

1
std::vector<std::vector<cv::Point>> contours;
2
std::vector<cv::Vec4i> hierarchy;
3

4
cv::findContours(binary, contours, hierarchy,
5
                 cv::RETR_EXTERNAL,          // 只外层
6
                 cv::CHAIN_APPROX_SIMPLE);   // 压缩共线点

1
double area = cv::contourArea(contours[i]);
2
double peri = cv::arcLength(contours[i], true);
3
cv::Rect bbox = cv::boundingRect(contours[i]);
4
cv::RotatedRect rrect = cv::minAreaRect(contours[i]);
5
cv::Moments m = cv::moments(contours[i]);
6
cv::Point2f center(m.m10 / m.m00, m.m01 / m.m00);

1
std::vector<cv::Point> approx;
2
cv::approxPolyDP(contours[i], approx, 0.02 * peri, true);

1
cv::drawContours(debug, contours, -1, cv::Scalar(0, 255, 0), 2);

1
cv::Point2f vertices[4];
2
rrect.points(vertices);
3
// 可转成自己的 Light 结构，统一长边/短边/倾角定义

1
cv::Scalar(255, 0, 0)   // 蓝
2
cv::Scalar(0, 255, 0)   // 绿
3
cv::Scalar(0, 0, 255)   // 红
4
cv::Scalar(0, 255, 255) // 黄
5
cv::Scalar(255, 255, 255) // 白
6
cv::Scalar(0, 0, 0)     // 黑