Класс QSGGeometryNode

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

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

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

• 3 открытых функции унаследованы от QSGBasicGeometryNode
• 20 открытых функций унаследованы от QSGNode

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

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

Класс QSGGeometryNode состоит из геометрии и материала. Геометрия определяет сетку, вершины и их структуру, которые должны быть нарисованы. Материал определяет, как форма будет заполнена.

Ниже приведен фрагмент кода, иллюстрирующий, как создать красную линию с помощью QSGGeometryNode:

QSGGeometry *geometry = new QSGGeometry(QSGGeometry::defaultAttributes_Point2D(), 2);
geometry->setDrawingMode(GL_LINES);
geometry->setLineWidth(3);
geometry->vertexDataAsPoint2D()[0].set(0, 0);
geometry->vertexDataAsPoint2D()[1].set(width(), height());

QSGFlatColorMaterial *material = new QSGFlatColorMaterial;
material->setColor(QColor(255, 0, 0));

QSGGeometryNode *node = new QSGGeometryNode;
node->setGeometry(geometry);
node->setFlag(QSGNode::OwnsGeometry);
node->setMaterial(material);
node->setFlag(QSGNode::OwnsMaterial);

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

Узел геометрии поддерживает два типа материалов: opaqueMaterial и обычный материал. opaqueMaterial используется, когда накопленная непрозрачность графического дерева сцены в момент отрисовки равна 1. Основной сценарий использования заключается в том, чтобы особым образом обработать непрозрачную отрисовку, чтобы избежать дополнительной операции в фрагментном шейдере, что может значительно повлиять на производительность на встроенных графических чипах. Непрозрачный материал является необязательным.

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

См. также QSGGeometry, QSGMaterial и QSGSimpleMaterial.

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

QSGGeometryNode::QSGGeometryNode()

Создает новый узел геометрии без геометрии и материала.

[override virtual] QSGGeometryNode::~QSGGeometryNode()

Удаляет этот узел геометрии.

Флаги QSGNode::OwnsMaterial, QSGNode::OwnsOpaqueMaterial и QSGNode::OwnsGeometry определяют, должен ли узел геометрии также удалить материалы и геометрию. По умолчанию эти флаги отключены.

QSGMaterial *QSGGeometryNode::material() const

Возвращает материал узла QSGGeometryNode.

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

QSGMaterial *QSGGeometryNode::opaqueMaterial() const

Возвращает непрозрачный материал узла QSGGeometryNode.

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

void QSGGeometryNode::setMaterial(QSGMaterial *material)

Устанавливает материал этого узла геометрии в material.

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

Если материал изменен, не вызвав setMaterial() повторно, пользователь также должен пометить материал как изменённый с помощью QSGNode::markDirty().

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

void QSGGeometryNode::setOpaqueMaterial(QSGMaterial *material)

Устанавливает непрозрачный материал этой геометрии в material.

Непрозрачный материал будет предпочтительнее для рендерера, чем стандартный материал, возвращаемый функцией material(), если он не равен null, и элемент геометрии имеет наследование непрозрачности равное 1.

Непрозрачность относится к непрозрачности графического дерева сцены, материал всё ещё может установить QSGMaterial::Blending в true и отображать прозрачные пиксели.

Если материал изменен, не вызвав setOpaqueMaterial() повторно, пользователь также должен пометить непрозрачный материал как изменённый с помощью QSGNode::markDirty().

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