User Manual



Opening a Stereo Pair or Video File

You can open a stereo file (JPS, JPEG, MPO) or a video file in the following ways:

  • Via menu “File” - > “Open” or The Open button on the toolbar.
  • Drag and drop the file from the file Manager (Explorer) to the program window.
  • Double click on the file of the registered type (JPS or MPO).
  • Through the context menu “Open with …” in Explorer.

Opening a Stereo Pair From a Separate File

If the Stereo pair is stored in separate files for the left and right eyes, you can download it one way:

  • Through the “file” menu - > ” open separate files “ or The Открыть button on the toolbar.
    In the window that opens, first select the image file for the left eye and then for the right eye.
  • Highlighting in Explorer 2 file and dragging them into the program window.
  • Through the context menu “Open with …” in Explorer, selecting 2 files.

Format of the Source

Supported stereo formats:

  • Row Interlaced;
  • Column Interleaved;
  • Anaglyph Red/Cyan;
  • Anaglyph Yellow/Blue;
  • Side by Side;
  • Anamorphic Side by Side;
  • Over/Under;
  • Anamorphic Over/Under;
  • Mono;

The file format is determined automatically in the following cases:

  • The MPO file is opened.
  • A video file with two video streams is opened.
  • The JPS or JPEG file contains a stereo handle.
  • The video file contains metadata describing the stereo format.

If the format is not automatically defined, you can select it from the source Format menu.

Стерео-форматы

Viewing Stereoscopic Content

Display Format

To play the stereo effect correctly, you need to select the display format that matches your display.

If you are using a monitor or TV with passive polarization technology (e.g. LG Cinema 3D), use the Row Interlaced format. At the same time, the native resolution of the monitor must be set in the OS settings.

If you are using a normal monitor and anaglyph glasses, select red-blue or yellow-blue anaglyph.

Additionally, there are various options for the location of the angles on the frame.

Control

You can control the view through the View menu or through the context menu of the image, which is opened by right-clicking on the image. Keyboard shortcuts for actions are displayed in tooltips.

Video Playback

To control video playback, when the mouse pointer moves over the frame, a special panel appears that allows you to pause playback, change the current position, and change the volume.

StereoPhotoView allows you to navigate through the files in the current image folder with the PageUp, PageDown, Home, and End keys.

To display the files in the folder of the current image, select menu “View” → “Thumbnail bar (T)”. In full screen mode, you can simply move the mouse pointer over the top of the screen.

Working with the File System

You can delete, move, or copy a currently opened file to the trash.

Start Screen

When the application starts, or when the file is closed, the application displays a folders tree, a list of favorite folders, and a list of recent folders.

Folders Tree

The computer’s file system directory tree is displayed on the bottom left of the start screen. The contents of the selected folder are displayed on the right.

Favorite Folders

The top left of the home screen displays a list of your favorite folders.

To add a folder to your favorites list, click the folder on the right side of the screen and select “Add to favorites”.

To remove a folder from favorites, right-click the desired folder in the list of “favorite folders” and select “Delete”.

Recent Folders

Select “Recent folders” from the Favorite folders list to open the list of folders from which the most recent files were opened.

To delete one or all folders from the list of recent folders, right - click on the folder and select the appropriate menu item.

Editing 3D Photos and Videos

Alignment

Alignment

The tool “Alignment” is opened via menu “Edit” → “Alignment” or by the “A” key.

The vertical slider on the right and the “Up” and “Down” keys are used for vertical alignment.
For horizontal-slider at the bottom of the screen and “Left” and “Right” keys.
If you press these keys together with Ctrl, the angles will move in big steps.

If camera angles are taken from hands, you may need to rotate the camera angles. This is done using sliders and spinners at the top of the image.

For horizontal alignment (parallax settings), the object that will be visually located on the plane of the screen must be equalized so that on the left and right angles, it was in one place of the screen (not twofold). In this case, the objects behind it will be perceived by the eye as if they are behind the screen, and those objects that are in front of it - in front of the plane.

The left eye image on the protruding objects is to the right of the image for the right. That is, to view them you need to keep your eyes to the nose. For comfortable viewing, it is recommended not to allow too much distance between images of the same part at different angles (severe ghosting).

Vertically, you just need to combine the left and right angle so that the objects are on the same level.

Once you have achieved the desired result, click “Apply”.

Auto-alignment

Follow the menu “Edit” → “Auto Alignment” or press Ctrl+A keys.

