atagen

monolith

public
Star0
Watch0
2454f8b9122d101a822ca97b17c55ca9df53a24e
1
ssh://brewery@pls.lobotomise.me:33/atagen/monolith.git

Blame: crates/render-vk/src/device.rs

824bf02b6e55atagen2026-10-16 09:15 UTC1
use crate::Error;
824bf02b6e55atagen2026-10-16 09:15 UTC2
use ash::vk;
824bf02b6e55atagen2026-10-16 09:15 UTC3
use gpu_allocator::vulkan::{Allocator, AllocatorCreateDesc};
824bf02b6e55atagen2026-10-16 09:15 UTC4
use std::sync::Mutex;
824bf02b6e55atagen2026-10-16 09:15 UTC5
824bf02b6e55atagen2026-10-16 09:15 UTC6
/// Everything that must outlive every Vulkan object the renderer hands out.
824bf02b6e55atagen2026-10-16 09:15 UTC7
/// Fields drop in declaration order, so the allocator frees its memory before
824bf02b6e55atagen2026-10-16 09:15 UTC8
/// the device is destroyed.
824bf02b6e55atagen2026-10-16 09:15 UTC9
pub(crate) struct Shared {
04f0de436841atagen2026-10-17 04:23 UTC10
    /// Staging buffers kept for reuse, see `Staging`.
04f0de436841atagen2026-10-17 04:23 UTC11
    pub staging_pool: Mutex<Vec<crate::image::Pooled>>,
824bf02b6e55atagen2026-10-16 09:15 UTC12
    pub allocator: Mutex<Allocator>,
824bf02b6e55atagen2026-10-16 09:15 UTC13
    pub device: Device,
824bf02b6e55atagen2026-10-16 09:15 UTC14
}
824bf02b6e55atagen2026-10-16 09:15 UTC15
04f0de436841atagen2026-10-17 04:23 UTC16
impl Drop for Shared {
04f0de436841atagen2026-10-17 04:23 UTC17
    fn drop(&mut self) {
04f0de436841atagen2026-10-17 04:23 UTC18
        let pool = std::mem::take(
04f0de436841atagen2026-10-17 04:23 UTC19
            self.staging_pool
04f0de436841atagen2026-10-17 04:23 UTC20
                .get_mut()
04f0de436841atagen2026-10-17 04:23 UTC21
                .unwrap_or_else(|e| e.into_inner()),
04f0de436841atagen2026-10-17 04:23 UTC22
        );
04f0de436841atagen2026-10-17 04:23 UTC23
        let allocator = self.allocator.get_mut().unwrap_or_else(|e| e.into_inner());
04f0de436841atagen2026-10-17 04:23 UTC24
        for p in pool {
04f0de436841atagen2026-10-17 04:23 UTC25
            unsafe { self.device.device.destroy_buffer(p.buffer, None) };
04f0de436841atagen2026-10-17 04:23 UTC26
            let _ = allocator.free(p.allocation);
04f0de436841atagen2026-10-17 04:23 UTC27
        }
04f0de436841atagen2026-10-17 04:23 UTC28
    }
04f0de436841atagen2026-10-17 04:23 UTC29
}
04f0de436841atagen2026-10-17 04:23 UTC30
7de49c2aa70batagen2026-10-16 09:27 UTC31
/// Loaders for the extensions that dmabuf import, export and fence export
7de49c2aa70batagen2026-10-16 09:27 UTC32
/// need. Absent when the device lacks any of them.
7de49c2aa70batagen2026-10-16 09:27 UTC33
pub(crate) struct DmabufExt {
7de49c2aa70batagen2026-10-16 09:27 UTC34
    pub memory_fd: ash::khr::external_memory_fd::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC35
    pub fence_fd: ash::khr::external_fence_fd::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC36
    pub modifier: ash::ext::image_drm_format_modifier::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC37
}
7de49c2aa70batagen2026-10-16 09:27 UTC38
7de49c2aa70batagen2026-10-16 09:27 UTC39
const DMABUF_EXTENSIONS: [&std::ffi::CStr; 5] = [
7de49c2aa70batagen2026-10-16 09:27 UTC40
    ash::khr::external_memory_fd::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC41
    ash::ext::external_memory_dma_buf::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC42
    ash::ext::image_drm_format_modifier::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC43
    ash::ext::queue_family_foreign::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC44
    ash::khr::external_fence_fd::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC45
];
7de49c2aa70batagen2026-10-16 09:27 UTC46
824bf02b6e55atagen2026-10-16 09:15 UTC47
pub(crate) struct Device {
824bf02b6e55atagen2026-10-16 09:15 UTC48
    pub _entry: ash::Entry,
824bf02b6e55atagen2026-10-16 09:15 UTC49
    pub instance: ash::Instance,
824bf02b6e55atagen2026-10-16 09:15 UTC50
    pub physical: vk::PhysicalDevice,
824bf02b6e55atagen2026-10-16 09:15 UTC51
    pub device: ash::Device,
824bf02b6e55atagen2026-10-16 09:15 UTC52
    pub queue: Mutex<vk::Queue>,
824bf02b6e55atagen2026-10-16 09:15 UTC53
    pub queue_family: u32,
824bf02b6e55atagen2026-10-16 09:15 UTC54
    pub push_descriptor: ash::khr::push_descriptor::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC55
    pub dmabuf: Option<DmabufExt>,
824bf02b6e55atagen2026-10-16 09:15 UTC56
    pub name: String,
2454f8b9122datagen2026-10-19 06:05 UTC57
    pub drm_node: Option<u64>,
d5eca1c82213atagen2026-10-16 13:56 UTC58
    /// Signalled fences kept for reuse, see `FenceInner`.
d5eca1c82213atagen2026-10-16 13:56 UTC59
    pub spare_fences: Mutex<Vec<vk::Fence>>,
824bf02b6e55atagen2026-10-16 09:15 UTC60
}
824bf02b6e55atagen2026-10-16 09:15 UTC61
824bf02b6e55atagen2026-10-16 09:15 UTC62
impl Drop for Device {
824bf02b6e55atagen2026-10-16 09:15 UTC63
    fn drop(&mut self) {
824bf02b6e55atagen2026-10-16 09:15 UTC64
        unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC65
            let _ = self.device.device_wait_idle();
d5eca1c82213atagen2026-10-16 13:56 UTC66
            for f in self
d5eca1c82213atagen2026-10-16 13:56 UTC67
                .spare_fences
d5eca1c82213atagen2026-10-16 13:56 UTC68
                .get_mut()
d5eca1c82213atagen2026-10-16 13:56 UTC69
                .unwrap_or_else(|e| e.into_inner())
d5eca1c82213atagen2026-10-16 13:56 UTC70
                .drain(..)
d5eca1c82213atagen2026-10-16 13:56 UTC71
            {
d5eca1c82213atagen2026-10-16 13:56 UTC72
                self.device.destroy_fence(f, None);
d5eca1c82213atagen2026-10-16 13:56 UTC73
            }
824bf02b6e55atagen2026-10-16 09:15 UTC74
            self.device.destroy_device(None);
824bf02b6e55atagen2026-10-16 09:15 UTC75
            self.instance.destroy_instance(None);
824bf02b6e55atagen2026-10-16 09:15 UTC76
        }
824bf02b6e55atagen2026-10-16 09:15 UTC77
    }
