如何在glDrawPixels中使用Eigen？帧缓冲显示异常排查

针对你用std::vector<Eigen::Vector3f>或std::vector<float>调用glDrawPixels全黑，但OpenCV能正常显示的问题，下面是具体排查和解决步骤：

1. 先搞定光栅位置，这是最容易踩的坑 #

glDrawPixels的绘制位置由glRasterPos控制，如果这个位置不在当前视口的可见范围内，OpenGL会直接跳过绘制。调用glDrawPixels前，重置矩阵并把光栅位置拉到可见区域：

// 切换到投影矩阵，设置匹配窗口的正交投影
glMatrixMode(GL_PROJECTION);
glLoadIdentity();
glOrtho(0, 700, 0, 700, -1, 1);
// 切回模型视图矩阵，重置为单位矩阵
glMatrixMode(GL_MODELVIEW);
glLoadIdentity();

// 把光栅位置设到窗口左下角
glRasterPos2i(0, 0);

如果之前你设置过3D投影（比如gluPerspective），默认的光栅位置大概率在裁剪区外，直接导致绘制失效。

2. 检查颜色值范围是否匹配 #

OpenGL用GL_FLOAT类型传颜色时，只认0.0f到1.0f的归一化值。如果你的frameBuffer里存的是0-255的浮点值（比如直接把uint8_t的颜色转成float没做处理），OpenGL会把超过1.0的值 clamp到1.0，若值为负数或0就会全黑。而OpenCV对颜色范围的兼容更宽松，所以能正常显示。

解决方法是把颜色值归一化：

std::vector<Eigen::Vector3f> normalizedBuffer;
normalizedBuffer.reserve(frameBuffer.size());
for (const auto& color : frameBuffer) {
    normalizedBuffer.push_back(color / 255.0f);
}
// 用归一化后的缓冲区传glDrawPixels
glDrawPixels(700, 700, GL_RGB, GL_FLOAT, normalizedBuffer.data());

3. 确认像素存储对齐设置 #

虽然你的像素格式（每个像素3个float，共12字节）默认对齐（GL_UNPACK_ALIGNMENT=4）没问题，但可以显式禁用对齐避免意外：

glPixelStorei(GL_UNPACK_ALIGNMENT, 1);

4. 别忘了刷新/交换缓冲区 #

如果用的是双缓冲窗口（比如GLUT的GLUT_DOUBLE），调用glDrawPixels后必须交换缓冲区才能看到内容：

// GLUT环境下
glutSwapBuffers();
// 单缓冲的话用glFlush强制刷新
glFlush();

5. 验证视口尺寸和绘制尺寸一致 #

确保视口和你要绘制的像素尺寸匹配：

glViewport(0, 0, 700, 700);

6. 用测试数据排查是不是buffer的问题 #

写个简单的测试代码，生成全红的缓冲区，验证glDrawPixels本身能不能工作：

std::vector<float> testBuffer(700*700*3, 1.0f);
for (int i = 0; i < 700*700; ++i) {
    testBuffer[i*3 + 1] = 0.0f; // 绿通道设0
    testBuffer[i*3 + 2] = 0.0f; // 蓝通道设0
}
// 先做好矩阵和光栅位置设置，再调用
glDrawPixels(700, 700, GL_RGB, GL_FLOAT, testBuffer.data());
glutSwapBuffers();

如果这个测试能显示红色窗口，说明你原frameBuffer的颜色值范围有问题；如果还是黑，继续检查矩阵和视口的设置。

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