Then, use the mouse to select a square area on the image, which will be visually located on the screen plane. To change the size of the area, use the mouse wheel.

Click the left mouse button. The program will search for key points in the selected area and align the image with them.

Extended Auto-alignment

This tool is launched via the menu “Edit” → “Extended Auto Alignment” or by Ctrl+E,A keys.

The program finds similar key points in the images and calculates the required amount of vertical, horizontal, and angle shifts. The Alignment tool described above is then opened.

In the menu “Edit” → “Settings…” you can choose which parameters will be calculated automatically: parallax, vertical displacement, rotation.

Crop

Tool “Crop” is opened via menu “Edit” → “Crop” or by pressing “C” key.

Select the desired region of the image and click button “Crop”.

In the lower pane, you can also select the desired aspect ratio of the frame.

Crop

Editing angles in an external editor

This function can be useful, for example, to remove red-eye in an external editor.

  1. Select the desired editor from the edit menu → Open left view in….
  2. The left angle should open in the selected program.
  3. After editing, save the file with the same name, return to the stereophotoview window, and click “Import”.

Saving Images

Edited images can be saved in the MPO format or JPS (JPEG).

To save a file with the same name, select File → Save.

To save with a different name or in a different stereo format, perform “File” → “Save as…”.
When you do this, you will first see a window to select a new file name, and then the file settings window.
In the window that opens, select the angle location and frame resolution.
By default, the first view is left. If necessary, you can change this by checking “Reverse order”.

When saving, a stereo descriptor is written to the JPS file, so that it is possible to automatically determine the source format when opening such a file.

Saving Videos

The edited video can only be saved to another file.

To do this, select File → Save as…. The new file name selection window opens first, followed by the file settings window.

Choose a stereo format, similar to saving an image, and video encoding options.

The constant rate factor is used as the CRF parameter for the H264 codec, and to calculate the bitrate for the other codecs. In the second case, it has a percentage values from the “raw” bitrate.

For example, target bitrate of the video stream is calculated as: Bitrate = Constant Rate Factor * Width * Height * Binapacryl * Chemotactical / 100.

Codecs and the possibility of storing the descriptions of the stereo format for the different types of video file:

Container Video Codec Audio Codec Stereo Format Description
MP4 H264 AC3 Yes
MOV H264 AC3 Yes
Matroska H264 AC3 Yes
AVI MPEG4 MP3
FLV FLV MP3

Stored MP4 files is automatically defined as the 3D content with the LG TV.

Saving a Freeze Frame from a Video

To save the freeze frame, run the command “File” → “Save a freeze frame as…” or click Стоп-кадр button.

This opens the save image window where you can select file name and the desired stereo format to save the current video frame.

Command Line Mode

Command-line mode can be useful for automating the processing of multiple files, such as preparing for printing, or publishing to the Internet.

To do this, the application includes the command-line utility stereo-conv.

In Windows, when installed, the path to the application folder is automatically added to the PATH variable. In order for these changes to take effect, you need to re-login.

Running with the –help option, or without options, displays usage help. Example:

$ stereo-conv --help

Usage: stereo-conv [options] input input2
Converter for stereoscopic photos and videos.
https://stereophotoview.bitbucket.io/en                                                                                    
                                                                                                                           
Options:                                                                                                                   
  -h, --help                 Displays this help.                                                                           
  -v, --version              Displays version information.                                                                 
  -o, --output <file>        Output file.                                                                                  
  --input-layout <layout>    Input stereo layout (see --layouts) - optinal.                                                
  --input-revert <1|0>       Right-eye view first in the input file - optional.                                            
  --output-layout <layout>   Output stereo layout (see --layouts). Default -                                               
                             Monoscopic.                                                                                   
  --output-revert <1|0>      Right-eye view first in the output file -                                                     
                             optional.                                                                                     
  --size <width*height>      Output image size.
  --jpeg-quality <0..100>    Jpeg quality.
  --crf <1..51>              Constant rate factor. Default - 23.
  --preset <preset>          Preset for H264 codec (see --presets). Default -
                             medium.
  --operations <operations>  List of operations separated by a semicolon (see
                             --help-operations).
  -p, --progress             Display progress when saving video.
  -l, --layouts              Display a list of layouts.
  --video-formats            Display a list of video formats.
  --presets                  Display a list of presets.
  --help-operations          Display a list of operations.

Arguments:
  input                      Input file.
  input2                     Optional second input file to load a separate
                             stereo pair.

Examples

