wgpu_hal/vulkan/
conv.rs

1use alloc::vec::Vec;
2
3use ash::vk;
4
5impl super::PrivateCapabilities {
6    pub fn map_texture_format(&self, format: wgt::TextureFormat) -> vk::Format {
7        use ash::vk::Format as F;
8        use wgt::TextureFormat as Tf;
9        use wgt::{AstcBlock, AstcChannel};
10        match format {
11            Tf::R8Unorm => F::R8_UNORM,
12            Tf::R8Snorm => F::R8_SNORM,
13            Tf::R8Uint => F::R8_UINT,
14            Tf::R8Sint => F::R8_SINT,
15            Tf::R16Uint => F::R16_UINT,
16            Tf::R16Sint => F::R16_SINT,
17            Tf::R16Unorm => F::R16_UNORM,
18            Tf::R16Snorm => F::R16_SNORM,
19            Tf::R16Float => F::R16_SFLOAT,
20            Tf::Rg8Unorm => F::R8G8_UNORM,
21            Tf::Rg8Snorm => F::R8G8_SNORM,
22            Tf::Rg8Uint => F::R8G8_UINT,
23            Tf::Rg8Sint => F::R8G8_SINT,
24            Tf::Rg16Unorm => F::R16G16_UNORM,
25            Tf::Rg16Snorm => F::R16G16_SNORM,
26            Tf::R32Uint => F::R32_UINT,
27            Tf::R32Sint => F::R32_SINT,
28            Tf::R32Float => F::R32_SFLOAT,
29            Tf::Rg16Uint => F::R16G16_UINT,
30            Tf::Rg16Sint => F::R16G16_SINT,
31            Tf::Rg16Float => F::R16G16_SFLOAT,
32            Tf::Rgba8Unorm => F::R8G8B8A8_UNORM,
33            Tf::Rgba8UnormSrgb => F::R8G8B8A8_SRGB,
34            Tf::Bgra8UnormSrgb => F::B8G8R8A8_SRGB,
35            Tf::Rgba8Snorm => F::R8G8B8A8_SNORM,
36            Tf::Bgra8Unorm => F::B8G8R8A8_UNORM,
37            Tf::Rgba8Uint => F::R8G8B8A8_UINT,
38            Tf::Rgba8Sint => F::R8G8B8A8_SINT,
39            Tf::Rgb10a2Uint => F::A2B10G10R10_UINT_PACK32,
40            Tf::Rgb10a2Unorm => F::A2B10G10R10_UNORM_PACK32,
41            Tf::Rg11b10Ufloat => F::B10G11R11_UFLOAT_PACK32,
42            Tf::R64Uint => F::R64_UINT,
43            Tf::Rg32Uint => F::R32G32_UINT,
44            Tf::Rg32Sint => F::R32G32_SINT,
45            Tf::Rg32Float => F::R32G32_SFLOAT,
46            Tf::Rgba16Uint => F::R16G16B16A16_UINT,
47            Tf::Rgba16Sint => F::R16G16B16A16_SINT,
48            Tf::Rgba16Unorm => F::R16G16B16A16_UNORM,
49            Tf::Rgba16Snorm => F::R16G16B16A16_SNORM,
50            Tf::Rgba16Float => F::R16G16B16A16_SFLOAT,
51            Tf::Rgba32Uint => F::R32G32B32A32_UINT,
52            Tf::Rgba32Sint => F::R32G32B32A32_SINT,
53            Tf::Rgba32Float => F::R32G32B32A32_SFLOAT,
54            Tf::Depth32Float => F::D32_SFLOAT,
55            Tf::Depth32FloatStencil8 => F::D32_SFLOAT_S8_UINT,
56            Tf::Depth24Plus => {
57                if self.texture_d24 {
58                    F::X8_D24_UNORM_PACK32
59                } else {
60                    F::D32_SFLOAT
61                }
62            }
63            Tf::Depth24PlusStencil8 => {
64                if self.texture_d24_s8 {
65                    F::D24_UNORM_S8_UINT
66                } else {
67                    F::D32_SFLOAT_S8_UINT
68                }
69            }
70            Tf::Stencil8 => {
71                if self.texture_s8 {
72                    F::S8_UINT
73                } else if self.texture_d24_s8 {
74                    F::D24_UNORM_S8_UINT
75                } else {
76                    F::D32_SFLOAT_S8_UINT
77                }
78            }
79            Tf::Depth16Unorm => F::D16_UNORM,
80            Tf::NV12 => F::G8_B8R8_2PLANE_420_UNORM,
81            Tf::P010 => F::G10X6_B10X6R10X6_2PLANE_420_UNORM_3PACK16,
82            Tf::Rgb9e5Ufloat => F::E5B9G9R9_UFLOAT_PACK32,
83            Tf::Bc1RgbaUnorm => F::BC1_RGBA_UNORM_BLOCK,
84            Tf::Bc1RgbaUnormSrgb => F::BC1_RGBA_SRGB_BLOCK,
85            Tf::Bc2RgbaUnorm => F::BC2_UNORM_BLOCK,
86            Tf::Bc2RgbaUnormSrgb => F::BC2_SRGB_BLOCK,
87            Tf::Bc3RgbaUnorm => F::BC3_UNORM_BLOCK,
88            Tf::Bc3RgbaUnormSrgb => F::BC3_SRGB_BLOCK,
89            Tf::Bc4RUnorm => F::BC4_UNORM_BLOCK,
90            Tf::Bc4RSnorm => F::BC4_SNORM_BLOCK,
91            Tf::Bc5RgUnorm => F::BC5_UNORM_BLOCK,
92            Tf::Bc5RgSnorm => F::BC5_SNORM_BLOCK,
93            Tf::Bc6hRgbUfloat => F::BC6H_UFLOAT_BLOCK,
94            Tf::Bc6hRgbFloat => F::BC6H_SFLOAT_BLOCK,
95            Tf::Bc7RgbaUnorm => F::BC7_UNORM_BLOCK,
96            Tf::Bc7RgbaUnormSrgb => F::BC7_SRGB_BLOCK,
97            Tf::Etc2Rgb8Unorm => F::ETC2_R8G8B8_UNORM_BLOCK,
98            Tf::Etc2Rgb8UnormSrgb => F::ETC2_R8G8B8_SRGB_BLOCK,
99            Tf::Etc2Rgb8A1Unorm => F::ETC2_R8G8B8A1_UNORM_BLOCK,
100            Tf::Etc2Rgb8A1UnormSrgb => F::ETC2_R8G8B8A1_SRGB_BLOCK,
101            Tf::Etc2Rgba8Unorm => F::ETC2_R8G8B8A8_UNORM_BLOCK,
102            Tf::Etc2Rgba8UnormSrgb => F::ETC2_R8G8B8A8_SRGB_BLOCK,
103            Tf::EacR11Unorm => F::EAC_R11_UNORM_BLOCK,
104            Tf::EacR11Snorm => F::EAC_R11_SNORM_BLOCK,
105            Tf::EacRg11Unorm => F::EAC_R11G11_UNORM_BLOCK,
106            Tf::EacRg11Snorm => F::EAC_R11G11_SNORM_BLOCK,
107            Tf::Astc { block, channel } => match channel {
108                AstcChannel::Unorm => match block {
109                    AstcBlock::B4x4 => F::ASTC_4X4_UNORM_BLOCK,
110                    AstcBlock::B5x4 => F::ASTC_5X4_UNORM_BLOCK,
111                    AstcBlock::B5x5 => F::ASTC_5X5_UNORM_BLOCK,
112                    AstcBlock::B6x5 => F::ASTC_6X5_UNORM_BLOCK,
113                    AstcBlock::B6x6 => F::ASTC_6X6_UNORM_BLOCK,
114                    AstcBlock::B8x5 => F::ASTC_8X5_UNORM_BLOCK,
115                    AstcBlock::B8x6 => F::ASTC_8X6_UNORM_BLOCK,
116                    AstcBlock::B8x8 => F::ASTC_8X8_UNORM_BLOCK,
117                    AstcBlock::B10x5 => F::ASTC_10X5_UNORM_BLOCK,
118                    AstcBlock::B10x6 => F::ASTC_10X6_UNORM_BLOCK,
119                    AstcBlock::B10x8 => F::ASTC_10X8_UNORM_BLOCK,
120                    AstcBlock::B10x10 => F::ASTC_10X10_UNORM_BLOCK,
121                    AstcBlock::B12x10 => F::ASTC_12X10_UNORM_BLOCK,
122                    AstcBlock::B12x12 => F::ASTC_12X12_UNORM_BLOCK,
123                },
124                AstcChannel::UnormSrgb => match block {
125                    AstcBlock::B4x4 => F::ASTC_4X4_SRGB_BLOCK,
126                    AstcBlock::B5x4 => F::ASTC_5X4_SRGB_BLOCK,
127                    AstcBlock::B5x5 => F::ASTC_5X5_SRGB_BLOCK,
128                    AstcBlock::B6x5 => F::ASTC_6X5_SRGB_BLOCK,
129                    AstcBlock::B6x6 => F::ASTC_6X6_SRGB_BLOCK,
130                    AstcBlock::B8x5 => F::ASTC_8X5_SRGB_BLOCK,
131                    AstcBlock::B8x6 => F::ASTC_8X6_SRGB_BLOCK,
132                    AstcBlock::B8x8 => F::ASTC_8X8_SRGB_BLOCK,
133                    AstcBlock::B10x5 => F::ASTC_10X5_SRGB_BLOCK,
134                    AstcBlock::B10x6 => F::ASTC_10X6_SRGB_BLOCK,
135                    AstcBlock::B10x8 => F::ASTC_10X8_SRGB_BLOCK,
136                    AstcBlock::B10x10 => F::ASTC_10X10_SRGB_BLOCK,
137                    AstcBlock::B12x10 => F::ASTC_12X10_SRGB_BLOCK,
138                    AstcBlock::B12x12 => F::ASTC_12X12_SRGB_BLOCK,
139                },
140                AstcChannel::Hdr => match block {
141                    AstcBlock::B4x4 => F::ASTC_4X4_SFLOAT_BLOCK_EXT,
142                    AstcBlock::B5x4 => F::ASTC_5X4_SFLOAT_BLOCK_EXT,
143                    AstcBlock::B5x5 => F::ASTC_5X5_SFLOAT_BLOCK_EXT,
144                    AstcBlock::B6x5 => F::ASTC_6X5_SFLOAT_BLOCK_EXT,
145                    AstcBlock::B6x6 => F::ASTC_6X6_SFLOAT_BLOCK_EXT,
146                    AstcBlock::B8x5 => F::ASTC_8X5_SFLOAT_BLOCK_EXT,
147                    AstcBlock::B8x6 => F::ASTC_8X6_SFLOAT_BLOCK_EXT,
148                    AstcBlock::B8x8 => F::ASTC_8X8_SFLOAT_BLOCK_EXT,
149                    AstcBlock::B10x5 => F::ASTC_10X5_SFLOAT_BLOCK_EXT,
150                    AstcBlock::B10x6 => F::ASTC_10X6_SFLOAT_BLOCK_EXT,
151                    AstcBlock::B10x8 => F::ASTC_10X8_SFLOAT_BLOCK_EXT,
152                    AstcBlock::B10x10 => F::ASTC_10X10_SFLOAT_BLOCK_EXT,
153                    AstcBlock::B12x10 => F::ASTC_12X10_SFLOAT_BLOCK_EXT,
154                    AstcBlock::B12x12 => F::ASTC_12X12_SFLOAT_BLOCK_EXT,
155                },
156            },
157        }
158    }
159}
160
161pub fn map_vk_surface_formats(
162    sf: vk::SurfaceFormatKHR,
163) -> Option<(wgt::TextureFormat, wgt::SurfaceColorSpace)> {
164    use ash::vk::Format as F;
165    use wgt::TextureFormat as Tf;
166    // Format list we care about pulled from https://vulkan.gpuinfo.org/listsurfaceformats.php.
167    let format = match sf.format {
168        F::B8G8R8A8_UNORM => Tf::Bgra8Unorm,
169        F::B8G8R8A8_SRGB => Tf::Bgra8UnormSrgb,
170        F::R8G8B8A8_SNORM => Tf::Rgba8Snorm,
171        F::R8G8B8A8_UNORM => Tf::Rgba8Unorm,
172        F::R8G8B8A8_SRGB => Tf::Rgba8UnormSrgb,
173        F::R16G16B16A16_SNORM => Tf::Rgba16Snorm,
174        F::R16G16B16A16_UNORM => Tf::Rgba16Unorm,
175        F::R16G16B16A16_SFLOAT => Tf::Rgba16Float,
176        F::A2B10G10R10_UNORM_PACK32 => Tf::Rgb10a2Unorm,
177        _ => return None,
178    };
179    let color_space = map_vk_color_space(sf.color_space)?;
180    Some((format, color_space))
181}
182
183pub fn map_vk_color_space(color_space: vk::ColorSpaceKHR) -> Option<wgt::SurfaceColorSpace> {
184    use wgt::SurfaceColorSpace as Scs;
185    Some(match color_space {
186        vk::ColorSpaceKHR::SRGB_NONLINEAR => Scs::Srgb,
187        vk::ColorSpaceKHR::EXTENDED_SRGB_LINEAR_EXT => Scs::ExtendedSrgbLinear,
188        vk::ColorSpaceKHR::EXTENDED_SRGB_NONLINEAR_EXT => Scs::ExtendedSrgb,
189        vk::ColorSpaceKHR::DISPLAY_P3_NONLINEAR_EXT => Scs::DisplayP3,
190        vk::ColorSpaceKHR::HDR10_ST2084_EXT => Scs::Bt2100Pq,
191        vk::ColorSpaceKHR::HDR10_HLG_EXT => Scs::Bt2100Hlg,
192        _ => return None,
193    })
194}
195
196pub fn map_surface_color_space(color_space: wgt::SurfaceColorSpace) -> vk::ColorSpaceKHR {
197    use wgt::SurfaceColorSpace as Scs;
198    match color_space {
199        Scs::Auto => unreachable!("wgpu-core resolves `Auto` before configuring the surface"),
200        Scs::Srgb => vk::ColorSpaceKHR::SRGB_NONLINEAR,
201        Scs::ExtendedSrgbLinear => vk::ColorSpaceKHR::EXTENDED_SRGB_LINEAR_EXT,
202        Scs::ExtendedSrgb => vk::ColorSpaceKHR::EXTENDED_SRGB_NONLINEAR_EXT,
203        Scs::DisplayP3 => vk::ColorSpaceKHR::DISPLAY_P3_NONLINEAR_EXT,
204        Scs::Bt2100Pq => vk::ColorSpaceKHR::HDR10_ST2084_EXT,
205        Scs::Bt2100Hlg => vk::ColorSpaceKHR::HDR10_HLG_EXT,
206        Scs::ExtendedDisplayP3 => {
207            unreachable!("`ExtendedDisplayP3` is never reported in the Vulkan surface capabilities")
208        }
209    }
210}
211
212impl crate::Attachment<'_, super::TextureView> {
213    pub(super) fn make_attachment_key(&self, ops: crate::AttachmentOps) -> super::AttachmentKey {
214        super::AttachmentKey {
215            format: self.view.raw_format,
216            layout: derive_image_layout(self.usage, self.view.format),
217            ops,
218        }
219    }
220}
221
222impl crate::ColorAttachment<'_, super::TextureView> {
223    pub(super) unsafe fn make_vk_clear_color(&self) -> vk::ClearColorValue {
224        let cv = &self.clear_value;
225        match self.target.view.format.sample_type(None, None).unwrap() {
226            wgt::TextureSampleType::Float { .. } => vk::ClearColorValue {
227                float32: [cv.r as f32, cv.g as f32, cv.b as f32, cv.a as f32],
228            },
229            wgt::TextureSampleType::Sint => vk::ClearColorValue {
230                int32: [cv.r as i32, cv.g as i32, cv.b as i32, cv.a as i32],
231            },
232            wgt::TextureSampleType::Uint => vk::ClearColorValue {
233                uint32: [cv.r as u32, cv.g as u32, cv.b as u32, cv.a as u32],
234            },
235            wgt::TextureSampleType::Depth => unreachable!(),
236        }
237    }
238}
239
240pub fn derive_image_layout(usage: wgt::TextureUses, format: wgt::TextureFormat) -> vk::ImageLayout {
241    let is_color = !format.is_depth_stencil_format();
242    match usage {
243        wgt::TextureUses::UNINITIALIZED => vk::ImageLayout::UNDEFINED,
244        wgt::TextureUses::COPY_SRC => vk::ImageLayout::TRANSFER_SRC_OPTIMAL,
245        wgt::TextureUses::COPY_DST => vk::ImageLayout::TRANSFER_DST_OPTIMAL,
246        wgt::TextureUses::RESOURCE if is_color => vk::ImageLayout::SHADER_READ_ONLY_OPTIMAL,
247        wgt::TextureUses::COLOR_TARGET => vk::ImageLayout::COLOR_ATTACHMENT_OPTIMAL,
248        _ => {
249            if usage == wgt::TextureUses::PRESENT {
250                vk::ImageLayout::PRESENT_SRC_KHR
251            } else if is_color {
252                vk::ImageLayout::GENERAL
253            } else {
254                match (
255                    usage.contains(wgt::TextureUses::DEPTH_WRITE),
256                    usage.contains(wgt::TextureUses::STENCIL_WRITE),
257                ) {
258                    (true, true) => vk::ImageLayout::DEPTH_STENCIL_ATTACHMENT_OPTIMAL,
259                    (false, true) => vk::ImageLayout::DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL,
260                    (true, false) => vk::ImageLayout::DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL,
261                    (false, false) => vk::ImageLayout::DEPTH_STENCIL_READ_ONLY_OPTIMAL,
262                }
263            }
264        }
265    }
266}
267
268pub fn map_queue_family(family: crate::QueueFamily) -> u32 {
269    match family {
270        crate::QueueFamily::Explicit(index) => index,
271        crate::QueueFamily::External => vk::QUEUE_FAMILY_EXTERNAL,
272        crate::QueueFamily::Foreign => vk::QUEUE_FAMILY_FOREIGN_EXT,
273    }
274}
275
276pub fn map_texture_usage(usage: wgt::TextureUses) -> vk::ImageUsageFlags {
277    let mut flags = vk::ImageUsageFlags::empty();
278    if usage.contains(wgt::TextureUses::COPY_SRC) {
279        flags |= vk::ImageUsageFlags::TRANSFER_SRC;
280    }
281    if usage.contains(wgt::TextureUses::COPY_DST) {
282        flags |= vk::ImageUsageFlags::TRANSFER_DST;
283    }
284    if usage.contains(wgt::TextureUses::RESOURCE) {
285        flags |= vk::ImageUsageFlags::SAMPLED;
286    }
287    if usage.contains(wgt::TextureUses::COLOR_TARGET) {
288        flags |= vk::ImageUsageFlags::COLOR_ATTACHMENT;
289    }
290    if usage.intersects(
291        wgt::TextureUses::DEPTH_READ
292            | wgt::TextureUses::DEPTH_WRITE
293            | wgt::TextureUses::STENCIL_READ
294            | wgt::TextureUses::STENCIL_WRITE,
295    ) {
296        flags |= vk::ImageUsageFlags::DEPTH_STENCIL_ATTACHMENT;
297    }
298    if usage.intersects(
299        wgt::TextureUses::STORAGE_READ_ONLY
300            | wgt::TextureUses::STORAGE_WRITE_ONLY
301            | wgt::TextureUses::STORAGE_READ_WRITE
302            | wgt::TextureUses::STORAGE_ATOMIC,
303    ) {
304        flags |= vk::ImageUsageFlags::STORAGE;
305    }
306    if usage.contains(wgt::TextureUses::TRANSIENT) {
307        flags |= vk::ImageUsageFlags::TRANSIENT_ATTACHMENT;
308    }
309    flags
310}
311
312pub fn map_texture_usage_to_barrier(
313    usage: wgt::TextureUses,
314    queue_flags: vk::QueueFlags,
315    support_store_op_none: bool,
316) -> (vk::PipelineStageFlags, vk::AccessFlags) {
317    let mut stages = vk::PipelineStageFlags::empty();
318    let mut access = vk::AccessFlags::empty();
319    let shader_stages = shader_stages(queue_flags);
320
321    if usage.contains(wgt::TextureUses::COPY_SRC) {
322        stages |= vk::PipelineStageFlags::TRANSFER;
323        access |= vk::AccessFlags::TRANSFER_READ;
324    }
325    if usage.contains(wgt::TextureUses::COPY_DST) {
326        stages |= vk::PipelineStageFlags::TRANSFER;
327        access |= vk::AccessFlags::TRANSFER_WRITE;
328    }
329    if usage.contains(wgt::TextureUses::RESOURCE) {
330        stages |= shader_stages;
331        access |= vk::AccessFlags::SHADER_READ;
332    }
333    if usage.contains(wgt::TextureUses::COLOR_TARGET) {
334        stages |= vk::PipelineStageFlags::COLOR_ATTACHMENT_OUTPUT;
335        access |= vk::AccessFlags::COLOR_ATTACHMENT_READ | vk::AccessFlags::COLOR_ATTACHMENT_WRITE;
336    }
337    if usage.intersects(wgt::TextureUses::DEPTH_READ | wgt::TextureUses::STENCIL_READ) {
338        stages |= vk::PipelineStageFlags::EARLY_FRAGMENT_TESTS
339            | vk::PipelineStageFlags::LATE_FRAGMENT_TESTS;
340        access |= if !support_store_op_none {
341            // If `vk::AttachmentStoreOp::NONE` isn't available we use `vk::AttachmentStoreOp::Store`
342            // for readonly depth-stencil attachments, which needs write access to avoid validation error.
343            vk::AccessFlags::DEPTH_STENCIL_ATTACHMENT_READ
344                | vk::AccessFlags::DEPTH_STENCIL_ATTACHMENT_WRITE
345        } else {
346            vk::AccessFlags::DEPTH_STENCIL_ATTACHMENT_READ
347        }
348    }
349    if usage.intersects(wgt::TextureUses::DEPTH_WRITE | wgt::TextureUses::STENCIL_WRITE) {
350        stages |= vk::PipelineStageFlags::EARLY_FRAGMENT_TESTS
351            | vk::PipelineStageFlags::LATE_FRAGMENT_TESTS;
352        access |= vk::AccessFlags::DEPTH_STENCIL_ATTACHMENT_READ
353            | vk::AccessFlags::DEPTH_STENCIL_ATTACHMENT_WRITE;
354    }
355    if usage.intersects(
356        wgt::TextureUses::STORAGE_READ_ONLY
357            | wgt::TextureUses::STORAGE_READ_WRITE
358            | wgt::TextureUses::STORAGE_ATOMIC,
359    ) {
360        stages |= shader_stages;
361        access |= vk::AccessFlags::SHADER_READ;
362    }
363    if usage.intersects(
364        wgt::TextureUses::STORAGE_WRITE_ONLY
365            | wgt::TextureUses::STORAGE_READ_WRITE
366            | wgt::TextureUses::STORAGE_ATOMIC,
367    ) {
368        stages |= shader_stages;
369        access |= vk::AccessFlags::SHADER_WRITE;
370    }
371
372    if usage == wgt::TextureUses::UNINITIALIZED || usage == wgt::TextureUses::PRESENT {
373        (
374            vk::PipelineStageFlags::TOP_OF_PIPE,
375            vk::AccessFlags::empty(),
376        )
377    } else {
378        (stages, access)
379    }
380}
381
382pub fn map_vk_image_usage(usage: vk::ImageUsageFlags) -> wgt::TextureUses {
383    let mut bits = wgt::TextureUses::empty();
384    if usage.contains(vk::ImageUsageFlags::TRANSFER_SRC) {
385        bits |= wgt::TextureUses::COPY_SRC;
386    }
387    if usage.contains(vk::ImageUsageFlags::TRANSFER_DST) {
388        bits |= wgt::TextureUses::COPY_DST;
389    }
390    if usage.contains(vk::ImageUsageFlags::SAMPLED) {
391        bits |= wgt::TextureUses::RESOURCE;
392    }
393    if usage.contains(vk::ImageUsageFlags::COLOR_ATTACHMENT) {
394        bits |= wgt::TextureUses::COLOR_TARGET;
395    }
396    if usage.contains(vk::ImageUsageFlags::DEPTH_STENCIL_ATTACHMENT) {
397        bits |= wgt::TextureUses::DEPTH_READ
398            | wgt::TextureUses::DEPTH_WRITE
399            | wgt::TextureUses::STENCIL_READ
400            | wgt::TextureUses::STENCIL_WRITE;
401    }
402    if usage.contains(vk::ImageUsageFlags::STORAGE) {
403        bits |= wgt::TextureUses::STORAGE_READ_ONLY
404            | wgt::TextureUses::STORAGE_WRITE_ONLY
405            | wgt::TextureUses::STORAGE_READ_WRITE
406            | wgt::TextureUses::STORAGE_ATOMIC;
407    }
408    if usage.contains(vk::ImageUsageFlags::TRANSIENT_ATTACHMENT) {
409        bits |= wgt::TextureUses::TRANSIENT;
410    }
411    bits
412}
413
414pub fn map_texture_dimension(dim: wgt::TextureDimension) -> vk::ImageType {
415    match dim {
416        wgt::TextureDimension::D1 => vk::ImageType::TYPE_1D,
417        wgt::TextureDimension::D2 => vk::ImageType::TYPE_2D,
418        wgt::TextureDimension::D3 => vk::ImageType::TYPE_3D,
419    }
420}
421
422pub fn map_index_format(index_format: wgt::IndexFormat) -> vk::IndexType {
423    match index_format {
424        wgt::IndexFormat::Uint16 => vk::IndexType::UINT16,
425        wgt::IndexFormat::Uint32 => vk::IndexType::UINT32,
426    }
427}
428
429pub fn map_vertex_format(vertex_format: wgt::VertexFormat) -> vk::Format {
430    use wgt::VertexFormat as Vf;
431    match vertex_format {
432        Vf::Uint8 => vk::Format::R8_UINT,
433        Vf::Uint8x2 => vk::Format::R8G8_UINT,
434        Vf::Uint8x4 => vk::Format::R8G8B8A8_UINT,
435        Vf::Sint8 => vk::Format::R8_SINT,
436        Vf::Sint8x2 => vk::Format::R8G8_SINT,
437        Vf::Sint8x4 => vk::Format::R8G8B8A8_SINT,
438        Vf::Unorm8 => vk::Format::R8_UNORM,
439        Vf::Unorm8x2 => vk::Format::R8G8_UNORM,
440        Vf::Unorm8x4 => vk::Format::R8G8B8A8_UNORM,
441        Vf::Snorm8 => vk::Format::R8_SNORM,
442        Vf::Snorm8x2 => vk::Format::R8G8_SNORM,
443        Vf::Snorm8x4 => vk::Format::R8G8B8A8_SNORM,
444        Vf::Uint16 => vk::Format::R16_UINT,
445        Vf::Uint16x2 => vk::Format::R16G16_UINT,
446        Vf::Uint16x4 => vk::Format::R16G16B16A16_UINT,
447        Vf::Sint16 => vk::Format::R16_SINT,
448        Vf::Sint16x2 => vk::Format::R16G16_SINT,
449        Vf::Sint16x4 => vk::Format::R16G16B16A16_SINT,
450        Vf::Unorm16 => vk::Format::R16_UNORM,
451        Vf::Unorm16x2 => vk::Format::R16G16_UNORM,
452        Vf::Unorm16x4 => vk::Format::R16G16B16A16_UNORM,
453        Vf::Snorm16 => vk::Format::R16_SNORM,
454        Vf::Snorm16x2 => vk::Format::R16G16_SNORM,
455        Vf::Snorm16x4 => vk::Format::R16G16B16A16_SNORM,
456        Vf::Float16 => vk::Format::R16_SFLOAT,
457        Vf::Float16x2 => vk::Format::R16G16_SFLOAT,
458        Vf::Float16x4 => vk::Format::R16G16B16A16_SFLOAT,
459        Vf::Float32 => vk::Format::R32_SFLOAT,
460        Vf::Float32x2 => vk::Format::R32G32_SFLOAT,
461        Vf::Float32x3 => vk::Format::R32G32B32_SFLOAT,
462        Vf::Float32x4 => vk::Format::R32G32B32A32_SFLOAT,
463        Vf::Uint32 => vk::Format::R32_UINT,
464        Vf::Uint32x2 => vk::Format::R32G32_UINT,
465        Vf::Uint32x3 => vk::Format::R32G32B32_UINT,
466        Vf::Uint32x4 => vk::Format::R32G32B32A32_UINT,
467        Vf::Sint32 => vk::Format::R32_SINT,
468        Vf::Sint32x2 => vk::Format::R32G32_SINT,
469        Vf::Sint32x3 => vk::Format::R32G32B32_SINT,
470        Vf::Sint32x4 => vk::Format::R32G32B32A32_SINT,
471        Vf::Float64 => vk::Format::R64_SFLOAT,
472        Vf::Float64x2 => vk::Format::R64G64_SFLOAT,
473        Vf::Float64x3 => vk::Format::R64G64B64_SFLOAT,
474        Vf::Float64x4 => vk::Format::R64G64B64A64_SFLOAT,
475        Vf::Unorm10_10_10_2 => vk::Format::A2B10G10R10_UNORM_PACK32,
476        Vf::Unorm8x4Bgra => vk::Format::B8G8R8A8_UNORM,
477    }
478}
479
480pub fn map_aspects(aspects: crate::FormatAspects) -> vk::ImageAspectFlags {
481    let mut flags = vk::ImageAspectFlags::empty();
482    if aspects.contains(crate::FormatAspects::COLOR) {
483        flags |= vk::ImageAspectFlags::COLOR;
484    }
485    if aspects.contains(crate::FormatAspects::DEPTH) {
486        flags |= vk::ImageAspectFlags::DEPTH;
487    }
488    if aspects.contains(crate::FormatAspects::STENCIL) {
489        flags |= vk::ImageAspectFlags::STENCIL;
490    }
491    if aspects.contains(crate::FormatAspects::PLANE_0) {
492        flags |= vk::ImageAspectFlags::PLANE_0;
493    }
494    if aspects.contains(crate::FormatAspects::PLANE_1) {
495        flags |= vk::ImageAspectFlags::PLANE_1;
496    }
497    if aspects.contains(crate::FormatAspects::PLANE_2) {
498        flags |= vk::ImageAspectFlags::PLANE_2;
499    }
500    flags
501}
502
503pub fn map_attachment_ops(
504    op: crate::AttachmentOps,
505) -> (vk::AttachmentLoadOp, vk::AttachmentStoreOp) {
506    let load_op = if op.contains(crate::AttachmentOps::LOAD) {
507        vk::AttachmentLoadOp::LOAD
508    } else if op.contains(crate::AttachmentOps::LOAD_DONT_CARE) {
509        vk::AttachmentLoadOp::DONT_CARE
510    } else if op.contains(crate::AttachmentOps::LOAD_CLEAR) {
511        vk::AttachmentLoadOp::CLEAR
512    } else {
513        unreachable!()
514    };
515    let store_op = if op.contains(crate::AttachmentOps::STORE) {
516        vk::AttachmentStoreOp::STORE
517    } else if op.contains(crate::AttachmentOps::STORE_DISCARD) {
518        vk::AttachmentStoreOp::DONT_CARE
519    } else {
520        unreachable!()
521    };
522    (load_op, store_op)
523}
524
525pub fn map_present_mode(mode: wgt::PresentMode) -> vk::PresentModeKHR {
526    match mode {
527        wgt::PresentMode::Immediate => vk::PresentModeKHR::IMMEDIATE,
528        wgt::PresentMode::Mailbox => vk::PresentModeKHR::MAILBOX,
529        wgt::PresentMode::Fifo => vk::PresentModeKHR::FIFO,
530        wgt::PresentMode::FifoRelaxed => vk::PresentModeKHR::FIFO_RELAXED,
531        wgt::PresentMode::AutoNoVsync | wgt::PresentMode::AutoVsync => {
532            unreachable!("Cannot create swapchain with Auto PresentationMode")
533        }
534    }
535}
536
537pub fn map_vk_present_mode(mode: vk::PresentModeKHR) -> Option<wgt::PresentMode> {
538    // Not exposed in Ash yet.
539    const FIFO_LATEST_READY: vk::PresentModeKHR = vk::PresentModeKHR::from_raw(1_000_361_000);
540
541    // See https://registry.khronos.org/vulkan/specs/latest/man/html/VkPresentModeKHR.html
542    match mode {
543        vk::PresentModeKHR::IMMEDIATE => Some(wgt::PresentMode::Immediate),
544        vk::PresentModeKHR::MAILBOX => Some(wgt::PresentMode::Mailbox),
545        vk::PresentModeKHR::FIFO => Some(wgt::PresentMode::Fifo),
546        vk::PresentModeKHR::FIFO_RELAXED => Some(wgt::PresentMode::FifoRelaxed),
547
548        // Modes that aren't exposed yet.
549        vk::PresentModeKHR::SHARED_DEMAND_REFRESH => None,
550        vk::PresentModeKHR::SHARED_CONTINUOUS_REFRESH => None,
551        FIFO_LATEST_READY => None,
552
553        _ => {
554            log::debug!("Unrecognized present mode {mode:?}");
555            None
556        }
557    }
558}
559
560pub fn map_composite_alpha_mode(mode: wgt::CompositeAlphaMode) -> vk::CompositeAlphaFlagsKHR {
561    match mode {
562        wgt::CompositeAlphaMode::Opaque => vk::CompositeAlphaFlagsKHR::OPAQUE,
563        wgt::CompositeAlphaMode::PreMultiplied => vk::CompositeAlphaFlagsKHR::PRE_MULTIPLIED,
564        wgt::CompositeAlphaMode::PostMultiplied => vk::CompositeAlphaFlagsKHR::POST_MULTIPLIED,
565        wgt::CompositeAlphaMode::Inherit => vk::CompositeAlphaFlagsKHR::INHERIT,
566        wgt::CompositeAlphaMode::Auto => unreachable!(),
567    }
568}
569
570pub fn map_vk_composite_alpha(flags: vk::CompositeAlphaFlagsKHR) -> Vec<wgt::CompositeAlphaMode> {
571    let mut modes = Vec::new();
572    if flags.contains(vk::CompositeAlphaFlagsKHR::OPAQUE) {
573        modes.push(wgt::CompositeAlphaMode::Opaque);
574    }
575    if flags.contains(vk::CompositeAlphaFlagsKHR::PRE_MULTIPLIED) {
576        modes.push(wgt::CompositeAlphaMode::PreMultiplied);
577    }
578    if flags.contains(vk::CompositeAlphaFlagsKHR::POST_MULTIPLIED) {
579        modes.push(wgt::CompositeAlphaMode::PostMultiplied);
580    }
581    if flags.contains(vk::CompositeAlphaFlagsKHR::INHERIT) {
582        modes.push(wgt::CompositeAlphaMode::Inherit);
583    }
584    modes
585}
586
587pub fn map_buffer_usage(usage: wgt::BufferUses) -> vk::BufferUsageFlags {
588    let mut flags = vk::BufferUsageFlags::empty();
589    if usage.contains(wgt::BufferUses::COPY_SRC) {
590        flags |= vk::BufferUsageFlags::TRANSFER_SRC;
591    }
592    if usage.contains(wgt::BufferUses::COPY_DST) {
593        flags |= vk::BufferUsageFlags::TRANSFER_DST;
594    }
595    if usage.contains(wgt::BufferUses::UNIFORM) {
596        flags |= vk::BufferUsageFlags::UNIFORM_BUFFER;
597    }
598    if usage.intersects(wgt::BufferUses::STORAGE_READ_ONLY | wgt::BufferUses::STORAGE_READ_WRITE) {
599        flags |= vk::BufferUsageFlags::STORAGE_BUFFER;
600    }
601    if usage.contains(wgt::BufferUses::INDEX) {
602        flags |= vk::BufferUsageFlags::INDEX_BUFFER;
603    }
604    if usage.contains(wgt::BufferUses::VERTEX) {
605        flags |= vk::BufferUsageFlags::VERTEX_BUFFER;
606    }
607    if usage.contains(wgt::BufferUses::INDIRECT) {
608        flags |= vk::BufferUsageFlags::INDIRECT_BUFFER;
609    }
610    if usage.contains(wgt::BufferUses::ACCELERATION_STRUCTURE_SCRATCH) {
611        flags |= vk::BufferUsageFlags::STORAGE_BUFFER | vk::BufferUsageFlags::SHADER_DEVICE_ADDRESS;
612    }
613    if usage.intersects(
614        wgt::BufferUses::BOTTOM_LEVEL_ACCELERATION_STRUCTURE_INPUT
615            | wgt::BufferUses::TOP_LEVEL_ACCELERATION_STRUCTURE_INPUT,
616    ) {
617        flags |= vk::BufferUsageFlags::ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_KHR
618            | vk::BufferUsageFlags::SHADER_DEVICE_ADDRESS;
619    }
620    if usage.intersects(wgt::BufferUses::ACCELERATION_STRUCTURE_QUERY) {
621        flags |= vk::BufferUsageFlags::TRANSFER_DST;
622    }
623    if usage.intersects(wgt::BufferUses::RAY_TRACING_PIPELINE_SHADER_DATA) {
624        flags |= vk::BufferUsageFlags::SHADER_BINDING_TABLE_KHR
625            | vk::BufferUsageFlags::SHADER_DEVICE_ADDRESS;
626    }
627    flags
628}
629
630pub fn map_buffer_usage_to_barrier(
631    usage: wgt::BufferUses,
632    queue_flags: vk::QueueFlags,
633) -> (vk::PipelineStageFlags, vk::AccessFlags) {
634    let mut stages = vk::PipelineStageFlags::empty();
635    let mut access = vk::AccessFlags::empty();
636    let shader_stages = shader_stages(queue_flags);
637
638    if usage.contains(wgt::BufferUses::MAP_READ) {
639        stages |= vk::PipelineStageFlags::HOST;
640        access |= vk::AccessFlags::HOST_READ;
641    }
642    if usage.contains(wgt::BufferUses::MAP_WRITE) {
643        stages |= vk::PipelineStageFlags::HOST;
644        access |= vk::AccessFlags::HOST_WRITE;
645    }
646    if usage.contains(wgt::BufferUses::COPY_SRC) {
647        stages |= vk::PipelineStageFlags::TRANSFER;
648        access |= vk::AccessFlags::TRANSFER_READ;
649    }
650    if usage.contains(wgt::BufferUses::COPY_DST) {
651        stages |= vk::PipelineStageFlags::TRANSFER;
652        access |= vk::AccessFlags::TRANSFER_WRITE;
653    }
654    if usage.contains(wgt::BufferUses::UNIFORM) {
655        stages |= shader_stages;
656        access |= vk::AccessFlags::UNIFORM_READ;
657    }
658    if usage.intersects(wgt::BufferUses::STORAGE_READ_ONLY) {
659        stages |= shader_stages;
660        access |= vk::AccessFlags::SHADER_READ;
661    }
662    if usage.intersects(wgt::BufferUses::STORAGE_READ_WRITE) {
663        stages |= shader_stages;
664        access |= vk::AccessFlags::SHADER_READ | vk::AccessFlags::SHADER_WRITE;
665    }
666    if usage.contains(wgt::BufferUses::INDEX) {
667        stages |= vk::PipelineStageFlags::VERTEX_INPUT;
668        access |= vk::AccessFlags::INDEX_READ;
669    }
670    if usage.contains(wgt::BufferUses::VERTEX) {
671        stages |= vk::PipelineStageFlags::VERTEX_INPUT;
672        access |= vk::AccessFlags::VERTEX_ATTRIBUTE_READ;
673    }
674    if usage.contains(wgt::BufferUses::INDIRECT) {
675        stages |= vk::PipelineStageFlags::DRAW_INDIRECT;
676        access |= vk::AccessFlags::INDIRECT_COMMAND_READ;
677    }
678    if usage.intersects(
679        wgt::BufferUses::BOTTOM_LEVEL_ACCELERATION_STRUCTURE_INPUT
680            | wgt::BufferUses::TOP_LEVEL_ACCELERATION_STRUCTURE_INPUT
681            | wgt::BufferUses::ACCELERATION_STRUCTURE_SCRATCH,
682    ) {
683        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
684        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR
685            | vk::AccessFlags::ACCELERATION_STRUCTURE_WRITE_KHR
686            | vk::AccessFlags::SHADER_READ;
687    }
688    if usage.contains(wgt::BufferUses::ACCELERATION_STRUCTURE_QUERY) {
689        stages |= vk::PipelineStageFlags::TRANSFER;
690        access |= vk::AccessFlags::TRANSFER_WRITE;
691    }
692
693    (stages, access)
694}
695
696fn shader_stages(queue_flags: vk::QueueFlags) -> vk::PipelineStageFlags {
697    let mut stages = vk::PipelineStageFlags::empty();
698
699    if queue_flags.contains(vk::QueueFlags::GRAPHICS) {
700        stages |= vk::PipelineStageFlags::VERTEX_SHADER | vk::PipelineStageFlags::FRAGMENT_SHADER;
701    }
702    if queue_flags.contains(vk::QueueFlags::COMPUTE) {
703        stages |= vk::PipelineStageFlags::COMPUTE_SHADER;
704    }
705
706    stages
707}
708
709pub fn map_view_dimension(dim: wgt::TextureViewDimension) -> vk::ImageViewType {
710    match dim {
711        wgt::TextureViewDimension::D1 => vk::ImageViewType::TYPE_1D,
712        wgt::TextureViewDimension::D2 => vk::ImageViewType::TYPE_2D,
713        wgt::TextureViewDimension::D2Array => vk::ImageViewType::TYPE_2D_ARRAY,
714        wgt::TextureViewDimension::Cube => vk::ImageViewType::CUBE,
715        wgt::TextureViewDimension::CubeArray => vk::ImageViewType::CUBE_ARRAY,
716        wgt::TextureViewDimension::D3 => vk::ImageViewType::TYPE_3D,
717    }
718}
719
720pub fn map_copy_extent(extent: &crate::CopyExtent) -> vk::Extent3D {
721    vk::Extent3D {
722        width: extent.width,
723        height: extent.height,
724        depth: extent.depth,
725    }
726}
727
728pub fn map_subresource_range(
729    range: &wgt::ImageSubresourceRange,
730    format: wgt::TextureFormat,
731) -> vk::ImageSubresourceRange {
732    vk::ImageSubresourceRange {
733        aspect_mask: map_aspects(crate::FormatAspects::new(format, range.aspect)),
734        base_mip_level: range.base_mip_level,
735        level_count: range.mip_level_count.unwrap_or(vk::REMAINING_MIP_LEVELS),
736        base_array_layer: range.base_array_layer,
737        layer_count: range
738            .array_layer_count
739            .unwrap_or(vk::REMAINING_ARRAY_LAYERS),
740    }
741}
742
743// Special subresource range mapping for dealing with barriers
744// so that we account for the "hidden" depth aspect in emulated Stencil8.
745pub(super) fn map_subresource_range_combined_aspect(
746    range: &wgt::ImageSubresourceRange,
747    format: wgt::TextureFormat,
748    private_caps: &super::PrivateCapabilities,
749) -> vk::ImageSubresourceRange {
750    let mut range = map_subresource_range(range, format);
751    if !private_caps.texture_s8 && format == wgt::TextureFormat::Stencil8 {
752        range.aspect_mask |= vk::ImageAspectFlags::DEPTH;
753    }
754    range
755}
756
757pub fn map_subresource_layers(
758    base: &crate::TextureCopyBase,
759) -> (vk::ImageSubresourceLayers, vk::Offset3D) {
760    let offset = vk::Offset3D {
761        x: base.origin.x as i32,
762        y: base.origin.y as i32,
763        z: base.origin.z as i32,
764    };
765    let subresource = vk::ImageSubresourceLayers {
766        aspect_mask: map_aspects(base.aspect),
767        mip_level: base.mip_level,
768        base_array_layer: base.array_layer,
769        layer_count: 1,
770    };
771    (subresource, offset)
772}
773
774pub fn map_filter_mode(mode: wgt::FilterMode) -> vk::Filter {
775    match mode {
776        wgt::FilterMode::Nearest => vk::Filter::NEAREST,
777        wgt::FilterMode::Linear => vk::Filter::LINEAR,
778    }
779}
780
781pub fn map_mip_filter_mode(mode: wgt::MipmapFilterMode) -> vk::SamplerMipmapMode {
782    match mode {
783        wgt::MipmapFilterMode::Nearest => vk::SamplerMipmapMode::NEAREST,
784        wgt::MipmapFilterMode::Linear => vk::SamplerMipmapMode::LINEAR,
785    }
786}
787
788pub fn map_address_mode(mode: wgt::AddressMode) -> vk::SamplerAddressMode {
789    match mode {
790        wgt::AddressMode::ClampToEdge => vk::SamplerAddressMode::CLAMP_TO_EDGE,
791        wgt::AddressMode::Repeat => vk::SamplerAddressMode::REPEAT,
792        wgt::AddressMode::MirrorRepeat => vk::SamplerAddressMode::MIRRORED_REPEAT,
793        wgt::AddressMode::ClampToBorder => vk::SamplerAddressMode::CLAMP_TO_BORDER,
794        // wgt::AddressMode::MirrorClamp => vk::SamplerAddressMode::MIRROR_CLAMP_TO_EDGE,
795    }
796}
797
798pub fn map_border_color(border_color: wgt::SamplerBorderColor) -> vk::BorderColor {
799    match border_color {
800        wgt::SamplerBorderColor::TransparentBlack | wgt::SamplerBorderColor::Zero => {
801            vk::BorderColor::FLOAT_TRANSPARENT_BLACK
802        }
803        wgt::SamplerBorderColor::OpaqueBlack => vk::BorderColor::FLOAT_OPAQUE_BLACK,
804        wgt::SamplerBorderColor::OpaqueWhite => vk::BorderColor::FLOAT_OPAQUE_WHITE,
805    }
806}
807
808pub fn map_comparison(fun: wgt::CompareFunction) -> vk::CompareOp {
809    use wgt::CompareFunction as Cf;
810    match fun {
811        Cf::Never => vk::CompareOp::NEVER,
812        Cf::Less => vk::CompareOp::LESS,
813        Cf::LessEqual => vk::CompareOp::LESS_OR_EQUAL,
814        Cf::Equal => vk::CompareOp::EQUAL,
815        Cf::GreaterEqual => vk::CompareOp::GREATER_OR_EQUAL,
816        Cf::Greater => vk::CompareOp::GREATER,
817        Cf::NotEqual => vk::CompareOp::NOT_EQUAL,
818        Cf::Always => vk::CompareOp::ALWAYS,
819    }
820}
821
822pub fn map_shader_stage(stage: wgt::ShaderStages) -> vk::ShaderStageFlags {
823    let mut flags = vk::ShaderStageFlags::empty();
824    if stage.contains(wgt::ShaderStages::VERTEX) {
825        flags |= vk::ShaderStageFlags::VERTEX;
826    }
827    if stage.contains(wgt::ShaderStages::FRAGMENT) {
828        flags |= vk::ShaderStageFlags::FRAGMENT;
829    }
830    if stage.contains(wgt::ShaderStages::COMPUTE) {
831        flags |= vk::ShaderStageFlags::COMPUTE;
832    }
833    if stage.contains(wgt::ShaderStages::TASK) {
834        flags |= vk::ShaderStageFlags::TASK_EXT;
835    }
836    if stage.contains(wgt::ShaderStages::MESH) {
837        flags |= vk::ShaderStageFlags::MESH_EXT;
838    }
839    if stage.contains(wgt::ShaderStages::RAY_GENERATION) {
840        flags |= vk::ShaderStageFlags::RAYGEN_KHR;
841    }
842    if stage.contains(wgt::ShaderStages::MISS) {
843        flags |= vk::ShaderStageFlags::MISS_KHR;
844    }
845    if stage.contains(wgt::ShaderStages::ANY_HIT) {
846        flags |= vk::ShaderStageFlags::ANY_HIT_KHR;
847    }
848    if stage.contains(wgt::ShaderStages::CLOSEST_HIT) {
849        flags |= vk::ShaderStageFlags::CLOSEST_HIT_KHR;
850    }
851    flags
852}
853
854pub fn map_binding_type(ty: wgt::BindingType) -> vk::DescriptorType {
855    match ty {
856        wgt::BindingType::Buffer {
857            ty,
858            has_dynamic_offset,
859            ..
860        } => match ty {
861            wgt::BufferBindingType::Storage { .. } => match has_dynamic_offset {
862                true => vk::DescriptorType::STORAGE_BUFFER_DYNAMIC,
863                false => vk::DescriptorType::STORAGE_BUFFER,
864            },
865            wgt::BufferBindingType::Uniform => match has_dynamic_offset {
866                true => vk::DescriptorType::UNIFORM_BUFFER_DYNAMIC,
867                false => vk::DescriptorType::UNIFORM_BUFFER,
868            },
869        },
870        wgt::BindingType::Sampler { .. } => vk::DescriptorType::SAMPLER,
871        wgt::BindingType::Texture { .. } => vk::DescriptorType::SAMPLED_IMAGE,
872        wgt::BindingType::StorageTexture { .. } => vk::DescriptorType::STORAGE_IMAGE,
873        wgt::BindingType::AccelerationStructure { .. } => {
874            vk::DescriptorType::ACCELERATION_STRUCTURE_KHR
875        }
876        wgt::BindingType::ExternalTexture => unimplemented!(),
877    }
878}
879
880pub fn map_topology(topology: wgt::PrimitiveTopology) -> vk::PrimitiveTopology {
881    use wgt::PrimitiveTopology as Pt;
882    match topology {
883        Pt::PointList => vk::PrimitiveTopology::POINT_LIST,
884        Pt::LineList => vk::PrimitiveTopology::LINE_LIST,
885        Pt::LineStrip => vk::PrimitiveTopology::LINE_STRIP,
886        Pt::TriangleList => vk::PrimitiveTopology::TRIANGLE_LIST,
887        Pt::TriangleStrip => vk::PrimitiveTopology::TRIANGLE_STRIP,
888    }
889}
890
891pub fn map_polygon_mode(mode: wgt::PolygonMode) -> vk::PolygonMode {
892    match mode {
893        wgt::PolygonMode::Fill => vk::PolygonMode::FILL,
894        wgt::PolygonMode::Line => vk::PolygonMode::LINE,
895        wgt::PolygonMode::Point => vk::PolygonMode::POINT,
896    }
897}
898
899pub fn map_front_face(front_face: wgt::FrontFace) -> vk::FrontFace {
900    match front_face {
901        wgt::FrontFace::Cw => vk::FrontFace::CLOCKWISE,
902        wgt::FrontFace::Ccw => vk::FrontFace::COUNTER_CLOCKWISE,
903    }
904}
905
906pub fn map_cull_face(face: wgt::Face) -> vk::CullModeFlags {
907    match face {
908        wgt::Face::Front => vk::CullModeFlags::FRONT,
909        wgt::Face::Back => vk::CullModeFlags::BACK,
910    }
911}
912
913pub fn map_stencil_op(op: wgt::StencilOperation) -> vk::StencilOp {
914    use wgt::StencilOperation as So;
915    match op {
916        So::Keep => vk::StencilOp::KEEP,
917        So::Zero => vk::StencilOp::ZERO,
918        So::Replace => vk::StencilOp::REPLACE,
919        So::Invert => vk::StencilOp::INVERT,
920        So::IncrementClamp => vk::StencilOp::INCREMENT_AND_CLAMP,
921        So::IncrementWrap => vk::StencilOp::INCREMENT_AND_WRAP,
922        So::DecrementClamp => vk::StencilOp::DECREMENT_AND_CLAMP,
923        So::DecrementWrap => vk::StencilOp::DECREMENT_AND_WRAP,
924    }
925}
926
927pub fn map_stencil_face(
928    face: &wgt::StencilFaceState,
929    compare_mask: u32,
930    write_mask: u32,
931) -> vk::StencilOpState {
932    vk::StencilOpState {
933        fail_op: map_stencil_op(face.fail_op),
934        pass_op: map_stencil_op(face.pass_op),
935        depth_fail_op: map_stencil_op(face.depth_fail_op),
936        compare_op: map_comparison(face.compare),
937        compare_mask,
938        write_mask,
939        reference: 0,
940    }
941}
942
943fn map_blend_factor(factor: wgt::BlendFactor) -> vk::BlendFactor {
944    use wgt::BlendFactor as Bf;
945    match factor {
946        Bf::Zero => vk::BlendFactor::ZERO,
947        Bf::One => vk::BlendFactor::ONE,
948        Bf::Src => vk::BlendFactor::SRC_COLOR,
949        Bf::OneMinusSrc => vk::BlendFactor::ONE_MINUS_SRC_COLOR,
950        Bf::SrcAlpha => vk::BlendFactor::SRC_ALPHA,
951        Bf::OneMinusSrcAlpha => vk::BlendFactor::ONE_MINUS_SRC_ALPHA,
952        Bf::Dst => vk::BlendFactor::DST_COLOR,
953        Bf::OneMinusDst => vk::BlendFactor::ONE_MINUS_DST_COLOR,
954        Bf::DstAlpha => vk::BlendFactor::DST_ALPHA,
955        Bf::OneMinusDstAlpha => vk::BlendFactor::ONE_MINUS_DST_ALPHA,
956        Bf::SrcAlphaSaturated => vk::BlendFactor::SRC_ALPHA_SATURATE,
957        Bf::Constant => vk::BlendFactor::CONSTANT_COLOR,
958        Bf::OneMinusConstant => vk::BlendFactor::ONE_MINUS_CONSTANT_COLOR,
959        Bf::Src1 => vk::BlendFactor::SRC1_COLOR,
960        Bf::OneMinusSrc1 => vk::BlendFactor::ONE_MINUS_SRC1_COLOR,
961        Bf::Src1Alpha => vk::BlendFactor::SRC1_ALPHA,
962        Bf::OneMinusSrc1Alpha => vk::BlendFactor::ONE_MINUS_SRC1_ALPHA,
963    }
964}
965
966fn map_blend_op(operation: wgt::BlendOperation) -> vk::BlendOp {
967    use wgt::BlendOperation as Bo;
968    match operation {
969        Bo::Add => vk::BlendOp::ADD,
970        Bo::Subtract => vk::BlendOp::SUBTRACT,
971        Bo::ReverseSubtract => vk::BlendOp::REVERSE_SUBTRACT,
972        Bo::Min => vk::BlendOp::MIN,
973        Bo::Max => vk::BlendOp::MAX,
974    }
975}
976
977pub fn map_blend_component(
978    component: &wgt::BlendComponent,
979) -> (vk::BlendOp, vk::BlendFactor, vk::BlendFactor) {
980    let op = map_blend_op(component.operation);
981    let src = map_blend_factor(component.src_factor);
982    let dst = map_blend_factor(component.dst_factor);
983    (op, src, dst)
984}
985
986pub fn map_pipeline_statistics(
987    types: wgt::PipelineStatisticsTypes,
988) -> vk::QueryPipelineStatisticFlags {
989    use wgt::PipelineStatisticsTypes as Pst;
990    let mut flags = vk::QueryPipelineStatisticFlags::empty();
991    if types.contains(Pst::VERTEX_SHADER_INVOCATIONS) {
992        flags |= vk::QueryPipelineStatisticFlags::VERTEX_SHADER_INVOCATIONS;
993    }
994    if types.contains(Pst::CLIPPER_INVOCATIONS) {
995        flags |= vk::QueryPipelineStatisticFlags::CLIPPING_INVOCATIONS;
996    }
997    if types.contains(Pst::CLIPPER_PRIMITIVES_OUT) {
998        flags |= vk::QueryPipelineStatisticFlags::CLIPPING_PRIMITIVES;
999    }
1000    if types.contains(Pst::FRAGMENT_SHADER_INVOCATIONS) {
1001        flags |= vk::QueryPipelineStatisticFlags::FRAGMENT_SHADER_INVOCATIONS;
1002    }
1003    if types.contains(Pst::COMPUTE_SHADER_INVOCATIONS) {
1004        flags |= vk::QueryPipelineStatisticFlags::COMPUTE_SHADER_INVOCATIONS;
1005    }
1006    flags
1007}
1008
1009pub fn map_acceleration_structure_format(
1010    format: crate::AccelerationStructureFormat,
1011) -> vk::AccelerationStructureTypeKHR {
1012    match format {
1013        crate::AccelerationStructureFormat::TopLevel => vk::AccelerationStructureTypeKHR::TOP_LEVEL,
1014        crate::AccelerationStructureFormat::BottomLevel => {
1015            vk::AccelerationStructureTypeKHR::BOTTOM_LEVEL
1016        }
1017    }
1018}
1019
1020pub fn map_acceleration_structure_build_mode(
1021    format: crate::AccelerationStructureBuildMode,
1022) -> vk::BuildAccelerationStructureModeKHR {
1023    match format {
1024        crate::AccelerationStructureBuildMode::Build => {
1025            vk::BuildAccelerationStructureModeKHR::BUILD
1026        }
1027        crate::AccelerationStructureBuildMode::Update => {
1028            vk::BuildAccelerationStructureModeKHR::UPDATE
1029        }
1030    }
1031}
1032
1033pub fn map_acceleration_structure_flags(
1034    flags: crate::AccelerationStructureBuildFlags,
1035) -> vk::BuildAccelerationStructureFlagsKHR {
1036    let mut vk_flags = vk::BuildAccelerationStructureFlagsKHR::empty();
1037
1038    if flags.contains(crate::AccelerationStructureBuildFlags::PREFER_FAST_TRACE) {
1039        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::PREFER_FAST_TRACE;
1040    }
1041
1042    if flags.contains(crate::AccelerationStructureBuildFlags::PREFER_FAST_BUILD) {
1043        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::PREFER_FAST_BUILD;
1044    }
1045
1046    if flags.contains(crate::AccelerationStructureBuildFlags::ALLOW_UPDATE) {
1047        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::ALLOW_UPDATE;
1048    }
1049
1050    if flags.contains(crate::AccelerationStructureBuildFlags::LOW_MEMORY) {
1051        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::LOW_MEMORY;
1052    }
1053
1054    if flags.contains(crate::AccelerationStructureBuildFlags::ALLOW_COMPACTION) {
1055        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::ALLOW_COMPACTION
1056    }
1057
1058    if flags.contains(crate::AccelerationStructureBuildFlags::ALLOW_RAY_HIT_VERTEX_RETURN) {
1059        vk_flags |= vk::BuildAccelerationStructureFlagsKHR::ALLOW_DATA_ACCESS
1060    }
1061
1062    vk_flags
1063}
1064
1065pub fn map_acceleration_structure_geometry_flags(
1066    flags: crate::AccelerationStructureGeometryFlags,
1067) -> vk::GeometryFlagsKHR {
1068    let mut vk_flags = vk::GeometryFlagsKHR::empty();
1069
1070    if flags.contains(crate::AccelerationStructureGeometryFlags::OPAQUE) {
1071        vk_flags |= vk::GeometryFlagsKHR::OPAQUE;
1072    }
1073
1074    if flags.contains(crate::AccelerationStructureGeometryFlags::NO_DUPLICATE_ANY_HIT_INVOCATION) {
1075        vk_flags |= vk::GeometryFlagsKHR::NO_DUPLICATE_ANY_HIT_INVOCATION;
1076    }
1077
1078    vk_flags
1079}
1080
1081pub fn map_acceleration_structure_usage_to_barrier(
1082    usage: crate::AccelerationStructureUses,
1083    features: wgt::Features,
1084    queue_flags: vk::QueueFlags,
1085) -> (vk::PipelineStageFlags, vk::AccessFlags) {
1086    let mut stages = vk::PipelineStageFlags::empty();
1087    let mut access = vk::AccessFlags::empty();
1088
1089    if usage.contains(crate::AccelerationStructureUses::BUILD_INPUT) {
1090        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
1091        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR;
1092    }
1093    if usage.contains(crate::AccelerationStructureUses::QUERY_INPUT) {
1094        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
1095        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR;
1096    }
1097    if usage.contains(crate::AccelerationStructureUses::BUILD_OUTPUT) {
1098        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
1099        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_WRITE_KHR;
1100    }
1101    if usage.contains(crate::AccelerationStructureUses::SHADER_INPUT)
1102        && features.contains(wgt::Features::EXPERIMENTAL_RAY_QUERY)
1103    {
1104        stages |= shader_stages(queue_flags);
1105        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR;
1106    }
1107    if usage.contains(crate::AccelerationStructureUses::SHADER_INPUT)
1108        && features.contains(wgt::Features::EXPERIMENTAL_RAY_TRACING_PIPELINES)
1109    {
1110        stages |= vk::PipelineStageFlags::RAY_TRACING_SHADER_KHR;
1111        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR;
1112    }
1113    if usage.contains(crate::AccelerationStructureUses::COPY_SRC) {
1114        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
1115        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR;
1116    }
1117    if usage.contains(crate::AccelerationStructureUses::COPY_DST) {
1118        stages |= vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR;
1119        access |= vk::AccessFlags::ACCELERATION_STRUCTURE_WRITE_KHR;
1120    }
1121
1122    (stages, access)
1123}
1124
1125pub fn map_component_swizzle(swizzle: wgt::ComponentSwizzle) -> vk::ComponentSwizzle {
1126    match swizzle {
1127        wgt::ComponentSwizzle::Zero => vk::ComponentSwizzle::ZERO,
1128        wgt::ComponentSwizzle::One => vk::ComponentSwizzle::ONE,
1129        wgt::ComponentSwizzle::R => vk::ComponentSwizzle::R,
1130        wgt::ComponentSwizzle::G => vk::ComponentSwizzle::G,
1131        wgt::ComponentSwizzle::B => vk::ComponentSwizzle::B,
1132        wgt::ComponentSwizzle::A => vk::ComponentSwizzle::A,
1133    }
1134}
1135
1136pub fn map_texture_component_swizzle(
1137    swizzle: wgt::TextureComponentSwizzle,
1138) -> vk::ComponentMapping {
1139    vk::ComponentMapping {
1140        r: map_component_swizzle(swizzle.r),
1141        g: map_component_swizzle(swizzle.g),
1142        b: map_component_swizzle(swizzle.b),
1143        a: map_component_swizzle(swizzle.a),
1144    }
1145}
1146
1147#[cfg(test)]
1148mod tests {
1149    use super::*;
1150
1151    /// `map_vk_color_space` and `map_surface_color_space` must stay mutually
1152    /// inverse so that a color space reported in the surface capabilities is
1153    /// exactly what the swapchain is created with.
1154    #[test]
1155    fn color_space_round_trip() {
1156        for vk_color_space in [
1157            vk::ColorSpaceKHR::SRGB_NONLINEAR,
1158            vk::ColorSpaceKHR::EXTENDED_SRGB_LINEAR_EXT,
1159            vk::ColorSpaceKHR::EXTENDED_SRGB_NONLINEAR_EXT,
1160            vk::ColorSpaceKHR::DISPLAY_P3_NONLINEAR_EXT,
1161            vk::ColorSpaceKHR::HDR10_ST2084_EXT,
1162            vk::ColorSpaceKHR::HDR10_HLG_EXT,
1163        ] {
1164            let mapped = map_vk_color_space(vk_color_space).unwrap();
1165            assert_eq!(map_surface_color_space(mapped), vk_color_space);
1166        }
1167    }
1168
1169    #[test]
1170    fn unknown_color_spaces_are_dropped() {
1171        for vk_color_space in [
1172            vk::ColorSpaceKHR::BT2020_LINEAR_EXT,
1173            vk::ColorSpaceKHR::DOLBYVISION_EXT,
1174            vk::ColorSpaceKHR::PASS_THROUGH_EXT,
1175            vk::ColorSpaceKHR::ADOBERGB_NONLINEAR_EXT,
1176        ] {
1177            assert!(map_vk_color_space(vk_color_space).is_none());
1178            assert!(map_vk_surface_formats(vk::SurfaceFormatKHR {
1179                format: vk::Format::B8G8R8A8_UNORM,
1180                color_space: vk_color_space,
1181            })
1182            .is_none());
1183        }
1184    }
1185
1186    #[test]
1187    fn hdr10_surface_format_maps() {
1188        let (format, color_space) = map_vk_surface_formats(vk::SurfaceFormatKHR {
1189            format: vk::Format::A2B10G10R10_UNORM_PACK32,
1190            color_space: vk::ColorSpaceKHR::HDR10_ST2084_EXT,
1191        })
1192        .unwrap();
1193        assert_eq!(format, wgt::TextureFormat::Rgb10a2Unorm);
1194        assert_eq!(color_space, wgt::SurfaceColorSpace::Bt2100Pq);
1195    }
1196
1197    #[test]
1198    fn buffer_shader_stages_follow_queue_flags() {
1199        let usage = wgt::BufferUses::UNIFORM;
1200
1201        let (stages, access) = map_buffer_usage_to_barrier(usage, vk::QueueFlags::GRAPHICS);
1202        assert_eq!(
1203            stages,
1204            vk::PipelineStageFlags::VERTEX_SHADER | vk::PipelineStageFlags::FRAGMENT_SHADER
1205        );
1206        assert_eq!(access, vk::AccessFlags::UNIFORM_READ);
1207
1208        let (stages, access) = map_buffer_usage_to_barrier(usage, vk::QueueFlags::COMPUTE);
1209        assert_eq!(stages, vk::PipelineStageFlags::COMPUTE_SHADER);
1210        assert_eq!(access, vk::AccessFlags::UNIFORM_READ);
1211
1212        let (stages, access) =
1213            map_buffer_usage_to_barrier(usage, vk::QueueFlags::GRAPHICS | vk::QueueFlags::COMPUTE);
1214        assert_eq!(
1215            stages,
1216            vk::PipelineStageFlags::VERTEX_SHADER
1217                | vk::PipelineStageFlags::FRAGMENT_SHADER
1218                | vk::PipelineStageFlags::COMPUTE_SHADER
1219        );
1220        assert_eq!(access, vk::AccessFlags::UNIFORM_READ);
1221    }
1222
1223    #[test]
1224    fn non_shader_buffer_usage_is_unchanged() {
1225        let (stages, access) = map_buffer_usage_to_barrier(
1226            wgt::BufferUses::COPY_SRC | wgt::BufferUses::VERTEX,
1227            vk::QueueFlags::empty(),
1228        );
1229
1230        assert_eq!(
1231            stages,
1232            vk::PipelineStageFlags::TRANSFER | vk::PipelineStageFlags::VERTEX_INPUT
1233        );
1234        assert_eq!(
1235            access,
1236            vk::AccessFlags::TRANSFER_READ | vk::AccessFlags::VERTEX_ATTRIBUTE_READ
1237        );
1238    }
1239
1240    #[test]
1241    fn texture_shader_stages_follow_queue_flags() {
1242        let usage = wgt::TextureUses::RESOURCE;
1243
1244        let (stages, access) = map_texture_usage_to_barrier(usage, vk::QueueFlags::GRAPHICS, false);
1245        assert_eq!(
1246            stages,
1247            vk::PipelineStageFlags::VERTEX_SHADER | vk::PipelineStageFlags::FRAGMENT_SHADER
1248        );
1249        assert_eq!(access, vk::AccessFlags::SHADER_READ);
1250
1251        let (stages, access) = map_texture_usage_to_barrier(usage, vk::QueueFlags::COMPUTE, false);
1252        assert_eq!(stages, vk::PipelineStageFlags::COMPUTE_SHADER);
1253        assert_eq!(access, vk::AccessFlags::SHADER_READ);
1254
1255        let (stages, access) = map_texture_usage_to_barrier(
1256            usage,
1257            vk::QueueFlags::GRAPHICS | vk::QueueFlags::COMPUTE,
1258            false,
1259        );
1260        assert_eq!(
1261            stages,
1262            vk::PipelineStageFlags::VERTEX_SHADER
1263                | vk::PipelineStageFlags::FRAGMENT_SHADER
1264                | vk::PipelineStageFlags::COMPUTE_SHADER
1265        );
1266        assert_eq!(access, vk::AccessFlags::SHADER_READ);
1267    }
1268
1269    #[test]
1270    fn non_shader_texture_usage_is_unchanged() {
1271        let (stages, access) = map_texture_usage_to_barrier(
1272            wgt::TextureUses::COPY_SRC | wgt::TextureUses::COLOR_TARGET,
1273            vk::QueueFlags::empty(),
1274            false,
1275        );
1276
1277        assert_eq!(
1278            stages,
1279            vk::PipelineStageFlags::TRANSFER | vk::PipelineStageFlags::COLOR_ATTACHMENT_OUTPUT
1280        );
1281        assert_eq!(
1282            access,
1283            vk::AccessFlags::TRANSFER_READ
1284                | vk::AccessFlags::COLOR_ATTACHMENT_READ
1285                | vk::AccessFlags::COLOR_ATTACHMENT_WRITE
1286        );
1287    }
1288
1289    #[test]
1290    fn acceleration_structure_shader_stages_follow_queue_flags() {
1291        let usage = crate::AccelerationStructureUses::SHADER_INPUT;
1292        let features = wgt::Features::EXPERIMENTAL_RAY_QUERY;
1293
1294        let (stages, access) =
1295            map_acceleration_structure_usage_to_barrier(usage, features, vk::QueueFlags::GRAPHICS);
1296        assert_eq!(
1297            stages,
1298            vk::PipelineStageFlags::VERTEX_SHADER | vk::PipelineStageFlags::FRAGMENT_SHADER
1299        );
1300        assert_eq!(access, vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR);
1301
1302        let (stages, access) =
1303            map_acceleration_structure_usage_to_barrier(usage, features, vk::QueueFlags::COMPUTE);
1304        assert_eq!(stages, vk::PipelineStageFlags::COMPUTE_SHADER);
1305        assert_eq!(access, vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR);
1306
1307        let (stages, access) = map_acceleration_structure_usage_to_barrier(
1308            usage,
1309            features,
1310            vk::QueueFlags::GRAPHICS | vk::QueueFlags::COMPUTE,
1311        );
1312        assert_eq!(
1313            stages,
1314            vk::PipelineStageFlags::VERTEX_SHADER
1315                | vk::PipelineStageFlags::FRAGMENT_SHADER
1316                | vk::PipelineStageFlags::COMPUTE_SHADER
1317        );
1318        assert_eq!(access, vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR);
1319    }
1320
1321    #[test]
1322    fn non_shader_acceleration_structure_usage_is_unchanged() {
1323        let (stages, access) = map_acceleration_structure_usage_to_barrier(
1324            crate::AccelerationStructureUses::BUILD_INPUT
1325                | crate::AccelerationStructureUses::BUILD_OUTPUT,
1326            wgt::Features::empty(),
1327            vk::QueueFlags::empty(),
1328        );
1329
1330        assert_eq!(
1331            stages,
1332            vk::PipelineStageFlags::ACCELERATION_STRUCTURE_BUILD_KHR
1333        );
1334        assert_eq!(
1335            access,
1336            vk::AccessFlags::ACCELERATION_STRUCTURE_READ_KHR
1337                | vk::AccessFlags::ACCELERATION_STRUCTURE_WRITE_KHR
1338        );
1339    }
1340}
wgpu_hal/vulkan/conv.rs

wgpu_hal/vulkan/
conv.rs
