Класс QSGSimpleTextureNode
Класс QSGSimpleTextureNode предоставляется для удобства, позволяя легко отрисовывать текстурированный контент с помощью графа сцен QML. Подробнее...
| Заголовок: | #include <QSGSimpleTextureNode> |
| CMake: | find_package(Qt6 COMPONENTS Quick REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Наследует: | QSGGeometryNode |
Публичные типы
| перечисление | Флаг преобразования координат текстуры { Без преобразования, Зеркально по горизонтали, Зеркально по вертикали } |
| флаги | Режим преобразования координат текстуры |
Публичные функции
| QSGSimpleTextureNode() | |
| виртуальный | ~QSGSimpleTextureNode() override |
| QSGTexture::Filtering | filtering() const |
| bool | владеетТекстурой() const |
| QRectF | прямоугольник() const |
| void | установитьФильтрацию(QSGTexture::Filtering filtering) |
| void | установитьВладениеТекстурой(bool owns) |
| void | установитьПрямоугольник(const QRectF &r) |
| void | установитьПрямоугольник(qreal x, qreal y, qreal w, qreal h) |
| void | установитьИсходныйПрямоугольник(const QRectF &r) |
| void | установитьИсходныйПрямоугольник(qreal x, qreal y, qreal w, qreal h) |
| void | установитьТекстуру(QSGTexture *texture) |
| void | установитьПреобразованиеКоординатТекстуры(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode) |
| QRectF | исходныйПрямоугольник() const |
| QSGTexture * | текстура() const |
| QSGSimpleTextureNode::TextureCoordinatesTransformMode | преобразованиеКоординатТекстуры() const |
Подробное описание
Предупреждение: Класс узла простой текстуры должен иметь текстуру перед добавлением в граф сцены для отрисовки.
Предупреждение: Этот служебный класс функционален только при использовании стандартных или программных бэкэндов графа сцен Qt Quick. В качестве альтернативы предпочтительнее использовать QSGImageNode через QQuickWindow::createImageNode(). Однако этот автономный класс по-прежнему полезен при использовании через наследование, если приложение знает, что специальные бэкэнды графа сцен не будут вовлечены.
Документация по типам членов
перечисление QSGSimpleTextureNode::Флаг преобразования координат текстурыфлаги QSGSimpleTextureNode::Режим преобразования координат текстуры
Перечисление TextureCoordinatesTransformFlag используется для указания режима генерации координат текстуры для текстурированного четырехугольника.
| Константа | Значение | Описание |
|---|---|---|
QSGSimpleTextureNode::NoTransform |
0x00 |
Координаты текстуры ориентированы по координатам окна, т.е. с началом в верхнем левом углу. |
QSGSimpleTextureNode::MirrorHorizontally |
0x01 |
Координаты текстуры инвертированы по горизонтали относительно координат окна. |
QSGSimpleTextureNode::MirrorVertically |
0x02 |
Координаты текстуры инвертированы по вертикали относительно координат окна. |
Тип TextureCoordinatesTransformMode является псевдонимом для QFlags<TextureCoordinatesTransformFlag>. Он хранит логическое ИЛИ комбинацию значений TextureCoordinatesTransformFlag.
Документация по функциям-членам
QSGSimpleTextureNode::QSGSimpleTextureNode()
Конструирует новый узел простой текстуры
[override virtual] QSGSimpleTextureNode::~QSGSimpleTextureNode()
Уничтожает узел текстуры
QSGTexture::Filtering QSGSimpleTextureNode::filtering() const
Возвращает фильтрацию, в настоящее время установленную для этого узла текстуры
См. также установитьФильтрацию().
[since 5.4] bool QSGSimpleTextureNode::владеетТекстурой() const
Возвращает true, если узел берет на себя владение текстурой; в противном случае возвращает false.
Эта функция была добавлена в Qt 5.4.
См. также установитьВладениеТекстурой().
QRectF QSGSimpleTextureNode::прямоугольник() const
Возвращает целевой прямоугольник этого узла текстуры.
См. также установитьПрямоугольник().
void QSGSimpleTextureNode::установитьФильтрацию(QSGTexture::Filtering filtering)
Устанавливает фильтрацию, которая будет использоваться для этого узла текстуры, на filtering.
Для плавной масштабирования используйте QSGTexture::Linear; для обычного масштабирования используйте QSGTexture::Nearest.
См. также filtering().
[since 5.4] void QSGSimpleTextureNode::установитьВладениеТекстурой(bool owns)
Устанавливает, берет ли узел на себя владение текстурой, на owns.
По умолчанию узел не берет на себя владение текстурой.
Эта функция была добавлена в Qt 5.4.
См. также владеетТекстурой() и установитьТекстуру().
void QSGSimpleTextureNode::установитьПрямоугольник(const QRectF &r)
Устанавливает целевой прямоугольник этого узла текстуры на r.
См. также прямоугольник().
void QSGSimpleTextureNode::установитьПрямоугольник(qreal x, qreal y, qreal w, qreal h)
Это перегруженная функция.
Устанавливает прямоугольник этого узла текстуры, начиная с (x, y) и имеющего ширину w и высоту h.
[since 5.5] void QSGSimpleTextureNode::установитьИсходныйПрямоугольник(const QRectF &r)
Устанавливает исходный прямоугольник этого узла текстуры на r.
Эта функция была добавлена в Qt 5.5.
См. также исходныйПрямоугольник().
[since 5.5] void QSGSimpleTextureNode::установитьИсходныйПрямоугольник(qreal x, qreal y, qreal w, qreal h)
Это перегруженная функция.
Устанавливает прямоугольник этого узла текстуры, показывающий его текстуру от (x, y) и имеющий ширину w и высоту h относительно QSGTexture::textureSize.
Эта функция была добавлена в Qt 5.5.
void QSGSimpleTextureNode::setTexture(QSGTexture *texture)
Устанавливает текстуру для этого узла текстуры в texture.
Используйте setOwnsTexture(), чтобы установить, должен ли узел принять владение текстурой. По умолчанию узел не принимает владение.
Предупреждение: Узел текстуры должен иметь текстуру перед добавлением в графический сценарий для отрисовки.
См. также texture().
void QSGSimpleTextureNode::setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)
Устанавливает метод генерации координат текстуры в mode. Это может использоваться для получения правильной ориентации текстуры. Это часто необходимо при использовании сторонней библиотеки OpenGL для рендеринга в текстуру, так как OpenGL имеет инвертированную ось y относительно Qt Quick.
См. также textureCoordinatesTransform().
[since 5.5] QRectF QSGSimpleTextureNode::sourceRect() const
Возвращает прямоугольник источника этого узла текстуры.
Эта функция была введена в Qt 5.5.
См. также setSourceRect().
QSGTexture *QSGSimpleTextureNode::texture() const
Возвращает текстуру для этого узла текстуры.
См. также setTexture().
QSGSimpleTextureNode::TextureCoordinatesTransformMode QSGSimpleTextureNode::textureCoordinatesTransform() const
Возвращает режим генерации координат текстуры для этого узла.
См. также setTextureCoordinatesTransform().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qsgsimpletexturenode.html