Описание класса QGraphicsPixmapItem

Класс QGraphicsPixmapItem предоставляет элемент растрового изображения, который вы можете добавить на QGraphicsScene. Далее...

 #include <QGraphicsPixmapItem>

Унаследован от: QGraphicsItem.

Класс был добавлен в Qt 4.2.

Список всех членов, включая унаследованные

Открытые типы

enum	ShapeMode { MaskShape, BoundingRectShape, HeuristicMaskShape }

Открытые функции

	QGraphicsPixmapItem ( QGraphicsItem * parent = 0 )
	QGraphicsPixmapItem ( const QPixmap & pixmap, QGraphicsItem * parent = 0 )
	~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

177 открытых функций, унаследованных от 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() чтобы получить текущий режим преобразования для элемента.

Описание типов-членов

enum QGraphicsPixmapItem::ShapeMode

Это перечисление описывает как QGraphicsPixmapItem вычисляет свою форму и область отрисовки.

Значением по умолчанию является MaskShape.

Константа	Значение	Описание
`QGraphicsPixmapItem::MaskShape`	`0`	Фигура определяется вызовогм QPixmap::mask(). Эта фигура включает только непрозрачные пиксели растрового изображения. Так как в этом случае фигура более сложная, он может быть медленнее чем другие режимы и использует больше памяти.
`QGraphicsPixmapItem::BoundingRectShape`	`1`	Фигура определяется отслеживанием контура растрового изображения. Это самый быстрый режим фигуры, но он не учитывает прозрачные области растрового изображения.
`QGraphicsPixmapItem::HeuristicMaskShape`	`2`	Фигура определяется вызовом QPixmap::createHeuristicMask(). Производительность и потребление памяти похожи на MaskShape.

Описание функций-членов

QGraphicsPixmapItem::QGraphicsPixmapItem ( QGraphicsItem * parent = 0 )

Создаёт QGraphicsPixmapItem. parent передаётся в конструктор QGraphicsItem.

Смотрите также QGraphicsScene::addItem().

QGraphicsPixmapItem::QGraphicsPixmapItem ( const QPixmap & pixmap, QGraphicsItem * parent = 0 )

Создаёт QGraphicsPixmapItem, используя pixmap в качестве растрового изображения по умолчанию. parent передаётся в конструктор QGraphicsItem.

Смотрите также QGraphicsScene::addItem().

QGraphicsPixmapItem::~QGraphicsPixmapItem ()

Уничтожает QGraphicsPixmapItem.

QRectF QGraphicsPixmapItem::boundingRect () const `[virtual]`

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

bool QGraphicsPixmapItem::contains ( const QPointF & point ) const `[virtual]`

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

bool QGraphicsPixmapItem::isObscuredBy ( const QGraphicsItem * item ) const `[virtual]`

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

QPointF QGraphicsPixmapItem::offset () const

Возвращает смещение растрового изображения элемента offset, которое определяет точку верхнего левого угла растрового изображения в локальных координатах.

Смотрите также setOffset().

QPainterPath QGraphicsPixmapItem::opaqueArea () const `[virtual]`

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

void QGraphicsPixmapItem::paint ( QPainter * painter, const QStyleOptionGraphicsItem * option, QWidget * widget ) `[virtual]`

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

QPixmap QGraphicsPixmapItem::pixmap () const

Возвращает растровое изображение элемента или неверный QPixmap, если растровое изображение не было установлено.

Смотрите также setPixmap().

void QGraphicsPixmapItem::setOffset ( const QPointF & offset )

Устанавливает смещение растрового изображения элемента равным offset. QGraphicsPixmapItem будет отрисовывать своё растровое изображение используя смещение offset для его верхнего левого угла.

Смотрите также offset().

void QGraphicsPixmapItem::setOffset ( qreal x, qreal y )

Эта вспомогательная функция эквивалента вызову setOffset(QPointF(x, y)).

Эта функция была введена в Qt 4.3.

void QGraphicsPixmapItem::setPixmap ( const QPixmap & pixmap )

Устанавливает растровое изображение элемента равным pixmap.

Смотрите также pixmap().

void QGraphicsPixmapItem::setShapeMode ( ShapeMode mode )

Устанавливает режим формы элемента равным mode. Режим формы описывает как QGraphicsPixmapItem рассчитывает свою форму. Режим по умолчанию равен MaskShape.

Смотрите также shapeMode() и ShapeMode.

void QGraphicsPixmapItem::setTransformationMode ( Qt::TransformationMode mode )

Устанавливает режим преобразования растрового изображения элемента равным mode, и вызывает обновление элемента. Режимом по умолчанию является Qt::FastTransformation, который предоставляет быстрое преобразование без сглаживания.

Qt::SmoothTransformation разблокирует QPainter::SmoothPixmapTransform для рисовальщика, и качество будет зависеть от платформы и области отображения. Результат обычно не так хорош как при вызове QPixmap::scale() напрямую.

Смотрите также transformationMode().

QPainterPath QGraphicsPixmapItem::shape () const `[virtual]`

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

ShapeMode QGraphicsPixmapItem::shapeMode () const

Возвращает режим формы элемента. Режим формы описывает как QGraphicsPixmapItem рассчитывает свою форму. Режим по умолчанию равен MaskShape.

Смотрите также setShapeMode() и ShapeMode.

Qt::TransformationMode QGraphicsPixmapItem::transformationMode () const

Возвращает режим преобразования растрового изображения. Режимом по умолчанию является Qt::FastTransformation, который предоставляет быстрое преобразование без сглаживания.

Смотрите также setTransformationMode().

int QGraphicsPixmapItem::type () const `[virtual]`

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

Оглавление