Cambios en Qt Quick 3D
Qt 6 es el resultado de un esfuerzo deliberado por hacer que el marco de trabajo sea más eficiente y fácil de usar.
Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables en un esfuerzo por hacer de Qt un marco de trabajo mejor. Partes de la API de Qt Quick 3D se han modificado sustancialmente.
En este tema resumimos esos cambios en Qt Quick 3D y ofrecemos orientación para gestionarlos.
RHI
A partir de Qt 6.0, la implementación predeterminada de Qt Quick siempre realiza el renderizado a través de una capa de abstracción gráfica, la Interfaz de Hardware de Renderizado de Qt (RHI), proporcionada por el módulo QtGui. Esto significa que, a diferencia de Qt 5, el grafo de escena no realiza llamadas directas a OpenGL. En su lugar, registra los comandos de recursos y de dibujo utilizando las API de RHI, que a su vez traducen el flujo de comandos en llamadas a OpenGL, Vulkan, Metal o Direct 3D. La gestión de los shaders también se unifica escribiendo el código de los shaders una sola vez, compilándolo a SPIR-V y traduciéndolo posteriormente al lenguaje adecuado para las distintas API gráficas.
En el caso de « Qt Quick » 3D, el cambio más importante en Qt 6.0 es la migración a la interfaz común de hardware de renderizado (RHI), que permite que « Qt Quick » 3D se ejecute en Direct3D, Metal y Vulkan, además de en OpenGL y OpenGL ES.
Qt Quick Qt Quick 3D están ahora totalmente unificados en este aspecto. Cualquier ajuste de configuración relacionado con la RHI —por ejemplo, qué API gráfica elegir para el renderizado— es aplicable a ambos.
Consulta los requisitos gráficos de «Qt Quick 3D» para obtener más detalles.
Otros cambios en la API
Versión de importación de QML
A partir de Qt 6.0, el número de versión de las sentencias de importación de Qml es el mismo que el número de versión de Qt. Ahora también es posible importar un módulo sin especificar una versión: de este modo se importará la última versión del módulo.
Iluminación
Light brightness ahora representa un multiplicador de energía cuyo valor por defecto es 1,0, mientras que en Qt 5 se utilizaba un valor porcentual cuyo valor por defecto era 100. En la práctica, esto significa que todos los valores de brightness deben dividirse entre 100.
SceneEnvironment.probeBrightness se ha renombrado como probeExposure y también se ha redefinido como un multiplicador con un valor por defecto de 1,0. Es decir, todos los valores de probeBrightness deben renombrarse como probeExposure y dividirse por 100.
AreaLight Se ha eliminado por motivos de rendimiento. En muchos casos, puede sustituirse por « SpotLight », que se añadió en « Qt Quick 3D 5.15».
Materiales personalizados
La API de materiales personalizados se ha rediseñado por completo en la versión 6.0. Esto significa que cualquier material personalizado existente tendrá que reescribirse en gran medida. Consulta la documentación de CustomMaterial para obtener más detalles sobre la nueva API.
Efectos de posprocesamiento
Effect Se ha mejorado para permitir un código de shader muy similar al que admite CustomMaterial, siguiendo los mismos patrones en cuanto a estructura y palabras clave integradas. Esto significa que los efectos existentes que incluyan código de shader personalizado deberán migrarse antes de que puedan funcionar en Qt 6.0. Consulta la documentación de Effect para obtener más detalles.
Material «Principled»
El tipo QML « PrincipledMaterial » se ha mejorado considerablemente en Qt Quick 6.0 y ahora se ajusta más a los principios del renderizado basado en la física. Los modelos importados deberían renderizarse correctamente sin necesidad de modificar las propiedades de los materiales. Será necesario modificar los materiales existentes para eliminar cualquier compensación derivada de imprecisiones anteriores.
| PrincipledMaterial en Qt 5 | PrincipledMaterial en Qt 6 |
|---|---|
|
|
Algunas propiedades cambian sus valores por defecto:
- metalness el valor por defecto pasa a ser 0 en lugar de 1.
- specularAmount el valor por defecto es 0,5 en lugar de 0.
Material por defecto
Algunas propiedades cambian sus valores por defecto:
- specularRoughness el valor por defecto es 0 en lugar de 50.
Materiales predefinidos
QtQuick3D 6.0 no incluye materiales predefinidos. Es probable que los materiales que se añadan en futuras versiones no sean compatibles con los antiguos. La importación «Materials» ya no existe. (El tipo « CustomMaterial » se ha trasladado a la importación base « QtQuick3D »).
Estos son los tipos QML de materiales que se han eliminado en Qt 6.0:
- AluminumAnodizedEmissiveMaterial
- AluminumAnodizedMaterial
- AluminumBrushedMaterial
- AluminumEmissiveMaterial
- AluminumMaterial
- Material de cobre
- Material de vidrio esmerilado
- Material de vidrio esmerilado de una sola pasada
- Material de vidrio
- Material de vidrio refractivo
- PapelMaterialArtístico
- Material de oficina de papel
- Material de plástico estructurado rojo emisivo
- Plástico: material estructurado rojo
- Acero: material concéntrico fresado
Mapas de teselación y desplazamiento
El modo de teselación de modelos ha desaparecido debido a que ahora se presta mayor atención a la compatibilidad con hardware integrado. Además, como consecuencia de ello, se ha eliminado la compatibilidad con mapas de desplazamiento de los materiales. Se pueden conseguir efectos similares con un « custom material ».
Qt Quick Itemcomo elementos secundarios de « » 3D Node
Aunque sintácticamente son idénticos, la forma en que se gestionan los elementos hijos 2D es bastante diferente a nivel interno. En Qt 6.0 no hay un paso implícito de renderizado a textura. Más bien, el contenido de los « Qt Quick » 2D se renderiza en línea, con la proyección en perspectiva adecuada, en la misma pasada de renderizado, lo que proporciona un mejor rendimiento, un menor consumo de recursos y, en algunos casos, una fidelidad visual potencialmente mejorada (con « Text », por ejemplo). Véase «Qt Quick: Escenas 3D con contenido 2D» para obtener una visión general.
Si por alguna razón es importante atravesar una textura (recorte, opacidad), convierte el subárbol 2D Item en una capa de forma explícita estableciendo layer.enabled: true. De esta forma, el comportamiento se asemeja más al que ofrecía Qt 5.15.
El contenido 2D ya no se centra en el origen del nodo padre. En su lugar, es la esquina superior izquierda del elemento 2D de nivel superior la que se sitúa en el origen del nodo 3D. Por lo tanto, a menudo será conveniente que el elemento 2D de nivel superior especifique un ancla, como, por ejemplo, anchors.centerIn: parent, para obtener resultados similares a los de Qt 5.15.
© 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.

