Stream to 3D - Settings


There are a range of configuration settings that can be tweaked to get the most out of the Stream to 3D application in different scenarios, which require further explanation.

Settings - Tools

The Tools configuration settings can be accessed from the Tools option in the main menu. This short cut makes it quicker to switch media players, for example.

It is best to check that the Tools configuration is correct following first installation or upgrade to make sure that everything has been correctly discovered and configured, clicking on the Tools item in the main menu takes us to the screen below:

If you had some of these tools installed before installing Stream to 3D, make sure that the paths that appear in the path selection boxes are correct. Stream to 3D uses the registry settings of these tools to determine their installed locations, if they are incorrect then you can change them accordingly.

Settings - Tools - Media Players

If you have any of the supported media players installed, you can use the Media Player drop-down to change the current Media Player (and so the install path displayed - labelled as MP Path) and edit the path as necessary. The Media Player selected is also the one that will be used when you hit the "Play" main menu button to play a video through Stream to 3D, which will be automatically converted to a 3D format:

As an example of configuration of other media players, this is the view with PotPlayer installed and selected:

You can also specify a "Custom" media player and the path to its ".exe" file, but the custom media player must be able to accept ".avs" files as input.

Settings - Tools - Libraries

The libraries (shown on Lib Path 1 and Lib Path 2) assist with scene and motion detection during 2D to 3D conversion. They are not absolutely required, but the quality of the 2D to 3D conversion will be enhanced significantly when they are available.

Settings - Tools - Video Streaming and Conversion [NA for Real-Time product]

The FFMpeg tool is used for video streaming and during off-line video conversion. The latest version of FFMpeg is downloaded during Stream to 3D installation, if selected. Check that the installation path is correct, particularly if you are using your own version of FFMpeg.

Stream to 3D auto-detects whether you have an Nvidia or AMD GPU and, if enabled, will use the appropriate FFMpeg settings for GPU accelerated video encoding to either H.264 or H.265. For details of configuring FFMPeg for Streaming and Conversion, click here.

Important: For GPU accelerated video encoding, FFMpeg has a dependency on your GPU graphics driver, so you need to make sure that your GPU graphics driver is up to date. You will receive an error from Stream to 3D, telling you to upgrade your graphics driver, during video streaming or conversion if there is a mismatch.

Settings - Format

The Format settings page provides control over the 3D video file output format from Stream to 3D and the file name format that is recognised by Stream to 3D as representing a 3D video file. The same settings are applied for real-time playback, streaming and file conversion.

The 3D output drop-down list allows selection of a number of different 3D output formats:

  • SBS (Full Side by Side)
  • TB/OU (Full Top/Bottom)
  • HSBS (Half Side by Side)
  • HTB/HOU (Half Top/Bottom)
  • HSBS Upscaled
  • HTB/HOU Upscaled
  • Anaglyph 3D (Red/Cyan)

The "HSBS Upscaled" and "HTB/HOU Upscaled" formats require a little more explanation. HSBS Upscaled outputs the video in HSBS format, but upscales the video so that it has the same resultant resolution as Full SBS, by retaining the horizontal resolution of the original video and doubling the vertical resolution. Similarly, HTB/HOU Upscaled retains the original vertical resolution of the video, but doubles the horizontal resolution. This is for compatibility with devices/media players that only support Half SBS/TB formats. However, the trade off in increased quality is an increased demand in terms of machine resources.

Anaglyph 3D (Red/Cyan) provides the 3D output in a format that can be displayed on a 2D device and viewed with Red/Cyan glasses.

The preset configurations supplied with Stream to 3D for Virtual Desktop and BigScreen Steam VR use a format of SBS (Full Side by Side) for Virtual Desktop and HSBS (Half Side by Side) for BigScreen. If your system can handle it, you could experiment with the Upscaled formats for BigScreen.

The "Resize Input Video to..." checkbox option allows you to optionally resize the resolution of a 2D video before it is converted to 3D. This is usually to scale down very high-resolution videos (e.g. 4K) before conversion, particularly if they are higher resolution than would be supported by the target device.

