= img2stereo =
== Overview ==

img2stereo is a wrapping tool for converting images for left and right eye into anaglyph images that can be viewed in 3D with standard red/cyan glasses. You find the script in {{{trunk/SCRIPTS/img2video}}} (available since r982).

== Requirements ==

img2stereo requires the Mencoder package (contained in Mplayer).\\
\\
== User instructions for converting a single pair of images ==

1. Run img2stereo as follows:{{{img2stereo #1 #2}}}, where {{{#1}}} and {{{#2}}} are the images for the left and right eye, respectively.\\\\'''Example:''' {{{img2stereo /home/username/stereo/lefteye.png /home/username/stereo/righteye.png}}}\\\\You will find the stereo image in the same directory as the left/right eye images are located.

== User instructions for converting a series of images ==

1. Prepare two folders with your input files. \\e.g. “/home/username/stereo/left” containing the files “image_left_0000.png”  to “image_left_3999.png” and  “/home/username/stereo/right/” containing the files “image_right_0000.png”  to “image_right_3999.png”. Make sure that both folders contain the same amount of images.\\\\
2. Run img2stereo with at least the {{{-n}}} and {{{-l}}} and {{{-r}}} parameters, \\'''Example:''' {{{img2stereo -l /home/username/stereo/left -r  /home/username/stereo/right -n image}}}\\The stereo images will be placed in a directory called {{{stereo}}} in the parent directory of the left/right eye images.

== Other parameters ==
You can switch on conversion into grayscale, which is highly recommended for anaglyph images by using the option {{{-g}}}.