Enum RendererLoadingPhase 

pub enum RendererLoadingPhase {
    Init,
    CompilingShaders,
    BuildingPipelines,
    Ready,
}

Coarse-grained stages the renderer passes through during AwsmRendererBuilder::build. Subscribers passed via AwsmRendererBuilder::with_phase_handler get a callback at each transition; consumer UIs can map these to whatever progress message they want to show.

The most useful UX win these surface is the cold WebGPU cache case: a fresh Chrome profile can sit on CompilingShaders for tens of seconds while Dawn + the GPU driver lower every shader to MSL on the first visit. Showing “Browser is compiling shaders… (first load may take a while)” rather than a frozen “Initializing renderer…” is the difference between a user assuming the app is broken and a user knowing the browser is doing real work that will be cached next time.

Variants

Init

Adapter / device acquisition + initial bookkeeping + supporting GPU resource generation (IBL default cubemaps, BRDF LUT compute, opaque-mipgen pipeline) + render-pass shader cache key collection. No Dawn shader / pipeline compile work in this phase — it’s the concurrent setup that feeds the cross-renderer pool.

CompilingShaders

The cross-renderer shader pool is running: one Shaders::ensure_keys covering every shader the renderer compiles (RenderPasses + Picker + LineRenderer + Shadows caster + Effects + Display), joined with EVSM inline-shader validate_shader futures. On a cold PSO disk cache this is where Dawn lowers WGSL → MSL; on a warm cache it’s a cache-hit lookup.

BuildingPipelines

The cross-renderer pipeline pool is running: one try_join’d ComputePipelines::ensure_keys + RenderPipelines::ensure_keys covering every compute and render pipeline across the entire renderer.

Ready

All renderer-init work done; ready to render.

Trait Implementations

impl Clone for RendererLoadingPhase

fn clone(&self) -> RendererLoadingPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RendererLoadingPhase

impl Debug for RendererLoadingPhase

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

Formats the value using the given formatter.

impl Eq for RendererLoadingPhase

impl Hash for RendererLoadingPhase

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RendererLoadingPhase

fn eq(&self, other: &RendererLoadingPhase) -> 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 StructuralPartialEq for RendererLoadingPhase