Тип Scene2D QML

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

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

Свойства

• entities : список<Entity>
• item : Item
• mouseEnabled : bool
• output : RenderTargetOutput
• renderPolicy : перечисление

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

Этот объект использует RenderControl для отрисовки заданного Item на оффскрин-поверхности, которая прикреплена к текстуре, предоставленной пользователем. Это позволяет компоненту напрямую отрисовывать в текстуру без промежуточной копии и пользователю свободно указывать, как текстура используется в 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 : список<Entity>

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

item : Item

Содержит Item, который отрисовывается Scene2D в текстуру.

mouseEnabled : bool

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

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

output : RenderTargetOutput

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

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

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

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