#include "frame.h" #include "lens_map.h" #include "optics.h" #include #include #include #include #include #include static int mesh_has_hanging_vertex(const FrameLensMesh *mesh) { for (size_t triangle = 0; triangle < mesh->triangle_count; ++triangle) for (size_t side = 0; side < 3; ++side) { const LensVertex *a = &mesh->vertices[mesh->triangles[triangle].vertex[side]]; const LensVertex *b = &mesh->vertices[mesh->triangles[triangle].vertex[(side + 1) % 3]]; const double dx = b->image_x - a->image_x; const double dy = b->image_y - a->image_y; const double length_squared = dx * dx + dy * dy; for (size_t vertex = 0; vertex < mesh->vertex_count; ++vertex) { if (vertex == mesh->triangles[triangle].vertex[side] || vertex == mesh->triangles[triangle].vertex[(side + 1) % 3]) continue; const LensVertex *p = &mesh->vertices[vertex]; const double px = p->image_x - a->image_x; const double py = p->image_y - a->image_y; const double cross = px * dy - py * dx; const double position = (px * dx + py * dy) / length_squared; if (fabs(cross) <= 1e-12 * length_squared && position > 1e-12 && position < 1.0 - 1e-12) return 1; } } return 0; } static int mesh_has_same_winding_shared_edge(const FrameLensMesh *mesh) { for (size_t left_triangle = 0; left_triangle < mesh->triangle_count; ++left_triangle) for (size_t left_side = 0; left_side < 3; ++left_side) { const size_t from = mesh->triangles[left_triangle].vertex[left_side]; const size_t to = mesh->triangles[left_triangle].vertex[(left_side + 1) % 3]; for (size_t right_triangle = left_triangle + 1; right_triangle < mesh->triangle_count; ++right_triangle) for (size_t right_side = 0; right_side < 3; ++right_side) { const size_t other_from = mesh->triangles[right_triangle].vertex[right_side]; const size_t other_to = mesh->triangles[right_triangle].vertex[(right_side + 1) % 3]; if ((from == other_from && to == other_to) || (from == other_to && to == other_from)) { if (from == other_from && to == other_to) return 1; } } } return 0; } static int review_probe_regressions(void) { RefinementConfig c = {.max_level=2, .min_edge_pixels=.5, .min_area_pixels2=.25, .angle_absolute_rad=3.14, .angle_relative=1e6, .retry_step_increment=10, .max_total_steps=100}; RayEndpoint flat = {.outcome=RAY_OUTCOME_ESCAPED, .frequency_ratio=1, .n_infinity={1,0,0}, .end_id=0}; for (int unresolved=0; unresolved<2; ++unresolved) { FrameLensMesh m={0}; if (frame_lens_mesh_build_coarse(&m,100,100,100,30)) return -1; for (size_t i=0;i 1e-12 * fmax(1.0, fabs(serial_hdr[value]))) { fputs("parallel catalog splat regression failed\n", stderr); free(serial_hdr); free(parallel_hdr); goto done; } free(serial_hdr); free(parallel_hdr); if (serial_images != 1 || parallel_images != serial_images) { fputs("parallel catalog image-count regression failed\n", stderr); goto done; } const LinearRgb cool = blackbody_to_linear_rgb(3000.0); const LinearRgb hot = blackbody_to_linear_rgb(10000.0); if (!(cool.r > cool.b && hot.b > hot.r && hot.r + hot.g + hot.b > cool.r + cool.g + cool.b)) { fputs("blackbody spectral-color regression failed\n", stderr); goto done; } /* The Moffat is flux-normalized and retains a measurable, continuous wing * beyond the former Gaussian's 3-sigma raster box. */ memset(hdr, 0, (size_t)width * height * 3 * sizeof *hdr); splat_moffat(hdr, width, height, 50.5, 50.5, (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, psf_relative_tail, 0.0); double moffat_flux = 0.0; for (int pixel = 0; pixel < width * height; ++pixel) moffat_flux += hdr[3 * pixel]; if (fabs(moffat_flux - 1.0) > 0.01 || hdr[3 * (50 * width + 62)] <= 0.0) { fputs("Moffat normalization or wing regression failed\n", stderr); goto done; } /* The cache stores 4-point pixel-area integrals over a 64x64 sub-pixel * lattice. Compare its bilinear interpolation with the independent 8-point * direct reference at phases on both sides of a pixel boundary. */ PsfKernelCache cache = {0}; double *cached_hdr = calloc((size_t)width * height * 3, sizeof *cached_hdr); double *reference_hdr = calloc((size_t)width * height * 3, sizeof *reference_hdr); if (cached_hdr == NULL || reference_hdr == NULL || psf_kernel_cache_init(&cache, &psf, psf_relative_tail)) { free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); fputs("PSF cache construction regression failed\n", stderr); goto done; } PsfKernelCache loose_tail_cache = {0}; if (psf_kernel_cache_init(&loose_tail_cache, &psf, 1e-5) || loose_tail_cache.relative_tail_fraction != 1e-5 || loose_tail_cache.radius_pixels >= cache.radius_pixels) { fputs("PSF relative-tail cache-radius regression failed\n", stderr); psf_kernel_cache_destroy(&loose_tail_cache); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } psf_kernel_cache_destroy(&loose_tail_cache); /* This is the exact eligibility split that a future event sink exposes to * HIP: cache event, CPU direct fallback, or min-Y discard. */ PsfCachedEvent prepared = {0}; if (psf_prepare_cached_event(&prepared, 12.25, 14.75, (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, &cache, 1.0, psf_relative_tail, 0.0) != 0 || prepared.x != 12.25 || prepared.y != 14.75 || !(prepared.support_radius > 0.0) || psf_prepare_cached_event(&prepared, 12.25, 14.75, (LinearRgb){1.0, 1.0, 1.0}, 1000.0, &psf, &cache, 1.0, psf_relative_tail, 0.0) != 1 || psf_prepare_cached_event(&prepared, 12.25, 14.75, (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, &cache, 1.0, psf_relative_tail, 1.0) != 3) { fputs("PSF event eligibility regression failed\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } const double phases[][2] = {{0.01, 0.99}, {0.499, 0.501}, {0.999, 0.001}}; for (size_t phase = 0; phase < sizeof phases / sizeof *phases; ++phase) { memset(cached_hdr, 0, (size_t)width * height * 3 * sizeof *cached_hdr); memset(reference_hdr, 0, (size_t)width * height * 3 * sizeof *reference_hdr); if (splat_moffat_cached(cached_hdr, width, height, 50.0 + phases[phase][0], 50.0 + phases[phase][1], (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, &cache, 1.0, psf_relative_tail, 0.0) != 0) { fputs("ordinary PSF cache unexpectedly fell back\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } splat_moffat_direct(reference_hdr, width, height, 50.0 + phases[phase][0], 50.0 + phases[phase][1], (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, psf_relative_tail, 0.0); double peak = 0.0, max_error = 0.0; for (int value = 0; value < width * height * 3; ++value) { peak = fmax(peak, reference_hdr[value]); max_error = fmax(max_error, fabs(cached_hdr[value] - reference_hdr[value])); } if (peak <= 0.0 || max_error > 4e-5 * peak) { fputs("PSF cache interpolation accuracy regression failed\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } } if (splat_moffat_cached(cached_hdr, width, height, 50.5, 50.5, (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, &cache, 1.0, psf_relative_tail, 1.0) != 3) { fputs("PSF minimum-Y cached discard regression failed\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } /* A bright event must avoid a cached hard cutoff by selecting the direct * reference path when the requested support exceeds the cache. */ if (splat_moffat_cached(cached_hdr, width, height, 50.5, 50.5, (LinearRgb){1.0, 1.0, 1.0}, 1000.0, &psf, &cache, 1.0, psf_relative_tail, 0.0) != 1) { fputs("bright PSF direct-fallback regression failed\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } memset(cached_hdr, 0, (size_t)width * height * 3 * sizeof *cached_hdr); memset(reference_hdr, 0, (size_t)width * height * 3 * sizeof *reference_hdr); if (splat_moffat_cached(cached_hdr, width, height, 50.5, 50.5, (LinearRgb){1.0, 1.0, 1.0}, 1000.0, &psf, &cache, 1000.0, psf_relative_tail, 0.0) != 2) { fputs("bright PSF cached-wing-clipping regression failed\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } splat_moffat_direct(reference_hdr, width, height, 50.5, 50.5, (LinearRgb){1.0, 1.0, 1.0}, 1000.0, &psf, psf_relative_tail, 0.0); const size_t center = 3 * (50 * width + 50); if (cached_hdr[center] <= 0.0 || fabs(cached_hdr[center] - reference_hdr[center]) > 4e-5 * reference_hdr[center]) { fputs("cached-wing clipping changed the bright PSF core\n", stderr); free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); goto done; } free(cached_hdr); free(reference_hdr); psf_kernel_cache_destroy(&cache); /* Fast mode: a nearest deposit must reproduce the current pixel-integrated * Moffat at the snapped supersampled centre, preserve total flux, and honour * the min-Y discard rule; bilinear deposition must preserve the centroid. */ { int fast_ok = 1; const int supersample = 2; FastPsfAccumulator fast = {0}; FastPsfAccumulator bilinear = {0}; FastPsfAccumulator min_y_fast = {0}; FastPsfAccumulator accumulation = {0}; double *fast_hdr = calloc((size_t)width * height * 3, sizeof *fast_hdr); double *direct_hdr = calloc((size_t)width * height * 3, sizeof *direct_hdr); double *background_hdr = calloc((size_t)width * height * 3, sizeof *background_hdr); if (fast_hdr == NULL || direct_hdr == NULL || background_hdr == NULL || fast_psf_accumulator_init(&fast, width, height, supersample, FAST_PSF_DEPOSIT_NEAREST, &psf, psf_relative_tail, 0.0, 1) || fast_psf_accumulator_init(&bilinear, width, height, supersample, FAST_PSF_DEPOSIT_BILINEAR, &psf, psf_relative_tail, 0.0, 1) || fast_psf_accumulator_init(&min_y_fast, width, height, supersample, FAST_PSF_DEPOSIT_NEAREST, &psf, psf_relative_tail, 0.5, 1) || fast_psf_accumulator_init(&accumulation, width, height, supersample, FAST_PSF_DEPOSIT_NEAREST, &psf, psf_relative_tail, 0.0, 1)) { fputs("fast-mode accumulator construction regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* (50.2, 50.2) snaps to supersampled cell 100, centre (100.5, 100.5) in * ss coordinates, i.e. final position (50.25, 50.25). */ if (fast_psf_accumulator_deposit(&fast, 50.2, 50.2, (LinearRgb){1.0, 1.0, 1.0}, 1.0) == 3 || fast_psf_accumulator_resolve(&fast, fast_hdr, 4)) { fputs("fast-mode nearest deposit regression failed\n", stderr); fast_ok = 0; goto fast_done; } splat_moffat_direct(direct_hdr, width, height, 50.25, 50.25, (LinearRgb){1.0, 1.0, 1.0}, 1.0, &psf, psf_relative_tail, 0.0); double peak = 0.0, max_error = 0.0, fast_flux = 0.0, direct_flux = 0.0; for (int value = 0; value < width * height * 3; ++value) { peak = fmax(peak, direct_hdr[value]); max_error = fmax(max_error, fabs(fast_hdr[value] - direct_hdr[value])); fast_flux += fast_hdr[value]; direct_flux += direct_hdr[value]; } if (!(peak > 0.0) || max_error > 1e-4 * peak || fabs(fast_flux - direct_flux) > 1e-4) { fputs("fast-mode nearest semantics regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* Bilinear keeps the exact continuous centroid. */ memset(fast_hdr, 0, (size_t)width * height * 3 * sizeof *fast_hdr); if (fast_psf_accumulator_deposit(&bilinear, 50.37, 50.62, (LinearRgb){1.0, 1.0, 1.0}, 1.0) == 3 || fast_psf_accumulator_resolve(&bilinear, fast_hdr, 4)) { fputs("fast-mode bilinear deposit regression failed\n", stderr); fast_ok = 0; goto fast_done; } double weight_sum = 0.0, cx = 0.0, cy = 0.0; for (int row = 0; row < height; ++row) for (int column = 0; column < width; ++column) { const double weight = fast_hdr[3 * (row * width + column)]; weight_sum += weight; cx += weight * (column + 0.5); cy += weight * (row + 0.5); } if (!(weight_sum > 0.0) || hypot(cx / weight_sum - 50.37, cy / weight_sum - 50.62) > 1e-6) { fputs("fast-mode bilinear centroid regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* The min-Y cutoff discards an event whose peak luminance is below it. */ if (fast_psf_accumulator_deposit(&fast, 10.5, 10.5, (LinearRgb){1.0, 1.0, 1.0}, 1.0) != 0 || fast_psf_accumulator_deposit(&min_y_fast, 10.5, 10.5, (LinearRgb){1.0, 1.0, 1.0}, 1.0) != 3) { fputs("fast-mode min-Y discard regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* End-to-end plumbing through the frame splat path. */ memset(fast_hdr, 0, (size_t)width * height * 3 * sizeof *fast_hdr); PsfSplatStats fast_stats = {0}; const size_t fast_images = frame_splat_catalog( &mesh, &catalog, fast_hdr, width, height, test_exposure, &psf, NULL, INFINITY, 1.0, psf_relative_tail, 0.0, 0, 1, FRAME_CATALOG_PREFETCH_FRAME, NULL, &fast_stats, NULL, &fast, NULL); if (fast_images != 1 || fast_stats.discarded_below_min_y != 0) { fputs("fast-mode frame splat regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* HDR accumulation semantics: resolve must add onto an existing * background, not overwrite it. A prefilled buffer plus one deposit must * preserve the far-field background exactly and add the PSF core. */ for (int value = 0; value < width * height * 3; ++value) background_hdr[value] = 0.25; if (fast_psf_accumulator_deposit(&accumulation, 10.5, 10.5, (LinearRgb){1.0, 1.0, 1.0}, 1.0) == 3 || fast_psf_accumulator_resolve(&accumulation, background_hdr, 4)) { fputs("fast-mode HDR accumulation regression failed\n", stderr); fast_ok = 0; goto fast_done; } /* (90, 90) is far outside the kernel support of a star at (10.5, 10.5). */ if (background_hdr[3 * (90 * width + 90)] != 0.25) { fputs("fast-mode HDR accumulation lost the background\n", stderr); fast_ok = 0; goto fast_done; } if (!(background_hdr[3 * (10 * width + 10)] > 0.25)) { fputs("fast-mode HDR accumulation did not add the deposit\n", stderr); fast_ok = 0; goto fast_done; } fast_done: free(fast_hdr); free(direct_hdr); free(background_hdr); fast_psf_accumulator_destroy(&fast); fast_psf_accumulator_destroy(&bilinear); fast_psf_accumulator_destroy(&min_y_fast); fast_psf_accumulator_destroy(&accumulation); if (!fast_ok) goto done; } frame_draw_mesh(&mesh, hdr, width, height, 0.5, 0.5); if (hdr[3 * (10 * width + 20)] != 0.25) { fputs("mesh diagnostic overlay regression failed\n", stderr); goto done; } /* A fixed absolute edge tolerance used to make tiny source triangles claim * sources far outside their field. */ FrameLensMesh fine_mesh = {0}; Star fine_stars[2] = {{.direction = {0.0, 0.0, -1.0}, .temperature_K = 7000.0, .amplitude = 1.0}, {.direction = {0.01, 0.0, -0.9999499987499375}, .temperature_K = 7000.0, .amplitude = 1.0}}; StarCatalog fine_catalog = {.stars = fine_stars, .count = 2}; memset(hdr, 0, (size_t)width * height * 3 * sizeof *hdr); if (frame_lens_mesh_build_coarse(&fine_mesh, width, height, 1, 0.1) || frame_lens_mesh_trace(&fine_mesh, &spacetime, &observer, &trace) || frame_splat_catalog(&fine_mesh, &fine_catalog, hdr, width, height, test_exposure, &psf, NULL, INFINITY, 1.0, psf_relative_tail, 0.0, 0, 1, FRAME_CATALOG_PREFETCH_FRAME, NULL, NULL, NULL, NULL, NULL) != 1) { fputs("fine source-triangle containment regression failed\n", stderr); frame_lens_mesh_destroy(&fine_mesh); goto done; } frame_lens_mesh_destroy(&fine_mesh); /* Schwarzschild level-4/J=0.2 ring triangle: the old edge tolerance accepts * (1,0,0) although it is outside, producing unsigned weights summing to * 1.09608. Keep a genuine interior source after it to check that rejecting * one source does not discard subsequent stars. Exercise both parities. */ const double thin_directions[3][3] = { {0.99999998891116071, 0.00013431364716360775, 6.4323579270168807e-05}, {0.99999997228355786, -0.00021216644782556991, -0.00010206998544149922}, {0.9999927016945267, -0.0034455730513416835, -0.001650631403158936}}; LensVertex thin_vertices[3] = { {.image_x = 40, .image_y = 40, .outcome = RAY_OUTCOME_ESCAPED}, {.image_x = 48, .image_y = 40, .outcome = RAY_OUTCOME_ESCAPED}, {.image_x = 40, .image_y = 48, .outcome = RAY_OUTCOME_ESCAPED}}; LensTriangle thin_triangle = {.vertex = {0, 1, 2}}; FrameLensMesh thin_mesh = {.vertices = thin_vertices, .vertex_count = 3, .triangles = &thin_triangle, .triangle_count = 1}; Star thin_stars[2] = { {.direction = {1, 0, 0}, .temperature_K = 7000, .amplitude = 1}, {.temperature_K = 7000, .amplitude = 1}}; for (int i = 0; i < 3; ++i) { memcpy(thin_vertices[i].n_infinity, thin_directions[i], sizeof thin_directions[i]); memcpy(thin_vertices[i].camera_direction, thin_directions[i], sizeof thin_directions[i]); for (int axis = 0; axis < 3; ++axis) thin_stars[1].direction[axis] += thin_directions[i][axis]; } const double thin_norm = hypot(hypot(thin_stars[1].direction[0], thin_stars[1].direction[1]), thin_stars[1].direction[2]); for (int axis = 0; axis < 3; ++axis) thin_stars[1].direction[axis] /= thin_norm; StarCatalog thin_catalog = {.stars = thin_stars, .count = 2}; for (int parity = 0; parity < 2; ++parity) { thin_triangle.vertex[1] = parity ? 2 : 1; thin_triangle.vertex[2] = parity ? 1 : 2; memset(hdr, 0, (size_t)width * height * 3 * sizeof *hdr); if (frame_splat_catalog(&thin_mesh, &thin_catalog, hdr, width, height, test_exposure, &psf, NULL, 1.0, 1.0, psf_relative_tail, 0.0, 0, 1, FRAME_CATALOG_PREFETCH_FRAME, NULL, NULL, NULL, NULL, NULL) != 1 || hdr[3 * (43 * width + 43)] <= 0.0) { fputs("thin source-triangle inverse-map regression failed\n", stderr); goto done; } } /* Refinement probes are temporary until their generation is complete. A * shared diagonal probe must produce one stable midpoint and conforming * children only after its endpoint has been installed. */ FrameLensMesh adaptive_mesh = {0}; RefinementConfig refine = {.max_level = 1, .angle_absolute_rad = 1e-4, .angle_relative = 1e-4, .jacobian_minimum = 1e-3, .min_edge_pixels = 1.0, .min_area_pixels2 = 1.0}; if (frame_lens_mesh_build_coarse(&adaptive_mesh, width, height, 100, 30.0)) goto done; for (size_t i = 0; i < adaptive_mesh.vertex_count; ++i) { adaptive_mesh.vertices[i].traced = 1; adaptive_mesh.vertices[i].outcome = RAY_OUTCOME_ESCAPED; adaptive_mesh.vertices[i].n_infinity[0] = 1.0; } if (frame_lens_mesh_prepare_generation(&adaptive_mesh, &refine) != 1) { fputs("adaptive shared-edge probe setup regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } const RayEndpoint bent_probe = {.n_infinity = {0.0, 1.0, 0.0}, .frequency_ratio = 1.0, .outcome = RAY_OUTCOME_ESCAPED}; if (frame_lens_mesh_install_sample(&adaptive_mesh, 0, &bent_probe) || frame_lens_mesh_finish_generation(&adaptive_mesh, &refine) != 1 || adaptive_mesh.vertex_count != 5 || adaptive_mesh.triangle_count != 4) { fputs("adaptive shared-edge split regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } frame_lens_mesh_destroy(&adaptive_mesh); /* A capture/escape discontinuity is a shadow boundary, not a smooth map * error: request all three midpoint rays and red-refine in one generation. */ if (frame_lens_mesh_build_coarse(&adaptive_mesh, width, height, 100, 30.0)) goto done; adaptive_mesh.triangle_count = 1; for (size_t i = 0; i < adaptive_mesh.vertex_count; ++i) { adaptive_mesh.vertices[i].traced = 1; adaptive_mesh.vertices[i].outcome = RAY_OUTCOME_ESCAPED; adaptive_mesh.vertices[i].n_infinity[0] = 1.0; } adaptive_mesh.vertices[0].outcome = RAY_OUTCOME_DARK; refine.max_level = 1; refine.angle_absolute_rad = 3.14159265358979323846; refine.angle_relative = 1e6; refine.jacobian_minimum = 1e-12; if (frame_lens_mesh_prepare_generation(&adaptive_mesh, &refine) != 3) { fputs("shadow-boundary red-probe setup regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } for (size_t i = 0; i < adaptive_mesh.sample_count; ++i) if (frame_lens_mesh_install_sample(&adaptive_mesh, i, &bent_probe)) { fputs("shadow-boundary red-probe installation regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } if (frame_lens_mesh_finish_generation(&adaptive_mesh, &refine) != 3 || adaptive_mesh.vertex_count != 7 || adaptive_mesh.triangle_count != 4) { fputs("shadow-boundary red-refinement regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } frame_lens_mesh_destroy(&adaptive_mesh); /* Two shadow leaves can force two edges of an escaped neighbour. That * neighbour must use a local three-child blue split, not create a third * requested edge that spreads red refinement farther outward. */ if (frame_lens_mesh_build_coarse(&adaptive_mesh, 200, 100, 100, 30.0)) goto done; adaptive_mesh.triangle_count = 3; for (size_t i = 0; i < adaptive_mesh.vertex_count; ++i) { adaptive_mesh.vertices[i].traced = 1; adaptive_mesh.vertices[i].outcome = RAY_OUTCOME_ESCAPED; adaptive_mesh.vertices[i].n_infinity[0] = 1.0; } adaptive_mesh.vertices[3].outcome = RAY_OUTCOME_DARK; adaptive_mesh.vertices[5].outcome = RAY_OUTCOME_DARK; if (frame_lens_mesh_prepare_generation(&adaptive_mesh, &refine) != 6) { fputs("shadow-boundary blue-neighbour probe setup regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } for (size_t i = 0; i < adaptive_mesh.sample_count; ++i) if (frame_lens_mesh_install_sample(&adaptive_mesh, i, &bent_probe)) { fputs("shadow-boundary blue-neighbour probe installation regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } if (frame_lens_mesh_finish_generation(&adaptive_mesh, &refine) != 6 || adaptive_mesh.vertex_count != 12 || adaptive_mesh.triangle_count != 11 || mesh_has_hanging_vertex(&adaptive_mesh) || mesh_has_same_winding_shared_edge(&adaptive_mesh)) { fputs("shadow-boundary blue-neighbour refinement regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } frame_lens_mesh_destroy(&adaptive_mesh); const RayEndpoint flat_probe = {.n_infinity = {1.0, 0.0, 0.0}, .frequency_ratio = 1.0, .outcome = RAY_OUTCOME_ESCAPED}; /* Opposite nonzero discrete-Jacobian signs on the two sides of the shared * diagonal require a sufficiently small magnitude before requesting it. */ refine.jacobian_minimum = 10.0; refine.angle_absolute_rad = 3.14159265358979323846; refine.angle_relative = 1e6; if (frame_lens_mesh_build_coarse(&adaptive_mesh, width, height, 100, 30.0)) goto done; const double source_directions[4][3] = { {1.0, 0.0, 0.0}, {sqrt(0.99), 0.0, 0.1}, {sqrt(0.99), 0.0, 0.1}, {sqrt(0.98), 0.1, 0.1}}; for (size_t i = 0; i < adaptive_mesh.vertex_count; ++i) { adaptive_mesh.vertices[i].traced = 1; adaptive_mesh.vertices[i].outcome = RAY_OUTCOME_ESCAPED; memcpy(adaptive_mesh.vertices[i].n_infinity, source_directions[i], sizeof source_directions[i]); } if (frame_lens_mesh_prepare_generation(&adaptive_mesh, &refine) != 1 || frame_lens_mesh_install_sample(&adaptive_mesh, 0, &flat_probe) || frame_lens_mesh_finish_generation(&adaptive_mesh, &refine) != 1 || adaptive_mesh.vertex_count != 5 || adaptive_mesh.triangle_count != 4) { fputs("adaptive fold-parity split regression failed\n", stderr); frame_lens_mesh_destroy(&adaptive_mesh); goto done; } frame_lens_mesh_destroy(&adaptive_mesh); /* E/D/U accounting. A UUU triangle must request one merged retry per * unresolved vertex with the next budget increment, and must not be * blackened. */ { LensVertex uuu_vertices[3] = { {.image_x = 0, .image_y = 0, .outcome = RAY_OUTCOME_UNRESOLVED, .traced = 1, .continuation_t = -1.0, .continuation_steps = 5, .continuation_limit = 5}, {.image_x = 10, .image_y = 0, .outcome = RAY_OUTCOME_UNRESOLVED, .traced = 1, .continuation_t = -1.0, .continuation_steps = 5, .continuation_limit = 5}, {.image_x = 0, .image_y = 10, .outcome = RAY_OUTCOME_UNRESOLVED, .traced = 1, .continuation_t = -1.0, .continuation_steps = 5, .continuation_limit = 5}}; for (int i = 0; i < 3; ++i) uuu_vertices[i].camera_direction[0] = 1.0; LensTriangle uuu_triangle = {{0, 1, 2}, 0, 0, 0}; FrameLensMesh uuu_mesh = {.vertices = uuu_vertices, .vertex_count = 3, .triangles = &uuu_triangle, .triangle_count = 1}; RefinementConfig uuu_config = {.max_level = 1, .angle_absolute_rad = 1.0, .angle_relative = 1.0, .jacobian_minimum = 1e-3, .min_edge_pixels = 1.0, .min_area_pixels2 = 1.0, .retry_step_increment = 10, .max_total_steps = 25}; if (frame_lens_mesh_prepare_generation(&uuu_mesh, &uuu_config) != 3) { fputs("UUU forced-retry regression failed\n", stderr); free(uuu_mesh.samples); free(uuu_mesh.probe_slots); goto done; } for (size_t i = 0; i < uuu_mesh.sample_count; ++i) { if (uuu_mesh.samples[i].kind != FRAME_SAMPLE_RETRY || uuu_mesh.samples[i].step_limit != 15) { fputs("UUU retry shape regression failed\n", stderr); free(uuu_mesh.samples); free(uuu_mesh.probe_slots); goto done; } } free(uuu_mesh.samples); free(uuu_mesh.probe_slots); } /* UUD/UDD is red-refined while the geometry can still support children. * At the geometric stop scale it becomes an approximate-black boundary * triangle while its shared U vertex keeps its unresolved outcome. */ { LensVertex ud_vertices[3] = { {.image_x = 0, .image_y = 0, .outcome = RAY_OUTCOME_UNRESOLVED, .traced = 1, .continuation_limit = 5}, {.image_x = 10, .image_y = 0, .outcome = RAY_OUTCOME_UNRESOLVED, .traced = 1, .continuation_limit = 5}, {.image_x = 0, .image_y = 10, .outcome = RAY_OUTCOME_DARK, .traced = 1}}; for (int i = 0; i < 3; ++i) ud_vertices[i].camera_direction[0] = 1.0; LensTriangle ud_triangle = {{0, 1, 2}, 0, 0, 0}; FrameLensMesh ud_mesh = {.vertices = ud_vertices, .vertex_count = 3, .triangles = &ud_triangle, .triangle_count = 1}; RefinementConfig red_config = {.max_level = 1, .angle_absolute_rad = 1.0, .angle_relative = 1.0, .jacobian_minimum = 1e-3, .min_edge_pixels = 0.5, .min_area_pixels2 = 0.5, .retry_step_increment = 10, .max_total_steps = 25}; if (frame_lens_mesh_prepare_generation(&ud_mesh, &red_config) != 3) { fputs("UUD red-refinement probe regression failed\n", stderr); free(ud_mesh.probe_slots); goto done; } for (size_t i = 0; i < ud_mesh.sample_count; ++i) if (ud_mesh.samples[i].kind != FRAME_SAMPLE_PROBE) { fputs("UUD red-refinement sample-kind regression failed\n", stderr); free(ud_mesh.probe_slots); goto done; } free(ud_mesh.samples); free(ud_mesh.probe_slots); ud_mesh.samples = NULL; ud_mesh.sample_count = ud_mesh.sample_capacity = 0; ud_mesh.probe_slots = NULL; ud_mesh.probe_slot_capacity = 0; RefinementConfig stop_config = red_config; stop_config.min_edge_pixels = 1e6; stop_config.min_area_pixels2 = 1e6; if (frame_lens_mesh_prepare_generation(&ud_mesh, &stop_config) != 0) { fputs("UUD stop-scale retry regression failed\n", stderr); free(ud_mesh.probe_slots); goto done; } FrameBoundaryStats ud_stats; frame_lens_mesh_boundary_stats(&ud_mesh, &stop_config, &ud_stats); if (ud_stats.uud_udd != 1 || ud_stats.approx_black_triangles != 1 || ud_stats.approx_black_area_pixels2 <= 0.0 || ud_stats.escaped_only != 0 || !ud_triangle.approx_black || ud_vertices[0].outcome != RAY_OUTCOME_UNRESOLVED) { fputs("UUD approximate-black regression failed\n", stderr); free(ud_mesh.probe_slots); goto done; } stop_config = red_config; stop_config.max_level = 0; frame_lens_mesh_boundary_stats(&ud_mesh, &stop_config, &ud_stats); if (ud_stats.approx_black_triangles != 1 || ud_stats.approx_black_level_stops != 1 || ud_stats.approx_black_max_edge_pixels < 10 || ud_stats.approx_black_area_pixels2 != 50) { fputs("max-level approximate-black provenance regression failed\n",stderr); goto done; } free(ud_mesh.probe_slots); } result = 0; done: frame_lens_mesh_destroy(&mesh); spacetime_destroy(&spacetime); blackbody_backend_destroy(); free(hdr); return result; }