Класс QSGEngine

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

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

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

Типы public

Функции public

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

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

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

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

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

См. также QSGImageNode.

QSGNinePatchNode *QSGEngine::createNinePatchNode() const

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

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

QSGRectangleNode *QSGEngine::createRectangleNode() const

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

Это кросс-платформенная альтернатива непосредственному построению 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.