Nuitrack v0.38.0

CHANGELOG.md

@@ -1,3 +1,16 @@
+# Release v0.38.0
+
+**Release Date**: 8 Jan 2025  
+**Nuitrack Runtime version**: 0.38.0  
+**Nuitrack SDK version**: 1.14.0  
+
+## Bug Fixes and Improvements
+* Depth sensing - numerous fixes, in particular for Azure Kinect, Orbbec Astra (multiple revisions)
+* Scene segmentation and user tracking - improved robustness, additional options for floor detection / scene segmentation
+
+## Known Issues
+* Nuitrack.exe works unstable when depth map rotation is set (examples and other applications are not impacted)
+
 # Release v0.37.24
 
 **Release Date**: 1 Jul 2024  

Examples/nuitrack_csharp_device_api_sample/cmake/FindMono.cmake

@@ -32,7 +32,7 @@ if( DEFINED CSHARP_MONO_FOUND )
 endif( DEFINED CSHARP_MONO_FOUND )
 
 unset( CSHARP_MONO_VERSIONS CACHE ) # Clear versions
-if( WIN32 AND NOT CMAKE_CROSSCOMPILING)
+if (WIN32 AND NOT CMAKE_CROSSCOMPILING)
   # Search for Mono on Win32 systems
   # See http://mono-project.com/OldReleases and http://www.go-mono.com/mono-downloads/download.html
   set( csharp_mono_bin_dirs )
@@ -103,7 +103,7 @@ if( WIN32 AND NOT CMAKE_CROSSCOMPILING)
     set( CSHARP_MONO_FOUND 1 CACHE INTERNAL "Boolean indicating if C# Mono was found" )
   endforeach( csharp_mono_bin_dir )
 
