Struct RendererOptions 

pub struct RendererOptions {
    pub tier: Option<Tier>,
    pub adapter: AdapterChoice,
    pub budget: SampleBudget,
}

Construction-time options for an on-surface Renderer (Plan 0044).

One field today and a struct anyway, because the tier pin is the first of a family: a renderer’s construction choices (quality, later backend or format preferences) are decided once and never per frame, and threading them as positional arguments is how the three constructors drift apart.

Fields

tier: Option<Tier>

An explicit tier pin, or None for auto — which resolves Tier::Rich and leaves the frame-time governor free to demote it once (ADR-0045). A pin is honoured in both directions and never demotes.

adapter: AdapterChoice

Which graphics adapter the window’s context asks for.

AdapterChoice::Default is what the surface path asked for before this field existed and stays the default here: an operator’s --gpu is a lever, not a new preference. Changing what an unflagged window selects would re-base every frame-time figure this project has published, which is a measurement question and not an argument-parsing one (ADR-0155).

Carrying a AdapterChoice::Named String is why this struct is Clone rather than Copy.

budget: SampleBudget

Which of the tier’s two attractor sample ceilings to resolve against (ADR-0140). SampleBudget::Live by default, so every caller that does not ask resolves exactly what it resolved before the choice existed.

Implementations

impl RendererOptions

pub fn pinned(tier: Tier) -> Self

Options pinning tier explicitly, on the default adapter.

pub fn pinned_offline(tier: Tier) -> Self

pinned, against the offline sample ceiling — for a headless render, which has no present deadline to answer to.

Trait Implementations

impl Clone for RendererOptions

fn clone(&self) -> RendererOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RendererOptions

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

Formats the value using the given formatter.

impl Default for RendererOptions

fn default() -> RendererOptions

Returns the “default value” for a type.

impl PartialEq for RendererOptions

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for RendererOptions

impl StructuralPartialEq for RendererOptions