Класс QSGEngine

Класс QSGEngine позволяет выполнять низкоуровневое рендеринг графа сцены. Подробнее...

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

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

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

Функции публичного доступа

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

Класс QSGEngine может использоваться для рендеринга дерева QSGNode непосредственно на QWindow или QOpenGLFramebufferObject без какой-либо интеграции с QML, QQuickWindow или QQuickItem и удобства, которые они предоставляют.

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

Примечание: Этот класс предназначен для очень низкоуровневого доступа к независимому графу сцены. В большинстве случаев вам будет лучше использовать подкласс QQuickItem и вставить свой QSGNode в обычную сцену QtQuick, переопределив QQuickItem::updatePaintNode().

См. также QSGAbstractRenderer.

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

перечисление QSGEngine::CreateTextureOptionфлаги QSGEngine::CreateTextureOptions

Перечисления CreateTextureOption используются для настройки того, как оборачивается текстура.

Тип CreateTextureOptions является псевдонимом для QFlags<CreateTextureOption>. Он хранит результат побитового ИЛИ значений CreateTextureOption.

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

QSGEngine::QSGEngine(QObject *parent = nullptr)

Конструирует новый QSGEngine с его parent

[override virtual] QSGEngine::~QSGEngine()

Уничтожает движок

QSGImageNode *QSGEngine::createImageNode() const

Создает простой узел изображения. Если граф сцены не инициализирован, возвращаемое значение равно null.

Это кросс-платформенная альтернатива прямому созданию QSGSimpleTextureNode.

Эта функция была представлена в Qt 5.8.

См. также QSGImageNode.

QSGNinePatchNode *QSGEngine::createNinePatchNode() const

Создает узел девятиугольной области. Если граф сцены не инициализирован, возвращаемое значение равно null.

Эта функция была представлена в Qt 5.8.

QSGRectangleNode *QSGEngine::createRectangleNode() const

Создает простой узел прямоугольника. Если граф сцены не инициализирован, возвращаемое значение равно null.

Это кросс-платформенная альтернатива прямому созданию QSGSimpleRectNode.

Эта функция была представлена в Qt 5.8.

См. также QSGRectangleNode.

QSGAbstractRenderer *QSGEngine::createRenderer() const

Возвращает рендерер, который можно использовать для рендеринга дерева QSGNode

Вы сначала вызываете initialize() с QOpenGLContext, который вы хотите использовать с этим рендерером. В противном случае будет возвращен null.

QSGTexture *QSGEngine::createTextureFromId(uint id, const QSize &size, QSGEngine::CreateTextureOptions options = CreateTextureOption()) const

Создает объект текстуры, который оборачивает текстуру GL id, загруженную с размером size

Допустимые options — TextureHasAlphaChannel и TextureOwnsGLTexture

Вызов функции берет на себя ответственность за объект текстуры, и текстура должна использоваться только с этим движком.

См. также createTextureFromImage(), QSGSimpleTextureNode::setOwnsTexture() и QQuickWindow::createTextureFromId().

QSGTexture *QSGEngine::createTextureFromImage(const QImage &image, QSGEngine::CreateTextureOptions options = CreateTextureOption()) const

Создает текстуру, используя данные из image

Допустимые options — TextureCanUseAtlas и TextureIsOpaque.

Вызов функции берет на себя ответственность за текстуру, и текстура должна использоваться только с этим движком.

См. также createTextureFromId(), QSGSimpleTextureNode::setOwnsTexture() и QQuickWindow::createTextureFromImage().

void QSGEngine::initialize(QOpenGLContext *context)

Инициализирует движок с context.

Предупреждение: Вы должны убедиться, что вы вызываете QOpenGLContext::makeCurrent() на context перед вызовом этой функции.

void QSGEngine::invalidate()

Деактивирует движок, освобождая его ресурсы

Вы должны снова вызвать initialize() и createRenderer(), если хотите снова его использовать.

QSGRendererInterface *QSGEngine::rendererInterface() const

Возвращает текущий интерфейс рендерера, если он есть. В противном случае возвращается null.

Эта функция была представлена в Qt 5.8.

См. также QSGRenderNode и QSGRendererInterface.