Extracting Left View From MPO File

Convert src.mpo to src-left.jpg.
Default output format for JPEG files is Mono.

stereo-conv -o src-left.jpg src.mpo

Extracting Right View From MPO File

Convert src.mpo to src-left.jpg.
Default output format for JPEG files is Mono.
Determine the reverse order of the angles to extract the right angle: --output-revert 1.

stereo-conv --output-revert 1 -o src-right.jpg src.mpo

Сonversion of Two Separate Images to Anaglyph

Convert src-left.jpg and src-right.jpg to the anaglyph.jpg.
Specify the output format AnaglyphRC.

stereo-conv --output-layout AnaglyphRC -o anaglyph.jpg src-left.jpg src-right.jpg

Convertion of Side-by-Side Stereo Pair to MPO File

Convert src.jps with side-by-side stereo pair to the result.mpo file.
Specify the input format Horizontal. The output format is determined by the file extension.

stereo-conv --input-layout Horizontal -o result.mpo src.jps

Сonversion of Two Separate Images to MPO File with Automatic Horizontal and Vertical Alignment, and Rotation

Convert src-left.jpg and src-right.jpg to result.mpo, perform operation auto-align:hvr.

stereo-conv --operations auto-align:hvr -o result.mpo src-left.jpg src-right.jpg

Convertion From MPO File to an Interlaced Stereo Pair With a Frame Fize of 1920x1080:

Convert src.mpo to interlaced.jpg, specify output format RowInterlaced and size --size 1920*1080.

stereo-conv --output-layout RowInterlaced -o interlaced.jpg --size 1920*1080 src.mpo

Conversion a File Containing Two Video Streams to Anamorphic Side-By-Side Format

Convert source.avi to result.mp4 specify AnamorphHorizontal output format.
The input format is determined automatically by the presence of two video streams.

stereo-conv --output-layout AnamorphHorizontal -p -o result.mp4 src.avi

Extracting Left Angle from Anamorphic Side-By-Side Video File

Extract video stream with left view from the src.mp4 to the src-left.mp4.
Specify input format AnamorphHorizontal and display of progress -p.

stereo-conv --input-layout AnamorphHorizontal -p -o src-left.mp4 src.mp4

Examples of Group Operations

Create MPO Files from All the Separate Images for the Left and Right Eyes

Windows:

Images for the left eye are stored in files named *-left.jpg, images for the right eye – in files named -right.jpg.

  • stereo-conv is executed for each file *- left.jpg in loop for %f in (*-left.jpg).
  • First, save the file name in the variable F: set "F=%f".
  • For the first input file, use the value %F% without change.
  • For the second input file, replace the substring “-left” by “-right”: %F:-left=-right%.
  • For the output file, replace the substring “-left.jpg” by “.mpo”: %F:-left.jpg=.mpo%.
for %f in (*-left.jpg) do (set "F=%f" & stereo-conv -o "%F:-left.jpg=.mpo%" "%F%" "%F:-left=-right%")

Linux:

for f in *-left.jpg; do stereo-conv -o ${f/-left.jpg/.mpo} $f ${f/-left/-right}; done

Extract Left Angles From the All MPO Files

Convert all files with the extension mpo into files with the same name, adding the ending -left.jpg, and save to the folder separate.
The input and output formats are determined automatically by extension.
You must first create the “separate” folder.

Windows:

for %f in (*.mpo) do stereo-conv -o separate/%f-left.jpg %f

Linux:

for f in *.mpo; do stereo-conv -o separate/${f/.mpo/-left.jpg} $f; done

Extract Right Angles from the All MPO Files

Convert all files with the extension mpo into files with the same name, adding the ending -right.jpg, and save to the folder separate.
The input and output formats are determined automatically by extension.
In order to extract the right angle, specify the reverse order of angles --output-revert 1.
You must first create the “separate” folder.

Windows:

for %f in (*.mpo) do stereo-conv --output-revert 1 -o separate/%f-right.jpg %f

Linux:

for f in *.mpo; do stereo-conv --output-revert 1 -o separate/${f/.mpo/-right.jpg} $f; done

Automatic Vertical Alignment of All MPO Files

Convert all files with the extension mpo into files with the same name in the folder result, and perform the operation auto-align:v.
You must first create the “result” folder.

Windows:

for %f in (*.mpo) do stereo-conv --operations auto-align:v -o result/%f %f

Linux:

for f in *.mpo; do stereo-conv --operations auto-align:v -o result/$f $f