切片

pub fn cmd_pipeline_barrier(&self,
                            command_buffer: vk::CommandBuffer,
                            src_stage_mask: vk::PipelineStageFlags,
                            dst_stage_mask: vk::PipelineStageFlags,
                            dependency_flags: vk::DependencyFlags,
                            memory_barriers: &[vk::MemoryBarrier<'_>],
                            buffer_memory_barriers: &[vk::BufferMemoryBarrier<'_>],
                            image_memory_barriers: &[vk::ImageMemoryBarrier<'_>]);

强类型句柄

每个Vulkan句柄类型都作为具有改进类型安全的新类型结构体公开。可以使用 T::null() 构造空句柄，并且句柄可以自由地转换为 u64 并从 Handle::from_raw 和 Handle::as_raw 转换回来，以与非Ash Vulkan代码进行互操作。

构建者模式

let queue_info = [vk::DeviceQueueCreateInfo::default()
    .queue_family_index(queue_family_index)
    .queue_priorities(&priorities)];

let device_create_info = vk::DeviceCreateInfo::default()
    .queue_create_infos(&queue_info)
    .enabled_extension_names(&device_extension_names_raw)
    .enabled_features(&features);

let device: Device = instance
    .create_device(pdevice, &device_create_info, None)
    .unwrap();

指针链

使用 base.push_next(ext) 在 base 所附加的指针链前插入 ext。

let mut variable_pointers = vk::PhysicalDeviceVariablePointerFeatures::default();
let mut corner = vk::PhysicalDeviceCornerSampledImageFeaturesNV::default();

let mut device_create_info = vk::DeviceCreateInfo::default()
    .push_next(&mut corner)
    .push_next(&mut variable_pointers);

.push_next() 的泛型参数只允许有效的结构体扩展给定的结构体（在Vulkan注册表中称为 structextends，映射到 Extends* 特性）。只有列在任何 structextends 中的结构体才会实现 .push_next()。

// Bitflag
vk::AccessFlags::COLOR_ATTACHMENT_READ | vk::AccessFlags::COLOR_ATTACHMENT_WRITE

// Constant
vk::PipelineBindPoint::GRAPHICS,

let flag = vk::AccessFlags::COLOR_ATTACHMENT_READ
        | vk::AccessFlags::COLOR_ATTACHMENT_WRITE;
println!("Debug: {:?}", flag);
println!("Display: {}", flag);
// Prints:
// Debug: AccessFlags(110000000)
// Display: COLOR_ATTACHMENT_READ | COLOR_ATTACHMENT_WRITE

use ash::khr;
let swapchain_loader = khr::swapchain::Device::new(&instance, &device);
let swapchain = swapchain_loader.create_swapchain(&swapchain_create_info).unwrap();

device.fp_v1_0().destroy_device(...);

use ash::{ext, khr};
#[cfg(all(unix, not(target_os = "android")))]
fn extension_names() -> Vec<*const i8> {
    vec![
        khr::surface::NAME.as_ptr(),
        khr::xlib_surface::NAME.as_ptr(),
        ext::debug_utils::NAME.as_ptr(),
    ]
}

pub fn create_command_pool(&self,
                           create_info: &vk::CommandPoolCreateInfo<'_>)
                           -> VkResult<vk::CommandPool>;

let pool = device.create_command_pool(&pool_create_info).unwrap();

您可以在以下位置找到示例：这里。所有示例目前都需要：LunarG 验证层和一个在您的 PATH 中可见的 Vulkan 库。开始的一个简单方法是使用 LunarG Vulkan SDK

Windows

请确保您有可用的 Vulkan 驱动程序，并安装 LunarG Vulkan SDK。

Linux

安装您选择的图形硬件的 Vulkan 驱动程序，以及（可选）通过您的包管理器安装 验证层

• Arch Linux: https://wiki.archlinux.org/title/Vulkan.
• Gentoo: https://wiki.gentoo.org/wiki/Vulkan.
• Ubuntu/Debian: 除了安装兼容的图形驱动程序外，还要安装 vulkan-validationlayers（《Debian》Debian）以使用验证层。
• 其他发行版：请咨询您的发行版文档和/或软件包仓库以了解安装和使用 Vulkan 的首选方法。

macOS

安装 LunarG Vulkan SDK。安装程序默认将 SDK 放在 $HOME/VulkanSDK/<版本>。在运行 cargo 时，您需要设置以下环境变量

VULKAN_SDK=$HOME/VulkanSDK/<version>/macOS \
DYLD_FALLBACK_LIBRARY_PATH=$VULKAN_SDK/lib \
VK_ICD_FILENAMES=$VULKAN_SDK/share/vulkan/icd.d/MoltenVK_icd.json \
VK_LAYER_PATH=$VULKAN_SDK/share/vulkan/explicit_layer.d \
cargo run ...

三角形

显示带有顶点颜色的三角形。

cargo run -p ash-examples --bin triangle

纹理

在一个四边形上显示纹理。

cargo run -p ash-examples --bin texture

有用的资源

示例

• vulkan-tutorial-rust - vulkan-tutorial.com 的移植。
• ash-sample-progression - LunarG 示例的移植。
• ash-nv-rt 为 ash 的一个光线追踪示例。

实用库

• vk-sync - 使用 rust 编写的简化 Vulkan 同步逻辑。
• vk-mem-rs - 此 crate 提供了 FFI 层和用于出色的 AMD Vulkan 内存分配器 C/C++ 库的惯用 Rust 包装器。
• gpu-allocator - 使用纯 Rust 编写的针对 Vulkan 和 DirectX 12 的 GPU 内存分配器。
• lahar - 用于异步上传数据到 Vulkan 设备的工具。

使用 ash 的库

• gfx-rs - gfx-rs 是一个低级别、跨平台的图形抽象库，用 Rust 实现。

致谢

• Api without secrets
• Vulkan 教程
• Vulkan 示例
• Vulkan 教程
• Vulkano
• vk-rs