前言
继续
正文
#if QT_DEPRECATED_SINCE(5, 13) #endif
包裹的部分是被弃用的函数,我以前的文章有说怎么看,这里就不说了。
1.drawTiledPixmap
系列函数 绘制平铺的图像
QPainter
的 drawTiledPixmap
函数用于在绘图设备上平铺绘制 QPixmap
图像。这些函数的目的都是将 QPixmap
图像平铺在指定的区域内。下面详细解释每个版本的用法和参数:
-
void drawTiledPixmap(const QRectF &rect, const QPixmap &pm, const QPointF &offset = QPointF());
- 参数:
rect
: 指定要绘制QPixmap
图像的区域,类型为QRectF
,通常是一个浮点矩形。pm
: 要平铺的QPixmap
对象。offset
: 指定平铺图像的偏移量,类型为QPointF
。默认为(0, 0)
,即没有偏移。
- 参数:
-
inline void drawTiledPixmap(int x, int y, int w, int h, const QPixmap &, int sx=0, int sy=0);
- 参数:
x, y
: 指定平铺区域的左上角位置,类型为整数。w, h
: 指定平铺区域的宽度和高度,类型为整数。pm
: 要平铺的QPixmap
对象。sx, sy
: 图像的起始点偏移量,类型为整数,默认为(0, 0)
。
- 参数:
-
inline void drawTiledPixmap(const QRect &, const QPixmap &, const QPoint & = QPoint());
- 参数:
QRect
: 指定要绘制QPixmap
图像的区域,类型为整数矩形。pm
: 要平铺的QPixmap
对象。offset
: 图像的偏移量,类型为QPoint
。默认为(0, 0)
,即没有偏移。
- 参数:
注意事项
- 1.这里的偏移量,第一个参数sx为正时图像向左移动,为负时向右移动;第二个参数sy为正时图像向上移动,为负时向下移动
- 2.如果用纯色来填充pixmap时,无论你如何调整偏移图像都不会改变,以为图像变化了你也看不出来(纯色).
- 3.对于你指定的rect,平铺的图像会将你指定的rect填充完
例子
void PaintWidget::paintEvent(QPaintEvent* event)
{
Q_UNUSED(event);
QPainter painter(this);
// 设置抗锯齿
painter.setRenderHint(QPainter::Antialiasing, true);
// 设置粗一点
QPen pen;
pen.setWidth(3);
painter.setPen(pen);
// 用大小初始化一个QPixmap
QPixmap pixmap(10,10);
pixmap.fill(Qt::blue); // 填充蓝色图像用于测试
QRect rect(200,0,width(),height());
// 使用 drawTiledPixmap(int x, int y, int w, int h, const QPixmap &, int sx=0, int sy=0)
int x = 10, y = 10, w = 100, h = 100;
// 图像起始点偏移量,设置了也没用对于纯色而言看不出来
int sx = 20, sy = 20;
painter.drawTiledPixmap(x, y, w, h, pixmap, sx, sy);
// 使用 drawTiledPixmap(const QRect &, const QPixmap &, const QPoint & = QPoint())
QPixmap pixmap2("D:/all_the_code/qt_code/ts/playQPainter/t1.png");
// 图像起始点偏移量,向左上移动
QPoint offset(-10,10);
painter.drawTiledPixmap(rect, pixmap2, offset);
}
2.drawPicture系列函数 绘制图片
#ifndef QT_NO_PICTURE
- 这是一条预处理指令,意思是在编译时,如果未定义
QT_NO_PICTURE
,则编译和包含随后的代码。换句话说,如果QT_NO_PICTURE
被定义了,意味着Qt库被配置为不支持QPicture
,则这些绘制函数将被排除在编译之外。
-
void drawPicture(const QPointF &p, const QPicture &picture);
- 这个函数在浮点数坐标
(p.x(), p.y())
处绘制QPicture
。QPointF
是一个表示二维浮点数坐标的类。
- 这个函数在浮点数坐标
-
inline void drawPicture(int x, int y, const QPicture &picture);
- 这是一个内联函数,用于在整数坐标
(x, y)
处绘制QPicture
。inline
关键字提示编译器尝试将此函数的代码直接嵌入到调用点,以减少函数调用的开销。
- 这是一个内联函数,用于在整数坐标
-
inline void drawPicture(const QPoint &p, const QPicture &picture);
- 另一个内联函数,用于在整数坐标
p
处绘制QPicture
,其中QPoint
是一个表示二维整数坐标的类。
- 另一个内联函数,用于在整数坐标
例子
void PaintWidget::paintEvent(QPaintEvent* event)
{
Q_UNUSED(event);
QPainter painter(this);
// 设置抗锯齿
painter.setRenderHint(QPainter::Antialiasing, true);
// 设置粗一点
QPen pen;
pen.setWidth(3);
painter.setPen(pen);
// 创建一个 QPicture 对象并记录绘图操作
//QPicture 主要用于记录和回放绘图命令,而不是直接加载和保存图像。
QPicture picture;
QPainter picPainter(&picture);
// 在 picture 中绘制图像
picPainter.setBrush(Qt::green);
picPainter.drawRect(10, 10, 100, 100); // 绘制一个绿色矩形
picPainter.drawEllipse(50, 50, 50, 50); // 绘制一个椭圆
picPainter.end(); // 结束记录
// 使用 drawPicture 在 widget 上绘制已记录的图像
painter.drawPicture(0, 0, picture);
}
3.drawPixmap系列函数 绘制像素图(Pixmap)
-
void drawPixmap(const QRectF &targetRect, const QPixmap &pixmap, const QRectF &sourceRect);
- 功能:将
pixmap
的sourceRect
区域绘制到目标矩形targetRect
中。 - 参数:
targetRect
:目标区域,以浮点矩形QRectF
表示,指定pixmap
将被绘制到的区域。pixmap
:要绘制的QPixmap
对象。sourceRect
:源区域,以浮点矩形QRectF
表示,指定pixmap
中要绘制的部分。
-
inline void drawPixmap(const QRect &targetRect, const QPixmap &pixmap, const QRect &sourceRect);
- 功能:与上一个函数类似,但使用整数矩形
QRect
代替浮点矩形。
-
inline void drawPixmap(int x, int y, int w, int h, const QPixmap &pm, int sx, int sy, int sw, int sh);
- 功能:将
pm
的某一部分(指定为从点(sx, sy)
开始,宽sw
,高sh
的区域)绘制到目标区域(x, y, w, h)
。 - 参数:
x
,y
,w
,h
:目标区域的左上角坐标(x, y)
及其宽度w
和高度h
。pm
:要绘制的QPixmap
对象。sx
,sy
,sw
,sh
:源区域的左上角坐标(sx, sy)
及其宽度sw
和高度sh
。
-
inline void drawPixmap(int x, int y, const QPixmap &pm, int sx, int sy, int sw, int sh);
-
功能:在目标点
(x, y)
处绘制pm
的某一部分(从(sx, sy)
开始,宽sw
,高sh
的区域)。 -
inline void drawPixmap(const QPointF &p, const QPixmap &pm, const QRectF &sr);
-
功能:在浮点坐标
p
处绘制pm
的sr
区域。 -
inline void drawPixmap(const QPoint &p, const QPixmap &pm, const QRect &sr);
-
功能:在整数坐标
p
处绘制pm
的sr
区域。 -
void drawPixmap(const QPointF &p, const QPixmap &pm);
-
功能:在浮点坐标
p
处绘制完整的QPixmap
对象pm
。 -
inline void drawPixmap(const QPoint &p, const QPixmap &pm);
-
功能:在整数坐标
p
处绘制完整的QPixmap
对象pm
。 -
inline void drawPixmap(int x, int y, const QPixmap &pm);
-
功能:在整数坐标
(x, y)
处绘制完整的QPixmap
对象pm
。 -
inline void drawPixmap(const QRect &r, const QPixmap &pm);
-
功能:将
QPixmap
对象pm
缩放或拉伸以适应目标矩形r
,并绘制出来。 -
inline void drawPixmap(int x, int y, int w, int h, const QPixmap &pm);
-
功能:将
QPixmap
对象pm
缩放或拉伸以适应目标矩形(x, y, w, h)
,并绘制出来。
例子
void PaintWidget::paintEvent(QPaintEvent* event)
{
Q_UNUSED(event);
QPainter painter(this);
// 设置抗锯齿
painter.setRenderHint(QPainter::Antialiasing, true);
// 设置粗一点
QPen pen;
pen.setWidth(3);
painter.setPen(pen);
// 加载图像到 QPixmap,替换为你的图片路径
QPixmap pixmap("D:/all_the_code/qt_code/ts/playQPainter/t1.png");
// 测试1:inline void drawPixmap(int x, int y, const QPixmap &pm);
// 在原始大小下绘制图片
painter.drawPixmap(10, 10, pixmap);
// 测试2:inline void drawPixmap(int x, int y, int w, int h, const QPixmap &pm);
// 缩放绘制图片到指定大小
painter.drawPixmap(200, 10, 100, 100, pixmap);
// 测试3:inline void drawPixmap(int x, int y, int w, int h, const QPixmap &pm, int sx, int sy, int sw, int sh);
//绘制图片的一部分,将pm 的某一部分(指定为从点 (sx, sy) 开始,宽sw,高sh的区域)绘制到目标区域(x, y, w, h)
painter.drawPixmap(100, 200, 50, 50, pixmap, 30,30,50,50);
// 测试4:使用 QPainter 的平移操作绘制图片
painter.translate(200, 200);
painter.drawPixmap(0, 0, pixmap.scaled(50, 50));
// 测试5:以某个角度旋转并绘制图片
painter.resetTransform(); // 重置平移变换
painter.translate(300, 200);
painter.rotate(45);
painter.drawPixmap(0, 0, pixmap.scaled(100, 100));
// 测试6:inline void drawPixmap(const QRect &r, const QPixmap &pm);
// 将 `QPixmap` 对象 `pm` 缩放或拉伸以适应目标矩形 `r`,并绘制出来
QRect targetRect(350, 10, 150, 150);
painter.drawPixmap(targetRect, pixmap);
}
4.drawPixmapFragments 绘制像素图片段
void drawPixmapFragments(const PixmapFragment *fragments, int fragmentCount, const QPixmap &pixmap, PixmapFragmentHints hints = PixmapFragmentHints());
用于将一个QPixmap
对象中的多个片段(或碎片)绘制到指定的目标区域。这些片段由PixmapFragment
结构体定义,可以在一个绘图操作中同时绘制多个片段。
参数解析:
-
const PixmapFragment *fragments
:PixmapFragment
的一个对象,PixmapFragment
是一个类,在序列二说过。
-
int fragmentCount
:- 片段的数量,表示
fragments
数组中有多少个PixmapFragment
需要被绘制。
- 片段的数量,表示
-
const QPixmap &pixmap
:- 被绘制的
QPixmap
对象,所有片段的源图像。
- 被绘制的
-
PixmapFragmentHints hints = PixmapFragmentHints()
:- 可选参数,定义一些提示(hints),用于控制片段绘制的行为。默认是空的
PixmapFragmentHints
,不提供任何特殊的绘制提示。PixmapFragmentHints
是一个枚举值。
- 可选参数,定义一些提示(hints),用于控制片段绘制的行为。默认是空的
用途:
这个函数非常适合需要从同一个 QPixmap
中绘制多个不同部分的场景,尤其是在游戏开发或复杂UI设计中,它可以用来绘制精灵图(Sprite)、拼图等。通过一次调用 drawPixmapFragments
,可以避免多个 drawPixmap
调用带来的开销,提高渲染效率。
例子
void PaintWidget::paintEvent(QPaintEvent* event)
{
Q_UNUSED(event);
QPainter painter(this);
// 设置抗锯齿
painter.setRenderHint(QPainter::Antialiasing, true);
// 设置粗一点
QPen pen;
pen.setWidth(3);
painter.setPen(pen);
// 加载图像到 QPixmap,替换为你的图片路径
QPixmap pixmap("D:/all_the_code/qt_code/ts/playQPainter/t1.png");
// 定义片段,PixmapFragment是一个类,再序列二讲过,这里创建一个对象的数组
QPainter::PixmapFragment fragments[3];
fragments[0] = QPainter::PixmapFragment::create(QPointF(50, 50), QRectF(0, 0, 50, 50)); // 左上角部分
fragments[1] = QPainter::PixmapFragment::create(QPointF(150, 50), QRectF(50, 0, 50, 50)); // 右上角部分
fragments[2] = QPainter::PixmapFragment::create(QPointF(100, 150), QRectF(0, 50, 50, 50)); // 左下角部分
// 调整片段属性
fragments[0].rotation = 45; // 旋转 45 度
fragments[1].scaleX = 2.0; // 横向放大 2 倍
fragments[1].scaleY = 0.5; // 纵向缩小 0.5 倍
fragments[2].opacity = 0.5; // 设置半透明
// 绘制片段
painter.drawPixmapFragments(fragments, 3, pixmap);
}
5.drawImage系列函数 绘制图像
-
void drawImage(const QRectF &targetRect, const QImage &image, const QRectF &sourceRect, Qt::ImageConversionFlags flags = Qt::AutoColor);
- 描述: 将
QImage
对象的sourceRect
区域绘制到targetRect
区域。sourceRect
定义了从QImage
中绘制的区域,targetRect
定义了在目标设备上绘制的区域。 flags
: 图像转换标志(默认是Qt::AutoColor
),用于控制绘制时的颜色处理,如是否使用透明背景等。
- 描述: 将
-
inline void drawImage(const QRect &targetRect, const QImage &image, const QRect &sourceRect, Qt::ImageConversionFlags flags = Qt::AutoColor);
- 描述: 与上述函数类似,但接受
QRect
对象作为参数。sourceRect
和targetRect
分别是源图像和目标区域的矩形。
- 描述: 与上述函数类似,但接受
-
inline void drawImage(const QPointF &p, const QImage &image, const QRectF &sr, Qt::ImageConversionFlags flags = Qt::AutoColor);
- 描述: 将
QImage
对象的sr
区域绘制到从p
开始的位置。sr
定义了从图像中绘制的区域,p
是目标位置的起点。
- 描述: 将
-
inline void drawImage(const QPoint &p, const QImage &image, const QRect &sr, Qt::ImageConversionFlags flags = Qt::AutoColor);
- 描述: 与上述函数类似,但接受
QPoint
对象作为目标位置。sr
是源图像的矩形区域。
- 描述: 与上述函数类似,但接受
-
inline void drawImage(const QRectF &r, const QImage &image);
- 描述: 将整个
QImage
对象绘制到r
区域。r
定义了目标区域的矩形。如果不指定sourceRect
,则整个图像都会被绘制到目标区域。
- 描述: 将整个
-
inline void drawImage(const QRect &r, const QImage &image);
- 描述: 与上述函数类似,但接受
QRect
对象作为参数。将整个QImage
绘制到指定的矩形区域r
。
- 描述: 与上述函数类似,但接受
-
void drawImage(const QPointF &p, const QImage &image);
- 描述: 将整个
QImage
对象绘制到从p
开始的位置。如果没有指定目标矩形,图像将以其原始尺寸绘制到p
的位置。
- 描述: 将整个
示例代码
下面是一个示例,展示如何使用这些 drawImage
函数将图像绘制到不同的区域:
void PaintWidget::paintEvent(QPaintEvent* event)
{
Q_UNUSED(event);
QPainter painter(this);
// 设置抗锯齿
painter.setRenderHint(QPainter::Antialiasing, true);
// 设置粗一点
QPen pen;
pen.setWidth(3);
painter.setPen(pen);
// 加载图像到 QPixmap,替换为你的图片路径
QImage image;
image.load("D:/all_the_code/qt_code/ts/playQPainter/t1.png");
// 定义目标区域和源图像区域,目标区域越大,图像也会相应增大
QRect targetRect(10, 10, 100, 100);
QRect sourceRect(0, 0, 50, 50);
// 绘制图像的一部分到指定区域
painter.drawImage(targetRect, image, sourceRect);
// 定义另一个区域和目标位置
QRect targetRect2(220, 10, 200, 200);
QRect sourceRect2(0, 0, image.width(), image.height());
// 绘制图像的全部内容到另一个指定区域
painter.drawImage(targetRect2, image, sourceRect2);
// 绘制图像的部分到指定位置
QPoint position(10, 220);
painter.drawImage(position, image, sourceRect);
// 直接绘制图像到指定区域
QRectF rect(100, 200, 100, 100);
painter.drawImage(rect, image);
}
注意事项
-
目标区域与源区域:
targetRect
定义了图像在目标设备上的绘制区域。如果sourceRect
和targetRect
的比例不同,图像可能会被拉伸或缩放。sourceRect
定义了从图像中绘制的区域。如果不指定sourceRect
,整个图像会被绘制。
-
图像转换标志:
flags
参数可以控制图像的颜色处理。例如,Qt::AutoColor
是默认值,会自动处理颜色转换。如果需要特定的图像处理效果,可以设置其他标志。
-
绘制区域的尺寸:
- 确保
targetRect
足够大以容纳图像。如果目标区域比图像小,图像会被裁剪。
- 确保