Qt 是目前最先進、最完整的跨平臺C++開發工具。它不僅完全實現了一次編寫，所有平臺無差別運行，更提供了幾乎所有開發過程中需要用到的工具。如今，Qt已被運用于超過70個行業、數千家企業，支持數百萬設備及應用。

當您在平板電腦上使用Qt應用程序時， s就會生成。如果您想處理tablet事件，需要重新實現tabletEvent()事件處理程序。當用于繪圖的工具(觸控筆)進入并離開寫字板附近時(即，當它關閉但未按下時)，當工具被按下并從中釋放時，當工具在寫字板上移動時，以及當工具上的一個按鈕被按下或釋放時，都會產生事件。

中可用的信息取決于所使用的設備，本實例可以處理多達三種不同繪圖工具的平板電腦：觸控筆、噴槍和藝術筆。對于這些事件，將包含工具的位置，平板電腦上的壓力、按鈕狀態、垂直傾斜和水平傾斜(即設備與平板電腦垂直方向之間的角度，如果平板電腦硬件可以提供)。噴槍有指輪，這個位置也可以在平板電腦事件中找到；藝術筆提供圍繞垂直于平板表面的軸旋轉，因此它可以用于書法。

在這個例子中，我們實現了一個繪圖程序。您可以用觸控筆在平板電腦上畫畫，就像在紙上用鉛筆一樣。當用噴槍畫畫時，會得到一種虛擬的油漆噴霧，手指輪用來改變噴霧的密度。當您用美術筆繪制時，會得到一條線，它的寬度和端點角度取決于筆的旋轉，壓力和傾斜也可以被分配來改變顏色的alpha和飽和度值以及筆畫的寬度。

本示例包括以下內容：

• MainWindow類繼承，創建菜單，并連接它們的槽和信號。
• TabletCanvas類繼承了并接收tablet事件，它使用事件將其繪制到屏幕外的像素圖上，然后渲染它。
• TabletApplication類繼承了QApplication，這個類處理平板電腦接近事件。
• main()函數創建一個主窗口，并將其顯示為頂層窗口。

Qt技術交流群：166830288      歡迎一起進群討論

在上文中（點擊這里回顧>>），我們為大家介紹了實現平板電腦示例的MainWindow類定義和實現，本文將繼續介紹TabletCanvas類的定義和實現，請繼續關注哦~

TabletCanvas類定義

TabletCanvas類提供了一個平面，用戶可以在上面用平板電腦繪圖。

class TabletCanvas : public QWidget
{
Q_OBJECT

public:
enum Valuator { PressureValuator, TangentialPressureValuator,
TiltValuator, VTiltValuator, HTiltValuator, NoValuator };
Q_ENUM(Valuator)

TabletCanvas();

bool saveImage(const QString &file);
bool loadImage(const QString &file);
void clear();
void setAlphaChannelValuator(Valuator type)
{ m_alphaChannelValuator = type; }
void setColorSaturationValuator(Valuator type)
{ m_colorSaturationValuator = type; }
void setLineWidthType(Valuator type)
{ m_lineWidthValuator = type; }
void setColor(const QColor &c)
{ if (c.isValid()) m_color = c; }
QColor color() const
{ return m_color; }
void setTabletDevice(QTabletEvent *event)
{ updateCursor(event); }

protected:
void tabletEvent(QTabletEvent *event) override;
void paintEvent(QPaintEvent *event) override;
void resizeEvent(QResizeEvent *event) override;

private:
void initPixmap();
void paintPixmap(QPainter &painter, QTabletEvent *event);
Qt::BrushStyle brushPattern(qreal value);
static qreal pressureToWidth(qreal pressure);
void updateBrush(const QTabletEvent *event);
void updateCursor(const QTabletEvent *event);

Valuator m_alphaChannelValuator = TangentialPressureValuator;
Valuator m_colorSaturationValuator = NoValuator;
Valuator m_lineWidthValuator = PressureValuator;
QColor m_color = Qt::red;
QPixmap m_pixmap;
QBrush m_brush;
QPen m_pen;
bool m_deviceDown = false;

struct Point {
QPointF pos;
qreal pressure = 0;
qreal rotation = 0;
} lastPoint;
};

畫布可以改變alpha通道、顏色飽和度和描邊的線寬。我們有一個枚舉，其中列出了QTabletEvent屬性，可以對其進行調整。我們分別為m_alphaChannelValuator、m_colorSaturationValuator和m_lineWidthValuator保留了一個私有變量，并為它們提供了訪問函數。

我們使用m_color在帶有m_pen和m_brush的上繪制，每次接收到時，從lastPoint到當前中給定的點繪制筆畫，然后將位置和旋轉保存在lastPoint中以備下次使用。saveImage()和loadImage()函數將 保存并加載到磁盤，像素圖在paintEvent()中繪制在小部件上。

