From f49d7146a4bb6c18fdf4fdd39b6d9a2cce761cd8 Mon Sep 17 00:00:00 2001 From: Hugo Date: Thu, 7 May 2026 19:56:55 -0300 Subject: [PATCH 1/4] Update what_is.md --- docs/lighting/clustered/what_is.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lighting/clustered/what_is.md b/docs/lighting/clustered/what_is.md index 625f0f8d..9ec34101 100644 --- a/docs/lighting/clustered/what_is.md +++ b/docs/lighting/clustered/what_is.md @@ -122,7 +122,7 @@ You can control the size of the shadow map by changing the "Initial Shadow Size" ![Initial Shadow Size is 7](images/shadowsize7.png) > [!NOTE] -> In the clustered renderer, shadowmaps for all lights are stored in a single, larger texture, called the 'Shadow Atlas', which has space for a limited amount of shadow data. Each time you increase the size of a shadow by 1, you increase the atlas' shadow size by a factor of 4. For example, a shadow of size 2 takes up only a quarter of the space that a shadow of size 3 takes up. +> In the clustered renderer, shadowmaps for all lights are stored in a single, larger texture, called the 'Shadow Atlas', which has space for a limited amount of shadow data. Each time you increase the size of a shadow by 1, you increase the atlas' shadow size by a factor of 4 (double the horizontal and vertical dimensions). For example, a shadow of size 2 takes up only a quarter of the space that a shadow of size 3 takes up. > If shadows in your map stop appearing suddenly, consider reducing the shadow size of a few less important shadows. > [!WARNING] From 4bbe7a04ae27a3c9531b3c63e0b9e4b728764bf8 Mon Sep 17 00:00:00 2001 From: Hugo Date: Thu, 7 May 2026 20:03:59 -0300 Subject: [PATCH 2/4] Update troubleshooting.md --- docs/lighting/clustered/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lighting/clustered/troubleshooting.md b/docs/lighting/clustered/troubleshooting.md index d66d87f0..6cc59148 100644 --- a/docs/lighting/clustered/troubleshooting.md +++ b/docs/lighting/clustered/troubleshooting.md @@ -16,7 +16,7 @@ This is a list of currently known issues and some troubleshooting tips for any i ### "I set the Shadowed spawn flag, but there are still no shadows / light leaks through walls" -* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas size by a factor of 4**, and **the shadow atlas cannot have exceed a value of 7**, so if there are for example 2 `light_rt`s with shadow size of 6 close to each other, they will overlap and therefore will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows. +* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas size by a factor of 4** (double the horizontal and vertical dimensions), and **the shadow atlas cannot have exceed a value of 7**, so if there are for example two `light_rt`s with a high shadow size, and the available space in the shadow atlas can only fit one of them (such that they would overlap), they will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows – when trying to fit a single shadow into the atlas, the engine will downscale it to the next biggest available space. ### "My dynamic shadows are blurry" From e5be906c0426ba86af27a3ec23c386aa8bacbfea Mon Sep 17 00:00:00 2001 From: Hugo Date: Thu, 7 May 2026 20:25:33 -0300 Subject: [PATCH 3/4] Update troubleshooting.md --- docs/lighting/clustered/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lighting/clustered/troubleshooting.md b/docs/lighting/clustered/troubleshooting.md index 6cc59148..cfd07543 100644 --- a/docs/lighting/clustered/troubleshooting.md +++ b/docs/lighting/clustered/troubleshooting.md @@ -16,7 +16,7 @@ This is a list of currently known issues and some troubleshooting tips for any i ### "I set the Shadowed spawn flag, but there are still no shadows / light leaks through walls" -* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas size by a factor of 4** (double the horizontal and vertical dimensions), and **the shadow atlas cannot have exceed a value of 7**, so if there are for example two `light_rt`s with a high shadow size, and the available space in the shadow atlas can only fit one of them (such that they would overlap), they will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows – when trying to fit a single shadow into the atlas, the engine will downscale it to the next biggest available space. +* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas usage by a factor of 4** (double the horizontal and vertical dimensions), and **the shadow size cannot have exceed a value of 7**, so if there are for example two `light_rt`s with a high shadow size, and the available space in the shadow atlas can only fit one of them (such that they would overlap), they will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows – when trying to fit a single shadow into the atlas, the engine will downscale it to the next biggest available space. ### "My dynamic shadows are blurry" From 5a73ab6753c61b286b362f18a96a4d216dd3c07a Mon Sep 17 00:00:00 2001 From: Hugo Date: Thu, 7 May 2026 20:26:18 -0300 Subject: [PATCH 4/4] Update troubleshooting.md --- docs/lighting/clustered/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/lighting/clustered/troubleshooting.md b/docs/lighting/clustered/troubleshooting.md index cfd07543..bf896749 100644 --- a/docs/lighting/clustered/troubleshooting.md +++ b/docs/lighting/clustered/troubleshooting.md @@ -16,7 +16,7 @@ This is a list of currently known issues and some troubleshooting tips for any i ### "I set the Shadowed spawn flag, but there are still no shadows / light leaks through walls" -* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas usage by a factor of 4** (double the horizontal and vertical dimensions), and **the shadow size cannot have exceed a value of 7**, so if there are for example two `light_rt`s with a high shadow size, and the available space in the shadow atlas can only fit one of them (such that they would overlap), they will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows – when trying to fit a single shadow into the atlas, the engine will downscale it to the next biggest available space. +* You have too many dynamic shadows updating at once. Remember that **each shadow size level increases the shadow atlas usage by a factor of 4** (double the horizontal and vertical dimensions), and **the shadow size cannot exceed a value of 7**, so if there are for example two `light_rt`s with a high shadow size, and the available space in the shadow atlas can only fit one of them (such that they would overlap), they will not produce any shadows. However, there is an unstable workaround, where by enabling `light_rt`s one by one they have a chance to keep their shadows – when trying to fit a single shadow into the atlas, the engine will downscale it to the next biggest available space. ### "My dynamic shadows are blurry"