Класс QPaintEngine

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

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

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

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

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

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

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

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

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

См. также QPainter, QPaintDevice::paintEngine() и Paint System.

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

enum QPaintEngine::DirtyFlagflags 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 = ...)

Создаёт движок отрисовки с набором функций, указанным в 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.

Примечание: Должна быть переопределена хотя бы одна из функций drawPolygon().

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

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

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

Примечание: Должна быть переопределена хотя бы одна из функций drawPolygon().

[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. Pixmap будет отрисовываться многократно, пока 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

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

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 для получения текущих значений для заданных свойств.

См. также QPaintEngineState.