-else( UNIX OR CMAKE_CROSSCOMPILING )
+else()
   # Search for Mono on non-Win32 systems
   set( chsarp_mono_names "mcs" "mcs.exe" "dmcs" "dmcs.exe" "smcs" "smcs.exe" "gmcs" "gmcs.exe" )
   set(
@@ -150,7 +150,7 @@ else( UNIX OR CMAKE_CROSSCOMPILING )
   # Remove temp variable from cache
   unset( csharp_mono_compiler CACHE )
 
-endif( WIN32 )
+endif()
 
 if( CSHARP_MONO_FOUND )
   # Report the found versions

Examples/nuitrack_csharp_sample/cmake/FindMono.cmake

@@ -32,7 +32,7 @@ if( DEFINED CSHARP_MONO_FOUND )
 endif( DEFINED CSHARP_MONO_FOUND )
 
 unset( CSHARP_MONO_VERSIONS CACHE ) # Clear versions
-if( WIN32 AND NOT CMAKE_CROSSCOMPILING)
+if (WIN32 AND NOT CMAKE_CROSSCOMPILING)
   # Search for Mono on Win32 systems
   # See http://mono-project.com/OldReleases and http://www.go-mono.com/mono-downloads/download.html
   set( csharp_mono_bin_dirs )
@@ -103,7 +103,7 @@ if( WIN32 AND NOT CMAKE_CROSSCOMPILING)
     set( CSHARP_MONO_FOUND 1 CACHE INTERNAL "Boolean indicating if C# Mono was found" )
   endforeach( csharp_mono_bin_dir )
 
-else( UNIX OR CMAKE_CROSSCOMPILING )
+else()
   # Search for Mono on non-Win32 systems
   set( chsarp_mono_names "mcs" "mcs.exe" "dmcs" "dmcs.exe" "smcs" "smcs.exe" "gmcs" "gmcs.exe" )
   set(
@@ -150,7 +150,7 @@ else( UNIX OR CMAKE_CROSSCOMPILING )
   # Remove temp variable from cache
   unset( csharp_mono_compiler CACHE )
 
-endif( WIN32 )
+endif()
 
 if( CSHARP_MONO_FOUND )
   # Report the found versions

Nuitrack/include/nuitrack/utils/ExceptionTranslator.h

@@ -19,28 +19,30 @@ class ExceptionTranslator
 #ifndef NUITRACK_NO_EXCEPTIONS
 		switch(errorCode)
 		{
-		case EXCEPTION:
-			throw tdv::nuitrack::Exception();
-		case TERMINATE_EXCEPTION:
-			throw tdv::nuitrack::TerminateException();
-		case BAD_CONFIG_VALUE_EXCEPTION:
-			throw tdv::nuitrack::BadConfigValueException();
-		case CONFIG_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ConfigNotFoundException();
-		case MODUDLE_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotFoundException();
-		case LICENSE_NOT_ACQUIRED_EXCEPTION:
-			throw tdv::nuitrack::LicenseNotAcquiredException();
-		case MODULE_NOT_INITIALIZED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotInitializedException();
-		case MODULE_NOT_STARTED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotStartedException();
-		case NETWORK_EXCEPTION:
-			throw tdv::nuitrack::NetworkException();
-		case NETWORK_UNAVAILABLE_EXCEPTION:
-			throw tdv::nuitrack::NetworkUnavailableException();
-		case SENSOR_DISCONNECTED_EXCEPTION:
-			throw tdv::nuitrack::SensorDisconnectedException();
+			case EXCEPTION:
+				throw tdv::nuitrack::Exception();
+			case TERMINATE_EXCEPTION:
+				throw tdv::nuitrack::TerminateException();
+			case BAD_CONFIG_VALUE_EXCEPTION:
+				throw tdv::nuitrack::BadConfigValueException();
+			case CONFIG_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ConfigNotFoundException();
+			case MODUDLE_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotFoundException();
+			case LICENSE_NOT_ACQUIRED_EXCEPTION:
+				throw tdv::nuitrack::LicenseNotAcquiredException();
+			case MODULE_NOT_INITIALIZED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotInitializedException();
+			case MODULE_NOT_STARTED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotStartedException();
+			case NETWORK_EXCEPTION:
+				throw tdv::nuitrack::NetworkException();
+			case NETWORK_UNAVAILABLE_EXCEPTION:
+				throw tdv::nuitrack::NetworkUnavailableException();
+			case SENSOR_DISCONNECTED_EXCEPTION:
+				throw tdv::nuitrack::SensorDisconnectedException();
+			case OK:
+				break;
 		}
 #else
 		if (errorCode != ExceptionType::OK)
@@ -54,28 +56,30 @@ class ExceptionTranslator
 		std::string message = (errorMessage == NULL ? "" : errorMessage);
 		switch(errorCode)
 		{
-		case EXCEPTION:
-			throw tdv::nuitrack::Exception("NuitrackException: " + message);
-		case TERMINATE_EXCEPTION:
-			throw tdv::nuitrack::TerminateException("NuitrackException (TerminateException): " + message);
-		case BAD_CONFIG_VALUE_EXCEPTION:
-			throw tdv::nuitrack::BadConfigValueException("NuitrackException (BadConfigValueException): " + message);
-		case CONFIG_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ConfigNotFoundException("NuitrackException (ConfigNotFoundException): " + message);
-		case MODUDLE_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotFoundException("NuitrackException (ModuleNotFoundException): " + message);
-		case LICENSE_NOT_ACQUIRED_EXCEPTION:
-			throw tdv::nuitrack::LicenseNotAcquiredException("NuitrackException (LicenseNotAcquiredException): " + message);
-		case MODULE_NOT_INITIALIZED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotInitializedException("NuitrackException (ModuleNotInitializedException): " + message);
-		case MODULE_NOT_STARTED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotStartedException("NuitrackException (ModuleNotStartedException): " + message);
-		case NETWORK_EXCEPTION:
-			throw tdv::nuitrack::NetworkException("NuitrackException (NetworkException): " + message);
-		case NETWORK_UNAVAILABLE_EXCEPTION:
-			throw tdv::nuitrack::NetworkUnavailableException("NuitrackException (NetworkUnavailableException): " + message);
-		case SENSOR_DISCONNECTED_EXCEPTION:
-			throw tdv::nuitrack::SensorDisconnectedException("NuitrackException (SensorDisconnectedException): " + message);
+			case EXCEPTION:
+				throw tdv::nuitrack::Exception("NuitrackException: " + message);
+			case TERMINATE_EXCEPTION:
+				throw tdv::nuitrack::TerminateException("NuitrackException (TerminateException): " + message);
+			case BAD_CONFIG_VALUE_EXCEPTION:
+				throw tdv::nuitrack::BadConfigValueException("NuitrackException (BadConfigValueException): " + message);
+			case CONFIG_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ConfigNotFoundException("NuitrackException (ConfigNotFoundException): " + message);
+			case MODUDLE_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotFoundException("NuitrackException (ModuleNotFoundException): " + message);
+			case LICENSE_NOT_ACQUIRED_EXCEPTION:
+				throw tdv::nuitrack::LicenseNotAcquiredException("NuitrackException (LicenseNotAcquiredException): " + message);
+			case MODULE_NOT_INITIALIZED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotInitializedException("NuitrackException (ModuleNotInitializedException): " + message);
+			case MODULE_NOT_STARTED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotStartedException("NuitrackException (ModuleNotStartedException): " + message);
+			case NETWORK_EXCEPTION:
+				throw tdv::nuitrack::NetworkException("NuitrackException (NetworkException): " + message);
+			case NETWORK_UNAVAILABLE_EXCEPTION:
+				throw tdv::nuitrack::NetworkUnavailableException("NuitrackException (NetworkUnavailableException): " + message);
+			case SENSOR_DISCONNECTED_EXCEPTION:
+				throw tdv::nuitrack::SensorDisconnectedException("NuitrackException (SensorDisconnectedException): " + message);
+			case OK:
+				break;
 		}
 #else
 		if (errorCode != ExceptionType::OK)

Unity3D/README.md

@@ -1,9 +1,8 @@
 ## How to use?
-- Download Nuitrack Runtime for your platform of choice and corresponding Unity package at the [Releases page](https://github.com/3DiVi/nuitrack-sdk/releases)
-- Install Nuitrack Runtime
-- Create new Project in Unity (or open your project)
+- Install Nuitrack Runtime https://github.com/3DiVi/nuitrack-sdk/blob/master/README.md
+- Create new Project in Unity (Or open your project)
 - Import NuitrackSDK.unitypackage into your project (Main menu: "Assets/Import Package/Custom Package..." and click "import" button)
-- Connect supported depth sensor (https://nuitrack.com/#sensors)
+- Connect supported sensor (https://nuitrack.com/#sensors)
 - In the main menu, select "Nuitrack/Activate Nuitrack"
 - In the main menu, select "Nuitrack/Play Test Unity Scene" (or manually open in Project Tab "Assets/NuitrackSDK/NuitrackDemos/AllModulesScene" and click Play button) (If something doesn't work, follow the on-screen instructions)
 - Сheck out the tutorials "Nuitrack/Help/Open Tutorials List"

UnrealEngine/NuitrackPluginForUE4/Source/NuitrackModule/include/nuitrack/utils/ExceptionTranslator.h

@@ -19,28 +19,30 @@ class ExceptionTranslator
 #ifndef NUITRACK_NO_EXCEPTIONS
 		switch(errorCode)
 		{
-		case EXCEPTION:
-			throw tdv::nuitrack::Exception();
-		case TERMINATE_EXCEPTION:
-			throw tdv::nuitrack::TerminateException();
-		case BAD_CONFIG_VALUE_EXCEPTION:
-			throw tdv::nuitrack::BadConfigValueException();
-		case CONFIG_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ConfigNotFoundException();
-		case MODUDLE_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotFoundException();
-		case LICENSE_NOT_ACQUIRED_EXCEPTION:
-			throw tdv::nuitrack::LicenseNotAcquiredException();
-		case MODULE_NOT_INITIALIZED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotInitializedException();
-		case MODULE_NOT_STARTED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotStartedException();
-		case NETWORK_EXCEPTION:
-			throw tdv::nuitrack::NetworkException();
-		case NETWORK_UNAVAILABLE_EXCEPTION:
-			throw tdv::nuitrack::NetworkUnavailableException();
-		case SENSOR_DISCONNECTED_EXCEPTION:
-			throw tdv::nuitrack::SensorDisconnectedException();
+			case EXCEPTION:
+				throw tdv::nuitrack::Exception();
+			case TERMINATE_EXCEPTION:
+				throw tdv::nuitrack::TerminateException();
+			case BAD_CONFIG_VALUE_EXCEPTION:
+				throw tdv::nuitrack::BadConfigValueException();
+			case CONFIG_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ConfigNotFoundException();
+			case MODUDLE_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotFoundException();
+			case LICENSE_NOT_ACQUIRED_EXCEPTION:
+				throw tdv::nuitrack::LicenseNotAcquiredException();
+			case MODULE_NOT_INITIALIZED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotInitializedException();
+			case MODULE_NOT_STARTED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotStartedException();
+			case NETWORK_EXCEPTION:
+				throw tdv::nuitrack::NetworkException();
+			case NETWORK_UNAVAILABLE_EXCEPTION:
+				throw tdv::nuitrack::NetworkUnavailableException();
+			case SENSOR_DISCONNECTED_EXCEPTION:
+				throw tdv::nuitrack::SensorDisconnectedException();
+			case OK:
+				break;
 		}
 #else
 		if (errorCode != ExceptionType::OK)
@@ -54,28 +56,30 @@ class ExceptionTranslator
 		std::string message = (errorMessage == NULL ? "" : errorMessage);
 		switch(errorCode)
 		{
-		case EXCEPTION:
-			throw tdv::nuitrack::Exception("NuitrackException: " + message);
-		case TERMINATE_EXCEPTION:
-			throw tdv::nuitrack::TerminateException("NuitrackException (TerminateException): " + message);
-		case BAD_CONFIG_VALUE_EXCEPTION:
-			throw tdv::nuitrack::BadConfigValueException("NuitrackException (BadConfigValueException): " + message);
-		case CONFIG_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ConfigNotFoundException("NuitrackException (ConfigNotFoundException): " + message);
-		case MODUDLE_NOT_FOUND_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotFoundException("NuitrackException (ModuleNotFoundException): " + message);
-		case LICENSE_NOT_ACQUIRED_EXCEPTION:
-			throw tdv::nuitrack::LicenseNotAcquiredException("NuitrackException (LicenseNotAcquiredException): " + message);
-		case MODULE_NOT_INITIALIZED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotInitializedException("NuitrackException (ModuleNotInitializedException): " + message);
-		case MODULE_NOT_STARTED_EXCEPTION:
-			throw tdv::nuitrack::ModuleNotStartedException("NuitrackException (ModuleNotStartedException): " + message);
-		case NETWORK_EXCEPTION:
-			throw tdv::nuitrack::NetworkException("NuitrackException (NetworkException): " + message);
-		case NETWORK_UNAVAILABLE_EXCEPTION:
-			throw tdv::nuitrack::NetworkUnavailableException("NuitrackException (NetworkUnavailableException): " + message);
-		case SENSOR_DISCONNECTED_EXCEPTION:
-			throw tdv::nuitrack::SensorDisconnectedException("NuitrackException (SensorDisconnectedException): " + message);
+			case EXCEPTION:
+				throw tdv::nuitrack::Exception("NuitrackException: " + message);
+			case TERMINATE_EXCEPTION:
+				throw tdv::nuitrack::TerminateException("NuitrackException (TerminateException): " + message);
+			case BAD_CONFIG_VALUE_EXCEPTION:
+				throw tdv::nuitrack::BadConfigValueException("NuitrackException (BadConfigValueException): " + message);
+			case CONFIG_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ConfigNotFoundException("NuitrackException (ConfigNotFoundException): " + message);
+			case MODUDLE_NOT_FOUND_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotFoundException("NuitrackException (ModuleNotFoundException): " + message);
+			case LICENSE_NOT_ACQUIRED_EXCEPTION:
+				throw tdv::nuitrack::LicenseNotAcquiredException("NuitrackException (LicenseNotAcquiredException): " + message);
+			case MODULE_NOT_INITIALIZED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotInitializedException("NuitrackException (ModuleNotInitializedException): " + message);
+			case MODULE_NOT_STARTED_EXCEPTION:
+				throw tdv::nuitrack::ModuleNotStartedException("NuitrackException (ModuleNotStartedException): " + message);
+			case NETWORK_EXCEPTION:
+				throw tdv::nuitrack::NetworkException("NuitrackException (NetworkException): " + message);
+			case NETWORK_UNAVAILABLE_EXCEPTION:
+				throw tdv::nuitrack::NetworkUnavailableException("NuitrackException (NetworkUnavailableException): " + message);
+			case SENSOR_DISCONNECTED_EXCEPTION:
+				throw tdv::nuitrack::SensorDisconnectedException("NuitrackException (SensorDisconnectedException): " + message);
+			case OK:
+				break;
 		}
 #else
 		if (errorCode != ExceptionType::OK)

VERSION

@@ -1,2 +1,2 @@
-0.37.24
-1.13.24
+0.38.0
+1.14.0