Класс QScene2D
класс Qt3DRender::Quick::QScene2DЭтот класс позволяет отрисовывать qml в текстуру, которая затем может быть использована как часть 3D сцены. Подробнее...
| Заголовок: | #include <Qt3DQuickScene2D/QScene2D> |
| CMake: | find_package(Qt6 COMPONENTS 3dquickscene2d REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dquickscene2d) |
| qmake: | QT += 3dquickscene2d |
| С: | Qt 5.9 |
| Инициализируется: | Scene2D |
| Наследуется от: | Qt3DCore::QNode |
Открытые типы
| перечисление | RenderPolicy { Continuous, SingleShot } |
Свойства
- item : QQuickItem*
- mouseEnabled : bool
- output : Qt3DRender::QRenderTargetOutput*
- renderPolicy : RenderPolicy
Открытые функции
| QScene2D(Qt3DCore::QNode *parent = nullptr) | |
| void | addEntity(Qt3DCore::QEntity *entity) |
| QList<Qt3DCore::QEntity *> | entities() const |
| bool | isMouseEnabled() const |
| QQuickItem * | item() const |
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | removeEntity(Qt3DCore::QEntity *entity) |
| QScene2D::RenderPolicy | renderPolicy() const |
Открытые слоты
| void | setItem(QQuickItem *item) |
| void | setMouseEnabled(bool enabled) |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
| void | setRenderPolicy(QScene2D::RenderPolicy policy) |
Сигналы
| void | itemChanged(QQuickItem *item) |
| void | mouseEnabledChanged(bool enabled) |
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
| void | renderPolicyChanged(QScene2D::RenderPolicy policy) |
Подробное описание
Этот класс использует QQuickRenderControl для отрисовки заданного QQuickItem на поверхностном изображении, которое прикреплено к текстуре, предоставленной пользователем. Это позволяет компоненту напрямую отрисовывать в текстуру без промежуточной копии и позволяет пользователю свободно определять, как используется текстура в 3D сцене.
Сущности, использующие QScene2D, могут быть связаны с классом для обеспечения взаимодействия с элементом; если сущность имеет компонент QObjectPicker, события выбора от этого пикера отправляются в QScene2D и преобразуются в события мыши, которые, в конечном итоге, отправляются в элемент.
Примечание: Поддерживаются только события мыши. Элемент не поддерживает ввод с клавиатуры.
Документация по типам членов
перечисление QScene2D::RenderPolicy
Это перечисление типов политик рендеринга, доступных в данном классе.
| Постоянная | Значение | Описание |
|---|---|---|
Qt3DRender::Quick::QScene2D::Continuous |
0 |
QScene2D постоянно отрисовывается. Это политика рендеринга по умолчанию. |
Qt3DRender::Quick::QScene2D::SingleShot |
1 |
QScene2D отрисовывает текстуру только один раз, после чего освобождает ресурсы, выделенные для рендеринга. |
Документация по свойствам
item : QQuickItem*
Содержит QQuickItem, который отрисовывается QScene2D в текстуру.
Функции доступа:
| QQuickItem * | item() const |
| void | setItem(QQuickItem *item) |
Сигнал уведомления:
| void | itemChanged(QQuickItem *item) |
mouseEnabled : bool
Указывает, включены ли события мыши для отрисовываемого элемента. События мыши генерируются из событий выбора объектов сущностей, добавленных в QScene2D. Включение мыши по умолчанию.
Примечание: События задерживаются на один кадр из-за того, что выбор объектов происходит в бэкенде.
Функции доступа:
| bool | isMouseEnabled() const |
| void | setMouseEnabled(bool enabled) |
Сигнал уведомления:
| void | mouseEnabledChanged(bool enabled) |
output : Qt3DRender::QRenderTargetOutput*
Содержит QRenderTargetOutput, который определяет, куда отрисовывает QScene2D.
Функции доступа:
| Qt3DRender::QRenderTargetOutput * | output() const |
| void | setOutput(Qt3DRender::QRenderTargetOutput *output) |
Сигнал уведомления:
| void | outputChanged(Qt3DRender::QRenderTargetOutput *output) |
renderPolicy : RenderPolicy
Содержит политику рендеринга этого Scene2D.
Функции доступа:
| QScene2D::RenderPolicy | renderPolicy() const |
| void | setRenderPolicy(QScene2D::RenderPolicy policy) |
Сигнал уведомления:
| void | renderPolicyChanged(QScene2D::RenderPolicy policy) |
Документация по членам-функциям
QScene2D::QScene2D(Qt3DCore::QNode *parent = nullptr)
Конструктор создаёт новый экземпляр QScene2D с указанным parent.
void QScene2D::addEntity(Qt3DCore::QEntity *entity)
Добавляет entity в объект QScene2D. Если у сущностей есть QObjectPicker, события выбора с этой сущности отправляются в QScene2D и преобразуются в события мыши.
QList<Qt3DCore::QEntity *> QScene2D::entities() const
Получить сущности, связанные с QScene2D.
void QScene2D::removeEntity(Qt3DCore::QEntity *entity)
Удаляет entity из объекта QScene2D.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qt3drender-quick-qscene2d.html
