tiny.sdfii.backend

1const std = @import("std");2const sdfii_backend = @import("sdfii_backend");3const types = @import("sdfii_ffi").types;45pub const Capabilities = sdfii_backend.capabilities;6pub const CapabilityReport = sdfii_backend.router.CapabilityReport;7pub const Contract = sdfii_backend.contract;8pub const ExecutorError = sdfii_backend.ExecutorError;9pub const RenderStyle = sdfii_backend.executor.RenderStyle;10pub const UpscalePolicy = sdfii_backend.executor.UpscalePolicy;11pub const PaletteQuantization = sdfii_backend.executor.PaletteQuantization;12pub const DitherMode = sdfii_backend.executor.DitherMode;13pub const OutlineMode = sdfii_backend.executor.OutlineMode;14pub const CameraSnapPolicy = sdfii_backend.executor.CameraSnapPolicy;15pub const AlphaMode = sdfii_backend.executor.AlphaMode;16pub const RenderGraph = sdfii_backend.render_graph;17pub const Retention = sdfii_backend.retention;18pub const CpuRenderGraph = sdfii_backend.cpu_render_graph;19pub const AccyPath = sdfii_backend.accy_path;20pub const frame_pixel_hit_flag = sdfii_backend.executor.frame_pixel_hit_flag;21pub const frame_pixel_outline_flag = sdfii_backend.executor.frame_pixel_outline_flag;22pub const UploadPlanner = sdfii_backend.upload;23pub const ZigCpuExecutor = sdfii_backend.zig_cpu;24pub const AccyExecutor = sdfii_backend.accy.Executor;25pub const Router = sdfii_backend.router;26pub const ExecutorKind = sdfii_backend.ExecutorKind;2728test "backend executor contract is surfaced through facade" {29    const failure = Contract.diagnoseFailure(30        .render,31        .accy,32        error.RenderFailed,33        .zig_cpu,34    );35    try std.testing.expectEqual(Contract.FailureKind.render_failed, failure.kind);36    try std.testing.expectEqual(Contract.FallbackPolicy.retry_backend, failure.fallback_policy);37    try std.testing.expectEqual(ExecutorError, @TypeOf(failure.err));3839    var router = Router.initWithAllocator(std.testing.allocator);40    defer router.deinit();41    const report = router.capabilityReport();42    try std.testing.expect(report.zig_cpu.available);43    try std.testing.expectEqual(types.BackendKind.accy, AccyPath.selectedBackend());44    const live = router.liveAvailability();45    try std.testing.expectEqual(@as(u8, 1), live.zig_cpu_available);46    try std.testing.expectEqual(types.flagFromBool(report.accy.available), live.accy_available);47}4849test "accy backend serves render and field queries when available" {50    const summary = types.CompiledArtifactSummary{51        .compiled_revision = 9,52        .node_count = 4,53        .execution_ir_version = 3,54        .supports_graphics_output = 1,55        .supports_field_queries = 1,56    };57    const availability = types.BackendAvailability{58        .zig_cpu_available = 1,59        .accy_available = 1,60        .prefer_accy_before_zig = 1,61    };6263    const plan = Router.renderPlan(.{64        .summary = summary,65        .availability = availability,66        .graphics_requested = 1,67    });68    try std.testing.expectEqual(@backingInt(types.BackendKind.accy), plan.selected_backend);69    try std.testing.expectEqual(@backingInt(types.RenderRoute.graphics_fast_path), plan.route);7071    const field_query = Router.chooseFieldQueryRoute(.{72        .summary = summary,73        .availability = availability,74        .backend = plan.selected_backend,75    });76    try std.testing.expectEqual(@backingInt(types.BackendKind.accy), field_query.query_backend);77    try std.testing.expectEqual(@backingInt(types.FieldQueryRouteReason.native_distance_sampling), field_query.reason);7879    const without_accelerator = Router.chooseFieldQueryRoute(.{80        .summary = summary,81        .availability = .{ .zig_cpu_available = 1 },82        .backend = @backingInt(types.BackendKind.zig_cpu),83    });84    try std.testing.expectEqual(@backingInt(types.BackendKind.zig_cpu), without_accelerator.query_backend);85    try std.testing.expectEqual(@backingInt(types.FieldQueryRouteReason.native_distance_sampling), without_accelerator.reason);86}8788test "backend render graph validates resources and executes in dependency order" {89    var setup = RenderGraph.Setup.init(std.testing.allocator);90    defer setup.deinit();9192    const scene = try setup.declareResource(.{93        .name = "scene",94        .kind = .scene_artifact,95        .scope = .external,96    });97    const surface = try setup.declareResource(.{98        .name = "surface",99        .kind = .render_artifact,100    });101    const frame = try setup.declareResource(.{102        .name = "frame",103        .kind = .frame_output,104        .scope = .output,105    });106107    const raymarch = try setup.addPass("raymarch");108    try setup.reads(raymarch, scene);109    try setup.writes(raymarch, surface);110    const submit = try setup.addPass("submit");111    try setup.reads(submit, surface);112    try setup.writes(submit, frame);113114    var graph = try setup.finish();115    defer graph.deinit();116    try std.testing.expectEqual(raymarch, graph.order[0]);117    try std.testing.expectEqual(submit, graph.order[1]);118    try std.testing.expectEqual(raymarch, (try graph.resource(surface)).producer.?);119120    const Recorder = struct {121        names: [2][]const u8 = .{ "", "" },122        count: usize = 0,123124        fn record(context: ?*anyopaque, execution: RenderGraph.PassExecution) !void {125            const self: *@This() = @ptrCast(@alignCast(context.?));126            self.names[self.count] = try execution.name();127            self.count += 1;128            for (execution.accesses) |access| {129                _ = try execution.resolve(access.resource);130            }131        }132    };133    var recorder = Recorder{};134    try graph.execute(&recorder, Recorder.record);135    try std.testing.expectEqualStrings("raymarch", recorder.names[0]);136    try std.testing.expectEqualStrings("submit", recorder.names[1]);137138    var missing = RenderGraph.Setup.init(std.testing.allocator);139    defer missing.deinit();140    const orphan = try missing.declareResource(.{ .name = "orphan", .kind = .render_artifact });141    const reader = try missing.addPass("reader");142    try missing.reads(reader, orphan);143    try std.testing.expectError(error.MissingResourceProducer, missing.finish());144}

1pub const backend = engine.backend;