class QGraphicsPixmapItem#

QGraphicsPixmapItem 类提供了一个可以添加到 QGraphicsScene 的位图项。 更多…

Inheritance diagram of PySide6.QtWidgets.QGraphicsPixmapItem

摘要#

方法#

注意

本文档可能包含从 C++ 自动翻译到 Python 的代码片段。我们总是欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 创建工单的方式来告知我们。

详细说明#

要设置项目的 pixmap，请将 QPixmap 传递给 QGraphicsPixmapItem 的构造函数，或调用 setPixmap() 函数。函数 pixmap() 返回当前 pixmap。

QGraphicsPixmapItem 使用 pixmap 的可选 alpha 掩码来提供对 boundingRect()、 shape() 和 contains() 的合理实现。

../../_images/graphicsview-pixmapitem.png

此 pixmap 在项目的 (0, 0) 坐标处绘制，由 offset() 返回。您可以通过调用 setOffset() 来更改绘图偏移。

您可以通过调用 setTransformationMode() 来设置 pixmap 的变换模式。默认情况下，使用 Qt::FastTransformation，它提供了快速的非平滑比例变换。Qt::SmoothTransformation 在 painter 上启用 QPainter::SmoothPixmapTransform，质量取决于平台和视口。结果通常不如直接调用 QPixmap::scale() 良好。调用 transformationMode() 以获取项目的当前变换模式。

class ShapeMode#

此枚举描述了 QGraphicsPixmapItem 如何计算其形状和透明区域。

默认值是 MaskShape。

常量

说明

QGraphicsPixmapItem.MaskShape

形状是通过调用QPixmap::mask()确定的。这个形状只包含图标的不可透明像素。然而，由于形状更加复杂，因此它可能比其他模式慢，并且使用更多的内存。

QGraphicsPixmapItem.BoundingRectShape

通过追踪图标的轮廓来确定形状。这是最快的形状模式，但它不考虑图标上的任何透明区域。

QGraphicsPixmapItem.HeuristicMaskShape

通过调用QPixmap::createHeuristicMask()来确定形状。性能和内存消耗与MaskShape相似。
__init__([parent=None])#
参数：

parent – QGraphicsItem

构建一个QGraphicsPixmapItem。将parent传递到QGraphicsItem 构造函数。

另请参阅

addItem()

__init__(pixmap[, parent=None])
参数：

构建一个QGraphicsPixmapItem，使用pixmap作为默认图标配图。parent传递给QGraphicsItem 构造函数。

另请参阅

addItem()

offset()#
返回类型：

QPointF

返回图标配件的自定义偏移量，它定义了图标配图的左上角点在本地坐标中的位置。

另请参阅

setOffset()

pixmap()#
返回类型：

QPixmap

返回项目的图标配图，如果没有设置图标配图，则返回一个无效的QPixmap。

另请参阅

setPixmap()

setOffset(offset)#
参数：

offset – QPointF

设置图标配件的自定义偏移量为offset。图标配件将使用offset作为其左上角的偏移量进行绘制。

另请参阅

offset()

setOffset(x, y)
参数：

  • x – 浮点数

  • y – 浮点数

此便捷函数等价于调用setOffset (QPointF(x, y)).

setPixmap(pixmap)#
参数：

pixmap – QPixmap

将项目的小品图设置为pixmap。

另请参阅

pixmap()

setShapeMode(mode)#
参数：

模式 – ShapeMode

将项目的形状模式设置为模式。形状模式描述了QGraphicsPixmapItem如何计算其形状。默认模式是MaskShape 。

另请参阅

shapeMode ShapeMode

setTransformationMode(mode)#
参数：

模式 – TransformationMode

将小品图的转换模式设置为模式，并切换项目的更新。默认模式是Qt::FastTransformation，它提供快速转换，没有平滑效果。

Qt::SmoothTransformation在画家上启用 QPainter::SmoothPixmapTransform，其质量取决于平台和视口。结果通常不如直接调用 QPixmap::scale()。

另请参阅

transformationMode()

shapeMode()#
返回类型：

形状模式

返回项目的形状模式。形状模式描述了QGraphicsPixmapItem如何计算其形状。默认模式是MaskShape 。

另请参阅

setShapeMode ShapeMode

transformationMode()#
返回类型：

转换模式

返回小品图的转换模式。默认模式是Qt::FastTransformation，它提供快速转换，没有平滑效果。