ludus::graphics::renderer::GpuPreviewGraphInvocation¶

Struct

One graph node's sampling policy and cooked callback selection; consumed during BeginGpuPreview.

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

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

struct ludus::graphics::renderer::GpuPreviewGraphInvocation final

Fields¶

Program¶

foundation::uint32 ludus::graphics::renderer::GpuPreviewGraphInvocation::Program = 0

Cooked callback-set index below RenderGraphFormat::MAX_RAY_PROGRAMS.

Related types: foundation::uint32

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

Buffers¶

foundation::BorrowedView<const GpuPreviewGraphBuffer> ludus::graphics::renderer::GpuPreviewGraphInvocation::Buffers

Zero or two slots. A null Buffer with zero Size requests a private zeroed dummy. Non-null storage remains owned by the caller through job release and submitted completion.

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

AccumulationSamples¶

foundation::uint32 ludus::graphics::renderer::GpuPreviewGraphInvocation::AccumulationSamples = 0

Zero outputs individual samples; a positive value up to RenderGraphFormat::MAX_ACCUMULATION_SAMPLES averages linear radiance before display conversion. Camera/scene replacement restarts the mean. A frame capture's graph may use up to MAX_RENDER_GRAPH_CAPTURE_SAMPLES (RenderGraph::SetAccumulationLimitOverride).

Related types: foundation::uint32

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

ToneMappingExposure¶

foundation::float32 ludus::graphics::renderer::GpuPreviewGraphInvocation::ToneMappingExposure = 0

Graph-owned display conversion: zero bypasses it; a finite multiplier in the RenderGraphFormat tone-mapping exposure range applies ToneMappingCurve and sRGB after optional accumulation.

Related types: foundation::float32

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

DenoisingQuality¶

foundation::uint32 ludus::graphics::renderer::GpuPreviewGraphInvocation::DenoisingQuality = 0

Zero bypasses OIDN. Otherwise RenderGraphFormat::ProcessingQuality selects RT HDR filtering before display conversion. Metal GPU only; unavailable builds reject explicitly.

Related types: foundation::uint32

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

RayPathCapture¶

GpuPreviewGraphBuffer ludus::graphics::renderer::GpuPreviewGraphInvocation::RayPathCapture {}

Ray path capture buffer bound at slot 10 of a capture-variant kernel; required exactly when the enabled compute shader declares that binding. Size is a positive multiple of four. Caller-owned, shared by every pass of the graph and retained through job release and submitted completion.

Related types: GpuPreviewGraphBuffer

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

HasNativeRayInvocation¶

bool ludus::graphics::renderer::GpuPreviewGraphInvocation::HasNativeRayInvocation = false

Execute the enabled native ray stages. False selects the ordinary compute artifact.

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

SceneSourceOrNull¶

const GpuPreview* ludus::graphics::renderer::GpuPreviewGraphInvocation::SceneSourceOrNull = nullptr

Optional live job of this renderer whose uploaded scene this job shares instead of packing another copy to the GPU: triangles, BVH, emitters, surfaces, lights, environment, texels and native geometry, charged to the preview and RHI byte budgets once. Requires a graph scene description with the same content and SceneData as the source's, such as another ray pass of one RenderGraph update; the camera, extent and kernel may differ. The shared scene stays alive until every job that references it is released and retired. A stale or released source returns InvalidHandle; a scene that packs differently returns InvalidDescription. Null uploads this job's own scene.

Related types: GpuPreview

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

ToneMappingCurve¶

ToneCurve ludus::graphics::renderer::GpuPreviewGraphInvocation::ToneMappingCurve = ToneCurve::Reinhard

Curve of a nonzero ToneMappingExposure: Reinhard or PbrNeutral. Ignored when exposure is zero.

Related types: ToneCurve

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