Compare commits

..
512 Commits
Author SHA1 Message Date
Mamadou Babaei 516d246793 bump the plugin version to v2.6.1 2025-06-05 13:20:13 +02:00
Mamadou Babaei 7fb4c7b5eb changelog fixes 2025-06-05 12:38:32 +02:00
Mamadou Babaei 4009892861 bump senseglove libraries to v2.204.0-3a37b1977 2025-06-05 12:38:31 +02:00
Mamadou Babaei f540872fa3 fix a changelog typo 2025-06-05 12:38:29 +02:00
Mamadou Babaei 538f99712b bump the plugin version to v2.6.0 2025-06-04 02:33:17 +02:00
Mamadou Babaei b3ccc1f274 fix a runuat build issue due to a missing header providing engine version macros 2025-06-04 02:33:17 +02:00
Mamadou Babaei caa08eb94d deprecate ue 5.3 support 2025-06-04 02:23:58 +02:00
Mamadou Babaei 1e9ea621f7 reoder changelog's last entry sections 2025-06-04 02:23:58 +02:00
Mamadou Babaei b9f2d01982 revamp the ubt third-party dependency system 2025-06-04 02:23:58 +02:00
Mamadou Babaei 5907d5bb41 fix build issue with sgbackend by deleting the impl struct copy constructor and copy assignment operator 2025-06-04 02:23:58 +02:00
Mamadou Babaei f502ee2cb9 fix a closing #endif directive comment 2025-06-04 02:23:58 +02:00
Mamadou Babaei 77d0b4858b minor code formatting fix 2025-06-04 02:23:58 +02:00
Mamadou Babaei fb1ae5a3e9 thread-safe sgbackend initialization 2025-06-04 02:23:58 +02:00
Mamadou Babaei 076a07bc7b thread-safe sglog initialization 2025-06-04 02:23:58 +02:00
Mamadou Babaei 9682585c00 revamp sglog to use unreal's tuniqueptr instead of std::unique_ptr 2025-06-04 02:23:58 +02:00
Mamadou Babaei 73957cfe66 fix critical deadlock between render and game threads in UE 5.6 when invoking IHeadMountedDisplay::GetHMDMonitorInfo() 2025-06-04 02:23:58 +02:00
Mamadou Babaei 48248eecc2 fix sglog windows/msvc build issues caused by the recent sglog refactor 2025-06-04 02:23:58 +02:00
Mamadou Babaei b324258683 update the changelog 2025-06-04 02:23:58 +02:00
Mamadou Babaei b074067667 add a missing header that causes build issues on linux aarch64 due to incomplete uaniminstance type 2025-06-04 02:23:58 +02:00
Mamadou Babaei 4db754109a fix type conversion safety and consistency issues across all sglog formatters 2025-06-04 02:23:58 +02:00
Mamadou Babaei 2981ab4670 fix unreal engine 5.6 string conversion build issues on linux 2025-06-04 02:23:57 +02:00
Mamadou Babaei 304a735e10 Revert "bump embedded winpython distribution to v3.12.10"
This reverts commit 4fe067cf9a.
2025-06-04 02:23:57 +02:00
Mamadou Babaei 2808e0f991 Revert "attempt at fixing handbook's broken make pack on windows by upgrading mdbook-pdf-outline"
This reverts commit 1be45f2cba.
2025-06-04 02:23:55 +02:00
Mamadou Babaei 33c661df43 attempt at fixing handbook's broken make pack on windows by upgrading mdbook-pdf-outline 2025-06-04 02:23:55 +02:00
Mamadou Babaei 0eaa936cb1 bump the SenseGlove Unreal Engine Marketplace Packager to v0.6.0-4108c6f 2025-06-04 02:23:55 +02:00
Mamadou Babaei 1ff40e1a9c bump senseglove libraries to v2.203.0-f3d3e676 which migrates to C++20 2025-06-04 02:23:54 +02:00
Mamadou Babaei 51651d3996 bump embedded winpython distribution to v3.12.10 2025-06-04 02:23:52 +02:00
Mamadou Babaei ffb9f52329 lock the mdbook crate version to v0.49.0 2025-06-04 02:23:50 +02:00
Mamadou Babaei 46e4786b4a bump senseglove libraries to v2.202.0-5d54da32 which fixes linux build issues for ue 5.5/5.6 by linking against libc++ instead of libstdc++ 2025-06-04 02:23:50 +02:00
Mamadou Babaei 0f45c30935 update the outdated directory structure section inside the handbook with the latest changes 2025-06-04 02:23:48 +02:00
Mamadou Babaei ee06a344ae bump the senseglove libraries to libraries to v2.201.0-edef7655 and replace epic native toolchain v24 with v25 2025-06-04 02:23:47 +02:00
Mamadou Babaei 0e4d0128d7 bump the plugin version to v2.5.0 2025-05-09 16:49:02 +02:00
Mamadou Babaei 3fbebe7b2b fix bad warning emoji character inside the platform support matrix 2025-05-09 16:49:02 +02:00
Mamadou Babaei a8c076e3f0 improve the changelog formatting as much as possible 2025-05-09 16:33:46 +02:00
Mamadou Babaei c17d901102 mention ue 5.2 and epic native toolchain v21 removal in the changelog 2025-05-09 16:33:46 +02:00
Mamadou Babaei aafab6d17b minor punctuation fix 2025-05-09 16:33:46 +02:00
Mamadou Babaei 3f1043cf0a update the planned featured completion status with regards to the latest changes 2025-05-09 16:33:45 +02:00
Mamadou Babaei 0bf94a8a77 update the changelog 2025-05-09 16:33:45 +02:00
Mamadou Babaei 747b0e454d bump the SenseGlove libraries to the v2.200.0-0cb715d0 release with BLE (Bluetooth Low Energy) support 2025-05-09 16:33:44 +02:00
Mamadou Babaei ac7318cd16 remove ue 5.2 deployment from sgum-packager 2025-05-09 16:33:43 +02:00
Mamadou Babaei aafa9f585f list the third-party tutorials inside the extra resources section in a categorized manner 2025-05-09 16:33:43 +02:00
Mamadou Babaei fb4c179bb5 minor handbook fixes 2025-05-09 16:33:43 +02:00
Mamadou Babaei f0f125bd00 downgrade mdbook-epub crate to cac03b7f4b151f106f7f05b13da4c33fc098dd2c 2025-05-09 16:33:43 +02:00
Mamadou Babaei 7a9311cc57 fix a broken handbook url 2025-05-09 16:33:43 +02:00
Mamadou Babaei 13dff97554 revamp the sensecom instructions and divide it into ble and btserial sections 2025-05-09 16:33:43 +02:00
Mamadou Babaei e652af89ef bump mdbook-epub crate to the latest v0.4.x 2025-05-09 16:33:42 +02:00
Mamadou Babaei ab6041edd7 fix a critical deadlock issue (UE-212224) in UE 5.5/5.6 during PipelinedFrameState acquisition 2025-05-09 16:32:27 +02:00
Mamadou Babaei 263d36d040 bump the SenseGlove libraries to the v2.199.1-8de3deb9 experimental release with BLE (Bluetooth Low Energy) support 2025-05-09 16:32:26 +02:00
Mamadou Babaei 0b3e9be180 bump the SenseGlove libraries to the v2.199.0-b35c8158 experimental release with BLE (Bluetooth Low Energy) support 2025-05-09 16:32:26 +02:00
Mamadou Babaei c565a109a2 mark ue 5.2 as out of support in the platform support matrix 2025-05-09 16:32:20 +02:00
Mamadou Babaei 24c2a8899f bump the senseglove libraries to the latest experimental ble builds 2025-05-09 16:32:20 +02:00
Mamadou Babaei d3b5463888 add missing changelogs from the previous commit 2025-05-09 16:32:04 +02:00
Mamadou Babaei b5970534a6 revamp android backend initialization error handling and bump the senseglove libraries to the latest experimental ble builds 2025-05-09 16:32:03 +02:00
Mamadou Babaei 4866220217 list the license section inside the overview section as well 2025-05-09 16:31:47 +02:00
Mamadou Babaei a8872273b5 fix a main menu title missing keyword 2025-05-09 16:31:47 +02:00
Mamadou Babaei 4a86784b37 a minor punctuation fix in the changelog 2025-05-09 16:31:47 +02:00
Mamadou Babaei 98717ab1fa add sgble and sgblexx rust dependency licenses 2025-05-09 16:31:47 +02:00
Mamadou Babaei f6ffc63399 bump the senseglove libraries to a ble-aware version that resolves android build issues 2025-05-09 16:31:45 +02:00
Mamadou Babaei 6e06f6b73e bump sgconnect for android to an experimental unreleased ble-aware implementation 2025-05-09 16:31:44 +02:00
Mamadou Babaei eaa979f6e8 bump senseglove libraries to a yet to be versioned, experimental release, with ble support 2025-05-09 16:31:43 +02:00
Mamadou Babaei d402c60a86 add initial support for epic native toolchain v24 2025-05-09 16:31:27 +02:00
Mamadou Babaei 4483d41b69 bump the senseglove libraries to v2.106.0-d5361a48 2025-05-09 16:31:27 +02:00
Mamadou Babaei 094854c248 bump the plugin version to v2.4.2 2025-02-17 13:28:26 +01:00
Mamadou Babaei 0f4dfea8ad list the third-party tutorials with a description in their corresponding parent sections 2025-02-17 13:28:25 +01:00
Mamadou Babaei 6bf4bebec1 bump the plugin version to v2.4.1 2025-02-14 15:11:42 +01:00
Mamadou Babaei 0e07d50414 fix a bug that breaks the custom styles on the release urls 2025-02-14 15:06:31 +01:00
Mamadou Babaei 35d2d75f12 apply a minor handbook makefile fix 2025-02-14 15:06:31 +01:00
Mamadou Babaei 4324cb0408 bump the plugin version to v2.4.0 2025-02-14 12:21:02 +01:00
Mamadou Babaei 054b4e0499 update the list of supported hmds in the planned features completion status 2025-02-14 12:07:21 +01:00
Mamadou Babaei f1b88ce752 remove meta xr plugin compatibility from the planned features completion status 2025-02-14 12:07:21 +01:00
Mamadou Babaei 397391a8d3 fix documentation errors and confusions 2025-02-14 12:07:21 +01:00
Mamadou Babaei 80921188ad list the vrexpansion plugin demo in the extra resources section 2025-02-14 12:07:21 +01:00
Mamadou Babaei 7f38355efa Revert "experiment with a hacky approach to make metaxr work"
This reverts commit f3bc6502e4.
2025-02-14 12:07:21 +01:00
Mamadou Babaei adbc7ef437 Revert "add SetupMetaXRAvailability during the build time to define WITH_METAXR"
This reverts commit e2c50e9c77.
2025-02-14 12:07:21 +01:00
Mamadou Babaei c9838bd7e2 remove metaxr compatibility from the documentation along with its assets and replace it with a caution incompatibility note 2025-02-14 12:07:21 +01:00
Mamadou Babaei 736f5adaee remove metaxr compatibility notes from the changelog for this release 2025-02-14 12:07:21 +01:00
Mamadou Babaei 26e063f852 minor changelog fixes 2025-02-14 12:07:21 +01:00
Mamadou Babaei bd667dca73 minor documentation fixes 2025-02-14 12:07:21 +01:00
Mamadou Babaei 84f50fe929 add notes in regards to pcvr and standlone modes support for vive and meta hmds 2025-02-14 12:07:21 +01:00
Mamadou Babaei f727212096 fix the platform support matrix formatting 2025-02-14 12:07:21 +01:00
Mamadou Babaei f45d234b59 add a deprecation note for ue 5.2 2025-02-14 12:07:21 +01:00
Mamadou Babaei 2617438c36 mark ue 5.5 meta quest standalone mode as supported 2025-02-14 12:07:18 +01:00
Mamadou Babaei 275041536c mark ue 5.5 meta quest standalone mode as supported 2025-02-14 12:04:24 +01:00
Mamadou Babaei f159542318 add a few third-party tutorials 2025-02-14 12:03:15 +01:00
Mamadou Babaei 69498f44d9 minor url fix 2025-02-14 12:03:15 +01:00
Mamadou Babaei c1fa8feda8 experiment with a hacky approach to make metaxr work 2025-02-14 12:03:15 +01:00
Mamadou Babaei 3d49e96635 add SetupMetaXRAvailability during the build time to define WITH_METAXR 2025-02-14 12:03:14 +01:00
Mamadou Babaei c3ada5ffd9 fix the changelog's grammatical issues and typos 2025-02-14 12:03:14 +01:00
Mamadou Babaei bc2017ef31 add missing headers to solve runuat build issues 2025-02-14 12:03:14 +01:00
Mamadou Babaei e7876c1075 add htc vive optimal rendering settings 2025-02-14 12:03:14 +01:00
Mamadou Babaei da2f12b2ce add htc vive specific optimization tips for running in standalone mode 2025-02-14 12:03:14 +01:00
Mamadou Babaei 2fc8941888 update viveopenxr XR_EXT_hand_tracking and wrist-tracking documentation with more accurate details 2025-02-14 12:03:14 +01:00
Mamadou Babaei db688b6c64 add initial ultimate tracker and OpenXRXrTracker support which is not fully functional 2025-02-14 12:03:14 +01:00
Mamadou Babaei cd0321cc36 bring the wrist-tracking hardware setup and XR_EXT_hand_tracking documentation on par with the recent changes 2025-02-14 12:03:14 +01:00
Mamadou Babaei ffb8b194be clear up debug logs 2025-02-14 12:03:14 +01:00
Mamadou Babaei a828e5249d add support for htc vive wrist trackers on android 2025-02-14 12:03:14 +01:00
Mamadou Babaei 763f7d8969 fix a comment formatting 2025-02-14 12:03:14 +01:00
Mamadou Babaei a185009927 fix a typo 2025-02-14 12:03:14 +01:00
Mamadou Babaei 64ae994db5 add support for htc vive focus vision hmd auto-detection and various htc hmds auto-detection support on android 2025-02-14 12:03:14 +01:00
Mamadou Babaei 88b53886be optimize FSGArrayUtils by pre-allocating memory instead of growing by every emplace_back or add 2025-02-14 12:03:11 +01:00
Mamadou Babaei 011387de52 fix a comment 2025-02-14 12:02:28 +01:00
Mamadou Babaei 6f1b5231c9 use fixed-width integers 2025-02-14 12:02:28 +01:00
Mamadou Babaei 0caca84fd7 clarify how to setup the VIVE Wrist Trackers in various configurations 2025-02-14 12:02:28 +01:00
Mamadou Babaei af198a51b8 add ue 5.2 deprectation notes to the changelog 2025-02-14 12:02:28 +01:00
Mamadou Babaei 084e075cc0 minor comment fixes 2025-02-14 12:02:28 +01:00
Mamadou Babaei dd7434a900 remove redundant sgxrtracker code 2025-02-14 12:02:28 +01:00
Mamadou Babaei 64f9d1597c use engine api to set the tracking motion source 2025-02-14 12:02:28 +01:00
Mamadou Babaei c58473a7e7 fix the non-editor build issues caused by the recent motion sources refactor 2025-02-14 12:02:28 +01:00
Mamadou Babaei 67810c0e7f refactor the way we populate and utilize motion sources for viveopenxr compatibility 2025-02-14 12:02:28 +01:00
Mamadou Babaei d8c308e1ef remove redundant dependency module 2025-02-14 12:02:28 +01:00
Mamadou Babaei b0cf3eb6b5 add the FSGPluginUtils utility class for other plugins or modules availability detection such as Meta XR and ViveOpenXR 2025-02-14 12:02:28 +01:00
Mamadou Babaei bfaa5c39da mention meta xr and viveopenxr plugins compatibility in the planned features completion status 2025-02-14 12:01:34 +01:00
Mamadou Babaei b4b3db2bd8 revamp the Enabling XR_EXT_hand_tracking OpenXR Extension on VR Headsets and Deploying to Android (Standalone) documentation and the Meta XR-compatibile and ViveOpenXR-compatibile instructions 2025-02-14 12:01:32 +01:00
Mamadou Babaei 3d5b406765 add FSGConnectJNI::Initialize() and FSGCoreJNI::Initialize() return codes to Android logs for detailed debugging purposes through adb logcat 2025-02-14 12:00:58 +01:00
Mamadou Babaei 480028c2e1 add a missing url 2025-02-14 12:00:58 +01:00
Mamadou Babaei a233a0e8d7 apply some minor changelog fixes 2025-02-14 12:00:58 +01:00
Mamadou Babaei 6c5149dc48 update the changelog with the unreleased changes 2025-02-14 12:00:58 +01:00
Mamadou Babaei f6155ec882 use ue 5.5 header github links in the fxrmotioncontrollerdata page since its removal is likey in ue 5.6 2025-02-14 12:00:58 +01:00
Mamadou Babaei 596f790c5f fixed a few broken URLs caused by bad markdown formatting 2025-02-14 12:00:58 +01:00
Mamadou Babaei d19687bdd6 update the changelog with the unreleased changes 2025-02-14 12:00:58 +01:00
Mamadou Babaei 935e436ecb bump the SenseGlove Unreal Engine Marketplace Packager v0.5.0-7df1183 2025-02-14 12:00:57 +01:00
Mamadou Babaei 6c4c51d85f make the handbook scp operations safer by utilizing quotes 2025-02-14 12:00:57 +01:00
Mamadou Babaei 4efb53c3d8 reintroduce Michael-F-Bryan/mdbook-epub backend for the handbook as its issue #115 have been solved 2025-02-14 12:00:57 +01:00
Mamadou Babaei 763c905c51 make the handbook makefile safer by wrapping files/folder navigations/operations in quotes 2025-02-14 12:00:57 +01:00
Mamadou Babaei 1df921eb75 remove a redundant copy from the handbook makefile 2025-02-14 12:00:57 +01:00
Mamadou Babaei 73ad2ae278 remove redundant steps from the handbook makefile 2025-02-14 12:00:57 +01:00
Mamadou Babaei 80b46c643b remove unused variable SG_DOCUMENTATION_EPUB_DIR from the handbook makefile 2025-02-14 12:00:57 +01:00
Mamadou Babaei 4b7eb8d5dd migrate the documentation changelogs for the next unreleased version to its own section 2025-02-14 12:00:53 +01:00
Mamadou Babaei 0cc7871b71 bump the mdbook-alerts crate to v0.7.x 2025-02-14 11:59:32 +01:00
Mamadou Babaei d47dd364ae bump the SenseGlove libraries to v2.105.3-97ea18cb 2025-02-14 11:59:31 +01:00
Mamadou Babaei 7d257f273c update the changelog with unreleased changes 2025-02-14 11:59:31 +01:00
Mamadou Babaei fa0be3be2a bump the SenseGlove Unreal Engine Marketplace Packager v0.4.1-e39a4f4 2025-02-14 11:59:31 +01:00
Mamadou Babaei bf2a643923 fix the changelog formatting 2025-02-14 11:59:31 +01:00
Mamadou Babaei e0bd96f528 bump the copyright years 2025-02-14 11:59:30 +01:00
Mamadou Babaei 1a47714b6f clarify htc vive stand-alone support status in the platform support matrix 2025-02-14 11:59:26 +01:00
Mamadou Babaei 0b9ea54816 bump the plugin version to v2.3.2 2025-01-28 14:39:14 +01:00
Mamadou Babaei 685a4341c7 fix a critical issue where HandStates->GetTransform(KeyPoint) was incorrectly resolving to (&HandStates[0])->GetTransform(KeyPoint), causing both hands to use the left hand's wrist transform under specific conditions 2025-01-28 14:34:20 +01:00
Mamadou Babaei c0ed6f0554 bump the plugin version to v2.3.1 2024-11-27 10:11:14 +01:00
Mamadou Babaei 15aaf4f73c do an ensure check instead of silently ignoring the non-existent joint 2024-11-27 10:11:14 +01:00
Mamadou Babaei e5c11adec3 calculate the bone ref transforms using the current mesh rather than the reference mesh 2024-11-27 10:11:14 +01:00
Mamadou Babaei 5075b0bc17 white space and code formatting fixes 2024-11-27 10:11:14 +01:00
Mamadou Babaei 0c2ab3aa7b bump the plugin version to v2.3.0 2024-11-14 00:30:27 +01:00
Mamadou Babaei 98dba77a02 fix ue 5.5 deprecation warnings inside USGVirtualHandComponent 2024-11-14 00:26:03 +01:00
Mamadou Babaei e152842ead fix rocket build issues by adding missing the headers 2024-11-14 00:26:03 +01:00
Mamadou Babaei 3a59442cda list AndroidPermission plugin as a dependency 2024-11-14 00:26:03 +01:00
Mamadou Babaei 4a3db0b35a remove comments that probably pasted by mistake 2024-11-14 00:26:03 +01:00
Mamadou Babaei afdaaf4950 revamp the way the plugin requests permisions on Android by showing a pop-up to the user rather than silently crashing if those permisions were not already given 2024-11-14 00:26:03 +01:00
Mamadou Babaei 3e1bae1e9a implement the android permissions singleton responsible for requesting android permissions and checking those 2024-11-14 00:26:03 +01:00
Mamadou Babaei 60f09035ba re-order the required permissions alphabetically inside the android upl file 2024-11-14 00:26:03 +01:00
Mamadou Babaei 080e83a344 make the USGBackend constructor private 2024-11-14 00:26:03 +01:00
Mamadou Babaei 9a35132911 remove USGBackend class config specifier 2024-11-14 00:26:03 +01:00
Mamadou Babaei 5a2ed01e59 apply a minor formatting fix to the changelog 2024-11-14 00:26:03 +01:00
Mamadou Babaei 1cbe24a4c9 bump the plugin version to v2.2.2 2024-11-08 12:24:07 +01:00
Mamadou Babaei 1e11ab6320 fix a chain of glove and hand-tracking bugs that render the hand-tracking state invalid at certain times 2024-11-08 12:24:07 +01:00
Mamadou Babaei 551e625c1f bump the plugin version to v2.2.1 2024-10-23 14:47:23 +02:00
Mamadou Babaei 287a81356d revise documentation to point to fab instead of ue marketplace 2024-10-23 14:47:23 +02:00
Mamadou Babaei 02690badc6 bump the plugin version to v2.2.0 2024-10-22 06:42:53 +02:00
Mamadou Babaei ba4441655f list ue 5.5 in the sgum-packager configuration file 2024-10-22 06:42:53 +02:00
Mamadou Babaei 9b361f5ef9 include Runtime/Launch/Resources/Version.h only where it matters 2024-10-22 06:42:52 +02:00
Mamadou Babaei 22210f05f0 add the documentation on consuming the FXRHandTrackingState struct in both Blueprint and C++ 2024-10-22 06:42:52 +02:00
Mamadou Babaei baa2998c8d minor formatting fix 2024-10-22 06:42:52 +02:00
Mamadou Babaei 4b2654a296 change SG_BROWSER_BINARY_PATH_LINUX binary path 2024-10-22 06:42:52 +02:00
Mamadou Babaei 3393a31e5f migrate away from the deprecated FXRMotionControllerData in favor of FXRMotionControllerState and FXRHandTrackingState on UE 5.5+ 2024-10-22 06:42:47 +02:00
Mamadou Babaei 3d274c1734 bump the plugin version to v2.1.4 2024-10-22 05:27:44 +02:00
Mamadou Babaei eb8a8b197b add the missing release title to the v2.1.3 changelog entry 2024-10-22 05:26:49 +02:00
Mamadou Babaei f3f5893fd8 update the documentation on consuming the FXRMotionControllerData struct 2024-10-22 05:26:47 +02:00
Mamadou Babaei c8801a48fa bump the plugin version to v2.1.3 2024-10-11 12:30:22 +02:00
Mamadou Babaei de11ff03c8 update the platform support matrix and also add a note in regards to fab and ue marketplace transition 2024-10-11 12:30:22 +02:00
Mamadou Babaei 42c560c43c add the planned features for the v2.2.x release series 2024-10-11 12:30:22 +02:00
Mamadou Babaei dfdb6017dc silence another ue 5.5 deprecation warning with a temporary workaround for the time being 2024-10-11 12:30:22 +02:00
Mamadou Babaei 2523b54a91 avoid mentioning the patch releases in the planned features completion status page 2024-10-11 12:30:22 +02:00
Mamadou Babaei 1d9ca12cf8 address a few ue 5.5 deprecation warnings 2024-10-11 12:30:22 +02:00
Mamadou Babaei 50599d2832 add a missing header 2024-10-11 12:30:22 +02:00
Mamadou Babaei 843c528fe1 add support for epic native toolchain v23 2024-10-11 12:30:22 +02:00
Mamadou Babaei 33a0bc10b8 bump the senseglove libraries to v2.105.2-f2de4b89 2024-10-11 12:30:21 +02:00
Mamadou Babaei 2dfb39842e fix code formatting 2024-10-11 12:30:21 +02:00
Mamadou Babaei bae22c36f5 remove a redundant header 2024-10-11 12:30:21 +02:00
Mamadou Babaei cfa01f1b97 fix a bug inside USGVirtualHandComponent::PostEditChangeProperty() where the get member name check happens against the wrong class and member names 2024-10-11 12:30:21 +02:00
Mamadou Babaei ab72a893e5 fix a grammatical typo in a comment 2024-10-11 12:30:21 +02:00
Mamadou Babaei 5c902276e9 bump the plugin version to v2.1.2 2024-09-02 19:38:01 +02:00
Mamadou Babaei 63ff7ba433 update the changelog 2024-09-02 19:38:01 +02:00
Mamadou Babaei 4ee17604dd update the changelog 2024-09-02 19:38:01 +02:00
Mamadou Babaei 937b298d83 fix a few virtual hand component visibility issues 2024-09-02 19:38:01 +02:00
Mamadou Babaei 5c33917333 fix the non-existent default hand-mesh warnings polluting the logs when packaging the game 2024-09-02 19:38:01 +02:00
Mamadou Babaei 6d2103bb9b update the changelog 2024-09-02 19:38:01 +02:00
Mamadou Babaei 0b30940ee7 fix the wrong script name for USXRTrackerKismetLibrary 2024-09-02 19:38:01 +02:00
Mamadou Babaei ba92e4313d fix the wrong script name for USGHMDTrackerKismetLibrary 2024-09-02 19:38:01 +02:00
Mamadou Babaei c9e8e24ee0 expand the clickable area on the handbook index page revision buttons 2024-09-02 19:38:01 +02:00
Mamadou Babaei f19f76d439 an overview title fix to match the summary file 2024-09-02 19:38:00 +02:00
Mamadou Babaei 3ddef7fe40 bump the SenseGlove Unreal Engine Plugin to v2.1.1 2024-08-18 01:46:19 +02:00
Mamadou Babaei 98c40746d2 fix documentation typos 2024-08-18 01:46:19 +02:00
Mamadou Babaei 59f8e1a71a fix a bug where SG_GIT_IS_SHALLOW_CLONE while building the handbook is always set to yes even if it's not a shadow clone 2024-08-18 01:32:14 +02:00
Mamadou Babaei 5a9768b42e removed android ndk r25 armv7 and x86 dependencies brought back by mistake while merging v2.1.0 from the dev branch to the master branch 2024-08-18 00:53:07 +02:00
Mamadou Babaei fc679a9f42 fix a bug that causes a handbook revision mismatch when deploying the handbook from the dev branch 2024-08-18 00:27:05 +02:00
Mamadou Babaei 978883d19b fix the messed up changelog file caused by cherry-picking merge conflicts between the dev branch and the master branch 2024-08-18 00:05:25 +02:00
Mamadou Babaei afc2c75b85 bump the plugin version to v2.1.0 2024-08-16 19:53:26 +02:00
Mamadou Babaei f37273bb48 fix build issues caused by cherry-pick order between v2.0.x and v2.1.x releases; the dev branch already contains these fixes 2024-08-16 19:52:00 +02:00
Mamadou Babaei ae58cfa20a extract the git version from the remote repo when it's a shallow clone to allow the sgum-packager work with release branches 2024-08-16 19:08:50 +02:00
Mamadou Babaei b49de07ca5 determine the value of mdbook site-url from the makefile instead of hardcoding it per branch 2024-08-16 16:44:35 +02:00
Mamadou Babaei d6f4090951 fix ue 5.4 runuat build issues inside the sggrabcomponent caused by missing headers 2024-08-16 16:44:35 +02:00
Mamadou Babaei c50fa7780f fix a broken url 2024-08-16 16:44:35 +02:00
Mamadou Babaei a77acc4bd7 add make pack to the output of make help 2024-08-16 16:44:35 +02:00
Mamadou Babaei db2208dd67 fix a broken url 2024-08-16 16:44:35 +02:00
Mamadou Babaei a5161f6a84 fix a url 2024-08-16 16:44:35 +02:00
Mamadou Babaei 2fbf161fdd add topic: Upgrade Guide 2024-08-16 16:44:35 +02:00
Mamadou Babaei 32d1f2f6e7 add the sub-topic: Optimizing Unreal Projects for Mobile 2024-08-16 16:44:35 +02:00
Mamadou Babaei d0792c1abe formatting fixes 2024-08-16 16:44:35 +02:00
Mamadou Babaei 9afbf885f3 add topic: Optimizing Your Project for Higher FPS 2024-08-16 16:44:34 +02:00
Mamadou Babaei b19161f964 lock cargo dependencies for the hadbook to pecific major/minor releases and not patch releases 2024-08-16 16:44:34 +02:00
Mamadou Babaei f6878e7ae1 clarify the note about how the separation of the real and virtual hand rendering is broken 2024-08-16 16:44:34 +02:00
Mamadou Babaei c557942d27 fix a typo 2024-08-16 16:44:34 +02:00
Mamadou Babaei d8636b630a remove troublesome inline keywords added by jetbrains rider 2024-08-16 16:44:34 +02:00
Mamadou Babaei 89af27ac7d mark the separation of the real and virtual hand rendering as broken and a note to the known issues section 2024-08-16 16:44:34 +02:00
Mamadou Babaei 909684d36e fix a few bugs that does affect the real hand collision events because of SetVisibility and redundant checking against grabbed actor 2024-08-16 16:44:34 +02:00
Mamadou Babaei 6b0d87cad5 replace SGPawn::FImpl::EnableActorPhysics() and SGPawn::FImpl::DisableActorPhysics() with USGGrabComponent::SimulatePhysics() 2024-08-16 16:44:34 +02:00
Mamadou Babaei 058bc5a87c enable bGravityEnabled, bSimulatePhysics, and call WakeRigidBody on grab component's owning actor at BeginPlay() if bAffectPhysicsState is enabled 2024-08-16 16:44:34 +02:00
Mamadou Babaei 787ab5aa96 document Configuring the SGPawn and Plugin Virtual Hand Mesh Settings as the final step in setting up the virtual hand meshes 2024-08-16 16:44:34 +02:00
Mamadou Babaei dceee38c40 fix a typo 2024-08-16 16:44:34 +02:00
Mamadou Babaei f6784a04ad use the value of GrabAttachPointSocketName from the plugin settings as default for USGGrabComponent's AttachmentSocketName uproperty 2024-08-16 16:44:34 +02:00
Mamadou Babaei dc0178b911 add the sgbasicdemo-openxr repository to the examples and demo projects section 2024-08-16 16:44:34 +02:00
Mamadou Babaei 64d29637cc minor fix 2024-08-16 16:44:34 +02:00
Mamadou Babaei ac6500becd add video tutorials 2024-08-16 16:44:34 +02:00
Mamadou Babaei dc5c0e220e add the contents for setting up the grab/release, and the touch systems 2024-08-16 16:44:33 +02:00
Mamadou Babaei 9b609e881a add another android note 2024-08-16 16:44:33 +02:00
Mamadou Babaei 0720dff14a fix the display name for various overloads of the Blueprint-exposed function Queue Command Vibro Level to expose sensible display names. 2024-08-16 16:44:33 +02:00
Mamadou Babaei 2e63b956d4 a changelog fix 2024-08-16 16:44:33 +02:00
Mamadou Babaei 1301ec957b fix a topic title 2024-08-16 16:44:33 +02:00
Mamadou Babaei 7fd999face minor fix 2024-08-16 16:44:33 +02:00
Mamadou Babaei c772eea773 add topic: Deploying to Android (Standalone) 2024-08-16 16:44:33 +02:00
Mamadou Babaei 931c626669 add a note in regards to meta xr and vive openxr plugins incompatibility 2024-08-16 16:44:33 +02:00
Mamadou Babaei b7a2e79503 add instructions: Setting up the SenseGlove Grab and Touch Sockets 2024-08-16 16:44:33 +02:00
Mamadou Babaei 5d9f763443 remove irrelevant section as it's already set up by the plugin automatically 2024-08-16 16:44:33 +02:00
Mamadou Babaei 08c1d21ce3 mention a relevant video tutorial 2024-08-16 16:44:33 +02:00
Mamadou Babaei 71f1153aee close the div tag properly 2024-08-16 16:44:33 +02:00
Mamadou Babaei 2a636323c4 add the instructions for: Setting up the Rigid Bodies 2024-08-16 16:44:32 +02:00
Mamadou Babaei eb69306ed1 fix license titles 2024-08-16 16:44:32 +02:00
Mamadou Babaei 1577889762 add instructions for importing / exporting compatible virtual hand meshes 2024-08-16 16:44:32 +02:00
Mamadou Babaei b88c124e4b minor fix 2024-08-16 16:44:32 +02:00
Mamadou Babaei 1c776eda27 update the overview section 2024-08-16 16:44:32 +02:00
Mamadou Babaei a77e73379a add the content for setting up the wrist tracking hardware section 2024-08-16 16:44:32 +02:00
Mamadou Babaei 767bd66f62 add important notes for setting up the wrist tracker and virtual hands 2024-08-16 16:44:32 +02:00
Mamadou Babaei dc7ccec543 add the complete documentation for setting up the senseglove default classes 2024-08-16 16:44:32 +02:00
Mamadou Babaei e04a66935e fix a build issue on ue 5.2 2024-08-16 16:44:32 +02:00
Mamadou Babaei fd0749314c apply summary.md changes to the overview page 2024-08-16 16:44:32 +02:00
Mamadou Babaei 4ccd4e63d1 fix borken links 2024-08-16 16:44:32 +02:00
Mamadou Babaei cd8f1ce367 add more topics to the menu 2024-08-16 16:44:32 +02:00
Mamadou Babaei 15e6e17116 minor fix 2024-08-16 16:44:32 +02:00
Mamadou Babaei 29b13be460 add the introduction to the senseglove default classes 2024-08-16 16:44:32 +02:00
Mamadou Babaei daef678e73 fix the wrong content path 2024-08-16 16:44:31 +02:00
Mamadou Babaei 9c5c1c6134 fix README.md broken links 2024-08-16 16:44:31 +02:00
Mamadou Babaei a5fc3ab518 add a caution for bvalidateifdefaultclassesaresgcompliant 2024-08-16 16:44:31 +02:00
Mamadou Babaei 36d4cdde1f fix a typo 2024-08-16 16:44:31 +02:00
Mamadou Babaei c82530cecf add the console commands SG_GetEngineScalabilitySettings and SG_SetEngineScalabilitySettings 2024-08-16 16:44:31 +02:00
Mamadou Babaei 826022ab40 add the license terms for the handbook 2024-08-16 16:44:31 +02:00
Mamadou Babaei 479609686d add the boilerplate for setting up the senseglove default classes 2024-08-16 16:44:31 +02:00
Mamadou Babaei 6526c0e3b3 fix broken links in the overview page by adding .. to the relative urls 2024-08-16 16:44:31 +02:00
Mamadou Babaei ac4fed8a82 fix broken index/readme.md links in the overview page 2024-08-16 16:44:31 +02:00
Mamadou Babaei e19621dea8 minor fix 2024-08-16 16:44:31 +02:00
Mamadou Babaei 5bc78b7dc6 add the content for the overview page 2024-08-16 16:44:31 +02:00
Mamadou Babaei 006165605f minor fix 2024-08-16 16:44:31 +02:00
Mamadou Babaei 76bcfae33a complete the plugin configuration, settings, and overrides, sections 2024-08-16 16:44:31 +02:00
Mamadou Babaei ef5cf020e7 improve the repo's main readme file 2024-08-16 16:44:30 +02:00
Mamadou Babaei 96d2f5fb60 reference the handbook's extra resources 2024-08-16 16:44:30 +02:00
Mamadou Babaei 3c606100f8 bring on par the SGSettings blueprint api with the cpp api 2024-08-16 16:44:30 +02:00
Mamadou Babaei ee8b209055 add some custom css styles for better html formatting 2024-08-16 16:44:30 +02:00
Mamadou Babaei d8a4c7bc81 add the plugin-settings section 2024-08-16 16:44:30 +02:00
Mamadou Babaei 79309f66d0 add a note about Hand and Body Tracking settings 2024-08-16 16:44:30 +02:00
Mamadou Babaei 57c34ea44b add the sensecom documentation 2024-08-16 16:44:30 +02:00
Mamadou Babaei 1a26d4a465 add a caution in regards to broken meta quest hmds on steamvr 2024-08-16 16:44:30 +02:00
Mamadou Babaei f3e21842b3 fix youtube video urls 2024-08-16 16:44:30 +02:00
Mamadou Babaei 81186177e6 whitespace fix 2024-08-16 16:44:30 +02:00
Mamadou Babaei 4211633ce5 add the low level api documentation 2024-08-16 16:44:30 +02:00
Mamadou Babaei 2c790d7b5f complete installation instructions 2024-08-16 16:44:30 +02:00
Mamadou Babaei e8317c31b2 Revert "move bFallbackToHandTrackingIfNoGloveDetected from tracking settings to glove tracking settings"
This reverts commit e16c1d216f.
2024-08-16 16:44:30 +02:00
Mamadou Babaei fac9e0e7ce move bFallbackToHandTrackingIfNoGloveDetected from tracking settings to glove tracking settings 2024-08-16 16:44:30 +02:00
Mamadou Babaei aff68a4673 add an important alert 2024-08-16 16:44:30 +02:00
Mamadou Babaei 6a4294467b minor fixes 2024-08-16 16:44:29 +02:00
Mamadou Babaei 008a3bbc0d fix a broken link 2024-08-16 16:44:29 +02:00
Mamadou Babaei f93bc57349 add instructions: Enabling XR_EXT_hand_tracking OpenXR extension on VR Headsets 2024-08-16 16:44:29 +02:00
Mamadou Babaei e3b9382649 add topic: Extra Resources 2024-08-16 16:44:29 +02:00
Mamadou Babaei aba3dfdf8f add instructions: Safe and Reliable Glove Access in Blueprint 2024-08-16 16:44:29 +02:00
Mamadou Babaei c7e91d0050 center all youtube videos 2024-08-16 16:44:29 +02:00
Mamadou Babaei 0ead89d3e5 add instructions: Enabling The SenseGlove Unreal Engine Plugin and Veirfying the Plugin Version 2024-08-16 16:44:29 +02:00
Mamadou Babaei e3659e23e6 whitespace fix 2024-08-16 16:44:29 +02:00
Mamadou Babaei 81b3a194cd add the epic games launcher installation instructions 2024-08-16 16:44:29 +02:00
Mamadou Babaei ac8056bc46 replace inline code blocks with back tilde inside the changelog 2024-08-16 16:44:29 +02:00
Mamadou Babaei 0d0e6f8c2e update the changelog 2024-08-16 16:44:29 +02:00
Mamadou Babaei 34b62b30d0 revamp the main readme file with the latest information and instructions 2024-08-16 16:44:29 +02:00
Mamadou Babaei 29905ef100 change the DocsURL from the old blueprint docs to the handbook 2024-08-16 16:44:29 +02:00
Mamadou Babaei 4b4c877325 improve the main index layout 2024-08-16 16:44:28 +02:00
Mamadou Babaei cd2af222a8 make the main index generation code more readable 2024-08-16 16:44:28 +02:00
Mamadou Babaei af60f75096 deploy the favicon to the main index as well 2024-08-16 16:44:28 +02:00
Mamadou Babaei 50b84f2d63 bump the SenseGlove Unreal Engine Marketplace Packager v0.4.0-a65bb20 2024-08-16 16:44:28 +02:00
Mamadou Babaei 0a950132b3 fix the windows cmd.exe issues with rename/copy and always use move when invoking the pack target 2024-08-16 16:44:28 +02:00
Mamadou Babaei d1ac264b98 remove the changelog.md file from filterplugin list and list the pdf and html documentation files 2024-08-16 16:44:28 +02:00
Mamadou Babaei 3ae36f4924 minor fixes 2024-08-16 16:44:28 +02:00
Mamadou Babaei 82214ee448 document for dependencies 2024-08-16 16:44:28 +02:00
Mamadou Babaei d910c17422 mention the purpose of make pack in the handbook readme file 2024-08-16 16:44:28 +02:00
Mamadou Babaei 69478003e3 add make pack target to the handbook makefile 2024-08-16 16:44:28 +02:00
Mamadou Babaei 5736076af7 try to fix rsync error on windows: error in rsync protocol data stream (code 12) 2024-08-16 16:44:28 +02:00
Mamadou Babaei afe3b59ced fix the windows rsync/git bash issue: the source and destination cannot both be remote 2024-08-16 16:44:28 +02:00
Mamadou Babaei 803cd87184 add a deployment note in regards to sourcing the deployment configurations on windows + git bash setups 2024-08-16 16:44:28 +02:00
Mamadou Babaei 46e09d45a2 introduce #sg-handbook-revision-url and #sg-handbook-revision-url + other preprocessor improvements 2024-08-16 16:44:27 +02:00
Mamadou Babaei ae162babf4 add the initial implementation for the deploy target 2024-08-16 16:44:27 +02:00
Mamadou Babaei e2314a1356 revamp the handbook make targets 2024-08-16 16:44:27 +02:00
Mamadou Babaei 28815f1a92 fix the broken pdf toc generation on linux 2024-08-16 16:44:27 +02:00
Mamadou Babaei 8ed1746a09 replace all bitfield uproperties with booleans 2024-08-16 16:44:27 +02:00
Mamadou Babaei 6ea5171c28 adjust the exclusion list to the latest repo structure overhaul 2024-08-16 16:44:27 +02:00
Mamadou Babaei ceb292a489 merge the pack branch into the plugin's source and add the sgum-packager v0.3.0 utility for automatic packaging and deployment to epic marketplace 2024-08-16 16:44:27 +02:00
Mamadou Babaei 0a726b7e8b winpython fixes and fix pdf-outline generation on gentoo using a temporary python env 2024-08-16 16:44:27 +02:00
Mamadou Babaei 13dd3c8e18 minor fixes and clean up 2024-08-16 16:44:26 +02:00
Mamadou Babaei 20bcd6396a replace inline code blocks with back tilde 2024-08-16 16:44:26 +02:00
Mamadou Babaei 52d6a613e4 complete advanced-topics/openxr/consuming-fxrmotioncontrollerdata/cpp tutorial 2024-08-16 16:44:26 +02:00
Mamadou Babaei 08903f0d17 set the default value of bValidateIfDefaultClassesAreSGCompliant to false 2024-08-16 16:44:26 +02:00
Mamadou Babaei 7f46c67eda crop the image edge 2024-08-16 16:44:26 +02:00
Mamadou Babaei 5a59065c02 add winpython and enable pdf-outline 2024-08-16 16:44:26 +02:00
Mamadou Babaei 31802a35f2 complete advanced-topics/openxr/consuming-fxrmotioncontrollerdata/blueprint tutorial 2024-08-16 16:44:25 +02:00
Mamadou Babaei 7660388dae fix a bug where tracking status not being set when the hand data is valid 2024-08-16 16:44:25 +02:00
Mamadou Babaei 47b4221fd6 specify the browser binary path from the gnu-make file 2024-08-16 16:44:25 +02:00
Mamadou Babaei 05bc8a34d6 formatting fix 2024-08-16 16:44:25 +02:00
Mamadou Babaei 10f650bfff add partial content to Handbook/src/advanced-topics/openxr/consuming-fxrmotioncontrollerdata/blueprint.md 2024-08-16 16:44:25 +02:00
Mamadou Babaei 00cbccf7ba minor fix 2024-08-16 16:44:25 +02:00
Mamadou Babaei 627bc6886e add links to the ue source code from github 2024-08-16 16:44:25 +02:00
Mamadou Babaei 29ccab3e52 add the blueprint title line 2024-08-16 16:44:25 +02:00
Mamadou Babaei 0294ff987b minor fix 2024-08-16 16:44:25 +02:00
Mamadou Babaei d27de2314d minor fix 2024-08-16 16:44:25 +02:00
Mamadou Babaei ea770c77bb mention the pdf format as well 2024-08-16 16:44:25 +02:00
Mamadou Babaei c39e25773d add mdbook-pdf support which is able to print pdfs using chromedevtools protocol retaining images 2024-08-16 16:44:25 +02:00
Mamadou Babaei e9a2b4f238 remove cargo installs for typst-cli, mdbook-typst, and mdbook-epub 2024-08-16 16:44:24 +02:00
Mamadou Babaei 115d91848d move the /assets/* content to their relative folders as it creates printing issues 2024-08-16 16:44:24 +02:00
Mamadou Babaei 1091183e94 add the content for the Consuming FXRMotionControllerData section 2024-08-16 16:44:24 +02:00
Mamadou Babaei 798927f0a8 replace c++ standard int type definitions with the ones from unreal 2024-08-16 16:44:24 +02:00
Mamadou Babaei 14f56c3a97 remove the pdf and epub backend due to build errors and inability to show markdown images 2024-08-16 16:44:24 +02:00
Mamadou Babaei a0d731e036 consider the value of site-url when verifying the handbook revision and simplify the makefile code to do so as well 2024-08-16 16:44:24 +02:00
Mamadou Babaei 8de4dd1557 make the default site-url next 2024-08-16 16:44:24 +02:00
Mamadou Babaei 78fbb95c10 mention the pdf and epub formats as well and rename the pdf output filename 2024-08-16 16:44:24 +02:00
Mamadou Babaei f14639dddc rename a page 2024-08-16 16:44:24 +02:00
Mamadou Babaei a538f840fa switch to typst-cli from crates.io instead of git 2024-08-16 16:44:24 +02:00
Mamadou Babaei 47fbe92dbe bump senseglove libraries to v2.104.1-55fddbd2 2024-08-16 16:44:22 +02:00
Mamadou Babaei 1fb2f26217 fix the inro notice 2024-08-16 16:43:25 +02:00
Mamadou Babaei 2e3c2c0af7 fix a table column header 2024-08-16 16:43:25 +02:00
Mamadou Babaei 6730398b0f remove edit-url-template from the book.toml file 2024-08-16 16:43:25 +02:00
Mamadou Babaei f413334d9b minor fix 2024-08-16 16:43:25 +02:00
Mamadou Babaei cae2267812 remove mdbook-lintcheck 2024-08-16 16:43:25 +02:00
Mamadou Babaei 31f138f982 add github flavored markdown alerts to the handbook 2024-08-16 16:43:25 +02:00
Mamadou Babaei 1b034df2bd add experimental mdbook plugins for epub and pdf generation 2024-08-16 16:43:25 +02:00
Mamadou Babaei 6220aa2b12 fix the mdbook errors 2024-08-16 16:43:25 +02:00
Mamadou Babaei 12263f0133 add more change logs 2024-08-16 16:43:25 +02:00
Mamadou Babaei c0e517ec35 add more change logs 2024-08-16 16:43:25 +02:00
Mamadou Babaei 73e947d8c3 update the changelog with many of the recent changes 2024-08-16 16:43:25 +02:00
Mamadou Babaei 95368c9640 minor changelog fix 2024-08-16 16:43:25 +02:00
Mamadou Babaei 1d59115d92 add FSGDebugCube 2024-08-16 16:43:25 +02:00
Mamadou Babaei f852ede634 reorganize the handbook structure and add new sections 2024-08-16 16:43:24 +02:00
Mamadou Babaei e82aed2625 rename SGGameUserSettingSettings to SGGameUserSettingsSettings 2024-08-16 16:43:24 +02:00
Mamadou Babaei 641ae2897c rename SGHardwareBenchmarkSettings to SGHardwareBenchmarkingSettings 2024-08-16 16:43:24 +02:00
Mamadou Babaei ef5cbb40ea apply the plugin settings when the user overrides the settings for the first time 2024-08-16 16:43:24 +02:00
Mamadou Babaei d57963db27 do not ensure as it's possible to get a nullpointer during component uninitialization 2024-08-16 16:42:45 +02:00
Mamadou Babaei dbc2a7ea08 re-implement the virtual hand settings overrides; and apply plenty of other improvements and bug fixes to the settings system; and introduce sgdebugcubesettings 2024-08-16 16:42:18 +02:00
Mamadou Babaei 8b1b1c6a96 rename verify-build-type target to verify-handbook-revision 2024-08-16 16:37:28 +02:00
Mamadou Babaei c805b310ba rename verify-build-type target to verify-build-revision 2024-08-16 16:37:28 +02:00
Mamadou Babaei 93e42cdba9 remove the motion source wrist tracking overrides from the wrist tracker component due to the fact that it's utilized only inside the underlying tracking module and overriding it has no effects 2024-08-16 16:37:28 +02:00
Mamadou Babaei 740660fac4 re-implement the wrist tracking settings overrides 2024-08-16 16:37:28 +02:00
Mamadou Babaei ac1af0512c rename bInIsVisibleWhenHandDataUnavailable to bInVisibleWhenHandDataUnavailable 2024-08-16 16:37:28 +02:00
Mamadou Babaei 580fc4200a apply some sgxrtracker enum parsing improvements 2024-08-16 16:37:28 +02:00
Mamadou Babaei 76d67927f8 rename bIsVirtualHandVisible to bVirtualHandVisible 2024-08-16 16:37:28 +02:00
Mamadou Babaei 15e3aa25b8 delete the engine utils default constructor and destructor 2024-08-16 16:37:28 +02:00
Mamadou Babaei 2e4fa23fa3 add the editor utils class 2024-08-16 16:37:27 +02:00
Mamadou Babaei 1fd9299fbd fix the debug virtual hand settings and logic 2024-08-16 16:37:27 +02:00
Mamadou Babaei 378b9d60de fix a comment 2024-08-16 16:37:27 +02:00
Mamadou Babaei f05c11b8a7 introduce the senseglove unreal engine handbook 2024-08-16 16:37:27 +02:00
Mamadou Babaei a3c7ab41b8 a const correctness fix 2024-08-16 16:37:27 +02:00
Mamadou Babaei 3e35a655b1 make FSGXRTracker::GetMotionControllerData() behave the same as 5.4 on both 5.2 and 5.3 2024-08-16 16:37:27 +02:00
Mamadou Babaei b886b5952b minor fix 2024-08-16 16:37:27 +02:00
Mamadou Babaei 150155516c update the changelog and clarify what happens when other openxr hand tracking provider's are enabled and the possible workarounds 2024-08-16 16:37:27 +02:00
Mamadou Babaei 2132e70648 workaround the runuat 5.2/5.3 build issue due to missing IOpenXRHMD.h from epic public headers 2024-08-16 16:37:27 +02:00
Mamadou Babaei a876c08ff6 fix various runuat buiild issues 2024-08-16 16:37:27 +02:00
Mamadou Babaei 131658c734 break a circular dependency 2024-08-16 16:37:27 +02:00
Mamadou Babaei 7131e182c3 do not reigger OnGrabStateUpdated and OnTouchStateUpdated at all when the hand mesh is not valid or visible and also some other extra measures to make sure even if they are triggered they won't affect anything 2024-08-16 16:37:27 +02:00
Mamadou Babaei d49c80e470 take into account the device visual type when updating the hand visibility 2024-08-16 16:37:27 +02:00
Mamadou Babaei c5212c287e clarify the meta xr and vive openxr plugins incompatibility 2024-08-16 16:37:27 +02:00
Mamadou Babaei 5e9dfef55e rename variable 2024-08-16 16:37:27 +02:00
Mamadou Babaei 8cfeb76a2f seprate the engine and senseglove module dependency lists 2024-08-16 16:37:27 +02:00
Mamadou Babaei 342fa15b9f implement our own GetMotionControllerData instead of using the one from the XRTrackingSystem as it only picks up the first hand tracking plugin in order to make sure at least internally we use the hand-tracking data from senseglove 2024-08-16 16:37:27 +02:00
Mamadou Babaei f41eb22a33 minor fixes 2024-08-16 16:37:27 +02:00
Mamadou Babaei 912a2f935a mark the SenseGlove settings as DefaultConfig 2024-08-16 16:37:27 +02:00
Mamadou Babaei a554e11d31 add more bluetooth permissions to be able to request access for nearby devices on android api level 32 in addition to 29 2024-08-16 16:37:26 +02:00
Mamadou Babaei 972aa70bf2 add the gradle deprecation warnings 2024-08-16 16:37:26 +02:00
Mamadou Babaei 35597ef3c8 never extend the content browser context menu if any skeletal mesh or skeltons selected at the same time 2024-08-16 16:37:26 +02:00
Mamadou Babaei 75aa84a674 clean up and remove the redundant asset type actions no longer required by the senseglove sockets editor 2024-08-16 16:37:26 +02:00
Mamadou Babaei 506999f690 implement the SenseGlove grab/touch sockets one-click-setup ability on any Epic-compliant virtual hand mesh from within the Unreal Editor's Content Browser, Skeleton Editor, or Skeletal Mesh Editor 2024-08-16 16:37:26 +02:00
Mamadou Babaei b33d7a364d update the implemented features list 2024-08-16 16:37:26 +02:00
Mamadou Babaei ae2207e34c revamp the whole settings system in order to unify the settings across various systems, modules, and api layers 2024-08-16 16:37:26 +02:00
Mamadou Babaei 5bdffb5438 make the virtual hand anim instance proxy safer 2024-08-16 16:37:26 +02:00
Mamadou Babaei 8ae2bc686e minor fix: get object by reference 2024-08-16 16:37:26 +02:00
Mamadou Babaei ebb0c76f67 add the DebugVirtualHandSettings to the Debugging category 2024-08-16 16:37:26 +02:00
Mamadou Babaei f8bec10622 rename SGVirtualHandTrackingSettings to SGVirtualHandSettings 2024-08-16 16:37:26 +02:00
Mamadou Babaei 26daeae7d2 remove the deperecated jcenter repository from the android upl file 2024-08-16 16:37:26 +02:00
Mamadou Babaei 30bdee989d mark the x86 and armeabi-v7a platforms as unsupported inside the android upl file 2024-08-16 16:37:26 +02:00
Mamadou Babaei 8c1c282df5 fix a critical Android crash that happens where the default development hand meshes could not be found 2024-08-16 16:37:26 +02:00
Mamadou Babaei 1b39f7b3d5 remove the hardcoded SG_HAND_MESH_YAW_CORRECTION_OFFSET and rely on FVirtualHandTrackingSettings::RootBoneRotationCorrection 2024-08-16 16:37:26 +02:00
Mamadou Babaei df628d74ed update the changelog 2024-08-16 16:37:26 +02:00
Mamadou Babaei acd04c9593 mention the wrist tracking hardware visualization bug as a known issue with the new openxr system 2024-08-16 16:37:26 +02:00
Mamadou Babaei e6887145a7 fix runuat build issues for ue 5.4 caused by missing headers 2024-08-16 16:37:26 +02:00
Mamadou Babaei 1df2718312 remove redundant header files 2024-08-16 16:37:26 +02:00
Mamadou Babaei 4bd11ac05f fix more runuat issues due to missing headers 2024-08-16 16:37:26 +02:00
Mamadou Babaei d8308fa260 fix runuat build issues for ue 5.2 2024-08-16 16:37:25 +02:00
Mamadou Babaei db287f0137 fix a crash when the wrist-tracker hardware set to auto-detection 2024-08-16 16:37:25 +02:00
Mamadou Babaei 5f524068b9 fix a few build issues 2024-08-16 16:37:25 +02:00
Mamadou Babaei 404d730c18 fix the wrong kismet library class name 2024-08-16 16:37:25 +02:00
Mamadou Babaei 56bea631e2 formatting fix 2024-08-16 16:37:25 +02:00
Mamadou Babaei 49e643e86e update the changelog 2024-08-16 16:37:25 +02:00
Mamadou Babaei 1e4005e3ae whitespace fix 2024-08-16 16:37:25 +02:00
Mamadou Babaei 1468b3b93f add missing header that contains engine version definitions 2024-08-16 16:37:25 +02:00
Mamadou Babaei d6c05603c2 drop the minimal api specifier 2024-08-16 16:37:25 +02:00
Mamadou Babaei 3f124e4938 remove redundant headers 2024-08-16 16:37:25 +02:00
Mamadou Babaei 308d558bc1 remove unnecessary initialization 2024-08-16 16:37:25 +02:00
Mamadou Babaei c9e74743da whitespace fix 2024-08-16 16:37:25 +02:00
Mamadou Babaei 94b37dc4eb fix wrong kismet script names and class exports 2024-08-16 16:37:25 +02:00
Mamadou Babaei b69a95eb58 remove the experimental bHandTrackingVisualizationAllowed feature 2024-08-16 16:37:25 +02:00
Mamadou Babaei 0fae4bbb43 remove SetWristTrackingSettings from the FSGWristTrackerComponent's header file since it does not have any implementation 2024-08-16 16:37:25 +02:00
Mamadou Babaei 07ce39f439 perform a ensure before dereferencing 2024-08-16 16:37:25 +02:00
Mamadou Babaei 2fbf6355ec formatting fix 2024-08-16 16:37:25 +02:00
Mamadou Babaei bc7175bd4f revamp the GetControllerOrientationAndPosition and GetWristTransform to use the same caluclations and get rid of bMotionSourceHandTracking in senseglove joint calculations 2024-08-16 16:37:25 +02:00
Mamadou Babaei 922ba92ed1 check if motioncontrollerdata is valid 2024-08-16 16:37:25 +02:00
Mamadou Babaei ab867121e5 remove the ability to override wrist tracking settings from the wrist tracker component 2024-08-16 16:37:24 +02:00
Mamadou Babaei 003d3f9b26 fix the how we determine the motion source inside the GetControllerOrientationAndPosition and GetControllerTrackingStatus for ue versions earlier than 5.3 2024-08-16 16:37:24 +02:00
Mamadou Babaei f9fb5c61ca add htc vive stand-alone support status to the platform support matrix 2024-08-16 16:37:24 +02:00
Mamadou Babaei 39fa2c476a fix ue 5.2 and 5.3 build issues 2024-08-16 16:37:24 +02:00
Mamadou Babaei 6426f6bca5 update the changelog and the readme 2024-08-16 16:37:24 +02:00
Mamadou Babaei 0405a5b6ad update the changelog 2024-08-16 16:37:24 +02:00
Mamadou Babaei 87359728a8 add the editor user interface for adding the senseglove sockets 2024-08-16 16:37:24 +02:00
Mamadou Babaei e1a6f5c3eb temporarility change the way we calculate the wrist offset 2024-08-16 16:37:24 +02:00
Mamadou Babaei 3666dc4660 remove SGWristTrackerVisualizationComponent 2024-08-16 16:37:24 +02:00
Mamadou Babaei c9aa422dd1 fix a few wrist tracker issues and introduce SGWristTrackerVisualizationComponent 2024-08-16 16:37:24 +02:00
Mamadou Babaei e14440a911 pass outer as the worldcontextobject to glovetracker::getinstance 2024-08-16 16:37:24 +02:00
Mamadou Babaei 7df307d838 make USGGloveTracker::GetInstance as flexible as possible 2024-08-16 16:37:24 +02:00
Mamadou Babaei 3594410478 simplify getworld implementation 2024-08-16 16:37:24 +02:00
Mamadou Babaei 2691f32492 migrate the static getworld to sgengineutils 2024-08-16 16:37:24 +02:00
Mamadou Babaei 77f6d9be90 safer in-editor getworld without the polluting logs 2024-08-16 16:37:24 +02:00
Mamadou Babaei ac51aaefe5 fix the you are not the main thread and the editor is currently in a play mode errors 2024-08-16 16:37:24 +02:00
Mamadou Babaei 3f5dce9438 fix the MarkRenderStateDirty data race condition by gathering as much as data only on the game thread 2024-08-16 16:37:24 +02:00
Mamadou Babaei b660af8938 introduce bValidateIfDefaultClassesAreSGCompliant 2024-08-16 16:37:24 +02:00
Mamadou Babaei a30b4f1b02 fix the blueprint category naming to adhere to the rest of the settings system 2024-08-16 16:37:24 +02:00
Mamadou Babaei 2cc9d616dd move hardware benchmarking settings to its own class 2024-08-16 16:37:24 +02:00
Mamadou Babaei 8af6bc689a disable bFallbackToHandTrackingIfNoGloveDetected by default 2024-08-16 16:37:23 +02:00
Mamadou Babaei 4a864e0c99 fix a bug where sgpawn hand's finger collider interact with the world when the hand is not mesh visible 2024-08-16 16:37:23 +02:00
Mamadou Babaei a79dd67dbf add the USGVirtualHandComponent::OnHandVisibilityChanged() event 2024-08-16 16:37:23 +02:00
Mamadou Babaei 9c727ce60e try to disable collision alltogether when the hand mesh is not visible 2024-08-16 16:37:23 +02:00
Mamadou Babaei 3c25a57964 update the changelog 2024-08-16 16:37:23 +02:00
Mamadou Babaei 9db7fd3463 improve the sgusersettings implementation by introducing custom enum item and more accuracy 2024-08-16 16:37:23 +02:00
Mamadou Babaei 9e6e1f564c implement the game user settings system 2024-08-16 16:37:23 +02:00
Mamadou Babaei 38495f0759 minor formatting fix 2024-08-16 16:37:23 +02:00
Mamadou Babaei 25f72442c4 minor formatting fix 2024-08-16 16:37:23 +02:00
Mamadou Babaei 3d82a3a8c3 add a partial workaround for a bug when the virtual hand inside the game is not visible but still have collisions with other objects inside the scene 2024-08-16 16:37:23 +02:00
Mamadou Babaei eaad77edff add IsAMetaQuestDevice() and IsAHtcViveDevice() methods 2024-08-16 16:37:23 +02:00
Mamadou Babaei d437455c97 fix vive pro detection issues by introducing additional device identifier 2024-08-16 16:37:23 +02:00
Mamadou Babaei a619203446 removed the allbreaker virtual hand model as it's no longer compatible with the openxr integration 2024-08-16 16:37:12 +02:00
Mamadou Babaei 7d4c169a56 fix android build issues 2024-08-16 16:35:06 +02:00
Mamadou Babaei 7d5c106186 update the changelog 2024-08-16 16:34:11 +02:00
Mamadou Babaei 67cb9e5445 remove minor ue 5.1 comments and hints 2024-08-16 16:34:11 +02:00
Mamadou Babaei daa0181540 update the changelog 2024-08-16 16:34:10 +02:00
Mamadou Babaei 52c713ed51 implement bHandTrackingVisualizationAllowed 2024-08-16 16:34:10 +02:00
Mamadou Babaei f2de0ef9de improve the wrist tracking code when using motion controllers 2024-08-16 16:34:10 +02:00
Mamadou Babaei 33f2213f1f refactor the sgxrtracker internals to use transforms as pimpl methods args instead of a combination of fvectors/fquats 2024-08-16 16:34:10 +02:00
Mamadou Babaei 50c39778d2 minor fixes, mostrly formatting 2024-08-16 16:34:10 +02:00
Mamadou Babaei c7897cc734 remove unused pimpl method 2024-08-16 16:34:10 +02:00
Mamadou Babaei 5946803891 remove dead code 2024-08-16 16:34:10 +02:00
Mamadou Babaei 2ba37dc56d even more optimal fxrmotioncontroller data calculations that considers mesh when outputting senseglove data 2024-08-16 16:34:10 +02:00
Mamadou Babaei bd385651c3 document more unreleased changes 2024-08-16 16:34:10 +02:00
Mamadou Babaei 2be26417c9 fix the wrong palm bone names on the allbreaker virtual hand models 2024-08-16 16:33:38 +02:00
Mamadou Babaei 44c2574a62 somewhat unfinished refactored sg bone calculations 2024-08-16 16:33:38 +02:00
Mamadou Babaei 68c3817227 increase the default finger distal phalanges length 2024-08-16 16:33:38 +02:00
Mamadou Babaei ae588ef02d add the senseglove debug kismet module 2024-08-16 16:33:38 +02:00
Mamadou Babaei 8b2bf3786b unfinished improvements based on the last commit 2024-08-16 16:33:38 +02:00
Mamadou Babaei b41546494e attempt at calculating a hand model and feeding it to get hand pose 2024-08-16 16:33:37 +02:00
Mamadou Babaei 9f97e963dd refactor the way we calculate the mesh bone reference transforms to read from the settings system instead of the hardcoded values 2024-08-16 16:33:37 +02:00
Mamadou Babaei 2b07512ee4 add the hard-coded hand defaulet reference bone transfomrs to the virtual hand settings 2024-08-16 16:32:51 +02:00
Mamadou Babaei 4aa76a952b openxr bugfixes and improvements + 1st attempt at calculating the fxrmotioncontrollerdata based off of the hand mesh 2024-08-16 16:32:39 +02:00
Mamadou Babaei a8119fca41 fix more UE 5.4 RunUAT build issues 2024-08-16 16:30:36 +02:00
Mamadou Babaei 84315e146f refactor the animation, wrist tracking, and hand interaction manipulation systems for FXRMotionControllerData compatibility 2024-08-16 16:29:36 +02:00
Mamadou Babaei dccf6ad013 update the readme 2024-08-16 16:29:36 +02:00
Mamadou Babaei 366996a7df implement the OpenXR-compatible hand tracking (XR_EXT_hand_tracking) support 2024-08-16 16:29:36 +02:00
Mamadou Babaei 2d3fa27cb0 rename sgheadmountdisplay to sgheadmounteddisplay 2024-08-16 16:29:36 +02:00
Mamadou Babaei 47bb12b6fe add extra null checks 2024-08-16 16:29:36 +02:00
Mamadou Babaei 26c2252d5b add vive xr elite hmd auto-detection checkes and other vive headset detection bug fixes and improvements 2024-08-16 16:29:36 +02:00
Mamadou Babaei 1d2857dcc1 remove ASGVirtualHandActor 2024-08-16 16:29:35 +02:00
Mamadou Babaei b0cb7b2528 make the sgsettings constructor private 2024-08-16 16:29:35 +02:00
Mamadou Babaei 6f08369551 bump senseglove libraries to v2.102.0-4a8bd81d and drop support for ue 5.1 and epic native toolchain v20 2024-08-16 16:28:33 +02:00
Mamadou Babaei 9b1bbb9657 remove debug logs from FSGHeadMountDisplay::GetDeviceType() 2024-08-16 16:26:30 +02:00
Mamadou Babaei 0cc5f0de09 check hmd auto-detection against various identifiers as the names returns from the engine is not reliable 2024-08-16 16:26:18 +02:00
Mamadou Babaei 07995f23e2 improve vive pro and vive focus 3 detection by utilizing optic resolution to distinguish them 2024-08-16 16:26:06 +02:00
Mamadou Babaei 27dddd1b03 implement hmd and wrist tracker hardware auto-detection fallback when it's not set explicitly 2024-08-16 16:22:42 +02:00
Mamadou Babaei 2dc4499984 bump the plugin version to v2.0.8 2024-07-15 22:22:21 +02:00
Mamadou Babaei e21d92a3ca fix a bug where the sgpawn right-hand grab colliders' default size is mistakenly set to the default value for the left-hand grab colliders at cdo initialization time 2024-07-15 22:15:23 +02:00
Mamadou Babaei 1db86d9778 bump the plugin version to v2.0.7 2024-05-29 12:47:33 +02:00
Mamadou Babaei 0de86b508a make the allbreaker assets compatible with ue 5.1+ again 2024-05-29 12:46:51 +02:00
Mamadou Babaei 65a96a462b bump the plugin version to v2.0.6 2024-05-29 11:40:07 +02:00
Mamadou Babaei 6b7c28c379 bump the plugin version to v2.0.5 2024-05-22 17:32:43 +02:00
Mamadou Babaei af0be8c1f7 fix the wrong palm bone names on the allbreaker virtual hand models 2024-05-22 17:31:58 +02:00
Mamadou Babaei 49a12f64a4 bump the plugin version to v2.0.4 2024-05-17 11:39:57 +02:00
Mamadou Babaei 76d03b1fe8 bump the plugin version to v2.0.3 2024-05-16 20:00:18 +02:00
Mamadou Babaei d8ae5923d5 fix v2.0.2 UE 5.4 RunUAT build issues that mostly caused by missing headers 2024-05-15 04:34:46 +02:00
Mamadou Babaei befb07470e improve target platform detection when building SenseGloveConnectImpl and SenseGloveCoreImpl modules and also distinguish x64 builds from arm64 on windows 2024-05-15 04:34:38 +02:00
Mamadou Babaei b467c679de fix: asking CppCompileEnvironment for a single Architecture, but it has multiple Architectures (arm64, x64) 2024-05-15 04:34:30 +02:00
Mamadou Babaei 9afbd8e54f bump the plugin version to v2.0.2 2024-04-25 12:56:05 +02:00
Mamadou Babaei 4e0d01c3de bump the plugin version to v2.0.1 2024-04-15 15:03:17 +02:00
Mamadou Babaei 8681f78c22 do not call FSGHandLayer::ResetCalibration on every backend initialization 2024-04-15 14:52:20 +02:00
Mamadou Babaei 84e8f46d35 only instantiate the connected glove once instead of recreating and destroying it every frame 2024-04-15 14:52:14 +02:00
Mamadou Babaei 3f0dd4a5b9 bump senseglove libraries to v2.102.0-35d4de3f 2024-04-15 14:52:05 +02:00
Mamadou Babaei d0970504ce fix the wrong header file description sections for the header files 2024-04-15 14:51:58 +02:00
Mamadou Babaei 0c73eccc16 update the changelog with the unreleased changes 2024-04-15 14:51:52 +02:00
Mamadou Babaei f3b9155955 update the outdated platform support matrix remarks 2024-03-23 17:23:03 +01:00
520 changed files with 1062 additions and 4150 deletions
+1 -3
View File
@@ -38,8 +38,6 @@ Resources/**/* filter=lfs diff=lfs merge=lfs -text
# LFS: everything under Source/ThirdParty/
Source/ThirdParty/**/* filter=lfs diff=lfs merge=lfs -text
# Except
Source/ThirdParty/**/*.Build.cs filter= diff= merge= text
# LFS: everything under Handbook/dist/
Handbook/dist/**/* filter=lfs diff=lfs merge=lfs -text
@@ -49,4 +47,4 @@ Handbook/dist/**/* filter=lfs diff=lfs merge=lfs -text
# LFS: sgum-packager Linux and Windows binaries
Packager/sgum-packager filter=lfs diff=lfs merge=lfs -text
Packager/sgum-packager.exe filter=lfs diff=lfs merge=lfs -text
Packager/sgum-packager.exe filter=lfs diff=lfs merge=lfs -text
+4 -3
View File
@@ -365,16 +365,17 @@ clean:
.PHONY: install-build-deps
install-build-deps:
@echo "Installing build dependencies if they have not already been installed..."
@cargo install mdbook --version "0.5.2" --locked
@cargo install mdbook --version "0.4.49" --locked
@cargo install xq --vers "^0.4" --locked
@cargo install mdbook-pdf --vers "0.1.13" --locked
@cargo install mdbook-alerts --vers "^0.7" --locked
@cargo install mdbook-pdf --vers "^0.1" --locked
ifeq ($(SG_BUILD_PLATFORM),$(SG_BUILD_PLATFORM_LINUX))
@echo "Installing mdbook-pdf-outline..."
@python -m venv $(VIRTUAL_ENV) \
&& . $(SG_LINUX_PYTHON_VENV_BIN_DIR)/activate \
&& pip install mdbook-pdf-outline 2>/dev/null
endif # ($(SG_BUILD_PLATFORM),$(SG_BUILD_PLATFORM_LINUX))
@cargo install --git https://github.com/Michael-F-Bryan/mdbook-epub --rev 21a1c8134134201a2d555313447c96e56e2a8996 --locked
@cargo install --git https://github.com/Michael-F-Bryan/mdbook-epub --rev cac03b7f4b151f106f7f05b13da4c33fc098dd2c --locked
################################################################################
# Make Targets - mdBook
+5 -5
View File
@@ -33,8 +33,8 @@ fi
readonly JSON_INPUT=$(cat)
readonly CONTEXT=$(printf '%s' "${JSON_INPUT}" | xq '.[0]')
readonly BOOK=$(printf '%s' "${JSON_INPUT}" | xq '.[1]')
readonly CONTEXT=$(echo "${JSON_INPUT}" | xq '.[0]')
readonly BOOK=$(echo "${JSON_INPUT}" | xq '.[1]')
escape_string() {
printf '%s' "$1" | sed -e 's/\\/\\\\/g' -e 's/"/\\"/g'
@@ -63,8 +63,8 @@ SG_PLUGIN_VERSION_PATCH_ESCAPED=$(escape_string "${SG_PLUGIN_VERSION_PATCH}")
SG_BUILD_HOST_ESCAPED=$(escape_string "${SG_BUILD_HOST}")
SG_BUILD_TIME_ESCAPED=$(escape_string "${SG_BUILD_TIME}")
PARSED_BOOK=$(printf '%s' "${BOOK}" | xq "
.items[] |= (
PARSED_BOOK=$(echo "${BOOK}" | xq "
.sections[] |= (
if has(\"Chapter\") then
.Chapter.content |=
walk(if type == \"string\" then
@@ -103,4 +103,4 @@ PARSED_BOOK=$(printf '%s' "${BOOK}" | xq "
#echo "BOOK: ${BOOK}" >&2
#echo "PARSED_BOOK: ${PARSED_BOOK}" >&2
printf '%s' "${PARSED_BOOK}"
echo "${PARSED_BOOK}" | xq '.'
+5 -1
View File
@@ -28,6 +28,7 @@
authors = ["Mamadou Babaei"]
description = "Welcome to the SenseGlove Unreal Engine documentation!"
language = "en"
multilingual = false
src = "src"
text-direction = "ltr"
title = "The SenseGlove Unreal Engine Handbook"
@@ -42,6 +43,8 @@ use-default-preprocessors = true
[preprocessor.links]
[preprocessor.alerts]
[preprocessor.senseglove]
after = [ "index", "links" ]
command = "sh ./bin/sg-preprocessor.sh"
@@ -56,9 +59,10 @@ footnote-backrefs = true
additional-css = ["styles/custom.css"]
additional-js = []
cname = "unreal.docs.senseglove.com"
copy-fonts = true
default-theme = "navy"
git-repository-url = "https://dev.azure.com/SenseGlove/_git/SenseGlove-Unreal"
git-repository-icon = "fab-git"
git-repository-icon = "fa-git"
input-404 = "404.md"
mathjax-support = false
no-section-label = false
-4
View File
@@ -68,7 +68,6 @@ Welcom to the SenseGlove Unreal Engine Handbook!
- [Third-Party Tutorials](misc/android-standalone-deployment/third-party-tutorials/README.md)
- [Upgrade Guide](misc/upgrade-guide/README.md)
- [Optimizing for Higher FPS](misc/optimize-higher-fps/README.md)
- [Third-Party Tutorials](misc/optimize-higher-fps/third-party-tutorials/README.md)
# 🛠️ Advanced Topics
@@ -80,7 +79,6 @@ Welcom to the SenseGlove Unreal Engine Handbook!
- [Consuming FXRMotionControllerData](advanced-topics/openxr/consuming-fxrmotioncontrollerdata/README.md)
- [Blueprint](advanced-topics/openxr/consuming-fxrmotioncontrollerdata/blueprint.md)
- [C++](advanced-topics/openxr/consuming-fxrmotioncontrollerdata/cpp.md)
- [Third-Party Integrations](advanced-topics/openxr/third-party-integrations/README.md)
- [Third-Party Tutorials](advanced-topics/openxr/third-party-tutorials/README.md)
# 🔌 Low-Level API
@@ -104,8 +102,6 @@ Welcom to the SenseGlove Unreal Engine Handbook!
- [SenseGlove SDK License](license/senseglove-sdk.md)
- [SGBLE and SGBLExx Rust Dependencies Licenses](license/sgble-sgblexx-rust-dependencies.md)
- [Boost C++ Libraries License](license/boost-cpp-libraries.md)
- [{fmt} Formatting Library License](license/fmt-formatting-library.md)
- [Loguru Logging Library License](license/loguru-loggin-library.md)
- [Serial Communication Library License](license/serial-communication-library.md)
-----------
@@ -1,265 +0,0 @@
# Third-Party OpenXR Integrations
The **SenseGlove Unreal Engine Plugin** registers itself as an `OpenXRHandTracking` provider, making it a fully compatible, drop-in replacement for Epics own **OpenXRHandTracking** plugin in Unreal Engine. This allows it to integrate seamlessly with any third-party system or plugin that can consume OpenXR hand-tracking data.
One notable example is the open-source, MIT-licensed [VR Expansion Plugin (VRE)](#vr-expansion-plugin).
> [!IMPORTANT]
> As explained in the
> [Third-Party Tutorials: Consuming OpenXR Hand-Tracking Data](../third-party-tutorials/)
> section, its entirely possible to build your own custom hand interaction
> system without relying on
> [SGPawn](../../../getting-started/setup-senseglove-default-classes/sgpawn.html)
> or any third-party OpenXR-compatible interaction plugin altogether.
>
> If your project requires finer-grained control than what these solutions
> offer, the tutorials in that section will guide you through understanding the
> OpenXR hand-tracking data format in Unreal Engine and help you implement a
> fully tailored interaction system from the ground up in a few hours.
As the SenseGlove Unreal Engine Plugin is fully OpenXR-compliant, it provides OpenXR hand-tracking data in the expected format and takes over as the active provider within Unreal. If your existing interaction system (e.g. VRE plugin) already uses OpenXR hand-tracking, SenseGlove will function as a direct tracking source instead of a real hand.
> [!NOTE]
> Since most hand-tracking systems are not capable of haptics feedback,
> integrating SenseGlove's haptic feedback requires a small amount of additional
> effort.
>
> The SenseGlove API is fully exposed to Unreal Engine via C++ and Blueprint,
> so triggering haptic feedback is as simple as calling a function.
> For more information, refer to the [Blueprint Changes](#blueprint-changes)
> section below.
> [!IMPORTANT]
> If you're using a third-party OpenXR hand interaction system, configuring the
> [Wrist-Tracker Hardware Settings](../../../getting-started/setup-wrist-tracking-hardware/)
> will likely have no effect, and your hand offsets may appear at the incorrect
> location in the scene.
>
> This is because those settings are only recognized by SenseGloves native
> actors and components such as `SGPawn`, `SGWristTrackerComponent`, etc.
> Most third-party plugins are unaware of these settings. As a result, you'll
> need to figure out how to manually apply the appropriate offsets within your
> chosen OpenXR hand interaction system.
>
> For example, the VRE plugin provide similar configurations in their plugin's
> settings section. For more information refer to the
> [Changing Wrist-Tracker Offsets](#changing-wrist-tracker-offsets) section
> below.
## Comparison of Supported OpenXR Hand-Interaction Systems
| | **Built-in?** | **Works out of the box?** | **Beginner-friendly?** | **Learning Curve** | **Featureful** | **Customizable?** | **Supports Custom Gestures?** |
|-------------------------------------|---------------|------------------------------------|--------------------------------------------------|-----------------------------|--------------------------------------------------------------------------|-----------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| **SGPawn** | ✅ Yes | ✅ Yes | ✅ Most beginer-friendly | ✅ Very easy | ⚠️ Very basic | ⚠️ Very limited | ❌ Not yet, maybe added in the future |
| **SenseGlove OpenXR** | ✅ Yes | ❌ Requires Blueprint or C++ coding | ✅ Requires a few hours of watching tutotrials | ✅ Moderate | ❌ You need to develop your own features and functionalities from scratch | ✅ Your imagination, creativity, and skill level are your limits | ✅ You have to implement your own recognition logic; example pinch detection algorithm is taught in the tutorial series |
| **VR Expansion Plugin** | ❌ No | ⚠️ Partially requires setup | ❌ Best suited for intermediate or advanced users | ⚠️ Steep | ✅ Diverse features and functionalities | ✅ Highly customizable | ✅ Via custom logic |
| **Other OpenXR-compatible Plugins** | ❌ No | ❓ Check their documentation | ❓ Check their documentation | ❓ Check their documentation | ❓ Check their documentation | ❓ Check their documentation | ❓ Check their documentation |
## VR Expansion Plugin
The [**VR Expansion Plugin (VRE)**](https://vreue4.com/) is a robust, community-driven plugin for Unreal Engine that focuses on advanced VR interaction and gameplay mechanics. It is open-source (MIT licensed), actively maintained, and has received support from Epic via the [MegaGrants program](https://www.unrealengine.com/en-US/megagrants).
Designed to extend Unreals capabilities for virtual reality, VRE offers a modular set of tools covering:
- Multiplayer and networking
- Locomotion systems
- Object gripping and interaction
- Custom movement and physics handling
The plugin is particularly useful for teams building sophisticated VR experiences. While it's beginner-friendly to an extent, its depth and flexibility are **best suited for intermediate to advanced Unreal Engine developers**. Whether you're prototyping with built-in features or extracting specific systems for your own framework, VRE offers a rich foundation for VR development.
> [!NOTE]
> For support and assistance with the VRE plugin, you can join
> [its active and welcoming Discord community](https://discord.gg/P4V7TY8BQy),
> known for being responsive and supportive.
### SGVRETemplate Demo Scene
To showcase how SenseGlove can be integrated with OpenXR-compatible third-party interaction systems, SenseGlove provides a ready-to-use [VR Expansion Plugin Integration Demo for Unreal Engine 5.4](https://dev.azure.com/SenseGlove/_git/SGVRETemplate).
This repository includes UE `5.4`compatible versions of both the **SenseGlove** and **VR Expansion** plugins, with all necessary setup and configuration already in place. Simply download the project and it should run out of the box, allowing you to explore the integration without additional setup.
> [!NOTE]
> SenseGlove provides this demo to demonstrate the potential for integrating
> with third-party OpenXR-based hand interaction systems.
> Please note that the **VR Expansion Plugin** is a third-party solution, and as
> such, **we do not offer official support for it**.
>
> For help with the VRE plugin, refer to its documentation at
> [**vreue4.com**](https://vreue4.com/) and consider joining the
> [**official VRE Discord community**](https://discord.gg/P4V7TY8BQy),
> which is active, supportive, and very responsive.
### SGVRETemplate Modifications
The [**SGVRETemplate**](https://dev.azure.com/SenseGlove/_git/SGVRETemplate) is built on top of the [VR Expansion Plugin Example Template](https://github.com/mordentral/VRExpPluginExample). However, since the original template is not directly compatible with SenseGlove, several adjustments were necessary.
In addition, a few known issues with OpenXR support in the VR Expansion Plugin for Unreal Engine `5.4` required us to modify the plugin itself to ensure smooth integration.
Below is an overview of the key modifications made to both the project template and this version of the VRE plugin.
#### Blueprint Changes
- **Content/VRE/Core/Character/BP_VRCharacter**: Four functions were added: `SendVibration`, `SendFFB`, `SendSqueeze`, and `ResetHaptics`. These functions retrieve the glove instance and send the appropriate haptic command to it. In the `OnPossessed` event, `Load Controller by Name` was added along with a string uproperty `Tracking Offset`, which is used to load the correct tracking offsets based on the selected profile.
> [!NOTE]
> If you'd like to implement your own haptic functions, the most convenient
> approach is to
> [safely acquire a glove instance](../../../advanced-topics/safe-glove-access-blueprint/).
> Once you have the glove instance, applying haptic feedback is as simple as
> calling the appropriate function.
>
> SenseGlove supports three types of haptics: Vibrations, Force-feedback, and
> Wrist-squeeze.
>
> - Using `Send Custom Waveform`, you can send vibrations to the glove instance.
> - Using `Queue Command Force Feedback Levels`, you can send force-feedback.
> - Using `Queue Command Wrist Squeeze`, you can send a wrist-squeeze command to
> the glove.
>
> Each of these functions can be called directly on the glove instance to
> trigger the desired haptic feedback.
- **Content/VRE/Core/GraspingHands/GraspingHandManny**: In the `SetupFingerAnimations` function, replace the hardcoded check for `HandType == Left` with a string comparison: convert the enum to a string and check if it contains `"Left"`. This allows compatibility with alternative tracking sources such as `"Left Foot"`.
#### C++ Changes
- **Plugins/VRExpansionPlugin/Source/VRExpansionPlugin/Public/Grippables/HandSocketComponent.h**: The following line was added as a public `UPROPERTY` in the header file:
```cpp
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Hand Animation")
float HandAnimationProgress = 0.0f;
```
- **Plugins/VRExpansionPlugin/Source/VRExpansionPlugin/Private/Grippables/HandSocketComponent.cpp**: In the function `bool UHandSocketComponent::GetBlendedPoseSnapShot(FPoseSnapshot& PoseSnapShot, USkeletalMeshComponent* TargetMesh, bool bSkipRootBone, bool bFlipHand)`, the `TrackLocation` calculation was modified from:
```cpp
if (TrackIndex != INDEX_NONE && (!bSkipRootBone || TrackIndex != 0))
{
double TrackLocation = 0.0f;
HandTargetAnimation->GetBoneTransform(LocalTransform, FSkeletonPoseBoneIndex(TrackMap[TrackIndex].BoneTreeIndex), TrackLocation, false);
}
else
{
```
To:
```cpp
if (TrackIndex != INDEX_NONE && (!bSkipRootBone || TrackIndex != 0))
{
double TrackLocation = HandTargetAnimation->GetPlayLength() * HandAnimationProgress;
HandTargetAnimation->GetBoneTransform(LocalTransform, FSkeletonPoseBoneIndex(TrackMap[TrackIndex].BoneTreeIndex), TrackLocation, false);
}
else
{
```
- **Plugins/VRExpansionPlugin/Source/VRExpansionPlugin/Private/GripMotionControllerComponent.cpp**: In the function `void UGripMotionControllerComponent::GetCurrentProfileTransform(bool bBindToNoticationDelegate)`, the following logic was updated from:
```cpp
if (HandType == EControllerHand::Left || HandType == EControllerHand::AnyHand || !VRSettings->bUseSeperateHandTransforms)
{
NewControllerProfileTransform = VRSettings->CurrentControllerProfileTransform;
}
else if (HandType == EControllerHand::Right)
{
NewControllerProfileTransform = VRSettings->CurrentControllerProfileTransformRight;
}
```
To:
```cpp
if (UEnum::GetDisplayValueAsText(HandType).ToString().Contains("Left") || HandType == EControllerHand::AnyHand || !VRSettings->bUseSeperateHandTransforms)
{
NewControllerProfileTransform = VRSettings->CurrentControllerProfileTransform;
}
else if (UEnum::GetDisplayValueAsText(HandType).ToString().Contains("Right"))
{
NewControllerProfileTransform = VRSettings->CurrentControllerProfileTransformRight;
}
```
The following function was also updated; from:
```cpp
void UGripMotionControllerComponent::GetHandType(EControllerHand& Hand)
{
if (!IMotionController::GetHandEnumForSourceName(MotionSource, Hand))
{
// Check if the palm motion source extension is being used
// I assume eventually epic will handle this case
if (MotionSource.Compare(FName(TEXT("RightPalm"))) == 0 || MotionSource.Compare(FName(TEXT("RightWrist"))) == 0)
{
Hand = EControllerHand::Right;
}
// Could skip this and default to left now but would rather check
else if (MotionSource.Compare(FName(TEXT("LeftPalm"))) == 0 || MotionSource.Compare(FName(TEXT("LeftWrist"))) == 0)
{
Hand = EControllerHand::Left;
}
else
{
Hand = EControllerHand::Left;
}
}
}
```
To:
```cpp
void UGripMotionControllerComponent::GetHandType(EControllerHand& Hand)
{
if (!IMotionController::GetHandEnumForSourceName(MotionSource, Hand))
{
// Check if the palm motion source extension is being used
// I assume eventually epic will handle this case
if (MotionSource.Compare(FName(TEXT("RightPalm"))) == 0 || MotionSource.Compare(FName(TEXT("RightWrist"))) == 0 || MotionSource.ToString().Contains("Right"))
{
Hand = EControllerHand::Right;
}
// Could skip this and default to left now but would rather check
else if (MotionSource.Compare(FName(TEXT("LeftPalm"))) == 0 || MotionSource.Compare(FName(TEXT("LeftWrist"))) == 0 || MotionSource.ToString().Contains("Left"))
{
Hand = EControllerHand::Left;
}
else
{
Hand = EControllerHand::Left;
}
}
}
```
#### Changing Wrist-Tracker Offsets
If you are using wrist-tracking hardware supported by the SenseGlove plugin, you can change the offsets inside `BP_VRCharacter` using the uproperty `Tracking Offset` typing or copying any of the following, depending on your hardware:
- **SenseGlove_Quest3**: The wrist-tracking controller profile for for Meta Quest3.
- **SenseGlove_ViveWristTrackers**: The wrist-tracking controller profile for HTC VIVE wrist trackers.
#### Changing Motion Source
In `BP_VRCharacter`, you can change the wrist-tracking motion source for each hand. This is required depending on which tracker you are using.
#### Adding More Gestures
In the `GraspingHandManny` Blueprint, weve created a simple function called `SaveHandPose`. If you press the `Space Bar` while the game is running, it will save the current pose of the corresponding hand. The pose is stored in a gestures database located under `Content/SenseGlove` with the default name `NewHandPose`. You should rename the pose to something meaningful when you intend to use it.
Its helpful to add an Event Dispatcher to the `GraspingHandManny` Blueprint, which is triggered in the Event Graph by the `On New Gesture Detected` event from the `OpenXRHandPose` component. This system is index-based rather than name-based, so keep that in mind when adding more dispatchers. By default, weve included examples for `Teleport`, `Grab`, `Release`, and `Use`.
#### Video Summary
This short video provides an overview of some of the key changes and modifications behind the SGVRETemplate demo scene, mentioned above.
<div style="margin: 0 auto; width: 560px;">
<iframe width="560" height="315" src="https://www.youtube.com/embed/6uTu4T10mjU" frameborder="0" allowfullscreen></iframe>
</div>
### SGVRETemplate Demo Calibration Scene
The SGVRETemplate includes a basic Calibration Scene located at `Content/SenseGlove/Maps/Calibration`. Inside this level, youll find a copy of `Content/SenseGlove/Blueprints/Calibration/BP_Calibrator` Blueprint responsible for transitioning to your desired target map after the calibration process is complete. You can configure the target map directly within this Blueprint by adjusting the `Level to Load` uproperty.
-126
View File
@@ -5,132 +5,6 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [2.7.3] - 2026-02-17
This patch release resolves documentation build pipeline failures by updating broken mdBook tooling.
### Documentation
- Bumped [mdBook](https://rust-lang.github.io/mdBook/) to `v0.5.2`
- Bumped the [Michael-F-Bryan/mdbook-epub](https://github.com/Michael-F-Bryan/mdbook-epub) crate to [`21a1c8134134201a2d555313447c96e56e2a8996`](https://github.com/Michael-F-Bryan/mdbook-epub/commit/21a1c8134134201a2d555313447c96e56e2a8996), which addresses issue [#133](https://github.com/Michael-F-Bryan/mdbook-epub/issues/133). This allowed upgrading mdBook from `0.4.49` to `v0.5.2` without breaking images inside the generated ePub version of the handbook.
- Bumped [HollowMan6/mdbook-pdf](https://github.com/HollowMan6/mdbook-pdf) to `v0.1.13`.
- Removed [lambdalisue/rs-mdbook-alerts](https://github.com/lambdalisue/rs-mdbook-alerts) as it's incompatible with mdBook `v0.5.x`. The good news is that mdBook itself is now able to support this feature natively.
## [2.7.2] - 2026-02-17
This patch release resolves build issues affecting Unreal Engine `5.7` on Linux `Arm64` architecture.
### Fixed
- Fixed an issue in UE `5.7` projects where Linux `Arm64` builds were incorrectly linking against third-party libraries compiled with Epic Native/Cross Toolchain `v25` (shipped with UE `5.6`), instead of the required Toolchain `v26` binaries (shipped with UE `5.7`).
## [2.7.1] - 2025-12-09
This patch release addresses a severe regression affecting UE `5.5` projects with specific settings.
### Fixed
- Resolved a critical deadlock between the rendering and game threads in Unreal Engine `5.5` that when `IHeadMountedDisplay::GetHMDMonitorInfo()` is invoked from `FSGXRTracker::GetControllerTransform()` in certain conditions; specifically while SenseCom is running and gloves are present and connected. This issue is [related to critical deadlock issue (UE-212224), occurring during PipelinedFrameState acquisition, which had already been addressed for the plugin versions running on UE `5.6+`](#260---2025-06-04). Because it only gets triggered under specific project settings, we were previously unaware that it also affected IHeadMountedDisplay::GetHMDMonitorInfo() in UE 5.5.
### Documentation
- Locked the [mdbook-pdf](https://github.com/HollowMan6/mdbook-pdf) crate to [`v0.1.11`](https://github.com/HollowMan6/mdbook-pdf/releases/tag/v0.1.11) due to the following `v0.1.12` panick during PDF generation: called `Result::unwrap()` on an `Err` value: Unable to deserialize the `RenderContext`.
## [2.7.0] - 2025-11-18
This minor release focuses on delivering performance improvements, made possible by major optimizations in the underlying proprietary SenseGlove libraries, while also introducing some breaking changes.
### Added
- Added support for UE `5.7`.
- Added support for Android NDK `r27c`, which is the recommend Android SDK since UE `5.6.1` and the default for UE `5.7+` for Android Standalone builds.
- Added support for Epic Cross and Native Toolchains `v26`, which is shipped with the UE `5.7` and GNU/Linux support.
- Added prebuilt binaries for third-party library [{fmt} Formatting Library](https://github.com/fmtlib/fmt) on all supported platforms. This third-party library is a required dependency of SenseGlove libraries >= `v2.300.0`.
- Added prebuilt binaries for third-party library: [Loguru Logging Library](https://github.com/emilk/loguru) on all supported platforms. This third-party library is a required dependency of SenseGlove libraries >= `v2.300.0`.
- Added third-party module `SGCommonThirdPartyLibs`.
- Added third-party module `SGConnectShmThirdPartyLibs`.
- Added third-party module `SGCoreShmThirdPartyLibs`.
- Added third-party module `SGCoreThirdPartyHeaders`.
- Added third-party module `SGFmtThirdPartyLibs`.
- Added third-party module `SGLogThirdPartyLibs`.
- Added third-party module `SGLoguruThirdPartyLibs`.
- Added third-party module `SGWjwwoodSerialThirdPartyLibs` to replace `SGSerialThirdPartyLibs` while retaining `SGSerialThirdPartyLibs` for a different purpose. See the relevant comment in the Changed section below.
- Added UPROPERTY `USGTouchComponent::VibrotactileAmplitude`.
- Added UPROPERTY `USGTouchComponent::VibrotactileFrequency`.
- Added method `USGTouchComponent::GetVibrotactileAmplitude()`.
- Added method `USGTouchComponent::SetVibrotactileAmplitude()`.
- Added method `USGTouchComponent::GetVibrotactileFrequency()`.
- Added method `USGTouchComponent::SetVibrotactileFrequency()`.
- Added Blueprint-accessible method `USGTouchComponentKismetLibrary::GetVibrotactileAmplitude()`.
- Added Blueprint-accessible method `USGTouchComponentKismetLibrary::SetVibrotactileAmplitude()`.
- Added Blueprint-accessible method `USGTouchComponentKismetLibrary::GetVibrotactileFrequency()`.
- Added Blueprint-accessible method `USGTouchComponentKismetLibrary::SetVibrotactileFrequency()`.
### Fixed
- Fix a typo in the function name `SGDeviceList::SenseCommRunning()`. This fix breaks ABI and API compatibility with previous versions of the plugin and affects both C++ and Blueprint code.
### Changed
- `SGDeviceList::SenseCommRunning()` has been renamed to `SGDeviceList::SenseComRunning()` due to a typo. This change breaks ABI and API compatibility with previous versions of the plugin and affects both C++ and Blueprint code.
- Bumped the SenseGlove libraries to `v2.305.3-17a820b6e`. This release of the SenseGlove libraries disables RTTI/Exceptions for the most parts and isolates it to a minor portion of the code base, which yields noticable performance gains. Futhermore, some optiomizations are done in the multi-threaded code, such as replacing Spinlocks with Adaptive Mutexes (a hybrid Mutex/Spinlock).
- As a result of SenseGlove libraries >= `v2.300.0` changing it's directory structure, the `ThirdParty` folder's directory structure has been revamped.
- Renamed third-party module `SGSerialThirdPartyLibs` to `SGWjwwoodSerialThirdPartyLibs` since SenseGlove libraries >= `v2.300.0` ships a new static library named `sgserial`. Thus, to avoid confusion and naming conflicts the third-party `serial` static library is now provided by the `SGWjwwoodSerialThirdPartyLibs` module and `sgserial` is provided by the `SGSerialThirdPartyLibs` module.
- `FSGGloveTrackingSettings::GloveConnectivityCheckInterval` settings have been renamed to `FSGGloveTrackingSettings::DataRetrievalRefreshRate` for adoption other than glove connectivity use cases.
- `USGVirtualHandComponent::GetMotionControllerData()` signature has changed.
- `USGVirtualHandComponent::GetHandTrackingState()` signature has changed.
- `USGWristTrackerComponent::GetMotionControllerData()` signature has changed.
- `USGWristTrackerComponent::GetHandTrackingState()` signature has changed.
- `USGVirtualHandComponentKismetLibrary::GetMotionControllerData()` signature has changed.
- `USGVirtualHandComponentKismetLibrary::GetHandTrackingState()` signature has changed.
- `SGPawn` and `SGTouchComponent` no longer use the legacy `QueueVibroLevels` method for applying vibrotactile feedback. Instead it's been replaced with `SendCustomWaveform`.
- Changed `USGTouchComponent::VibrotactileDuration` UPROPERTY's maximum value to `1.0f`. Previously it was uncapped, and now any value beyond `1.0f` seconds is clamped.
### Removed
- Dropped support for Unreal Engine `5.3`, which was already deprecated in the `v2.6.x` release series.
- Dropped support for MSVC `v142` (Visual Studio 2019), since UE `5.3` was the last supported version relying on it.
- Cleaned up remnants of the long-removed Unreal Engine `5.2` from third-party module `*.Build.cs` files.
- Cleaned up remnants of the long-removed Unreal Engine `5.2` from `SenseGlove.Build.cs`, `SenseGloveKismet.Build.cs`, `SenseGloveTracking.Build.cs`, files.
- Cleaned up remnants of the long-removed Unreal Engine `5.2` from `SenseGloveTracking` module.
- `USGVirtualHandComponent::GetMotionControllerState()` has been removed.
- `USGWristTrackerComponent::GetMotionControllerState()` has been removed.
- `USGVirtualHandComponentKismetLibrary::GetMotionControllerState()` has been removed.
- `USGWristTrackerComponentKismetLibrary::GetMotionControllerState()` has been removed.
- `USGTouchComponent::VibrotactileLevel` UPROPERTY has been removed.
- `USGTouchComponent::GetVibrotactileLevel()` method has been removed.
- `USGTouchComponent::SetVibrotactileLevel()` method has been removed.
- `USGTouchComponentKismetLibrary::GetVibrotactileLevel()` method has been removed and is no longer available to Blueprint.
- `USGTouchComponentKismetLibrary::SetVibrotactileLevel()` method has been removed and is no longer available to Blueprint.
### Deprecated
- **This is the last major/minor release to support Unreal Engine `5.4`**, and its support will be removed in future minor or major releases. This is **important to keep in mind if your target development and deployment platform is [HTC VIVE in Standalone Mode](../getting-started/enabling-xr-ext-hand-tracking-vr-headsets/standalone-mode/index.html#htc-vive)**. Unfortunately, HTC has not released any updates to their HTC ViveOpenXR plugin since December 6, 2024. Their [latest release](https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/) [[1]](https://web.archive.org/web/20251113165658/https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/) [[2]](https://archive.ph/DlrLr), ViveOpenXR Plugin `v2.5.0`, supports only Unreal Engine `5.3` and `5.4`. [HTC VIVE PCVR Mode](../getting-started/enabling-xr-ext-hand-tracking-vr-headsets/pcvr-mode/index.html#htc-vive) is unaffected and will remain fully functional because, on Microsoft Windows, it is supported via the [OpenXRViveTracker Plugin](../getting-started/enabling-xr-ext-hand-tracking-vr-headsets/pcvr-mode/index.html#openxrvivetracker-plugin), which is bundled with Unreal Engine and officially maintained by Epic Games. If you still intend to target HTC in Standalone Mode, you are welcome to continue using the latest SenseGlove Unreal Engine Plugin `v2.7.x`, which will retain HTC Standalone Mode support. However, please keep in mind that once newer versions of the SenseGlove Unreal Engine Plugin are released and UE `5.4` is no longer supported, the latest release of the plugin supporting UE `5.4` will not receive new features, hardware support, or bug fixes. If at any point in the future HTC releases a new version of their ViveOpenXR plugin that supports any Unreal Engine version we actively support, [in accordance with our support policy and Platform Support Matrix](../appendix/platform-support-matrix.html), we will make every reasonable effort to reintroduce HTC Standalone Mode support.
### Documentation
- Added [{fmt} Formatting Library License](../license/fmt-formatting-library.html) section.
- Added [Loguru Logging Library License](../license/loguru-loggin-library.html) section.
- Updated [Setting up the Touch System](../getting-started/setup-touch-system/index.html) section to reflect the recent touch system changes.
- Added [a third-party tutorial to the Android Standalone Mode Deployment](../misc/android-standalone-deployment/third-party-tutorials/) section for UE `5.7` which provides a one-click Android development and build environment setup, instructions on how to setup and use the new UE `5.7` project launcher, and how to enabled OpenXR hand-tracking support on Meta Quest and HTC VIVE devices.
## [2.6.3] - 2025-06-27
This patch release contains no changes to the plugin code. It includes only documentation updates and improvements.
### Documentation
- Added a new section to the handbook titled [Third-Party OpenXR Integrations](../advanced-topics/openxr/third-party-integrations/) section.
- Additional minor fixes and improvements that may not be listed here.
## [2.6.2] - 2025-06-10
This patch release contains no changes to the plugin code. It includes only documentation updates and improvements.
### Documentation
- Added [a third-party tutorial to the Optimizing Your Project for Higher FPS](../misc/optimize-higher-fps/third-party-tutorials/) section.
## [2.6.1] - 2025-06-05
This patch release addresses several critical build and linking issues.
+28 -26
View File
@@ -69,17 +69,17 @@
├── include (header files)
│ │
── SenseGlove
├── BLE (SGBLE headers)
├── Common (SGCommon headers)
├── Connect (SGConnect headers)
── Core (SGCore headers)
└── Log (SGLog headers)
── boost
│ │
├── SenseGlove
├── BLE (SGBLE headers)
├── Connect (SGConnect headers)
── Core (SGCoreCpp headers)
│ │
└── serial
├── lib (platform-specific pre-built binary dependencies)
│ │
@@ -87,13 +87,13 @@
│ │ │
│ │ └── r25b (Android NDK r25b dependencies for UE 5.1+)
│ │ │
│ │ ├── aarch64 (64-bit ARM variant of Android)
│ │ ├── arm64 (64-bit ARM variant of Android)
│ │ │ │
│ │ │ ├── debug
│ │ │ │
│ │ │ └── release
│ │ │
│ │ └── x86-64 (64-bit x86-64 variant of Android)
│ │ └── x64 (64-bit x86-64 variant of Android)
│ │ │
│ │ ├── debug
│ │ │
@@ -115,7 +115,7 @@
│ │ │ │
│ │ │ └── release
│ │ │
│ │ ├── v22 (5.4 GNU/Linux dependencies)
│ │ ├── v22 (UE 5.3 and 5.4 GNU/Linux dependencies)
│ │ │ │
│ │ │ ├── aarch64 (dependencies targeting GNU/Linux AArch64 architecture)
│ │ │ │ │
@@ -157,23 +157,25 @@
│ │ │
│ │ └── release
│ │
│ └── windows
│ └── win64
│ │
│ ├── v143 (Microsoft Visual Studio 2022 dependencies)
│ ├── msvc142 (Microsoft Visual Studio 2019 dependencies)
│ │ │
│ │ ── x86-64 (dependencies targeting Microsoft Windows x86-64 architecture)
│ │
│ │ ├── debug
│ │
│ └── release
│ │ ── debug
│ │ │
│ │ └── release
│ │
├── msvc143 (Microsoft Visual Studio 2022 dependencies)
│ │ │
│ │ ├── debug
│ │ │
│ │ └── release
│ │
│ └── rustc (Microsoft Windows binary dependencies built with Rust)
│ │
── x86-64 (dependencies targeting Microsoft Windows x86-64 architecture)
├── debug
│ │
│ └── release
── debug
│ │
└── release
├── SGBleThirdPartyLibs (Third-party module providing SGBLE headers and libraries)
+1 -6
View File
@@ -9,10 +9,9 @@ There are various resources available for older versions of the SenseGlove Unrea
- [Example C++ API Project (only compatible with early v1.x.x releases)](https://dev.azure.com/SenseGlove/_git/SenseGlove-Unreal-SGPlaygroundCpp)
- [Example Blueprint API Project (only compatible with early v1.x.x releases)](https://dev.azure.com/SenseGlove/_git/SenseGlove-Unreal-SGPlaygroundBP)
### Third-Party OpenXR Integration Demos
### OpenXR Integration Demos
- [A VRExpansionPlugin Integration Demo for UE `5.4`](https://dev.azure.com/SenseGlove/_git/SGVRETemplate)
- [Documentation](../advanced-topics/openxr/third-party-integrations/)
## Tutorials
@@ -44,7 +43,3 @@ There are various resources available for older versions of the SenseGlove Unrea
- [Build & Deploy Unreal Engine 5.5 Projects APK to Android & Meta Quest 3S/3/Pro/2 in Standalone Mode](https://youtu.be/EClbEbNcl4k)
- [Unreal Engine OpenXR Hand-Tracking on Android with Meta XR (Quest 3S/3/Pro/2) and HTC VIVE OpenXR (Focus Vision/XR Elite/Focus 3) Plugins](https://youtu.be/BWd3MwtfTJE)
### VR Optimization
- [Optimizing Unreal Engine VR Projects for Higher Framerates (Meta Quest, HTC VIVE, FFR, ETFR, NVIDIA DLSS, AMD FSR, and Intel XeSS Tips Included!)](https://youtu.be/67CZqMrAOns)
@@ -1,6 +1,6 @@
## Planned Features Completion Status
### Implemented as of v2.7.x
### Implemented as of v2.6.x
- [X] Full SenseGlove low-level core API access through Unreal C++.
- [X] Full SenseGlove low-level core API access through Blueprint.
@@ -42,7 +42,7 @@
- [X] Ability to automatically ask for the required permissions on Android when the plugin is enabled in any UE project.
- [X] `ViveOpenXR` plugin compatibility.
### Upcoming features planned for the v2.8.x release
### Upcoming features planned for the v2.6.x release
### Planned features long-term
@@ -2,11 +2,10 @@
| | **Windows (MSVC 2017)** | **Windows (MSVC 2019)** | **Windows (MSVC 2022)** | **Linux x86-64 (Native Toolchain)** | **Linux AArch64 (Native Toolchain)** | **Meta Quest Standalone (Android NDK)** | **HTC VIVE Standalone (Android NDK)** | **Fab** | **Azure DevOps Version** |
|:--------:|-------------------------|-------------------------|-------------------------|:-----------------------------------:|:------------------------------------:|:---------------------------------------:|:-------------------------------------:|:--------:|:------------------------:|
| **5.7** | ❌ | ❌ | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x (r25b) | ❓ | ✅ v2.7.3 | ✅ v2.7.3 |
| **5.6** | ❌ | ❌ | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x (r25b) | ❓ | ✅ v2.7.3 | ✅ v2.7.3 |
| **5.5** | ❌ | ❌ | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x | ✅ v2.7.x (r25b) | | ✅ v2.7.3 | ✅ v2.7.3 |
| **5.4** | ❌ | | ⚠️ v2.7.x | ⚠️ v2.7.x | ⚠️ v2.7.x | ⚠️ v2.7.x (r25b) | ⚠️ v2.7.x (r25b) | ⚠️ v2.7.3 | ⚠️ v2.7.3 |
| **5.3** | ❌ | ⚠️ v2.6.x | ⚠️ v2.6.x | ⚠️ v2.6.x | ⚠️ v2.6.x | ⚠️ v2.6.x (r25b) | ⚠️ v2.6.x (r25b) | ⚠️ v2.6.3 | ⚠️ v2.6.3 |
| **5.6** | ❌ | ❌ | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x (r25b) | ❓ | ✅ v2.6.1 | ✅ v2.6.1 |
| **5.5** | ❌ | ❌ | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x (r25b) | ❓ | ✅ v2.6.1 | ✅ v2.6.1 |
| **5.4** | ❌ | ❌ | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x | ✅ v2.6.x (r25b) | ✅ v2.6.x (r25b) | ✅ v2.6.1 | ✅ v2.6.1 |
| **5.3** | ❌ | ✅ v2.6.x | v2.6.x | v2.6.x | v2.6.x | v2.6.x (r25b) | v2.6.x (r25b) | v2.6.1 | v2.6.1 |
| **5.2** | ❌ | ⚠️ v2.4.x | ⚠️ v2.4.x | ⚠️ v2.4.x | ⚠️ v2.4.x | ⚠️ v2.4.x (r25b) | ❓ | ⚠️ v2.4.2 | ⚠️ v2.4.2 |
| **5.1** | ❌ | ⚠️ v2.0.x | ⚠️ v2.0.x | ⚠️ v2.0.x | ⚠️ v2.0.x | ⚠️ v2.0.x (r25b) | ❓ | ⚠️ v2.0.0 | ⚠️ v2.0.2 |
| **5.0** | ❌ | ⚠️ v1.6.x | ⚠️ v1.6.x | ⚠️ v1.6.x | ⚠️ v1.6.x | ⚠️ v1.6.x (r21e) | ❓ | ⚠️ v1.6.1 | ⚠️ v1.6.1 |
@@ -18,7 +17,7 @@
| **4.22** | ⚠️ v1.0.x | ⚠️ v1.0.x | ❌ | ⚠️ v1.0.x | ❌ | ❌ | ❌ | ❌ | ⚠️ v1.0.4 |
* <code>✅</code> Supported
* <code>⚠️</code> End-of-life (EOL) release that is not supported anymore and might be lacking features
* <code>⚠️</code> Not supported by the latest release and might be lacking features
* <code>❌</code> Not supported at all
* <code>❓</code> Unknown or untested
@@ -34,32 +34,6 @@ To set up `XR_EXT_hand_tracking` support on Meta Quest HMDs in Standalone mode,
To set up `XR_EXT_hand_tracking` support on HTC VIVE HMDs in Standalone mode, additional plugins or configuration steps are required.
> [!CAUTION]
> The SenseGlove Unreal Engine Plugin `v2.7.x` is the last release series to
> support Unreal Engine `5.4`, and its support will be removed in future minor
> or major releases. This is important to keep in mind if your target
> development and deployment platform is HTC VIVE in Standalone Mode.
> Unfortunately, HTC has not released any updates to their HTC ViveOpenXR
> plugin since December 6, 2024. Their
> [latest release](https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/)
> [[1]](https://web.archive.org/web/20251113165658/https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/)
> [[2]](https://archive.ph/DlrLr), ViveOpenXR Plugin `v2.5.0`, supports only
> Unreal Engine `5.3` and `5.4`.
> [HTC VIVE PCVR Mode](../pcvr-mode/index.html#htc-vive) is unaffected and will
> remain fully functional because, on Microsoft Windows, it is supported via the
> [OpenXRViveTracker Plugin](../pcvr-mode/index.html#openxrvivetracker-plugin),
> which is bundled with Unreal Engine and officially maintained by Epic Games.
> If you still intend to target HTC in Standalone Mode, you are welcome to
> continue using the latest SenseGlove Unreal Engine Plugin `v2.7.x`, which will
> retain HTC Standalone Mode support. However, please keep in mind that once
> newer versions of the SenseGlove Unreal Engine Plugin are released and UE
> `5.4` is no longer supported, the latest release of the plugin supporting UE
> `5.4` will not receive new features, hardware support, or bug fixes. If at any
> point in the future HTC releases a new version of their ViveOpenXR plugin that
> supports any Unreal Engine version we actively support,+
> [in accordance with our support policy and Platform Support Matrix](../../../appendix/platform-support-matrix.html),
> we will make every reasonable effort to reintroduce HTC Standalone Mode support.
### OpenXRViveTracker Plugin
Unlike the [PCVR-mode on Windows](../pcvr-mode/), the `OpenXRViveTracker` plugin is not required on Android since it only provides an implementation of the `XR_HTCX_vive_tracker_interaction` OpenXR extension which is necessary when we use VIVE Trackers on Windows or we [emulate the VIVE Wrist Trackers as VIVE Trackers on Windows](../pcvr-mode/#vive-business-streaming-app). Instead, we require the `XR_HTCX_vive_wrist_tracker_interaction` OpenXR extension to be able to use VIVE Wrist Trackers on Android, which is provided by the [`ViveOpenXR` plugin](#viveopenxr-plugin). So, you can safely ignore enabling this plugin for Android standalone deployments.
@@ -44,33 +44,6 @@ When running in PCVR mode, the functional wrist-tracking settings looks somethin
### Standalone Mode
> [!CAUTION]
> The SenseGlove Unreal Engine Plugin `v2.7.x` is the last release series to
> support Unreal Engine `5.4`, and its support will be removed in future minor
> or major releases. This is important to keep in mind if your target
> development and deployment platform is
> [HTC VIVE in Standalone Mode](../enabling-xr-ext-hand-tracking-vr-headsets/standalone-mode/index.html#htc-vive).
> Unfortunately, HTC has not released any updates to their HTC ViveOpenXR
> plugin since December 6, 2024. Their
> [latest release](https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/)
> [[1]](https://web.archive.org/web/20251113165658/https://developer.vive.com/resources/openxr/unreal/unreal-download/latest/)
> [[2]](https://archive.ph/DlrLr), ViveOpenXR Plugin `v2.5.0`, supports only
> Unreal Engine `5.3` and `5.4`.
> [HTC VIVE PCVR Mode](../enabling-xr-ext-hand-tracking-vr-headsets/pcvr-mode/index.html#htc-vive) is unaffected and will
> remain fully functional because, on Microsoft Windows, it is supported via the
> [OpenXRViveTracker Plugin](../pcvr-mode/index.html#openxrvivetracker-plugin),
> which is bundled with Unreal Engine and officially maintained by Epic Games.
> If you still intend to target HTC in Standalone Mode, you are welcome to
> continue using the latest SenseGlove Unreal Engine Plugin `v2.7.x`, which will
> retain HTC Standalone Mode support. However, please keep in mind that once
> newer versions of the SenseGlove Unreal Engine Plugin are released and UE
> `5.4` is no longer supported, the latest release of the plugin supporting UE
> `5.4` will not receive new features, hardware support, or bug fixes. If at any
> point in the future HTC releases a new version of their ViveOpenXR plugin that
> supports any Unreal Engine version we actively support,+
> [in accordance with our support policy and Platform Support Matrix](../../appendix/platform-support-matrix.html),
> we will make every reasonable effort to reintroduce HTC Standalone Mode support.
When running in Standalone mode, the functional wrist-tracking settings looks something like this:
![Setting Up the Wrist Tracking Hardware - HTC VIVE Focus 3 Wrist Tracker (Standalone Mode)](senseglove-wrist-tracking-settings-htc-vive-focus-3-wrist-tracker-openxrvivewristtracker.png "Setting Up the Wrist Tracking Hardware - HTC VIVE Focus 3 Wrist Tracker (Standalone Mode)")
![Setting Up the Wrist Tracking Hardware - HTC VIVE Focus 3 Wrist Tracker (Standalone Mode)](senseglove-wrist-tracking-settings-htc-vive-focus-3-wrist-tracker-openxrvivewristtracker.png "Setting Up the Wrist Tracking Hardware - HTC VIVE Focus 3 Wrist Tracker (Standalone Mode)")
@@ -1,31 +0,0 @@
# {fmt} Formatting Library License
```
Copyright (c) 2012 - present, Victor Zverovich and {fmt} contributors
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.
--- Optional exception to the license ---
As an exception, if, as a result of your compiling your source code, portions
of this Software are embedded into a machine-executable object form of such
source code, you may redistribute such embedded portions in such object form
without including the above copyright and permission notices.
```
@@ -1,28 +0,0 @@
# Loguru Logging Library License
```
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.
In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.
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 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.
For more information, please refer to <https://unlicense.org>
```
-2
View File
@@ -7,8 +7,6 @@ The following third-party software are used and shipped with the SenseGlove Unre
- [The SenseGlove SDK (a.k.a. SenseGlove Backend Libraries, or SenseGlove Core Libraries)](senseglove-sdk.md)
- [SGBLE and SGBLExx Rust Dependencies](sgble-sgblexx-rust-dependencies.md)
- [The Boost C++ Libraries](boost-cpp-libraries.md)
- [The {fmt} Formatting Library](fmt-formatting-library.md)
- [The Loguru Logging Library License](loguru-loggin-library.md)
- [The Serial Communication Library](serial-communication-library.md)
For more information consult their own respective open-source licenses, please.
@@ -1,17 +1,5 @@
# Third-Party Tutorials: Android Standalone Mode Deployment
## On-Click Unreal Engine 5.7 Android Packaging & APK Build Tutorial | Meta Quest & HTC VIVE Standalone
This tutorial provides a complete, streamlined guide to packaging and deploying Unreal Engine 5.7 projects to Android devices in standalone mode, with full support for Meta Quest and HTC VIVE headsets. Viewers learn how to correctly install and configure every required component, including Android Studio, SDK, NDK, JDK, and Visual Studio, using either a manual setup, or an open-source one-click PowerShell installer featured in the video.
The tutorial walks through creating a fresh Unreal Engine VR Template project, configuring Android project settings, enabling ADB device debugging, and generating a working APK using the updated Project Launcher workflow in UE 5.7. It also covers how to integrate the Meta XR and HTC VIVE OpenXR plugins to ensure proper VR recognition and hand-tracking functionality on each platform.
By the end, developers understand how to go from a blank project to a fully packaged and deployable Android APK, with functioning VR, correct device targeting, and reliable deployment pipelines on both Meta Quest and HTC VIVE standalone headsets.
<div style="margin: 0 auto; width: 560px;">
<iframe width="560" height="315" src="https://www.youtube.com/embed/SCtAfDeWXBM" frameborder="0" allowfullscreen></iframe>
</div>
## Build & Deploy Unreal Engine 5.5 Projects APK to Android & Meta Quest 3S/3/Pro/2 in Standalone Mode
This video will guide you through the process of building and deploying an Unreal Engine 5.5 project (or any version newer than `4.24`) to Android Standalone Mode for Meta Quest 2 and Quest 3 devices. The steps outlined here should also apply to other Android-based VR headsets.
@@ -1,20 +0,0 @@
# Third-Party Tutorials: Optimizing Your Project for Higher FPS
## Optimizing Unreal Engine VR Projects for Higher Framerates (Meta Quest, HTC VIVE, FFR, ETFR, NVIDIA DLSS, AMD FSR, and Intel XeSS Tips Included!)
This beginner-friendly tutorial, covers how to significantly boost the performance of your Unreal Engine VR projects, whether you're building for standalone (mobile) or PCVR (desktop) on devices such as Meta Quest, HTC VIVE, Varjo, or Valve Index.
It covers step-by-step how to:
- Convert a regular project into a VR-ready experience.
- Optimize for both standalone (Android) and PCVR (Windows) platforms.
- Tweak key rendering, lighting, and texture settings for smoother gameplay.
- Configure Meta XR and HTC VIVE OpenXR plugins to fine-tune settings for the best performance possible.
- Utilize and fine-tune engine scalability settings.
- Explore powerful optimization features like DLSS, FSR, XeSS, and Foveated Rendering
Even if youre new to VR development, this guide breaks it down with visuals, clear examples, and actionable tips to take your framerate from sluggish to silky smooth.
<div style="margin: 0 auto; width: 560px;">
<iframe width="560" height="315" src="https://www.youtube.com/embed/67CZqMrAOns" frameborder="0" allowfullscreen></iframe>
</div>
-4
View File
@@ -68,7 +68,6 @@ Toipcs that do not fall under any specific category:
- [Third-Party Tutorials](../misc/android-standalone-deployment/third-party-tutorials/)
- [Upgrade Guide](../misc/upgrade-guide/)
- [Optimizing for Higher FPS](../misc/optimize-higher-fps/)
- [Third-Party Tutorials](../misc/optimize-higher-fps/third-party-tutorials/)
## 🛠️ Advanced Topics
@@ -82,7 +81,6 @@ For users familiar with the basics, this section explores advanced features of t
- [Consuming FXRMotionControllerData](../advanced-topics/openxr/consuming-fxrmotioncontrollerdata/)
- [Blueprint](../advanced-topics/openxr/consuming-fxrmotioncontrollerdata/blueprint.md)
- [C++](../advanced-topics/openxr/consuming-fxrmotioncontrollerdata/cpp.md)
- [Third-Party Integrations](../advanced-topics/openxr/third-party-integrations/)
- [Third-Party Tutorials](../advanced-topics/openxr/third-party-tutorials/)
## 🔌 Low-Level API
@@ -110,6 +108,4 @@ The appendix contains various extra useful information:
- [SenseGlove SDK License](../license/senseglove-sdk.md)
- [SGBLE and SGBLExx Rust Dependencies Licenses](../license/sgble-sgblexx-rust-dependencies.md)
- [Boost C++ Libraries License](../license/boost-cpp-libraries.md)
- [{fmt} Formatting Library License](../license/fmt-formatting-library.md)
- [Loguru Logging Library License](../license/loguru-loggin-library.md)
- [Serial Communication Library License](../license/serial-communication-library.md)
@@ -4,8 +4,8 @@ Provides the tracking settings related to SenseGlove devices.
![The Glove-tracking Settings](glove-tracking-settings.png "The Glove-tracking Settings")
## DataRetrievalRefreshRate
## GloveConnectivityCheckInterval
The glove data retrieval refresh rate. This affects the interval in which the tracking module checks for glove connectivity and data retrieval.
The interval in which the tracking module checks for glove connectivity.
The default is s `60Hz` (data retrieval operations per second).
The default is `16.666666f` which means `60` times per second.
+13 -13
View File
@@ -42,10 +42,10 @@ Deploy:
PasswordEnvVar: SGUM_PACKAGER_REPOSITORY_PASSWORD
Branches:
- "5.7"
- "5.6"
- "5.5"
- "5.4"
- "5.3"
Exclusions:
- .git
@@ -185,11 +185,6 @@ Rocket:
EnginePaths:
- Branch: "5.7"
Path:
Linux: "/opt/UE57"
Windows: "C:\\OPT\\UE_5.7"
- Branch: "5.6"
Path:
Linux: "/opt/UE56"
@@ -205,17 +200,17 @@ Rocket:
Linux: "/opt/UE54"
Windows: "C:\\OPT\\UE_5.4"
NDKPaths:
- Branch: "5.7"
- Branch: "5.3"
Path:
Linux: "/opt/android/sdk/ndk/27.2.12479018"
Windows: "%LOCALAPPDATA%\\Android\\Sdk\\ndk\\27.2.12479018"
Linux: "/opt/UE53"
Windows: "C:\\OPT\\UE_5.3"
NDKPaths:
- Branch: "5.6"
Path:
Linux: "/opt/android/sdk/ndk/27.2.12479018"
Windows: "%LOCALAPPDATA%\\Android\\Sdk\\ndk\\27.2.12479018"
Linux: "/opt/android/sdk/ndk/25.1.8937393"
Windows: "%LOCALAPPDATA%\\Android\\Sdk\\ndk\\25.1.8937393"
- Branch: "5.5"
Path:
@@ -227,6 +222,11 @@ Rocket:
Linux: "/opt/android/sdk/ndk/25.1.8937393"
Windows: "%LOCALAPPDATA%\\Android\\Sdk\\ndk\\25.1.8937393"
- Branch: "5.3"
Path:
Linux: "/opt/android/sdk/ndk/25.1.8937393"
Windows: "%LOCALAPPDATA%\\Android\\Sdk\\ndk\\25.1.8937393"
Rsync:
+1 -2
View File
@@ -1,7 +1,7 @@
{
"FileVersion": 3,
"Version": 1,
"VersionName": "2.7.3",
"VersionName": "2.6.1",
"FriendlyName": "SenseGlove",
"Description": "Integrating the SenseGlove haptic controller into Unreal Engine",
"Category": "Virtual Reality",
@@ -10,7 +10,6 @@
"DocsURL": "https://unreal.docs.senseglove.com/",
"MarketplaceURL": "com.epicgames.launcher://ue/marketplace/product/5e1d408f517b4966a269ec1035de0b9e",
"SupportURL": "https://www.senseglove.com/support/",
"EngineVersion": "5.4.0",
"CanContainContent": true,
"IsBetaVersion": false,
"IsExperimentalVersion": false,
@@ -108,16 +108,17 @@ void FSGVirtualHandAnimInstanceProxy::PreEvaluateAnimation(UAnimInstance* InAnim
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
HandTrackingState = VirtualHand->GetHandTrackingState();
if (!HandTrackingState.bValid)
const bool bGotHandTrackingState = VirtualHand->GetHandTrackingState(
EXRSpaceType::UnrealWorldSpace, HandTrackingState);
if (!bGotHandTrackingState || !HandTrackingState.bValid)
{
return;
}
ensureAlwaysMsgf(HandTrackingState.HandKeyLocations.Num() == HandTrackingState.HandKeyRotations.Num(),
TEXT("Mismatched hand tracking state locations and rotations!"));
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
MotionControllerData = VirtualHand->GetMotionControllerData();
if (!MotionControllerData.bValid)
const bool bGotMotionControllerData = VirtualHand->GetMotionControllerData(MotionControllerData);
if (!bGotMotionControllerData || !MotionControllerData.bValid)
{
return;
}
@@ -103,9 +103,8 @@ USGTouchComponent::USGTouchComponent(const FObjectInitializer& ObjectInitializer
{
ForceFeedbackLevel = 1.0f;
VibrotactileAmplitude = 1.0f;
VibrotactileDuration = 1.0f;
VibrotactileFrequency= 180.0f;
VibrotactileDuration = 0.25f;
VibrotactileLevel = 0.0f;
}
USGTouchComponent::FImpl::FImpl(USGTouchComponent* InOwner)
@@ -42,12 +42,12 @@
#include "Engine/EngineTypes.h"
#include "Engine/SkeletalMesh.h"
#include "InputCoreTypes.h"
#include "IXRTrackingSystem.h"
#include "Templates/UnrealTypeTraits.h"
#include "UObject/ConstructorHelpers.h"
#include "SenseGlove/Animation/SGVirtualHandAnimInstance.h"
#include "SenseGlove/Components/SGWristTrackerComponent.h"
#include "SGBuildHacks/SGPlatform.h"
#include "SGCore/SGHapticGlove.h"
#include "SGDebug/SGDebugVirtualHand.h"
#include "SGLog/SGLog.h"
@@ -100,14 +100,6 @@ struct USGVirtualHandComponent::FImpl
ECollisionEnabled::Type CachedCollisionEnabled;
FCollisionResponseContainer CachedCollisionResponse;
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
FXRMotionControllerData MotionControllerData;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
FXRHandTrackingState HandTrackingState;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
/************************
* Owner object
************************/
@@ -150,8 +142,6 @@ struct USGVirtualHandComponent::FImpl
void DisableCollisionResponse();
void RestoreCollisionResponse() const;
void UpdateXRData();
void SetVisibility(const bool bInVisible);
void UpdateVisibility();
@@ -377,7 +367,7 @@ void USGVirtualHandComponent::InitializeComponent()
Pimpl->SetDefaultMesh();
}
Pimpl->UpdateXRData();
Pimpl->UpdateVisibility();
}
void USGVirtualHandComponent::UninitializeComponent()
@@ -397,7 +387,7 @@ void USGVirtualHandComponent::BeginPlay()
{
Super::BeginPlay();
Pimpl->UpdateXRData();
Pimpl->UpdateVisibility();
}
void USGVirtualHandComponent::EndPlay(const EEndPlayReason::Type EndPlayReason)
@@ -426,7 +416,7 @@ void USGVirtualHandComponent::TickComponent(
Super::TickComponent(DeltaTime, TickType, ThisTickFunction);
Pimpl->UpdateXRData();
Pimpl->UpdateVisibility();
if (Pimpl->ShouldDrawDebugVirtualHand())
{
@@ -449,7 +439,7 @@ void USGVirtualHandComponent::SetSkeletalMesh(USkeletalMesh* NewMesh, const bool
void USGVirtualHandComponent::EditorTick(
const float DeltaTime, const ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction)
{
Pimpl->UpdateXRData();
Pimpl->UpdateVisibility();
if (Pimpl->ShouldDrawDebugVirtualHand())
{
@@ -471,16 +461,61 @@ USGHapticGlove* USGVirtualHandComponent::GetConnectedGlove() const
return Glove;
}
const FXRMotionControllerData& USGVirtualHandComponent::GetMotionControllerData() const
bool USGVirtualHandComponent::GetMotionControllerData(FXRMotionControllerData& OutMotionControllerData)
{
return Pimpl->MotionControllerData;
OutMotionControllerData.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
PRAGMA_DISABLE_DEPRECATION_WARNINGS
const bool bGotMotionControllerData =
FSGXRTracker::GetMotionControllerData(this, Hand, OutMotionControllerData);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
if (!bGotMotionControllerData || !OutMotionControllerData.bValid)
{
return false;
}
return OutMotionControllerData.bValid;
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
const FXRHandTrackingState& USGVirtualHandComponent::GetHandTrackingState() const
bool USGVirtualHandComponent::GetMotionControllerState(
const EXRSpaceType XRSpaceType, const EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState)
{
return Pimpl->HandTrackingState;
OutMotionControllerState.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
const bool bGotMotionControllerState =
FSGXRTracker::GetMotionControllerState(
this, XRSpaceType, Hand, XRControllerPoseType, OutMotionControllerState);
if (!bGotMotionControllerState || !OutMotionControllerState.bValid)
{
return false;
}
return OutMotionControllerState.bValid;
}
bool USGVirtualHandComponent::GetHandTrackingState(
const EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState)
{
OutHandTrackingState.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
const bool bGotHandTrackingState =
FSGXRTracker::GetHandTrackingState(
this, XRSpaceType, Hand, OutHandTrackingState);
if (!bGotHandTrackingState || !OutHandTrackingState.bValid)
{
return false;
}
return OutHandTrackingState.bValid;
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
const TArray<FName>& USGVirtualHandComponent::GetHandBoneNames() const
@@ -750,42 +785,6 @@ void USGVirtualHandComponent::FImpl::RestoreCollisionResponse() const
Owner->SetCollisionResponseToChannels(CachedCollisionResponse);
}
void USGVirtualHandComponent::FImpl::UpdateXRData()
{
const EControllerHand Hand = Owner->IsRight() ? EControllerHand::Right : EControllerHand::Left;
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
{
FXRMotionControllerData Data;
Data.bValid = false;
PRAGMA_DISABLE_DEPRECATION_WARNINGS
const bool bGotMotionControllerData =
FSGXRTracker::GetMotionControllerData(Owner, Hand, Data);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
(void)
bGotMotionControllerData;
MotionControllerData = MoveTemp(Data);
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
{
FXRHandTrackingState State;
State.bValid = false;
const bool bGotHandTrackingState =
FSGXRTracker::GetHandTrackingState(
Owner, EXRSpaceType::UnrealWorldSpace, Hand, State);
(void) bGotHandTrackingState;
HandTrackingState = MoveTemp(State);
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
}
void USGVirtualHandComponent::FImpl::SetVisibility(const bool bInVisible)
{
Owner->SetHiddenInGame(!bInVisible, false);
@@ -804,12 +803,23 @@ void USGVirtualHandComponent::FImpl::SetVisibility(const bool bInVisible)
void USGVirtualHandComponent::FImpl::UpdateVisibility()
{
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
FXRHandTrackingState HandTrackingState;
const bool bGotHandTrackingState =
Owner->GetHandTrackingState(EXRSpaceType::UnrealWorldSpace, HandTrackingState);
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
FXRMotionControllerData MotionControllerData;
const bool bGotMotionControllerData = Owner->GetMotionControllerData(MotionControllerData);
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
const bool bHandDataAvailable =
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
HandTrackingState.bValid
bGotHandTrackingState
&& HandTrackingState.bValid
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
MotionControllerData.bValid
&& MotionControllerData.DeviceVisualType == EXRVisualType::Hand
bGotMotionControllerData
&& MotionControllerData.bValid
&& MotionControllerData.DeviceVisualType == EXRVisualType::Hand
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
;
const bool bHandVisible = Owner->IsVisible();
@@ -871,16 +881,18 @@ void USGVirtualHandComponent::FImpl::DrawDebugVirtualHand() const
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
if (!HandTrackingState.bValid)
FXRHandTrackingState HandTrackingState;
const bool bGotHandTrackingState = Owner->GetHandTrackingState(EXRSpaceType::UnrealWorldSpace, HandTrackingState);
if (!bGotHandTrackingState || !HandTrackingState.bValid)
{
return;
}
FSGDebugVirtualHand::Draw(World, HandTrackingState, Owner->GetVirtualHandSettings().DebuggingSettings);
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
if (!MotionControllerData.bValid
|| MotionControllerData.DeviceVisualType == EXRVisualType::Hand)
FXRMotionControllerData MotionControllerData;
const bool bGotMotionControllerData = Owner->GetMotionControllerData(MotionControllerData);
if (!bGotMotionControllerData || !MotionControllerData.bValid)
{
return;
}
@@ -36,10 +36,9 @@
#include "SenseGlove/Components/SGWristTrackerComponent.h"
#include "IXRTrackingSystem.h"
#include "MotionDelayBuffer.h"
#include "SGBuildHacks/SGPlatform.h"
#include "SGDebug/SGDebugGizmo.h"
#include "SGLog/SGLog.h"
#include "SGSettings/SGSettings.h"
#include "SGTracking/SGXRTracker.h"
@@ -57,14 +56,6 @@ struct USGWristTrackerComponent::FImpl
bool bOverridePluginSettingsPropertyAlreadyModified;
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
FXRMotionControllerData MotionControllerData;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
FXRHandTrackingState HandTrackingState;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
/************************
* Owner object
************************/
@@ -94,9 +85,7 @@ struct USGWristTrackerComponent::FImpl
void OverridePluginSettingsPropertyChanged();
void UpdateMotionSource() const;
void UpdateXRData();
void UpdateWristTrackingData() const;
void DrawDebugWristTracker() const;
};
@@ -212,18 +201,18 @@ void USGWristTrackerComponent::InitializeComponent()
{
Super::InitializeComponent();
Pimpl->UpdateMotionSource();
Pimpl->UpdateXRData();
Pimpl->UpdateWristTrackingData();
Pimpl->UpdateMotionSource();
}
void USGWristTrackerComponent::BeginPlay()
{
Super::BeginPlay();
Pimpl->UpdateMotionSource();
Pimpl->UpdateXRData();
Pimpl->UpdateWristTrackingData();
Pimpl->UpdateMotionSource();
}
void USGWristTrackerComponent::TickComponent(
@@ -239,34 +228,77 @@ void USGWristTrackerComponent::TickComponent(
Super::TickComponent(DeltaTime, TickType, ThisTickFunction);
Pimpl->UpdateXRData();
Pimpl->UpdateWristTrackingData();
if (GetWristTrackingSettings().DebuggingSettings.bDrawDebugWristTracker)
{
Pimpl->DrawDebugWristTracker();
}
Pimpl->UpdateWristTrackingData();
}
void USGWristTrackerComponent::EditorTick(
const float DeltaTime, const ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction)
{
Pimpl->UpdateXRData();
Pimpl->UpdateWristTrackingData();
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
const FXRMotionControllerData& USGWristTrackerComponent::GetMotionControllerData() const
bool USGWristTrackerComponent::GetMotionControllerData(FXRMotionControllerData& OutMotionControllerData)
{
return Pimpl->MotionControllerData;
OutMotionControllerData.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
PRAGMA_DISABLE_DEPRECATION_WARNINGS
const bool bGotMotionControllerData =
FSGXRTracker::GetMotionControllerData(this, Hand, OutMotionControllerData);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
if (!bGotMotionControllerData || !OutMotionControllerData.bValid)
{
return false;
}
return OutMotionControllerData.bValid;
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
const FXRHandTrackingState& USGWristTrackerComponent::GetHandTrackingState() const
bool USGWristTrackerComponent::GetMotionControllerState(
const EXRSpaceType XRSpaceType, const EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState)
{
return Pimpl->HandTrackingState;
OutMotionControllerState.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
const bool bGotMotionControllerState =
FSGXRTracker::GetMotionControllerState(
this, XRSpaceType, Hand, XRControllerPoseType, OutMotionControllerState);
if (!bGotMotionControllerState || !OutMotionControllerState.bValid)
{
return false;
}
return OutMotionControllerState.bValid;
}
bool USGWristTrackerComponent::GetHandTrackingState(
const EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState)
{
OutHandTrackingState.bValid = false;
const EControllerHand Hand = IsRight() ? EControllerHand::Right : EControllerHand::Left;
const bool bGotHandTrackingState =
FSGXRTracker::GetHandTrackingState(
this, XRSpaceType, Hand, OutHandTrackingState);
if (!bGotHandTrackingState || !OutHandTrackingState.bValid)
{
return false;
}
return OutHandTrackingState.bValid;
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
USGWristTrackerComponent::FImpl::FImpl(USGWristTrackerComponent* InOwner)
@@ -327,41 +359,6 @@ void USGWristTrackerComponent::FImpl::UpdateMotionSource() const
Owner->SetTrackingMotionSource(TrackingMotionSource);
}
void USGWristTrackerComponent::FImpl::UpdateXRData()
{
const EControllerHand Hand = Owner->IsRight() ? EControllerHand::Right : EControllerHand::Left;
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
{
FXRMotionControllerData Data;
Data.bValid = false;
PRAGMA_DISABLE_DEPRECATION_WARNINGS
const bool bGotMotionControllerData =
FSGXRTracker::GetMotionControllerData(Owner, Hand, Data);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
(void)
bGotMotionControllerData;
MotionControllerData = MoveTemp(Data);
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
{
FXRHandTrackingState State;
State.bValid = false;
const bool bGotHandTrackingState =
FSGXRTracker::GetHandTrackingState(
Owner, EXRSpaceType::UnrealWorldSpace, Hand, State);
(void) bGotHandTrackingState;
HandTrackingState = MoveTemp(State);
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
}
void USGWristTrackerComponent::FImpl::UpdateWristTrackingData() const
{
FVector NewWristLocation{Owner->GetComponentLocation()};
@@ -36,6 +36,8 @@
#include "SenseGlove/GameFramework/SGPlayerController.h"
#include "Runtime/Launch/Resources/Version.h"
#include "Engine/TimerHandle.h"
#include "TimerManager.h"
#include "SenseGlove/Components/SGTouchComponent.h"
#include "SenseGlove/Components/SGVirtualHandComponent.h"
@@ -43,7 +45,6 @@
#include "SenseGlove/Haptics/SGGrabState.h"
#include "SenseGlove/Haptics/SGTouchState.h"
#include "SGBuildHacks/SGPlatform.h"
#include "SGCore/SGCustomWaveform.h"
#include "SGCore/SGHapticGlove.h"
struct ASGPlayerController::FImpl
@@ -54,6 +55,11 @@ struct ASGPlayerController::FImpl
static float GetForceFeedbackLevel(const AActor* Actor);
static float GetVibrotactileDuration(const AActor* ActorThumbTouching, const AActor* ActorIndexTouching,
const AActor* ActorMiddleTouching, const AActor* ActorRingTouching,
const AActor* ActorPinkyTouching);
static float GetVibrotactileLevel(const AActor* Actor);
static TArray<float> GetForceFeedbackLevels(
const AActor* ActorThumbTouching,
const AActor* ActorIndexTouching,
@@ -61,10 +67,19 @@ struct ASGPlayerController::FImpl
const AActor* ActorRingTouching,
const AActor* ActorPinkyTouching);
static TArray<float> GetVibrotactileLevels(
const AActor* ActorThumbTouching,
const AActor* ActorIndexTouching,
const AActor* ActorMiddleTouching,
const AActor* ActorRingTouching,
const AActor* ActorPinkyTouching);
/************************
* Member variables
************************/
FTimerHandle TouchVibrotactileStopTimer;
/************************
* Owner object
************************/
@@ -89,8 +104,6 @@ struct ASGPlayerController::FImpl
* Methods
************************/
USGCustomWaveform* GetCustomWaveform(const AActor* Actor);
void UpdateHapticsFeedback(const FSGTouchState& TouchState);
};
@@ -108,6 +121,74 @@ float ASGPlayerController::FImpl::GetForceFeedbackLevel(const AActor* Actor)
return 0.0f;
}
float ASGPlayerController::FImpl::GetVibrotactileDuration(const AActor* ActorThumbTouching,
const AActor* ActorIndexTouching,
const AActor* ActorMiddleTouching,
const AActor* ActorRingTouching,
const AActor* ActorPinkyTouching)
{
if (IsValid(ActorThumbTouching))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(ActorThumbTouching);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileDuration();
}
}
if (IsValid(ActorIndexTouching))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(ActorIndexTouching);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileDuration();
}
}
if (IsValid(ActorMiddleTouching))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(ActorMiddleTouching);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileDuration();
}
}
if (IsValid(ActorRingTouching))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(ActorRingTouching);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileDuration();
}
}
if (IsValid(ActorPinkyTouching))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(ActorPinkyTouching);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileDuration();
}
}
return 0.0f;
}
float ASGPlayerController::FImpl::GetVibrotactileLevel(const AActor* Actor)
{
if (IsValid(Actor))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(Actor);
if (IsValid(TouchComponent))
{
return TouchComponent->GetVibrotactileLevel();
}
}
return 0.0f;
}
TArray<float> ASGPlayerController::FImpl::GetForceFeedbackLevels(
const AActor* ActorThumbTouching,
const AActor* ActorIndexTouching,
@@ -132,6 +213,30 @@ TArray<float> ASGPlayerController::FImpl::GetForceFeedbackLevels(
return ForceFeedbackLevels;
}
TArray<float> ASGPlayerController::FImpl::GetVibrotactileLevels(
const AActor* ActorThumbTouching,
const AActor* ActorIndexTouching,
const AActor* ActorMiddleTouching,
const AActor* ActorRingTouching,
const AActor* ActorPinkyTouching)
{
const float ThumbVibrotactileLevel = GetVibrotactileLevel(ActorThumbTouching);
const float IndexVibrotactileLevel = GetVibrotactileLevel(ActorIndexTouching);
const float MiddleVibrotactileLevel = GetVibrotactileLevel(ActorMiddleTouching);
const float RingVibrotactileLevel = GetVibrotactileLevel(ActorRingTouching);
const float PinkyVibrotactileLevel = GetVibrotactileLevel(ActorPinkyTouching);
const TArray<float> ForceFeedbackLevels{
ThumbVibrotactileLevel,
IndexVibrotactileLevel,
MiddleVibrotactileLevel,
RingVibrotactileLevel,
PinkyVibrotactileLevel,
};
return ForceFeedbackLevels;
}
ASGPlayerController::ASGPlayerController(const FObjectInitializer& ObjectInitializer)
: Super(ObjectInitializer),
Pimpl(TUniquePtr<FImpl, FImplDeleter>(new FImpl{this}, PimplDeleter))
@@ -225,29 +330,6 @@ ASGPlayerController::FImpl::FImpl(ASGPlayerController* InOwner)
ASGPlayerController::FImpl::~FImpl() = default;
USGCustomWaveform* ASGPlayerController::FImpl::GetCustomWaveform(const AActor* Actor)
{
float Amplitude = 0.0f;
float Duration = 0.0f;
float Frequency = 0.0f;
if (IsValid(Actor))
{
const USGTouchComponent* TouchComponent = USGTouchComponent::GetTouchComponent(Actor);
if (IsValid(TouchComponent))
{
Amplitude = TouchComponent->GetVibrotactileAmplitude();
Duration = TouchComponent->GetVibrotactileDuration();
Frequency = TouchComponent->GetVibrotactileFrequency();
}
}
USGCustomWaveform* CustomWaveform{
USGCustomWaveform::NewCustomWaveform(Owner, Amplitude, Duration, Frequency)
};
return CustomWaveform;
}
void ASGPlayerController::FImpl::UpdateHapticsFeedback(const FSGTouchState& TouchState)
{
static const TArray<float> VibrotactileOffCommand{0.0f, 0.0f, 0.0, 0.0, 0.0f};
@@ -277,43 +359,44 @@ void ASGPlayerController::FImpl::UpdateHapticsFeedback(const FSGTouchState& Touc
};
Glove->QueueForceFeedbackLevels(MoveTemp(ForceFeedbackLevels));
// Queue the Vibrotactile command...
TArray<float> VibrotactileLevels{
GetVibrotactileLevels(
TouchState.ActorThumbTouching, TouchState.ActorIndexTouching, TouchState.ActorMiddleTouching,
TouchState.ActorRingTouching, TouchState.ActorPinkyTouching)
};
Glove->QueueVibroLevels(MoveTemp(VibrotactileLevels));
// Send the haptics commands!
Glove->SendHaptics();
// Send Vibrotactile to the thumb finger if it's touching an actor...
if (IsValid(TouchState.ActorThumbTouching))
{
USGCustomWaveform* CustomWaveform(GetCustomWaveform(TouchState.ActorThumbTouching));
Glove->SendCustomWaveform(CustomWaveform, ESGHapticLocation::ThumbTip);
}
// Stop the Vibrotactile command after the timeout if any haptic feedback is ongoing.
const float VibrotactileDuration = FImpl::GetVibrotactileDuration(
TouchState.ActorThumbTouching, TouchState.ActorIndexTouching, TouchState.ActorMiddleTouching,
TouchState.ActorRingTouching, TouchState.ActorPinkyTouching);
// Send Vibrotactile to the index finger if it's touching an actor...
if (IsValid(TouchState.ActorIndexTouching))
{
USGCustomWaveform* CustomWaveform(GetCustomWaveform(TouchState.ActorIndexTouching));
Glove->SendCustomWaveform(CustomWaveform, ESGHapticLocation::IndexTip);
}
Owner->GetWorldTimerManager().ClearTimer(TouchVibrotactileStopTimer);
// Send Vibrotactile to the middle finger if it's touching an actor...
if (IsValid(TouchState.ActorMiddleTouching))
FTimerDelegate TouchVibrotactileStopHandler;
TouchVibrotactileStopHandler.BindLambda([= SG_CAPTURE_THIS]()-> void
{
USGCustomWaveform* CustomWaveform(GetCustomWaveform(TouchState.ActorMiddleTouching));
Glove->SendCustomWaveform(CustomWaveform, ESGHapticLocation::MiddleTip);
}
if (!IsValid(Glove))
{
return;
}
// Send Vibrotactile to the ring finger if it's touching an actor...
if (IsValid(TouchState.ActorRingTouching))
{
USGCustomWaveform* CustomWaveform(GetCustomWaveform(TouchState.ActorRingTouching));
Glove->SendCustomWaveform(CustomWaveform, ESGHapticLocation::RingTip);
}
const bool bGloveConnected = Glove->IsConnected();
if (!bGloveConnected)
{
return;
}
// Send Vibrotactile to the pinky finger if it's touching an actor...
if (IsValid(TouchState.ActorPinkyTouching))
{
USGCustomWaveform* CustomWaveform(GetCustomWaveform(TouchState.ActorPinkyTouching));
Glove->SendCustomWaveform(CustomWaveform, ESGHapticLocation::PinkyTip);
}
Glove->QueueVibroLevels(VibrotactileOffCommand);
Glove->SendHaptics();
});
Owner->GetWorldTimerManager().SetTimer(
TouchVibrotactileStopTimer, TouchVibrotactileStopHandler, VibrotactileDuration, false, -1.0f);
}
void ASGPlayerController::FImplDeleter::operator()(const FImpl* P) const
@@ -57,17 +57,12 @@ private:
meta=(AllowPrivateAccess="false", ClampMin = "0.0", ClampMax = "1.0", UIMin = "0.0", UIMax = "1.0"))
float ForceFeedbackLevel;
UPROPERTY(EditAnywhere, Category="SenseGlove",
meta=(AllowPrivateAccess="false", ClampMin = "0.0", ClampMax = "1.0", UIMin = "0.0", UIMax = "1.0"))
float VibrotactileAmplitude;
UPROPERTY(EditAnywhere, Category="SenseGlove",
meta=(AllowPrivateAccess="false", ClampMin = "0.0", ClampMax = "1.0", UIMin = "0.0", UIMax = "1.0"))
UPROPERTY(EditAnywhere, Category="SenseGlove", meta=(AllowPrivateAccess="false", ClampMin = "0.0", UIMin = "0.0"))
float VibrotactileDuration;
UPROPERTY(EditAnywhere, Category="SenseGlove",
meta=(AllowPrivateAccess="false", ClampMin = "10.0", ClampMax = "500.0", UIMin = "10.0", UIMax = "500.0"))
float VibrotactileFrequency;
meta=(AllowPrivateAccess="false", ClampMin = "0.0", ClampMax = "100.0", UIMin = "0.0", UIMax = "100.0"))
float VibrotactileLevel;
private:
struct FImpl;
@@ -91,16 +86,6 @@ public:
ForceFeedbackLevel = Level;
}
FORCEINLINE float GetVibrotactileAmplitude() const
{
return VibrotactileAmplitude;
}
FORCEINLINE void SetVibrotactileAmplitude(const float Amplitude)
{
VibrotactileAmplitude = Amplitude;
}
FORCEINLINE float GetVibrotactileDuration() const
{
return VibrotactileDuration;
@@ -110,14 +95,13 @@ public:
{
VibrotactileDuration = Duration;
}
FORCEINLINE float GetVibrotactileFrequency() const
FORCEINLINE float GetVibrotactileLevel() const
{
return VibrotactileFrequency;
return VibrotactileLevel;
}
FORCEINLINE void SetVibrotactileFrequency(const float Frequency)
FORCEINLINE void SetVibrotactileLevel(const float Level)
{
VibrotactileFrequency = Frequency;
VibrotactileLevel = Level;
}
};
@@ -181,10 +181,16 @@ public:
bool IsGloveConnected() const;
USGHapticGlove* GetConnectedGlove() const;
const FXRMotionControllerData& GetMotionControllerData() const;
UE_DEPRECATED(5.5, "Deprecated by UE 5.5 in favor of GetMotionControllerState and GetHandTrackingState")
bool GetMotionControllerData(FXRMotionControllerData& OutMotionControllerData);
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
const FXRHandTrackingState& GetHandTrackingState() const;
bool GetMotionControllerState(
EXRSpaceType XRSpaceType, EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState);
bool GetHandTrackingState(
EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState);
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
public:
@@ -165,9 +165,15 @@ protected:
FActorComponentTickFunction* ThisTickFunction);
public:
const FXRMotionControllerData& GetMotionControllerData() const;
UE_DEPRECATED(5.5, "Deprecated by UE 5.5 in favor of GetMotionControllerState and GetHandTrackingState")
bool GetMotionControllerData(FXRMotionControllerData& OutMotionControllerData);
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
const FXRHandTrackingState& GetHandTrackingState() const;
bool GetMotionControllerState(
EXRSpaceType XRSpaceType, EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState);
bool GetHandTrackingState(
EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState);
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
};
+5
View File
@@ -54,7 +54,12 @@ public class SenseGlove : ModuleRules
"InputCore",
"InputDevice",
"OpenXRHMD",
// NOTE
// UE 5.3+ provides UXRDeviceVisualizationComponent as part of the XRBase plugin.
// UE 5.2 provides UXRDeviceVisualizationComponent as part of the HeadMountDisplay module.
#if UE_5_3_OR_LATER
"XRBase",
#endif
}
);
@@ -58,7 +58,6 @@ public class SenseGloveBuildHacks : ModuleRules
new string[]
{
"SGConnectThirdPartyHeaders",
"SGCoreThirdPartyHeaders",
}
);
@@ -42,8 +42,8 @@ public class SenseGloveConnectImpl : ModuleRules
{
PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
bEnableExceptions = false;
bUseRTTI = false;
bEnableExceptions = true;
bUseRTTI = true;
PrivateDependencyModuleNames.AddRange(
new string[]
@@ -58,13 +58,8 @@ public class SenseGloveConnectImpl : ModuleRules
new string[]
{
"SGBleThirdPartyLibs",
"SGCommonThirdPartyLibs",
"SGConnectShmThirdPartyLibs",
"SGConnectThirdPartyLibs",
"SGSerialThirdPartyLibs",
"SGFmtThirdPartyLibs",
"SGLoguruThirdPartyLibs",
"SGWjwwoodSerialThirdPartyLibs",
}
);
@@ -59,9 +59,9 @@ int32 FSGDeviceList::ActiveDevices()
return SGCoreImpl_FSGDeviceListImpl_ActiveDevices();
}
bool FSGDeviceList::SenseComRunning()
bool FSGDeviceList::SenseCommRunning()
{
return SGCoreImpl_FSGDeviceListImpl_SenseComRunning();
return SGCoreImpl_FSGDeviceListImpl_SenseCommRunning();
}
void FSGDeviceList::Dispose()
@@ -64,7 +64,7 @@ public:
/**
* Returns true if the SenseCom program is running.
*/
static bool SenseComRunning();
static bool SenseCommRunning();
/**
* Clear the device list, and block any further attempt to add to it until ReInitialize is called.
@@ -51,6 +51,7 @@ public class SenseGloveCore : ModuleRules
}
);
PrivateDependencyModuleNames.AddRange(
new string[]
{
@@ -35,8 +35,6 @@
#include "SGCoreImpl/SGBetaDeviceImpl.h"
#include <memory>
#include "Containers/StringConv.h"
#include "Misc/AssertionMacros.h"
@@ -72,7 +70,7 @@ TSharedRef<FSGBetaDeviceImpl> FSGBetaDeviceImpl::Parse(const FString& String)
FSGDevicePtrType SGDevicePtr{FBetaDeviceType::Parse(TCHAR_TO_UTF8(*String))};
ensureAlwaysMsgf(SGDevicePtr, TEXT("Invalid SGDevice!"));
const TSharedRef<FSGBetaDeviceImpl> BetaDeviceImpl{
MakeShared<FSGBetaDeviceImpl>(std::static_pointer_cast<FBetaDeviceType>(MoveTemp(SGDevicePtr)))
MakeShared<FSGBetaDeviceImpl>(std::dynamic_pointer_cast<FBetaDeviceType>(MoveTemp(SGDevicePtr)))
};
return BetaDeviceImpl;
}
@@ -135,12 +133,12 @@ FSGBetaDeviceImpl::FBetaDeviceType FSGBetaDeviceImpl::ToBetaDevice() const
FSGBetaDeviceImpl::FBetaDevicePtrType FSGBetaDeviceImpl::ToBetaDevicePtr() const
{
return std::static_pointer_cast<FBetaDeviceType>(ToSGDevicePtr());
return std::dynamic_pointer_cast<FBetaDeviceType>(ToSGDevicePtr());
}
FSGBetaDeviceImpl::FBetaDevicePtrType FSGBetaDeviceImpl::ToBetaDevicePtrChecked() const
{
FBetaDevicePtrType BetaDevice = std::static_pointer_cast<FBetaDeviceType>(ToSGDevicePtr());
FBetaDevicePtrType BetaDevice = std::dynamic_pointer_cast<FBetaDeviceType>(ToSGDevicePtr());
ensureAlwaysMsgf(BetaDevice.get(), TEXT("Invalid BetaDevice"));
return BetaDevice;
}
@@ -35,7 +35,6 @@
#include "SGCoreImpl/SGDeviceImpl.h"
#include <memory>
#include <string>
#include "Containers/StringConv.h"
@@ -158,35 +157,35 @@ TSharedRef<FSGDeviceImpl> FSGDeviceImpl::ToSGDeviceImplRef()
TSharedRef<FSGBetaDeviceImpl> FSGDeviceImpl::ToBetaDeviceImplRef()
{
FSGBetaDeviceImpl* BetaDevice{static_cast<FSGBetaDeviceImpl*>(this)};
FSGBetaDeviceImpl* BetaDevice{dynamic_cast<FSGBetaDeviceImpl*>(this)};
ensureAlwaysMsgf(BetaDevice, TEXT("Invalid BetaDevice!"));
return SharedThis(BetaDevice);
}
TSharedRef<FSGHapticGloveImpl> FSGDeviceImpl::ToHapticGloveImplRef()
{
FSGHapticGloveImpl* HapticGlove{static_cast<FSGHapticGloveImpl*>(this)};
FSGHapticGloveImpl* HapticGlove{dynamic_cast<FSGHapticGloveImpl*>(this)};
ensureAlwaysMsgf(HapticGlove, TEXT("Invalid HapticGlove!"));
return SharedThis(HapticGlove);
}
TSharedRef<FSGNova2GloveImpl> FSGDeviceImpl::ToNova2GloveImplRef()
{
FSGNova2GloveImpl* Nova2Glove{static_cast<FSGNova2GloveImpl*>(this)};
FSGNova2GloveImpl* Nova2Glove{dynamic_cast<FSGNova2GloveImpl*>(this)};
ensureAlwaysMsgf(Nova2Glove, TEXT("Invalid Nova2Glove!"));
return SharedThis(Nova2Glove);
}
TSharedRef<FSGNovaGloveImpl> FSGDeviceImpl::ToNovaGloveImplRef()
{
FSGNovaGloveImpl* NovaGlove{static_cast<FSGNovaGloveImpl*>(this)};
FSGNovaGloveImpl* NovaGlove{dynamic_cast<FSGNovaGloveImpl*>(this)};
ensureAlwaysMsgf(NovaGlove, TEXT("Invalid NovaGlove!"));
return SharedThis(NovaGlove);
}
TSharedRef<FSGSenseGloveImpl> FSGDeviceImpl::ToSenseGloveImplRef()
{
FSGSenseGloveImpl* SenseGlove{static_cast<FSGSenseGloveImpl*>(this)};
FSGSenseGloveImpl* SenseGlove{dynamic_cast<FSGSenseGloveImpl*>(this)};
ensureAlwaysMsgf(SenseGlove, TEXT("Invalid SenseGlove!"));
return SharedThis(SenseGlove);
}
@@ -194,7 +193,7 @@ TSharedRef<FSGSenseGloveImpl> FSGDeviceImpl::ToSenseGloveImplRef()
bool FSGDeviceImpl::IsABetaDevice() const
{
const FSGBetaDeviceImpl::FBetaDevicePtrType BetaDevice{
std::static_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(ToSGDevicePtr())
};
return BetaDevice != nullptr;
}
@@ -202,7 +201,7 @@ bool FSGDeviceImpl::IsABetaDevice() const
bool FSGDeviceImpl::IsAHapticGlove() const
{
const FSGHapticGloveImpl::FHapticGlovePtrType HapticGlove{
std::static_pointer_cast<FSGHapticGloveImpl::FHapticGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGHapticGloveImpl::FHapticGloveType>(ToSGDevicePtr())
};
return HapticGlove != nullptr;
}
@@ -210,7 +209,7 @@ bool FSGDeviceImpl::IsAHapticGlove() const
bool FSGDeviceImpl::IsANova2Glove() const
{
const FSGNova2GloveImpl::FNova2GlovePtrType Nova2Glove{
std::static_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(ToSGDevicePtr())
};
return Nova2Glove != nullptr;
}
@@ -218,7 +217,7 @@ bool FSGDeviceImpl::IsANova2Glove() const
bool FSGDeviceImpl::IsANovaGlove() const
{
const FSGNovaGloveImpl::FNovaGlovePtrType NovaGlove{
std::static_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(ToSGDevicePtr())
};
return NovaGlove != nullptr;
}
@@ -226,7 +225,7 @@ bool FSGDeviceImpl::IsANovaGlove() const
bool FSGDeviceImpl::IsASenseGlove() const
{
const FSGSenseGloveImpl::FSenseGlovePtrType SenseGlove{
std::static_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(ToSGDevicePtr())
};
return SenseGlove != nullptr;
}
@@ -234,7 +233,7 @@ bool FSGDeviceImpl::IsASenseGlove() const
TSharedPtr<FSGBetaDeviceImpl> FSGDeviceImpl::AsBetaDevice() const
{
const FSGBetaDeviceImpl::FBetaDevicePtrType BetaDevice{
std::static_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(ToSGDevicePtr())
};
ensureAlwaysMsgf(BetaDevice, TEXT("Invalid BetaDevice!"));
return MakeShared<FSGBetaDeviceImpl>(BetaDevice);
@@ -243,7 +242,7 @@ TSharedPtr<FSGBetaDeviceImpl> FSGDeviceImpl::AsBetaDevice() const
TSharedPtr<FSGHapticGloveImpl> FSGDeviceImpl::AsHapticGlove() const
{
const FSGHapticGloveImpl::FHapticGlovePtrType HapticGlove{
std::static_pointer_cast<FSGHapticGloveImpl::FHapticGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGHapticGloveImpl::FHapticGloveType>(ToSGDevicePtr())
};
ensureAlwaysMsgf(HapticGlove, TEXT("Invalid HapticGlove!"));
return MakeShared<FSGHapticGloveImpl>(HapticGlove);
@@ -252,7 +251,7 @@ TSharedPtr<FSGHapticGloveImpl> FSGDeviceImpl::AsHapticGlove() const
TSharedPtr<FSGNova2GloveImpl> FSGDeviceImpl::AsNova2Glove() const
{
const FSGNova2GloveImpl::FNova2GlovePtrType Nova2Glove{
std::static_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(ToSGDevicePtr())
};
ensureAlwaysMsgf(Nova2Glove, TEXT("Invalid Nova2Glove!"));
return MakeShared<FSGNova2GloveImpl>(Nova2Glove);
@@ -261,7 +260,7 @@ TSharedPtr<FSGNova2GloveImpl> FSGDeviceImpl::AsNova2Glove() const
TSharedPtr<FSGNovaGloveImpl> FSGDeviceImpl::AsNovaGlove() const
{
const FSGNovaGloveImpl::FNovaGlovePtrType NovaGlove{
std::static_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(ToSGDevicePtr())
};
ensureAlwaysMsgf(NovaGlove, TEXT("Invalid NovaGlove!"));
return MakeShared<FSGNovaGloveImpl>(NovaGlove);
@@ -270,7 +269,7 @@ TSharedPtr<FSGNovaGloveImpl> FSGDeviceImpl::AsNovaGlove() const
TSharedPtr<FSGSenseGloveImpl> FSGDeviceImpl::AsSenseGlove() const
{
const FSGSenseGloveImpl::FSenseGlovePtrType SenseGlove{
std::static_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(ToSGDevicePtr())
std::dynamic_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(ToSGDevicePtr())
};
ensureAlwaysMsgf(SenseGlove, TEXT("Invalid SenseGlove!"));
return MakeShared<FSGSenseGloveImpl>(SenseGlove);
@@ -35,7 +35,6 @@
#include "SGCoreImpl/SGDeviceListImpl.h"
#include <memory>
#include <string>
#include "Containers/StringConv.h"
@@ -57,7 +56,7 @@ int32 FSGDeviceListImpl::ActiveDevices()
return FDeviceListType::ActiveDevices();
}
bool FSGDeviceListImpl::SenseComRunning()
bool FSGDeviceListImpl::SenseCommRunning()
{
return FDeviceListType::SenseComRunning();
}
@@ -84,7 +83,7 @@ TArray<TSharedRef<FSGDeviceImpl>> FSGDeviceListImpl::GetDevices()
case ESGDeviceType::BetaDevice:
{
FSGBetaDeviceImpl::FBetaDevicePtrType BetaDevice =
std::static_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(Device);
std::dynamic_pointer_cast<FSGBetaDeviceImpl::FBetaDeviceType>(Device);
if (ensureAlwaysMsgf(BetaDevice, TEXT("Invalid BetaDevice!")))
{
TSharedRef<FSGBetaDeviceImpl> BetaDeviceImpl{
@@ -98,7 +97,7 @@ TArray<TSharedRef<FSGDeviceImpl>> FSGDeviceListImpl::GetDevices()
case ESGDeviceType::Nova2:
{
FSGNova2GloveImpl::FNova2GlovePtrType Nova2Glove =
std::static_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(Device);
std::dynamic_pointer_cast<FSGNova2GloveImpl::FNova2GloveType>(Device);
if (ensureAlwaysMsgf(Nova2Glove, TEXT("Invalid Nova2Glove device!")))
{
TSharedRef<FSGNova2GloveImpl> Nova2GloveImpl{MakeShared<FSGNova2GloveImpl>(Nova2Glove)};
@@ -110,7 +109,7 @@ TArray<TSharedRef<FSGDeviceImpl>> FSGDeviceListImpl::GetDevices()
case ESGDeviceType::Nova:
{
FSGNovaGloveImpl::FNovaGlovePtrType NovaGlove =
std::static_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(Device);
std::dynamic_pointer_cast<FSGNovaGloveImpl::FNovaGloveType>(Device);
if (ensureAlwaysMsgf(NovaGlove, TEXT("Invalid NovaGlove device!")))
{
TSharedRef<FSGNovaGloveImpl> NovaGloveImpl{MakeShared<FSGNovaGloveImpl>(NovaGlove)};
@@ -122,7 +121,7 @@ TArray<TSharedRef<FSGDeviceImpl>> FSGDeviceListImpl::GetDevices()
case ESGDeviceType::SenseGlove:
{
FSGSenseGloveImpl::FSenseGlovePtrType SenseGlove{
std::static_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(Device)};
std::dynamic_pointer_cast<FSGSenseGloveImpl::FSenseGloveType>(Device)};
if (ensureAlwaysMsgf(SenseGlove, TEXT("Invalid SenseGlove device!")))
{
TSharedRef<FSGSenseGloveImpl> SenseGloveImpl{
@@ -135,7 +134,7 @@ TArray<TSharedRef<FSGDeviceImpl>> FSGDeviceListImpl::GetDevices()
default:
SGLOG_WARNING(
FString::Printf(TEXT("Unknown SenseGlove device '%s'!"), *UEnum::GetValueAsString(FSGCoreEnumCast::ToESGDeviceType(Device->GetDeviceType()))),
FString::Printf(TEXT("Unknown SenseGlove device '%s'!"), UTF8_TO_TCHAR(typeid(Device).name())),
FString::Printf(TEXT("Device ID: '%s'!"), UTF8_TO_TCHAR(Device->GetDeviceId().c_str())),
FString::Printf(TEXT("Hardware Version: '%s'!"), UTF8_TO_TCHAR(Device->GetHardwareVersion().c_str())),
FString::Printf(TEXT("Firmware Version: '%d'!"), Device->GetFirmwareVersion()),
@@ -1322,9 +1322,9 @@ int32 SGCoreImpl_FSGDeviceListImpl_ActiveDevices()
return FSGDeviceListImpl::ActiveDevices();
}
bool SGCoreImpl_FSGDeviceListImpl_SenseComRunning()
bool SGCoreImpl_FSGDeviceListImpl_SenseCommRunning()
{
return FSGDeviceListImpl::SenseComRunning();
return FSGDeviceListImpl::SenseCommRunning();
}
void SGCoreImpl_FSGDeviceListImpl_Dispose()
@@ -140,7 +140,7 @@ FSGHapticGloveImpl::FSGHapticGloveImpl()
}
FSGHapticGloveImpl::FSGHapticGloveImpl(const FHapticGlovePtrType HapticGlove)
: FSGDeviceImpl(std::static_pointer_cast<FSGDeviceType>(HapticGlove)),
: FSGDeviceImpl(std::dynamic_pointer_cast<FSGDeviceType>(HapticGlove)),
Pimpl(TUniquePtr<FImpl, FImplDeleter>(new FImpl{this}, PimplDeleter))
{
}
@@ -168,12 +168,12 @@ FSGHapticGloveImpl& FSGHapticGloveImpl::operator=(FSGHapticGloveImpl&& Rhs) SG_N
FSGHapticGloveImpl::FHapticGlovePtrType FSGHapticGloveImpl::ToHapticGlovePtr() const
{
return std::static_pointer_cast<FHapticGloveType>(ToSGDevicePtr());
return std::dynamic_pointer_cast<FHapticGloveType>(ToSGDevicePtr());
}
FSGHapticGloveImpl::FHapticGlovePtrType FSGHapticGloveImpl::ToHapticGlovePtrChecked() const
{
FHapticGlovePtrType HapticGlove = std::static_pointer_cast<FHapticGloveType>(ToSGDevicePtr());
FHapticGlovePtrType HapticGlove = std::dynamic_pointer_cast<FHapticGloveType>(ToSGDevicePtr());
ensureAlwaysMsgf(HapticGlove.get(), TEXT("Invalid HapticGlove"));
return HapticGlove;
}
@@ -93,7 +93,7 @@ TSharedRef<FSGDeviceImpl> FSGNova2GloveImpl::Parse(const FString& ConstantsStrin
FSGDevicePtrType SGDevicePtr{FNova2GloveType::Parse(MoveTemp(ConstantsStdString))};
ensureAlwaysMsgf(SGDevicePtr, TEXT("Invalid SGDevice!"));
const TSharedRef<FSGNova2GloveImpl> Nova2GloveImpl{
MakeShared<FSGNova2GloveImpl>(std::static_pointer_cast<FNova2GloveType>(MoveTemp(SGDevicePtr)))
MakeShared<FSGNova2GloveImpl>(std::dynamic_pointer_cast<FNova2GloveType>(MoveTemp(SGDevicePtr)))
};
return Nova2GloveImpl;
}
@@ -275,12 +275,12 @@ const FSGNova2GloveImpl::FNova2GloveType& FSGNova2GloveImpl::ToNova2Glove() cons
FSGNova2GloveImpl::FNova2GlovePtrType FSGNova2GloveImpl::ToNova2GlovePtr() const
{
return std::static_pointer_cast<FNova2GloveType>(ToSGDevicePtr());
return std::dynamic_pointer_cast<FNova2GloveType>(ToSGDevicePtr());
}
FSGNova2GloveImpl::FNova2GlovePtrType FSGNova2GloveImpl::ToNova2GlovePtrChecked() const
{
FNova2GlovePtrType Nova2Glove = std::static_pointer_cast<FNova2GloveType>(ToSGDevicePtr());
FNova2GlovePtrType Nova2Glove = std::dynamic_pointer_cast<FNova2GloveType>(ToSGDevicePtr());
ensureAlwaysMsgf(Nova2Glove.get(), TEXT("Invalid Nova2Glove"));
return Nova2Glove;
}
@@ -95,7 +95,7 @@ TSharedRef<FSGDeviceImpl> FSGNovaGloveImpl::Parse(const FString& ConstantsString
FSGDevicePtrType SGDevicePtr{FNovaGloveType::Parse(MoveTemp(ConstantsStdString))};
ensureAlwaysMsgf(SGDevicePtr, TEXT("Invalid SGDevice!"));
const TSharedRef<FSGNovaGloveImpl> NovaGloveImpl{MakeShared<FSGNovaGloveImpl>(
std::static_pointer_cast<FNovaGloveType>(MoveTemp(SGDevicePtr)))};
std::dynamic_pointer_cast<FNovaGloveType>(MoveTemp(SGDevicePtr)))};
return NovaGloveImpl;
}
@@ -288,12 +288,12 @@ const FSGNovaGloveImpl::FNovaGloveType& FSGNovaGloveImpl::ToNovaGlove() const
FSGNovaGloveImpl::FNovaGlovePtrType FSGNovaGloveImpl::ToNovaGlovePtr() const
{
return std::static_pointer_cast<FNovaGloveType>(ToSGDevicePtr());
return std::dynamic_pointer_cast<FNovaGloveType>(ToSGDevicePtr());
}
FSGNovaGloveImpl::FNovaGlovePtrType FSGNovaGloveImpl::ToNovaGlovePtrChecked() const
{
FNovaGlovePtrType NovaGlove{std::static_pointer_cast<FNovaGloveType>(ToSGDevicePtr())};
FNovaGlovePtrType NovaGlove{std::dynamic_pointer_cast<FNovaGloveType>(ToSGDevicePtr())};
ensureAlwaysMsgf(NovaGlove.get(), TEXT("Invalid NovaGlove"));
return NovaGlove;
}
@@ -93,7 +93,7 @@ TSharedRef<FSGDeviceImpl> FSGSenseGloveImpl::Parse(const FString& ConstantsStrin
FSGDevicePtrType SGDevicePtr{FSenseGloveType::Parse(MoveTemp(ConstantsStdString))};
ensureAlwaysMsgf(SGDevicePtr, TEXT("Invalid SGDevice!"));
const TSharedRef<FSGSenseGloveImpl> SenseGloveImpl{
MakeShared<FSGSenseGloveImpl>(std::static_pointer_cast<FSenseGloveType>(MoveTemp(SGDevicePtr)))
MakeShared<FSGSenseGloveImpl>(std::dynamic_pointer_cast<FSenseGloveType>(MoveTemp(SGDevicePtr)))
};
return SenseGloveImpl;
}
@@ -277,7 +277,7 @@ FSGSenseGloveImpl::FSGSenseGloveImpl(const FSenseGloveType SenseGlove)
}
FSGSenseGloveImpl::FSGSenseGloveImpl(const FSenseGlovePtrType SenseGlove)
: FSGHapticGloveImpl(std::static_pointer_cast<FHapticGloveType>(SenseGlove)),
: FSGHapticGloveImpl(std::dynamic_pointer_cast<FHapticGloveType>(SenseGlove)),
Pimpl(TUniquePtr<FImpl, FImplDeleter>(new FImpl{this}, PimplDeleter))
{
}
@@ -310,12 +310,12 @@ const FSGSenseGloveImpl::FSenseGloveType& FSGSenseGloveImpl::ToSenseGlove() cons
FSGSenseGloveImpl::FSenseGlovePtrType FSGSenseGloveImpl::ToSenseGlovePtr() const
{
return std::static_pointer_cast<FSenseGloveType>(ToSGDevicePtr());
return std::dynamic_pointer_cast<FSenseGloveType>(ToSGDevicePtr());
}
FSGSenseGloveImpl::FSenseGlovePtrType FSGSenseGloveImpl::ToSenseGlovePtrChecked() const
{
FSenseGlovePtrType SenseGlove = std::static_pointer_cast<FSenseGloveType>(ToSGDevicePtr());
FSenseGlovePtrType SenseGlove = std::dynamic_pointer_cast<FSenseGloveType>(ToSGDevicePtr());
ensureAlwaysMsgf(SenseGlove.get(), TEXT("Invalid SenseGlove"));
return SenseGlove;
}
@@ -53,7 +53,7 @@ public:
public:
static int32 ActiveDevices();
static bool SenseComRunning();
static bool SenseCommRunning();
static void Dispose();
@@ -64,35 +64,15 @@ public:
template <typename T>
static TArray<TSharedRef<FSGDeviceImpl>> GetDevices()
{
ESGDeviceType TargetType = ESGDeviceType::Unknown;
if constexpr (std::is_same_v<T, FSGNova2GloveImpl>)
{
TargetType = ESGDeviceType::Nova2;
}
else if constexpr (std::is_same_v<T, FSGNovaGloveImpl>)
{
TargetType = ESGDeviceType::Nova;
}
else if constexpr (std::is_same_v<T, FSGSenseGloveImpl>)
{
TargetType = ESGDeviceType::SenseGlove;
}
else if constexpr (std::is_same_v<T, FSGBetaDeviceImpl>)
{
TargetType = ESGDeviceType::BetaDevice;
}
else
{
static_assert(!sizeof(T), "Unsupported device type in GetDevices<T>()");
}
const std::type_info& TType = typeid(T);
const TArray<TSharedRef<FSGDeviceImpl>> CurrentDevices = GetDevices();
TArray<TSharedRef<FSGDeviceImpl>> Devices;
for (TSharedRef<FSGDeviceImpl> Device : CurrentDevices)
{
if (Device->GetDeviceType() == TargetType)
auto &d = Device.Get();
const std::type_info& DType = typeid(d);
if (DType.hash_code() == TType.hash_code())
{
Devices.Push(Device);
}
@@ -680,7 +680,7 @@ SENSEGLOVECOREIMPL_PUBLIC_API void SGCoreImpl_FSGDeviceImpl_ToString(
SENSEGLOVECOREIMPL_PUBLIC_API int32 SGCoreImpl_FSGDeviceListImpl_ActiveDevices();
SENSEGLOVECOREIMPL_PUBLIC_API bool SGCoreImpl_FSGDeviceListImpl_SenseComRunning();
SENSEGLOVECOREIMPL_PUBLIC_API bool SGCoreImpl_FSGDeviceListImpl_SenseCommRunning();
SENSEGLOVECOREIMPL_PUBLIC_API void SGCoreImpl_FSGDeviceListImpl_Dispose();
@@ -42,8 +42,8 @@ public class SenseGloveCoreImpl : ModuleRules
{
PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
bEnableExceptions = false;
bUseRTTI = false;
bEnableExceptions = true;
bUseRTTI = true;
PrivateDependencyModuleNames.AddRange(
new string[]
@@ -57,12 +57,7 @@ public class SenseGloveCoreImpl : ModuleRules
PrivateDependencyModuleNames.AddRange(
new string[]
{
"SGCommonThirdPartyLibs",
"SGCoreShmThirdPartyLibs",
"SGCoreThirdPartyLibs",
"SGLogThirdPartyLibs",
"SGFmtThirdPartyLibs",
"SGLoguruThirdPartyLibs",
}
);
@@ -43,9 +43,9 @@ int32 USGDeviceListKismetLibrary::ActiveDevices()
return FSGDeviceList::ActiveDevices();
}
bool USGDeviceListKismetLibrary::SenseComRunning()
bool USGDeviceListKismetLibrary::SenseCommRunning()
{
return FSGDeviceList::SenseComRunning();
return FSGDeviceList::SenseCommRunning();
}
void USGDeviceListKismetLibrary::Dispose()
@@ -66,7 +66,7 @@ public:
* Returns true if the SenseCom program is running.
*/
UFUNCTION(BlueprintCallable, Category="SenseGlove | Core | Device List")
static bool SenseComRunning();
static bool SenseCommRunning();
/**
* Clear the device list, and block any further attempt to add to it until ReInitialize is called.
@@ -44,31 +44,18 @@
#include "SGDebug/SGDebugCube.h"
#include "SGDebug/SGDebugGizmo.h"
void FSGDebugVirtualHand::Draw(
const UWorld* World,
const FXRMotionControllerData& MotionControllerData,
const FSGVirtualHandDebuggingSettings& Settings)
void FSGDebugVirtualHand::Draw(const UWorld* World,
const FXRMotionControllerData& MotionControllerData,
const FSGVirtualHandDebuggingSettings& Settings)
{
if (!ensureAlwaysMsgf(
Settings.DrawingMode != ESGDebugVirtualHandDrawingMode::None,
TEXT("Invalid virtual hand drawing mode!")))
{
return;
}
ensureAlwaysMsgf(Settings.DrawingMode != ESGDebugVirtualHandDrawingMode::None,
TEXT("Invalid virtual hand drawing mode!"));
if (!ensureAlwaysMsgf(
MotionControllerData.bValid,
TEXT("Invalid motion controller data!")))
{
return;
}
ensureAlwaysMsgf(MotionControllerData.bValid,
TEXT("Invalid motion controller data!"));
if (!ensureAlwaysMsgf(
MotionControllerData.HandKeyPositions.Num() == MotionControllerData.HandKeyRotations.Num(),
TEXT("Mismatched motion controller data positions and rotations!")))
{
return;
}
ensureAlwaysMsgf(MotionControllerData.HandKeyPositions.Num() == MotionControllerData.HandKeyRotations.Num(),
TEXT("Mismatched motion controller data positions and rotations!"));
for (TArray<FVector>::SizeType HandKeyIndex = 0;
HandKeyIndex < MotionControllerData.HandKeyPositions.Num(); ++HandKeyIndex)
@@ -88,31 +75,18 @@ void FSGDebugVirtualHand::Draw(
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
void FSGDebugVirtualHand::Draw(
const UWorld* World,
const FXRHandTrackingState& HandTrackingState,
const FSGVirtualHandDebuggingSettings& Settings)
void FSGDebugVirtualHand::Draw(const UWorld* World,
const FXRHandTrackingState& HandTrackingState,
const FSGVirtualHandDebuggingSettings& Settings)
{
if (!ensureAlwaysMsgf(
Settings.DrawingMode != ESGDebugVirtualHandDrawingMode::None,
TEXT("Invalid virtual hand drawing mode!")))
{
return;
};
ensureAlwaysMsgf(Settings.DrawingMode != ESGDebugVirtualHandDrawingMode::None,
TEXT("Invalid virtual hand drawing mode!"));
if (!ensureAlwaysMsgf(
HandTrackingState.bValid,
TEXT("Invalid hand tracking state!")))
{
return;
};
ensureAlwaysMsgf(HandTrackingState.bValid,
TEXT("Invalid hand tracking state!"));
if (!ensureAlwaysMsgf(
HandTrackingState.HandKeyLocations.Num() == HandTrackingState.HandKeyRotations.Num(),
TEXT("Mismatched hand tracking state locations and rotations!")))
{
return;
};
ensureAlwaysMsgf(HandTrackingState.HandKeyLocations.Num() == HandTrackingState.HandKeyRotations.Num(),
TEXT("Mismatched hand tracking state locations and rotations!"));
for (TArray<FVector>::SizeType HandKeyIndex = 0;
HandKeyIndex < HandTrackingState.HandKeyLocations.Num(); ++HandKeyIndex)
@@ -48,6 +48,7 @@ class UWorld;
class SENSEGLOVEDEBUG_API FSGDebugVirtualHand final
{
public:
UE_DEPRECATED(5.5, "Deprecated in favor of the variant that accepts FXRHandTrackingState")
static void Draw(
const UWorld* World,
const FXRMotionControllerData& MotionControllerData,
@@ -47,4 +47,14 @@ void USGDebugVirtualHandKismetLibrary::Draw_FXRMotionControllerData(
PRAGMA_DISABLE_DEPRECATION_WARNINGS
FSGDebugVirtualHand::Draw(WorldContextObject->GetWorld(), MotionControllerData, Settings);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
}
void USGDebugVirtualHandKismetLibrary::Draw_FXRHandTrackingState(
UObject* WorldContextObject,
const FXRHandTrackingState& HandTrackingState,
const FSGVirtualHandDebuggingSettings& Settings)
{
ensureAlwaysMsgf(WorldContextObject, TEXT("Invalid world context object!"));
FSGDebugVirtualHand::Draw(WorldContextObject->GetWorld(), HandTrackingState, Settings);
}
@@ -56,4 +56,11 @@ public:
UObject* WorldContextObject,
const FXRMotionControllerData& MotionControllerData,
const FSGVirtualHandDebuggingSettings& Settings);
UFUNCTION(BlueprintCallable, DisplayName="Draw", Category="SenseGlove | Debug | Virtual Hand",
meta=(WorldContext="WorldContextObject"))
static void Draw_FXRHandTrackingState(
UObject* WorldContextObject,
const FXRHandTrackingState& HandTrackingState,
const FSGVirtualHandDebuggingSettings& Settings);
};
@@ -60,14 +60,14 @@ void UTouchComponentKismetLibrary::SetForceFeedbackLevel(USGTouchComponent* Touc
TouchComponent->SetForceFeedbackLevel(Level);
}
float UTouchComponentKismetLibrary::GetVibrotactileAmplitude(const USGTouchComponent* TouchComponent)
float UTouchComponentKismetLibrary::GetVibrotactileLevel(const USGTouchComponent* TouchComponent)
{
return TouchComponent->GetVibrotactileAmplitude();
return TouchComponent->GetVibrotactileLevel();
}
void UTouchComponentKismetLibrary::SetVibrotactileAmplitude(USGTouchComponent* TouchComponent, const float Amplitude)
void UTouchComponentKismetLibrary::SetVibrotactileLevel(USGTouchComponent* TouchComponent, const float Level)
{
TouchComponent->SetVibrotactileAmplitude(Amplitude);
TouchComponent->SetVibrotactileLevel(Level);
}
float UTouchComponentKismetLibrary::GetVibrotactileDuration(const USGTouchComponent* TouchComponent)
@@ -78,15 +78,4 @@ float UTouchComponentKismetLibrary::GetVibrotactileDuration(const USGTouchCompon
void UTouchComponentKismetLibrary::SetVibrotactileDuration(USGTouchComponent* TouchComponent, const float Duration)
{
TouchComponent->SetVibrotactileDuration(Duration);
}
float UTouchComponentKismetLibrary::GetVibrotactileFrequency(const USGTouchComponent* TouchComponent)
{
return TouchComponent->GetVibrotactileFrequency();
}
void UTouchComponentKismetLibrary::SetVibrotactileFrequency(USGTouchComponent* TouchComponent, const float Frequency)
{
TouchComponent->SetVibrotactileFrequency(Frequency);
}
}
@@ -110,14 +110,28 @@ USGHapticGlove* UVirtualHandComponentKismetLibrary::GetConnectedGlove(
return VirtualHandComponent->GetConnectedGlove();
}
const FXRMotionControllerData& UVirtualHandComponentKismetLibrary::GetMotionControllerData(
USGVirtualHandComponent* VirtualHandComponent)
bool UVirtualHandComponentKismetLibrary::GetMotionControllerData(
USGVirtualHandComponent* VirtualHandComponent, FXRMotionControllerData& OutMotionControllerData)
{
PRAGMA_DISABLE_DEPRECATION_WARNINGS
return VirtualHandComponent->GetMotionControllerData();
return VirtualHandComponent->GetMotionControllerData(OutMotionControllerData);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
}
bool UVirtualHandComponentKismetLibrary::GetMotionControllerState(USGVirtualHandComponent* VirtualHandComponent,
const EXRSpaceType XRSpaceType, const EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState)
{
return VirtualHandComponent->GetMotionControllerState(
XRSpaceType, XRControllerPoseType, OutMotionControllerState);
}
bool UVirtualHandComponentKismetLibrary::GetHandTrackingState(USGVirtualHandComponent* VirtualHandComponent,
const EXRSpaceType XRSpaceType, FXRHandTrackingState& OutHandTrackingState)
{
return VirtualHandComponent->GetHandTrackingState(XRSpaceType, OutHandTrackingState);
}
const TArray<FName>& UVirtualHandComponentKismetLibrary::GetHandBoneNames(
const USGVirtualHandComponent* VirtualHandComponent)
{
@@ -90,10 +90,27 @@ const FRotator& UWristTrackerComponentKismetLibrary::GetWristRotation(
return WristTrackerComponent->GetWristRotation();
}
const FXRMotionControllerData& UWristTrackerComponentKismetLibrary::GetMotionControllerData(
USGWristTrackerComponent* WristTrackerComponent)
bool UWristTrackerComponentKismetLibrary::GetMotionControllerData(
USGWristTrackerComponent* WristTrackerComponent, FXRMotionControllerData& OutMotionControllerData)
{
PRAGMA_DISABLE_DEPRECATION_WARNINGS
return WristTrackerComponent->GetMotionControllerData();
return WristTrackerComponent->GetMotionControllerData(OutMotionControllerData);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
}
bool UWristTrackerComponentKismetLibrary::GetMotionControllerState(
USGWristTrackerComponent* WristTrackerComponent,
const EXRSpaceType XRSpaceType, const EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState)
{
return WristTrackerComponent->GetMotionControllerState(
XRSpaceType, XRControllerPoseType, OutMotionControllerState);
}
bool UWristTrackerComponentKismetLibrary::GetHandTrackingState(
USGWristTrackerComponent* WristTrackerComponent,
const EXRSpaceType XRSpaceType, FXRHandTrackingState& OutHandTrackingState)
{
return WristTrackerComponent->GetHandTrackingState(
XRSpaceType, OutHandTrackingState);
}
@@ -61,20 +61,14 @@ public:
static void SetForceFeedbackLevel(UPARAM(ref) USGTouchComponent* TouchComponent, float Level);
UFUNCTION(BlueprintPure, Category="SenseGlove | Components | Touch Component")
static float GetVibrotactileAmplitude(const USGTouchComponent* TouchComponent);
static float GetVibrotactileLevel(const USGTouchComponent* TouchComponent);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Touch Component")
static void SetVibrotactileAmplitude(UPARAM(ref) USGTouchComponent* TouchComponent, float Amplitude);
static void SetVibrotactileLevel(UPARAM(ref) USGTouchComponent* TouchComponent, float Level);
UFUNCTION(BlueprintPure, Category="SenseGlove | Components | Touch Component")
static float GetVibrotactileDuration(const USGTouchComponent* TouchComponent);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Touch Component")
static void SetVibrotactileDuration(UPARAM(ref) USGTouchComponent* TouchComponent, float Duration);
UFUNCTION(BlueprintPure, Category="SenseGlove | Components | Touch Component")
static float GetVibrotactileFrequency(const USGTouchComponent* TouchComponent);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Touch Component")
static void SetVibrotactileFrequency(UPARAM(ref) USGTouchComponent* TouchComponent, float Frequency);
};
@@ -103,8 +103,18 @@ public:
static USGHapticGlove* GetConnectedGlove(const USGVirtualHandComponent* VirtualHandComponent);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Virtual Hand Component")
static const FXRMotionControllerData& GetMotionControllerData(
UPARAM(ref) USGVirtualHandComponent* VirtualHandComponent);
static bool GetMotionControllerData(UPARAM(ref) USGVirtualHandComponent* VirtualHandComponent,
FXRMotionControllerData& OutMotionControllerData);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Virtual Hand Component")
static bool GetMotionControllerState(UPARAM(ref) USGVirtualHandComponent* VirtualHandComponent,
EXRSpaceType XRSpaceType, EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Virtual Hand Component")
static bool GetHandTrackingState(UPARAM(ref) USGVirtualHandComponent* VirtualHandComponent,
EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState);
UFUNCTION(BlueprintPure, Category="SenseGlove | Components | Virtual Hand Component")
static const TArray<FName>& GetHandBoneNames(const USGVirtualHandComponent* VirtualHandComponent);
@@ -84,6 +84,16 @@ public:
static const FRotator& GetWristRotation(const USGWristTrackerComponent* WristTrackerComponent);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Wrist Tracker Component")
static const FXRMotionControllerData& GetMotionControllerData(
UPARAM(ref) USGWristTrackerComponent* WristTrackerComponent);
static bool GetMotionControllerData(UPARAM(ref) USGWristTrackerComponent* WristTrackerComponent,
FXRMotionControllerData& OutMotionControllerData);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Wrist Tracker Component")
static bool GetMotionControllerState(UPARAM(ref) USGWristTrackerComponent* WristTrackerComponent,
EXRSpaceType XRSpaceType, EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Components | Wrist Tracker Component")
static bool GetHandTrackingState(UPARAM(ref) USGWristTrackerComponent* WristTrackerComponent,
EXRSpaceType XRSpaceType,
FXRHandTrackingState& OutHandTrackingState);
};
@@ -49,7 +49,12 @@ public class SenseGloveKismet : ModuleRules
"CoreUObject",
"Engine",
"HeadMountedDisplay",
// NOTE
// UE 5.3+ provides UXRDeviceVisualizationComponent as part of the XRBase plugin.
// UE 5.2 provides UXRDeviceVisualizationComponent as part of the HeadMountDisplay module.
#if UE_5_3_OR_LATER
"XRBase",
#endif
}
);
@@ -37,13 +37,13 @@
FSGGloveTrackingSettings::FSGGloveTrackingSettings()
: FSGGloveTrackingSettings{
60.0f
1000.0f / 60.0f
}
{
}
FSGGloveTrackingSettings::FSGGloveTrackingSettings(
const float InDataRetrievalRefreshRate)
: DataRetrievalRefreshRate(InDataRetrievalRefreshRate)
const float InGloveConnectivityCheckInterval)
: GloveConnectivityCheckInterval(InGloveConnectivityCheckInterval)
{
}
@@ -51,17 +51,16 @@ struct SENSEGLOVESETTINGS_API FSGGloveTrackingSettings
public:
/**
* The glove data retrieval refresh rate. This affects the interval in which
* the tracking module checks for glove connectivity and data retrieval.
* The interval in which the tracking module checks for glove connectivity (in milliseconds).
*
* The default is s 60Hz (data retrieval operations per second).
* The default is 16.666666f which means 60 times per second.
*/
UPROPERTY(Config, EditDefaultsOnly, Category="Glove Tracking")
float DataRetrievalRefreshRate;
float GloveConnectivityCheckInterval;
public:
FSGGloveTrackingSettings();
explicit FSGGloveTrackingSettings(
float InDataRetrievalRefreshRate);
float InGloveConnectivityCheckInterval);
};
@@ -58,7 +58,7 @@ struct USGGloveTracker::FImpl
{
const USGSettings* Settings{USGSettings::GetInstance()};
ensureAlwaysMsgf(Settings, TEXT("The settings subsystem has not been initialized!"));
return 1.0f / Settings->GetTrackingSettings().GloveTrackingSettings.DataRetrievalRefreshRate;
return Settings->GetTrackingSettings().GloveTrackingSettings.GloveConnectivityCheckInterval * 0.001f;
}
/************************
@@ -124,24 +124,24 @@ void USGGloveTracker::Initialize(FSubsystemCollectionBase& Collection)
{
SGLOG("Starting the glove connectivity check timer...");
const float Interval = FImpl::GetGloveConnectivityCheckInterval();
const float GloveConnectivityCheckInterval = FImpl::GetGloveConnectivityCheckInterval();
FTimerDelegate Handler;
Handler.BindLambda([= SG_CAPTURE_THIS]()-> void
FTimerDelegate GloveConnectivityCheckHandler;
GloveConnectivityCheckHandler.BindLambda([= SG_CAPTURE_THIS]()-> void
{
Pimpl->UpdateGloves();
});
FTimerManager& TimerManager = World->GetTimerManager();
TimerManager.SetTimer(
Pimpl->GloveConnectivityCheckTimer, Handler, Interval,
Pimpl->GloveConnectivityCheckTimer, GloveConnectivityCheckHandler, GloveConnectivityCheckInterval,
true, -1.0f);
if (ensureAlwaysMsgf(TimerManager.IsTimerActive(Pimpl->GloveConnectivityCheckTimer),
TEXT("GloveConnectivityCheckTimer is not active")))
{
SGLOG("The glove connectivity check timer has been started successfully!");
SGLOG("The glove connectivity timer interval is: ", Interval);
SGLOG("The glove connectivity timer interval is: ", GloveConnectivityCheckInterval);
}
else
{
@@ -72,12 +72,12 @@ struct FSGHMDTracker::FStaticImpl
void FSGHMDTracker::FStaticImpl::GetHMDMonitorInfo(
IHeadMountedDisplay* Device, IHeadMountedDisplay::MonitorInfo& OutMonitorInfo)
{
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 4
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 5
Device->GetHMDMonitorInfo(OutMonitorInfo);
return;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 4 */
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 5 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 6
TPromise<TOptional<IHeadMountedDisplay::MonitorInfo>> Promise;
const TFuture<TOptional<IHeadMountedDisplay::MonitorInfo>> Future{Promise.GetFuture()};
@@ -100,7 +100,7 @@ void FSGHMDTracker::FStaticImpl::GetHMDMonitorInfo(
OutMonitorInfo = Result.GetValue();
}
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 6 */
}
FName FSGHMDTracker::GetDeviceName()
@@ -56,6 +56,9 @@
#include "Misc/Timespan.h"
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5 */
#include "OpenXRCore.h"
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 3
#include "OpenXRHMD.h"
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 3 */
#include "SGCore/SGHapticGlove.h"
#include "SGLog/SGLog.h"
@@ -68,6 +71,20 @@
#include "SGUtils/SGEngineUtils.h"
#include "SGUtils/SGPluginUtils.h"
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 3
void EnumerateOpenXRApiLayers(TArray<XrApiLayerProperties>& OutProperties)
{
uint32 Count = 0;
XR_ENSURE(xrEnumerateApiLayerProperties(0, &Count, nullptr));
OutProperties.SetNum(Count);
for (auto& Prop: OutProperties)
{
Prop = XrApiLayerProperties{XR_TYPE_API_LAYER_PROPERTIES};
}
XR_ENSURE(xrEnumerateApiLayerProperties(Count, &Count, OutProperties.GetData()));
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 3 */
struct FSGXRTracker::FImpl
{
/************************
@@ -650,10 +667,6 @@ struct FSGXRTracker::FImpl
void BuildMotionSourceToKeypointMap();
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7
void CreateHandTracker(XrSession InSession, XrHandEXT HandEXT, FSGXRHandState& HandState) const;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
bool CanOutputTrackingData(EControllerHand Hand) const;
bool UpdateXRHandTrackingData(FSGXRHandState& OutHandState, const XrHandJointsLocateInfoEXT& LocateInfo) const;
@@ -1013,8 +1026,6 @@ FTransform FSGXRTracker::FImpl::GetMeshFingerStartBoneRefTransform(
return Transform;
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
bool FSGXRTracker::GetMotionControllerData(
UObject* WorldContextObject,
const EControllerHand Hand,
@@ -1240,8 +1251,6 @@ bool FSGXRTracker::GetMotionControllerData(
return OutMotionControllerData.bValid;
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 5
bool FSGXRTracker::GetMotionControllerState(
@@ -1486,7 +1495,6 @@ bool FSGXRTracker::GetHandTrackingState(
OutHandTrackingState.HandKeyRadii,
bTracked);
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7
/// TODO
// Begin backward compatibility with the deprecated function, remove this block along with the deprecated
// GetAllKeypointStates.
@@ -1503,7 +1511,6 @@ bool FSGXRTracker::GetHandTrackingState(
// The inability to distinguish this is the reason for the deprecation.
}
// End backward compability.
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION < 7 */
if (!ensureAlwaysMsgf(
!OutHandTrackingState.bValid
@@ -1599,7 +1606,7 @@ bool FSGXRTracker::GetRequiredExtensions(TArray<const ANSICHAR*>& OutExtensions)
}
}
OutExtensions.Add(XR_EXT_HAND_TRACKING_EXTENSION_NAME);
OutExtensions.Add("XR_EXT_hand_tracking");
return true;
}
@@ -1648,29 +1655,21 @@ const void* FSGXRTracker::OnBeginSession(const XrSession InSession, const void*
// Create a hand tracker for the left hand that tracks default set of hand joints.
FSGXRHandState& LeftHandState{Pimpl->GetLeftHandState()};
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7
Pimpl->CreateHandTracker(InSession, XR_HAND_LEFT_EXT, LeftHandState);
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
{
XrHandTrackerCreateInfoEXT CreateInfo{XR_TYPE_HAND_TRACKER_CREATE_INFO_EXT};
CreateInfo.hand = XR_HAND_LEFT_EXT;
CreateInfo.handJointSet = XR_HAND_JOINT_SET_DEFAULT_EXT;
XR_ENSURE(Pimpl->XRCreateHandTrackerEXT(InSession, &CreateInfo, &LeftHandState.HandTracker));
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
// Create a hand tracker for the right hand that tracks default set of hand joints.
FSGXRHandState& RightHandState{Pimpl->GetRightHandState()};
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7
Pimpl->CreateHandTracker(InSession, XR_HAND_RIGHT_EXT, RightHandState);
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
{
XrHandTrackerCreateInfoEXT CreateInfo{XR_TYPE_HAND_TRACKER_CREATE_INFO_EXT};
CreateInfo.hand = XR_HAND_RIGHT_EXT;
CreateInfo.handJointSet = XR_HAND_JOINT_SET_DEFAULT_EXT;
XR_ENSURE(Pimpl->XRCreateHandTrackerEXT(InSession, &CreateInfo, &RightHandState.HandTracker));
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
}
return InNext;
@@ -1727,9 +1726,15 @@ void FSGXRTracker::UpdateDeviceLocations(
}
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3
bool FSGXRTracker::GetControllerOrientationAndPosition(const int32 ControllerIndex, const FName MotionSource,
FRotator& OutOrientation, FVector& OutPosition,
const float WorldToMetersScale) const
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
bool FSGXRTracker::GetControllerOrientationAndPosition(const int32 ControllerIndex, const EControllerHand DeviceHand,
FRotator& OutOrientation, FVector& OutPosition,
const float WorldToMetersScale) const
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
{
if (!IsHandTrackingStateValid())
{
@@ -1748,6 +1753,10 @@ bool FSGXRTracker::GetControllerOrientationAndPosition(const int32 ControllerInd
return false;
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 2
const FName& MotionSource{FImpl::GetControllerHandEnumName(DeviceHand)};
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 2 */
FTransform ControllerTransform;
bool bMotionSourceHandTracking;
const bool bGotTransform = Pimpl->GetControllerTransform(MotionSource, WorldToMetersScale,
@@ -1760,13 +1769,22 @@ bool FSGXRTracker::GetControllerOrientationAndPosition(const int32 ControllerInd
return bGotTransform;
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3
ETrackingStatus FSGXRTracker::GetControllerTrackingStatus(const int32 ControllerIndex, const FName MotionSource) const
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
ETrackingStatus FSGXRTracker::GetControllerTrackingStatus(const int32 ControllerIndex,
const EControllerHand DeviceHand) const
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
{
if (!IsHandTrackingStateValid())
{
return ETrackingStatus::NotTracked;
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 2
const FName& MotionSource{FImpl::GetControllerHandEnumName(DeviceHand)};
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION <= 2 */
const FImpl::FSGMotionSourceInfo* KeyPointInfoPtr{Pimpl->MotionSourceToKeypointMap.Find(MotionSource)};
if (!KeyPointInfoPtr)
{
@@ -2048,27 +2066,6 @@ void FSGXRTracker::FImpl::BuildMotionSourceToKeypointMap()
RightHandSGMotionSourceName, FSGMotionSourceInfo(EHandKeypoint::Wrist, false));
}
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7
void FSGXRTracker::FImpl::CreateHandTracker(XrSession InSession, XrHandEXT HandEXT, FSGXRHandState& HandState) const
{
XrHandTrackerCreateInfoEXT CreateInfo{XR_TYPE_HAND_TRACKER_CREATE_INFO_EXT};
CreateInfo.hand = HandEXT;
CreateInfo.handJointSet = XR_HAND_JOINT_SET_DEFAULT_EXT;
IOpenXRHMD* OpenXRHMD{XRTrackingSystem ? XRTrackingSystem->GetIOpenXRHMD() : nullptr};
if (OpenXRHMD)
{
TArray<IOpenXRExtensionPlugin*> ExtensionPlugins{OpenXRHMD->GetExtensionPlugins()};
for (IOpenXRExtensionPlugin* Plugin : ExtensionPlugins)
{
CreateInfo.next = Plugin->OnCreateHandTracker(CreateInfo.next);
}
}
XR_ENSURE(XRCreateHandTrackerEXT(InSession, &CreateInfo, &HandState.HandTracker));
}
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 7 */
bool FSGXRTracker::FImpl::CanOutputTrackingData(const EControllerHand Hand) const
{
const bool bFallbackToHandTrackingIfNoGloveDetected = ShouldFallbackToHandTrackingIfNoGloveDetected();
@@ -55,6 +55,7 @@ class SENSEGLOVETRACKING_API FSGXRTracker final : public IOpenXRExtensionPlugin,
public IHandTracker
{
public:
UE_DEPRECATED(5.5, "Deprecated by UE 5.5 in favor of GetMotionControllerState and GetHandTrackingState")
static bool GetMotionControllerData(
UObject* WorldContextObject,
EControllerHand Hand,
@@ -135,11 +136,19 @@ public:
public:
// The IMotionController interface.
#if ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3
virtual bool GetControllerOrientationAndPosition(const int32 ControllerIndex, const FName MotionSource,
FRotator& OutOrientation, FVector& OutPosition,
float WorldToMetersScale) const override;
virtual ETrackingStatus GetControllerTrackingStatus(const int32 ControllerIndex,
const FName MotionSource) const override;
#else /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
virtual bool GetControllerOrientationAndPosition(const int32 ControllerIndex, const EControllerHand DeviceHand,
FRotator& OutOrientation, FVector& OutPosition,
float WorldToMetersScale) const override;
virtual ETrackingStatus GetControllerTrackingStatus(const int32 ControllerIndex,
const EControllerHand DeviceHand) const override;
#endif /* ENGINE_MAJOR_VERSION >= 5 && ENGINE_MINOR_VERSION >= 3 */
virtual FName GetMotionControllerDeviceTypeName() const override;
virtual void EnumerateSources(TArray<FMotionControllerSource>& SourcesOut) const override;
@@ -55,9 +55,15 @@ public class SenseGloveTracking : ModuleRules
"InputDevice",
"OpenXRHMD",
"OpenXRInput",
// NOTE
// Only UE 5.3+ provides the XRBase plugin.
#if UE_5_3_OR_LATER
"XRBase",
#else
"OpenXR",
#endif
"Slate",
"SlateCore",
"XRBase",
}
);
@@ -45,4 +45,21 @@ bool USGXRTrackerKismetLibrary::GetMotionControllerData(
PRAGMA_DISABLE_DEPRECATION_WARNINGS
return FSGXRTracker::GetMotionControllerData(WorldContextObject, Hand, OutMotionControllerData);
PRAGMA_ENABLE_DEPRECATION_WARNINGS
}
bool USGXRTrackerKismetLibrary::GetMotionControllerState(
UObject* WorldContextObject,
const EXRSpaceType XRSpaceType, const EControllerHand Hand, const EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState)
{
return FSGXRTracker::GetMotionControllerState(
WorldContextObject, XRSpaceType, Hand, XRControllerPoseType, OutMotionControllerState);
}
bool USGXRTrackerKismetLibrary::GetHandTrackingState(
UObject* WorldContextObject,
const EXRSpaceType XRSpaceType, const EControllerHand Hand,
FXRHandTrackingState& OutHandTrackingState)
{
return FSGXRTracker::GetHandTrackingState(WorldContextObject, XRSpaceType, Hand, OutHandTrackingState);
}
@@ -57,4 +57,18 @@ public:
UObject* WorldContextObject,
EControllerHand Hand,
FXRMotionControllerData& OutMotionControllerData);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Tracking | XR Tracker",
meta=(WorldContext="WorldContextObject"))
static bool GetMotionControllerState(
UObject* WorldContextObject,
EXRSpaceType XRSpaceType, EControllerHand Hand, EXRControllerPoseType XRControllerPoseType,
FXRMotionControllerState& OutMotionControllerState);
UFUNCTION(BlueprintCallable, Category="SenseGlove | Tracking | XR Tracker",
meta=(WorldContext="WorldContextObject"))
static bool GetHandTrackingState(
UObject* WorldContextObject,
EXRSpaceType XRSpaceType, EControllerHand Hand,
FXRHandTrackingState& OutHandTrackingState);
};
Binary file not shown.
@@ -1,177 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGCommonThirdPartyLibs : ModuleRules
{
public SGCommonThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "sgcommon";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,177 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGConnectShmThirdPartyLibs : ModuleRules
{
public SGConnectShmThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "sgconnectshm";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,177 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGCoreShmThirdPartyLibs : ModuleRules
{
public SGCoreShmThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "sgcoreshm";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,53 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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 CoreION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGCoreThirdPartyHeaders : ModuleRules
{
public SGCoreThirdPartyHeaders(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PublicIncludePaths.Add(IncludePath);
}
}
Binary file not shown.
@@ -1,182 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGFmtThirdPartyLibs : ModuleRules
{
public SGFmtThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "fmt";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsDebugBuild)
{
LibraryName += "d";
}
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,177 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGLogThirdPartyLibs : ModuleRules
{
public SGLogThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "sglog";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,182 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGLoguruThirdPartyLibs : ModuleRules
{
public SGLoguruThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "loguru";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsDebugBuild)
{
LibraryName += "d";
}
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
@@ -1,177 +0,0 @@
/**
* @file
*
* @author Mamadou Babaei <mamadou@senseglove.com>
*
* @section LICENSE
*
* (The MIT License)
*
* Copyright (c) 2020 - 2025 SenseGlove
*
* 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.
*
* @section DESCRIPTION
*
*
*/
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using UnrealBuildTool;
public class SGWjwwoodSerialThirdPartyLibs : ModuleRules
{
public SGWjwwoodSerialThirdPartyLibs(ReadOnlyTargetRules Target) : base(Target)
{
Type = ModuleType.External;
string ThirdPartyDirectory = Path.GetFullPath(Path.Combine(ModuleDirectory, ".."));
string LibraryPath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "lib"));
string LibraryPathAnroidAArch64 = "";
string LibraryPathAnroidX64 = "";
string LibraryName = "serial";
bool bIsAndroid = Target.IsInPlatformGroup(UnrealPlatformGroup.Android);
bool bIsLinux = Target.Platform == UnrealTargetPlatform.Linux;
bool bIsLinuxArm64 = Target.Platform == UnrealTargetPlatform.LinuxArm64;
bool bIsWin64 = Target.IsInPlatformGroup(UnrealPlatformGroup.Windows) &&
Target.WindowsPlatform.Architecture == UnrealArch.X64;
bool bIsDebugBuild = (Target.Configuration == UnrealTargetConfiguration.Debug);
if (bIsAndroid)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "android"));
#if UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r27c"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "r25b"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinux)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsLinuxArm64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "linux"));
#if UE_5_7_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v26"));
#elif UE_5_6_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v25"));
#elif UE_5_5_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v23"));
#elif UE_5_4_OR_LATER
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v22"));
#else
Debug.Assert(false, "Unsupported engine version or compiler!");
#endif
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "aarch64"));
LibraryName = string.Format("lib{0}.a", LibraryName);
}
else if (bIsWin64)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "windows"));
switch (Target.WindowsPlatform.Compiler)
{
case WindowsCompiler.VisualStudio2022:
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "v143"));
break;
default:
Debug.Assert(false, "Unsupported engine version or compiler!");
break;
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "x86-64"));
LibraryName = string.Format("{0}.lib", LibraryName);
}
else
{
Debug.Assert(false, "Unsupported platform!");
}
string IncludePath = Path.GetFullPath(Path.Combine(ThirdPartyDirectory, "include"));
PrivateIncludePaths.Add(IncludePath);
if (bIsAndroid)
{
if (bIsDebugBuild)
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "debug"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "debug"));
}
else
{
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, "release"));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, "release"));
}
LibraryPathAnroidAArch64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidAArch64, LibraryName));
LibraryPathAnroidX64 = Path.GetFullPath(Path.Combine(LibraryPathAnroidX64, LibraryName));
PublicAdditionalLibraries.Add(LibraryPathAnroidAArch64);
PublicAdditionalLibraries.Add(LibraryPathAnroidX64);
}
else
{
if (bIsDebugBuild)
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "debug"));
}
else
{
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, "release"));
}
LibraryPath = Path.GetFullPath(Path.Combine(LibraryPath, LibraryName));
PublicAdditionalLibraries.Add(LibraryPath);
}
}
}
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

Some files were not shown because too many files have changed in this diff Show More