來自平板的事件解釋是在tabletEvent()中完成的，而paintPixmap()、updateBrush()和updateCursor()是tabletEvent()使用的輔助函數。

TabletCanvas類實現

我們從構造函數開始：

TabletCanvas::TabletCanvas()
: QWidget(nullptr), m_brush(m_color)
, m_pen(m_brush, 1.0, Qt::SolidLine, Qt::RoundCap, Qt::RoundJoin)
{
resize(500, 500);
setAutoFillBackground(true);
setAttribute(Qt::WA_TabletTracking);
}

在構造函數中，我們初始化了大多數類變量。

下面是saveImage()的實現：

bool TabletCanvas::saveImage(const QString &file)
{
return m_pixmap.save(file);
}

實現了將自身保存到磁盤的功能，因此我們只需調用()。

下面是loadImage()的實現：

bool TabletCanvas::loadImage(const QString &file)
{
bool success = m_pixmap.load(file);

if (success) {
update();
return true;
}
return false;
}

我們只需調用load()，它從文件中加載圖像。

下面是tabletEvent()的實現：

void TabletCanvas::tabletEvent(QTabletEvent *event)
{
switch (event->type()) {
case QEvent::TabletPress:
if (!m_deviceDown) {
m_deviceDown = true;
lastPoint.pos = event->position();
lastPoint.pressure = event->pressure();
lastPoint.rotation = event->rotation();
}
break;
case QEvent::TabletMove:
#ifndef Q_OS_IOS
if (event->pointingDevice() && event->pointingDevice()->capabilities().testFlag(QPointingDevice::Capability::Rotation))
updateCursor(event);
#endif
if (m_deviceDown) {
updateBrush(event);
QPainter painter(&m_pixmap);
paintPixmap(painter, event);
lastPoint.pos = event->position();
lastPoint.pressure = event->pressure();
lastPoint.rotation = event->rotation();
}
break;
case QEvent::TabletRelease:
if (m_deviceDown && event->buttons() == Qt::NoButton)
m_deviceDown = false;
update();
break;
default:
break;
}
event->accept();
}

這個函數有三種類型的事件：TabletPress、TabletRelease和TabletMove，它們是在繪圖工具被按下、抬起或在平板上移動時生成的。當設備在平板上按下時，我們將m_deviceDown設置為true；然后就知道當接收到移動事件時應該進行繪制。我們已經實現了updateBrush()來更新m_brush和m_pen，這取決于用戶選擇關注哪個tablet事件屬性。updateCursor()函數選擇一個光標來表示正在使用的繪圖工具，這樣當您將工具懸停在靠近平板電腦的位置時，就可以看到要繪制哪種筆畫。

void TabletCanvas::updateCursor(const QTabletEvent *event)
{
QCursor cursor;
if (event->type() != QEvent::TabletLeaveProximity) {
if (event->pointerType() == QPointingDevice::PointerType::Eraser) {
cursor = QCursor(QPixmap(":/images/cursor-eraser.png"), 3, 28);
} else {
switch (event->deviceType()) {
case QInputDevice::DeviceType::Stylus:
if (event->pointingDevice()->capabilities().testFlag(QPointingDevice::Capability::Rotation)) {
QImage origImg(QLatin1String(":/images/cursor-felt-marker.png"));
QImage img(32, 32, QImage::Format_ARGB32);
QColor solid = m_color;
solid.setAlpha(255);
img.fill(solid);
QPainter painter(&img);
QTransform transform = painter.transform();
transform.translate(16, 16);
transform.rotate(event->rotation());
painter.setTransform(transform);
painter.setCompositionMode(QPainter::CompositionMode_DestinationIn);
painter.drawImage(-24, -24, origImg);
painter.setCompositionMode(QPainter::CompositionMode_HardLight);
painter.drawImage(-24, -24, origImg);
painter.end();
cursor = QCursor(QPixmap::fromImage(img), 16, 16);
} else {
cursor = QCursor(QPixmap(":/images/cursor-pencil.png"), 0, 0);
}
break;
case QInputDevice::DeviceType::Airbrush:
cursor = QCursor(QPixmap(":/images/cursor-airbrush.png"), 3, 4);
break;
default:
break;
}
}
}
setCursor(cursor);
}

如果使用藝術筆(RotationStylus)，則每個TabletMove事件也會調用updateCursor()，并呈現旋轉的光標，以便您可以看到筆尖的角度。

下面是paintEvent()的實現：

void TabletCanvas::initPixmap()
{
qreal dpr = devicePixelRatio();
QPixmap newPixmap = QPixmap(qRound(width() * dpr), qRound(height() * dpr));
newPixmap.setDevicePixelRatio(dpr);
newPixmap.fill(Qt::white);
QPainter painter(&newPixmap);
if (!m_pixmap.isNull())
painter.drawPixmap(0, 0, m_pixmap);
painter.end();
m_pixmap = newPixmap;
}

void TabletCanvas::paintEvent(QPaintEvent *event)
{
if (m_pixmap.isNull())
initPixmap();
QPainter painter(this);
QRect pixmapPortion = QRect(event->rect().topLeft() * devicePixelRatio(),
event->rect().size() * devicePixelRatio());
painter.drawPixmap(event->rect().topLeft(), m_pixmap, pixmapPortion);
}

Qt第一次調用paintEvent()時，m_pixmap是默認構造的，所以() 返回true。既然我們知道要渲染到哪個屏幕，就可以創建具有適當分辨率的像素圖了。我們填充窗口的像素圖的大小取決于屏幕分辨率，因為示例不支持縮放；可能是一個屏幕的DPI高，而另一個屏幕的DPI低，我們還需要繪制背景，因為默認是灰色的。

之后，我們只需在小部件的左上角繪制像素圖。

下面是paintPixmap()的實現：

void TabletCanvas::paintPixmap(QPainter &painter, QTabletEvent *event)
{
static qreal maxPenRadius = pressureToWidth(1.0);
painter.setRenderHint(QPainter::Antialiasing);

switch (event->deviceType()) {
case QInputDevice::DeviceType::Airbrush:
{
painter.setPen(Qt::NoPen);
QRadialGradient grad(lastPoint.pos, m_pen.widthF() * 10.0);
QColor color = m_brush.color();
color.setAlphaF(color.alphaF() * 0.25);
grad.setColorAt(0, m_brush.color());
grad.setColorAt(0.5, Qt::transparent);
painter.setBrush(grad);
qreal radius = grad.radius();
painter.drawEllipse(event->position(), radius, radius);
update(QRect(event->position().toPoint() - QPoint(radius, radius), QSize(radius * 2, radius * 2)));
}
break;
case QInputDevice::DeviceType::Puck:
case QInputDevice::DeviceType::Mouse:
{
const QString error(tr("This input device is not supported by the example."));
#if QT_CONFIG(statustip)
QStatusTipEvent status(error);
QCoreApplication::sendEvent(this, &status);
#else
qWarning() << error;
#endif
}
break;
default:
{
const QString error(tr("Unknown tablet device - treating as stylus"));
#if QT_CONFIG(statustip)
QStatusTipEvent status(error);
QCoreApplication::sendEvent(this, &status);
#else
qWarning() << error;
#endif
}
Q_FALLTHROUGH();
case QInputDevice::DeviceType::Stylus:
if (event->pointingDevice()->capabilities().testFlag(QPointingDevice::Capability::Rotation)) {
m_brush.setStyle(Qt::SolidPattern);
painter.setPen(Qt::NoPen);
painter.setBrush(m_brush);
QPolygonF poly;
qreal halfWidth = pressureToWidth(lastPoint.pressure);
QPointF brushAdjust(qSin(qDegreesToRadians(-lastPoint.rotation)) * halfWidth,
qCos(qDegreesToRadians(-lastPoint.rotation)) * halfWidth);
poly << lastPoint.pos + brushAdjust;
poly << lastPoint.pos - brushAdjust;
halfWidth = m_pen.widthF();
brushAdjust = QPointF(qSin(qDegreesToRadians(-event->rotation())) * halfWidth,
qCos(qDegreesToRadians(-event->rotation())) * halfWidth);
poly << event->position() - brushAdjust;
poly << event->position() + brushAdjust;
painter.drawConvexPolygon(poly);
update(poly.boundingRect().toRect());
} else {
painter.setPen(m_pen);
painter.drawLine(lastPoint.pos, event->position());
update(QRect(lastPoint.pos.toPoint(), event->position().toPoint()).normalized()
.adjusted(-maxPenRadius, -maxPenRadius, maxPenRadius, maxPenRadius));
}
break;
}
}

在這個函數中，我們根據工具的移動繪制像素圖。如果在平板電腦上使用的工具是觸控筆，我們希望在最后已知的位置和當前位置之間畫一條線。同時還假設這是對任何未知設備的合理處理，但是用警告更新狀態欄。如果它是一個噴槍，我們想要繪制一個充滿柔和漸變的圓圈，其密度可以取決于各種事件參數。默認情況下，它取決于切向壓力，即噴槍上手指輪的位置。如果工具是旋轉筆，我們通過繪制梯形筆畫段來模擬毛氈標記。

