Struct QualityProfile 

#[non_exhaustive]
pub struct QualityProfile {
    pub resolution_scale: f32,
    pub max_filter_samples: u32,
    pub motion_blur_subframes: u32,
    pub texture_budget_bytes: u64,
}

Runtime quality controls shared by real-time playback and export.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

resolution_scale: f32

Output scale relative to project dimensions.

max_filter_samples: u32

Maximum sampling work available to a filter pass.

motion_blur_subframes: u32

Temporal samples used by motion blur implementations.

texture_budget_bytes: u64

Soft budget available to reusable GPU textures.

Implementations

impl QualityProfile

pub const MAX_RESOLUTION_SCALE: f32 = 8.0

Largest supported multiplier for project dimensions.

pub const MAX_FILTER_SAMPLES: u32 = alpha2_render::RenderQualityControls::MAX_FILTER_SAMPLES

Largest per-pass filter sampling budget: the most any pass takes (alpha2_render::RenderQualityControls::MAX_FILTER_SAMPLES). A Tier-B renderer applies less, and reports it.

pub const MAX_MOTION_BLUR_SUBFRAMES: u32 = 256

Largest temporal sample count allocated for one render plan.

pub const MIN_TEXTURE_BUDGET_BYTES: u64

Smallest useful reusable-texture pool budget.

pub const MAX_TEXTURE_BUDGET_BYTES: u64

Largest accepted reusable-texture pool budget.

pub const fn export() -> Self

Full-resolution deterministic export defaults.

pub const fn preview() -> Self

Responsive half-resolution playback defaults.

pub const fn with_resolution_scale(self, scale: f32) -> Self

This profile with scale as its multiplier for project dimensions; Self::validate checks it.

pub fn validate(self) -> Result<(), EngineError>

Checks that all controls are finite and within runtime-safe bounds.

Errors

Returns EngineError::InvalidQualityProfile for out-of-range values.

pub fn render_size( self, settings: &ProjectSettings, ) -> Result<RenderSize, EngineError>

Resolves scaled project dimensions, rounding to the nearest pixel.

Errors

Returns EngineError for an invalid profile or unrepresentable size.

pub fn export_size( self, settings: &ProjectSettings, ) -> Result<RenderSize, EngineError>

The size of the 4:2:0 frames an export at this profile renders: the render size, which must be even in both dimensions. Every export entry point refuses an odd one with this before it renders, so the error names the nearest even size instead of the readback failing deep inside the GPU work.

Errors

Returns EngineError::OddExportDimensions, or what Self::render_size returns.

pub fn benchmark_metadata( self, project: impl Into<String>, settings: &ProjectSettings, renderer: &Renderer, ) -> Result<BenchmarkMetadata, EngineError>

Captures project, adapter, driver, backend, and quality facts for a benchmark.

Errors

Returns EngineError when the profile cannot resolve output dimensions.

Trait Implementations

impl Clone for QualityProfile

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 QualityProfile

impl Debug for QualityProfile

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

Formats the value using the given formatter.

impl Default for QualityProfile

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for QualityProfile

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QualityProfile