wgpu/wgpu-core/src/hal_api.rs

use wgt::{Backend, WasmNotSendSync};

use crate::{
    global::Global,
    hub::Hub,
    instance::{Instance, Surface},
};

pub trait HalApi: hal::Api + 'static + WasmNotSendSync {
    const VARIANT: Backend;
    fn create_instance_from_hal(name: &str, hal_instance: Self::Instance) -> Instance;
    fn instance_as_hal(instance: &Instance) -> Option<&Self::Instance>;
    fn hub(global: &Global) -> &Hub<Self>;
    fn surface_as_hal(surface: &Surface) -> Option<&Self::Surface>;
}

impl HalApi for hal::api::Empty {
    const VARIANT: Backend = Backend::Empty;
    fn create_instance_from_hal(_: &str, _: Self::Instance) -> Instance {
        unimplemented!("called empty api")
    }
    fn instance_as_hal(_: &Instance) -> Option<&Self::Instance> {
        unimplemented!("called empty api")
    }
    fn hub(_: &Global) -> &Hub<Self> {
        unimplemented!("called empty api")
    }
    fn surface_as_hal(_: &Surface) -> Option<&Self::Surface> {
        unimplemented!("called empty api")
    }
}

#[cfg(vulkan)]
impl HalApi for hal::api::Vulkan {
    const VARIANT: Backend = Backend::Vulkan;
    fn create_instance_from_hal(name: &str, hal_instance: Self::Instance) -> Instance {
        Instance {
            name: name.to_owned(),
            vulkan: Some(hal_instance),
            ..Default::default()
        }
    }
    fn instance_as_hal(instance: &Instance) -> Option<&Self::Instance> {
        instance.vulkan.as_ref()
    }
    fn hub(global: &Global) -> &Hub<Self> {
        &global.hubs.vulkan
    }
    fn surface_as_hal(surface: &Surface) -> Option<&Self::Surface> {
        surface.vulkan.as_ref()
    }
}

#[cfg(metal)]
impl HalApi for hal::api::Metal {
    const VARIANT: Backend = Backend::Metal;
    fn create_instance_from_hal(name: &str, hal_instance: Self::Instance) -> Instance {
        Instance {
            name: name.to_owned(),
            metal: Some(hal_instance),
            ..Default::default()
        }
    }
    fn instance_as_hal(instance: &Instance) -> Option<&Self::Instance> {
        instance.metal.as_ref()
    }
    fn hub(global: &Global) -> &Hub<Self> {
        &global.hubs.metal
    }
    fn surface_as_hal(surface: &Surface) -> Option<&Self::Surface> {
        surface.metal.as_ref()
    }
}

#[cfg(dx12)]
impl HalApi for hal::api::Dx12 {
    const VARIANT: Backend = Backend::Dx12;
    fn create_instance_from_hal(name: &str, hal_instance: Self::Instance) -> Instance {
        Instance {
            name: name.to_owned(),
            dx12: Some(hal_instance),
            ..Default::default()
        }
    }
    fn instance_as_hal(instance: &Instance) -> Option<&Self::Instance> {
        instance.dx12.as_ref()
    }
    fn hub(global: &Global) -> &Hub<Self> {
        &global.hubs.dx12
    }
    fn surface_as_hal(surface: &Surface) -> Option<&Self::Surface> {
        surface.dx12.as_ref()
    }
}

#[cfg(gles)]
impl HalApi for hal::api::Gles {
    const VARIANT: Backend = Backend::Gl;
    fn create_instance_from_hal(name: &str, hal_instance: Self::Instance) -> Instance {
        #[allow(clippy::needless_update)]
        Instance {
            name: name.to_owned(),
            gl: Some(hal_instance),
            ..Default::default()
        }
    }
    fn instance_as_hal(instance: &Instance) -> Option<&Self::Instance> {
        instance.gl.as_ref()
    }
    fn hub(global: &Global) -> &Hub<Self> {
        &global.hubs.gl
    }
    fn surface_as_hal(surface: &Surface) -> Option<&Self::Surface> {
        surface.gl.as_ref()
    }
}