Класс QSGEngine

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

Этот класс устарел. Он предоставляется для поддержки старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.

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

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

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

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

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

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

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

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

Предупреждение: Этот класс подходит только для работы непосредственно с OpenGL. Он несовместим с путём рендеринга, основанным на RHI.

См. также 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.