当前位置：首页 > news >正文

在Linux系统中使用字符图案和VNC运行Qt Widgets程序

news 来源：原创 2025/7/15 9:40:52

大部分服务器并没有GUI，运行的是基础的Linux系统，甚至是容器。如果我们需要在这些系统中运行带有GUI功能的Qt程序，一般情况下就会报错，比如：

$ ./collidingmice
qt.qpa.xcb: could not connect to display
qt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.Available platform plugins are: linuxfb, wayland-egl, vnc, eglfs, wayland, vkkhrdisplay, minimalegl, minimal, offscreen, textui, xcb.

如果现实情况不允许我们安装图形界面，是不是就完全无法使用这些程序了呢？答案是否定的。本文介绍一些使用GUI程序的例子。

1. Qt的Platform插件机制

Qt 的Platform插件，是用来适配各种GUI环境的框架。从上面出错的提示我们就能看到，它支持很多类的GUI，比如linux的framebuf，以及vnc。为什么Qt能够支持如此多的平台呢？主要原因是Qt本身把GUI完全独立于OS来完全重写，我的一篇文章里详细跟踪了这种从像素开始造轮子的原理：

Qt Desktop Widgets 控件绘图原理逐步分析拆解

其实就是Qt从像素级别在内存中实现了完整的GUI。因此，Qt的程序运行可以完全脱离GUI。

2. 探索：bash下的奶酪鼠鼠

理论上，我们只要有一个支持显示图案的方法，以及一套读取键鼠的驱动，就可以贯通Qt的GUI了。我们签出Qt6.8.1的源码，在 plugins/platform里，加入一个测试插件，就叫"textui"。这个插件是从 minmal直接修改而来，功能不完全，仅用于测试。

这个插件实现了一个字符界面的 backingStore，可以把一幅图的轮廓用彩色的字符显示出来：

#ifndef QBACKINGSTORE_MINIMAL_H
#define QBACKINGSTORE_MINIMAL_H#include <qpa/qplatformbackingstore.h>
#include <qpa/qplatformwindow.h>
#include <QtGui/QImage>
#include <QThread>
#include "textcall.h"
QT_BEGIN_NAMESPACEclass QTextUIBackingStore : public QPlatformBackingStore
{
public:QTextUIBackingStore(QWindow *window);~QTextUIBackingStore();QPaintDevice *paintDevice() override;void flush(QWindow *window, const QRegion &region, const QPoint &offset) override;void resize(const QSize &size, const QRegion &staticContents) override;void initEvent();void exitEvent();
private:QImage mImage;QThread * m_keyThread;textInput * m_textInput;textCall * m_textCall;
};QT_END_NAMESPACE#endif

绘图代码：

