ludus::graphics::renderer::GpuPreviewOptions¶

Struct

Optional progressive GPU path-tracing settings. No CPU transport or readback fallback. Static RGB reflection/emission uses RT1's admitted surface profile; this is a progressive, finite-depth reference mode using native ray queries, without denoising. Use RasterViewport for ordinary interactive World navigation; this mode freezes scene/camera input, and requires native hardware ray support, compute and retained reference inputs. Native-query artifacts require native ray support. Triangle graph kernels may instead supply the software compute ABI, which needs ordinary compute and retained scene inputs but creates no acceleration structures. Unsupported devices/APIs return Unsupported; no CPU transport fallback is selected.

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp

#include <ludus/graphics/renderer/gpu_preview.hpp>

struct ludus::graphics::renderer::GpuPreviewOptions final

Fields¶

CpuByteBudget¶

ludus::foundation::usize ludus::graphics::renderer::GpuPreviewOptions::CpuByteBudget = 0

Setup/retained geometry budget, including BVH construction and packing/upload scratch. Positive. Excludes RHI-retained input texels/registries and driver staging.

Related types: ludus::foundation::usize

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp

GpuByteBudget¶

ludus::foundation::usize ludus::graphics::renderer::GpuPreviewOptions::GpuByteBudget = 0

Known preview buffers and two RGBA8/private-depth output images across live previews, including native BLAS/TLAS inputs, structures and build scratch, and cancelled jobs with pending producers/acquired frames. Excludes renderer/RHI registries, upload staging and opaque driver allocations.

Related types: ludus::foundation::usize

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp

Exposure¶

ludus::foundation::float32 ludus::graphics::renderer::GpuPreviewOptions::Exposure = 1

Positive finite display exposure. Output applies Reinhard then sRGB encoding.

Related types: ludus::foundation::float32

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp

StorageBuffers¶

foundation::BorrowedView<const content::render_graph_format::StorageBuffer> ludus::graphics::renderer::GpuPreviewOptions::StorageBuffers {}

Optional native graph storage; copied by EnableGpuPreview/EnableTriangleRayPipeline. Slots/strides/access must match the compute shader. Each job owns zeroed buffers until release; Count==0 follows its pixel extent. Budgets include their bytes.

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp

NativeRayStagesOrNull¶

const rhi::RasterShaderDescription* ludus::graphics::renderer::GpuPreviewOptions::NativeRayStagesOrNull = nullptr

Optional native Metal stage artifact, borrowed only during Enable. Requires the same public binding/workgroup ABI as the compute artifact. Unsupported devices reject explicitly.

Related types: rhi::RasterShaderDescription

Declared in modules/graphics/renderer/include/ludus/graphics/renderer/gpu_preview.hpp