https://github.com/facebookarchive/Surround360

Surround360 is Facebook's open source hardware and software for capturing stereoscopic 3D 360 video for VR. The repo contains hardware designs, as well as software for camera control and rendering.
https://github.com/facebookarchive/Surround360

Last synced: 3 days ago
JSON representation

Surround360 is Facebook's open source hardware and software for capturing stereoscopic 3D 360 video for VR. The repo contains hardware designs, as well as software for camera control and rendering.

• Host: GitHub
• URL: https://github.com/facebookarchive/Surround360
• Owner: facebookarchive
• License: other
• Archived: true
• Created: 2016-06-20T21:25:29.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-08-30T06:22:04.000Z (about 5 years ago)
• Last Synced: 2024-05-21T06:05:49.074Z (6 months ago)
• Language: C++
• Size: 49.9 MB
• Stars: 2,162
• Watchers: 270
• Forks: 578
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-360video-search - [software

README

        
# Surround360 System

Surround360 is a hardware and software system for capturing and rendering 3D (stereo) 360 videos and photos, suitable for viewing in VR. We divide the open source components of the system into three subdirectories:

* /surround360_design -- hardware designs and assembly instructions

* /surround360_camera_ctl_ui -- Linux desktop application for controlling the camera to capture raw data

* /surround360_render -- software for rendering the raw data that is captured into a format suitable for viewing in VR.

## Instruction Manual ##

Please refer to our instruction manual (which covers use of both hardware and software) here:

https://github.com/facebook/Surround360/blob/master/surround360_design/assembly_guide/Surround360_Manual.pdf

## Sample Data ##

We provide a sample dataset for those who are interested in testing the rendering software without first building a camera.

* "Palace of Fine Arts Take 1" - 2 frames - (337.4MB)

  * Raw data: http://surround360.hacktv.xyz/sample/sample_dataset.zip

  * Sample result: https://s3-us-west-2.amazonaws.com/surround360/sample/sample_result.zip

  * NOTE: The Surround 360 hardware and camera control software records to a RAW binary format which needs to be unpacked to get to the individual images. In this smaller dataset, the 'unpack' and 'arrange' steps of the pipeline have already been run (see run_all.py), so you do not need to run them again.

* "Facebook Building 20" - 190 frames - (21.15GB)

  * Binary file 1: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/0.bin (10.76GB)

  * Binary file 2: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/1.bin (9.56GB)

  * Sample result: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/render.zip (823.6MB)

  * NOTE: the render directory contains calibrated config files and two rendered frames

  * The file NOTES.txt contains sample commands to process the binaries

## Join the Surround360 community

See the CONTRIBUTING file in each subdirectory for how to help out.

## License

The hardware designs, camera control software, and rendering software are subject to different licenses. Please refer to the LICENSE file in each subdirectory. We also provide an additional patent grant.