Blender V5.3
eevee_test_shadow.bsl.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2023 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
7#include "eevee_shadow.bsl.hh"
8
11
12void set_clipmap_data(LightData &light,
13 int clipmap_lod_min,
14 int clipmap_lod_max,
15 float clipmap_origin_x,
16 float clipmap_origin_y)
17{
18 LightSunData sun_data = light.sun;
19 sun_data.clipmap_origin = float2(clipmap_origin_x, clipmap_origin_y);
20 sun_data.clipmap_lod_min = clipmap_lod_min;
21 sun_data.clipmap_lod_max = clipmap_lod_max;
22 light.sun = sun_data;
23}
24
25void set_clipmap_base_offset(LightData &light, int2 clipmap_base_offset)
26{
27 LightSunData sun_data = light.sun;
28 sun_data.clipmap_base_offset_pos = clipmap_base_offset;
29 sun_data.clipmap_base_offset_neg = int2(0);
30 light.sun = sun_data;
31}
32
33[[compute, local_size(1)]]
34void eevee_test_shadows([[resource_table]] [[maybe_unused]] const ShaderTestOutput &srt)
35{
36 TEST(eevee_shadow, DirectionalMemberSet)
37 {
38 LightData light;
39 set_clipmap_data(light, 1, 2, 3.0f, 4.0f);
40 set_clipmap_base_offset(light, int2(5, 6));
41
42 EXPECT_EQ(light.sun.clipmap_lod_min, 1);
43 EXPECT_EQ(light.sun.clipmap_lod_max, 2);
44 EXPECT_EQ(light.sun.clipmap_origin, float2(3.0f, 4.0f));
45 EXPECT_EQ(light.sun.clipmap_base_offset_pos, int2(5, 6));
46 }
47
48 TEST(eevee_shadow, DirectionalClipmapLevel)
49 {
50 LightData light;
51 light.type = LIGHT_SUN;
52 set_clipmap_data(light, -5, 8, 0.0f, 0.0f);
53 light.lod_bias = 0.0f;
54 float fac = float(SHADOW_TILEMAP_RES - 1) / float(SHADOW_TILEMAP_RES);
55 EXPECT_EQ(shadow_directional_level(light, float3(fac * 0.0f)), light.sun.clipmap_lod_min);
56 EXPECT_EQ(shadow_directional_level(light, float3(fac * 0.49f)), 1);
57 EXPECT_EQ(shadow_directional_level(light, float3(fac * 0.5f)), 1);
58 EXPECT_EQ(shadow_directional_level(light, float3(fac * 0.51f)), 1);
59 EXPECT_EQ(shadow_directional_level(light, float3(fac * 0.99f)), 2);
60 EXPECT_EQ(shadow_directional_level(light, float3(fac * 1.0f)), 2);
61 EXPECT_EQ(shadow_directional_level(light, float3(fac * 1.01f)), 2);
62 EXPECT_EQ(shadow_directional_level(light, float3(fac * 12.5f)), 6);
63 EXPECT_EQ(shadow_directional_level(light, float3(fac * 12.51f)), 6);
64 EXPECT_EQ(shadow_directional_level(light, float3(fac * 15.9999f)), 6);
65 EXPECT_EQ(shadow_directional_level(light, float3(fac * 16.0f)), 6);
66 EXPECT_EQ(shadow_directional_level(light, float3(fac * 16.00001f)), 6);
67 EXPECT_EQ(shadow_directional_level(light, float3(fac * 5000.0f)), light.sun.clipmap_lod_max);
68 /* Produces NaN / Inf, Undefined behavior. */
69 // EXPECT_EQ(shadow_directional_level(light, float3(FLT_MAX)),
70 // light.sun.clipmap_lod_max);
71 }
72
73 TEST(eevee_shadow, DirectionalCascadeLevel)
74 {
75 LightData light;
76 light.type = LIGHT_SUN_ORTHO;
77 set_clipmap_data(light, 2, 8, 0.0f, 0.0f);
78 float half_size = exp2(float(light.sun.clipmap_lod_min - 1));
79 light.lod_bias = light.sun.clipmap_lod_min - 1;
80 float fac = float(SHADOW_TILEMAP_RES - 1) / float(SHADOW_TILEMAP_RES);
81 EXPECT_EQ(shadow_directional_level(light, float3(fac * half_size * 0.0f, 0.0f, 0.0f)), 2);
82 EXPECT_EQ(shadow_directional_level(light, float3(fac * half_size * 0.5f, 0.0f, 0.0f)), 2);
83 EXPECT_EQ(shadow_directional_level(light, float3(fac * half_size * 1.0f, 0.0f, 0.0f)), 3);
84 EXPECT_EQ(shadow_directional_level(light, float3(fac * half_size * 1.5f, 0.0f, 0.0f)), 3);
85 EXPECT_EQ(shadow_directional_level(light, float3(fac * half_size * 2.0f, 0.0f, 0.0f)), 4);
86 EXPECT_EQ(shadow_directional_level(light, float3(fac * 5000.0f)), light.sun.clipmap_lod_max);
87 /* Produces NaN / Inf, Undefined behavior. */
88 // EXPECT_EQ(shadow_directional_level(light, float3(FLT_MAX)),
89 // light.sun.clipmap_lod_max);
90 }
91
92 TEST(eevee_shadow, DirectionalClipmapCoordinates)
93 {
94 ShadowCoordinates coords;
95 float3 lP, camera_lP;
96
97 LightData light;
98 light.type = LIGHT_SUN;
99 // clipmap_lod_min = 0; /* Range [-0.5f..0.5f]. */
100 // clipmap_lod_max = 2; /* Range [-2..2]. */
101 set_clipmap_data(light, 0, 2, 0.0f, 0.0f);
102
103 light.tilemap_index = light.sun.clipmap_lod_min;
104 light.object_to_world.x = float4(1.0f, 0.0f, 0.0f, 0.0f);
105 light.object_to_world.y = float4(0.0f, 1.0f, 0.0f, 0.0f);
106 light.object_to_world.z = float4(0.0f, 0.0f, 1.0f, 0.0f);
107 light.lod_bias = 0;
108
109 float lod_min_tile_size = exp2(float(light.sun.clipmap_lod_min)) / float(SHADOW_TILEMAP_RES);
110 float lod_max_half_size = exp2(float(light.sun.clipmap_lod_max)) / 2.0f;
111
112 camera_lP = float3(0.0f, 0.0f, 0.0f);
113 /* Follows ShadowDirectional::end_sync(). */
114 set_clipmap_base_offset(light, int2(round(camera_lP.xy / lod_min_tile_size)));
115 EXPECT_EQ(light.sun.clipmap_base_offset_pos, int2(0));
116
117 /* Test UVs and tile mapping. */
118
119 lP = float3(1e-5f, 1e-5f, 0.0f);
120 coords = shadow_directional_coordinates(light, lP);
121 EXPECT_EQ(coords.tilemap_index, 0);
122 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2));
123 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 2), 1e-3f);
124
125 lP = float3(-1e-5f, -1e-5f, 0.0f);
126 coords = shadow_directional_coordinates(light, lP);
127 EXPECT_EQ(coords.tilemap_index, 0);
128 EXPECT_EQ(coords.tilemap_tile, uint2((SHADOW_TILEMAP_RES / 2) - 1));
129 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 2), 1e-3f);
130
131 lP = float3(-0.5f, -0.5f, 0.0f); /* Min of first LOD. */
132 coords = shadow_directional_coordinates(light, lP);
133 EXPECT_EQ(coords.tilemap_index, 0);
134 EXPECT_EQ(coords.tilemap_tile, uint2(0));
135 // EXPECT_NEAR(coords.uv, float2(0), 1e-3f);
136
137 lP = float3(0.5f, 0.5f, 0.0f); /* Max of first LOD. */
138 coords = shadow_directional_coordinates(light, lP);
139 EXPECT_EQ(coords.tilemap_index, 0);
140 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES - 1));
141 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES), 1e-3f);
142
143 /* Test clip-map level selection. */
144
145 camera_lP = float3(2.0f, 2.0f, 0.0f);
146 /* Follows ShadowDirectional::end_sync(). */
147 set_clipmap_base_offset(light, int2(round(camera_lP.xy / lod_min_tile_size)));
148 EXPECT_EQ(light.sun.clipmap_base_offset_pos, int2(32));
149
150 lP = float3(2.00001f, 2.00001f, 0.0f);
151 coords = shadow_directional_coordinates(light, lP);
152 EXPECT_EQ(coords.tilemap_index, 0);
153 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2));
154 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 2), 1e-3f);
155
156 lP = float3(1.50001f, 1.50001f, 0.0f);
157 coords = shadow_directional_coordinates(light, lP);
158 EXPECT_EQ(coords.tilemap_index, 1);
159 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 4));
160 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 4), 1e-3f);
161
162 lP = float3(1.00001f, 1.00001f, 0.0f);
163 coords = shadow_directional_coordinates(light, lP);
164 EXPECT_EQ(coords.tilemap_index, 2);
165 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 4));
166 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 4), 1e-3f);
167
168 lP = float3(-0.0001f, -0.0001f, 0.0f); /* Out of bounds. */
169 coords = shadow_directional_coordinates(light, lP);
170 EXPECT_EQ(coords.tilemap_index, 2);
171 EXPECT_EQ(coords.tilemap_tile, uint2(0));
172 // EXPECT_NEAR(coords.uv, float2(0), 1e-3f);
173
174 /* Test clip-map offset. */
175
176 set_clipmap_base_offset(light, int2(31, 1));
177 lP = float3(2.0001f, 0.0001f, 0.0f);
178
179 coords = shadow_directional_coordinates(light, lP);
180 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2) + uint2(1, -1));
181
182 coords = shadow_directional_coordinates(light, lP);
183 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2) + uint2(1, 0));
184
185 coords = shadow_directional_coordinates(light, lP);
186 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2) + uint2(1, 0));
187
188 coords = shadow_directional_coordinates(light, lP);
189 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2) + uint2(1, 0));
190
191 /* Test clip-map negative offsets. */
192
193 set_clipmap_base_offset(light, int2(-31, -1));
194 lP = float3(-2.0001f, -0.0001f, 0.0f);
195
196 coords = shadow_directional_coordinates(light, lP);
197 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2 - 1) + uint2(-1, 1));
198
199 coords = shadow_directional_coordinates(light, lP);
200 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2 - 1) + uint2(-1, 0));
201
202 coords = shadow_directional_coordinates(light, lP);
203 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2 - 1) + uint2(-1, 0));
204
205 coords = shadow_directional_coordinates(light, lP);
206 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2 - 1) + uint2(-1, 0));
207 }
208
209 TEST(eevee_shadow, DirectionalCascadeCoordinates)
210 {
211 ShadowCoordinates coords;
212 float3 lP, camera_lP;
213
214 LightData light;
215 light.type = LIGHT_SUN_ORTHO;
216 // clipmap_lod_min = 0; /* Range [-0.5f..0.5f]. */
217 // clipmap_lod_max = 2; /* 3 tile-maps. */
218 set_clipmap_data(light, 0, 2, 0.0f, 0.0f);
219 light.tilemap_index = 1;
220 light.object_to_world.x = float4(1.0f, 0.0f, 0.0f, 0.0f);
221 light.object_to_world.y = float4(0.0f, 1.0f, 0.0f, 0.0f);
222 light.object_to_world.z = float4(0.0f, 0.0f, 1.0f, 0.0f);
223 light.lod_bias = light.sun.clipmap_lod_min - 1;
224 float lod_tile_size = exp2(float(light.sun.clipmap_lod_min)) / float(SHADOW_TILEMAP_RES);
225 float lod_half_size = exp2(float(light.sun.clipmap_lod_min)) / 2.0f;
226 float narrowing = float(SHADOW_TILEMAP_RES - 1) / float(SHADOW_TILEMAP_RES);
227
228 camera_lP = float3(0.0f, 0.0f, 0.0f);
229 int level_range_size = light.sun.clipmap_lod_max - light.sun.clipmap_lod_min + 1;
230 float2 farthest_tilemap_center = float2(lod_half_size * float(level_range_size - 1), 0.0f);
232 light, floatBitsToInt(float2(lod_half_size / float(level_range_size - 1), 0.0f)));
233
234 /* Test UVs and tile mapping. */
235
236 lP = float3(1e-8f, 1e-8f, 0.0f);
237 coords = shadow_directional_coordinates(light, lP);
238 EXPECT_EQ(coords.tilemap_index, 1);
239 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES / 2));
240 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 2), 1e-3f);
241
242 lP = float3(lod_half_size * narrowing - 1e-5f, 1e-8f, 0.0f);
243 coords = shadow_directional_coordinates(light, lP);
244 EXPECT_EQ(coords.tilemap_index, 1);
245 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES - 1, SHADOW_TILEMAP_RES / 2));
246 // EXPECT_NEAR(coords.uv, float2(float(SHADOW_TILEMAP_RES) - 0.5f, SHADOW_TILEMAP_RES / 2),
247 // 1e-3f);
248
249 lP = float3(lod_half_size + 1e-5f, 1e-5f, 0.0f);
250 coords = shadow_directional_coordinates(light, lP);
251 EXPECT_EQ(coords.tilemap_index, 2);
252 EXPECT_EQ(coords.tilemap_tile, uint2(SHADOW_TILEMAP_RES - 1, SHADOW_TILEMAP_RES / 2));
253 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES, SHADOW_TILEMAP_RES / 2), 1e-3f);
254
255 // lP = float3(-0.5f, -0.5f, 0.0f); /* Min of first LOD. */
256 // coords = shadow_directional_coordinates(light, lP);
257 // EXPECT_EQ(coords.tilemap_index, 0);
258 // EXPECT_EQ(coords.tilemap_tile, uvec2(0));
259 // EXPECT_NEAR(coords.uv, float2(0), 1e-3f);
260
261 // lP = float3(0.5f, 0.5f, 0.0f); /* Max of first LOD. */
262 // coords = shadow_directional_coordinates(light, lP);
263 // EXPECT_EQ(coords.tilemap_index, 0);
264 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES - 1));
265 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES), 1e-3f);
266
267 /* Test clip-map level selection. */
268
269 // camera_lP = float3(2.0f, 2.0f, 0.0f);
270 /* Follows ShadowDirectional::end_sync(). */
271 // set_clipmap_base_offset(light, ivec2(round(camera_lP.xy / lod_min_tile_size)));
272 // EXPECT_EQ(light.sun.clipmap_base_offset_pos, ivec2(32));
273
274 // lP = float3(2.00001f, 2.00001f, 0.0f);
275 // coords = shadow_directional_coordinates(light, lP);
276 // EXPECT_EQ(coords.tilemap_index, 0);
277 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2));
278 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 2), 1e-3f);
279
280 // lP = float3(1.50001f, 1.50001f, 0.0f);
281 // coords = shadow_directional_coordinates(light, lP);
282 // EXPECT_EQ(coords.tilemap_index, 1);
283 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 4));
284 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 4), 1e-3f);
285
286 // lP = float3(1.00001f, 1.00001f, 0.0f);
287 // coords = shadow_directional_coordinates(light, lP);
288 // EXPECT_EQ(coords.tilemap_index, 2);
289 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 4));
290 // EXPECT_NEAR(coords.uv, float2(SHADOW_TILEMAP_RES / 4), 1e-3f);
291
292 // lP = float3(-0.0001f, -0.0001f, 0.0f); /* Out of bounds. */
293 // coords = shadow_directional_coordinates(light, lP);
294 // EXPECT_EQ(coords.tilemap_index, 2);
295 // EXPECT_EQ(coords.tilemap_tile, uvec2(0));
296 // EXPECT_NEAR(coords.uv, float2(0), 1e-3f);
297
298 /* Test clip-map offset. */
299
300 // set_clipmap_base_offset(light, ivec2(31, 1));
301 // lP = float3(2.0001f, 0.0001f, 0.0f);
302
303 // coords = shadow_directional_coordinates(light, lP);
304 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2) + uvec2(1, -1));
305
306 // coords = shadow_directional_coordinates(light, lP);
307 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2) + uvec2(1, 0));
308
309 // coords = shadow_directional_coordinates(light, lP);
310 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2) + uvec2(1, 0));
311
312 // coords = shadow_directional_coordinates(light, lP);
313 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2) + uvec2(1, 0));
314
315 /* Test clip-map negative offsets. */
316
317 // set_clipmap_base_offset(light, ivec2(-31, -1));
318 // lP = float3(-2.0001f, -0.0001f, 0.0f);
319
320 // coords = shadow_directional_coordinates(light, lP);
321 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2 - 1) + uvec2(-1, 1));
322
323 // coords = shadow_directional_coordinates(light, lP);
324 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2 - 1) + uvec2(-1, 0));
325
326 // coords = shadow_directional_coordinates(light, lP);
327 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2 - 1) + uvec2(-1, 0));
328
329 // coords = shadow_directional_coordinates(light, lP);
330 // EXPECT_EQ(coords.tilemap_tile, uvec2(SHADOW_TILEMAP_RES / 2 - 1) + uvec2(-1, 0));
331 }
332}
ShadowCoordinates shadow_directional_coordinates(LightData light, float3 lP)
int shadow_directional_level(LightData light, float3 lP)
void eevee_test_shadows(const ShaderTestOutput &srt)
void set_clipmap_base_offset(LightData &light, int2 clipmap_base_offset)
void set_clipmap_data(LightData &light, int clipmap_lod_min, int clipmap_lod_max, float clipmap_origin_x, float clipmap_origin_y)
#define resource_table
#define compute
#define local_size(...)
VecBase< int, D > floatBitsToInt(VecOp< float, D >) RET
#define exp2
#define round
#define TEST(a, b)
#define EXPECT_EQ(result, expect)
@ LIGHT_SUN
KERNEL_FEATURE_LIGHT_PASSES KERNEL_FEATURE_PATH_GUIDING float