您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 技巧大全

讀 OpenCV 源碼:UIImageToMat 與 MatToUIImage 的底細

編輯:iOS 技巧大全

在 iOS 上做 OpenCV 開發,遲早會碰到這兩個函式:UIImageToMat() 與 MatToUIImage()。它們負責 UIImage 與 cv::Mat 之間的轉換,但官方文件對細節著墨不多——轉換後的 Mat 是幾通道?帶不帶 alpha?色彩空間是 RGBA 還是 BGRA?這些都得自己讀源碼才有答案。

一、UIImageToMat 的細節

void UIImageToMat(const UIImage* image, cv::Mat& m, bool alphaExist) {
    CGColorSpaceRef colorSpace = CGImageGetColorSpace(image.CGImage);
    CGFloat cols = image.size.width, rows = image.size.height;
    CGContextRef contextRef;
    CGBitmapInfo bitmapInfo = kCGImageAlphaPremultipliedLast;

    if (CGColorSpaceGetModel(colorSpace) == 0) {
        // 單色(灰度)
        m.create(rows, cols, CV_8UC1);   // 8 bits per component, 1 channel
        if (!alphaExist) bitmapInfo = kCGImageAlphaNone;
        contextRef = CGBitmapContextCreate(m.data, m.cols, m.rows, 8, m.step[0], colorSpace, bitmapInfo);
    } else {
        m.create(rows, cols, CV_8UC4);   // 8 bits per component, 4 channels
        if (!alphaExist) bitmapInfo = kCGImageAlphaNoneSkipLast | kCGBitmapByteOrderDefault;
        contextRef = CGBitmapContextCreate(m.data, m.cols, m.rows, 8, m.step[0], colorSpace, bitmapInfo);
    }

    CGContextDrawImage(contextRef, CGRectMake(0, 0, cols, rows), image.CGImage);
    CGContextRelease(contextRef);
}

這段程式位於 modules/imgcodecs/src/ios_conversions.mm。

流程拆解:

第一步,把 UIImage 轉成底層的 CGImageRef:

@property(nullable, nonatomic, readonly) CGImageRef CGImage;  // 回傳底層 CGImageRef,若為 CIImage -based 則為 nil

CGImageRef 代表的是「點陣圖(bitmap)」,也就是一個由像素組成的矩形陣列,每個像素對應來源圖像中的一個取樣點。

第二步,用 CGImageGetColorSpace 取得色彩空間。注意:若傳入的其實是「影像遮罩(image mask)」,這個方法會回傳 NULL。遮罩的概念等同 Photoshop 裡的蒙版,只有被指定的區域才會顯示。

第三步,用 CGColorSpaceGetModel 取得色彩模型,回傳一個列舉:

typedef CF_ENUM (int32_t, CGColorSpaceModel) {
    kCGColorSpaceModelUnknown = -1,
    kCGColorSpaceModelMonochrome,
    kCGColorSpaceModelRGB,
    kCGColorSpaceModelCMYK,
    kCGColorSpaceModelLab,
    kCGColorSpaceModelDeviceN,
    kCGColorSpaceModelIndexed,
    kCGColorSpaceModelPattern
};

順帶一提,C++ 版的 OpenCV 用 cols 與 rows 表示寬與高,而 Java 版用的是 width 與 height,語意相同但命名不同。

程式碼裡判斷 == 0 其實就是比對 kCGColorSpaceModelMonochrome。若是單色圖,就以 CV_8UC1 建立 Mat,色彩空間沿用原圖,沒有 alpha 通道。若不是單色圖,則以 CV_8UC4 建立 Mat,把原始色彩空間寫入 data。

結論:傳入單色灰度圖,輸出就是單通道、無 alpha;傳入 RGB 或 BGRA,輸出會保留原色彩空間,且 alpha 通道預設存在,除非在第三個參數明確指定 alphaExist = false。

二、MatToUIImage 的細節

UIImage* MatToUIImage(const cv::Mat& image) {
    NSData *data = [NSData dataWithBytes:image.data
                                  length:image.elemSize() * image.total()];
    CGColorSpaceRef colorSpace;
    if (image.elemSize() == 1) {
        colorSpace = CGColorSpaceCreateDeviceGray();
    } else {
        colorSpace = CGColorSpaceCreateDeviceRGB();
    }

    CGDataProviderRef provider = CGDataProviderCreateWithCFData((__bridge CFDataRef)data);

    // 有 4 通道時保留 alpha
    bool alpha = image.channels() == 4;
    CGBitmapInfo bitmapInfo = (alpha ? kCGImageAlphaLast : kCGImageAlphaNone) | kCGBitmapByteOrderDefault;

    CGImageRef imageRef = CGImageCreate(image.cols, image.rows,
                                        8, 8 * image.elemSize(),
                                        image.step.p[0], colorSpace, bitmapInfo,
                                        provider, NULL, false, kCGRenderingIntentDefault);

    UIImage *finalImage = [UIImage imageWithCGImage:imageRef];
    CGImageRelease(imageRef);
    CGDataProviderRelease(provider);
    CGColorSpaceRelease(colorSpace);
    return finalImage;
}

逐段來看:

先取出 Mat 的原始位元組資料,長度是 elemSize() * total()。elemSize() 回傳單一元素的大小(bytes),也就是「通道數 × 每通道位元組數」——例如 CV_8UC3 就是 3 bytes。total() 則回傳元素總數。

接著依元素大小決定色彩空間:1 byte 用灰階(對應 CV_8UC1),其他一律用 RGB。再判斷是否為 4 bytes——RGB 各佔一 byte,第四個 byte 就是 alpha。

CGDataProviderCreateWithCFData 建立資料提供者,這裡的 __bridge 是 ARC 下 Core Foundation 與 Foundation 物件之間的轉換標記,用來正確處理記憶體管理。

最後 CGImageCreate 組出點陣圖,再包成 UIImage。

結論:單通道 Mat 轉出的 UIImage 是灰階;其餘一律視為 RGB。若 Mat 為 4 通道,轉出的 UIImage 會帶 alpha。

三、總結

把兩個方向合起來看:

UIImageToMat()   → 輸出的 Mat 預設帶 alpha 通道,可由第三個參數關閉
MatToUIImage()  → 輸出的 UIImage 色彩空間一律為 RGB(單通道除外),Mat 帶 alpha 時 UIImage 也帶

實務上的含意是:如果你在 iOS 上做影像處理後要轉回 UIImage 顯示,中間的色彩空間其實是被 OpenCV 重新決定的,不會保留原始 ICC 描述檔。對色彩準度有要求的場景(例如色偏敏感的影像比對),建議在轉換前後自行記錄並還原色彩資訊。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved