PySide6.QtWidgets.QGraphicsPixmapItem¶

class QGraphicsPixmapItem¶

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

概要¶

方法¶

def __init__()
def offset()
def pixmap()
def setOffset()
def setPixmap()
def setShapeMode()
def setTransformationMode()
def shapeMode()
def transformationMode()

注意

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

详细描述¶

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

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

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

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

另请参阅

QGraphicsPathItem QGraphicsRectItem QGraphicsEllipseItem QGraphicsTextItem QGraphicsPolygonItem QGraphicsLineItem 图形视图框架

class ShapeMode¶

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

默认值为MaskShape。

常量

描述

QGraphicsPixmapItem.MaskShape

形状由调用QPixmap::mask()确定。此形状仅包括位图的不透明像素。然而，由于形状更复杂，它可能比其他模式慢，并且使用更多内存。

QGraphicsPixmapItem.BoundingRectShape

形状由位图的轮廓决定。这是最快的形状模式，但它不考虑位图上的任何透明区域。

QGraphicsPixmapItem.HeuristicMaskShape

形状是通过调用QPixmap::createHeuristicMask()来确定的。性能和内存消耗与MaskShape相似。

常量	描述
QGraphicsPixmapItem.MaskShape	形状由调用QPixmap::mask()确定。此形状仅包括位图的不透明像素。然而，由于形状更复杂，它可能比其他模式慢，并且使用更多内存。
QGraphicsPixmapItem.BoundingRectShape	形状由位图的轮廓决定。这是最快的形状模式，但它不考虑位图上的任何透明区域。
QGraphicsPixmapItem.HeuristicMaskShape	形状是通过调用QPixmap::createHeuristicMask()来确定的。性能和内存消耗与MaskShape相似。

__init__([parent=None])¶

Parameters:: 父级 – QGraphicsItem

构造一个QGraphicsPixmapItem。parent被传递给QGraphicsItem的构造函数。

另请参阅

addItem()

__init__(pixmap[, parent=None])

Parameters:

pixmap – QPixmap
parent – QGraphicsItem

构造一个QGraphicsPixmapItem，使用pixmap作为默认的像素图。parent被传递给QGraphicsItem的构造函数。

另请参阅

addItem()

offset()¶

Return type:: QPointF

返回pixmap项的偏移量，该偏移量定义了pixmap左上角的点，使用局部坐标表示。

另请参阅

setOffset()

pixmap()¶

Return type:: QPixmap

返回项目的像素图，如果未设置像素图，则返回无效的QPixmap。

另请参阅

setPixmap()

setOffset(offset)¶

Parameters:: 偏移量 – QPointF

将像素图项的偏移量设置为offset。QGraphicsPixmapItem将使用offset作为其左上角来绘制其像素图。

另请参阅

offset()

setOffset(x, y)

Parameters:

x – 浮点数
y – 浮点数

这个便捷函数等同于调用 setOffset (QPointF(x, y))。

setPixmap(pixmap)¶

Parameters:: pixmap – QPixmap

将项目的像素图设置为 pixmap。

另请参阅

pixmap()

setShapeMode(mode)¶

Parameters:: 模式 – ShapeMode

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

另请参阅

shapeMode() ShapeMode

setTransformationMode(mode)¶

Parameters:: mode – TransformationMode

将pixmap项的变换模式设置为mode，并切换项的更新。默认模式是Qt::FastTransformation，它提供了快速的变换，没有平滑效果。

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

另请参阅

transformationMode()

shapeMode()¶

Return type:: ShapeMode

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

另请参阅

setShapeMode() ShapeMode

transformationMode()¶

Return type:: TransformationMode

返回像素图的变换模式。默认模式是Qt::FastTransformation，它提供快速的变换，没有平滑处理。

另请参阅

setTransformationMode()