Qt Quick Nivel de detalle 3D
Nivel de detalle (LoD)
El nivel de detalle (LoD) se refiere a la técnica de utilizar versiones alternativas de un modelo 3D a diferentes distancias de la cámara. El objetivo es optimizar el uso de recursos utilizando versiones más sencillas del modelo cuando este se encuentra lejos o ocupa una pequeña parte de la pantalla, y versiones más detalladas cuando está más cerca u ocupa una mayor parte del espacio de la pantalla. Este enfoque permite un uso eficiente de los recursos de la GPU al tiempo que se mantiene la fidelidad visual.
Qt Quick 3D ofrece tanto un sistema de nivel de detalle automático como uno explícito. El sistema automático se basa en el uso de una única malla con múltiples niveles de detalle almacenados en el archivo de malla. El sistema explícito se basa en el uso de un componente « LodManager » para especificar los diferentes niveles de detalle como modelos secundarios.
Nivel de detalle automático
La forma principal de utilizar la compatibilidad con el nivel de detalle automático es importando contenido con la herramienta Balsam Asset Import Tool. Al utilizar el indicador « --generateMeshLevelsOfDetail » al importar recursos, la herramienta generará niveles de detalle para cada malla siempre que sea posible. Esto se consigue intentando simplificar la geometría de la malla original, al tiempo que se mantienen las características generales. El resultado es geometría adicional, así como nuevos valores de índice para cada nivel de detalle adicional, además de un factor de distancia que se utiliza para determinar qué malla emplear para un tamaño de renderizado determinado. Este factor de distancia está relacionado con la distancia entre el objeto que se está renderizando y la cámara, pero lo más importante es contar con una buena relación entre geometría y píxeles. Estos datos se escriben en el archivo .mesh y se utilizarán automáticamente cuando los utilice un modelo.

Una desventaja del sistema automático, y la razón por la que no está activado por defecto, es que es posible que, al reducir la geometría, también se introduzcan artefactos visuales. El algoritmo de simplificación geométrica utilizado intenta conservar las características del modelo, pero en algunos casos puede ser necesario recalcular las normales de la malla para mantener el aspecto visual deseado. Esto se puede hacer utilizando el indicador « --recalculateLodNormals » al importar el activo. El proceso de recálculo de normales se puede ajustar aún más pasando valores de ángulos de Euler a los argumentos --recalculateLodNormalsMergeAngle y --recalculateLodNormalsSplitAngle para controlar el ángulo en el que se fusionan o se dividen las normales, respectivamente.
La principal ventaja del sistema automático es que resulta fácil de usar una vez que el activo se ha importado con la configuración adecuada. No se requiere código adicional para utilizar el sistema automático y cualquier modelo que haga referencia a los archivos de malla generados que contengan geometría con niveles de detalle elegirá automáticamente la geometría adecuada en función del número de píxeles que ocupe el modelo en la pantalla.
Es posible ajustar el comportamiento de la selección automática del nivel de detalle, ya sea en global level o en per-model level, utilizando la propiedad « levelOfDetailBias » de Camera o Model. El valor predeterminado de 1,0 de cada una de estas propiedades de sesgo significa que se confía en el valor calculado por el sistema automático. Este valor representa un sesgo respecto al valor ideal, de modo que un valor inferior a 1,0 requerirá un tamaño renderizado aún menor antes de pasar a un nivel de detalle inferior. Los valores superiores a 1,0 harán que se utilicen niveles de detalle más bajos antes. Un valor de 0,0 desactivará por completo el uso de los niveles de detalle y siempre se utilizará la geometría original de la malla.
El sistema automático no es tan flexible como el sistema explícito. Por ejemplo, el sistema automático siempre utiliza el mismo material para todos los niveles de detalle, lo que puede no ser siempre deseable. Otro posible inconveniente es que no hay transición entre los diferentes niveles de detalle, lo que, en teoría, no debería ser necesario con el nivel de detalle automático, pero puede ser deseable para determinados casos de uso.
Nivel de detalle explícito
El sistema de nivel de detalle explícito es más flexible que el automático, pero requiere más trabajo para su uso. El sistema explícito se basa en el uso de un componente « LodManager » para especificar los diferentes niveles de detalle como componentes hijos « Model ». Cualquier elemento hijo de « LodManager » que sea una instancia de «Model» se considerará un nivel de detalle. Esto resulta muy potente, ya que cada nivel de detalle puede ser un modelo totalmente personalizado, con sus propias geometrías y materiales.
El componente « LodManager » también cuenta con una propiedad « distances », que se utiliza para determinar qué componente « Model » secundario se debe emplear. El nodo « LodManager » realizará una transición al siguiente nodo « Model » a medida que la distancia de la cámara se acerque a cada límite de distancia. La propiedad « fadeDistance » permite establecer a qué distancia comienza y termina la transición de fundido cruzado en torno a los límites de distancia.
Este es un ejemplo de cómo utilizar el sistema explícito de niveles de detalle:

En el ejemplo mencionado, se utiliza la propiedad « LodManager » para especificar explícitamente diferentes archivos de malla para cada nivel de detalle del busto de mármol.
LodManager {
camera: camera
distances: [100, 140, 180]
fadeDistance: 10
Model {
scale: Qt.vector3d(100, 100, 100);
source: "meshes/marble_bust_01_LOD_0.mesh"
materials: [ marbleMaterial ]
}
Model {
scale: Qt.vector3d(100, 100, 100);
source: "meshes/marble_bust_01_LOD_1.mesh"
materials: [ marbleMaterial ]
}
Model {
scale: Qt.vector3d(100, 100, 100);
source: "meshes/marble_bust_01_LOD_2.mesh"
materials: [ marbleMaterial ]
}
Model {
scale: Qt.vector3d(100, 100, 100);
source: "meshes/marble_bust_01_LOD_3.mesh"
materials: [ marbleMaterial ]
}
}Para este código, este es un diagrama de lo que se está definiendo, que señala cómo se utiliza la lista de distancias para definir dónde se encuentran los límites entre los diferentes niveles de detalle, así como la propiedad `fadeDistance`, que se utiliza para definir la transición de fundido cruzado.

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