OpencvSharp 算子学习教案之 - Cv2.Demosaicing

fengxing666

347人浏览 · 2026-05-29 08:09:05

fengxing666 · 2026-05-29 08:09:05 发布

大家好，Opencv在很多工程项目中都会用到，而OpencvSharp则是以C#开发与实现的Opencv操作库，对.NET开发人员友好，但很多API的中文资料、应用场景及常见坑点等缺乏系统性归纳，因此这系列博客将给大家带来Cv2及Mat对象全系列算子学习教案，供大家参考学习。

Cv2.Demosaicing

教案版本：V1.0
面向对象：OpenCvSharp 初学者
所属模块：imgproc
源码位置：OpenCvSharp/Cv2/Cv2_imgproc.cs:2532

摘要：Cv2.Demosaicing 用来把 Bayer 原始马赛克图还原成彩色图。它最适合帮助初学者理解传感器原始数据为什么只有单个颜色通道，以及不同插值算法为什么会带来不同的还原效果。

1. 函数名称（带参数签名）

public static void Demosaicing(
    InputArray src,
    OutputArray dst,
    ColorConversionCodes code,
    int dstCn = 0)

2. 函数用途

Cv2.Demosaicing 用来把 Bayer 原始图案还原成彩色图像。

它最常见的用途有：

还原相机传感器输出的 Bayer 原始帧。
比较不同插值算法在边缘和纹理上的差异。
把单通道马赛克数据转换成可视化的 BGR 或 RGB 图像。
在教学中解释“为什么每个像素一开始只有一个颜色分量”。

3. 函数公式

Demosaicing 的核心可以理解成“从马赛克采样中插值恢复缺失通道”：

$\operatorname{interpolate}(src, code, dstCn)$

更具体地说：

src 里每个像素只保存一个颜色分量。
code 决定 Bayer 图案的排列方式和重建算法。
dstCn 决定输出通道数，默认值 0 时自动推导。

对常见的 Bayer 原始图，OpenCV 通常会输出：

三通道彩色图，例如 BGR。
单通道灰度图，例如 BayerBG2GRAY。
带 alpha 通道的四通道图，例如 BayerBG2BGRA。

4. 函数原理说明

Bayer 图案是把 RGB 三个颜色分量分散到不同像素位置上的一种采样方式。它的关键特点是：

每个像素只记录一个颜色分量。
邻近像素会互相补充缺失的颜色信息。
还原时需要插值，所以不同算法的效果会不一样。

最常见的三种重建思路是：

双线性插值：最快，最容易理解。
VNG：更注重局部梯度，边缘通常更自然。
Edge-Aware：会尝试保护边缘细节，常见于更高质量的还原。

对初学者来说，记住一句话就够了：

Bayer 原图不是“坏掉的彩色图”，它本来就是传感器的一种原始采样方式，Demosaicing 的工作就是把它还原成完整的彩色图。

5. 参数含义解析

参数名	类型	必填	含义
src	InputArray	是	Bayer 原始图，通常是单通道图像
dst	OutputArray	是	还原后的图像
code	ColorConversionCodes	是	Bayer 图案和插值方式
dstCn	int	否	目标通道数，`0` 表示自动推导

补充说明：

src 一般是 8 位或 16 位单通道图像。
dst 的尺寸和 src 相同。
dstCn 可以用来显式指定输出通道数，但多数时候保持默认即可。
你必须根据 Bayer 的实际排列选择正确的 code，否则颜色会明显偏掉。

6. 应用场景列表

场景名	场景说明	典型用途
场景A：双线性还原	用最基础的方式恢复彩色图	入门教学、快速预览
场景B：VNG 还原	使用 Variable Number of Gradients	边缘更平滑的重建
场景C：Edge-Aware 还原	使用边缘感知算法	更强调细节保留
场景D：灰度还原	直接得到灰度图	统计、检测、调试

7. 函数使用示例（与 WPF 场景一一对应）

