Renderizado instanciado
Introducción
Qt Quick El 3D admite la instanciación de objetos Model. La instanciación se refiere a una técnica en la que un objeto se renderiza varias veces con una sola llamada de dibujo. (Por ejemplo, la función de OpenGL glDrawElementsInstanced.)
La instanciación permite duplicar un modelo con variaciones. A diferencia de lo que ocurre al utilizar un ` Repeater3D`, el modelo y sus recursos gráficos solo se asignan una vez. El renderizado de las instancias duplicadas lo realiza la GPU a bajo nivel. Dependiendo de la complejidad del modelo, esto puede suponer una mejora del rendimiento de varios órdenes de magnitud.
En la práctica, la instanciación se lleva a cabo definiendo una tabla que especifica cómo se modifica cada instancia con respecto al modelo base.
API de instanciación
El principio fundamental de la API de instanciación es que es explícita: no intenta detectar automáticamente oportunidades de instanciación dentro de la API existente. En su lugar, cada modelo se marca individualmente estableciendo su propiedad « instancing » para que haga referencia a un objeto « Instancing ». El mismo objeto «Instancing» puede utilizarse en varios modelos al mismo tiempo.
El objeto «Instancing» especifica una tabla que define cómo se representa cada copia. Las modificaciones disponibles son:
- transformación: posición, rotación y escala
- color: un color que se mezcla con el material del modelo
- datos personalizados: datos que pueden ser utilizados por materiales personalizados
Qt proporciona tres tipos de Qml que heredan de `Instancing`:
- InstanceList enumera todas las instancias y permite vincularse a las propiedades de cada una de ellas.
- RandomInstancing ofrece una forma de realizar pruebas y crear prototipos rápidamente mediante la generación de instancias aleatorias dentro de unos límites definidos.
- FileInstancing lee una tabla de instancias desde un archivo externo.
El ejemplo de instanciación muestra cómo crear una escena utilizando la API de QML.
Se pueden definir otros tipos de tablas de instancias en C++ creando subclases de ` QQuick3DInstancing`. Por ejemplo, el ` particle system ` utiliza internamente su propia tabla de instanciación. Está disponible como ` ModelParticle3D.instanceTable`.
Al escribir código de shader personalizado, es posible utilizar la instanciación para controlar propiedades adicionales, como variables para el renderizado basado en la física, pesos de animación esquelética, distorsión o cualquier otro elemento que pueda expresarse con materiales personalizados. Los datos personalizados de la tabla de instanciación consisten en cuatro números de coma flotante.
El ejemplo de instanciación personalizada muestra cómo combinar materiales personalizados y una tabla de instanciación implementada en C++.
Mezcla alfa e instanciación
Para que la mezcla alfa sea correcta, es necesario que los objetos semitransparentes se rendericen de atrás hacia delante. Por este motivo, QtQuick3D clasifica los objetos opacos y semitransparentes por separado y los renderiza en el orden correcto. Sin embargo, con la instanciación, la GPU renderizará las instancias en el orden especificado por la tabla de instanciación, si no está activada la opción « depth-sorting ». Por motivos de rendimiento, QtQuick3D no ordena la tabla de forma predeterminada, ya que puede llevar mucho tiempo cuando hay un gran número de instancias. Esto significa que, si las instancias semitransparentes se superponen entre sí o con otros objetos semitransparentes, los resultados pueden parecer incorrectos. En general, el error es menos visible cuando la opacidad es baja.
Los objetos totalmente opacos, junto con los objetos semitransparentes que no se solapan, siempre se representarán correctamente, ya que Qt utiliza pruebas de búfer de profundidad para evitar dibujar detrás de objetos opacos. Sin embargo, la falta de ordenación tiene posibles implicaciones en el rendimiento de los objetos opacos: es posible que no se representen en el orden óptimo, lo que significa que el mismo píxel puede escribirse varias veces, lo que supone más trabajo para el sombreador de fragmentos.
El renderizador no inspecciona el contenido de la tabla de instanciación, por lo que debe especificarse explícitamente cuando una tabla de instanciación contenga valores alfa semitransparentes: establece la propiedad ` hasTransparency ` en ` true ` para asegurarte de que el renderizador habilite la mezcla alfa. Esto se aplica a todas las instancias: incluso las instancias totalmente opacas se renderizarán sin comprobación de profundidad, lo que podría provocar errores visibles.
El orden de renderizado respecto al resto de la escena se puede ajustar configurando la propiedad « depth bias » del modelo.
Transformaciones e instanciación
Cada instancia tiene su propia transformación en la tabla de instancias. Esta se combina con las transformaciones del modelo instanciado. Esto resulta algo complejo, ya que existen varios casos de uso:
- Realizar una transformación en el modelo que se aplique a cada instancia individual. Esto permite animaciones sencillas, por ejemplo, girando todas las instancias a la vez sin tener que modificar la tabla de instancias.
- Transformar todo el grupo de instancias a la vez.
- Instanciar una jerarquía de modelos.
Para dar soporte a todos estos casos, la transformación del modelo se divide en dos partes: la transformación local de la instancia y la transformación global de la instancia. Conceptualmente, la instanciación se realiza de la siguiente manera:
- En primer lugar, el modelo se transforma según la transformación de instancia local.
- A continuación, cada instancia se calcula aplicando la transformación de la tabla de instancias.
- Por último, todo el conjunto de objetos instanciados se transforma según la transformación global de instancias.
Por defecto, la transformación de instancia local de un modelo consiste en la escala y la rotación del modelo, mientras que el resto se incluye en la transformación de instancia global.
Esto se puede controlar configurando la propiedad « instanceRoot » del modelo. Esta propiedad define el origen del sistema de coordenadas de la instancia. El uso más habitual es al instanciar una jerarquía de modelos. Por ejemplo, una esfera que orbita alrededor de un cubo:
Model {
id: cube
instancing: someInstanceTable
source: "#Cube"
materials: DefaultMaterial { diffuseColor: "lightgray" }
Node {
Model {
source: "#Sphere"
instanceRoot: cube
instancing: cube.instancing
x: 150
materials: DefaultMaterial { diffuseColor: "gray" }
}
NumberAnimation on eulerRotation.y {
from: 0
to: 360
duration: 4000
loops: Animation.Infinite
}
}
}La propiedad ` instanceRoot ` es necesaria para especificar que la instancia de la esfera debe colocarse como si fuera un elemento del cubo. Cada modelo de una jerarquía debe seguir especificando la propiedad ` instancing `: en casos normales, todos deben estar configurados con el mismo objeto ` Instancing `.
instanceRoot También se puede utilizar al instanciar un único modelo. Por ejemplo, un cilindro que gira alrededor de un punto descentrado:
Node {
id: parentNode
Model {
source: "#Cylinder"
instanceRoot: parentNode
instancing: anotherInstanceTable
x: 25
materials: DefaultMaterial { diffuseColor: "white" }
}
NumberAnimation on eulerRotation.y {
from: 0
to: 360
duration: 1000
loops: Animation.Infinite
}
}Selección e instanciación
Picking es un mecanismo que permite seleccionar un modelo a partir de una interacción con la interfaz de usuario. Con el renderizado instanciado, existen varias representaciones del mismo modelo, por lo que el resultado de la selección incluirá un instance index. La selección instanciada se habilita configurando la propiedad pickable en el modelo base.
© 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.