Spec-Zone.ru › Qt 5.9

Класс 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.

QRectF QGraphicsPixmapItem::boundingRect() const

Переопределено из QGraphicsItem::boundingRect().

bool QGraphicsPixmapItem::contains(const QPointF &point) const

Переопределено из QGraphicsItem::contains().

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/qt-5.9/qgraphicspixmapitem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API