Qt 3D Descripción general
Qt 3D ofrece un renderizador totalmente configurable que permite a los desarrolladores implementar rápidamente cualquier proceso de renderizado que necesiten. Además, Qt 3D proporciona un marco genérico para simulaciones casi en tiempo real más allá del renderizado.
Qt 3D está claramente dividido en un núcleo y un número ilimitado de «aspectos» que pueden implementar cualquier funcionalidad que se desee. Los aspectos interactúan con componentes y entidades para proporcionar una parte concreta de la funcionalidad. Algunos ejemplos de aspectos son la física, el audio, las colisiones, la inteligencia artificial (IA) y la búsqueda de rutas.
Características básicas en 3D
Qt 3D es un marco de trabajo 3D que permite dibujar formas tridimensionales y moverlas, así como desplazar la cámara. Admite las siguientes características básicas:
- rendering 2D y 3D para aplicaciones en C++ y Qt Quick
- Meshes y geometría
- Materials
- Shaders
- Mapeado de sombras
- Ambient occlusion
- Alto rango dinámico
- Renderizado diferido
- Multitexturizado
- Renderizado instanciado
- Objetos de búfer uniforme
- Portabilidad a RHI
- Consejos profesionales
Los materiales
Qt 3D cuenta con un sistema de materiales robusto y muy flexible que permite múltiples niveles de personalización. Se adapta a diferentes enfoques de renderizado en distintas plataformas o versiones de OpenGL, permite múltiples pasadas de renderizado con diferentes conjuntos de estados, proporciona mecanismos para anular parámetros en distintos niveles y permite cambiar fácilmente de shader. Todo ello desde C++ o mediante enlaces de propiedades QML.
Las propiedades de un tipo « Material » pueden asignarse fácilmente a variables uniformes en un programa de sombreador GLSL que, a su vez, se especifica en la propiedad de efecto a la que se hace referencia.
Para ver ejemplos de uso de materiales, consulta los siguientes ejemplos:
Shaders
Qt 3D es compatible con todas las etapas programables del proceso de renderizado de OpenGL: sombreadores de vértices, de control de teselación, de evaluación de teselación, de geometría y de fragmentos. Se prevé la incorporación de sombreadores de cálculo en una futura versión.
Para ver ejemplos de uso de sombreadores, consulta el ejemplo de «Qt 3D: Wireframe» en QML.
Mapeado de sombras
OpenGL no admite directamente las sombras, pero existen innumerables técnicas que pueden emplearse para generarlas. El mapeo de sombras es sencillo de utilizar para generar sombras atractivas, al tiempo que supone un coste de rendimiento muy reducido.
El mapeo de sombras se suele implementar mediante un renderizado de dos pasadas. En la primera pasada, se genera la información de las sombras. En la segunda pasada, se genera la escena utilizando una técnica de renderizado concreta, al tiempo que se utiliza la información recopilada en la primera pasada para dibujar las sombras.
La idea en la que se basa el mapeado de sombras es que solo se iluminan los fragmentos más cercanos a la luz. Los fragmentos situados detrás de otros fragmentos quedan ocluidos y, por lo tanto, en sombra.
Por lo tanto, en la primera pasada, la escena se dibuja desde el punto de vista de la luz. La información que se almacena es simplemente la distancia del fragmento más cercano en este espacio de luz. En términos de OpenGL, esto equivale a disponer de un objeto de búfer de fotogramas (Framebuffer Object, o FBO) al que se le ha adjuntado una textura de profundidad. De hecho, la distancia desde el ojo es la definición de la profundidad, y la comprobación de profundidad predeterminada que realiza OpenGL almacenará, en realidad, solo la profundidad del fragmento más cercano.
Ni siquiera es necesario adjuntar una textura de color, ya que no hay que sombrear los fragmentos, sino únicamente calcular su profundidad.
La siguiente imagen muestra una escena con un plano con sombra propia y un nudo trébol:

La siguiente imagen muestra una textura de mapa de sombras exagerada de la escena:

