Класс QSGNode

Класс QSGNode является базовым классом для всех узлов в графическом дереве сцены. Подробнее...

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

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

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

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

Класс QSGNode может использоваться как контейнер для дочерних элементов. Дочерние элементы добавляются с помощью appendChildNode(), prependChildNode(), insertChildNodeBefore() и insertChildNodeAfter(). Порядок узлов важен, так как геометрические узлы отрисовываются в соответствии с их порядком в графическом дереве сцены.

Узлы графического дерева сцены содержат механизм для описания изменений в части сцены. Это включает в себя совокупные матрицы, накопленную непрозрачность, изменения в иерархии узлов и так далее. Эта информация может использоваться для оптимизации внутри рендерера графического дерева сцены. Для правильной отрисовки узлов рендерером важно, чтобы пользователи вызывали QSGNode::markDirty() с правильными флагами при изменении узлов. Большинство функций в классах узлов неявно вызывают markDirty(). Например, QSGNode::appendChildNode() вызовет markDirty() с передачей QSGNode::DirtyNodeAdded.

Если узлы изменяются каждый кадр, функция preprocess() может быть использована для применения изменений к узлу для каждого кадра, в котором он отрисовывается. Использование preprocess() должно быть явно включено путем установки флага QSGNode::UsePreprocess на узле.

Виртуальная функция isSubtreeBlocked() может использоваться для отключения всего поддерева. Узлы в заблокированном поддереве не будут обработаны с помощью preprocess() и не будут отрисованы.

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

перечисление QSGNode::DirtyStateBitфлаги QSGNode::DirtyState

Используется в QSGNode::markDirty() для указания изменений в графическом дереве сцены.

Тип DirtyState является псевдонимом для QFlags<DirtyStateBit>. Он хранит логическое ИЛИ сочетание значений DirtyStateBit.

См. также QSGNode::markDirty().

перечисление QSGNode::Flagфлаги QSGNode::Flags

Перечисление QSGNode::Flag описывает флаги для QSGNode

Тип Flags — это псевдоним для QFlags<Flag>. Он хранит логическое ИЛИ комбинацию значений Flag.

Перечисление QSGNode::NodeType

Может быть использовано для определения типа узла.

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

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

QSGNode::QSGNode()

Создаёт новый узел.

[virtual] QSGNode::~QSGNode()

Уничтожает узел.

Каждый дочерний узел этого узла, у которого установлен флаг QSGNode::OwnedByParent, также будет удалён.

void QSGNode::appendChildNode(QSGNode *node)

Добавляет node в список дочерних узлов этого узла.

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

QSGNode *QSGNode::childAtIndex(int i) const

Возвращает дочерний узел с индексом i.

Дочерние узлы хранятся во внутренней связанной структуре, поэтому итерация по дочерним узлам по индексу неэффективна.

int QSGNode::childCount() const

Возвращает количество дочерних узлов.

QSGNode *QSGNode::firstChild() const

Возвращает первый дочерний узел этого узла.

Дочерние узлы хранятся в связанном списке.

QSGNode::Flags QSGNode::flags() const

Возвращает набор флагов для этого узла.

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

void QSGNode::insertChildNodeAfter(QSGNode *node, QSGNode *after)

Вставляет node в список дочерних узлов этого узла после узла, указанного after.

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

void QSGNode::insertChildNodeBefore(QSGNode *node, QSGNode *before)

Вставляет node в список дочерних узлов этого узла перед узлом, указанным before.

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

[virtual] bool QSGNode::isSubtreeBlocked() const

Возвращает, доступен ли этот узел и его поддерево для использования.

Заблокированные поддеревья не будут получать обновлённые состояния и не будут отрисовываться.

Например, QSGOpacityNode вернёт заблокированное поддерево, если накопленная непрозрачность равна 0.

QSGNode *QSGNode::lastChild() const

Возвращает последний дочерний узел этого узла.

Дочерние узлы хранятся в связанном списке.

void QSGNode::markDirty(QSGNode::DirtyState bits)

Уведомляет все подключённые отрисовщики, что узел имеет изменённые биты bits.

QSGNode *QSGNode::nextSibling() const

Возвращает узел, следующий за этим в списке дочерних узлов родителя.

Дочерние узлы хранятся в связанном списке.

QSGNode *QSGNode::parent() const

Возвращает родительский узел этого узла.

void QSGNode::prependChildNode(QSGNode *node)

Добавляет node в начало списка дочерних узлов этого узла.

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

[virtual] void QSGNode::preprocess()

Переопределите эту функцию для выполнения обработки узла перед его отрисовкой.

Предварительная обработка должна быть явно включена, установив флаг QSGNode::UsePreprocess. Флаг должен быть установлен до добавления узла в график сцены, и это заставит функцию preprocess() вызываться для каждого кадра отрисовки узла.

QSGNode *QSGNode::previousSibling() const

Возвращает узел, предшествующий этому в списке дочерних узлов родителя.

Дочерние узлы хранятся в связанном списке.

void QSGNode::removeAllChildNodes()

Удаляет все дочерние узлы из списка дочерних узлов этого узла.

void QSGNode::removeChildNode(QSGNode *node)

Удаляет node из списка дочерних узлов этого узла.

void QSGNode::setFlag(QSGNode::Flag f, bool enabled = true)

Устанавливает флаг f для этого узла, если enabled имеет значение true; в противном случае очищает флаг.

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

void QSGNode::setFlags(QSGNode::Flags f, bool enabled = true)

Устанавливает флаги f для этого узла, если enabled имеет значение true; в противном случае очищает флаги.

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

QSGNode::NodeType QSGNode::type() const

Возвращает тип этого узла. Тип узла должен быть одним из предопределённых типов, определённых в QSGNode::NodeType, и его можно безопасно использовать для преобразования в соответствующий класс.