Другой подход, немного отличающийся от подхода , предоставляемого eyllanesc . Хотя это может показаться гораздо более сложным, чем это, я считаю, что он предлагает лучшую реализацию и интерфейс, с добавлением лучшей производительности.
В этом случае вместо переопределения метода рисования (который запускается каждый раз, когдаэлемент окрашен, что случается очень часто), я использую функцию shape() вместе с флагом QGraphicsItem.ItemClipsToShape, которая позволяет ограничить рисование только в пределах границы формы пути.
Что делает shape(), так это возвращает QPainterPath, который включает только «непрозрачные» части элемента, которые будут реагировать на события мыши и обнаружение столкновений (со сценойграницы и другие ее элементы). В случае QGraphicsPixmapItem это также учитывает возможную маску (например, растровое изображение на основе PNG с прозрачными областями или изображение SVG). Установив ItemClipsToShape, мы можем гарантировать, что рисование будет охватывать только те части изображения, которые находятся внутри этой фигуры.
Основным преимуществом этого подхода является то, что взаимодействие мыши и обнаружение столкновений с другими элементами учитывают фактический кругФорма изделия
Это означает, что если вы щелкнете за пределами круга (но все еще в пределах прямоугольника область полного изображения), элемент не получит событие. Кроме того, если изображение поддерживает маскирование (PNG с прозрачными областями), которое по умолчанию не будет частью фигуры, этот метод будет учитывать это.
Кроме того, «кэшируя» фигуру, мы такженемного ускорить процесс рисования (поскольку Qt позаботится об этом, без какой-либо обработки, выполняемой с использованием python).
class CircleClipPixmapItem(QtGui.QGraphicsPixmapItem):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.setFlag(self.ItemClipsToShape)
self.updateRect()
def updateRect(self):
baseRect = super().boundingRect()
minSize = min(baseRect.width(), baseRect.height())
self._boundingRect = QtCore.QRectF(0, 0, minSize, minSize)
self._boundingRect.moveCenter(baseRect.center())
self._shape = QtGui.QPainterPath()
self._shape.addEllipse(self._boundingRect)
# the shape might include transparent areas, using the & operator
# I'm ensuring that _shape only includes the areas that intersect
# the shape provided by the base implementation
self._shape &= super().shape()
def setPixmap(self, pm):
super().setPixmap(pm)
# update the shape to reflect the new image size
self.updateRect()
def setShapeMode(self, mode):
super().setShapeMode(mode)
# update the shape with the new mode
self.updateRect()
def boundingRect(self):
return self._boundingRect
def shape(self):
return self._shape
Имейте в виду, что есть ловушка для обоих методов:если соотношение сторон изображения сильно отличается от 1: 1, у вас всегда будут проблемы с позиционированием. Например, для моего изображения оно всегда будет отображаться в 60 пикселях справа от фактической позиции элемента. Если вы хотите избежать этого, функция updateRect будет немного отличаться, и, к сожалению, вам придется переопределить функцию paint() (при этом она останется немного быстрее, чем другие параметры):
def updateRect(self):
baseRect = super().boundingRect()
minSize = min(baseRect.width(), baseRect.height())
self._boundingRect = QtCore.QRectF(0, 0, minSize, minSize)
# the _boundingRect is *not* centered anymore, but a new rect is created
# as a reference for both shape intersection and painting
refRect= QtCore.QRectF(self._boundingRect)
refRect.moveCenter(baseRect.center())
# note the minus sign!
self._reference = -refRect.topLeft()
self._shape = QtGui.QPainterPath()
self._shape.addEllipse(self._boundingRect)
self._shape &= super().shape().translated(self._reference)
# ...
def paint(self, painter, option, widget):
# we are going to translate the painter to the "reference" position,
# let's save its state before that
painter.save()
painter.translate(self._reference)
super().paint(painter, option, widget)
painter.restore()
Это заставит boundingRect (и полученную внутреннюю форму) позиционировать весь элемент в верхнем левом углу позиции элемента.
На следующем рисунке показаны различия между двумя подходами;Я использовал PNG с прозрачными областями, чтобы лучше объяснить всю концепцию.
В верхней части находится исходное изображение, в середине - подход переопределения paint() и, наконец, реализация shape() внизу.
Хотя, кажется, нет никакой разницы между двумя методами, как показано в примерах слева, справа я выделил фактическиеграницы каждого элемента, показывая их boundingRect (синим цветом), shape (красным цветом), которые будут использоваться для событий мыши, обнаружения столкновений и отсечения краски;зеленый кружок показывает общий круг, используемый как для формы, так и для рисования.
Примеры в центре показывают позиционирование на основе исходного размера изображения, в то время как справа вы можете видеть абсолютное позиционирование на основе эффективного размера круга, как объяснено. выше.
Рисование круга вокруг изображения
К сожалению, флаг ItemClipsToShape не поддерживает сглаживание для отсечения: если мы просто нарисуем круг после рисования изображения, результат будет ужасным,Слева вы можете видеть, что круг очень пикселизирован и не полностью перекрывает изображение. Справа - правильное рисование.
Для поддержки этого флаг не должен быть установлен, и функция рисования будет немного отличаться.
class CircleClipPixmapItem(QtGui.QGraphicsPixmapItem):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
# we don't need this anymore:
# self.setFlag(self.ItemClipsToShape)
# always set the shapeMode to the bounding rect without any masking:
# if the image has transparent areas they will be clickable anyway
self.setShapeMode(self.BoundingRectShape)
self.updateRect()
self.pen = QtGui.QPen(QtCore.Qt.red, 2)
# ...
def setPen(self, pen):
self.pen = pen
self.update()
def paint(self, painter, option, widget):
# we are going to translate the painter to the "reference" position,
# and we are also changing the pen, let's save the state before that
painter.save()
painter.translate(.5, .5)
painter.setRenderHints(painter.Antialiasing)
# another painter save "level"
painter.save()
# apply the clipping to the painter
painter.setClipPath(self._shape)
painter.translate(self._reference)
super().paint(painter, option, widget)
painter.restore()
painter.setPen(self.pen)
# adjust the rectangle to precisely match the circle to the image
painter.drawEllipse(self._boundingRect.adjusted(.5, .5, -.5, -.5))
painter.restore()
# restore the state of the painter