Mapeado de sombras
Introducción
El mapeado de sombras es una técnica habitual para generar sombras en tiempo real en una escena 3D. Funciona mediante el renderizado de una textura de mapa de profundidad desde el punto de vista de la fuente de luz. A continuación, al sombrear un píxel de un modelo 3D, su valor de profundidad se compara con el mapa de profundidad y se sombrea más oscuro si está en sombra o más claro si está iluminado por la luz.
Las sombras contribuyen al realismo perceptivo de una escena y facilitan la evaluación de las posiciones relativas de los objetos.

Fíjate en cómo, en la escena de la izquierda de la imagen, es imposible saber a qué distancia del plano se encuentran los objetos, mientras que en la escena de la derecha las sombras lo hacen más fácil.
Qt ofrece soporte para el mapeado de sombras en nuestros tres tipos de luz: DirectionalLight, PointLight y SpotLight. Para activar las sombras en tu escena, primero debes configurar la luz para que proyecte sombras estableciendo castsShadow en true. A continuación, puedes controlar qué modelos proyectarán y recibirán sombras configurando castsShadows y receivesShadows en true o false.
Luces direccionales
La luz direccional emite luz en una sola dirección desde una fuente no identificable situada a una distancia infinita. Esto es similar a cómo funciona la luz solar en la vida real. Una luz direccional tiene un alcance infinito y no se atenúa.
Mapas de sombras en cascada
Uno de los problemas de los mapas de sombras en bloque ( DirectionalLight ) es que renderizan toda la escena desde el punto de vista de la luz. Esto puede dar lugar a sombras con aspecto pixelado cuando el tamaño del mapa de sombras no es adecuado. Una opción para obtener una mejor calidad de renderizado es utilizar mapas de sombras en cascada (CSM). Qt admite una versión de CSM denominada «mapas de sombras de división paralela» (PSSM). Los PSSM funcionan dividiendo el frustum de visión en varias partes y renderizando un mapa de sombras para cada una de ellas.

Esta imagen muestra una representación abstracta de un frustum de visión con divisiones PSSM. Presenta dos divisiones que dan lugar a tres cascadas.
De esta forma, se puede conseguir una mejor resolución del mapa de sombras más cerca de la cámara, donde la calidad visual es más apreciable, y una resolución menor más lejos de la cámara, donde la calidad visual es menos perceptible.

La imagen anterior muestra un mapa de sombras sin divisiones (izquierda) y un mapa de sombras con tres divisiones (derecha).
Puedes controlar el número de divisiones en cascada mediante la propiedad csmNumSplits y la ubicación de las divisiones mediante las propiedades csmSplit1, csmSplit2 y csmSplit3. Para conseguir transiciones agradables entre las divisiones, puedes especificar un grado determinado de mezcla entre ellas con la propiedad csmBlendRatio.

La imagen anterior muestra una vista ampliada de una unión en cascada sin mezcla activada.
Ten en cuenta que, por cada división que añadas, la aplicación tendrá que renderizar otro mapa de sombras, lo que afectará negativamente al rendimiento. El tamaño del área de mezcla influirá en el rendimiento, así que procuras que sea lo más pequeño posible.
Luz puntual
La luz puntual ( PointLight ) puede describirse como una esfera que emite luz con la misma intensidad en todas las direcciones desde el centro de la luz hasta un radio determinado. Esto es similar a la forma en que una bombilla emite luz.

PointLight renderiza su mapa de sombras en un mapa cúbico, lo que significa que realiza seis pasadas de renderizado. Esto puede suponer una carga computacional considerable.
Foco
El « SpotLight » emite luz en una sola dirección con forma de cono, definida por la propiedad « coneAngle ». La intensidad de la luz disminuye a medida que se acerca a la « coneAngle ». El ángulo a partir del cual la intensidad de la luz comienza a disminuir viene definido por « innerConeAngle ». Esto es similar a cómo emite luz una linterna o un foco.

