Тип Scene2D QML

Этот тип позволяет рендерить qml в текстуру, которая затем может быть использована как часть 3D сцены. Подробнее...

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

Свойства

• entities : список<Сущность>
• item : Элемент
• mouseEnabled : bool
• output : Выход рендеринга
• renderPolicy : перечисление

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

Этот объект использует RenderControl для рендеринга заданного элемента на внеэкранную поверхность, которая прикреплена к текстуре, предоставленной пользователем. Это позволяет компоненту напрямую рендерить в текстуру без промежуточной копии, и пользователю свободно указывать, как используется текстура в 3D сцене.

Сущности, использующие Scene2D, могут быть связаны с типом, чтобы включить взаимодействие с элементом; если у сущности есть компонент ObjectPicker, события выбора от этого компонента отправляются в Scene2D и преобразуются в события мыши, которые затем отправляются элементу.

Использование:

Entity {
    id: sceneRoot

    // specify Scene2D inside the entity hierarchy
    Scene2D {
        // specify output
        output: RenderTargetOutput {
            attachmentPoint: RenderTargetOutput.Color0
            texture: Texture2D {
                id: textureId
                width: 1024
                height: 1024
                format: Texture.RGBA8_UNorm
            }
        }
        // specify entities
        entities: [entityId]

        // specify rendered content
        Rectangle {
            color: "red"
        }
    }

    Entity {
        id: entityId

        property Material material: TextureMaterial {
            texture: textureId
        }
        property ObjectPicker picker: ObjectPicker {
            hoverEnabled: true
            dragEnabled: true
        }
        ...

Документация свойств

entities : список<Сущность>

Содержит список сущностей, которые связаны с объектом Scene2D. Если у сущностей есть ObjectPicker, события выбора от этой сущности отправляются в Scene2D и преобразуются в события мыши.

item : Элемент

Содержит элемент, который рендерится Scene2D в текстуру.

mouseEnabled : bool

Указывает, включены ли события мыши для рендерируемого элемента. События мыши генерируются из событий выбора объекта сущностей, добавленных в Scene2D. События мыши включены по умолчанию.

Примечание: События, отправленные элементам, задерживаются на один кадр из-за того, что выбор объектов происходит на бэкенде.

output : RenderTargetOutput

Содержит RenderTargetOutput, который определяет, куда рендерится Scene2D.

renderPolicy : перечисление

Содержит политику рендеринга этого Scene2D.

• Непрерывный Scene2D рендерится непрерывно. Это политика рендеринга по умолчанию.
• Единоразовый Scene2D рендерится в текстуру только один раз, после чего ресурсы, выделенные для рендеринга, освобождаются.