Software Utilities for Stereoscopic Photographers: README for Macintosh

lrComare and raw2jpg Copyright (C) 2016-2018 Herb Weiner <herbw@wiskit.com>
Licensed under Creative Commons CC BY-SA 4.0.

For an introduction to these Software Utilities for Stereoscopic Photographers, refer to http://www.herbweiner.com/stereo-software.html .

BUILDING FROM SOURCE CODE

Source code (lrCompare.cc and raw2jpg.cc) is provided in the Source folder.

INSTALLATION

You must install ImageMagick (https://www.imagemagick.org/script/index.php). Note that there is no graphical user interface for Mac; raw2jpg uses the ImageMagick convert utility.

If you want to create MPO files, you must install the Perl JPEG Libraries by opening a cmd window and typing:

	cpan Image::MetaData::JPEG

lrCompare, raw2jpg, and exiftool (download from https://www.sno.phy.queensu.ca/~phil/exiftool) should be copied to an appropriate directory such as /usr/local/bin.

lrCompare.cmd, raw2jpg.cmd, and mpo.pl should be copied to the new folder you will create in the next section.

SETUP

Create a new folder. You may place this folder wherever it is convenient, and give it the name of your choice. For example, you might create a folder named photos and place it on your Desktop. In this folder, place the following items:

•	A new folder named Raw-Left. You will place raw files imported from your left camera in this folder.
•	A new folder named Raw-Right. You will place raw files imported from your right camera in this folder.
•	A new folder named JPG-Left-Right. The software will place converted JPG files from both the left and right camera in this folder.
•	A new folder named MPO. The software will place created MPO files in this folder, if you request that MPO files be created.
•	lrCompare.cmd (supplied).
•	raw2jpg.cmd (supplied).
•	mpo.pl (supplied).

Edit the lrCompare.cmd and raw2jpg.cmd files if you wish to change any of the options. For example, one of the comments in raw2jpg.cmd explains what to change if you do not wish to create MPO files.

USAGE

Open a Terminal Window, and cd to the directory you created in the previous step.

Type ./lrCompare.sh to launch the lrCompare utility. Be sure to run lrCompare prior to running raw2jpg.

Type ./raw2jpg.sh to launch the raw2jpg utility. In order to minimize processing time, raw2jpg uses the creation or modification date of each file to determine what operations are required, and to perform only the required operations.

If you make changes to a raw file and save the changes as a Photoshop (PSD) file with the same name and in the same folder as the raw file, raw2jpg will use the newer PSD file rather than the older raw file. If the JPG file already exists and is newer than the raw or PSD file, raw2jpg will skip that file. Likewise, if an MPO file already esists and is newer than both the left and the right JPG files, raw2jpg will skip that file.

REFERENCE

lrCompare usage: lrCompare -options start-end [left=right]
options:
  -?: Display these help messages [enabled]
  -h: Display these help messages [enabled]
  -d: Debug Output [disabled]
  -f: Use First Pair as Time Reference [disabled]
  -i: Ignore Errors [disabled]
  -lf value: Left Source Folder [Raw-Left]
  -l: Use Last Pair as Time Reference [disabled]
  -n: Match Based on Image Number rather than Date/Time [disabled]
  -p value: Filename Pattern [IMGP####.PEF]
  -pr: Prompt for First, Last, and Match [disabled]
  -rf value: Right Source Folder [Raw-Right]
  -r: Delete and Rename Files to Match Left and Right [disabled]
  -t value: Time Difference Threshhold [10]
  -v: Verbose Output [disabled]

raw2jpg usage: raw2jpg -options
options:
  -?: Display these help messages [enabled]
  -h: Display these help messages [enabled]
  -c: Concise messages [disabled]
  -d: Debug messages [disabled]
  -j value: JPEG Destination Folder [JPG]
  -lf value: Left Source Folder [Raw-Left]
  -lr value: Left Rotation (Clockwise Degrees) []
  -rf value: Right Source Folder [Raw-Right]
  -rr value: Right Rotation (Clockwise Degrees) []
  -r value: Non-Stereoscopic Rotation (Clockwise Degrees) []
  -rp: Also Rotate PSD Files [disabled]
  -mc value: MPO Command [mpo.pl]
  -s value: JPG Filename Suffix []
  -mf value: MPO Destination Folder []
  -v: Verbose messages [disabled]

mpo.pl usage:
perl mpo.pl -l left.jpg -r right.jpg -o out.mpo
