Класс QPaintEngine

Класс QPaintEngine предоставляет абстрактное определение того, как QPainter рисует на заданном устройстве в данной платформе. Подробнее...

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

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

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

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

Qt предоставляет несколько готовых реализаций QPaintEngine для различных бэкэндов рисования, которые мы поддерживаем. Основной движок рисования — это растровый движок рисования, который содержит программный растризатор, поддерживающий полный набор функций во всех поддерживаемых платформах. Это значение по умолчанию для рисования на классах, основанных на QWidget, например, на Windows, X11 и macOS, это бэкэнд для рисования на QImage, и он используется в качестве резервного варианта для движков рисования, которые не поддерживают определённую возможность. Кроме того, мы предоставляем реализации QPaintEngine для OpenGL (доступные через QOpenGLWidget) и печати (что позволяет использовать QPainter для рисования на объекте QPrinter).

Если необходимо использовать QPainter для рисования на другом бэкэнде, необходимо создать подкласс QPaintEngine и переопределить все его виртуальные функции. Реализация QPaintEngine затем предоставляется путём создания подкласса QPaintDevice и переопределения виртуальной функции QPaintDevice::paintEngine().

QPaintEngine создаётся и принадлежит QPaintDevice, который его создал.

См. также QPainter, QPaintDevice::paintEngine() и Систему рисования.

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

Перечисление QPaintEngine::DirtyFlagфлаги QPaintEngine::DirtyFlags

Эти типы используются QPainter для запуска ленивых обновлений различных состояний в QPaintEngine с помощью QPaintEngine::updateState().

Двигатель отрисовки должен обновить каждое испачканное состояние.

Тип DirtyFlags является псевдонимом для QFlags<DirtyFlag>. Он хранит сочетание значений DirtyFlag по оператору ИЛИ.

enum QPaintEngine::PaintEngineFeatureflags QPaintEngine::PaintEngineFeatures

Это перечисление используется для описания функций или возможностей, которые имеет двигатель отрисовки. Если функция не поддерживается движком, QPainter сделает все возможное, чтобы эмулировать эту функцию другими способами и передаст альфа-смешанный QImage движку с эмулированными результатами. Некоторые функции не могут быть эмулированы: AlphaBlend и PorterDuff.

Тип PaintEngineFeatures является псевдонимом для QFlags<PaintEngineFeature>. Он хранит сочетание значений PaintEngineFeature по оператору ИЛИ.

enum QPaintEngine::PolygonDrawMode

enum QPaintEngine::Type

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

QPaintEngine::QPaintEngine(QPaintEngine::PaintEngineFeatures caps = PaintEngineFeatures())

Создает движок отрисовки с набором функций, указанным в caps.

[virtual] QPaintEngine::~QPaintEngine()

Уничтожает движок отрисовки.

[pure virtual] bool QPaintEngine::begin(QPaintDevice *pdev)

Переопределите эту функцию, чтобы инициализировать движок отрисовки при начале отрисовки на устройстве отрисовки pdev. Верните true, если инициализация прошла успешно; в противном случае верните false.

См. также end() и isActive().

[virtual] void QPaintEngine::drawEllipse(const QRectF &rect)

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

По умолчанию вызывается drawPolygon().

[virtual] void QPaintEngine::drawEllipse(const QRect &rect)

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

[virtual] void QPaintEngine::drawImage(const QRectF &rectangle, const QImage &image, const QRectF &sr, Qt::ImageConversionFlags flags = Qt::AutoColor)

Переопределите эту функцию, чтобы нарисовать часть изображения image, заданную прямоугольником sr, в заданный прямоугольник rectangle, используя флаги преобразования flags для преобразования в растровый рисунок.

[virtual] void QPaintEngine::drawLines(const QLineF *lines, int lineCount)

По умолчанию список линий в lines разделяется на отдельные вызовы drawPath() или drawPolygon() в зависимости от набора функций движка отрисовки.

[virtual] void QPaintEngine::drawLines(const QLine *lines, int lineCount)

Это перегруженная функция.

По умолчанию первая lineCount линий в lines преобразуются в QLineF и вызывается плавающая версия этой функции.

[virtual] void QPaintEngine::drawPath(const QPainterPath &path)

По умолчанию функция игнорирует path и ничего не делает.

[pure virtual] void QPaintEngine::drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr)

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

[virtual] void QPaintEngine::drawPoints(const QPointF *points, int pointCount)

Рисует первые pointCount точек в буфере points

[virtual] void QPaintEngine::drawPoints(const QPoint *points, int pointCount)

Рисует первые pointCount точек в буфере points

По умолчанию первые pointCount QPoints в points преобразуются в QPointFs и вызывается плавающая версия drawPoints.

[virtual] void QPaintEngine::drawPolygon(const QPointF *points, int pointCount, QPaintEngine::PolygonDrawMode mode)

Переопределите эту виртуальную функцию, чтобы нарисовать многоугольник, определяемый первыми pointCount точками в points, используя режим mode.

[virtual] void QPaintEngine::drawPolygon(const QPoint *points, int pointCount, QPaintEngine::PolygonDrawMode mode)

Это перегруженная функция.

Переопределите эту виртуальную функцию, чтобы нарисовать многоугольник, определяемый первыми pointCount точками в points, используя режим mode.

[virtual] void QPaintEngine::drawRects(const QRectF *rects, int rectCount)

Рисует первые rectCount прямоугольников в буфере rects. По умолчанию эта функция вызывает drawPath() или drawPolygon() в зависимости от набора функций движка отрисовки.

[virtual] void QPaintEngine::drawRects(const QRect *rects, int rectCount)

Это перегруженная функция.

По умолчанию первые rectCount прямоугольников в буфере rects преобразуются в QRectF и вызывается плавающая версия этой функции.

[virtual] void QPaintEngine::drawTextItem(const QPointF &p, const QTextItem &textItem)

Эта функция рисует элемент текста textItem в позиции p. По умолчанию эта функция преобразует текст в QPainterPath и рисует полученную траекторию.

[virtual] void QPaintEngine::drawTiledPixmap(const QRectF &rect, const QPixmap &pixmap, const QPointF &p)

Переопределите эту функцию, чтобы нарисовать pixmap в заданном rect, начиная с заданного p. Растровый рисунок будет повторно нарисован до заполнения rect.

[pure virtual] bool QPaintEngine::end()

Переопределите эту функцию, чтобы завершить рисование на текущем устройстве рисования. Вернуть true, если рисование было успешно завершено; в противном случае вернуть false.

См. также begin() и isActive().

bool QPaintEngine::hasFeature(QPaintEngine::PaintEngineFeatures feature) const

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

bool QPaintEngine::isActive() const

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

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

QPaintDevice *QPaintEngine::paintDevice() const

Возвращает устройство, на котором выполняется рисование этим движком, если рисование активно; в противном случае возвращает nullptr.

QPainter *QPaintEngine::painter() const

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

void QPaintEngine::setActive(bool state)

Устанавливает активное состояние движка рисования в state.

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

[pure virtual] QPaintEngine::Type QPaintEngine::type() const

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

[pure virtual] void QPaintEngine::updateState(const QPaintEngineState &state)

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

При реализации эта функция отвечает за проверку текущего состояния движка рисования state и обновление изменённых свойств. Используйте функцию QPaintEngineState::state(), чтобы узнать, какие свойства необходимо обновить, а затем используйте соответствующую функцию get function для получения текущих значений заданных свойств.

См. также QPaintEngineState.