Класс 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 (подходящий для профилей core с 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(). Используется, когда требуется использовать только часть текстуры при blit-опереции.

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

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

bool QOpenGLTextureBlitter::supportsExternalOESTarget() const

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

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

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

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

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

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

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