The value selected in the "Maximum Width"  drop-down is applied if the "Resize Input Video to" checkbox is ticked. In this case the input 2D video is resized to the width selected, before 2D to 3D video processing is applied. You can think of this as the maximum target, per eye resolution of the output 3D video. The output video may actually end up with a lower horizontal per eye resolution than this if the "Force 16:9 Output" option is selection, as aspect ratio correction may in some cases crop the video further after the intial resize pre-processing is complete. As a guide, note that the maximum per eye resolution of the Quest 2 VR headset, for example, is 1,832 × 1,920 pixels and for the Oculus Quest Pro it is similar at 1800 × 1920 per eye. VR headsets have a variety of resolutions, see here for details.

The "IPD Frame Stretch" factor allows tweaking of the depth effect. You can increase the value to heighten the depth effect, but setting it too high will cause the effect to break down and introduce distortion. It is also related to Interpupillary Distance, so if the 3D view is not comfortable for you, try adjusting this stretch factor.

When the "Force 16:9 Output" check box is used, Stream to 3D will change the aspect ratio of 3D output videos to 16:9 by automatically cropping in the vertical or horizontal direction to achieve the required aspect ratio. Many output devices have a fixed standard 16:9 aspect ratio, this option can be used to better support such devices.

The "3D File Name Pattern" item allows maintenance of the pattern used by Stream to 3D functions to determine whether a file is in 3D format. See here for further details.

Settings - Algorithm

For background and further reading on the algorithm used by Stream to 3D, see here. Several significant enhancements to the base algorithm are implemented in Stream to 3D to enhance the effect and eliminate discomfort. These are described here and here. The Algorithm settings in Stream to 3D allow fine tuning of the algorithm.

The "Detect Scenes" checkbox enables or disables scene detection. The base algorithm breaks down at scene transitions and causes discomfort to the viewer. As discussed here, enabling this setting effectively eliminates the impact of scene transitions.

The base algorithm can also introduce discomfort when there is large scale rapid movement, characterised by large scale visual changes between frames. This is similar to a scene transition. The same enhancement introduced to eliminate the impact of scene transitions also addresses large scale rapid motion between frames. The "Threshold" setting determines the percentage of the frame that needs to change before it is treated as a large scale rapid motion change. The 10% default has been determined as effective for a wide range of videos, but it can be tuned if necessary using the "Threshold" drop-down percentage value.

The "Show Detected" checkbox is provided to assist tuning of the "Threshold" value. When the "Show Detected" checkbox is checked, the 2D to 3D conversion process will turn the right eye view pink at detected scene transitions and when large scale rapid motion is detected. Viewing the video with this enabled will allow you to increase of decrease the threshold to your tastes. However, the default value works well for most cases.

The "Stabilize Frames" checkbox, enables or disables the algorithmic enhancement described here, in terms of Motion and Alignment. Enabling this item has a very significant effect in reducing discomfort, but also dampens the 3D effect somewhat. You can adust to your taste.

The "Frame Rate" setting allows you to set the output frame rate following 2D to 3D conversion. The default frame rate is 24 Frames Per Second (FPS). The available values are 24, 30, 48, 60 and 120 frames per second.

Note that frame rate interpolation is used to generate intermediate frames for all but the default of 24 FPS. Frame rate interpolation is a very resource intensive process and it is unlikely that you will be able to achieve real-time conversion for the higher frame rates, particularly for full frame 3D output on high-resolution videos. However, these rates can be successfully applied for off-line conversion.

The default frame rate is obtained by sampling the source video at 24 FPS rather than performing interpolation, so there is no frame rate interpolation overhead at 24 FPS.

Note also that these selectable FPS values are shorthand approximations for the actual industry standard frame rates applied which are; 23.976, 29.97, 47.952, 59.94 and 119.88 frames per second respectively.

Note the "CPU Cores to Use" item. Stream to 3D automatically detects the number of CPU cores on your machine. By default it will set the number of "CPU Cores to Use" for conversion, streaming and playback to half the number of CPU cores available. This is to reduce the risk of Stream to 3D processing impacting other processes running on your machine. You can experminent with this value.

Settings - Saving Configurations

You can save Stream to 3D configurations settings for distinct purposes in different config files, using the Settings/Save Setttings menu option as shown in the screen shot below and reload them again with the Load Settings option:

You can edit the name of the settings save file to suit your purposes.

Click here to go to the Usage and Configuration home page.