[SYCL] Add structure to pass references to ranges

sycl/include/sycl/detail/ranges_ref_view.hpp

@@ -0,0 +1,54 @@
+//==---- ranges_ref_view.hpp --- SYCL iteration with reference to ranges ---==//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+
+#pragma once
+
+#include <sycl/nd_range.hpp>
+
+namespace sycl {
+inline namespace _V1 {
+namespace detail {
+
+// The structure to keep dimension and references to ranges unified for
+// all dimensions.
+class ranges_ref_view {
+
+public:
+  ranges_ref_view() = default;
+  ranges_ref_view(const ranges_ref_view &Desc) = default;
+  ranges_ref_view(ranges_ref_view &&Desc) = default;
+
+  template <int Dims_>
+  ranges_ref_view(sycl::range<Dims_> &GlobalSizes,
+                  sycl::range<Dims_> &LocalSizes)
+      : GlobalSize(&(GlobalSizes[0])), LocalSize(&(LocalSizes[0])),
+        Dims{size_t(Dims_)} {}
+
+  // to support usage in sycl::ext::oneapi::experimental::submit_with_event()
+  template <int Dims_>
+  ranges_ref_view(sycl::nd_range<Dims_> &ExecutionRange)
+      : GlobalSize(&ExecutionRange.globalSize[0]),
+        LocalSize(&ExecutionRange.localSize[0]),
+        GlobalOffset(&ExecutionRange.offset[0]), Dims{size_t(Dims_)} {}
+
+  template <int Dims_>
+  ranges_ref_view(sycl::range<Dims_> &Range)
+      : GlobalSize(&(Range[0])), Dims{size_t(Dims_)} {}
+
+  ranges_ref_view &operator=(const ranges_ref_view &Desc) = default;
+  ranges_ref_view &operator=(ranges_ref_view &&Desc) = default;
+
+  const size_t *GlobalSize = nullptr;
+  const size_t *LocalSize = nullptr;
+  const size_t *GlobalOffset = nullptr;
+  size_t Dims = 0;
+};
+
+} // namespace detail
+} // namespace _V1
+} // namespace sycl

sycl/include/sycl/nd_range.hpp

@@ -15,6 +15,10 @@
 namespace sycl {
 inline namespace _V1 {
 
+namespace detail {
+class ranges_ref_view;
+}
+
 /// Defines the iteration domain of both the work-groups and the overall
 /// dispatch.
 ///
@@ -65,6 +69,8 @@ template <int Dimensions = 1> class nd_range {
   bool operator!=(const nd_range<Dimensions> &rhs) const {
     return !(*this == rhs);
   }
+
+  friend class sycl::_V1::detail::ranges_ref_view;
 };
 
 } // namespace _V1

sycl/unittests/scheduler/CMakeLists.txt

@@ -22,4 +22,5 @@ add_sycl_unittest(SchedulerTests OBJECT
     AccessorDefaultCtor.cpp
     HostTaskAndBarrier.cpp
     BarrierDependencies.cpp
+    RangesRefViewUsage.cpp
 )

sycl/unittests/scheduler/RangesRefViewUsage.cpp

@@ -0,0 +1,112 @@
+//==---- RangesRefViewUsage.cpp --- Check ranges_ref_view ------------------==//
+//
+// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
+// See https://llvm.org/LICENSE.txt for license information.
+// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+//
+//===----------------------------------------------------------------------===//
+#include <sycl/detail/ranges_ref_view.hpp>
+
+#include <gtest/gtest.h>
+
+TEST(RangesRefUsage, RangesRefUsage) {
+  sycl::detail::ranges_ref_view r0;
+  ASSERT_EQ(r0.Dims, size_t{0});
+
+  {
+    sycl::range<1> global_range{1024};
+    sycl::range<1> local_range{64};
+    sycl::id<1> offset{10};
+    sycl::nd_range<1> nd_range{global_range, local_range, offset};
+
+    {
+      sycl::detail::ranges_ref_view r{nd_range};
+      ASSERT_EQ(r.Dims, size_t{1});
+      ASSERT_EQ(*r.GlobalSize, global_range[0]);
+      ASSERT_EQ(*r.LocalSize, local_range[0]);
+      ASSERT_EQ(*r.GlobalOffset, offset[0]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range, local_range};
+      ASSERT_EQ(r.Dims, size_t{1});
+      ASSERT_EQ(*r.GlobalSize, global_range[0]);
+      ASSERT_EQ(*r.LocalSize, local_range[0]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range};
+      ASSERT_EQ(r.Dims, size_t{1});
+      ASSERT_EQ(*r.GlobalSize, global_range[0]);
+      ASSERT_EQ(r.LocalSize, nullptr);
+    }
+  }
+  {
+    sycl::range<2> global_range{1024, 512};
+    sycl::range<2> local_range{64, 32};
+    sycl::id<2> offset{10, 20};
+    sycl::nd_range<2> nd_range{global_range, local_range, offset};
+
+    {
+      sycl::detail::ranges_ref_view r{nd_range};
+      ASSERT_EQ(r.Dims, size_t{2});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.LocalSize[0], local_range[0]);
+      ASSERT_EQ(r.LocalSize[1], local_range[1]);
+      ASSERT_EQ(r.GlobalOffset[0], offset[0]);
+      ASSERT_EQ(r.GlobalOffset[1], offset[1]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range, local_range};
+      ASSERT_EQ(r.Dims, size_t{2});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.LocalSize[0], local_range[0]);
+      ASSERT_EQ(r.LocalSize[1], local_range[1]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range};
+      ASSERT_EQ(r.Dims, size_t{2});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.LocalSize, nullptr);
+    }
+  }
+  {
+    sycl::range<3> global_range{1024, 512, 256};
+    sycl::range<3> local_range{64, 32, 16};
+    sycl::id<3> offset{10, 20, 30};
+    sycl::nd_range<3> nd_range{global_range, local_range, offset};
+
+    {
+      sycl::detail::ranges_ref_view r{nd_range};
+      ASSERT_EQ(r.Dims, size_t{3});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.GlobalSize[2], global_range[2]);
+      ASSERT_EQ(r.LocalSize[0], local_range[0]);
+      ASSERT_EQ(r.LocalSize[1], local_range[1]);
+      ASSERT_EQ(r.LocalSize[2], local_range[2]);
+      ASSERT_EQ(r.GlobalOffset[0], offset[0]);
+      ASSERT_EQ(r.GlobalOffset[1], offset[1]);
+      ASSERT_EQ(r.GlobalOffset[2], offset[2]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range, local_range};
+      ASSERT_EQ(r.Dims, size_t{3});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.GlobalSize[2], global_range[2]);
+      ASSERT_EQ(r.LocalSize[0], local_range[0]);
+      ASSERT_EQ(r.LocalSize[1], local_range[1]);
+      ASSERT_EQ(r.LocalSize[2], local_range[2]);
+    }
+    {
+      sycl::detail::ranges_ref_view r{global_range};
+      ASSERT_EQ(r.Dims, size_t{3});
+      ASSERT_EQ(r.GlobalSize[0], global_range[0]);
+      ASSERT_EQ(r.GlobalSize[1], global_range[1]);
+      ASSERT_EQ(r.GlobalSize[2], global_range[2]);
+      ASSERT_EQ(r.LocalSize, nullptr);
+    }
+  }
+}