Struct Hal 

pub struct Hal {
    pub instance: Instance,
    pub adapter: Adapter,
    pub device: Device,
    pub queue: Queue,
}

Estado wgpu compartido. Una instancia por proceso. Device y Queue son Arc internamente, así que clonar es barato.

Fields

instance: Instance

adapter: Adapter

device: Device

queue: Queue

Implementations

impl Hal

pub async fn new( compatible_surface: Option<&Surface<'static>>, ) -> Result<Self, HalError>

Construye Hal pidiendo un adapter compatible con una surface dada (recomendado: pasar Some(&surface) para garantizar que el adapter elegido sabe presentar a esa surface).

Examples found in repository

examples/clear_screen.rs (line 50)

    fn resumed(&mut self, event_loop: &ActiveEventLoop) {
        if self.state.is_some() {
            return;
        }
        let window = event_loop
            .create_window(
                WindowAttributes::default()
                    .with_title("llimphi · clear_screen")
                    .with_inner_size(LogicalSize::new(960u32, 540u32)),
            )
            .expect("create window");
        let window = Arc::new(window);
        let hal = pollster::block_on(Hal::new(None)).expect("hal");
        let surface = WinitSurface::new(&hal, window.clone()).expect("surface");
        window.request_redraw();
        self.state = Some(State {
            window,
            hal,
            surface,
        });
    }

pub async unsafe fn new_for_raw_surface( make_target: impl Fn() -> SurfaceTargetUnsafe, width: u32, height: u32, ) -> Result<(Self, RawSurface), HalError>

Construye el Hal y una RawSurface a la vez, eligiendo el adaptador compatible con esa surface — el dispositivo que el compositor sabe presentar. Es el camino correcto para el backend layer-shell de pata.

El problema que resuelve: en sistemas multi-GPU (Optimus), pedir el adaptador sin pista de surface (new(None) con HighPerformance) puede elegir la dGPU mientras el compositor compone en la iGPU → los dmabuf cruzan dispositivos y get_capabilities devuelve 0 formatos (la surface “no expone formatos”). Pasar compatible_surface ata el adaptador al dispositivo del compositor. Como la surface hace falta ANTES de pedir el adaptador, y new crea la instancia internamente, este constructor une los dos pasos.

make_target reconstruye el SurfaceTargetUnsafe cada vez que se llama (los RawHandle son Copy): create_surface_unsafe consume el target y puede que probemos dos instancias (PRIMARY y, si no hay adaptador, todos los backends — el GL de Mesa/Wayland revienta en teardown, por eso PRIMARY primero, igual que Hal::new).

Safety

Los handles que produce make_target deben apuntar a objetos Wayland/… vivos durante toda la vida de la RawSurface devuelta.