Класс QGraphicsPixmapItem
Класс QGraphicsPixmapItem предоставляет элемент изображения, который можно добавить в QGraphicsScene. Подробнее...
| Заголовок: | #include <QGraphicsPixmapItem> |
| qmake: | QT += widgets |
| С тех пор: | Qt 4.2 |
| Наследует: | QGraphicsItem |
Типы
| перечисление | ShapeMode { MaskShape, BoundingRectShape, HeuristicMaskShape } |
Открытые функции
| QGraphicsPixmapItem(QGraphicsItem *parent = Q_NULLPTR) | |
| QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = Q_NULLPTR) | |
| ~QGraphicsPixmapItem() | |
| QPointF | offset() const |
| QPixmap | pixmap() const |
| void | setOffset(const QPointF &offset) |
| void | setOffset(qreal x, qreal y) |
| void | setPixmap(const QPixmap &pixmap) |
| void | setShapeMode(ShapeMode mode) |
| void | setTransformationMode(Qt::TransformationMode mode) |
| ShapeMode | shapeMode() const |
| Qt::TransformationMode | transformationMode() const |
Переопределенные открытые функции
| virtual QRectF | boundingRect() const |
| virtual bool | contains(const QPointF &point) const |
| virtual bool | isObscuredBy(const QGraphicsItem *item) const |
| virtual QPainterPath | opaqueArea() const |
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) |
| virtual QPainterPath | shape() const |
| virtual int | type() const |
- 176 открытых функций унаследовано от QGraphicsItem
Дополнительные унаследованные члены
- 2 статических открытых члена унаследовано от QGraphicsItem
- 24 защищенных функций унаследовано от QGraphicsItem
Подробное описание
Класс QGraphicsPixmapItem предоставляет элемент изображения, который можно добавить в QGraphicsScene.
Чтобы установить изображение элемента, передайте QPixmap в конструктор QGraphicsPixmapItem или вызовите функцию setPixmap(). Функция pixmap() возвращает текущее изображение.
QGraphicsPixmapItem использует необязательную альфа-маску изображения для обеспечения разумной реализации boundingRect(), shape() и contains().
Изображение отображается в координатах элемента (0, 0), как возвращается функцией offset(). Можно изменить смещение отображения, вызвав setOffset().
Можно установить режим преобразования изображения, вызвав setTransformationMode(). По умолчанию используется Qt::FastTransformation, который обеспечивает быстрое, но не плавное масштабирование. Qt::SmoothTransformation включает QPainter::SmoothPixmapTransform в рисовальщике, а качество зависит от платформы и области просмотра. Результат обычно не так хорош, как прямой вызов QPixmap::scale(). Вызовите transformationMode(), чтобы получить текущий режим преобразования для элемента.
См. также QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsLineItem и Графический фреймворк.
Документация по типам членов
перечисление QGraphicsPixmapItem::ShapeMode
Это перечисление описывает, как QGraphicsPixmapItem рассчитывает свою форму и непрозрачную область.
Значение по умолчанию — MaskShape.
| Постоянная | Значение | Описание |
|---|---|---|
QGraphicsPixmapItem::MaskShape |
0 |
Форма определяется вызовом QPixmap::mask(). Эта форма включает только непрозрачные пиксели изображения. Однако, поскольку форма более сложная, она может быть медленнее, чем другие режимы, и использует больше памяти. |
QGraphicsPixmapItem::BoundingRectShape |
1 |
Форма определяется по контуру изображения. Это самый быстрый режим формы, но он не учитывает прозрачные области изображения. |
QGraphicsPixmapItem::HeuristicMaskShape |
2 |
Форма определяется вызовом QPixmap::createHeuristicMask(). Производительность и потребление памяти аналогичны MaskShape. |
Документация по функциям членов
QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = Q_NULLPTR)
Создаёт QGraphicsPixmapItem. parent передаётся конструктору QGraphicsItem.
См. также QGraphicsScene::addItem().
QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = Q_NULLPTR)
Создаёт QGraphicsPixmapItem с использованием pixmap как изображения по умолчанию. parent передаётся конструктору QGraphicsItem.
См. также QGraphicsScene::addItem().
QGraphicsPixmapItem::~QGraphicsPixmapItem()
Уничтожает QGraphicsPixmapItem.
[virtual] QRectF QGraphicsPixmapItem::boundingRect() const
Переопределено из QGraphicsItem::boundingRect().
[virtual] bool QGraphicsPixmapItem::contains(const QPointF &point) const
Переопределено из QGraphicsItem::contains().
[virtual] bool QGraphicsPixmapItem::isObscuredBy(const QGraphicsItem *item) const
Переопределено из QGraphicsItem::isObscuredBy().
QPointF QGraphicsPixmapItem::offset() const
Возвращает смещение элемента pixmap, которое определяет точку верхнего левого угла pixmap в локальных координатах.
См. также setOffset().
[virtual] QPainterPath QGraphicsPixmapItem::opaqueArea() const
Переопределено из QGraphicsItem::opaqueArea().
[virtual] void QGraphicsPixmapItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Переопределено из QGraphicsItem::paint().
QPixmap QGraphicsPixmapItem::pixmap() const
Возвращает pixmap элемента, или недействительную QPixmap, если pixmap не задан.
См. также setPixmap().
void QGraphicsPixmapItem::setOffset(const QPointF &offset)
Устанавливает смещение элемента pixmap на offset. QGraphicsPixmapItem будет отрисовывать pixmap, используя offset для верхнего левого угла.
См. также offset().
void QGraphicsPixmapItem::setOffset(qreal x, qreal y)
Эта вспомогательная функция эквивалентна вызову setOffset(QPointF(x, y)).
Эта функция была добавлена в Qt 4.3.
void QGraphicsPixmapItem::setPixmap(const QPixmap &pixmap)
Устанавливает pixmap элемента на pixmap.
См. также pixmap().
void QGraphicsPixmapItem::setShapeMode(ShapeMode mode)
Устанавливает режим формы элемента на mode. Режим формы описывает, как QGraphicsPixmapItem вычисляет свою форму. По умолчанию режим равен MaskShape.
См. также shapeMode() и ShapeMode.
void QGraphicsPixmapItem::setTransformationMode(Qt::TransformationMode mode)
Устанавливает режим преобразования элемента pixmap на mode, и включает обновление элемента. Режим по умолчанию — Qt::FastTransformation, который обеспечивает быстрое преобразование без сглаживания.
Qt::SmoothTransformation включает QPainter::SmoothPixmapTransform в рисовальщике, и качество зависит от платформы и области просмотра. Результат обычно не так хорош, как прямой вызов QPixmap::scale().
См. также transformationMode().
[virtual] QPainterPath QGraphicsPixmapItem::shape() const
Переопределено из QGraphicsItem::shape().
ShapeMode QGraphicsPixmapItem::shapeMode() const
Возвращает режим формы элемента. Режим формы описывает, как QGraphicsPixmapItem вычисляет свою форму. По умолчанию режим равен MaskShape.
См. также setShapeMode() и ShapeMode.
Qt::TransformationMode QGraphicsPixmapItem::transformationMode() const
Возвращает режим преобразования pixmap. Режим по умолчанию — Qt::FastTransformation, который обеспечивает быстрое преобразование без сглаживания.
См. также setTransformationMode().
[virtual] int QGraphicsPixmapItem::type() const
Переопределено из QGraphicsItem::type().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qgraphicspixmapitem.html