QGraphicsPixmapItem¶
The
QGraphicsPixmapItem
class provides a pixmap item that you can add to aQGraphicsScene
. More…
Synopsis¶
Functions¶
def
offset
()def
pixmap
()def
setOffset
(offset)def
setOffset
(x, y)def
setPixmap
(pixmap)def
setShapeMode
(mode)def
setTransformationMode
(mode)def
shapeMode
()def
transformationMode
()
Detailed Description¶
To set the item’s pixmap, pass a
QPixmap
toQGraphicsPixmapItem
‘s constructor, or call thesetPixmap()
function. Thepixmap()
function returns the current pixmap.
QGraphicsPixmapItem
uses pixmap’s optional alpha mask to provide a reasonable implementation ofboundingRect()
,shape()
, andcontains()
.The pixmap is drawn at the item’s (0, 0) coordinate, as returned by
offset()
. You can change the drawing offset by callingsetOffset()
.You can set the pixmap’s transformation mode by calling
setTransformationMode()
. By default,FastTransformation
is used, which provides fast, non-smooth scaling.SmoothTransformation
enablesSmoothPixmapTransform
on the painter, and the quality depends on the platform and viewport. The result is usually not as good as calling QPixmap::scale() directly. CalltransformationMode()
to get the current transformation mode for the item.
-
class
QGraphicsPixmapItem
([parent=None])¶ QGraphicsPixmapItem(pixmap[, parent=None])
- param parent
- param pixmap
QPixmap
Constructs a
QGraphicsPixmapItem
.parent
is passed toQGraphicsItem
‘s constructor.See also
Constructs a
QGraphicsPixmapItem
, usingpixmap
as the default pixmap.parent
is passed toQGraphicsItem
‘s constructor.See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
ShapeMode
¶ This enum describes how
QGraphicsPixmapItem
calculates its shape and opaque area.The default value is .
Constant
Description
QGraphicsPixmapItem.MaskShape
The shape is determined by calling
mask()
. This shape includes only the opaque pixels of the pixmap. Because the shape is more complex, however, it can be slower than the other modes, and uses more memory.QGraphicsPixmapItem.BoundingRectShape
The shape is determined by tracing the outline of the pixmap. This is the fastest shape mode, but it does not take into account any transparent areas on the pixmap.
QGraphicsPixmapItem.HeuristicMaskShape
The shape is determine by calling
createHeuristicMask()
. The performance and memory consumption is similar to .
-
PySide2.QtWidgets.QGraphicsPixmapItem.
offset
()¶ - Return type
QPointF
Returns the pixmap item’s offset , which defines the point of the top-left corner of the pixmap, in local coordinates.
See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
pixmap
()¶ - Return type
QPixmap
Returns the item’s pixmap, or an invalid
QPixmap
if no pixmap has been set.See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
setOffset
(offset)¶ - Parameters
offset –
QPointF
Sets the pixmap item’s offset to
offset
.QGraphicsPixmapItem
will draw its pixmap usingoffset
for its top-left corner.See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
setOffset
(x, y) - Parameters
x –
qreal
y –
qreal
This convenience function is equivalent to calling
setOffset
(QPointF
(x
,y
)).
-
PySide2.QtWidgets.QGraphicsPixmapItem.
setPixmap
(pixmap)¶ - Parameters
pixmap –
QPixmap
Sets the item’s pixmap to
pixmap
.See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
setShapeMode
(mode)¶ - Parameters
mode –
ShapeMode
Sets the item’s shape mode to
mode
. The shape mode describes howQGraphicsPixmapItem
calculates its shape. The default mode isMaskShape
.See also
shapeMode()
ShapeMode
-
PySide2.QtWidgets.QGraphicsPixmapItem.
setTransformationMode
(mode)¶ - Parameters
mode –
TransformationMode
Sets the pixmap item’s transformation mode to
mode
, and toggles an update of the item. The default mode isFastTransformation
, which provides quick transformation with no smoothing.SmoothTransformation
enablesSmoothPixmapTransform
on the painter, and the quality depends on the platform and viewport. The result is usually not as good as calling QPixmap::scale() directly.See also
-
PySide2.QtWidgets.QGraphicsPixmapItem.
shapeMode
()¶ - Return type
Returns the item’s shape mode. The shape mode describes how
QGraphicsPixmapItem
calculates its shape. The default mode isMaskShape
.See also
setShapeMode()
ShapeMode
-
PySide2.QtWidgets.QGraphicsPixmapItem.
transformationMode
()¶ - Return type
TransformationMode
Returns the transformation mode of the pixmap. The default mode is
FastTransformation
, which provides quick transformation with no smoothing.See also
© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.