document access in macro

Author: schell

crates/spirv-std/macros/src/image.rs

@@ -574,11 +574,11 @@ mod params {
     }
 
     pub fn image_access_to_const_u32(access: Option<AccessQualifier>) -> proc_macro2::TokenStream {
-        match access {
-            Some(AccessQualifier::ReadOnly) => quote!(AccessQualifier::ReadOnly as u32),
-            Some(AccessQualifier::WriteOnly) => quote!(AccessQualifier::WriteOnly as u32),
-            Some(AccessQualifier::ReadWrite) => quote!(AccessQualifier::ReadWrite as u32),
-            None => quote!(3),
+        if let Some(aq) = access {
+            let n = aq as u32;
+            quote!(#n)
+        } else {
+            quote!(3)
         }
     }
 

crates/spirv-std/macros/src/lib.rs

@@ -123,6 +123,8 @@ use std::fmt::Write;
 ///    Accepted values: `true` or `false`. Default: `false`.
 /// - `depth` — Whether it is known that the image is a depth image.
 ///    Accepted values: `true` or `false`. Default: `unknown`.
+/// - `access` — The access qualifier of the image, if known.
+///    Accepted values: `readonly`, `writeonly` or `readwrite`.
 ///
 /// [`ImageFormat`]: spirv_std_types::image_params::ImageFormat
 ///