说明：下面代码对应 WPF 页面里的 Demosaicing 场景。为了让初学者更容易看懂，这里先构造一张彩色参考图，再把它按 BayerBG 方式压成单通道马赛克图，最后分别用不同算法还原。

using System;
using OpenCvSharp;

internal static class Program
{
    private static void Main()
    {
        // 先构造一张简单的彩色参考图，后面会把它转换成 Bayer 原始图。
        using var reference = CreateReferenceCard();

        // 根据 BayerBG 排列把彩色图压成单通道马赛克图。
        using var bayer = CreateBayerRaw(reference, BayerPattern.Bg);

        // 同一张 Bayer 原图分别用三种方法还原成彩色图。
        using var bilinear = new Mat();
        using var vng = new Mat();
        using var edgeAware = new Mat();
        using var gray = new Mat();

        Cv2.Demosaicing(bayer, bilinear, ColorConversionCodes.BayerBG2BGR);
        Cv2.Demosaicing(bayer, vng, ColorConversionCodes.BayerBG2BGR_VNG);
        Cv2.Demosaicing(bayer, edgeAware, ColorConversionCodes.BayerBG2BGR_EA);
        Cv2.Demosaicing(bayer, gray, ColorConversionCodes.BayerBG2GRAY);

        // 保存原图、马赛克图和还原结果，方便直接对比。
        Cv2.ImWrite("demosaicing_reference.png", reference);
        Cv2.ImWrite("demosaicing_bayer.png", bayer);
        Cv2.ImWrite("demosaicing_bilinear.png", bilinear);
        Cv2.ImWrite("demosaicing_vng.png", vng);
        Cv2.ImWrite("demosaicing_edgeaware.png", edgeAware);
        Cv2.ImWrite("demosaicing_gray.png", gray);

        Console.WriteLine("Demosaicing 演示已完成。");
    }

    private static Mat CreateReferenceCard()
    {
        // 参考图里放几块颜色鲜明的几何图形，这样还原后更容易看出色彩差异。
        var canvas = new Mat(240, 360, MatType.CV_8UC3, new Scalar(244, 241, 236));

        Cv2.Rectangle(canvas, new Rect(20, 26, 108, 78), new Scalar(58, 148, 240), -1, LineTypes.AntiAlias);
        Cv2.Circle(canvas, new Point(204, 86), 48, new Scalar(76, 220, 126), -1, LineTypes.AntiAlias);
        Cv2.Ellipse(canvas, new Point(274, 172), new Size(66, 42), -15, 0, 360, new Scalar(220, 108, 78), -1, LineTypes.AntiAlias);
        Cv2.PutText(canvas, "Bayer", new Point(134, 220), HersheyFonts.HersheySimplex, 0.95, new Scalar(40, 40, 40), 2, LineTypes.AntiAlias);

        return canvas;
    }

    private static Mat CreateBayerRaw(Mat reference, BayerPattern pattern)
    {
        // Bayer 原图只有一个通道，所以这里要把彩色图压成单通道马赛克。
        var bayer = new Mat(reference.Rows, reference.Cols, MatType.CV_8UC1);

        for (var row = 0; row < reference.Rows; row++)
        {
            for (var col = 0; col < reference.Cols; col++)
            {
                var bgr = reference.At<Vec3b>(row, col);
                bayer.At<byte>(row, col) = pattern switch
                {
                    // BayerBG：偶数行偶数列放蓝色，偶数行奇数列放绿色。
                    BayerPattern.Bg when row % 2 == 0 && col % 2 == 0 => bgr.Item0,
                    BayerPattern.Bg when row % 2 == 0 && col % 2 == 1 => bgr.Item1,
                    BayerPattern.Bg when row % 2 == 1 && col % 2 == 0 => bgr.Item1,
                    BayerPattern.Bg => bgr.Item2,
                    _ => bgr.Item0,
                };
            }
        }

        return bayer;
    }

    private enum BayerPattern
    {
        Bg,
    }
}