Класс QSGNode

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

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

Публичные типы

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

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

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

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

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

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

Примечание: Все классы с префиксом QSG должны использоваться только в потоке отрисовки графического представления сцены. Подробнее см. Графическое представление сцены и рендеринг.

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

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

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

Тип DirtyState является псевдонимом для QFlags<DirtyStateBit>. Он хранит комбинацию значений DirtyStateBit, объединенных операцией OR.

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

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

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

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

enum 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() для каждого кадра, в котором узел отрисовывается.

Предупреждение: Остерегайтесь удаления узлов во время их предварительной обработки. Возможно, с небольшой потерей производительности, удаление одного узла во время его собственного вызова 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, и его можно безопасно использовать для приведения к соответствующему классу.