A diferencia del PointLight, el SpotLight renderiza su mapa de sombras en un único mapa de profundidad.
Rendimiento y ajuste de la escena
Aunque Qt intenta proporcionar valores por defecto razonables para las propiedades relacionadas con el mapeado de sombras, suele ser necesario ajustarlas para adaptarlas a la escena concreta. Especialmente si tienes una escena mucho más pequeña o más grande de lo esperado. En la siguiente sección se explica con más detalle cómo puedes ajustar los valores para que el mapa de sombras tenga un buen aspecto y, al mismo tiempo, se mantenga el mejor rendimiento posible.
El «shadow bias»
Shadow bias es una forma de eliminar el denominado «acné de sombras», que son sombras falsas que suelen aparecer siguiendo ciertos patrones. El sesgo de sombra desplaza la textura de profundidad del mapa de sombras de tal manera que las sombras parecen estar más alejadas del objeto que las proyecta, lo que a menudo corrige el acné de sombras. El inconveniente es que, si el sesgo de sombra es excesivo, puede producirse un efecto denominado «peter panning», en el que la sombra queda demasiado alejada del objeto que la proyecta. También es posible reducir el «acné de sombras» aumentando la resolución del mapa de sombras.

La imagen anterior muestra una escena con un sesgo de sombra de 0 (izquierda) frente a uno de 10 (derecha). La escena de la izquierda presenta algunas sombras falsas en la parte superior de los conos y cilindros.
Resolución del mapa de sombras
La resolución o calidad del mapa de sombras se controla mediante la propiedad « shadowMapQuality ». Una mayor calidad del mapa de sombras reduce el efecto de «bloqueo» de las sombras, pero su renderizado es más costoso, por lo que conviene ajustarla al valor más bajo posible sin perder la calidad visual necesaria.

La imagen anterior muestra una escena con una resolución baja del mapa de sombras frente a una con una resolución alta.
Calidad de las sombras suaves
Las sombras suaves son una forma de aproximarse al aspecto de las sombras en la vida real, donde se desvanecen de más definidas a más suaves en los bordes. La calidad de las sombras suaves se controla mediante la propiedad « softShadowQuality ». Admite tanto sombras duras sin suavidad como sombras suaves con filtrado por proximidad porcentual (PCF) de diversa calidad. Las sombras duras son las más baratas de renderizar, mientras que el PCF resulta cada vez más costoso a medida que aumenta la calidad. Para controlar el radio de la sombra suave, utiliza la propiedad « pcfFactor ». El valor de « pcfFactor » no afecta a la velocidad de renderizado, pero cuanto mayor sea, mayor deberá ser la calidad de la sombra suave para que el resultado sea satisfactorio.

La imagen anterior muestra una escena con una sombra « softShadowQuality » ( Light.Hard ) a la izquierda y una escena con una sombra « softShadowQuality » ( Light.PCF32 ) y una « pcfFactor » ( 10 ) a la derecha.
Distancia máxima del mapa de sombras
La propiedad shadowMapFar se puede utilizar para controlar la distancia máxima del mapa de sombras. Esta propiedad funciona de forma ligeramente diferente para PointLight y SpotLight frente a DirectionalLight.
En el caso de PointLight/SpotLight, determina el tamaño que debe tener el rectángulo delimitador de la sombra renderizada, mientras que en el caso de DirectionalLight, define la distancia a la que el mapa de sombras debe extenderse desde la cámara de la escena.

La imagen anterior muestra la misma escena con la misma luz direccional, pero con dos valores diferentes para « shadowMapFar ».
Profundidad de bits del mapa de sombras
Hay ciertos casos en los que se tiene una escena muy grande, lo que hace que el mapa de sombras cubra una gran área en su eje de profundidad. Por ejemplo, si hay muchos objetos alejados de la vista de la cámara que siguen proyectando sombras y deben formar parte de los límites del mapa de sombras. Lo que puede ocurrir en este caso es que, incluso con un valor más alto de « shadowBias », la escena siga presentando artefactos de bandas. Una forma de solucionar esto es utilizar una profundidad de 32 bits en el mapa de sombras. Al establecer la propiedad « use32BitShadowmap » en « true », se activará esta opción para esa luz concreta.

La imagen anterior muestra la misma escena con la misma luz direccional, pero en un caso se utiliza un mapa de sombras de 32 bits y en el otro, uno de 16 bits.
Véase también «Uso de la iluminación basada en imágenes», «Mapas de luz e iluminación global» y «Qt Quick 3D: ejemplo de mapas de sombras en cascada».
© 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.