Справка по программе StereoPhotoView



Открытие стереопары или видео файла

Открыть файл со стереопарой (JPS, JPEG, MPO) или видео файл можно следующими способами:

  • Через меню “Файл” → “Открыть” или кнопку Открыть на панели инструментов.
  • Перетащив файл из файлового менеджера (проводника) в окно программы.
  • По двойному щелчку на файле зарегистрированного типа (JPS или MPO).
  • Через контекстное меню “Открыть с помощью…” в проводнике.

Открытие стереопары из отдельных файлов

Если стереопара хранится в отдельных файлах для левого и правого глаза, загрузить её можно одним из способов:

  • Через меню “Файл” → “Открыть раздельные файлы” или кнопку Открыть на панели инструментов.
    В открывшемся окне выберите сначала файл со снимком для левого глаза, а затем - для правого.
  • Выделив в проводнике 2 файла и перетащив их в окно программы.
  • Через контекстное меню “Открыть с помощью…” в проводнике, выделив 2 файла.

Формат источника

Поддерживаемые стерео-форматы:

  • Чередование строк;
  • Чередование столбцов;
  • Анаглиф красно-голубой;
  • Анаглиф жёлто-синий;
  • Горизонтальная пара;
  • Анаморфная горизонтальная пара;
  • Вертикальная пара;
  • Анаморфная вертикальная пара;
  • Моно;

Стерео-формат открытого файла определяется автоматически в следующих случаях:

  • Открыт файл MPO.
  • Открыт видео файл с двумя видео-потоками.
  • В файле JPS или JPEG содержатся стерео дескриптор.
  • В видео файле содержаться метаданные с описанием стерео-формата.

Если формат не определился автоматически, его можно выбрать в меню “Формат источника”.

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

Просмотр стереоскопического контента

Формат отображения

Для правильного воспроизведение стерео эффекта, нужно выбрать формат отображения, соответствующий вашему дисплею.

Если вы используете монитор или телевизор, с пассивной поляризационной технологией (например, LG Cinema 3D), используйте формат “Чередование строк”. При этом, в настройках ОС обязательно должно быть выставлено родное для монитора разрешение.

Если используется обычный монитор и анаглифные очки, выберите красно-голубой, или жёлто-синий анаглиф.

Кроме того, поддерживаются различные варианты расположения ракурсов на кадре.

Управление

Управлять просмотром можно через меню “Вид” или через контекстное меню изображения, которое открывается по щелчку правой кнопкой мыши по изображению. В подсказках отображаются комбинации клавиш для действий.

Воспроизведение видео

Для управления воспроизведением видео, при движении указателя мыши над кадром, появляется специальная панель, которая позволяет приостанавливать воспроизведение, изменять текущую позицию, и менять громкость звука.

Навигация по файлам

Программа позволяет осуществлять навигацию по файлам в папке текущего изображения кнопками PageUp, PageDown, Home, и End.

Для отображения файлов в папке текущего изображения, выберите меню “Вид” → “Панель миниатюр (T)”. В полноэкранном режиме можно просто навести указатель мыши на верхний край экрана.

Работа с файловой системой

Можно удалять в корзину, перемещать, или копировать открытый в данный момент файл.

Стартовый экран

При старте приложения, или после закрытия файла, программа отображает дерево каталогов, список избранных папок, и список последних папок.

Дерево каталогов

В левой нижней части стартового экрана отображается дерево каталогов файловой системы компьютера. Содержимое выбранной папки отображается справа.

Избранные папки

В левой верхней части начального экрана отображается список избранных папок.

Чтобы добавить папку в список избранных, щелкните по нужной папке в правой части экрана, и выберите “Добавить в избранное”.

Чтобы удалить папку из избранного - щелкните правой кнопкой по нужной папке в списке “Избранные папки” и выберите “Удалить”.

Последние папки

Выберите пункт “Последние папки” в списке “Избранные папки” - откроется список папок, из которых были открыты последние файлы.

Чтобы удалить одну или все папки из списка последних - нажмите правой кнопкой по папке и выберите соответствующий пункт меню.

Редактирование 3D фотографий и видео

Выравнивание

Выравнивание

Инструмент “Выравнивание” открывается через меню “Правка” → “Выравнивание” или клавишей A (англ).

Для выравнивания по вертикали используется вертикальный ползунок справа и клавиши: вверх и вниз.
Для горизонтального - ползунок в нижней части экрана и клавиши: влево и вправо.
Если нажимать эти клавиши вместе с Ctrl, ракурсы будут двигаться большими шагами.

Если ракурсы сняты фотоаппаратом с рук, может понадобится повернуть ракурсы. Это делается с помощью ползунков и спинеров в верхней части изображения.

Для горизонтального выравнивания (настройки параллакса), объект, который будет визуально находится на плоскости экрана нужно выравнять так, чтобы на левом и правом ракурсе, он находился в одном месте экрана (не двоился). При этом объекты, находящиеся за ним, будут восприниматься, глазом так, как будто они находятся за экраном, а те объекты, которые находятся перед ним - перед плоскость.

