OROCHI 2.0

- support a lot more CUDA/HIP functions compared to OROCHI 1. Should be almost exhaustive.
- we will keep one branch per version of CUDA/HIP, (example of branch name: 'release/hip5.7_cuda12.2'),
  so developers can switch on branches depending on their environment.
  If you need a combination that doesn't exist, open a Issue.
- Change compared to OROCHI 1: you need to install the CUDA SDK corresponding to the branch you are using.
  for example, if you use branch release/hip5.7_cuda12.2, install CUDA SDK 12.2.
  However CUDA will still be dynamically loaded at runtime, only includes of the SDK are used at compile time.
- new Demo for Textures
- new Demo for D3D12 interop
- some refactoring/improvement of OrochiUtils was done.
- Orochi.h can be included in the kernel files to have the oro* names
- The binding and naming between HIP/CUDA has been improved and developed in a way it should be easier to maintain for future versions.
- most Orochi/OrochiUtils API has not been changed so updating the project from Orochi 1.0 to 2.0 should be straightforward.

Author: RichardGe

.gitignore

@@ -21,3 +21,7 @@ dist/**
 .DS_Store
 .vs/
 build/
+
+result.xml
+UnitTest/bitcodes/*.fatbin
+Test/SimpleD3D12/cache/**

Orochi/GpuMemory.h

@@ -1,3 +1,25 @@
+//
+// Copyright (c) 2021-2024 Advanced Micro Devices, Inc. All rights reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+//
+
 #pragma once
 
 #include <Orochi/OrochiUtils.h>
@@ -91,9 +113,35 @@ class GpuMemory final
 		*this = std::move( tmp );
 	}
 
+	/// @brief Asynchronous version of 'resize' using a given Orochi stream.
+	/// @param new_size The new memory size after the function is called.
+	/// @param copy If true, the function will copy the data to the newly created memory space as well.
+	/// @param stream The Orochi stream used for the underlying operations.
+	void resizeAsync( const size_t new_size, const bool copy = false, oroStream stream = 0 ) noexcept
+	{
+		if( new_size <= m_capacity )
+		{
+			m_size = new_size;
+			return;
+		}
+
+		GpuMemory tmp( new_size );
+
+		if( copy )
+		{
+			OrochiUtils::copyDtoDAsync( tmp.m_data, m_data, m_size, stream );
+		}
+
+		*this = std::move( tmp );
+	}
+
 	/// @brief Reset the memory space so that all bits inside are cleared to zero.
 	void reset() noexcept { OrochiUtils::memset( m_data, 0, m_size * sizeof( T ) ); }
 
+	/// @brief Asynchronous version of 'reset' using a given Orochi stream.
+	/// @param stream The Orochi stream used for the underlying operations.
+	void resetAsync( oroStream stream = 0 ) noexcept { OrochiUtils::memsetAsync( m_data, 0, m_size * sizeof( T ), stream ); }
+
 	/// @brief Copy the data from device memory to host.
 	/// @param host_ptr The host pointer.
 	/// @param host_data_size The size of the host memory which represents the number of elements.