En esta página

Scene2D QML Type

Este tipo permite renderizar qml en una textura, que luego puede utilizarse como parte de una escena 3D. Más...

Import Statement: import QtQuick.Scene2D 2.11
In C++: QScene2D
Status: Deprecated

Propiedades

Descripción Detallada

Este objeto utiliza RenderControl para renderizar el Item dado en una superficie fuera de la pantalla, que está unida a una textura proporcionada por el usuario. Esto permite al componente renderizar directamente en la textura sin copia intermedia y al usuario especificar libremente cómo se utiliza la textura en la escena 3D.

Las entidades que utilizan la Scene2D pueden asociarse con el tipo para permitir la interacción con el elemento; si una entidad tiene un componente ObjectPicker, los eventos de selección de ese selector se envían a la Scene2D y se convierten en eventos de ratón y finalmente se envían al elemento.

Nota: Sólo se admiten eventos de ratón. El ítem no soporta entrada de teclado.

Utilización:

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
        }
        ...

Documentación de Propiedades

entities : list<Entity>

Contiene la lista de entidades asociadas al objeto Scene2D. Si las entidades tienen ObjectPicker, los eventos de selección de esa entidad se envían a Scene2D y se convierten en eventos de ratón.

item : Item

Contiene el elemento, que se renderiza mediante Scene2D a la textura.

mouseEnabled : bool

Indica si los eventos de ratón están habilitados para el elemento renderizado. Los eventos de ratón se generan a partir de los eventos de recogida de objetos de las entidades añadidas a Scene2D. El ratón está activado por defecto.

Nota: Los eventos enviados a los elementos se retrasan un fotograma debido a la recogida de objetos que tiene lugar en el backend.

output : RenderTargetOutput

Contiene la dirección RenderTargetOutput, que especifica hacia dónde se renderiza Scene2D.

renderPolicy : enumeration

Mantiene la política de renderizado de este Scene2D.

  • Continuo El Scene2D está renderizando continuamente. Esta es la política de renderizado por defecto.
  • SingleShot El Scene2D renderiza a la textura sólo una vez, después de lo cual se liberan los recursos asignados para el renderizado.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.