feat: Added instructions for depth reference and project coordinate i…

…mage instructions (#545)

* feat: Added instructions for depth reference and project coordinate image instructions

* docs: add alias annotation for methods in spirv-std/src/textures.rs

tests/ui/image/sample_depth_reference/sample.rs

@@ -0,0 +1,19 @@
+// Test `OpImageSampleDrefImplicitLod`
+// build-pass
+
+use spirv_std::{arch, Cubemap, Image2d, Image2dArray, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] image_array: &Image2dArray,
+    #[spirv(uniform_constant, descriptor_set = 2, binding = 2)] cubemap: &Cubemap,
+    #[spirv(uniform_constant, descriptor_set = 3, binding = 3)] sampler: &Sampler,
+    output: &mut f32,
+) {
+    let v2 = glam::Vec2::new(0.0, 1.0);
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    *output = image.sample_depth_reference(*sampler, v2, 1.0);
+    *output += image_array.sample_depth_reference(*sampler, v3, 1.0);
+    *output += cubemap.sample_depth_reference(*sampler, v3, 1.0);
+}

tests/ui/image/sample_depth_reference/sample_gradient.rs

@@ -0,0 +1,23 @@
+// Test `OpImageSampleDrefExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Cubemap, Image2d, Image2dArray, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] image_array: &Image2dArray,
+    #[spirv(uniform_constant, descriptor_set = 2, binding = 2)] sampler: &Sampler,
+    #[spirv(uniform_constant, descriptor_set = 3, binding = 3)] cubemap: &Cubemap,
+    output: &mut f32,
+) {
+    let v2 = glam::Vec2::new(0.0, 1.0);
+    let v2_dx = glam::Vec2::new(0.0, 1.0);
+    let v2_dy = glam::Vec2::new(0.0, 1.0);
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    let v3_dx = glam::Vec3A::new(0.0, 1.0, 0.5);
+    let v3_dy = glam::Vec3A::new(0.0, 1.0, 0.5);
+    *output = image.sample_depth_reference_by_gradient(*sampler, v2, 1.0, v2_dx, v2_dy);
+    *output += image_array.sample_depth_reference_by_gradient(*sampler, v3, 1.0, v2_dx, v2_dy);
+    *output += cubemap.sample_depth_reference_by_gradient(*sampler, v3, 1.0, v3_dx, v3_dy);
+}

tests/ui/image/sample_depth_reference/sample_lod.rs

@@ -0,0 +1,19 @@
+// Test `OpImageSampleDrefExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Cubemap, Image2d, Image2dArray, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] image_array: &Image2dArray,
+    #[spirv(uniform_constant, descriptor_set = 2, binding = 2)] sampler: &Sampler,
+    #[spirv(uniform_constant, descriptor_set = 3, binding = 3)] cubemap: &Cubemap,
+    output: &mut f32,
+) {
+    let v2 = glam::Vec2::new(0.0, 1.0);
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    *output = image.sample_depth_reference_by_lod(*sampler, v2, 1.0, 0.0);
+    *output += image_array.sample_depth_reference_by_lod(*sampler, v3, 1.0, 0.0);
+    *output += image_array.sample_depth_reference_by_lod(*sampler, v3, 1.0, 0.0);
+}

tests/ui/image/sample_depth_reference_with_project_coordinate/sample.rs

@@ -0,0 +1,14 @@
+// Test `OpImageSampleProjDrefImplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut f32,
+) {
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    *output = image.sample_depth_reference_with_project_coordinate(*sampler, v3, 1.0);
+}

tests/ui/image/sample_depth_reference_with_project_coordinate/sample_gradient.rs

@@ -0,0 +1,16 @@
+// Test `OpImageSampleProjDrefExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut f32,
+) {
+    let v2_dx = glam::Vec2::new(0.0, 1.0);
+    let v2_dy = glam::Vec2::new(0.0, 1.0);
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    *output = image.sample_depth_reference_with_project_coordinate_by_gradient(*sampler, v3, 1.0, v2_dx, v2_dy);
+}

tests/ui/image/sample_depth_reference_with_project_coordinate/sample_lod.rs

@@ -0,0 +1,14 @@
+// Test `OpImageSampleProjDrefExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut f32,
+) {
+    let v3 = glam::Vec3A::new(0.0, 0.0, 1.0);
+    *output = image.sample_depth_reference_with_project_coordinate_by_lod(*sampler, v3, 1.0, 0.0);
+}

tests/ui/image/sample_with_project_coordinate/sample.rs

@@ -0,0 +1,14 @@
+// Test `OpImageSampleProjImplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image2d: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut glam::Vec4,
+) {
+    let v3 = glam::Vec3::new(0.0, 1.0, 0.5);
+    *output = image2d.sample_with_project_coordinate(*sampler, v3);
+}

tests/ui/image/sample_with_project_coordinate/sample_gradient.rs

@@ -0,0 +1,15 @@
+// Test `OpImageSampleProjExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image2d: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut glam::Vec4,
+) {
+    let v2 = glam::Vec2::new(0.0, 1.0);
+    let v3 = glam::Vec3::new(0.0, 1.0, 0.5);
+    *output = image2d.sample_with_project_coordinate_by_gradient(*sampler, v3, v2, v2);
+}

tests/ui/image/sample_with_project_coordinate/sample_lod.rs

@@ -0,0 +1,14 @@
+// Test `OpImageSampleProjExplicitLod`
+// build-pass
+
+use spirv_std::{arch, Image2d, Sampler};
+
+#[spirv(fragment)]
+pub fn main(
+    #[spirv(uniform_constant, descriptor_set = 0, binding = 0)] image2d: &Image2d,
+    #[spirv(uniform_constant, descriptor_set = 1, binding = 1)] sampler: &Sampler,
+    output: &mut glam::Vec4,
+) {
+    let v3 = glam::Vec3::new(0.0, 1.0, 0.5);
+    *output = image2d.sample_with_project_coordinate_by_lod(*sampler, v3, 0.0);
+}