Изображения левого глаза на выступающих объектах находится правее изображения для правого. То есть, для их просмотра нужно сводить глаза к переносице. Для комфортного просмотра, не рекомендуется допускать слишком большое расстояние между изображениями этой детали на разных ракурсах (сильного двоения).

По вертикали, нужно просто совместить левый и правый ракурс так, чтобы объекты находились на одном уровне.

После того, как вы добьётесь желаемого результата, нажмите кнопку “Применить”.

Авто-выравнивание

Выполните меню “Правка” → “Авто-выравнивание” или нажмите Ctrl+A (англ).

Затем, с помощью мыши, выберите на изображении квадратную область, которая будет визуально находится на плоскости экрана. Для изменения размеров области, используйте колёсико мыши.

Нажмите левую кнопку мыши. Программа выполнит поиск ключевых точек в выбранной области, и выравняет изображение по ним.

Расширенное авто-выравнивание

Данный инструмент запускается через меню “Правка” → “Расширенное авто-выравнивание” или сочетанием Ctrl+E,A (англ).

Программа находит на обоих снимках похожие ключевые точки и вычисляет необходимую величину сдвига по вертикали, горизонтали, а также углы поворота ракурсов. После этого открывается инструмент выравнивание, авто-выравнивания, для ручной корректировки.

В меню “Правка” → “Настройки…” можно выбрать, какие параметры будут вычисляться автоматически: параллакс, вертикальное смещение, вращение.

Кадрирование

Инструмент “Кадрирование” открывается через меню “Правка” → “Кадрировать” или клавишей C (англ).

Выберите область снимка, и нажмите кнопку “Кадрировать”.

В нижней панели также можно выбрать желаемое соотношение сторон кадра.

Кадрирование

Открытие ракурсов во внешнем редакторе

Эта функция может быть полезна, например, для удаления эффекта красных глаз во внешнем редакторе.

  1. В меню “Правка” → “Открыть левый ракурс в…” выберите редактор.
  2. Левый ракурс должен открыться в выбранной программе.
  3. После редактирования, сохранить файл с тем-же именем, вернитесь к окну StereoPhotoView, и нажмите кнопку “Импортировать”.

Сохранение изображений

Отредактированное изображения можно сохранить в формат MPO или JPS (JPEG).

Для сохранения файла с тем-же именем, выполните команду “Файл” → “Сохранить”.

Для сохранения с другим именем или в другом стерео-формате, выполните “Файл” → “Сохранить как…”.
При этом, сначала откроется окно выбора нового имени файла, а затем окно параметров файла.
В открывшемся окне выберите расположение ракурсов и разрешение кадра.
По умолчанию первый ракурс - левый. При необходимости, можно изменить это, поставив галочку “Обратный порядок”.

При сохранении, в файл JPS записывается стерео-дескриптор, благодаря чему есть возможность автоматического определения формата источника при открытии такого файла.

Сохранение видео

Отредактированное видео можно сохранить только в другой файл.

Для этого выполните команду “Файл” → “Сохранить как…”. Сначала откроется окно выбора нового имени файла, а затем окно параметров файла.

Выберите стерео-формат, по аналогии с сохранением изображения, и параметры кодирования видео.

Постоянный коэффициент скорости используется как параметр CRF для кодека H264, и для вычисления битрейта для остальных кодеков. Во втором случае, он имеет значения процента от “сырого” битрейта.

Для примера, целевой битрейт видео потока вычисляется так: Битрейт = Постоянный_коэффициент_скорости * Ширина * Высота * Бит_на_пиксел * Частотак_кадров / 100.

Кодеки и возможности хранения описания стерео-формата для разных типов видео-файлов:

Контейнер Видео кодек Аудио кодек Описание стерео-формата
MP4 H264 AC3 Да
MOV H264 AC3 Да
Matroska H264 AC3 Да
AVI MPEG4 MP3
FLV FLV MP3

Проверено, что сохранённые файлы MP4 автоматически определяются как 3D контент телевизором LG.

Сохранение стоп-кадра из видео

Для сохранения стоп-кадра, выполните команду “Файл” → “Сохранить стоп-кадр как…” или нажмите кнопку Стоп-кадр.

После этого откроется окно сохранения изображения в котором можно выбрать имя файла нужный стерео-формат для сохранения текущего кадра видео.

Режим командной строки

Режим командной строки может быть полезен для автоматизации обработки множества файлов, например, при подготовке для печати, или публикации в интернете.

Для этого в состав приложения входит утилита командной строки stereo-conv.

В Windows, при установке, путь к папке приложения автоматически добавляется в переменную PATH. Для того, чтобы эти изменения вступили в силу, нужно пере-зайти в систему.

Запуск с параметром –help, или без параметров, отображает справку по использованию. Пример:

$ stereo-conv --help

Usage: stereo-conv [options] input input2
Конвертер для стереоскопических фотографий и видео файлов.
https://stereophotoview.bitbucket.io/

