跨线程场景下WPF中OpenGL生成的WriteableBitmap无法绑定Image控件问题

问题场景 #

• 运行环境为.NET Core 3.1平台下的WPF应用，OpenGL上下文托管在隐藏的GLFW窗口中，渲染完成后通过glReadPixels读取像素数据，最终将结果展示到UI层的Image控件上
• 单线程执行全流程时代码逻辑完全正常，本质是位图对象创建在UI线程，线程所有权匹配
• 切换到独立工作线程调用同一套渲染逻辑时，Image控件无法正常显示图像
• 已完成本地文件校验：在工作线程中将生成的WriteableBitmap通过BmpBitmapEncoder保存为本地bmp文件，文件内容完整无损坏，可确认WriteableBitmap的创建流程、像素数据本身均无问题
• 已尝试通过Dispatcher.BeginInvoke将控件赋值操作切换到UI线程执行，仍未解决显示问题

原始代码逻辑 #

byte[] imageBuffer = new byte[imageWidth * imageHeight * 4];
glReadPixels(0, 0, imageWidth, imageHeight, GL_BGRA, GL_UNSIGNED_BYTE, imageBuffer);
imageBuffer = ImageReverse(imageBuffer, imageWidth);
PixelFormat pixelFormat = PixelFormats.Pbgra32;
int rawStride = (imageWidth * pixelFormat.BitsPerPixel) / 8;
BitmapSource bitmapSource = BitmapSource.Create(imageWidth, imageHeight, 96, 96, pixelFormat, null, imageBuffer, rawStride);
WriteableBitmap writeableBitmap = new WriteableBitmap(bitmapSource);

// 校验逻辑：将WriteableBitmap保存为本地文件
using (FileStream fileStream = new FileStream(@"C:\Temp\Image1.bmp", FileMode.Create))
{
    BmpBitmapEncoder encoder = new BmpBitmapEncoder();
    encoder.Frames.Add(BitmapFrame.Create(writeableBitmap));
    encoder.Save(fileStream);
}

Action action = new Action(() => {
    _imgSoilProfile.Source = writeableBitmap; 
});
_imgSoilProfile.Dispatcher.BeginInvoke(action, DispatcherPriority.Send);

问题核心根因 #

出现显示异常的本质是WPF对DispatcherObject的线程所有权绑定规则：

• 所有WPF的UI相关对象，包括BitmapSource、WriteableBitmap这类继承自DispatcherObject的位图资源，在创建时会自动绑定到当前执行线程的Dispatcher上。只有绑定到UI线程Dispatcher的位图资源，才能被WPF渲染引擎正常读取、渲染到屏幕上。
• 原代码里的BitmapSource和WriteableBitmap都是在工作线程中创建的，这些对象的所有权直接绑定到了工作线程的Dispatcher上。哪怕后续通过Dispatcher.BeginInvoke把给Image.Source赋值的操作切回UI线程执行，位图对象本身的线程绑定关系没有变化，WPF渲染引擎在访问跨线程所有权的位图资源时，会静默跳过渲染流程，不会抛出可捕获的异常，最终表现就是Image控件空白无内容。
• 本地文件保存的校验逻辑不涉及WPF的跨线程渲染校验，仅对内存中的像素字节做序列化写入，因此可以正常生成完整的图像文件，刚好验证了像素数据本身没有问题，但无法绕开WPF的线程绑定规则。

修复方案 #

调整执行流程，把所有WPF位图对象的创建操作移到UI线程的上下文中执行，从根源上保证位图对象的线程所有权绑定到UI线程：

1. 工作线程内仅执行OpenGL像素读取、像素格式翻转等纯内存字节处理操作，保留处理完成的像素字节数组，不要在工作线程创建任何WPF位图对象
2. 携带处理完成的像素字节数组，通过Dispatcher将后续的位图创建、控件赋值操作切换到UI线程执行
3. 调整后的核心代码参考：

// 工作线程内完成OpenGL读取和像素处理，不创建WPF位图对象
byte[] imageBuffer = new byte[imageWidth * imageHeight * 4];
glReadPixels(0, 0, imageWidth, imageHeight, GL_BGRA, GL_UNSIGNED_BYTE, imageBuffer);
imageBuffer = ImageReverse(imageBuffer, imageWidth);
PixelFormat pixelFormat = PixelFormats.Pbgra32;
int rawStride = (imageWidth * pixelFormat.BitsPerPixel) / 8;

// 所有WPF对象创建、控件赋值操作全部在UI线程上下文执行
_imgSoilProfile.Dispatcher.Invoke(() => 
{
    BitmapSource bitmapSource = BitmapSource.Create(imageWidth, imageHeight, 96, 96, pixelFormat, null, imageBuffer, rawStride);
    WriteableBitmap writeableBitmap = new WriteableBitmap(bitmapSource);
    _imgSoilProfile.Source = writeableBitmap;
});

注意：原代码中使用DispatcherPriority.Send的高优先级BeginInvoke操作没有生效，本质是因为问题不在赋值操作的执行线程，而在于被赋值的位图对象本身的线程所有权绑定错误，仅调整赋值操作的优先级或执行线程无法解决根本问题。

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