Struct RayTraceSettings 

pub struct RayTraceSettings {
    pub samples_per_axis: u32,
    pub max_bounces: u32,
}

Ray-tracing quality settings shared by the CPU reference renderer and both GPU shader backends.

The values are packed into the GPU frame header so the CPU path and the shaders sample and bounce identically.

Fields

samples_per_axis: u32

Supersampling grid resolution per axis. 1 traces one ray per pixel; 4 traces sixteen and averages them. Valid range 1..=4.

max_bounces: u32

Maximum number of secondary bounces after the primary hit. 0 still shades the primary hit. Valid range 0..=16.

Implementations

impl RayTraceSettings

Implements the constructors and validation for RayTraceSettings.

pub fn new_default() -> RayTraceSettings

Returns the default settings: one ray per pixel and the [RAYTRACE_DEFAULT_MAX_BOUNCES_LIMIT] bounce limit.

Returns

• RayTraceSettings - The default settings.

pub fn with_quality(samples_per_axis: u32, max_bounces: u32) -> RayTraceSettings

Returns a settings block with an explicit sampling grid and bounce limit.

The arguments are not validated here; call RayTraceSettings::validate before packing or rendering.

Arguments

• u32 - The supersampling grid resolution per axis.
• u32 - The maximum number of secondary bounces.

Returns

• RayTraceSettings - The new settings.

pub fn rays_per_pixel(&self) -> u32

Returns the total number of rays traced per pixel, which is samples_per_axis squared.

Returns

• u32 - The per-pixel ray count.

pub fn validate(&self) -> Result<(), String>

Checks that both fields are inside the range the CPU renderer and both shaders support.

samples_per_axis must be within 1..=[RAYTRACE_SAMPLES_PER_AXIS_MAX] and max_bounces within 0..=[RAYTRACE_MAX_BOUNCES_MAX]. Anything else is rejected rather than clamped, so a caller never silently gets a different image than it asked for.

Returns

• Result<(), String> - Ok(()) when both fields are in range, otherwise a message naming the offending field.

impl RayTraceSettings

pub fn get_samples_per_axis(&self) -> u32

pub fn get_mut_samples_per_axis(&mut self) -> &mut u32

pub fn set_samples_per_axis(&mut self, val: u32) -> &mut Self

pub fn get_max_bounces(&self) -> u32

pub fn get_mut_max_bounces(&mut self) -> &mut u32

pub fn set_max_bounces(&mut self, val: u32) -> &mut Self

impl RayTraceSettings

pub fn new(samples_per_axis: u32, max_bounces: u32) -> Self

Trait Implementations

impl Clone for RayTraceSettings

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RayTraceSettings

impl Debug for RayTraceSettings

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for RayTraceSettings

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RayTraceSettings