case QInputDevice::DeviceType::Airbrush:
{
painter.setPen(Qt::NoPen);
QRadialGradient grad(lastPoint.pos, m_pen.widthF() * 10.0);
QColor color = m_brush.color();
color.setAlphaF(color.alphaF() * 0.25);
grad.setColorAt(0, m_brush.color());
grad.setColorAt(0.5, Qt::transparent);
painter.setBrush(grad);
qreal radius = grad.radius();
painter.drawEllipse(event->position(), radius, radius);
update(QRect(event->position().toPoint() - QPoint(radius, radius), QSize(radius * 2, radius * 2)));
}
break;

在updateBrush()中，我們設置用于繪圖的筆和畫筆來匹配m_alphaChannelValuator、m_lineWidthValuator、m_colorSaturationValuator和m_color，將檢查為每個變量設置m_brush和m_pen的代碼：

void TabletCanvas::updateBrush(const QTabletEvent *event)
{
int hue, saturation, value, alpha;
m_color.getHsv(&hue, &saturation, &value, &alpha);

int vValue = int(((event->yTilt() + 60.0) / 120.0) * 255);
int hValue = int(((event->xTilt() + 60.0) / 120.0) * 255);

我們獲取當前drawingcolor的色調、飽和度、值和alpha值，hValue和vValue設置為水平和垂直傾斜，作為0到255之間的數字。原始值的度數從-60到60，即0等于-60、127等于0、255等于60度，測量的角度是在設備和平板的垂線之間(參見 的插圖)。

switch (m_alphaChannelValuator) {
case PressureValuator:
m_color.setAlphaF(event->pressure());
break;
case TangentialPressureValuator:
if (event->deviceType() == QInputDevice::DeviceType::Airbrush)
m_color.setAlphaF(qMax(0.01, (event->tangentialPressure() + 1.0) / 2.0));
else
m_color.setAlpha(255);
break;
case TiltValuator:
m_color.setAlpha(std::max(std::abs(vValue - 127),
std::abs(hValue - 127)));
break;
default:
m_color.setAlpha(255);
}

的alpha通道是一個介于0和255之間的數字，其中0是透明的，255是不透明的，或者是一個浮點數，其中0是透明的，1.0是不透明的，()返回0.0到1.0之間的壓力值。當筆垂直于平板時，我們得到的alpha值最小(即顏色最透明)，選擇垂直和水平傾斜值中的最大值。

switch (m_colorSaturationValuator) {
case VTiltValuator:
m_color.setHsv(hue, vValue, value, alpha);
break;
case HTiltValuator:
m_color.setHsv(hue, hValue, value, alpha);
break;
case PressureValuator:
m_color.setHsv(hue, int(event->pressure() * 255.0), value, alpha);
break;
default:
;
}

HSV顏色模型中的色彩飽和度可以用0到255之間的整數或0到1之間的浮點值給出，我們選擇將alpha表示為整數，因此使用整數值調用()，這意味著我們需要將壓強乘以0到255之間的一個數字。

switch (m_lineWidthValuator) {
case PressureValuator:
m_pen.setWidthF(pressureToWidth(event->pressure()));
break;
case TiltValuator:
m_pen.setWidthF(std::max(std::abs(vValue - 127),
std::abs(hValue - 127)) / 12);
break;
default:
m_pen.setWidthF(1);
}

如果這樣選擇，筆畫的寬度可以隨著壓力的增加而增加。但是當筆的寬度由傾斜控制時，我們讓寬度隨著工具和平板垂直線之間的角度而增加。

if (event->pointerType() == QPointingDevice::PointerType::Eraser) {
m_brush.setColor(Qt::white);
m_pen.setColor(Qt::white);
m_pen.setWidthF(event->pressure() * 10 + 1);
} else {
m_brush.setColor(m_color);
m_pen.setColor(m_color);
}
}

我們最后檢查指針是觸控筆還是橡皮擦，如果是橡皮擦，將顏色設置為像素圖的背景色，并讓壓力決定筆的寬度，否則設置之前在函數中確定的顏色。

未完待續，下期繼續......

Qt Widget組件推薦

• QtitanRibbon - Ribbon UI組件：是一款遵循Microsoft Ribbon UI Paradigm for Qt技術的Ribbon UI組件，QtitanRibbon致力于為Windows、Linux和Mac OS X提供功能完整的Ribbon組件。
• QtitanChart - Qt類圖表組件：是一個C ++庫，代表一組控件，這些控件使您可以快速地為應用程序提供漂亮而豐富的圖表。
• QtitanDataGrid - Qt網格組件：提供了一套完整的標準 QTableView 函數和傳統組件無法實現的獨特功能。使您能夠將不同來源的各類數據加載到一個快速、靈活且功能強大的可編輯網格中，支持排序、分組、報告、創建帶狀列、拖放按鈕和許多其他方便的功能。
• QtitanDocking：允許您像 Visual Studio 一樣為您的偉大應用程序配備可停靠面板和可停靠工具欄。黑色、白色、藍色調色板完全支持 Visual Studio 2019 主題！