C# EmguCV PictureBox如何显示无符号16位灰度图像？

问题背景 #

使用单色相机采集8位/16位深度图像，通过EmguCV将相机读取的字节数组创建Mat对象，在EmguCV PictureBox控件显示。8位模式下画面正常，但切换到16位模式时画面全黑。两种模式下将Mat保存到文件后，用画图打开均能正常显示，需排查PictureBox的显示问题。

原代码如下：

// 独立线程中持续从相机获取帧
private int CatureVideoWorker()
{
    while(captureImages) 
    {
        // 用GCMarshal固定缓冲区地址到pinnedImgBuffer
        buffer = readFrameFromCamera(); 
        // 加锁避免GUI线程在写入时访问Mat对象
        lock (syncRoot)      
        {
            lastFrame.Dispose();
            if (8bitMode == true)
                lastFrame = new Mat(_height, _width, Emgu.CV.CvEnum.DepthType.Cv8U, 1, pinnedImgBuffer.AddrOfPinnedObject(), _width);
            else  
                lastFrame = new Mat(_height, _width, Emgu.CV.CvEnum.DepthType.Cv16U, 1, pinnedImgBuffer.AddrOfPinnedObject(), _width * 2);
        }
    }
    return 1;
}

// GUI线程定时器事件，约33ms更新一次PictureBox
private void tmrCaptureFrame_Tick(object sender, EventArgs e)
{
    // 加锁避免Mat对象在克隆时被写入/释放
    lock (syncRoot)
    {
        pbx.Image = lastFrame.Clone();
    }
}

问题原因 #

EmguCV的PictureBox控件默认无法正确渲染16位单通道（Cv16U）图像。GUI控件通常仅支持8位像素数据（范围0-255），而16位图像的像素值范围是0-65535，直接赋值给PictureBox时，大部分像素值会超出8位显示范围，导致画面全黑。画图程序打开16位图像时会自动将数据归一化到8位范围，因此能正常显示。

解决方案 #

在将Mat赋值给PictureBox之前，将16位图像转换为8位图像，以下两种方式按需选择：

1. 线性缩放（ConvertScaleAbs） #

直接将0-65535的像素值线性映射到0-255，适合像素值覆盖全范围的场景：

private void tmrCaptureFrame_Tick(object sender, EventArgs e)
{
    lock (syncRoot)
    {
        using (var tempFrame = lastFrame.Clone())
        {
            Mat displayFrame = new Mat();
            if (!8bitMode)
            {
                // 16位转8位：将0-65535线性映射到0-255
                CvInvoke.ConvertScaleAbs(tempFrame, displayFrame, 255.0 / 65535.0);
            }
            else
            {
                displayFrame = tempFrame.Clone();
            }
            pbx.Image = displayFrame;
        }
    }
}

2. 归一化（Normalize） #

将图像中的最小/最大像素值拉伸到0-255，适合像素值集中在某一区间的场景：

private void tmrCaptureFrame_Tick(object sender, EventArgs e)
{
    lock (syncRoot)
    {
        using (var tempFrame = lastFrame.Clone())
        {
            Mat displayFrame = new Mat();
            if (!8bitMode)
            {
                // 归一化到8位范围，拉伸像素值区间
                CvInvoke.Normalize(tempFrame, displayFrame, 0, 255, 
                    Emgu.CV.CvEnum.NormType.MinMax, Emgu.CV.CvEnum.DepthType.Cv8U);
            }
            else
            {
                displayFrame = tempFrame.Clone();
            }
            pbx.Image = displayFrame;
        }
    }
}

注意事项 #

• 使用using语句临时克隆原Mat，避免转换过程中原Mat被线程修改
• 转换操作放在GUI线程（Timer Tick事件）中执行，避免跨线程资源冲突
• 转换后的Mat会由PictureBox自动管理释放，无需手动Dispose

内容的提问来源于stack exchange，提问作者p0miki