La imagen indica la profundidad almacenada al renderizar la escena desde el punto de vista de la luz. Los colores más oscuros representan una profundidad menor (es decir, más cerca de la cámara). En esta escena, la luz se sitúa en algún punto por encima de los objetos de la escena, en el lado derecho con respecto a la cámara principal (compáralo con la primera captura de pantalla). Esto concuerda con el hecho de que el plano de juguete está más cerca de la cámara que los demás objetos.
Una vez generado el mapa de sombras, se realiza la segunda pasada de renderizado. En esta segunda pasada, el renderizado se realiza utilizando la cámara normal de la escena. Aquí se puede utilizar cualquier efecto, como el sombreado de Phong. Es importante que el algoritmo del mapa de sombras se aplique en el sombreador de fragmentos. Es decir, el fragmento más cercano a la luz se dibuja iluminado, mientras que los demás fragmentos se dibujan en sombra.
El mapa de sombras generado en la primera pasada proporciona la información necesaria sobre la distancia de los fragmentos a la luz. Entonces basta con reasignar el fragmento en el espacio de luz, calculando así su profundidad desde el punto de vista de la luz, así como dónde se encuentran sus coordenadas en la textura del mapa de sombras. A continuación, se puede muestrear la textura del mapa de sombras en las coordenadas dadas y comparar la profundidad del fragmento con el resultado del muestreo. Si el fragmento está más lejos, entonces está en sombra; de lo contrario, está iluminado.
Renderizado instanciado
La instanciación es una forma de hacer que la GPU dibuje muchas copias (instancias) de un objeto base que varía de alguna manera en cada copia. A menudo, en posición, orientación, color, propiedades del material, escala, etc. Qt 3D ofrece una API similar al elemento Qt Quick Repeater . En este caso, el delegado es el objeto base y el modelo proporciona los datos por instancia. Así, mientras que una entidad con un componente « Mesh » adjunto acaba transformándose en una llamada a `glDrawElements`, una entidad con un componente «instanced» se traducirá en una llamada a `glDrawElementsInstanced`.
El renderizado instanciado está previsto para una futura versión.
Objetos de búfer uniforme
Un objeto de búfer uniforme (UBO) puede vincularse a programas de sombreado de OpenGL para que grandes cantidades de datos estén fácilmente disponibles. Los casos de uso típicos de los UBO son conjuntos de parámetros de materiales o de iluminación.
Consejos útiles
En esta página se pueden encontrar algunos consejos de programación muy útiles para el renderizado 3D: Qt 3D Render Pro Tips.
Renderizador configurable
Para combinar la compatibilidad con las API de C++ y QML con un renderizador totalmente configurable, se introdujo el concepto de «framegraph ». Mientras que un «scenegraph» es una descripción basada en datos de lo que se va a renderizar, un «framegraph» es una descripción basada en datos de cómo renderizarlo.
Un «framegraph» permite a los desarrolladores elegir, por ejemplo, entre un renderizador directo sencillo —que incluye una pasada de relleno Z— o un renderizador diferido. También les permite controlar cuándo renderizar cualquier objeto transparente, entre otras cosas. Dado que todo esto se configura exclusivamente a partir de datos, resulta muy fácil modificarlo incluso de forma dinámica en tiempo de ejecución sin tener que tocar ningún código C++. Es posible ampliar Qt 3D creando tus propios «framegraphs» que implementen algoritmos de renderizado personalizados.
Extensiones 3D
Más allá de lo esencial para mostrar contenido 3D en pantalla, Qt 3D es lo suficientemente extensible y flexible como para actuar como host de los siguientes tipos de extensiones relacionadas con los objetos 3D:
- Simulación física
- Detección de colisiones
- Audio posicional 3D
- Animación de cuerpos rígidos, esqueléticos y de objetivos de morfo
- Búsqueda de rutas y otras funciones de IA
- Selección
- Partículas
- Generación de objetos
Rendimiento
Qt 3D está diseñado para ofrecer un buen rendimiento y escalar en función del número de núcleos de CPU disponibles, ya que el hardware moderno mejora el rendimiento aumentando el número de núcleos en lugar de la velocidad de reloj base. El uso de múltiples núcleos funciona bien, ya que muchas tareas son independientes entre sí. Por ejemplo, las operaciones que lleva a cabo un módulo de búsqueda de rutas no se solapan en gran medida con las tareas que realiza un renderizador, salvo quizá al renderizar información de depuración o estadísticas.
Qt 3D Arquitectura
Los principales casos de uso de Qt 3D son la simulación de objetos casi en tiempo real y el renderizado del estado de dichos objetos en la pantalla. El ejemplo de Space Invaders contiene los siguientes objetos:

- El cañón terrestre del jugador
- El terreno
- Los bloques defensivos
- Las naves enemigas de Space Invaders
- El platillo volante del jefe enemigo
- Las balas disparadas por los enemigos y por el jugador
En un diseño tradicional en C++, este tipo de objetos se implementarían normalmente como clases organizadas en una especie de árbol de herencia. Las distintas ramas del árbol de herencia podrían añadir funcionalidades adicionales a la clase raíz para características tales como:
- Acepta entradas del usuario
- Reproduce un sonido
- Está animado
- Choca con otros objetos
- Se dibuja en pantalla
Los tipos del ejemplo de Space Invaders pueden clasificarse según estas características. Sin embargo, diseñar un árbol de herencia elegante, incluso para un ejemplo tan sencillo, no es fácil.
Este enfoque y otras variantes de la herencia plantean una serie de problemas:
- Las jerarquías de herencia profundas y amplias son difíciles de comprender, mantener y ampliar.
- La taxonomía de la herencia queda fijada de forma definitiva en el momento de la compilación.
- Cada nivel del árbol de herencia de clases solo puede clasificar según un único criterio o eje.
- La funcionalidad compartida tiende a ascender por la jerarquía de clases con el paso del tiempo.
- Es imposible predecir lo que los desarrolladores querrán hacer.
Ampliar árboles de herencia profundos y extensos suele requerir comprender y estar de acuerdo con la taxonomía utilizada por el autor original. Por lo tanto, « Qt 3D » se centra en la agregación, en lugar de en la herencia, como medio para dotar de funcionalidad a una instancia de un objeto. Concretamente, « Qt 3D » implementa un sistema de componentes de entidad (ECS).
Uso de un ECS
En un ECS, una entidad representa un objeto simulado, pero por sí sola carece de cualquier comportamiento o característica específica. Se puede incorporar comportamiento adicional a una entidad haciendo que esta agregue uno o más componentes. Cada componente es una porción vertical del comportamiento de un tipo de objeto.
En el ejemplo de Space Invaders, el suelo es una entidad con un componente asociado que indica al sistema que la entidad necesita ser renderizada y qué tipo de renderizado requiere. Una nave enemiga de Space Invaders es otra entidad con componentes asociados que hacen que la nave se renderice, pero que también le permiten emitir sonidos, sufrir colisiones, animarse y ser controlada por una IA sencilla.
La entidad del cañón terrestre del jugador tiene componentes en su mayoría similares a los de la nave enemiga de «Space Invaders», salvo que no cuenta con el componente de IA. En su lugar, el cañón tiene un componente de entrada que permite al jugador moverlo y disparar balas.
Backend de ECS

