Video Format Guidelines

The Knowledgebase has moved! Please visit the link below for updates and new articles.

https://facebookincubator.github.io/facebook-360-spatial-workstation/KB.html

 

 

While the Video Player can load and playback a variety of formats, for the best performance follow the guidelines below. The guidelines are for both Desktop View and VR View. This page will be updated as we make improvements to our video engine.

These guidelines are for Slave mode. Standalone mode may handle higher resolutions and frame rates.

A test DNxHD video can be downloaded from here.

Please ensure that the version of the FFmpeg binary that is installed on your system is at least 3.3.2 or above.

Desktop and VR View  
Format Avid DNxHD, Profile: DNxHR_LB Encoding to Avid DNxHD can be done  in a tool like iFFmpeg or directly invoking ffmpeg in a terminal window
Resolution Up to 3840x2160 (Full list of supported resolutions here. Higher resolutions may be possible, depending on your computer) but consider lowering resolutions if it becomes too taxing on your system

Resolution and aspect ratio can be specified in FFmpeg with

-s WIDTHxHEIGHT -aspect HORIZONTAL:VERTICAL
Frame Rate (Frames Per Second) Up to 30 fps (higher frame rates may be possible, depending on your computer)

Frame rate can be specified in FFmpeg with:

-r 30
3D Video If you aren’t using a VR device for live preview, consider exporting a 2D version as this will allow for a higher resolution when using the Desktop mode.   See below

The following FFmpeg command would take a video and convert it to the recommended format without affecting the resolution of the original video:

ffmpeg -i <input.mp4> -map 0:v -an -c:v dnxhd -pix_fmt yuv422p -trellis 0 -me_range 16 -refs 3 -sc_threshold 40 -nitris_compat 1 -sn -profile:v dnxhr_lb -y <output-video.mov>

Converting videos to DNxHD with iFFMpeg

iFFmpeg for OSX is a useful video conversion utility. The Windows version is called MyFFMpeg. The steps below are for converting a video to DnxHD so it can be played back with the Video Player using iFFmpeg.

DNxHD is a codec (we recommend using DnxHR LB as the profile) that is used commonly in post-production as it can reduce CPU load when decoding video. Other codecs such as H.264 are often not ideal for post-production, depending on the capabilities of the computer being used.

We recommend that you download our preset for iFFmpeg/myFFmpeg from here

  1. Open iFFmpeg/MyFFmpeg

  2. Go to Preferences -> Preset Manager -> Open Preset folder and drop the downloaded preset there
    Screen_Shot_2017-05-22_at_17.58.24.png
  3. Drag your video into the iFFmpeg main window
    Screen_Shot_2017-05-22_at_18.00.12.png

  4. From the dropdown menu, choose User Preset -> dnxhr_lb_4k (the preset you just downloaded)
    Screen_Shot_2017-05-22_at_18.01.58.png

  5. Click on "Edit" under "Video (DNxHD)" in the right column. Set the video size or other settings beyond what the preset offers. We recommend a maximum resolution of 3840x2160 and a maximum frame rate of 30FPS (higher frame rates and resolutions might work depending on your computer).

    Screen_Shot_2017-05-22_at_18.05.40.png

  6. Click on "General" to confirm that the 'Custom Encode options' have this value:-profile:v dnxhr_lb
    Screen_Shot_2017-05-22_at_18.08.17.png
  7. Ensure that you check our video guidelines above for more details around resolution, scaling and frame rate options.

 

Converting 3D Video to 2D

The simplest way to convert stereoscopic video to mono is to use the video for a single eye and crop the other half of the video.

The bottom portion of a top bottom video can be cropped with:

-vf crop=iw:ih/2:0:0

The right portion of a side by side video can be cropped with:

-vf crop=iw/2:ih:0:0

 

 

The above guidelines are based on tests with the following devices:

  • MacBook Pro (Retina, 15-inch, Mid 2015)
  • MacBook Pro (Retina, 15-inch, Mid 2014)
  • VR Ready PC

________________________________________________________________________________________________

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk