Struct PhysicalDevice

pub struct PhysicalDevice { /* private fields */ }

A physical device abstracts away an actual device, like a graphics card or integrated graphics card. This struct stores its Vulkan handle, properties and requested queues.

Implementations

impl PhysicalDevice

pub fn select<Window: WindowInterface>( instance: &Instance, surface: Option<&Surface>, settings: &AppSettings<'_, Window>, ) -> Result<Self>

Selects the best available physical device from the given requirements and parameters.

pub fn select_with_surface<Window: WindowInterface>( instance: &Instance, settings: &AppSettings<'_, Window>, ) -> Result<(Surface, Self)>

Selects the best available physical device and creates a surface on it.

pub fn queue_families(&self) -> &[QueueFamilyProperties]

Get all queue families available on this device. This is different from Device::queue_families() since this knows about properties of each family, while the device function only knows about family indices.

pub fn queues(&self) -> &[QueueInfo]

Get information on all requested queues.

Example

fn list_queues(device: PhysicalDevice) {
    device.queues()
          .iter()
          .for_each(|info| {
                println!("Queue #{} supports {:#?} (dedicated = {}, can_present = {})", info.family_index, info.flags, info.dedicated, info.can_present);
          })
}

pub unsafe fn handle(&self) -> PhysicalDevice

Get unsafe access to the physical device handle

Safety

Any vulkan calls that mutate this physical device may leave the system in an undefined state.

pub fn properties(&self) -> &PhysicalDeviceProperties

This is the same function as Device::properties()

pub fn memory_properties(&self) -> &PhysicalDeviceMemoryProperties

Get the memory properties of this physical device, such as the different memory heaps available.

Example

fn list_memory_heaps(device: PhysicalDevice) {
    let properties = device.memory_properties();
    for i in 0..properties.memory_heap_count {
        let heap = properties.memory_heaps[i as usize];
        println!("Heap #{i} has flags {:#?} and a size of {} bytes", heap.flags, heap.size);
    }
}

Trait Implementations

impl Debug for PhysicalDevice

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

Formats the value using the given formatter.

impl Default for PhysicalDevice

fn default() -> PhysicalDevice

Returns the “default value” for a type.