#include "qtextuibackingstore.h"
#include "qscreen.h"
#include <QtCore/qdebug.h>
#include <qpa/qplatformscreen.h>
#include <private/qguiapplication_p.h>
#include <QKeyEvent>
#include <ncurses.h>
#include "textgraph_bash.h"QT_BEGIN_NAMESPACE
WINDOW * scr = nullptr;
QColor cls_standard[]{QColor(0,0,0),QColor(255,0,0),QColor(0,255,0),QColor(0,0,255),QColor(255,255,0),QColor(255,0,255),QColor(0,255,255),QColor(255,255,255)};
#define PFF(W,h,w,c) (h * (W*3) + w * 3 + c)using namespace Qt::StringLiterals;QTextUIBackingStore::QTextUIBackingStore(QWindow *window): QPlatformBackingStore(window)
{scr = initscr();start_color();init_pair(1, COLOR_RED, COLOR_BLACK);init_pair(2, COLOR_GREEN, COLOR_BLACK);init_pair(3, COLOR_BLUE, COLOR_BLACK);init_pair(4, COLOR_YELLOW, COLOR_BLACK);init_pair(5, COLOR_MAGENTA, COLOR_BLACK);init_pair(6, COLOR_CYAN, COLOR_BLACK);init_pair(7, COLOR_WHITE, COLOR_BLACK);initEvent();
}QTextUIBackingStore::~QTextUIBackingStore()
{endwin();exitEvent();
}QPaintDevice *QTextUIBackingStore::paintDevice()
{return &mImage;
}
void QTextUIBackingStore::initEvent()
{m_textInput = new textInput;m_textCall = new textCall;m_keyThread = new QThread;m_textInput->moveToThread(m_keyThread);QObject::connect(m_textInput,&textInput::keyPress,m_textCall,&textCall::onKeyPress,Qt::QueuedConnection);m_keyThread->start();
}
void QTextUIBackingStore::exitEvent()
{m_keyThread->terminate();m_textInput->deleteLater();m_textCall->deleteLater();QObject::disconnect(m_textInput,&textInput::keyPress,m_textCall,&textCall::onKeyPress);}
void QTextUIBackingStore::flush(QWindow *window, const QRegion &region, const QPoint &offset)
{Q_UNUSED(window);Q_UNUSED(region);Q_UNUSED(offset);unsigned short int tw,th;if (!get_bash_size(&tw,&th))return;const int img_width = mImage.width();const int img_height = mImage.height();const double sw = img_width *1.0 / tw;const double sh = img_height*1.0 / th;const int dw = sw/2;const int dh = sh/2;const int ds = (dw * 2 + 1) * (dh * 2 +1);const char pAMP[] = " .,`'\":;-+??{]XCUOP#%B@";const int lev = sizeof(pAMP)-1;for (int h = 0;h < th;++h){for (int w = 0;w<tw;++w){const double c_y = h * sh ;const double c_x = w * sw;float r=0,g=0,b=0, p = 0;for (int iy = -dh;iy<=dh;++iy){int y = qRound( c_y + iy);if (y<0) y = 0;if (y>=img_height)      y = img_height - 1;QRgb *line = reinterpret_cast<QRgb*>(mImage.scanLine(y));for (int ix = 0; ix <=dw; ++ix) {int x = qRound(c_x + ix);if (x<0) x = 0;if (x>=img_width) x = img_width-1;QRgb &rgb = line[x];r += qRed(rgb);g += qGreen(rgb);b += qBlue(rgb);//p +=  0.2989 * r + 0.5870 * g + 0.1140 * b;p +=  (r + g + b)/3;}}float r1 = double(r) /ds/ 256;float g1 = double(g) /ds/ 256;float b1 = double(b) /ds/ 256;float mindis = 1e99;int mini = 7;for (int i = 1;i<8;++i){float r2,g2,b2;cls_standard[i].getRgbF(&r2,&g2,&b2);double dis = (r1-r2)*(r1-r2) +  (g1-g2)*(g1-g2) +  (b1-b2)*(b1-b2);if (dis < mindis){mindis = dis;mini = i;}}attron(COLOR_PAIR(mini));p /=256;p/=ds;if (p<0.5)attron(A_NORMAL);elseattron(A_BOLD);p *=lev;if (p>=lev)p = lev -.1;int nv = p;mvprintw(h,w,"%c",pAMP[nv]); // 在指定位置输出字符 A}}refresh();  // 刷新屏幕显示
}void QTextUIBackingStore::resize(const QSize &size, const QRegion &)
{QImage::Format format = QGuiApplication::primaryScreen()->handle()->format();if (mImage.size() != size)mImage = QImage(size, format);
}QT_END_NAMESPACE

上述代码，直接读取 backingStore的图片，并转换为近似色彩的字符图案。我们举例使用Qt Widgets的经典程序 collidingmice 来测试：

$ ./collidingmice -platform textui

可以看到，在bash中，鼠鼠可以自由地在字符奶酪里运动。

在这里插入图片描述

注意，由于我们没有实现键鼠事件，所以这个程序只能看，不能玩。

mouse

3. 实操：使用VNC平台

上面的例子，我们利用bash下 ncurse库，实现了基本的字符显示。ncurse也可以捕捉键鼠，但是由于字符界面的分辨率非常糟糕，要输入汉字、精确拖放都是不行的。其实，Linux下Qt早就想到了我们的需求，提供了VNC插件。

 ./collidingmice -platform  vnc:size=640x640,port=5902

而后，在一台具有GUI的机器，比如windows上，远程VNC到 5902端口，即可看到同样的界面：

在这里插入图片描述

4. Qt GUI 程序开发建议

既然Qt GUI程序可以支持这种平台重载，那就要考虑到对应的使用方式，尤其是对 minimal平台的支持。

minimal平台是一个空壳，不做任何绘图和键鼠事件捕获，因此，可以在自己的代码中加入判断，允许用–service等类似字眼的开关，打开一个后台模式，让GUI程序默默在后台运行功能。
对VNC平台，可以在代码中加入允许从命令行设置最大化的功能，让GUI随着vnc的窗口设置而变。

1. Qt的Platform插件机制

2. 探索：bash下的奶酪鼠鼠

3. 实操：使用VNC平台

4. Qt GUI 程序开发建议

相关文章：