Класс QQuickPaintedItem

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

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

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

Свойства

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

• 23 свойства унаследованы от QQuickItem
• 1 свойство унаследовано от QObject

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

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

• 92 открытые функции унаследованы от QQuickItem
• 31 открытая функция унаследована от QObject
• 2 открытые функции унаследованы от QQmlParserStatus

Сигналы

• 1 сигнал унаследован от QQuickItem
• 2 сигнала унаследованы от QObject

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

• 33 защищённые функции унаследованы от QQuickItem
• 9 защищённых функций унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QQuickItem
• 1 открытый слот унаследован от QObject
• 11 статические открытые члены унаследованы от QObject
• 33 защищённые функции унаследованы от QQuickItem
• 9 защищённых функций унаследованы от QObject

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

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

Класс QQuickPaintedItem позволяет использовать API QPainter с QML графическим представлением. Он создаёт текстурированный прямоугольник в графическом представлении и использует QPainter для рисования на текстуре. Цель отрисовки может быть либо QImage, либо QOpenGLFramebufferObject. Когда целью отрисовки является QImage, QPainter сначала рисует в изображение, а затем содержимое загружается в текстуру. При использовании QOpenGLFramebufferObject, 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 = Q_NULLPTR)

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

[virtual] QQuickPaintedItem::~QQuickPaintedItem()

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

bool QQuickPaintedItem::antialiasing() const

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

По умолчанию сглаживание не включено.

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

[virtual] bool QQuickPaintedItem::isTextureProvider() const

Переопределено из QQuickItem::isTextureProvider().

[virtual protected] void QQuickPaintedItem::itemChange(ItemChange, const ItemChangeData &)

bool QQuickPaintedItem::mipmap() const

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

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

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

bool QQuickPaintedItem::opaquePainting() const

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

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

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

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

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

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

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

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

Примечание: QML-граф сцены использует два отдельных потока: основной поток выполняет действия, такие как обработка событий или обновление анимаций, а второй поток выполняет фактическую отрисовку OpenGL. Вследствие этого paint() вызывается не из основного потока GUI, а из потока рендеринга OpenGL. В момент вызова paint() поток GUI заблокирован, поэтому он потокобезопасен.

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

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

PerformanceHints QQuickPaintedItem::performanceHints() const

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

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

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

[virtual protected] void QQuickPaintedItem::releaseResources()

Переопределено из QQuickItem::releaseResources().

void QQuickPaintedItem::setAntialiasing(bool enable)

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

По умолчанию сглаживание не включено.

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

void QQuickPaintedItem::setMipmap(bool enable)

Если enable имеет значение true, сглаживание по пирамидальной схеме (mipmap) включено для связанной текстуры.

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

По умолчанию, сглаживание по пирамидальной схеме выключено.

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

void QQuickPaintedItem::setOpaquePainting(bool opaque)

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

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

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

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

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

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

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

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

void QQuickPaintedItem::setPerformanceHints(PerformanceHints hints)

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

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

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

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

Переопределено из QQuickItem::textureProvider().

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

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

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

Обратите внимание, что вызов этой функции приведет к перерисовке всей сцены.

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

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

Переопределено из QQuickItem::updatePaintNode().