emilk/egui · error

The surface isn't supported by this adapter

Error message

The surface isn't supported by this adapter

What it means

Error "The surface isn't supported by this adapter" thrown in emilk/egui.

Source

Thrown at crates/egui-wgpu/src/winit.rs:129

        let desired_maximum_frame_latency = if surface_state.resizing {
            Some(desired_maximum_frame_latency.unwrap_or(2).max(2))
        } else {
            desired_maximum_frame_latency
        };

        let width = surface_state.width;
        let height = surface_state.height;

        let mut surf_config = wgpu::SurfaceConfiguration {
            usage: wgpu::TextureUsages::RENDER_ATTACHMENT,
            format: render_state.target_format,
            present_mode,
            alpha_mode: surface_state.alpha_mode,
            view_formats: vec![render_state.target_format],
            ..surface_state
                .surface
                .get_default_config(&render_state.adapter, width, height)
                .expect("The surface isn't supported by this adapter")
        };

        if let Some(desired_maximum_frame_latency) = desired_maximum_frame_latency {
            surf_config.desired_maximum_frame_latency = desired_maximum_frame_latency;
        }

        surface_state
            .surface
            .configure(&render_state.device, &surf_config);
    }

    /// Drop the existing [`wgpu::Surface`] for `viewport_id` and create a fresh one for the
    /// given window via [`wgpu::Instance::create_surface`], then configure it.
    ///
    /// Used to recover from [`wgpu::CurrentSurfaceTexture::Lost`], where reconfiguring the
    /// existing surface object cannot recover.
    fn recreate_surface(
        &mut self,

View on GitHub (pinned to d802a982ce)

When it happens

Trigger: Thrown at crates/egui-wgpu/src/winit.rs:129 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of emilk/egui@d802a982ce (2026-08-16). Data as JSON: /api/errors/257e733795d087e6. Report an issue: GitHub.