Класс QOpenGLTextureBlitter

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

Этот класс был представлен в Qt 5.8.

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

Типы публичного доступа

Публичные функции

Статические публичные члены

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

Отрисовка текстурированных квадов, для отображения содержимого текстуры на экране, является распространенной операцией при разработке 2D пользовательских интерфейсов. QOpenGLTextureBlitter предоставляет удобный класс для избежания повторения данных вершин, источников шейдеров, управления буферами и программами, а также вычислений матриц.

Например, подкласс QOpenGLWidget может сделать следующее, чтобы отобразить содержимое, отрисованное в буфере кадров, в позиции пикселей (x, y):

void OpenGLWidget::initializeGL()
{
    m_blitter.create();
    m_fbo = new QOpenGLFramebufferObject(size);
}

void OpenGLWidget::paintGL()
{
    m_fbo->bind();
    // update offscreen content
    m_fbo->release();

    m_blitter.bind();
    const QRect targetRect(QPoint(x, y), m_fbo->size());
    const QMatrix4x4 target = QOpenGLTextureBlitter::targetTransform(targetRect, QRect(QPoint(0, 0), m_fbo->size()));
    m_blitter.blit(m_fbo->texture(), target, QOpenGLTextureBlitter::OriginBottomLeft);
    m_blitter.release();
}

Блиттер реализует GLSL шейдеры как для GLSL 1.00 (подходящий для OpenGL (ES) 2.x и профилей совместимости более новых версий OpenGL), так и для версии 150 (подходящий для контекстов профиля ядра с OpenGL 3.2 и более поздними версиями).

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

перечисление QOpenGLTextureBlitter::Origin

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

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

QOpenGLTextureBlitter::QOpenGLTextureBlitter()

Создает новый экземпляр QOpenGLTextureBlitter.

Примечание: графические ресурсы не инициализируются в конструкторе. Это позволяет безопасно помещать обычные члены QOpenGLTextureBlitter в классы, так как фактическая инициализация, зависящая от контекста OpenGL, происходит только в create().

QOpenGLTextureBlitter::~QOpenGLTextureBlitter()

Удаляет экземпляр.

Примечание: Когда контекст OpenGL — или контекст, совместно использующий ресурсы с ним — который был текущим при вызове create(), не является текущим, графические ресурсы не будут освобождены. Поэтому рекомендуется вызывать destroy() вручную вместо полагания на деструктор для выполнения очистки графических ресурсов OpenGL.

void QOpenGLTextureBlitter::bind(GLenum target = GL_TEXTURE_2D)

Связывает графические ресурсы, используемые блиттером. Это необходимо вызвать перед вызовом blit(). Следует избегать кода, изменяющего состояние OpenGL, между вызовом bind() и blit(), так как в противном случае могут возникнуть конфликты.

target — целевой тип текстуры для источника текстуры и должен быть либо GL_TEXTURE_2D, либо GL_OES_EGL_image_external.

См. также release() и blit().

void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, QOpenGLTextureBlitter::Origin sourceOrigin)

Выполняет копирование с исходной текстурой texture.

targetTransform определяет применяемое преобразование. Оно обычно генерируется функцией-помощником targetTransform().

sourceOrigin указывает, требуется ли инверсия данных изображения. Когда texture соответствует текстуре, прикрепленной к проходу FBO, передайте OriginBottomLeft. С другой стороны, когда texture основана на не инвертированных данных изображения, передайте OriginTopLeft. Это более эффективно, чем использование QImage::mirrored().

См. также targetTransform(), Origin и bind().

void QOpenGLTextureBlitter::blit(GLuint texture, const QMatrix4x4 &targetTransform, const QMatrix3x3 &sourceTransform)

Выполняет копирование с исходной текстурой texture.

targetTransform определяет применяемое преобразование. Оно обычно генерируется функцией-помощником targetTransform().

sourceTransform определяет преобразование, применяемое к источнику. Это позволяет использовать только подпрямоугольник исходной текстуры. Оно обычно генерируется функцией-помощником sourceTransform().

См. также sourceTransform(), targetTransform(), Origin и bind().

bool QOpenGLTextureBlitter::create()

Инициализирует графические ресурсы, используемые блиттером.

Возвращает true при успехе и false при ошибке. Ошибки могут возникнуть, когда в текущей потоке отсутствует контекст OpenGL или когда компиляция шейдеров завершается неудачно по какой-либо причине.

См. также isCreated() и destroy().

void QOpenGLTextureBlitter::destroy()

Освобождает все графические ресурсы, удерживаемые блиттером. Предполагается, что контекст OpenGL или другой контекст, совместно использующий ресурсы с ним, который был текущим в потоке при вызове create(), является текущим.

Функция не имеет эффекта, когда блиттер не находится в состоянии создания.

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

bool QOpenGLTextureBlitter::isCreated() const

Возвращает true, если create() был вызван и выполнен успешно. false в противном случае.

См. также create() и destroy().

void QOpenGLTextureBlitter::release()

Освобождает графические ресурсы, используемые блиттером.

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

void QOpenGLTextureBlitter::setOpacity(float opacity)

Изменяет непрозрачность на opacity. Значение по умолчанию — 1.0.

Примечание: блиттер не изменяет состояние смешивания. От пользователя функции blit() требуется обеспечить корректные настройки смешивания.

void QOpenGLTextureBlitter::setRedBlueSwizzle(bool swizzle)

Устанавливает значение swizzle для включения/выключения перестановки красного и синего цветовых каналов. Преобразование BGRA в RGBA (происходит в шейдере на GPU, а не в медленной операции на CPU) может быть полезно, когда исходная текстура содержит данные из QImage с форматом, таким как QImage::Format_ARGB32, который соответствует BGRA на системах с малым порядком байтов.

По умолчанию перестановка красного и синего каналов отключена, так как это необходимо для текстуры, прикрепленной к объекту фреймбуфера или текстуре, основанной на формате байтового порядка QImage (например, QImage::Format_RGBA8888).

[static] QMatrix3x3 QOpenGLTextureBlitter::sourceTransform(const QRectF &subTexture, const QSize &textureSize, QOpenGLTextureBlitter::Origin origin)

Вычисляет 3x3 матрицу, подходящую в качестве входных данных для blit(). Используется при необходимости использования только части текстуры в блите.

subTexture — желаемый исходный прямоугольник в пикселях, textureSize — полная ширина и высота данных текстуры. origin определяет ориентацию данных изображения относительно оси Y.

См. также blit() и Origin.

bool QOpenGLTextureBlitter::supportsExternalOESTarget() const

Возвращает true если bind() принимает GL_TEXTURE_EXTERNAL_OES в качестве аргумента целевого объекта.

См. также bind() и blit().

[static] QMatrix4x4 QOpenGLTextureBlitter::targetTransform(const QRectF &target, const QRect &viewport)

Вычисляет матрицу преобразования целевого объекта, подходящую для blit().

target — целевой прямоугольник в пикселях. viewport описывает исходные размеры и в большинстве случаев устанавливается в (0, 0, ширина_изображения, высота_изображения).

Для выходных данных без масштабирования размеры target и viewport должны совпадать.

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