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 (alpha2_render::RenderQualityControls::MAX_FILTER_SAMPLES). Tier B applies less.

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 dimension multiplier (checked by Self::validate).

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 4:2:0 export size: the render size, which must be even. Export entry points check this before rendering so the error names the nearest even size.

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