commit 1f2bbea36b9bdedf0fb5c7d26ea46ddd5c9abb4c Author: Mamadou Babaei Date: Mon Feb 10 12:12:24 2025 +0100 initial commit diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..70cf0fe --- /dev/null +++ b/.gitattributes @@ -0,0 +1,43 @@ +# Keep CRLF out of the repository +* text=auto eol=lf + +# Always keep config files (even the empty ones under Git, not LFS) +Config/* filter= diff= merge= text + +# In case the git binary/text auto-detection algorithm fails, in order to avoid +# line-ending normalization, treat these files as binary no matter what +*.{uasset,umap,3ds,fbx,flac,gif,jif,jiff,jpe,jpeg,jpg,m4a,mp3,mp4,ogg,png,psd,ttf,wav,webp,xcf} binary + +# LFS: UE4 file types +*.uasset filter=lfs diff=lfs merge=lfs -text +*.umap filter=lfs diff=lfs merge=lfs -text + +# LFS: raw content types +*.3ds filter=lfs diff=lfs merge=lfs -text +*.fbx filter=lfs diff=lfs merge=lfs -text +*.flac filter=lfs diff=lfs merge=lfs -text +*.gif filter=lfs diff=lfs merge=lfs -text +*.jif filter=lfs diff=lfs merge=lfs -text +*.jiff filter=lfs diff=lfs merge=lfs -text +*.jpe filter=lfs diff=lfs merge=lfs -text +*.jpeg filter=lfs diff=lfs merge=lfs -text +*.jpg filter=lfs diff=lfs merge=lfs -text +*.m4a filter=lfs diff=lfs merge=lfs -text +*.mp3 filter=lfs diff=lfs merge=lfs -text +*.mp4 filter=lfs diff=lfs merge=lfs -text +*.ogg filter=lfs diff=lfs merge=lfs -text +*.png filter=lfs diff=lfs merge=lfs -text +*.psd filter=lfs diff=lfs merge=lfs -text +*.ttf filter=lfs diff=lfs merge=lfs -text +*.wav filter=lfs diff=lfs merge=lfs -text +*.webp filter=lfs diff=lfs merge=lfs -text +*.xcf filter=lfs diff=lfs merge=lfs -text + +# LFS: everything under Content/ tracking rules +Content/**/* filter=lfs diff=lfs merge=lfs -text + +# LFS: Plugins/Source/ThirdParty/ tracking rules +Plugins/**/Source/ThirdParty/**/* filter=lfs diff=lfs merge=lfs -text + +# LFS: Plugins/ViveOpenXR/Source/ViveOpenXRLoader/lib/ tracking rules +Plugins/ViveOpenXR/Source/ViveOpenXRLoader/lib/**/* filter=lfs diff=lfs merge=lfs -text \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..562b694 --- /dev/null +++ b/.gitignore @@ -0,0 +1,134 @@ +# Explcitly ignore annoying Windows files, regardless of where they are +[Dd]esktop.ini +Thumbs.db + +# Explcitly ignore annoying macOS files, regardless of where they are +.DS_Store + +# Makefile; only in the project root +/Makefile + +# CMake; only in the project root +/CMakeLists.txt + +# QMake / Qt Creator +*.pro +*Config.pri +*Defines.pri +*Header.pri +*Includes.pri +*Source.pri +.qmake.stash +*.autosave +*.pro.user +*.pro.user.* +CMakeLists.txt.user +CMakeLists.txt.user.* + +# Visual Studio +.vs/ +.vsconfig +*.sln +*.suo +*.opensdf +*.sdf +*.VC.db +*.VC.opendb + +# Visual Studio Code +.vscode/ +*.code-workspace + +# Code::Blocks +*.workspace + +# CodeLite +*CodeLitePreProcessor.txt + +# KDevelop +.kdev4/ +*.kdev4 + +# CLion +*CodeCompletionFolders.txt + +# IntelliJ IDE +.idea/ + +# Xcode +*.xcodeproj +*.xcworkspace + +# Compiled Object files +*.slo +*.lo +*.o +*.obj + +# Precompiled Headers +*.gch +*.pch + +# Compiled Dynamic libraries +*.so +*.dylib +*.dll + +# Fortran module files +*.mod + +# Compiled Static libraries +*.lai +*.la +*.a +*.lib + +# Executables +*.exe +*.out +*.app +*.ipa + +# Precompiled Assets +SourceArt/**/*.png +SourceArt/**/*.tga + +# Binary Files +Binaries/* +Plugins/*/Binaries/* + +# Builds +Build/* + +# Whitelist PakBlacklist-.txt files +!Build/*/ +Build/*/** +!Build/*/PakBlacklist*.txt + +# Don't ignore icon files in Build +!Build/**/*.ico + +# Built data for maps +*_BuiltData.uasset + +# Configuration files generated by the Editor +Saved/* + +# Compiled source files for the engine to use +Intermediate/* +Plugins/*/Intermediate/* + +# Cache files for the editor to use +DerivedDataCache/* + +# Misc +.ignore + +# The Platforms folder +Platforms/ + +# Whitelist Plugins/**/Source/ThirdParty/**/* +!Plugins/**/Source/ThirdParty/**/* + +# Whitelist Plugins/ViveOpenXR/Source/ViveOpenXRLoader/lib/**/* +!Plugins/ViveOpenXR/Source/ViveOpenXRLoader/lib/**/* \ No newline at end of file diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..f0a5cd4 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,57 @@ +# The SenseGlove Unreal Engine Plugin License + +``` +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. +``` + +# VRExpansionPlugin, OpenXRExpansionPlugin, AdvancedSteamSessions, and AdvancedSessions License + +``` +Copyright Joshua Statzer + +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. +``` + +# Meta XR Plugin License + +For the Meta XR Plugin usage license please visit the [official website](https://developers.meta.com/horizon/downloads/package/unreal-engine-5-integration/). + +# VIVE OpenXR License + +For the HTC VIVE OpenXR plugin usage license please visit the [official website](https://developer.vive.com/resources/openxr/unreal/). \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..374bf06 --- /dev/null +++ b/README.md @@ -0,0 +1,17 @@ +# SenseGlove VRExpansion Plugin Integration Demo + +A sample project demonstrating how to integrate the SenseGlove Unreal Engine Plugin into third-party OpenXR plugins such as the [VRExpansionPlugin](https://github.com/mordentral/VRExpansionPlugin). + +## Compatibility + +This demo is compatible with UE `5.4`. + +## How to checkout + +The most straightforward way to download this project is to click on the kebab menu (three vertical dots) located at the top-right of the screen and choose Download as Zip to obtain the source code for that branch or tag. + +This repository is fully self-contained and ships a compatible version of the SenseGlove Unreal Engine Plugin with itself along with any third-party plugin that is required. So, once you download it using the kebab menu you can simply start using the project without the extra work of obtaining any plugins separately. + +## License + +Checkout the [LICENSE.md](./LICENSE.md) file for the usage license of this project, the SenseGlove Unreal Engine Plugin or any third-party plugins that are shipped through this repository. \ No newline at end of file