Giter Club home page Giter Club logo

xr-stereoscopic-viewer's Introduction

README

XR-Stereoscopic-Viewer

Introduction

A viewer of Spatial Video and Spatial image in XR devices.

Bring the experience of the Photos App in Apple Vision Pro to the META Quest series headset, with support for Spatial Video and Spatial image. This Project aims to showcase the stereoscopic imaging solution of Apple, allowing us to immerse in its charm in advance.

Features Roadmap

  • Spatial photo view
  • Spatial video view
  • IPD adjustment
  • Import local files
  • Spatial UI
  • Bump mapping
  • Window transform adjustment
  • MR mode
  • Advanced blur effect

Requirements

  • Meta Quest 2 / Pro / 3
  • Enable developer mode (you can follow these instructions).
  • Device system version V56 or later is recommended

Getting Started

  1. Download the APK.
  2. Connect Quest to computer, use SideQuest or other ADB tools to install it.
  3. Download ‘Media’ file and Unzip folder to the ‘Media’ folder.
  4. "Place the ‘Media’ folder into the ‘Android.Eis4TY.XRStereoscopicViewer’ directory. (If you can’t see this folder, please open the app once, then close it and try again)
  5. Alternatively, you can create a new folder named ‘Media’ here and then add your stereoscopic photos and videos to the folder. The program currently supports .jpg, .png, and .mp4 formats”.
  6. To use the extrusion depth feature, the black and white depth map must be named '[Original Image Name]_D' and placed in the 'Media' folder as well. The program will automatically recognize it. Photos with a depth map will display the extrusion depth controls in the 'Settings' UI.
  7. Open the app and enjoy. (The program is not yet perfect, so you may encounter some bugs)

Getting Started (ZH)

  1. 下载 APP
  2. 将头显连接到计算机并运行访问文件,使用SideQuest或其他ADB工具来安装 APP。
  3. 下载 ‘Media’ 文件并解压到 ‘Media’ 文件夹。
  4. 将 ‘Media’ 文件夹放入 “Android.Eis4TY.XRStereoscopicViewer” 文件夹中 (如果你看不到这个文件夹,请先打开一次 APP,然后关闭再试)。
  5. 或在此处新建一个名为 “Media” 的文件夹,然后将你的立体照片和立体视频放入文件夹,程序目前支持.jpg.png.mp4格式
  6. 使用挤出深度功能需要将黑白深度图命名为 “原图名字_D”,同样放入 “Media” 文件夹,程序会自动识别。带有深度图的照片会「Settings」中显示挤出深度控件。
  7. 打开 APP 并欣赏。(目前程序还不够完善,可能会遇到一些 bug)

BUGs

  1. Importing too many files may cause memory overflow

How to build?

Get the XR-Stereoscopic-Viewer open-source application running on your own devices.

  1. Clone this project.
  2. Open the project with Unity 2022.3.9f1 (Android Build).
  3. Navigate to File > Build Settings..., select the Android platform, then select your Meta Quest Pro as the Run device (if it's plugged in) and then click on Build and Run.

Acknowledgements

xr-stereoscopic-viewer's People

Contributors

eis4ty avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.