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 información...

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

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Este objeto utiliza RenderControl para renderizar el elemento dado en una superficie fuera de pantalla, que está vinculada a una textura proporcionada por el usuario. Esto permite que el componente renderice directamente en la textura sin necesidad de copias intermedias y que el usuario especifique libremente cómo se utiliza la textura en la escena 3D.

Las entidades que utilizan Scene2D pueden asociarse a este 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 Scene2D, se convierten en eventos de ratón y, finalmente, se envían al elemento.

Nota: Solo se admiten eventos de ratón. El elemento no admite entradas de teclado.

Uso:

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 disponen de `ObjectPicker`, los eventos de selección de dicha entidad se envían a ` Scene2D ` y se convierten en eventos del ratón.

item : Item

Contiene el elemento que « Scene2D » aplica a la textura.

mouseEnabled : bool

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

Nota: Los eventos enviados a los elementos se retrasan un fotograma debido a que la selección de objetos se realiza en el backend.

output : RenderTargetOutput

Contiene el objeto `RenderTargetOutput`, que especifica dónde se realiza el renderizado del objeto ` Scene2D `.

renderPolicy : enumeration

Contiene la política de renderizado de este Scene2D.

  • Continuo: el Scene2D se renderiza de forma continua. Esta es la política de renderizado predeterminada.
  • SingleShot: el « Scene2D » se renderiza en la textura solo una vez, tras 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.