Класс QOpenGLPaintDevice

Класс QOpenGLPaintDevice позволяет выполнять отрисовку в контексте OpenGL с помощью QPainter. Подробнее...

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

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

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

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

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

QOpenGLPaintDevice использует текущий контекст QOpenGL для отрисовки команд рисования QPainter. Контекст фиксируется при создании. Требуется поддержка OpenGL (ES) 2.0 или выше.

Производительность

QOpenGLPaintDevice почти всегда ускоряется аппаратным обеспечением и может быть значительно быстрее, чем программная растризация. Однако он более чувствителен к изменениям состояния и, следовательно, требует тщательного упорядочения команд рисования для достижения оптимальной производительности.

Антиалиасинг и качество

Антиалиасинг в движке рисования OpenGL выполняется с помощью многократной выборки. Большинству аппаратных средств требуется значительно больше памяти для выполнения многократной выборки, а полученное качество не соответствует качеству программного движка рисования. Сила движка рисования OpenGL заключается в его производительности, а не в качестве визуального рендеринга.

Изменения состояния

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

Смешивание QPainter и OpenGL

При смешивании QPainter и OpenGL важно уведомить QPainter о том, что состояние OpenGL может быть загромождено, чтобы он мог восстановить своё внутреннее состояние. Это достигается вызовом QPainter::beginNativePainting() перед началом рендеринга OpenGL и вызовом QPainter::endNativePainting() после завершения.

См. также Пример окна OpenGL.

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

QOpenGLPaintDevice::QOpenGLPaintDevice(int width, int height)

Создаёт QOpenGLPaintDevice с заданной шириной и высотой.

QOpenGLPaintDevice допустим только для текущего контекста.

См. также QOpenGLContext::currentContext().

QOpenGLPaintDevice::QOpenGLPaintDevice(const QSize &size)

Создаёт QOpenGLPaintDevice с заданным размером.

QOpenGLPaintDevice допустим только для текущего контекста.

См. также QOpenGLContext::currentContext().

QOpenGLPaintDevice::QOpenGLPaintDevice()

Создаёт QOpenGLPaintDevice.

QOpenGLPaintDevice допустим только для текущего контекста.

См. также QOpenGLContext::currentContext().

[virtual] QOpenGLPaintDevice::~QOpenGLPaintDevice()

Удаляет QOpenGLPaintDevice.

QOpenGLContext *QOpenGLPaintDevice::context() const

Возвращает контекст OpenGL, связанный с устройством рисования.

qreal QOpenGLPaintDevice::dotsPerMeterX() const

Возвращает количество точек на метр по горизонтали.

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

qreal QOpenGLPaintDevice::dotsPerMeterY() const

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

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

[virtual] void QOpenGLPaintDevice::ensureActiveTarget()

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

beginNativePainting() также вызовет этот метод.

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

[override virtual protected] int QOpenGLPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const

Реализует: QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const.

[override virtual] QPaintEngine *QOpenGLPaintDevice::paintEngine() const

Реализует: QPaintDevice::paintEngine() const.

bool QOpenGLPaintDevice::paintFlipped() const

Возвращает true если рисование инвертировано относительно оси Y.

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

void QOpenGLPaintDevice::setDevicePixelRatio(qreal devicePixelRatio)

Устанавливает коэффициент пикселей устройства для устройства рисования на devicePixelRatio.

void QOpenGLPaintDevice::setDotsPerMeterX(qreal dpmx)

Устанавливает количество точек на метр по горизонтали на dpmx.

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

void QOpenGLPaintDevice::setDotsPerMeterY(qreal dpmy)

Устанавливает количество точек на метр по вертикали на dpmy.

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

void QOpenGLPaintDevice::setPaintFlipped(bool flipped)

Устанавливает, должно ли рисование быть перевернуто относительно оси Y, в значение flipped.

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

void QOpenGLPaintDevice::setSize(const QSize &size)

Устанавливает размер устройства рисования в пикселях до значения size.

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

QSize QOpenGLPaintDevice::size() const

Возвращает размер устройства рисования в пикселях.

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