824bf02b6e55atagen2026-10-16 09:15 UTC78
}
824bf02b6e55atagen2026-10-16 09:15 UTC79
824bf02b6e55atagen2026-10-16 09:15 UTC80
impl Shared {
824bf02b6e55atagen2026-10-16 09:15 UTC81
    /// Opens the first suitable device, or the one whose name contains
f27fa4c2ade9atagen2026-10-16 12:59 UTC82
    /// `MONOLITH_VK_DEVICE` when that is set. With `node`, only the device
f27fa4c2ade9atagen2026-10-16 12:59 UTC83
    /// behind that DRM device number qualifies.
f27fa4c2ade9atagen2026-10-16 12:59 UTC84
    pub fn new(node: Option<u64>) -> Result<Self, Error> {
824bf02b6e55atagen2026-10-16 09:15 UTC85
        let entry = unsafe { ash::Entry::load()? };
824bf02b6e55atagen2026-10-16 09:15 UTC86
        let app = vk::ApplicationInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC87
            .application_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC88
            .engine_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC89
            .api_version(vk::API_VERSION_1_3);
824bf02b6e55atagen2026-10-16 09:15 UTC90
        let instance = unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC91
            entry.create_instance(
824bf02b6e55atagen2026-10-16 09:15 UTC92
                &vk::InstanceCreateInfo::default().application_info(&app),
824bf02b6e55atagen2026-10-16 09:15 UTC93
                None,
824bf02b6e55atagen2026-10-16 09:15 UTC94
            )?
824bf02b6e55atagen2026-10-16 09:15 UTC95
        };
824bf02b6e55atagen2026-10-16 09:15 UTC96
        let wanted = std::env::var("MONOLITH_VK_DEVICE").ok();
f27fa4c2ade9atagen2026-10-16 12:59 UTC97
        let picked = unsafe { pick_physical(&instance, wanted.as_deref(), node) };
824bf02b6e55atagen2026-10-16 09:15 UTC98
        let Some((physical, queue_family, name)) = picked else {
824bf02b6e55atagen2026-10-16 09:15 UTC99
            unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC100
            return Err(Error::NoSuitableDevice);
824bf02b6e55atagen2026-10-16 09:15 UTC101
        };
824bf02b6e55atagen2026-10-16 09:15 UTC102
        let priorities = [1.0];
7de49c2aa70batagen2026-10-16 09:27 UTC103
        let available: Vec<_> = unsafe { instance.enumerate_device_extension_properties(physical) }
7de49c2aa70batagen2026-10-16 09:27 UTC104
            .unwrap_or_default()
7de49c2aa70batagen2026-10-16 09:27 UTC105
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC106
            .filter_map(|e| e.extension_name_as_c_str().ok().map(ToOwned::to_owned))
7de49c2aa70batagen2026-10-16 09:27 UTC107
            .collect();
2454f8b9122datagen2026-10-19 06:05 UTC108
        let drm_node = available
2454f8b9122datagen2026-10-19 06:05 UTC109
            .iter()
2454f8b9122datagen2026-10-19 06:05 UTC110
            .any(|a| a.as_c_str() == ash::ext::physical_device_drm::NAME)
2454f8b9122datagen2026-10-19 06:05 UTC111
            .then(|| unsafe { drm_node(&instance, physical) })
2454f8b9122datagen2026-10-19 06:05 UTC112
            .flatten();
7de49c2aa70batagen2026-10-16 09:27 UTC113
        let has_dmabuf = DMABUF_EXTENSIONS
7de49c2aa70batagen2026-10-16 09:27 UTC114
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC115
            .all(|n| available.iter().any(|a| a.as_c_str() == *n));
7de49c2aa70batagen2026-10-16 09:27 UTC116
        let mut extensions = vec![ash::khr::push_descriptor::NAME.as_ptr()];
7de49c2aa70batagen2026-10-16 09:27 UTC117
        if has_dmabuf {
7de49c2aa70batagen2026-10-16 09:27 UTC118
            extensions.extend(DMABUF_EXTENSIONS.iter().map(|n| n.as_ptr()));
7de49c2aa70batagen2026-10-16 09:27 UTC119
        }
796c963a4b55atagen2026-10-16 22:46 UTC120
        let global_priority = [
796c963a4b55atagen2026-10-16 22:46 UTC121
            ash::khr::global_priority::NAME,
796c963a4b55atagen2026-10-16 22:46 UTC122
            ash::ext::global_priority::NAME,
796c963a4b55atagen2026-10-16 22:46 UTC123
        ]
796c963a4b55atagen2026-10-16 22:46 UTC124
        .into_iter()
796c963a4b55atagen2026-10-16 22:46 UTC125
        .find(|n| available.iter().any(|a| a.as_c_str() == *n));
796c963a4b55atagen2026-10-16 22:46 UTC126
        let mut priorities_to_try = vec![None];
796c963a4b55atagen2026-10-16 22:46 UTC127
        if let Some(name) = global_priority {
796c963a4b55atagen2026-10-16 22:46 UTC128
            extensions.push(name.as_ptr());
796c963a4b55atagen2026-10-16 22:46 UTC129
            priorities_to_try = vec![
796c963a4b55atagen2026-10-16 22:46 UTC130
                Some(vk::QueueGlobalPriorityKHR::REALTIME),
796c963a4b55atagen2026-10-16 22:46 UTC131
                Some(vk::QueueGlobalPriorityKHR::HIGH),
796c963a4b55atagen2026-10-16 22:46 UTC132
                None,
796c963a4b55atagen2026-10-16 22:46 UTC133
            ];
796c963a4b55atagen2026-10-16 22:46 UTC134
        }
796c963a4b55atagen2026-10-16 22:46 UTC135
        let mut created = Err(vk::Result::ERROR_INITIALIZATION_FAILED);
796c963a4b55atagen2026-10-16 22:46 UTC136
        for priority in priorities_to_try {
796c963a4b55atagen2026-10-16 22:46 UTC137
            let mut features13 = vk::PhysicalDeviceVulkan13Features::default()
796c963a4b55atagen2026-10-16 22:46 UTC138
                .dynamic_rendering(true)
796c963a4b55atagen2026-10-16 22:46 UTC139
                .synchronization2(true);
796c963a4b55atagen2026-10-16 22:46 UTC140
            let mut global = vk::DeviceQueueGlobalPriorityCreateInfoKHR::default()
796c963a4b55atagen2026-10-16 22:46 UTC141
                .global_priority(priority.unwrap_or(vk::QueueGlobalPriorityKHR::MEDIUM));
796c963a4b55atagen2026-10-16 22:46 UTC142
            let mut queue = vk::DeviceQueueCreateInfo::default()
796c963a4b55atagen2026-10-16 22:46 UTC143
                .queue_family_index(queue_family)
796c963a4b55atagen2026-10-16 22:46 UTC144
                .queue_priorities(&priorities);
796c963a4b55atagen2026-10-16 22:46 UTC145
            if priority.is_some() {
796c963a4b55atagen2026-10-16 22:46 UTC146
                queue = queue.push_next(&mut global);
796c963a4b55atagen2026-10-16 22:46 UTC147
            }
796c963a4b55atagen2026-10-16 22:46 UTC148
            let queues = [queue];
796c963a4b55atagen2026-10-16 22:46 UTC149
            let info = vk::DeviceCreateInfo::default()
796c963a4b55atagen2026-10-16 22:46 UTC150
                .queue_create_infos(&queues)
796c963a4b55atagen2026-10-16 22:46 UTC151
                .enabled_extension_names(&extensions)
796c963a4b55atagen2026-10-16 22:46 UTC152
                .push_next(&mut features13);
796c963a4b55atagen2026-10-16 22:46 UTC153
            created = unsafe { instance.create_device(physical, &info, None) };
796c963a4b55atagen2026-10-16 22:46 UTC154
            match &created {
796c963a4b55atagen2026-10-16 22:46 UTC155
                Ok(_) => {
796c963a4b55atagen2026-10-16 22:46 UTC156
                    tracing::info!(?priority, "queue global priority");
796c963a4b55atagen2026-10-16 22:46 UTC157
                    break;
796c963a4b55atagen2026-10-16 22:46 UTC158
                }
796c963a4b55atagen2026-10-16 22:46 UTC159
                Err(e) => tracing::debug!(?priority, "queue global priority refused: {e}"),
796c963a4b55atagen2026-10-16 22:46 UTC160
            }
796c963a4b55atagen2026-10-16 22:46 UTC161
        }
796c963a4b55atagen2026-10-16 22:46 UTC162
        let device = match created {
824bf02b6e55atagen2026-10-16 09:15 UTC163
            Ok(d) => d,
824bf02b6e55atagen2026-10-16 09:15 UTC164
            Err(e) => {
824bf02b6e55atagen2026-10-16 09:15 UTC165
                unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC166
                return Err(e.into());
824bf02b6e55atagen2026-10-16 09:15 UTC167
            }
824bf02b6e55atagen2026-10-16 09:15 UTC168
        };
824bf02b6e55atagen2026-10-16 09:15 UTC169
        let queue = unsafe { device.get_device_queue(queue_family, 0) };
824bf02b6e55atagen2026-10-16 09:15 UTC170
        let push_descriptor = ash::khr::push_descriptor::Device::new(&instance, &device);
7de49c2aa70batagen2026-10-16 09:27 UTC171
        let dmabuf = has_dmabuf.then(|| DmabufExt {
7de49c2aa70batagen2026-10-16 09:27 UTC172
            memory_fd: ash::khr::external_memory_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC173
            fence_fd: ash::khr::external_fence_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC174
            modifier: ash::ext::image_drm_format_modifier::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC175
        });
824bf02b6e55atagen2026-10-16 09:15 UTC176
        let allocator = Allocator::new(&AllocatorCreateDesc {
824bf02b6e55atagen2026-10-16 09:15 UTC177
            instance: instance.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC178
            device: device.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC179
            physical_device: physical,
824bf02b6e55atagen2026-10-16 09:15 UTC180
            debug_settings: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC181
            buffer_device_address: false,
824bf02b6e55atagen2026-10-16 09:15 UTC182
            allocation_sizes: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC183
        });
824bf02b6e55atagen2026-10-16 09:15 UTC184
        let device = Device {
824bf02b6e55atagen2026-10-16 09:15 UTC185
            _entry: entry,
824bf02b6e55atagen2026-10-16 09:15 UTC186
            instance,
824bf02b6e55atagen2026-10-16 09:15 UTC187
            physical,
824bf02b6e55atagen2026-10-16 09:15 UTC188
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC189
            queue: Mutex::new(queue),
824bf02b6e55atagen2026-10-16 09:15 UTC190
            queue_family,
824bf02b6e55atagen2026-10-16 09:15 UTC191
            push_descriptor,
7de49c2aa70batagen2026-10-16 09:27 UTC192
            dmabuf,
824bf02b6e55atagen2026-10-16 09:15 UTC193
            name,
2454f8b9122datagen2026-10-19 06:05 UTC194
            drm_node,
d5eca1c82213atagen2026-10-16 13:56 UTC195
            spare_fences: Mutex::new(Vec::new()),
824bf02b6e55atagen2026-10-16 09:15 UTC196
        };
824bf02b6e55atagen2026-10-16 09:15 UTC197
        Ok(Self {
04f0de436841atagen2026-10-17 04:23 UTC198
            staging_pool: Mutex::new(Vec::new()),
824bf02b6e55atagen2026-10-16 09:15 UTC199
            allocator: Mutex::new(allocator?),
824bf02b6e55atagen2026-10-16 09:15 UTC200
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC201
        })
824bf02b6e55atagen2026-10-16 09:15 UTC202
    }