El backend de Qt 3D implementa la parte del sistema del paradigma ECS en forma de aspectos. Un aspecto implementa la sección vertical concreta de la funcionalidad que proporcionan a las entidades una combinación de uno o más de sus componentes agregados.
Por ejemplo, el aspecto de renderizado busca entidades que tengan componentes de malla, material y, opcionalmente, de transformación. Si el aspecto de renderizado encuentra una entidad así, sabe cómo tomar esos datos y dibujar algo bonito a partir de ellos. Si una entidad no tiene esos componentes, el aspecto de renderizado la ignora.
Qt 3D crea entidades personalizadas mediante la agregación de componentes que proporcionan capacidades adicionales. El motor « Qt 3D » utiliza aspectos para procesar y actualizar entidades con componentes específicos.
Por ejemplo, un aspecto de física busca entidades que tengan algún tipo de componente de volumen de colisión y otro componente que especifique otras propiedades necesarias para dichas simulaciones, como la masa, el coeficiente de fricción, etc. Una entidad que emite sonido tiene un componente que especifica que es un emisor de sonido, además de indicar cuándo y qué sonidos deben reproducirse.
Dado que el ECS utiliza la agregación en lugar de la herencia, es posible cambiar dinámicamente el comportamiento de un objeto en tiempo de ejecución simplemente añadiendo o eliminando componentes.
Por ejemplo, para que un jugador pueda atravesar paredes de repente tras obtener un potenciador, se puede eliminar temporalmente el componente de volumen de colisión de esa entidad, hasta que el potenciador deje de tener efecto. No es necesario crear una subclase especial y puntual para PlayerWhoRunsThroughWalls.
Qt 3D Implementación de ECS
Qt 3D implementa el ECS como una jerarquía de clases sencilla. La clase base de ` Qt 3D ` es `Qt3DCore::QNode`, que es una subclase de ` QObject`. `Qt3DCore::QNode` añade a ` QObject ` la capacidad de comunicar automáticamente los cambios de propiedades a los aspectos, así como un identificador único en toda la aplicación. Los aspectos existen en subprocesos adicionales y Qt3DCore::QNode simplifica la transferencia de datos entre los objetos orientados al usuario y los aspectos.
Normalmente, las subclases de `Qt3DCore::QNode` proporcionan datos de apoyo adicionales a los que hacen referencia los componentes. Por ejemplo, la clase `QShaderProgram` especifica el código GLSL que se debe utilizar al renderizar un conjunto de entidades.

Los componentes de Qt 3D se implementan creando subclases de Qt3DCore::QComponent y añadiendo los datos necesarios para que el aspecto correspondiente realice su trabajo. Por ejemplo, el aspecto del renderizador utiliza el componente de malla para recuperar los datos por vértice que deben enviarse a través del canal de OpenGL.
Por último, Qt3DCore::QEntity es simplemente un objeto que puede agrupar cero o más instancias de Qt3DCore::QComponent.
Ampliación Qt 3D
Añadir funcionalidad a Qt 3D, ya sea como parte de Qt XML o de forma específica para tus propias aplicaciones con el fin de beneficiarte del back-end multihilo, consiste en las siguientes tareas:
- Identificar e implementar los componentes y datos de apoyo necesarios.
- Registrar los componentes en el motor QML (solo si se utiliza la API de QML).
- Crear una subclase de `QAbstractAspect` e implementar la funcionalidad del subsistema.
Qt 3D Motor basado en tareas
En Qt 3D, en cada fotograma se solicita a los aspectos un conjunto de tareas que deben ejecutarse, junto con las dependencias entre ellas. Un programador distribuye las tareas entre todos los núcleos configurados para mejorar el rendimiento.
Qt 3DAspectos de xml-ph-0000@deepl.internal
De forma predeterminada, Qt 3D proporciona los aspectos Qt3DRender y Qt3DInput. Los componentes y otras clases de apoyo que proporcionan estos aspectos se describen en la documentación de dichos módulos.
En futuras versiones de Qt 3D se añadirán aspectos adicionales que ofrecerán más funcionalidades.
© 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.