Options:
  -h, --help                 Displays this help.
  -v, --version              Displays version information.
  -o, --output <file>        Выходной файл.
  --input-layout <layout>    Компоновка стерео-пары во входном файле (см.
                             --layouts) - не обязательный.
  --input-revert <1|0>       Указывает, что во входном файле сначала идёт
                             ракурс для правого глаза - не обязательно.
  --output-layout <layout>   Компоновка стерео-пары в выходном файле (см.
                             --layouts) - По умолчанию - Monoscopic.
  --output-revert <1|0>      Указывает, что в выходном файле сначала идёт
                             ракурс для правого глаза - не обязательно.
  --size <width*height>      Размер кадра в выходном файле.
  --jpeg-quality <0..100>    Качество JPEG.
  --crf <1..51>              Постоянный коэффициент скорости для сохранения
                             видео. По умолчанию - 23.
  --preset <preset>          Пресет для кодека H264 (см. --presets). По
                             умолчанию - medium.
  --operations <operations>  Список операций, разделённый точкой с запятой (см.
                             --help-operations).
  -p, --progress             Отображать прогресс сохранения видео.
  -l, --layouts              Отобразить список возможных компоновок стерео-пар.
  --video-formats            Отобразить список форматов видео файлов.
  --presets                  Отобразить список пресетов.
  --help-operations          Отобразить список операций.

Arguments:
  input                      Входной файл.
  input2                     Необязательный второй входной файл для загрузки
                             раздельной стерео-пары.

Примеры

Извлечение левого ракурса из MPO файла

Открыть src.mpo и сохранить в src-left.jpg.
Формат вывода по умолчанию для JPEG файлов - моно.

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

Извлечение правого ракурса из MPO файла

Открыть src.mpo и сохранить в src-right.jpg.
Формат вывода по умолчанию для JPEG файлов - моно.
Для того, чтобы сохранить именно правый ракурс, указываем обратный порядок ракурсов --output-revert 1.

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

Преобразование двух отдельных снимков в анаглиф

Преобразовать src-left.jpg и src-right.jpg в anaglyph.jpg.
Указываем формат вывода AnaglyphRC.

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

Преобразование горизонтальной стерео-пары в файл MPO

Преобразовать стереопару src.jps в файл result.mpo.
Указываем входной формат Horizontal. Выходной формат определяется по расширению файла.

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

Преобразование двух отдельных снимков в MPO файл с автоматическим выравниванием по горизонтали, вертикали, и углу наклона

Преобразовать src-left.jpg и src-right.jpg в result.mpo, выполнив операцию auto-align:hvr.

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

Преобразование MPO файла в чересстрочную стереопару размером 1920x1080

Преобразовать src.mpo в interlaced.jpg с указанием выходного формата RowInterlaced и размера --size 1920*1080.

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

Преобразование видео с раздельными видео-потоками в видео файл с анаморфной горизонтальной стерео-парой

Преобразовываем src.avi в result.mp4, и указываем выходной формат AnamorphHorizontal.
Входной формат определяется автоматически по наличию двух видео-потоков.

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

Извлечение левого ракурса из видео-файла с анаморфной горизонтальной стерео-парой:

Преобразовываем src.mp4 в src-left.mp4.
Указываем входной формат AnamorphHorizontal и отображение прогресса выполнения -p.

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

Примеры групповых операций

Создать mpo файлы из всех отдельных снимков для левого (-left.jpg) и правого (-right.jpg) глаза

Изображения для левого глаза хранятся в файлах с именем *-left.jpg, изображения для правого глаза - в файлах с именем *-right.jpg.
Результат сохраняется в файл с именем *.mpo.

Windows:

stereo-conv выполняется для каждого файла *-left.jpg в цикле for %f in (*-left.jpg).

  • Сначала сохраняем имя файла в переменную F: set "F=%f".
  • Для первого входного файла используем значение %F% без преобразований.
  • Для второго входного файла заменяем подстроку “-left” на “-right”: %F:-left=-right%.
  • Для выходного файла заменяем подстроку “-left.jpg” на “.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

Извлечь левые ракурсы из всех MPO файлов в папку separate

Преобразовываем все файлы с расширением mpo в файлы с таким же именем, добавив окончание -left.jpg, и сохраняем в папку separate.
Входной и выходной форматы определяются автоматически по расширению.
Папку нужно предварительно создать.

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

Извлечь правые ракурсы из всех MPO файлов в папку separate

Преобразовываем все файлы с расширением mpo в файлы с таким же именем, добавив окончание -left.jpg, и сохраняем в папку separate.
Входной и выходной форматы определяются автоматически по расширению.
Для того, чтобы сохранить именно правый ракурс, указываем обратный порядок ракурсов --output-revert 1.
Папку нужно предварительно создать.

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

Автоматическое выравнивание по вертикали всех mpo файлов и сохранение результата в папку result

Преобразовываем все файлы с расшрением mpo в файлы с таким-же имнеем в папку result, и выполняем операцию auto-align:v.
Папку нужно предварительно создать.

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