824bf02b6e55atagen2026-10-16 09:15 UTC203
}
824bf02b6e55atagen2026-10-16 09:15 UTC204
f27fa4c2ade9atagen2026-10-16 12:59 UTC205
/// Whether `physical` is the device behind DRM device number `node`, as its
f27fa4c2ade9atagen2026-10-16 12:59 UTC206
/// primary or render node.
f27fa4c2ade9atagen2026-10-16 12:59 UTC207
unsafe fn serves_node(instance: &ash::Instance, physical: vk::PhysicalDevice, node: u64) -> bool {
f27fa4c2ade9atagen2026-10-16 12:59 UTC208
    let mut drm = vk::PhysicalDeviceDrmPropertiesEXT::default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC209
    let mut props = vk::PhysicalDeviceProperties2::default().push_next(&mut drm);
f27fa4c2ade9atagen2026-10-16 12:59 UTC210
    unsafe { instance.get_physical_device_properties2(physical, &mut props) };
f27fa4c2ade9atagen2026-10-16 12:59 UTC211
    let (major, minor) = (
f27fa4c2ade9atagen2026-10-16 12:59 UTC212
        rustix::fs::major(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC213
        rustix::fs::minor(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC214
    );
f27fa4c2ade9atagen2026-10-16 12:59 UTC215
    (drm.has_primary == vk::TRUE && (drm.primary_major, drm.primary_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC216
        || (drm.has_render == vk::TRUE && (drm.render_major, drm.render_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC217
}
f27fa4c2ade9atagen2026-10-16 12:59 UTC218
2454f8b9122datagen2026-10-19 06:05 UTC219
/// The render node of `physical`, or its primary node when it has none.
2454f8b9122datagen2026-10-19 06:05 UTC220
unsafe fn drm_node(instance: &ash::Instance, physical: vk::PhysicalDevice) -> Option<u64> {
2454f8b9122datagen2026-10-19 06:05 UTC221
    let mut drm = vk::PhysicalDeviceDrmPropertiesEXT::default();
2454f8b9122datagen2026-10-19 06:05 UTC222
    let mut props = vk::PhysicalDeviceProperties2::default().push_next(&mut drm);
2454f8b9122datagen2026-10-19 06:05 UTC223
    unsafe { instance.get_physical_device_properties2(physical, &mut props) };
2454f8b9122datagen2026-10-19 06:05 UTC224
    let node = |major: i64, minor: i64| rustix::fs::makedev(major as u32, minor as u32);
2454f8b9122datagen2026-10-19 06:05 UTC225
    if drm.has_render == vk::TRUE {
2454f8b9122datagen2026-10-19 06:05 UTC226
        Some(node(drm.render_major, drm.render_minor))
2454f8b9122datagen2026-10-19 06:05 UTC227
    } else if drm.has_primary == vk::TRUE {
2454f8b9122datagen2026-10-19 06:05 UTC228
        Some(node(drm.primary_major, drm.primary_minor))
2454f8b9122datagen2026-10-19 06:05 UTC229
    } else {
2454f8b9122datagen2026-10-19 06:05 UTC230
        None
2454f8b9122datagen2026-10-19 06:05 UTC231
    }
2454f8b9122datagen2026-10-19 06:05 UTC232
}
2454f8b9122datagen2026-10-19 06:05 UTC233
824bf02b6e55atagen2026-10-16 09:15 UTC234
unsafe fn pick_physical(
824bf02b6e55atagen2026-10-16 09:15 UTC235
    instance: &ash::Instance,
824bf02b6e55atagen2026-10-16 09:15 UTC236
    wanted: Option<&str>,
f27fa4c2ade9atagen2026-10-16 12:59 UTC237
    node: Option<u64>,
824bf02b6e55atagen2026-10-16 09:15 UTC238
) -> Option<(vk::PhysicalDevice, u32, String)> {
824bf02b6e55atagen2026-10-16 09:15 UTC239
    let devices = unsafe { instance.enumerate_physical_devices() }.ok()?;
824bf02b6e55atagen2026-10-16 09:15 UTC240
    let mut candidates = Vec::new();
824bf02b6e55atagen2026-10-16 09:15 UTC241
    for physical in devices {
824bf02b6e55atagen2026-10-16 09:15 UTC242
        let props = unsafe { instance.get_physical_device_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC243
        if props.api_version < vk::API_VERSION_1_3 {
824bf02b6e55atagen2026-10-16 09:15 UTC244
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC245
        }
824bf02b6e55atagen2026-10-16 09:15 UTC246
        let name = props
824bf02b6e55atagen2026-10-16 09:15 UTC247
            .device_name_as_c_str()
824bf02b6e55atagen2026-10-16 09:15 UTC248
            .unwrap_or(c"unknown")
824bf02b6e55atagen2026-10-16 09:15 UTC249
            .to_string_lossy()
824bf02b6e55atagen2026-10-16 09:15 UTC250
            .into_owned();
824bf02b6e55atagen2026-10-16 09:15 UTC251
        if wanted.is_some_and(|w| !name.contains(w)) {
824bf02b6e55atagen2026-10-16 09:15 UTC252
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC253
        }
824bf02b6e55atagen2026-10-16 09:15 UTC254
        let mut f13 = vk::PhysicalDeviceVulkan13Features::default();
824bf02b6e55atagen2026-10-16 09:15 UTC255
        let mut f2 = vk::PhysicalDeviceFeatures2::default().push_next(&mut f13);
824bf02b6e55atagen2026-10-16 09:15 UTC256
        unsafe { instance.get_physical_device_features2(physical, &mut f2) };
824bf02b6e55atagen2026-10-16 09:15 UTC257
        if f13.dynamic_rendering == vk::FALSE || f13.synchronization2 == vk::FALSE {
824bf02b6e55atagen2026-10-16 09:15 UTC258
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC259
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC260
        let extensions =
f27fa4c2ade9atagen2026-10-16 12:59 UTC261
            unsafe { instance.enumerate_device_extension_properties(physical) }.unwrap_or_default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC262
        let has = |n: &std::ffi::CStr| {
f27fa4c2ade9atagen2026-10-16 12:59 UTC263
            extensions
f27fa4c2ade9atagen2026-10-16 12:59 UTC264
                .iter()
f27fa4c2ade9atagen2026-10-16 12:59 UTC265
                .any(|e| e.extension_name_as_c_str().ok() == Some(n))
f27fa4c2ade9atagen2026-10-16 12:59 UTC266
        };
f27fa4c2ade9atagen2026-10-16 12:59 UTC267
        if !has(ash::khr::push_descriptor::NAME) {
f27fa4c2ade9atagen2026-10-16 12:59 UTC268
            continue;
f27fa4c2ade9atagen2026-10-16 12:59 UTC269
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC270
        if let Some(node) = node
f27fa4c2ade9atagen2026-10-16 12:59 UTC271
            && !(has(ash::ext::physical_device_drm::NAME)
f27fa4c2ade9atagen2026-10-16 12:59 UTC272
                && unsafe { serves_node(instance, physical, node) })
f27fa4c2ade9atagen2026-10-16 12:59 UTC273
        {
824bf02b6e55atagen2026-10-16 09:15 UTC274
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC275
        }
824bf02b6e55atagen2026-10-16 09:15 UTC276
        let families = unsafe { instance.get_physical_device_queue_family_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC277
        let Some(family) = families
824bf02b6e55atagen2026-10-16 09:15 UTC278
            .iter()
824bf02b6e55atagen2026-10-16 09:15 UTC279
            .position(|f| f.queue_flags.contains(vk::QueueFlags::GRAPHICS))
824bf02b6e55atagen2026-10-16 09:15 UTC280
        else {
824bf02b6e55atagen2026-10-16 09:15 UTC281
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC282
        };
824bf02b6e55atagen2026-10-16 09:15 UTC283
        let rank = match props.device_type {
824bf02b6e55atagen2026-10-16 09:15 UTC284
            vk::PhysicalDeviceType::DISCRETE_GPU => 0,
824bf02b6e55atagen2026-10-16 09:15 UTC285
            vk::PhysicalDeviceType::INTEGRATED_GPU => 1,
824bf02b6e55atagen2026-10-16 09:15 UTC286
            vk::PhysicalDeviceType::VIRTUAL_GPU => 2,
824bf02b6e55atagen2026-10-16 09:15 UTC287
            _ => 3,
824bf02b6e55atagen2026-10-16 09:15 UTC288
        };
824bf02b6e55atagen2026-10-16 09:15 UTC289
        candidates.push((rank, physical, family as u32, name));
824bf02b6e55atagen2026-10-16 09:15 UTC290
    }
824bf02b6e55atagen2026-10-16 09:15 UTC291
    candidates.sort_by_key(|c| c.0);
824bf02b6e55atagen2026-10-16 09:15 UTC292
    candidates.into_iter().next().map(|(_, p, f, n)| (p, f, n))
824bf02b6e55atagen2026-10-16 09:15 UTC293
}