Класс QOpenGLTextureBlitter

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

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

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

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

Статические открытые члены

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

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

Отрисовка текстурированных квадров, для того чтобы получить содержимое текстуры на экран, является распространённой операцией при разработке 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 на системах с little endian.

По умолчанию перестановка красного и синего каналов отключена, так как это необходимо для текстуры, присоединённой к объекту фреймбуфера или текстуре, основанной на байтовом формате 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 в качестве аргумента целевого объекта.

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

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

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

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

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

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