在 iOS 上做 OpenCV 開發,遲早會碰到這兩個函式:UIImageToMat() 與 MatToUIImage()。它們負責 UIImage 與 cv::Mat 之間的轉換,但官方文件對細節著墨不多——轉換後的 Mat 是幾通道?帶不帶 alpha?色彩空間是 RGBA 還是 BGRA?這些都得自己讀源碼才有答案。
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。
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 描述檔。對色彩準度有要求的場景(例如色偏敏感的影像比對),建議在轉換前後自行記錄並還原色彩資訊。