Класс QQuickPaintedItem

Класс QQuickPaintedItem предоставляет способ использования API QPainter в графическом представлении QML. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

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

Свойства

• fillColor : QColor
• renderTarget : RenderTarget
• textureSize : QSize

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

Переопределенные открытые функции

Сигналы

Переопределенные защищенные функции

Подробное описание

QQuickPaintedItem позволяет использовать API QPainter с графическим представлением QML. Он настраивает текстурированный прямоугольник в графическом представлении и использует QPainter для отрисовки на текстуре. Цель отрисовки в Qt 6 всегда является QImage. Когда цель отрисовки является QImage, QPainter сначала отрисовывает в изображение, а затем содержимое загружается в текстуру. Вызовите update(), чтобы инициировать перерисовку.

Чтобы разрешить QPainter выполнять антиалиасинг, используйте setAntialiasing().

Чтобы создать собственный отрисовываемый элемент, сначала создайте подкласс QQuickPaintedItem, а затем начните с реализации единственной чистой виртуальной открытой функции: paint(), которая реализует фактическую отрисовку. Отрисовка будет внутри прямоугольника, охватывающего от 0,0 до width(),height().

Документация по типам членов

Перечисление QQuickPaintedItem::PerformanceHintФлаги QQuickPaintedItem::PerformanceHints

Это перечисление описывает флаги, которые вы можете включить, чтобы улучшить производительность отрисовки в QQuickPaintedItem. По умолчанию ни один из этих флагов не установлен.

Тип PerformanceHints является псевдонимом для QFlags<PerformanceHint>. Он хранит логическое ИЛИ комбинацию значений PerformanceHint.

Перечисление QQuickPaintedItem::RenderTarget

Это перечисление описывает цели отрисовки QQuickPaintedItem. Цель отрисовки — это поверхность, на которую QPainter рисует перед отрисовкой элемента на экране.

См. также setRenderTarget().

Документация по функциям-членам

QQuickPaintedItem::QQuickPaintedItem(QQuickItem *parent = nullptr)

Создаёт QQuickPaintedItem с заданным элементом parent.

[override virtual] QQuickPaintedItem::~QQuickPaintedItem()

Удаляет QQuickPaintedItem.

bool QQuickPaintedItem::antialiasing() const

Возвращает true, если включена антиалиасинговая обработка, в противном случае возвращает false.

По умолчанию антиалиасинговая обработка не включена.

См. также setAntialiasing().

[override virtual] bool QQuickPaintedItem::isTextureProvider() const

Переопределяет: QQuickItem::isTextureProvider() const.

[override virtual protected] void QQuickPaintedItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

Переопределяет: QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value).

bool QQuickPaintedItem::mipmap() const

Возвращает true, если включены mipmap, в противном случае возвращает false.

По умолчанию mipmap не включены.

См. также setMipmap().

bool QQuickPaintedItem::opaquePainting() const

Возвращает true, если этот элемент непрозрачен, в противном случае возвращает false.

По умолчанию элементы, которые рисуются, не являются непрозрачными.

См. также setOpaquePainting().

[pure virtual] void QQuickPaintedItem::paint(QPainter *painter)

Эта функция, которая обычно вызывается QML Scene Graph, рисует содержимое элемента в локальных координатах.

Подлежащая текстура будет иметь размер, определённый свойством textureSize, если оно установлено, или размером элемента, умноженным на коэффициент масштабирования пикселей окна.

Функция вызывается после того, как элемент был заполнен цветом fillColor.

Переопределите эту функцию в подклассе QQuickPaintedItem, чтобы обеспечить реализацию рисования элемента, используя painter.

См. также width(), height() и textureSize.

QQuickPaintedItem::PerformanceHints QQuickPaintedItem::performanceHints() const

Возвращает параметры производительности.

По умолчанию ни один параметр производительности не включён.

См. также setPerformanceHint() и setPerformanceHints().

[override virtual protected] void QQuickPaintedItem::releaseResources()

Переопределяет: QQuickItem::releaseResources().

void QQuickPaintedItem::setAntialiasing(bool enable)

Если enable равно true, то включена антиалиасинговая обработка.

По умолчанию антиалиасинговая обработка не включена.

См. также antialiasing().

void QQuickPaintedItem::setMipmap(bool enable)

Если enable равно true, то включено mipmap для связанной текстуры.

Mipmap увеличивает скорость рендеринга и уменьшает артефакты ступенчатости при уменьшении масштаба элемента.

По умолчанию mipmap не включены.

См. также mipmap().

void QQuickPaintedItem::setOpaquePainting(bool opaque)

Если opaque равно true, то элемент непрозрачен; в противном случае он считается полупрозрачным.

Непрозрачные элементы не смешиваются с остальной частью сцены. Установите это значение в true, если содержимое элемента непрозрачно, чтобы ускорить рендеринг.

По умолчанию элементы, которые рисуются, не являются непрозрачными.

См. также opaquePainting().

void QQuickPaintedItem::setPerformanceHint(QQuickPaintedItem::PerformanceHint hint, bool enabled = true)

Устанавливает заданный параметр производительности hint для элемента, если enabled равно true; в противном случае параметр производительности очищается.

По умолчанию ни один параметр производительности не включён.

См. также setPerformanceHints() и performanceHints().

void QQuickPaintedItem::setPerformanceHints(QQuickPaintedItem::PerformanceHints hints)

Устанавливает параметры производительности в hints

По умолчанию ни один параметр производительности не включён.

См. также setPerformanceHint() и performanceHints().

[override virtual] QSGTextureProvider *QQuickPaintedItem::textureProvider() const

Переопределяет: QQuickItem::textureProvider() const.

void QQuickPaintedItem::update(const QRect &rect = QRect())

Планирует перерисовку области, охватываемой rect в данном элементе. Вы можете вызвать эту функцию всякий раз, когда ваш элемент необходимо перерисовать, например, если он изменил свой вид или размер.

Эта функция не вызывает немедленной перерисовки; вместо этого она планирует запрос на перерисовку, который обрабатывается QML Scene Graph при отрисовке следующего кадра. Элемент будет перерисован только в том случае, если он виден.

См. также paint().

[override virtual protected] QSGNode *QQuickPaintedItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *data)

Переопределяет: QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData).